RatheDG Cachalot System 1.2.0

System Server-Side Installation on Windows NT

  1. Preparing to install

    System can be installed on Windows NT (Windows NT 4.0, Windows 2000, Windows XP, Windows 2003 Server).
    To install the system you will need files listed below. To simplify the description these files are supposed to be in c:\temp\.
    1. Unzip or any other archiver capable to extract zip archives.
      We recommend to use Info Unzip (156 Kb), distributed under Info-ZIP license.
    2. RatheDG Cachalot System 1.2.0.
      cachalot-1.2.0.zip (850 Kb)
    3. Java Runtime Environment 1.3.1_08 with JavaC compiler added.
      cachalot-java-winnt.zip (7247 Kb)
    4. 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)
    5. WinPcap 3.0: the Free Packet Capture Architecture for Windows.
      WinPcap_3_0.exe (430 Kb)
    6. JPcap library for traffic accounting.
      cachalot-jpcap-winnt.zip (196 Kb)
    7. Database.
    8. JDBC driver for your database.
  2. Quick installation

    Use this description for quick system installation with default parameters.
    To simplify the installation put unzip.exe file to %SystemRoot%\system32\ (usually c:\winnt\system32 or c:\windows\system32) or any other folder which is contained in PATH environment variable.
    Detailed description of each step is below.
    1. mkdir "C:\Program Files\cachalot"
    2. unzip -d "C:\Program Files\cachalot" c:\temp\cachalot-1.2.0.zip
    3. "C:\Program Files\cachalot\system\install.cmd" logs
    4. "C:\Program Files\cachalot\system\install.cmd" java
    5. "C:\Program Files\cachalot\system\install.cmd" tomcat
    6. c:\temp\WinPcap_3_0.exe
    7. "C:\Program Files\cachalot\system\install.cmd" jpcap
    8. "C:\Program Files\cachalot\system\install.cmd" pgsql_jdbc
    9. Now you have to configure.
  3. Detailed installation description

    1. Unarchiving the system

      Create C:\Program Files\cachalot\ folder and extract cachalot-1.2.0.zip to it:
      1. mkdir "C:\Program Files\cachalot\"
      2. unzip -d "C:\Program Files\cachalot\" c:\temp\cachalot-1.2.0.zip
      You can install system into the folder another than C:\Program Files\cachalot\. For this replace all C:\Program Files\cachalot\ occurences in this instruction to required folder.
      Most steps described below can be done using C:\Program Files\cachalot\system\install.cmd script with necessary parameters.
    2. Configuring log-files

      Quick alternative for steps below:
      "C:\Program Files\cachalot\system\install.cmd" logs
      By default log files will be in /var/opt/cachalot folder.
      You have to create this folder:
      mkdir c:\var\opt\cachalot
      Or change log file path in configuration files. ('log.filename' parameter in C:\Program Files\cachalot\conf\erus.conf, C:\Program Files\cachalot\conf\tru.conf, C:\Program Files\cachalot\conf\uiu.conf).
    3. Installing Java

      1. Java Runtime Environment
        Quick alternative for steps below:
        "C:\Program Files\cachalot\system\install.cmd" java
        It is recommended to install cachalot-java-winnt.zip to simplify the installation and configuration. This is Java Runtime Environment 1.3.1_08 with JavaC compiler added.
        For this it is enough to extract this archive to C:\Program Files\cachalot folder:
        unzip -d "C:\Program Files\cachalot" c:\temp\cachalot-java-winnt.zip
      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.
        For minimal configuration of the system it is recommended to:
        1. Install JDK into C:\Program Files\cachalot\external\java\.
        2. Or after JDK is installed, specify path to installed JDK in C:\Program Files\cachalot\bin\environment.cmd file in JAVA_HOME variable. For this remove rem in beginning of the following line:
          rem set JAVA_HOME=path_to_your_JDK_installation
          and replace path_to_your_JDK_installation with path to installed JDK.
          Note that this variable value must not contain " character (double quotes).
    4. Installing Tomcat 4.x

      Quick alternative for steps below:
      "C:\Program Files\cachalot\system\install.cmd" tomcat
      For minimal system configuration it is recommended to:
      • Install Tomcat to C:\Program Files\cachalot\external\tomcat\.
        For this extract cachalot-tomcat.zip to C:\Program Files\cachalot\:
        unzip -d "C:\Program Files\cachalot" c:\temp\cachalot-tomcat.zip
      • Or after installing Tomcat to another location, specify path to installed tomcat in C:\Program Files\cachalot\bin\environment.cmd file in CATALINA_HOME variable. For this remove rem in beginning of the following line:
        rem set CATALINA_HOME=path_to_your_Tomcat_installation
        and replace path_to_your_Tomcat_installation with path to installed Tomcat.
        Note that this variable value must not contain " character (double quotes).
      Now after running C:\Program Files\cachalot\bin\uiu_start.cmd user interface will be available at http://localhost:8080/.
    5. Installing WinPcap (for traffic accounting)

      Install WinPcap (run WinPcap_3_0.exe):
      c:\temp\WinPcap_3_0.exe
    6. Installing JPcap (for traffic accounting)

      Quick alternative for steps below:
      "C:\Program Files\cachalot\system\install.cmd" jpcap
      To install JPcap:
      unzip -d "C:\Program Files\cachalot" c:\temp\cachalot-jpcap-winnt.zip
      If you have installed Java not using cachalot-java-winnt.zip, then copy C:\Program Files\cachalot\external\java\bin\jpcap.dll to %JAVA_HOME%\bin.
    7. Install JDBC driver (PostgreSQL example)

      Quick alternative for steps below:
      "C:\Program Files\cachalot\system\install.cmd" pgsql_jdbc
      Install JDBC driver for PostgreSQL:
      unzip -d "C:\Program Files\cachalot" c:\temp\cachalot-jdbc-pgsql.zip
      If you have installed Tomcat not using cachalot-tomcat.zip, then copy JDBC driver to your Tomcat:
      copy "C:\Program Files\cachalot\external\jdbc\pg73jdbc2ee.jar" "C:\Program Files\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. C:\Program Files\cachalot\conf\tru.conf
      2. C:\Program Files\cachalot\conf\erus.conf
      3. C:\Program Files\cachalot\conf\uiu.conf
      4. C:\Program Files\cachalot\bin\eru_stop.cmd
      5. C:\Program Files\cachalot\bin\eru_client.cmd
      6. C:\Program Files\cachalot\bin\eru_jclient.cmd
    2. System automatic start

      • To run/stop the system on computer start up/shutdown it is necessary to install the service:
        "C:\Program Files\cachalot\system\server\cachalot.exe install"
      • To start system manually use following command:
        net start cachalot
      • To stop system manually use following command:
        net stop cachalot
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.