Installation from sources

When installing Big Sister from the source package you will additionally need at least a working copy of the Make utility and the Bourne shell. This means that you will probably not be able to install Big Sister from source directly on a Windows machine and this section therefore just assumes you are installing on a Unix box.

Before you can proceed you should decide where to store your various Big Sister files (see section ** ). If this is your first installation it might be a good idea to just use the defaults. You should also consider a few points:

Usually you will install Big Sister under its own user account for security reasons. Big Sister daemons will run under this account. Before you can install Big Sister you have to create this account.

Are you still with us? Well, then we can start the installation. Unpack your Big Sister source package, log in as root and change directory into your package. Now you can run the configuration procedure by changing directory into the Big Sister package directory and run

 ./configure

Configure will try to use reasonable defaults, but it is a good idea to browse through its configuration options and look for things you want to have configured differently. Please run

./configure --help

to see all the supported options. Especially useful options in my eyes are:

 --prefix=[dir]
                    (install Big Sister elsewhere than in /usr/local)
                
--with-user=[login]
                    (use some other user than the default "bs")
                
 --with-cgi=[URL]
                    (the URL of the directory your browser will find the Big Sister
                        CGIs under "/cgi")
                
 --with-url=[URL]
                    (the URL of the directory your browser will find the
                        "www" directory of Big Sister (defaults to "/bs")
                

Once you have run configure and you are happy with the configuration it generated you can run

make install

install the whole Big Sister package or

make install-agent

just install the agent, or

make install-server

just install the server.

During the installation process a Big Sister boot script will be placed in the "init" directory of your system (/etc/init.d, /sbin/init.d, /etc/rc.d/init.d, whatever else). It's up to you to enable this script by placing the necessary links in the rc*.d directories or using chkconfig (if your system supports this).