RatheDG Cachalot System 1.2.0

Manual for Upgrade to New Version

  1. About Manual

    This manual describes what is necessary to do to install new version over installed previous version.

    In some cases functionality of particular components of system (e.g. clients of ERU) is not changed and it is possible to continue using those components from previous version of system.

    It is necessary to remember that this manual doesn't describe all possible variants of upgrade. It describes minimal enough sequence of actions for upgrade.

    References to the distributive package files mean files from latter version distributive package unless opposite is explicitly specified.

  2. Upgrade from 1.1.0 to 1.2.0

    1. Database

      There were no changes in the database.

    2. ERU

      1. Command line clients

        Java command line client has not changed.

        Native command line client has not changed.

      2. Windows integrated client

        Windows integrated client has not changed.

      3. Server

        Server has not changed.

    3. TRU

      TRU has not changed.

    4. UIU

      In case of arbitrary container required action can only be formulated in general way: it is necessary to replace web-application to new (system/server/uiu.war file).

      Below is description of actions for Tomcat 4.x. Description is given in assumption that UIU is in c:/cachalot/uiu folder and %CATALINA_HOME%/conf/server.xml has been changed accordingly to user manual of version 1.1.0.

      It is necessary to:

      • stop container.
      • rename c:/cachalot/uiu folder to c:/cachalot/uiu.old.
      • replace c:/cachalot/system/server/uiu.war file with system/server/uiu.war distributive file.
      • if UIU was configured via web.xml file then copy all parameters of configuration from c:/cachalot/uiu.old/WEB-INF/web.xml to c:/cachalot/uiu/WEB-INF/web.xml (without changing any pieces of file beside env-entry sections)
      • remove %CATALINA_HOME%/work folder.
      • run container.
      • remove c:/cachalot/uiu.old.
  3. Upgrade from 1.0.3 to 1.1.0

    1. Database

      Perform the following steps to convert the database:

      • Use system/database/create.*.sql, as if you create database from the scratch (See installation guide, "Database" chapter).
      • Execute script system/database/upgrade.x.sql (upgrade.mssql65-8.sql for MSSQL, upgrade.pgsql.sql for PostgreSQL; for another database, replace upgrade.tmpl.sql metavalues %TRUE% according to the description in installation guide, "Database" chapter).
      • Execute scripts system/database/drop_operations.sql and system/database/drop_general.sql from version 1.0.3 distributive package.
    2. ERU

      1. Command line clients

        Java command line client has not changed.

        Native command line client has not changed.

      2. Windows integrated client

        Windows integrated client has not changed.

      3. Server

        It is necessary to replace all double backslashes with single backslashes in ERU/S configuration file.

        It is necessary to replace eru.jar and restart ERU/S.

    3. TRU

      It is necessary to replace all double backslashes with single backslashes in TRU configuration file.

      It is necessary to add and define 'shutdown.*' parameters in TRU configuration file (see installation manual).

      It is necessary to replace tru.jar. Use tru_start.cmd instead of tru.cmd.

      After replacements and corrections of scripts restart TRU.

    4. UIU

      In case of arbitrary container required action can only be formulated in general way: it is necessary to replace web-application (former uiu/uiu.war of distributive package) to new (system/server/uiu.war file).

      Below is description of actions for Tomcat 4.x. Description is given in assumption that UIU is in c:/cachalot/uiu folder and %CATALINA_HOME%/conf/server.xml has been changed accordingly to user manual of version 1.0.3.

      If 'log.event' parameter of configuration contains 'startup' event, then remove it from parameter value.

      If UIU was configured using configuration file then replace all double backslashes with single backslashes in configuration file.

      It is necessary to:

      • stop container.
      • rename c:/cachalot/uiu folder to c:/cachalot/uiu.old.
      • unpack from disributive content of system/server/uiu.war into c:/cachalot/uiu (using unzip or jar).
      • if UIU was configured via web.xml file then copy all parameters of configuration from c:/cachalot/uiu.old/WEB-INF/web.xml to c:/cachalot/uiu/WEB-INF/web.xml (without changing any pieces of file beside env-entry sections)
      • run container.
      • remove c:/cachalot/uiu.old.
  4. Upgrade from 1.0.2 to 1.0.3

    1. Database

      There were no changes in the database.

    2. ERU

      1. Command line clients

        Java command line client has not changed.

        Native command line client has changed. It is necessary to use eru_nclc.exe instead of CachalotCLClient.exe.

      2. Windows integrated client

        It is possible to use client from version 1.0.2, in such case new functionality will not be available.

        To replace client necessary to:

        • place rdgcswic.dll to %SystemRoot%/System32 folder.
        • change parameter GinaDLL of HKLM\Software\Microsoft\Windows NT\CurrentVersion\Winlogon registry key to 'rdgcswic.dll'.
        • create parameter 'neterror.allow' of HKLM\Software\RatheDG\Cachalot registry key (see description in user manual).
        • reboot computer.
        • remove %SystemRoot%/System32/CachalotWIC.dll.
      3. Server

        It is necessary to replace eru.jar and restart ERU/S.

    3. TRU

      It is necessary to replace tru.jar. It is also necessary to replace libjpcap.so and replace net.sourceforge.jpcap-0.01.12.jar to net.sourceforge.jpcap-0.01.13.jar. After replacements and corrections of scripts restart TRU.

    4. UIU

      In case of arbitrary container required action can only be formulated in general way: it is necessary to replace web-application (former uiu folder of distributive package) to new (uiu/uiu.war file).

      Below is description of actions for Tomcat 4.x. Description is given in assumption that UIU is in c:/cachalot/uiu folder and %CATALINA_HOME%/conf/server.xml has been changed accordingly to user manual of version 1.0.2.

      It is necessary to:

      • stop container.
      • rename c:/cachalot/uiu folder to c:/cachalot/uiu.old.
      • unpack from disributive content of uiu/uiu.war into c:/cachalot/uiu (using unzip or jar).
      • copy all parameters of configuration from c:/cachalot/uiu.old/WEB-INF/web.xml to c:/cachalot/uiu/WEB-INF/web.xml (without changing any pieces of file beside env-entry sections).
      • replace in cachalot.db.dateDiff and cachalot.db.bigInt parameters {0} and {1} to %0% ¨ %1% correspondingly; if before values have contained '%' characters, replace each of them to '%%'.
      • run container.
      • remove c:/cachalot/uiu.old.
  5. Upgrade from 1.0.1 to 1.0.2

    1. Database

      There were no changes in the database.

    2. ERU

      1. Command line clients

        Java command line client has not changed.

        Native command line client has not changed.

      2. Windows integrated client

        It is necessary to replace CachalotWIC.dll.

      3. Server

        It is necessary to replace eru.jar and restart ERU/S.

    3. TRU

      It is necessary to replace tru.jar and restart TRU.

    4. UIU

      In case of arbitrary container required action can only be formulated in general way: it is necessary to replace web-application (former uiu folder of distributive package) to new (uiu folder).

      Below is description of actions for Tomcat 4.x. Description is given in assumption that UIU is in c:/cachalot/uiu folder and %CATALINA_HOME%/conf/server.xml has been changed accordingly to user manual of version 1.0.1.

      It is necessary to:

      • stop container.
      • rename c:/cachalot/uiu folder to c:/cachalot/uiu.old.
      • copy from distributive content of uiu folder to c:/cachalot/uiu folder.
      • copy all parameters of configuration from c:/cachalot/uiu.old/WEB-INF/web.xml to c:/cachalot/uiu/WEB-INF/web.xml (without changing any pieces of file beside env-entry sections).
      • run container.
      • remove c:/cachalot/uiu.old.
  6. Upgrade from 1.0.0 to 1.0.1

    1. Database

      There were no changes in the database.

    2. ERU

      1. Command line clients

        Java command line client has not changed.

        Native command line client has not changed.

      2. Windows integrated client

        It is necessary to replace CachalotWIC.dll.

      3. Server

        It is necessary to replace eru.jar and restart ERU/S.

    3. TRU

      It is necessary to:

      • replace tru.jar.
      • add to tru.conf device.promiscuous parameter (see description in user manual).
      • restart TRU.
    4. UIU

      In case of arbitrary container required action can only be formulated in general way: it is necessary to replace web-application (former uiu folder of distributive package) to new (uiu folder).

      Below is description of actions for Tomcat 4.x. Description is given in assumption that UIU is in c:/cachalot/uiu folder and %CATALINA_HOME%/conf/server.xml has been changed accordingly to user manual of version 1.0.0.

      It is necessary to:

      • stop container.
      • rename c:/cachalot/uiu folder to c:/cachalot/uiu.old.
      • copy from distributive content of uiu folder to c:/cachalot/uiu folder.
      • copy all parameters of configuration from c:/cachalot/uiu.old/WEB-INF/web.xml to c:/cachalot/uiu/WEB-INF/web.xml (without changing any pieces of file beside env-entry sections).
      • run container.
      • remove c:/cachalot/uiu.old.
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.