Upgrade CCMS Web Server

Upgrading to IXIA CCMS Web 7.4 is mostly done by the installation script.

About this task

In this procedure, %InstallDir% is the folder where the previous version of CCMS Web Server is installed. The default installation directory depends on the operating system.

Windows: c:\Ixiasoft\ccms
Linux: /opt/ixiasoft/ccms

Note: You must manually delete or correct any duplicate active users in IXIA CCMS Web. The Web Installer will detect active duplicate users it finds, as well as report them and temporarily deactivate them for the web connection. You can delete them once installation is complete.

DTD validations occur at installation and during start up.

Upgrade CCMS Web Server:

Procedure

Download and unzip the package:
1. Go to the 7.4 area of the MadCap Software Downloads site:
  https://cms.ixiasoft.com/downloads/CCMS_7.4/
2. Click the CCMS_Web folder.
3. Enter the username and password given to you by IXIA CCMS Sales.
4. Click the latest .zip file of the installation package.
  For example:
  IXIASOFT-CCMS-Web-windows-1.2.3.zip
  
  IXIASOFT-CCMS-Web-[platform]-<version>.zip
  
  Where:
  
  The platform is either windows or linux and version is the latest build version of the installation package
5. Extract the zip file to a temporary folder on the local drive.
  
  Important: Do not use spaces in the path or filename. Do not extract to a location that would result in a long path.
Optional: In the location where you extracted the package, open and edit the properties.txt file in a text editor if required.

Important: For existing parameters, the installation script will reuse any existing values you set in the previous version of CCMS Web. You do not need to update them unless you want to change your configuration.

If you use SCCM to manage Windows updates on the server with CCMS Web, change the following Tomcat properties in the properties.txt file, if required:


Parameter	Describes
`TOMCAT_SHUTDOWN_PORT`	The port that the Apache Tomcat application server uses to listen for shutdown requests. The native service can trigger a signal to Tomcat's shutdown port, and Tomcat's own code can handle the rest. Default value: `8035`
`TOMCAT_AJP_PORT`	The port used for AJP implementation if in use. Default value: `8039`

MadCap Software has set new default values for Tomcat because SCCM (Microsoft's automated deployment and update tool) uses port 8005 for installing Windows updates, which was Tomcat's default shutdown port. Thus, Tomcat cannot bind to the port.

You only need to change the default values above if you want to set different values for these ports.

Optional: Make a full copy of the folder for the current CCMS Web installation.
MadCap Software recommends having a full copy of the existing folder as it simplifies reverting the changes if required.
Run the installation script.

Note: When upgrading to IXIA CCMS Web 7.4, the installation script uninstalls the current versions of Java, Tomcat, and Oxygen.
Java
The new version of Java is a local JDK that comes with the installation package, and it runs independently of what is installed on the server. No action is required.
Tomcat
The re-installation resets the Tomcat configuration. If you have modified the Tomcat configuration, save those values somewhere before running the installation script so you can reconfigure Tomcat afterward.
Oxygen
The installer creates a backup of the oxygenworkspace folder for the Oxygen configuration, which includes frameworks and plug--ins. No action is required to save values for the Oxygen configuration, but you must re-install all these additional frameworks and plug-ins after the update.
- Windows: Open a command prompt using Run as administrator, go to the folder where you extracted the installation script, and enter:
```
WindowsInstall.bat <InstallDir>
```
- Linux: Run the following command as root:
```
sh ./LinuxInstall.sh <InstallDir>
```
Verify that the script was successful:
1. In the folder where you extracted the installation script, open the installation.log file in a text editor.
2. Scroll to the end of the log and look for the message Installation successful.
  If the Installation successful message is missing, the installation failed.
If the installation failed, do the following:
1. Retrieve the properties from the previous installation, which is saved in the installation source folder in the file properties.txt.automerged.
  This is the same folder where WindowsInstaller.bat is located.
2. Clean-up the target folder if there are still files there.
3. Do a fresh install of CCMS Web 7.4.
  For more details, see the guide: Installing IXIA CCMS Web.
4. Reinstall your Oxygen frameworks and plug-ins, which the Web Installer saved in the backup folder.
  The Web Installer backs them up, it but does not automatically re-install them.
5. If you modified the Tomcat configuration for your previous CCMS Web installation, you must reconfigure Tomcat.
Verify that CCMS Web is at the correct version and is working by taking the following actions:
1. Go to the URL for CCMS Web, using the following pattern:
  http://[host name]:TOMCAT_HTTP_PORT/
  
  For example:
  
  http://localhost:8080/
2. On the login page, verify that the Version indicates 7.4.
3. Log in and verify that the first page opens as expected.
Reinstall your Oxygen frameworks and plug-ins, which the Web Installer saved in the backup folder.
The Web Installer backs them up, it but does not automatically re-install them.