A.5.1 Upgrade Oracle Guest

The procedures in this section perform the IDIH Oracle Guest upgrade.

Note:

When attempting to repeat an upgrade following a back out, it is not necessary to upgrade the Oracle Guest if the source release is 7.1 or later.

A.5.1 IDIH CLI: Perform a System Health Check on the Oracle Guest

1. Log in to the Oracle guest as the admusr user.

   ssh <IDIH IP address>

   login as: admusr

   password: <enter password>

2. Execute the analyze_server.sh script.

   $ sudo /usr/TKLC/xIH/plat/bin/analyze_server.sh -i

   Sample output:

   [admusr@cat-ora ~]$ /usr/TKLC/xIH/plat/bin/analyze_server.sh -i

   13:24:52: STARTING HEALTHCHECK PROCEDURE

   13:24:52: date: 03-17-15, hostname: cat-ora

   13:24:52: TPD VERSION: 7.8.3.0.0-89.21.0

   13:24:52: -------------------------------------------

   13:24:52: Checking disk free space

   13:24:52: No disk space issues found

   :

   13:25:02: All tests passed!

   13:25:02: ENDING HEALTHCHECK PROCEDURE WITH CODE 0

   If the output indicates the following error, ignore the error and continue the upgrade. This error indicates the target release and the running release are the same.

   00:47:29: Checking runlevel

   00:47:29: >>> Error: Runlevel value "3 4" is different from "N 4"

   If the output indicates any other failure, do not proceed with the upgrade. It is recommended to contact My Oracle Support (MOS) for guidance.

A.5.1 IDIH CLI: Shut Down the Mediation and Guest

Follow this procedure to shut down the mediation guest to prepare for the Oracle Guest Upgrade.

1. Log in to the Mediation guest as admusr user.

   ssh <IDIH IP address>

   login as: admusr

   password: <enter password>

2. Shut down the Mediation guest.

   $ sudo init 0

   The active SOAM server may have some or all of the following expected alarms:

   Alarm ID = 19800 Communication Agent Connection Down

   Alarm ID = 11511 Unable to connect via Comagent to remote DIH server with hostname

   The active NOAM server may have some or all of the following expected alarms:

   Alarm ID = 19800 Communication Agent Connection Down

A.5.1 IDIH CLI: Shut Down the Application Guest

Follow this procedure to shut down the application guest to prepare for the Oracle Guest Upgrade.

1. Log in to the Application guest as admusr user.

   ssh <IDIH IP address>

   login as: admusr

   password: <enter password>

2. Shut down the Application guest.

   $ sudo init 0

   The active SOAM server may have some or all of the following expected alarms:

   Alarm ID = 19800 Communication Agent Connection Down

   Alarm ID = 11511 Unable to connect via Comagent to remote DIH server with hostname

   The active NOAM server may have some or all of the following expected alarms:

   Alarm ID = 19800 Communication Agent Connection Down

A.5.1 PMAC GUI: Start the Upgrade of the Oracle Guest using the PMAC GUI

1. Navigate to the PMAC VM Management menu.
2. Select the Oracle guest and click Upgrade.
3. On the Select Image screen, select the target image from the list of available images.
   The Oracle iso for a fresh installation and upgrade is different.

   When installing IDIH, use the following:

   • apps iso
   • mediation iso
   • oracleGuest iso

   When upgrading IDIH, use the following:

   • apps iso
   • mediation iso
   • oracle iso
4. Click Start Software Upgrade to initiate the upgrade.

A.5.1 PMAC GUI: Monitor the Upgrade Using the PMAC GUI

1. Navigate to the Task Monitoring menu and wait until the upgrade task finishes.

   If the upgrade fails, do not proceed with the upgrade. It is recommended to contact My Oracle Support.

   When it finishes, the status is either Success or Failed.

A.5.1 IDIH CLI: Perform a System Health Check on the Oracle Guest

1. Wait a few minutes to allow the Oracle guest to stabilize after the reboot, and repeat step 1 to perform the postupgrade system health check.

   Note:

   The following warnings are expected due to the mediation and app servers being shut down.

   • Warning: mediation server is not reachable (or ping response exceeds 3 seconds)
   • Warning: app server is not reachable (or ping response exceeds 3 seconds)