Upgrading BMC Helix Client Gateway

Use the information in this topic to upgrade from an older version of the BMC Helix Client Gateway to the latest version. Refer to the following topics for more information about BMC Helix Client Gateway.

• Requirements - System requirements and Gateway configuration options.
• Installing - Downloading the installation files and installing the BMC Helix Client Gateway for the first time.
• Configuring - BMC Helix Client Gateway configuration elements and adding a proxy.

To upgrade the gateway service for Windows

1. Extract the setup files to the existing installation directory.
   For example, C:\Program Files\Kaazing.
   
    
2. Copy the configuration files kwic-config.xml and truststore.db from the previous version to the current version. 
   For example, copy from <PREVIOUS_KWIC_DIR>\conf to <NEW_KWIC_DIR>\conf.
   
    
3. Replace the license.xml file in the license folder and remove all other license folder contents.
   
    
4. Stop the Kaazing KWIC Service via the Windows Services console.
5. Set the Startup type of Kaazing KWIC Service to Manual via the Windows Services console.
   
    
6. To uninstall the old service: 
   1. Open Command Prompt as administrator.
   2. Run the following command from the <PREVIOUS_KWIC_DIR>\ext\bin folder: 
      kwic.service.exe remove
      
       
7. To install the new service: 
   1. Open Command Prompt as administrator.
   2. Run the following command from the new installation directory: 
      kwic.setup.exe -service or kwic.setup.exe -s
      
       
8. Validate that the Kaazing KWIC Service is installed and functional.
   

If issues occur, roll back to the previous version and contact BMC Helix Support.

To upgrade the gateway service for Linux

1. Extract the upgrade tarball to the desired directory.
   For example, /opt/bmc.
   
    
2. Copy the configuration files kwic-config.xml and truststore.db from the previous version to the current version. 
   For example, copy from <PREVIOUS_KWIC_DIR>/conf to <NEW_KWIC_DIR>/conf.
   
    
3. Replace the license.xml file in the license folder and remove all other license folder contents.
4. Stop the running Kaazing process using the following commands:
   • ps -ef | grep kwic - to get the PID of the Kaazing service.
   • kill -9 <pid> - to kill the process.
     If you have configured a systemd service, use it to stop the Kaazing Gateway service.
     
      
5. Start the new gateway from the <NEW_KWIC_DIR>/conf/bin directory using: 
   ./gateway.start & or nohup ./gateway.start &
   
    
6. (Optional) If you are using systemd, update paths in the service file and run: 
   systemctl daemon-reload
7. Validate that the Developer Tools function properly.

If issues occur, stop the client gateway process, restart the WebSocket service, and contact BMC Helix Support.