NetIQ Documentation: NetIQ Sentinel Installation and Configuration Guide - Upgrading Sentinel in High Availability

A.4 Upgrading Sentinel in High Availability

When you upgrade Sentinel in an HA environment, you should first upgrade the passive nodes in the cluster, then upgrade the active cluster node.

A.4.1 Prerequisites

Download the latest installer from the NetIQ download Web site.
If you are using the SLES operating system with kernel version 3.0.101 or later, you must manually load the watchdog driver in the computer. To find the appropriate watchdog driver for your computer hardware, contact your hardware vendor. To load the watchdog driver, perform the following:
1. In the command prompt, run the following command to load the watchdog driver in the current session:
```
/sbin/modprobe -v --ignore-install <watchdog driver name>
```
2. Add the following line to the /etc/init.d/boot.local file to ensure that the computer automatically loads the watchdog driver at every boot time:
```
/sbin/modprobe -v --ignore-install <watchdog driver name>
```

A.4.2 Upgrading a Traditional Sentinel HA Installation

Enable the maintenance mode on the cluster:
```
crm configure property maintenance-mode=true
```
Maintenance mode helps you to avoid any disturbance to the running cluster resources while you update Sentinel. You can run this command from any cluster node.
Verify whether the maintenance mode is active:
```
crm status
```
The cluster resources should appear in the unmanaged state.
Upgrade the passive cluster node:
1. Stop the cluster stack:
```
rcopenais stop
```
  Stopping the cluster stack ensures that the cluster resources remain accessible and avoids fencing of nodes.
2. Log in as root to the server where you want to upgrade Sentinel.
3. Extract the install files from the tar file:
```
tar xfz <install_filename>
```
4. Run the following command in the directory where you extracted the install files:
```
./install-sentinel --cluster-node
```
5. After the upgrade is complete, restart the cluster stack:
```
rcopenais start
```
  Repeat Step 3 for all passive cluster nodes.
Upgrade the active cluster node:
1. Back up your configuration, then create an ESM export.
  
  For more information about backing up data, see Backing Up and Restoring Data in the NetIQ Sentinel Administration Guide.
2. Stop the cluster stack:
```
rcopenais stop
```
  Stopping the cluster stack ensures that the cluster resources remain accessible and avoids fencing of nodes.
3. Log in as root to the server where you want to upgrade Sentinel.
4. Run the following command to extract the install files from the tar file:
```
tar xfz <install_filename>
```
5. Run the following command in the directory where you extracted the install files:
```
./install-sentinel 
```
6. After the upgrade is complete, start the cluster stack:
```
rcopenais start
```
Disable the maintenance mode on the cluster:
```
crm configure property maintenance-mode=false
```
You can run this command from any cluster node.
Verify whether the maintenance mode is inactive:
```
crm status
```
The cluster resources should appear in the Started state.
(Optional) Verify whether the Sentinel upgrade is successful:
```
rcsentinel version
```

A.4.3 Upgrading a Sentinel HA Appliance Installation

You can upgrade a Sentinel HA appliance installation by using the Zypper patch and also through WebYast.

Upgrading Sentinel HA Appliance by Using Zypper

You must register all the appliance nodes through WebYast before the upgrade. For more information, see Section 13.4.3, Registering for Updates. If you do not register the appliance, Sentinel displays a yellow warning.

Enable the maintenance mode on the cluster.
```
crm configure property maintenance-mode=true
```
Maintenance mode helps you to avoid any disturbance to the running cluster resources while you update the Sentinel software. You can run this command from any cluster node.
Verify whether the maintenance mode is active.
```
crm status
```
The cluster resources should appear in the unmanaged state.
Upgrade the passive cluster node:
1. Download updates for the Sentinel HA appliance.
```
zypper -v patch -d
```
  This command downloads updates for packages installed on the appliance including Sentinel to /var/cache/zypp/packages.
2. Stop the cluster stack.
```
rcopenais stop
```
  Stopping the cluster stack ensures that the cluster resources remain accessible and avoids fencing of nodes.
