Creating Appliances › Distribution Installations › Windows Installation Reference › Windows MSI Upgrade Reference

Windows MSI Upgrade Reference

If you have built a Windows appliance and want at some point to install a newer version of the MSI used to create that appliance, thereby updating the Windows APK and any appliance specific scripts contained in the MSI, this topic provides step-by-step instructions for doing this. The instructions are segregated by type of appliance.

WIN03* / WIN08* - Generic Windows Server Appliances

The following steps describe the process for upgrading a generic Windows server appliance, using /system_ms:WIN08S as an example.

1. Create a new application and open it in the infrastructure editor. Drag an instance of the WIN08S appliance from the system_ms catalog onto the canvas and branch the class instance.
2. Modify the boundary of the singleton as follows:
   • Set the documentation URL to https://support.ca.com/cadocs/0/CA%203Tera%20Applogic%203%200-ENU/Bookshelf_Files/HTML/Catalog_Ref/CatGenericWindows.html.
3. Save and then start the application.
4. From a 3t shell, ssh into the running singleton and perform the following:
   • Set a new Administrator password, for example net user administrator newpwd.
   • ipconfig /all | grep DHCP Server and note the IP address of the DHCP server for the internal interface.
   • cd / and then use wget to obtain the current Windows Server MSI from the grid controller using the IP address noted above, for example wget http://ip-address:8080/download/Server_Windows-1.1.7-1.msi
   • chmod 755 *.msi
5. Open the graphic console for the singleton and log in as Administrator.
6. Execute the MSI installer, for example double-click on the file Server_Windows-1.1.7-1.msi within Windows Explorer.
7. In the ssh session open on the singleton:
   • rm -f *.msi
   • Set a new complex Administrator password, for example net user administrator a3893hf092jfww.^JDFoi8hfwehohgw
   • Exit and then ssh back into the running singleton
   • rm -f ~/.bash_history
   • Exit
8. Stop the application. In the application editor drag the singleton into the user catalog.
9. Execute the following commands in a 3t shell:

   class destroy /system_ms:WIN08S --force (or move the existing class if you want to preserve it). 
   class move /user:WIN08S /system_ms:WIN08S 
   

10. Destroy the application.

VDS_Win* - Windows VDS Singleton Appliances

The following steps describe the process for upgrading the singleton in a Windows VDS application, using the application VDS_Win08S_r2 as an example.

1. Create a new application and open it in the infrastructure editor. Drag an instance of the WIN08S appliance from the system_ms catalog onto the canvas and branch the class instance.
2. Save and then start the application.
3. From a 3t shell, ssh into the running singleton and do the following:
   • Set a new Administrator password, for example net user administrator newpwd.
   • ipconfig /all | grep DHCP Server and note the IP address of the DHCP server for the internal interface.
   • cd / and then use wget to obtain the current Windows VDS MSI from the grid controller using the IP address noted above, for example wget http://ip-address:8080/download/VDS_Windows-1.2.4-1.msi
   • chmod 755 *.msi
4. Open the graphic console for the singleton and log in as Administrator.
5. Execute the MSI installer, for example double-click on the file VDS_Windows-1.2.4-1.msi within Windows Explorer.
6. In the ssh session open on the singleton:
   • rm -f *.msi
   • Set a new complex Administrator password, for example net user administrator a3893hf092jfww.^JDFoi8hfwehohgw
   • Exit and then ssh back into the running singleton
   • rm -f ~/.bash_history
   • Exit
7. Stop the application.
8. Execute the following commands in a 3t shell:

   vol destroy VDS_Win08S_r2:VDS_WIN08S.boot --force 
   vol copy app-name:WIN08S.boot VDS_Win08S_r2:VDS_WIN08S.boot where app-name is the name of the application you have created. 
   

9. Destroy the application app-name.

IIS03* / IIS08* - Windows IIS Web Server Appliance

The following steps describe the process for upgrading a Windows IIS appliance, using /system_ms:IIS08S as an example.

1. Create a new application and open it in the infrastructure editor. Drag an instance of the IIS08S appliance from the system_ms catalog onto the canvas and branch the class instance.
2. Modify the boundary of the singleton as follows:
   • Set the documentation URL to https://support.ca.com/cadocs/0/CA%203Tera%20Applogic%203%200-ENU/Bookshelf_Files/HTML/Catalog_Ref/CatWebServersIIS.html.
3. Create a 100 MB ntfs08 volume (or ntfs03 volume for Windows Server 2003 based IIS appliances) and configure the singleton to use this volume as its content volume.
4. Save and then start the application.
5. From a 3t shell, ssh into the running singleton and do the following:
   • Set a new Administrator password, for example net user administrator newpwd.
   • ipconfig /all | grep DHCP Server and note the IP address of the DHCP server for the internal interface.
   • cd / and then use wget to obtain the current Windows IIS MSI from the grid controller using the IP address noted above, for example wget http://ip-address:8080/download/IIS_Windows-1.1.1-1.msi
   • chmod 755 *.msi
6. Open the graphic console for the singleton and log in as Administrator.
7. Execute the MSI installer, for example double-click on the file IIS_Windows-1.1.1-1.msi within Windows Explorer.
8. In the ssh session open on the singleton:
   • rm -f *.msi
   • Set a new complex Administrator password, for example net user administrator a3893hf092jfww.^JDFoi8hfwehohgw
   • Exit and then ssh back into the running singleton
   • rm -f ~/.bash_history
   • Exit
9. Stop the application. In the infrastructure editor, drag the singleton into the user catalog.
10. Execute the following commands in a 3t shell:

    class destroy /system_ms:IIS08S --force (or move the existing class if you want to preserve it). 
    class move /user:IIS08S /system_ms:IIS08S 
    

11. Destroy the application.

SQL08* - Windows SQL Server Appliance

The following steps describe the process for upgrading a Windows SQL appliance, using /system_ms:SQL08S_08 as an example.

1. Create a new application and open it in the infrastructure editor. Drag an instance of the SQL08S_08 appliance from the system_ms catalog onto the canvas and branch the class instance.
2. Modify the boundary of the singleton as follows:
   • Set the documentation URL to http://doc.3tera.net/AppLogic29/CatDatabaseAppliancesSQL.html.
3. Create a 3 GB raw volume and configure the singleton to use this volume as its data volume.
4. Save and then start the application.
5. From a 3t shell, ssh into the running singleton and do the following:
   • Set a new Administrator password, for example net user administrator newpwd.
   • ipconfig /all | grep DHCP Server and note the IP address of the DHCP server for the internal interface.
   • cd / and then use wget to obtain the current Windows SQL MSI from the grid controller using the IP address noted above, for example wget http://ip-address:8080/download/SQL_Windows-1.1.1-1.msi
   • chmod 755 *.msi
6. Open the graphic console for the singleton and log in as Administrator.
7. Execute the MSI installer, for example double-click on the file SQL_Windows-1.1.1-1.msi within Windows Explorer.
8. In the ssh session open on the singleton:
   • rm -f *.msi
   • Set a new complex Administrator password, for example net user administrator a3893hf092jfww.^JDFoi8hfwehohgw
   • Exit and then ssh back into the running singleton
   • rm -f ~/.bash_history
   • Exit
9. Stop the application. In the infrastructure editor, drag the singleton into the user catalog.
10. Execute the following commands in a 3t shell:

    class destroy /system_ms:SQL08S_08 --force (or move the existing class if you want to preserve it). 
    class move /user:SQL08S_08 /system_ms:SQL08S_08 
    

11. Destroy the application