source: branches/stable/arb_INSTALL.txt

Last change on this file was 14803, checked in by westram, 3 years ago
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 4.6 KB
Line 
1================================================================================
2To install a precompiled ARB
3================================================================================
4
51. download the needed files from our homepage http://www.arb-home.de/
6   and save them into a directory of your choice (i.e. ~/arb-install/ )
7
8   Files needed: 'arb-*.tgz' and 'arb_install.sh'
9                 (see arb_README.txt for details on different versions)
10
112. get root
123. run arb_install.sh and follow the instructions
134. Install packages needed by ARB:
14
15--------------------------------------------------------------------------------
164a. If you're using Ubuntu please refer to:
17
18  * the detailed list of packets to install for ARB:    arb_UBUNTU.txt
19  * the package-install-script for ubuntu:              SH/arb_installubuntu4arb.sh
20
21--------------------------------------------------------------------------------
224b. If you're using debian please install one of the centos versions
23
24You may also want to use
25  * the package-install-script for ubuntu:              SH/arb_installubuntu4arb.sh
26(Note: add 'contrib non-free' behind 'main' in /etc/apt/sources.list)
27
28--------------------------------------------------------------------------------
294c. Otherwise use your package manager to install the
30    software that is needed to run ARB:
31
32- (open)motif
33- bash
34- libpng
35- xterm
36- libxerces-c3.1
37
38Only needed for Open GL version:
39
40- OPENGL
41- libGLEW -- Open GL extensions library (see subdirectory lib/addlibs)
42
43
44Software that is useful together with ARB:
45
46- gnuplot
47- ghostview (gv)
48- xfig (+ fig2dev to print from xfig)
49- perl5
50- treetool
51
52--------------------------------------------------------------------------------
53Libraries needed to run 32-bit ARB on 64-bit machine:
54(checked on OpenSuSE 10.2)
55
56- openmotif-libs-32bit
57
58--------------------------------------------------------------------------------
59If you get errors about missing libraries when calling arb, have a look if there
60are different versions of the missing libraries in /usr/lib and create a link
61there.
62
63Most likely you'll be missing libXm.so.4, so the following example describes
64how to solve the problem for that library:
65
66    # as superuser:
67    cd /usr/lib
68    ln -s libXm.so.4 libXm.so.3
69
70
71================================================================================
72To build ARB from source
73================================================================================
74
751. download the needed files from our homepage http://www.arb-home.de/
76   and save them into a directory of your choice (i.e. ~/arb-build/ )
77
78   Files needed: 'arbsrc*.tgz'
79
802. Unpack the source
81
82   e.g.
83        tar -zxvf arbsrc.tgz
84
853. Goto source dir
86
87   e.g.
88        cd arbsrc_6213
89
904. Set up compile environment
91
92   if you're using bash:
93
94      export ARBHOME=`pwd`
95      export PATH=$ARBHOME/bin:$PATH
96      export LD_LIBRARY_PATH=$ARBHOME/lib:$LD_LIBRARY_PATH
97
985. Now either
99
100   a. run
101
102        make all
103
104      to compile arb. On a multiprocessor machine you may want to call
105
106        make -j5 all
107
108      or similar (where the number should be the number of processors + 1).
109
110      This will fail on first call telling you to edit config.Makefile.
111      Open that file in your editor and check whether the default values
112      suit your system and needs.
113
114      If you like to activate openGL features set OPENGL to 1
115      (needs additional libraries).
116
117      When done, again call one of the make commands mentioned above.
118
119      If compilation fails, have a look at the packages needed for compilation
120      below. For ubuntu/debian there is a script for automated package
121      installation in
122
123             SH/arb_installubuntu4arb.sh
124
125      Once compilation succeeds, call
126
127        arb
128
129      to run arb in compilation directory.
130
131   b. run
132
133        make tarfile
134        ./arb_install.sh
135
136      to install arb for all users
137
138   and follow the instructions there.
139
140
141Additional software that is needed to compile ARB:
142--------------------------------------------------
143
144- expat, xmllint, xsltproc [needed for target 'help' only]
145- openmotif, openmotif-devel
146- xaw???
147- libtiff-devel
148- lynx
149
150Additional software that is needed to compile open gl parts:
151------------------------------------------------------------
152- mesa
153- mesa-devel
154- mesaglw (opensuse)
155- mesaglw-devel (opensuse)
156- libGLw-devel (SuSE 13.x)
157- libpng
158- libglew
159- glew-devel (opensuse)
160- freeglut
161- freeglut-devel
162----------------------------------------------------------------------
163If we forgot something (or if your OS needs something special)
164please notify us (devel@arb-home.de). We will mention it here..
165----------------------------------------------------------------------
166
Note: See TracBrowser for help on using the repository browser.