Big Sister - README.rpm

- Starting Big Sister
- Configuring your Web server
- Required/suggested other software packages

    The RPM version of Big Sister tries to implement the File Hierarchy
    Standard (FHS) and actually was generated using

      ./configure --enable-fhs --with-user=bigsis --with-cgi=/bigsis/cgi --with-url=/bigsis make

    Due to this there are a few things to note, notably the locations
    where you find configuration files:

      - local configuration files are stored below /etc/bigsister
        - whenever the Big Sister documentation talks about the
        "adm" directory, translate it into /etc/bigsister
      - the site-wide, shared config files are stored below
        /usr/share/bigsister/etc
      - the program directory is /usr/share/bigsister
      - the documentation is installed in /usr/share/doc/packages/bigsister
      - the "var" directory, where all the files are stored Big Sister
        itself writes information to, are located below /var/lib/bigsister
      - the Big Sister user is "bigsis"
      - Big Sister was configured to display under the URL
        http://<localhost>/bigsis/, you find a (working) example apache
        configuration snippet in /etc/bigsister/httpd.conf

## Starting Big Sister

    The RPM will install a start script named "bigsister" in your
    init directory (/etc/init.d, most probably) and enable it for
    starting during boot time. If you want to immediately start Big
    Sister just run

    	/etc/init.d/bigsister start

    in a root shell.

## Configuring your Web server

    Of course, you can browse through Big Sister status via the URL
    file:/var/lib/bigsister/www. Anyway, it is better to have a web server
    running on the Big Sister server (no need for a web server on agent
    machines).

    If the Big Sister RPM has detected an installed Apache server it has
    probably already configured your webserver appropriately. Start or
    re-start your webserver via

    	/etc/init.d/apache restart

    (on some systems: /etc/init.d/httpd restart) and access Big Sister
    via the URL

    	http://<yourhostname>/bigsis/

    If you prefer installing and configuring a web server manually:
    You find an example Apache configuration fragment in /etc/bigsister/httpd.conf.
    You can either directly include it in your main httpd.conf or do whatever
    you like with it :-)

## Required/suggested other software packages

    Big Sister comes with a minimum of dependencies. It does not require
    Apache (though I strongly suggest installing it),  it does not require
    certain Perl modules, ...

    Anyway, please browse through the INSTALL document to see what optional
    packages might enable more functionality as soon as they are installed.

    Have fun!