Solaris10 installation howto

1. This "How To" is probably just one way to setup the server, but it works.
2. The procedure to set up a central repository server or a client on which statistics is to be collected in similar.
3. The extra steps to be performed for a server install are indicated where necessary.
5. All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org were not tested but should also work)
6. 1. make 3.80
7. 2. gcc 3.4.6
8. 3. libgcc 3.4.6 (don't install until you read security comment below)
9. 4. libiconv 1.11
10. 5. orca-snapshot-r535 (http://www.orcaware.com)
11. 6. RICHPse (ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz, http://www.sunfreeware.com/setoolkit.html)
13. Quick: if you need to install Apache2 from scratch on the central repository server, here is a list of packages you will likely need:
14. make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!)
15. You can get all the packages above from sunfreeware.com.

1. Install or ensure there is a suitable C compiler e.g., gcc 3.4.2, gcc 3.4.6

2. Use the default system perl or install GNU Perl built with gcc e.g., Perl 5.8.7 (you may need autoconf and m4 packages on Solaris 10)

3. Set your PATH and LD_LIBRARY_PATH variables temporarily export PATH=/usr/local/bin:/usr/ccs/bin:$PATH export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

4. Install libiconv (only if using the GNU gcc from sunfreeware for example)

5. For a server install, the package SUNWsprot must be installed (usually installed by default)

6. Install SE Toolkit (version 3.4 at least for Solaris 10)

gunzip RICHPse.gz pkgadd -d . RICHPse

Alternatively, if using the RICHPse-3.3.tar.gz package, then use the following commands instead: gunzip RICHPse-3.3.tar.gz tar -xvf RICHPse-3.3.tar pkgadd -d RICHPse

7. Install Orca Extract the Orca compressed package e.g., to /tmp NOTE: it may be a good idea to install orcallator somewhere else apart from the default /usr/local since its files will grow e.g., on a dedicated filesystem or under /var for example.

gunzip orca-snapshot-r535.tar.gz tar -xf orca-snapshot-r535.tar cd orca-snapshot-r535

1. The next 2 steps only applies to Solaris 10

8. Edit file: orca-snapshot-r535/packages/rrdtool-1.0.50/perl-shared/Makefile

a. change the line CCCDLFLAGS = -KPIC To: CCCDLFLAGS =

b. change the line CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO -DHAVE_CONFIG_H To: CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO -DHAVE_CONFIG_H

c. change the line OPTIMIZE = -xO3 -xspace -xildoff To: OPTIMIZE =

9. Edit file: orca-snapshot-r535/packages/Storable-2.15/Makefile

a. change the line CCCDLFLAGS = -KPIC To: CCCDLFLAGS =

b. change the line CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -xarch=v8 -D_TS_ERRNO To: CCFLAGS = -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_TS_ERRNO

c. change the line OPTIMIZE = -xO3 -xspace -xildoff To: OPTIMIZE =

1. if you are reinstalling, remember to delete the existing orca folder or else the new installation will not succeed e.g.,

rm -rf /usr/local/var/orca

1. "make" fails when using the default perl installation as it (perl) expects to use the cc compiler, so
2. create a soft link to the gcc compiler i.e.,

cd /usr/local/bin ln -s gcc cc

1. "make" fails because it couldn't locate perl pod2man executable, so find it and add to PATH variable

find /usr | grep pod2man /usr/perl5/5.6.1/bin/pod2man /usr/perl5/5.6.1/man/man1/pod2man.1 /usr/perl5/5.8.4/bin/pod2man /usr/perl5/5.8.4/man/man1/pod2man.1

1. "perl -v" returns 5.8.4, so use the "second" pod2man above

export PATH=$PATH:/usr/perl5/5.8.4/bin

1. go back to the extracted installation source folder

pwd orca-snapshot-r535

1. run the configure script

./configure --with-html-dir=/var/apache2/htdocs/orca --with-ncsa-log=/var/apache2/logs/access_log

1. install orca

make make install make orcallator_run_at_boot

1. NOTE: orca doesn't start on solaris 10 after the installation process above
2. The Reason: the following statement in the orcallator startup script is used
3. to derive part of the name of the PATH to some of the files needed by
4. orcalltor, orcallator does not start
5. "/opt/RICHPse/bin/se -version | awk '{print $4}'"
6. the command above returns 3.4.1 which is the used to
7. generate the PATH /usr/local/lib/SE/3.4.1 which does not exist.
8. The actual path on the server is /usr/local/lib/SE/3.4
9. The solution is to create a soft link as below.

cd /usr/local/lib/SE ln -s 3.4 3.4.1

1. start the orcallator

/etc/init.d/orcallator start

1. This is only needed on the central server

mkdir -p /var/apache2/htdocs/orca/orcallator

1. Final words: for security reasons, you may prefer to install gcc 3.4.6 and make 3.80, finish compiling
2. and installing orca and anything else that requires gcc in order to successfully install, then uninstall gcc
3. and make 3.80. Finally, install only the libgcc so that does applications that require the library will work properly

1. The rest ONLY applies to the central server
3. DO THIS ONLY if using GNU perl (e.g., from sunfreeware.com)
4. Edit the file /usr/local/bin/orca and change the first line to use the new perl installation i.e.,
5. the line changes from #!/usr/bin/perl TO: #!/usr/local/bin/perl

1. The commands below are ONLY needed on the server

/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

1. Once it starts up successfully without errors and completes the first run,
2. kill the process (find it's pid with "ps -ef | grep orca")

1. then restart orca as a daemon i.e.,

/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg

1. You are adviced to create an auto-start script in /etc/init.d and /etc/rc2.d for the above process.

Ayotunde Itayemi (Last updated 22/05/2008)