source: branches/profile/arb_INSTALL.txt

Last change on this file was 12330, checked in by westram, 5 years ago
  • doc installing precompiled versions on debian (tested with wheezy)
  • 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
37Only needed for Open GL version:
38
39- OPENGL
40- libGLEW -- Open GL extensions library (see subdirectory lib/addlibs)
41
42
43Software that is useful together with ARB:
44
45- gnuplot
46- ghostview (gv)
47- xfig (+ fig2dev to print from xfig)
48- perl5
49- treetool
50
51--------------------------------------------------------------------------------
52Libraries needed to run 32-bit ARB on 64-bit machine:
53(checked on OpenSuSE 10.2)
54
55- openmotif-libs-32bit
56
57--------------------------------------------------------------------------------
58If you get errors about missing libraries when calling arb, have a look if there
59are different versions of the missing libraries in /usr/lib and create a link
60there.
61
62Most likely you'll be missing libXm.so.4, so the following example describes
63how to solve the problem for that library:
64
65    # as superuser:
66    cd /usr/lib
67    ln -s libXm.so.4 libXm.so.3
68
69
70================================================================================
71To build ARB from source
72================================================================================
73
741. download the needed files from our homepage http://www.arb-home.de/
75   and save them into a directory of your choice (i.e. ~/arb-build/ )
76
77   Files needed: 'arbsrc*.tgz'
78
792. Unpack the source
80
81   e.g.
82        tar -zxvf arbsrc.tgz
83
843. Goto source dir
85
86   e.g.
87        cd arbsrc_6213
88
894. Set up compile environment
90
91   if you're using bash:
92
93      export ARBHOME=`pwd`
94      export PATH=$ARBHOME/bin:$PATH
95      export LD_LIBRARY_PATH=$ARBHOME/lib:$LD_LIBRARY_PATH
96
975. Now either
98
99   a. run
100
101        make all
102
103      to compile arb. On a multiprocessor machine you may want to call
104
105        make -j5 all
106
107      or similar (where the number should be the number of processors + 1).
108
109      This will fail on first call telling you to edit config.Makefile.
110      Open that file in your editor and check whether the default values
111      suit your system and needs.
112
113      If you like to activate openGL features set OPENGL to 1
114      (needs additional libraries).
115
116      When done, again call one of the make commands mentioned above.
117
118      If compilation fails, have a look at the packages needed for compilation
119      below. For ubuntu/debian there is a script for automated package
120      installation in
121
122             SH/arb_installubuntu4arb.sh
123
124      Once compilation succeeds, call
125
126        arb
127
128      to run arb in compilation directory.
129
130   b. run
131
132        make tarfile
133        ./arb_install.sh
134
135      to install arb for all users
136
137   and follow the instructions there.
138
139
140Additional software that is needed to compile ARB:
141--------------------------------------------------
142
143- expat, xmllint, xsltproc [needed for target 'help' only]
144- openmotif, openmotif-devel
145- xaw???
146- libtiff-devel
147- lynx
148
149Additional software that is needed to compile open gl parts:
150------------------------------------------------------------
151- mesa
152- mesa-devel
153- mesaglw (opensuse)
154- mesaglw-devel (opensuse)
155- libGLw-devel (SuSE 13.x)
156- libpng
157- libglew
158- glew-devel (opensuse)
159- freeglut
160- freeglut-devel
161----------------------------------------------------------------------
162If we forgot something (or if your OS needs something special)
163please notify us (devel@arb-home.de). We will mention it here..
164----------------------------------------------------------------------
165
Note: See TracBrowser for help on using the repository browser.