Upgrade Generic Windows Server Appliances

Using CA AppLogic › Appliance Developer Guide › Appliance OS Installations › Common Components › Windows APK › Upgrade the Windows APK › Upgrade Generic Windows Server Appliances

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.

The following steps use the example of upgrading a WIN08S appliance.

Follow these steps:

Open the GUI, then create and open a new application. This creates a sandbox application that you delete in the final step.
The application displays in the Infrastructure Editor.
- Drag an instance of the WIN08S appliance from the system_ms catalog to the canvas.
- Branch the class instance.
- Right click the singleton and select Modify Boundary. The Class Definition dialog box displays.
  In the Documentation URL field, enter the catalog datasheet URL. For example:
  
  http://doc.3tera.com/AppLogicxx/en/index.htm?toc.htm?CatGenericWindows.html.
  
  where xx is the new version of AppLogic
  
  Click OK. The Infrastructure Editor displays.
- Save and start the application. Do not close the GUI.
Open a 3t shell and ssh into the running singleton.
- Set a new Administrator password, such as net user administrator newpwd.
- Note the IP address of the DHCP server for the internal interface using
```
ipconfig /all | grep 'DHCP Server' 
```
- Change the directory
```
cd /cygdrive/c
```
- Use wget and the IP address noted above to obtain the current Windows Server exe from the grid controller. For example:
```
wget http://ip-address:8080/download/Server_Windows-*.exe
```
- Use the following to change permissions
```
chmod 755 *.exe
```
- Do not close the 3t shell.
Open a Windows command line
- Change the directory to C:\
- Verify the permissions with:
```
dir /Q
```
- Change the permissions of the cygwin and appliance directories.
```
takeown.exe /A /R /F C:\appliance
takeown.exe /A /R /F C:\cygwin
```
- Delete the following directories:
  rmdir /S /Q C:\appliance
  
  rmdir /S /Q C:\cygwin
- Execute the installer. For example, run Server_Windows-3.7.14.exe
Access the GUI and select the application. The application displays in the Infrastructure Editor.
- Click the Restart icon. This stops and restarts the application. The application updates the parameters, such as setting a random admin password, that were manually updated in the previous steps.
- Click the Stop icon.
- Drag the singleton to the user catalog.
Access the 3t shell and execute the following commands to destroy or archive the existing class:
- To destroy the existing class
```
class destroy /system_ms:WIN08S --force 
```
- To archive the existing class
```
class move /user:WIN08S /system_ms:WIN08S 
```
Access the GUI, then destroy the application that you created in step 1.