A.6.2 Server Upgrade Using platcfg

The following procedure enables a server to be upgraded using the Platform Configuration (platcfg) utility.
  1. Log in to the Server Console to be upgraded.
    Use the SSH command (on UNIX systems – or putty if running on windows) to log into the server to be upgraded:
    ssh admusr@<server IP> 
    password: <enter password> 

    Answer yes if you are asked to confirm the identity of the server.

  2. Enter the platcfg menu
    Switch to the platcfg user to start the configuration menu:
    $ sudo su – platcfg 

    From the Main Menu, select Maintenance.

  3. Perform Upgrade Checks
    1. From the Maintenance Menu, select Upgrade.
    2. From the Upgrade Menu, select Early Upgrade Checks.
  4. Select the Upgrade Media
    1. From the Choose Upgrade Media Menu, select the desired target media. This begins the early upgrade checks in the console window.

      Informational messages display as the checks progress. At the end of a successful test, a message similar to this displays:

      Running earlyUpgradeChecks () for Upgrade::EarlyPolicy:: TPDEarlyChecks upgrade policy...

      Verified server is not pending accept of previous upgrade

      Hardware architectures match

      Install products match.

      Verified server is alarm free!

      Early Upgrade Checks Have Passed!

    2. Verify early upgrade checks pass. In case of errors, it is recommended to contact My Oracle Support (MOS).
    3. Press q to exit the screen session and return to the platcfg menu.
    4. From the Choose Upgrade Media Menu, select Exit.
  5. Initiate the Upgrade.
    From the Upgrade Menu, select Initiate Upgrade.
  6. Select the Upgrade Media
    From the Choose Upgrade Media Menu, select the desired target media. This begins the server upgrade.

    Many informational messages display on the terminal screen as the upgrade proceeds.

    After the upgrade is complete, the server reboots.

    A reboot of the server is required.

    The server will be rebooted in 10 seconds

  7. Log in to the Server to be upgraded
    Use the SSH command (on UNIX systems – or putty if running on windows) to log into the server to be upgraded:

    ssh admusr@<server IP>

    password: <enter password>

    Answer yes if you are asked to confirm the identity of the server.

  8. Check for Upgrade Errors
    1. Examine the upgrade logs in the /var/TKLC/log/upgrade directory and verify no errors were reported.
      grep -i error /var/TKLC/log/upgrade/upgrade.log
    2. Examine the output of the command to determine if any errors were reported.
    3. If the upgrade fails, collect the following files:

      /var/TKLC/log/upgrade/upgrade.log

      /var/TKLC/log/upgrade/ugwrap.log

      /var/TKLC/log/upgrade/earlyChecks.log

      /var/TKLC/log/platcfg/upgrade.log

    4. It is recommended to contact My Oracle Support by referring to Create a Link for ComAgent and provide these files.
  9. Verify the Upgrade
    1. Check the upgrade log for the upgrade complete message:

      grep "UPGRADE IS COMPLETE" /var/TKLC/log/upgrade/upgrade.log

    2. Verify the UPGRADE IS COMPLETE message displays. If not, it is recommended to contact My Oracle Support:

      [admusr@NO2 ~]$ grep "UPGRADE IS COMPLETE" /var/TKLC/log/ upgrade/upgrade.log

      1407786220:: UPGRADE IS COMPLETE