RatheDG Cachalot System 1.2.0

System Server-Side Installation on Linux (x86)

  1. Preparing to install

    Installation requires 'root' permissions.
    To install the system you will need files listed below. To simplify the description these files are supposed to be in /tmp/.
    1. RatheDG Cachalot System 1.2.0.
      cachalot-1.2.0.zip (850 Kb)
    2. Java Runtime Environment 1.3.1_08 with JavaC compiler added.
      cachalot-java-linux.zip (13452 Kb)
    3. Jakarta Tomcat 4.1.24 (jakarta-tomcat-4.1.24-LE-jdk14.tar.gz is used; it is tuned for minimal distributive package size and maximum performance).
      cachalot-tomcat.zip (3885 Kb)
    4. JPcap library for traffic accounting.
      cachalot-jpcap-linux.zip (176 Kb)
    5. Database (PostgreSQL 7.3.4 is recommended). MySQL is not supported.
      postgresql-base-7.3.4.tar.gz (6970 Kb)
      Or use mirror list.
    6. JDBC driver for your database.
  2. Quick installation

    Use this description for quick system installation with default parameters.
    Detailed description of each step is below.
    1. mkdir -p /opt/cachalot
    2. unzip -d /opt/cachalot /tmp/cachalot-1.2.0.zip
    3. /opt/cachalot/system/install.sh users
    4. /opt/cachalot/system/install.sh logs
    5. /opt/cachalot/system/install.sh java
    6. /opt/cachalot/system/install.sh tomcat
    7. /opt/cachalot/system/install.sh jpcap
    8. /opt/cachalot/system/install.sh pgsql_inst
    9. /opt/cachalot/system/install.sh pgsql_db
    10. /opt/cachalot/system/install.sh pgsql_jdbc
    11. Now you have to configure.
  3. Detailed installation description

    1. Unarchiving the system

      Create /opt/cachalot/ folder and extract cachalot-1.2.0.zip to it:
      1. mkdir -p /opt/cachalot
      2. unzip -d /opt/cachalot /tmp/cachalot-1.2.0.zip
      You can install system into the folder another than /opt/cachalot/. For this replace all /opt/cachalot occurences in this instruction to required folder.
      Most steps described below can be done using script /opt/cachalot/system/install.sh with necessary parameters.
    2. Create users to run the system

      Quick alternative for steps below:
      /opt/cachalot/system/install.sh users
      • Create group 'cachalot' for easy permissions management for different system units:
        groupadd cachalot
      • Create user 'cachalot' for running UIU unit. (see /opt/cachalot/bin/uiu_start.sh, /opt/cachalot/bin/uiu_stop.sh):
        useradd -g cachalot cachalot
      • Create user 'cachalot-eru' for running ERU unit. (see /opt/cachalot/bin/eru_start.sh, /opt/cachalot/bin/eru_stop.sh):
        useradd -g cachalotcachalot-eru
      • Change /opt/cachalot/ folder owner to user 'root' and group 'cachalot'.
        chown -R root:cachalot /opt/cachalot
    3. Logs configuration

      Quick alternative for steps below:
      /opt/cachalot/system/install.sh logs
      By default log files will be in /var/opt/cachalot folder. You have to create this folder:
      1. mkdir -p /var/opt/cachalot
      2. chown cachalot:cachalot /var/opt/cachalot
      3. chmod 755 /var/opt/cachalot
      Or change log file path in configuration files. ('log.filename' parameter in /opt/cachalot/conf/erus.conf, /opt/cachalot/conf/tru.conf, /opt/cachalot/ņonf/uiu.conf).
    4. Installing Java

      1. Java Runtime Environment
        Quick alternative for steps below:
        /opt/cachalot/system/install.sh java
        It is recommended to install cachalot-java-linux.zip to simplify the installation and configuration. This is Java Runtime Environment 1.3.1_08 with JavaC compiler added.
        1. unzip -d /opt/cachalot /tmp/cachalot-java-linux.zip
        2. chown -R root:cachalot /opt/cachalot/external/java
      2. Java Development Kit
        If for some reason you can't use cachalot-java-linux.zip then install JDK 1.3.1_08 or above, which can be downloaded from Sun:
        http://java.sun.com/j2se/1.3/download.html.
        When downloading JDK for Linux select bin-file (j2sdk-1_3_1_08-linux-i586.bin).
        For minimal configuration of the system it is recommended to:
        1. Install into /opt/cachalot/external/java/.
          For this:
          1. cd /opt/cachalot/external
          2. /tmp/j2sdk-1_3_1_08-linux-i586.bin
          3. mv jdk1.3.1_08 java
        2. Or make symbolic link /opt/cachalot/external/java/ to folder where JDK is installed.
          Let's assume you have installed JDK in /opt/jdk1.3.1_08.
          Then make:
          ln -s /opt/jdk1.3.1_08 /opt/cachalot/external/java
    5. Tomcat 4.x installation

      Quick alternative for steps below:
      /opt/cachalot/system/install.sh tomcat
      For minimal system configuration it is recommended to:
      1. Install Tomcat to /opt/cachalot/external/tomcat/.
        For this extract cachalot-tomcat.zip to /opt/cachalot/:
        unzip -d /opt/cachalotcachalot-tomcat.zip
      2. Or make symbolic link /opt/cachalot/external/tomcat/ to folder where Tomcat is installed.
        Let's assume you have Tomcat installed to /opt/jakarta-tomcat-4.1.24.
        Then make:
        ln -s /opt/jakarta-tomcat-4.1.24 /opt/cachalot/external/tomcat
      Now after running /opt/cachalot/bin/uiu_start.sh user interface will be available at http://localhost:8080/.
    6. Installing JPcap (for traffic accounting)

      To install traffic accounting library do the following:
      unzip -d /opt/cachalot /tmp/cachalot-jpcap-linux.zip
    7. Database installation (PostgreSQL example)

      Quick alternative for steps below:
      /opt/cachalot/system/install.sh pgsql_inst
      To install PostgreSQL 7.3.4 do the following:
      1. cd /tmp
      2. tar xzf /tmp/postgresql-base-7.3.4.tar.gz
      3. cdpostgresql-7.3.4
      4. ./configure --prefix=/opt/pgsql
      5. gmake install
      6. useradd -g cachalot postgres
      7. mkdir /opt/pgsql/data
      8. chown postgres /opt/pgsql/data
      9. chmod 770 /opt/pgsql/data
      10. touch /var/opt/postgresql
      11. chown postgres /var/opt/postgresql
      12. su - postgres
      13. /opt/pgsql/bin/initdb -D /opt/pgsql/data
      14. /opt/cachalot/bin/postgres.sh start
      Quick alternative for steps below:
      /opt/cachalot/system/install.sh pgsql_db
      Do the following for creating the database:
      1. su - postgres
      2. /opt/pgsql/bin/createdb cachalot
      3. /opt/pgsql/bin/psql -f /opt/cachalot/system/database/create_general.pgsql.sql cachalot
      4. /opt/pgsql/bin/psql -f /opt/cachalot/system/database/create_operations.pgsql.sql cachalot
      5. /opt/pgsql/bin/psql -f /opt/cachalot/system/database/create_permissions.pgsql.sql cachalot
      Quick alternative for steps below:
      /opt/cachalot/system/install.sh pgsql_jdbc
      Install JDBC driver:
      unzip -d /opt/cachalot /tmp/cachalot-jdbc-pgsql.zip
      If you have installed Tomcat not using cachalot-tomcat.zip, then add JDBC driver to your Tomcat:
      ln -s /opt/cachalot/external/jdbc/pg73jdbc2ee.jar /opt/cachalot/external/tomcat/shared/lib
  4. Configuring the system

    1. Setting mandatory parameters

      It is necessary to set parameters marked with  (!) in configuration files:
      1. /opt/cachalot/conf/tru.conf
      2. /opt/cachalot/conf/erus.conf
      3. /opt/cachalot/conf/uiu.conf
      4. /opt/cachalot/bin/eru_stop.sh
      5. /opt/cachalot/bin/eru_jclient.sh
    2. System automatic startup/shutdown

      • Add /opt/cachalot/bin/cachalot.sh call to /etc/rc.d/rc3.d (folder) or /etc/rc.d/rc.3 (file) to run the system on computer startup:
        ln -s /opt/cachalot/bin/cachalot.sh /etc/rc.d/rc3.d/S98cachalot
        And to /etc/rc.d/rc5.d (folder) or /etc/rc.d/rc.5 (file):
        ln -s /opt/cachalot/bin/cachalot.sh /etc/rc.d/rc5.d/S98cachalot
      • Add /opt/cachalot/bin/postgres.sh call to /etc/rc.d/rc3.d (folder) or /etc/rc.d/rc.3 (file) to run the PostgreSQL on computer startup:
        ln -s /opt/cachalot/bin/postgres.sh /etc/rc.d/rc3.d/S97postgres
        And to /etc/rc.d/rc5.d (folder) or /etc/rc.d/rc.5 (file):
        ln -s /opt/cachalot/bin/cachalot.sh /etc/rc.d/rc5.d/S97postgres
      • Add /opt/cachalot/bin/cachalot.sh call to /etc/rc.d/rc6.d (folder) or /etc/rc.d/rc.6 (file) to stop the system on computer shutdown:
        ln -s /opt/cachalot/bin/cachalot.sh /etc/rc.d/rc6.d/K00cachalot
      • Add /opt/cachalot/bin/postgres.sh call to /etc/rc.d/rc6.d (folder) or /etc/rc.d/rc.6 (file) to stop the PostgreSQL on computer shutdown:
        ln -s /opt/cachalot/bin/postgres.sh /etc/rc.d/rc6.d/K01postgres
Product page:
http://www.rathedg.com/products/cachalot/
Company page:
http://www.rathedg.com/
Any questions:
support@rathedg.com

© 2001-2003 Rathe Development Group. All rights reserved.
Use is subject to license terms.