source: trunk/arb_INSTALL.txt

Last change on this file was 19492, checked in by westram, 8 months ago
  • mention libgomp1 (required by FastTreeMP)
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.0 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-download/ )
7
8   Files needed: 'arb-*.tgz' and 'arb_install.sh'
9                 (see arb_README.txt for details on different versions)
10
112. if you like to install arb for all users, become superuser (root).
12
133. run the arb installation script with the following commands
14
15       cd ~/arb-download
16       bash arb_install.sh
17
18   and follow the instructions.
19
204. Install packages needed by ARB:
21
22--------------------------------------------------------------------------------
234a. If you're using Ubuntu please refer to:
24
25  * the detailed list of packets to install for ARB:    arb_UBUNTU.txt
26  * the package-install-script for ubuntu:              SH/arb_installubuntu4arb.sh
27
28--------------------------------------------------------------------------------
294b. If you're using debian please install one of the centos versions
30
31You may also want to use
32  * the package-install-script for ubuntu:              SH/arb_installubuntu4arb.sh
33(Note: add 'contrib non-free' behind 'main' in /etc/apt/sources.list)
34
35--------------------------------------------------------------------------------
364c. Otherwise use your package manager to install the
37    software that is needed to run ARB:
38
39- libmotif-common
40- libmotif-dev
41- bash
42- libpng
43- xterm
44- libxerces-c-dev
45- libgomp1 (required for FastTreeMP)
46
47Only needed for Open GL version:
48
49- OPENGL
50- libGLEW -- Open GL extensions library (see subdirectory lib/addlibs)
51
52
53Software that is useful together with ARB:
54
55- gnuplot
56- xreader (or gv)
57- xfig (+ fig2dev to print from xfig)
58- xterm
59- transfig
60- perl5
61- treetool
62
63--------------------------------------------------------------------------------
64If you get errors about missing libraries when calling arb, have a look if there
65are different versions of the missing libraries in /usr/lib and create a link
66there.
67
68Most likely you'll be missing libXm.so.4, so the following example describes
69how to solve the problem for that library:
70
71    # as superuser:
72    cd /usr/lib
73    ln -s libXm.so.4 libXm.so.3
74
75
76================================================================================
77To build ARB from source
78================================================================================
79
801. download the needed files from our homepage http://www.arb-home.de/
81   and save them into a directory of your choice (i.e. ~/arb-build/ )
82
83   Files needed: 'arbsrc*.tgz'
84
852. Unpack the source
86
87   e.g.
88        tar -zxvf arbsrc.tgz
89
903. Goto source dir
91
92   e.g.
93        cd arbsrc_6213
94
954. Set up compile environment
96
97   if you're using bash:
98
99      export ARBHOME=`pwd`
100      export PATH=$ARBHOME/bin:$PATH
101      export LD_LIBRARY_PATH=$ARBHOME/lib:$LD_LIBRARY_PATH
102
1035. Now either
104
105   a. run
106
107        make all
108
109      to compile arb. On a multiprocessor machine you may want to call
110
111        make -j5 all
112
113      or similar (where the number should be the number of processors + 1).
114
115      This will fail on first call telling you to edit config.Makefile.
116      Open that file in your editor and check whether the default values
117      suit your system and needs.
118
119      If you like to activate openGL features set OPENGL to 1
120      (needs additional libraries).
121
122      When done, again call one of the make commands mentioned above.
123
124      If compilation fails, have a look at the packages needed for compilation
125      below. For ubuntu/debian there is a script for automated package
126      installation in
127
128             SH/arb_installubuntu4arb.sh
129
130      Once compilation succeeds, call
131
132        arb
133
134      to run arb in compilation directory.
135
136   b. run
137
138        make tarfile
139        bash arb_install.sh
140
141      to install arb for all users
142
143   and follow the instructions there.
144
145
146Additional software that is needed to compile ARB:
147--------------------------------------------------
148
149- 'g++' (gcc-c++) or 'clang'
150- make
151- time
152- lynx
153- autoconf
154- automake
155- libtool
156- patch
157- subversion (if you want to check out from arb svn repository)
158- openmotif, openmotif-devel (aka motif-devel; aka libmotif-common + libmotif-dev)
159- glib2-devel (libglib2.0-dev)
160- readline-devel (aka libreadline-dev)
161- libxerces-c-dev (aka libxerces-c-devel)
162- libboost_random*-devel (aka libboost-random-dev)
163- libtiff-devel
164- libx11-dev
165- libXpm-devel (aka libxpm-dev)
166- libxt-dev
167- libXext-devel (aka libxext-dev)
168- libXaw-devel (eg. libxaw7-dev)
169- libxml2-utils
170- libtirpc-devel
171- expat
172- xmllint
173- xsltproc
174
175not required for basic build:
176
177- makedepend (use xutils-dev or perl-ExtUtils-MakeMaker)
178
179Additional software that is needed to compile sina:
180---------------------------------------------------
181(can be disabled via config.makefile)
182
183- libboost_filesystem*-devel (aka libboost-filesystem-dev)
184- libboost_iostreams*-devel (aka libboost-iostreams-dev)
185- libboost_program_options* + libboost_program_options*-devel (aka libboost-program-options-dev)
186- libboost_system*-devel (aka libboost-system-dev)
187- libboost_thread*-devel (aka libboost-thread-dev)
188- libboost_test*-devel (aka libboost-test-dev)
189- tbb-devel (aka libtbb-dev)
190
191Additional software that is needed to compile open gl parts:
192------------------------------------------------------------
193(can be enabled via config.makefile)
194
195- mesa
196- mesa-devel [aka Mesa-devel]
197- mesaglw (suse leap)
198- mesaglw-devel (aka libglw1-mesa-dev)
199- libGLw-devel (suse leap)
200- libpng
201- libpng*-devel (aka libpng-dev)
202- libglew
203- glew-devel (aka libglew-dev)
204- freeglut
205- freeglut-devel (aka freeglut*-dev)
206
207General notes:
208--------------
209
210- some 'EXAMPLE-devel' package you also need to install the 'EXAMPLE' package itself.
211  (encountered e.g. for libboost-packages on suse leap)
212
213----------------------------------------------------------------------
214If we forgot something (or if your OS needs something special)
215please notify us (devel@arb-home.de). We will mention it here..
216----------------------------------------------------------------------
217
Note: See TracBrowser for help on using the repository browser.