3. After you download the updates, install the updates using the following command:
```
rpm -Uvh /var/cache/zypp/packages/sentinel_server_7000_x86_64-Updates/rpm/noarch/*.rpm /var/cache/zypp/packages/sentinel_server_7000_x86_64-Updates/rpm/x86_64/*.rpm /var/cache/zypp/packages/sentinel_server_7000_x86_64-Updates/rpm/i586/*.rpm --excludepath=/var/opt/novell/
```
4. Run the following script to complete the upgrade process:
```
/var/adm/update-scripts/sentinel_server_ha_x86_64-update-<version>-overlay_files.sh
```
5. After the upgrade is complete, restart the cluster stack.
```
rcopenais start
```
  Repeat Step 3 for all the passive cluster nodes.
Upgrade the active cluster node:
1. Back up your configuration, then create an ESM export.
  
  For more information on backing up data, see Backing Up and Restoring Data in the NetIQ Sentinel Administration Guide.
2. Stop the cluster stack.
```
rcopenais stop
```
  Stopping the cluster stack ensures that the cluster resources remain accessible and avoids fencing of nodes.
3. Log in to the Sentinel appliance as an administrator.
4. To upgrade the Sentinel appliance, click Appliance to launch WebYaST.
5. To check whether there are any updates, click Updates.
6. Select and apply the updates.
  
  The updates might take few minutes to complete. After the update is successful, the WebYaST login page appears.
  
  Before upgrading the appliance, WebYaST automatically stops the Sentinel service. You must manually restart this service after the upgrade is complete.
7. Clear your Web browser cache to view the latest Sentinel version.
8. After the upgrade is complete, restart the cluster stack.
```
rcopenais start
```
Disable the maintenance mode on the cluster.
```
crm configure property maintenance-mode=false
```
You can run this command from any cluster node.
Verify whether the maintenance mode is inactive.
```
crm status
```
The cluster resources should appear in the Started state.
(Optional) Verify whether the Sentinel upgrade is successful:
```
rcsentinel version
```

Upgrading Sentinel HA Appliance Through WebYast

Enable the maintenance mode on the cluster.
```
crm configure property maintenance-mode=true
```
Maintenance mode helps you to avoid any disturbance to the running cluster resources while you update the Sentinel software. You can run this command from any cluster node.
Verify whether the maintenance mode is active.
```
crm status
```
The cluster resources should appear in the unmanaged state.
Upgrade the passive cluster nodes:
1. Stop the cluster stack.
```
rcopenais stop
```
  Stopping the cluster stack ensures that the cluster resources remain accessible and avoids fencing of nodes.
2. Specify the URL of passive cluster node using port 4984 to launch WebYaST as https://<IP_address>:4984, where <IP_address> is the IP address of passive cluster node. Log in to the Sentinel appliance as an administrator.
3. To check whether there are any updates, click Updates.
4. Select and apply the updates.
  
  The updates might take few minutes to complete. After the update is successful, the WebYaST login page appears.
5. After the upgrade is complete, restart the cluster stack.
```
rcopenais start
```
  Repeat Step 4 for all passive cluster nodes.
Upgrade the active cluster node:
1. Back up your configuration, then create an ESM export.
  
  For more information on backing up data, see Backing Up and Restoring Data in the NetIQ Sentinel Administration Guide.
2. Stop the cluster stack.
```
rcopenais stop
```
  Stopping the cluster stack ensures that the cluster resources remain accessible and avoids fencing of nodes.
3. Log in to the Sentinel appliance as an administrator.
4. To upgrade the Sentinel appliance, click Appliance to launch WebYaST.
5. To check whether there are any updates, click Updates.
6. Select and apply the updates.
  
  The updates might take few minutes to complete. After the update is successful, the WebYaST login page appears.
  
  Before upgrading the appliance, WebYaST automatically stops the Sentinel service. You must manually restart this service after the upgrade is complete.
7. Clear your Web browser cache to view the latest Sentinel version.
8. After the upgrade is complete, restart the cluster stack.
```
rcopenais start
```
Disable the maintenance mode on the cluster.
```
crm configure property maintenance-mode=false
```
You can run this command from any cluster node.
Verify whether the maintenance mode is inactive.
```
crm status
```
The cluster resources should appear in the Started state.
(Optional) Verify whether the Sentinel upgrade is successful:
```
rcsentinel version
```