Solaris10 installation howto

This "How To" is probably just one way to setup the server, but it works.

All the extra software used were downloaded from sunfreeware.com (similar packages from blastwave.org should also work) 1. make 3.80 2. gcc 3.4.6 3. libgcc 3.4.6 (not needed unless you intend to uninstall gcc after you finish the installation, only then will you install libgcc) 4. libiconv-1.11-sol10-sparc-local.gz 5. orca-snapshot-r535.tar.bz2

HOW TO SETUP ORCA (CLIENTS AND SERVER)

============================

make, expat, db-4, apr, aprutil, openssl, libiconv, gdbm, gcc (if not installed), apache2 (of course!) You can get all the packages above from sunfreeware.com.

Installing ORCA on server and clients

=========================

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)

  Not necessary: Install freetype2 package from sunfreeware

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. You need to install libiconv (e.g., libiconv-1.8-sol9-sparc-local) if using gcc

5. install SE Toolkit (version 3.4 at least for Solaris 10) Also the package SUNWsprot must be installed on the server - it is usually installed by default)

  ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/RICHPse.gz
  http://www.sunfreeware.com/setoolkit.html

gunzip RICHPse-3.3.tar.gz tar -xvf RICHPse-3.3.tar pkgadd -d RICHPse (OR: gunzip RICHPse.gz; pkgadd -d . RICHPse )

6. install Orca (or orcallator.se on clients) extract the Orca compressed package e.g., to /opt 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 -xvf orca-snapshot-r535.tar cd orca-snapshot-r535

Solaris 10 NOTE

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

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

2. 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

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

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

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

2. 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

3. 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.