Upgrading Viewer Extension

Do a silent upgrade for Viewer Extension.

About this task

Complete the following steps on the Deployment Manager server or one of the HCL Connections servers (wherever the installation for the previous release was run). These steps are based on Linux, but are basically the same for Windows. If you are upgrading from the Deployment Manager, ensure that the Deployment Manager node has access to the Connections provisions directory.


  1. Extract the installation files:
    1. Log into the server where Viewer Extension is installed with an administrative account.
    2. Extract native/ViewerLCCustomizeApp_2.0.0.zip to /opt/install/Docs/ViewerLCCustomizeApp.
  2. Update the cfg.properties file:
    1. Open the cfg.properties file for the previous release in a text editor such as gedit or nano:
      • gedit /opt/IBM/IBMViewer/extension/cfg.properties
    2. Review and update as applicable the following parameters in the file. Suggested default values are provided in the following table.
      Table 1. Default values for file
      Field Value
      ext_install_root /opt/IBM/IBMViewer/extension
      • /opt/IBM/WebSphere/AppServer/profiles/dmgr -or-
      • /opt/IBM/WebSphere/AppServer/profiles/DocsLab01
      Note: It depends upon where the upgrade is being run from.
      was_soap_port 8879
      auth_type Basic
      viewer_admin_j2c_alias <Leave blank because using BASIC auth>
      files_scope Cluster
      files_scope_name ConnectionsFilesCluster
      files_node_name <Leave blank because using clusters>
      news_scope Cluster
      news_scope_name ConnectionsNewsCluster
      news_node_name <Leave blank since using clusters>
      viewer_server_url http://Connections.renovations.com/viewer
    3. Save the file and close the editor.
  3. Run the upgrade:
    1. Open a terminal window in the root account.
    2. Navigate to the directory /opt/install/Docs/ViewerLCCustomizeApp/installer.
    3. Run the following command: ./upgrade.sh -installRoot /opt/IBM/IBMViewer/extension.
    4. A license agreement is displayed. If you accept the agreement, press the "a" key and then press Enter.
    5. When prompted, enter your WebSphere Application Server credentials. Suggested default values for your credentials are provided in the following table:
      Table 2. WebSphere® Application Server credentials
      Field Value
      WAS Administrative Username wasadmin
      WAS Administrator password password
    6. When the installer is finished, the command prompt is displayed. If an error occurred with the install process, the configuration reverts. Correct the error and try again.
    7. Review the extensionUpgrade.log file for errors and repeat this task if necessary. The log file is in the /opt/IBM/IBMViewer/extension/logs directory.
      Note: You can set the following option for the upgrade script:
      • -h: Displays help for the upgrade arguments.