Server Upgrade Using platcfg

A.2 Server Upgrade Using platcfg

The following procedure enables a server to be upgraded using the Platform Configuration (platcfg) utility.

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.
Enter the platcfg menu
Switch to the platcfg user to start the configuration menu:
```
$ sudo su – platcfg 
```
From the Main Menu, select Maintenance.
Perform Upgrade Checks
1. From the Maintenance Menu, select Dual Image Upgrade.
2. From the Dual Image Upgrade Menu, select Early Upgrade Checks.
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.
Initiate the Upgrade.
From the Dual Image Upgrade Menu, select Initiate Background Upgrade.
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.
Exit from Upgrade Media Menu and select Dual Image Upgrade Menu.
Select Apply Upgrade.

Note:
If Apply Upgrade option does not appear, exit from the platcfg and then again navigate to platcfg.

After the upgrade is complete, the server reboots.

A reboot of the server is required.

The server will be rebooted in 10 seconds
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.
Once server comes us and post apply scripts are completed, verify this by running the following command:
```
tail -f /var/TKLC/log/upgrade/upgrade.log
```
Note:
Post apply scripts takes 10 to 15 minutes to get completed.
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.
Verify the Upgrade
1. Check the upgrade log for the upgrade complete message:
  
  grep "APPLY COMPLETE" /var/TKLC/log/upgrade/upgrade.log
2. Verify the APPLY COMPLETE message displays. If not, it is recommended to contact My Oracle Support:
  
  [admusr@NO2 ~]$ grep "APPLY COMPLETE" /var/TKLC/log/ upgrade/upgrade.log
  
  1407786220:: APPLY COMPLETE