Using CA AppLogic › Appliance Developer Guide › Appliance OS Installations › Common Components › Linux APK › Upgrade APK in Linux Appliance

Upgrade APK in Linux Appliance

You can upgrade the APK in older appliances to the latest APK. The APK resides in the boot volume of the appliance. You should branch, upgrade, and test prior to moving the appliance to the catalog. The required privileges and ssh keys must exist.

The latest APK is always the highest version. APK versioning is managed independently of the CA AppLogic version numbers. All APK have backward compatibility. This ensures the latest APK will work with all supported versions of CA AppLogic.

When you install a new grid, the /usr/local/applogic/download directory automatically updates with the latest APK.

Follow these steps:

1. Create a sandbox application.
2. Drag your Linux appliance to the canvas and branch the appliance to a singleton.
3. Access the 3t shell and manage the boot volume of the appliance by entering:

   vol manage [name]:[name2]--rw
   

   where name is the name of the volume to be managed and name2 is the name of the secondary volume to be managed.

   The following example uses an appliance named VDS64_Fedora18_r2 with a second name of VDS64_Fedora18_r2.boot

   

4. Locate the IP address of the grid controller by entering:

   [root@hostname /]# cat /tmp/acs-dhclient-options
   

5. Download the new APK to the appliance tmp directory using wget to access the APK from the grid controller location.

   For example:

   [root@hostname /]# wget http://[ipaddress]:8080/download/apk-3.0.10-linux-rh.tar.gz
   

   The APK files download.

6. Upgrade the APK.
   1. Set the working directory by changing the directory to the appliance root. The appliance root is located below the volume mount point.

      For example:

      

   2. Unpack the APK.

      In the files, notice the name of the file holding the apk is "apk-3.0.10-linux-rh.tar.gz"; This is the red hat apk, version 3.0.10. 

      

   3. Run the APK install script.

      

      Press Enter. The install continues.

   4. cat version.tag to validate upgrade. The version displayed should be the same as the version number on the downloaded apk-*.tar.gz file.

      

   5. Remove the tmp files

      

   6. Exit vol manage.

   The APK upgrade is complete.

7. Start the application and test the appliance.
8. Update any scripts that you created, particularly on custom appliances, that need to use the new features that the APK offers.

   For additional information on using the new features, refer to Customize Appliance Behavior.

9. Move the appliance to the catalog.
   1. Shut down the application.
   2. Move the appliance to the catalog. All applications using that appliance will be automatically updated when you restart their corresponding application.
   3. Delete the sandbox application.