Installing ORCA on servers and clients
==================================================

1. install or ensure there is a suitable C compiler e.g., gcc 3.4.2
2. install GNU Perl built with gcc e.g., Perl 5.8.7
3. set your PATH temporarily
export PATH=/usr/local/bin:/usr/ccs/bin:$PATH

4. install SE Toolkit
gunzip RICHPse-3.3.tar.gz
tar -xvf RICHPse-3.3.tar
pkgadd -d . RICHPse

whi
5. install Orca
extract the Orca compressed package e.g., to /opt
cd /opt
gunzip orca-0.27b3.tar.gz
tar orca-0.27b3.tar
cd orca-0.27b3
./configure --with-html-dir=/var/apache/htdocs/orca --with-ncsa-log=/var/apache/logs/access_log
make
make install
make orcallator_run_at_boot

start the orcallator
/etc/init.d/orcallator start

remember to cd to the following directories under the top Orca directory

cd packages/Data-Dumper-2.101
perl Makefile.PL
make
make test
make install

cd ../Digest-MD5-2.20
perl Makefile.PL
make
make test
make install

cd ../Math-Interpolate-1.05
perl Makefile.PL
make
make test
make install

cd ../rrdtool-1.0.40
sh configure
make
make install

cd perl-shared
perl Makefile.PL
make
make test
make install

cd ../../Storable-2.05
perl Makefile.PL
make
make test
make install


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


edit the file /usr/local/bin/orca and change the first line
to use the new perl installation i.e., the line changes from
#!/usr/bin/perl    TO     #!/usr/local/bin/perl

the command below is only needed on the server
/usr/local/bin/orca -v /usr/local/lib/orcallator.cfg

(once it starts up completely without errors and completes the first run,
kill the process (find it's pid with "ps -ef | grep orca")

then restart orca as a daemon i.e.,
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg


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


edit the /etc/hosts on both the server and client and ensure they can "see" each other
(alternatively use DNS)


Configure the client for "password-less" login to the server
==============================================================
on the client (as root) run "ssh-keygen" to generate the client's
authentication key files, when asked for the name of the file
in which to save the key, just press the ENTER key 
and when asked for a paraphrase also press the ENTER key.
Press ENTER key again to confirm the blank paraphrase. 
This generates the default pair of files 
/.ssh/id_rsa and /.ssh/id_rsa.pub

copy the content of the /.ssh/id_rsa.pub from the client into
the /.ssh/authorized_keys on the server.
(make the permission on the authorized_keys file 400 i.w., 
"chmod 400 authorized_keys")

NOTE: the content of the id_rsa.pub file is one single continuous line
NOTE: if there are other lines in the authorized_keys file on the server,
just place the content of the id_rsa.pub file on a new line.

Now configure the client to send the Orca stats files to the server
on the client add the entry to root's crontab ("crontab -e"):

0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/bin/scp -r /usr/local/var/orca/orcallator/ vnl-evddb01:/usr/local/var/orca/orcallator/
(where vnl-evddb01 is the name of the server in this example which must be resolvable on the client)


NOTE: it seems once you have added a new client to the configuration, and at least one
set of statistics have been copied to the server, you may have to kill and restart the 
Orca daemon on the server so that it will see the new client:
i.e., kill the process (find it's pid with "ps -ef | grep orca")
and restart it
/usr/local/bin/orca -d /usr/local/lib/orcallator.cfg