6.1 Upgrading from 1.0 to 1.1

This section describes the procedure to upgrade Sentinel Log Manager application from 1.0 to 1.1 version or migrate the Sentinel Log Manager application 1.0 to Sentinel Log Manager Appliance 1.1.

6.1.1 Upgrading Sentinel Log Manager Application from 1.0 to 1.1

  1. Make a backup of your configuration and create an ESM export.

  2. (Conditional) If the version of installed Sentinel Log Manager is lower than 1.0 hotfix 4, then upgrade it to Sentinel Log Manager 1.0 hotfix 5, which is the latest hotfix available. Download the hotfix from the Novell Patch Download site.

    NOTE:You must be a registered user to download patches. If you have not registered, click Register to create a user account in the patch download site.

  3. Log in as root to the server where you want to install Sentinel Log Manager.

  4. Specify the following command to stop the Sentinel Log Manager server:

    /opt/novell/sentinel_log_mgr/bin/server.sh stop

    For example, /opt/novell/sentinel_log_mgr_1.0_x86-64/bin/server.sh stop

  5. Specify the following command to extract the install files from the tar file:

    tar xfz <install_filename>

    Replace <install_filename> with the actual name of the install file.

  6. Specify the following command to run the install-slm script to upgrade Sentinel Log Manager: 

    ./install-slm

  7. To proceed with a language of your choice, select the number specified next to the language.

    The end user license agreement is displayed in the selected language.

  8. Read the end user license and enter yes or y, to accept the license and continue with the installation.

  9. The installation script detects that an older version of the product already exists and prompts you to specify if you want to upgrade the product. If you press n, the installation terminates. To continue with the upgrade, press y.

    The installation starts installing all RPM packages. This installation might take a few seconds to complete.

    The existing Sentinel Log Manager 1.0 installation is left intact, with the following exceptions:

    • If the 1.0 data directory (For example, /opt/novell/sentinel_log_manager_1.0_x86-64/data) and the 1.1 data directory (For example, /var/opt/novell/sentinel_log_mgr/data) are in the same file system, then the <1.0>/data/eventuate and <1.0>/data/rawdata subdirectories are moved to the 1.1 location because the eventdata and rawdata directories are typically very large. If the 1.0 data and 1.1 data directories are in different file systems, then the eventdata and rawdata subdirectories are copied to the 1.1 location, and the 1.0 files are left intact.

    • If the existing 1.0 data directory (For example, /opt/novell/sentinel_log_mgr_1.0_x86-64) is on a separately mounted file system and there is insufficient space on the file system containing the 1.1 data directory (/var/opt/novell/sentinel_log_mgr/data) then you can allow the installer to remount the file system from the 1.0 location to the 1.1 location. Any entry in /etc/fstab is also updated. If you decide not to allow the installer to remount the existing file system, the upgrade exits. You can then create sufficient space on the file system for the 1.1 data directory.

  10. When the Sentinel Log Manager 1.1 installation is successful and the server is functional, then you must specify the following command to manually remove Sentinel Log Manager 1.0 directory:

    rm -rf /opt/novell/slm_1.0_install_directory

    For example:

    rm -rf /opt/novell/sentinel_log_mgr_1.0_x86-64

    Removing the installation directory permanently deletes the Sentinel Log Manager 1.0 installation.

  11. Make sure that all the Collector Managers are upgraded to a version compatible with the upgraded Sentinel Log Manager server. For more information on upgrading Collector Managers, see Section 6.3, Upgrading the Collector Manager.

NOTE:When you start the system for the first time after upgrading, it might take approximately five minutes for the system to initialize before you can start using it. This delay only occurs when you start the system for the first time after the installation or an update.

6.1.2 Migrating from 1.0 to 1.1 Appliance

If you have installed Sentinel Log Manager 1.0 and you want to migrate to Sentinel Log Manager Appliance 1.1, follow the steps given below to migrate data and configuration:

  1. Make a backup of your configuration and create an ESM export.

  2. Upgrade to Sentinel Log Manager 1.1. For more information, see Section 6.1.1, Upgrading Sentinel Log Manager Application from 1.0 to 1.1.

  3. Specify the following command to change to novell user:

    su -novell

  4. Specify the following command to change to the /bin directory:

    cd /opt/novell/sentinel_log_mgr/bin

  5. Specify the following command to take a full backup of Sentinel Log Manager 1.1 data and configuration. 

    ./backup_util.sh -m backup -c -e -l -r -s -w -f $APP_HOME/data/<backupfilename>

    Replace <backupfilename> with a file name to store backup data.

    For more information on backing up data, see Backing Up and Restoring Data.

  6. Install Sentinel Log Manager Appliance 1.1 on a separate machine. For more information, see Section 4.0, Installing the Appliance.

  7. Copy the file which contains the backed up data onto the newly installed Sentinel Log Manager 1.1 appliance.

  8. Specify the following command:

    chown novell:novell <backfupfilename>

  9. Specify the following command to change to the /bin directory:

    cd /opt/novell/sentinel_log_mgr/bin

  10. Specify the following command to fully restore the data backed up from the Sentinel Log Manager 1.1 application:

    ./backup_util.sh -m restore -f $APP_HOME/data/<backupfilename>

    For more information, see Backing Up and Restoring Data.