Upgrading Editor Extension

Do a silent upgrade of the Editor Extension.

Before you begin

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

Procedure

  1. Extract the installation files:
    1. Log into the server where Editor Extension is installed with an administrative account.
    2. Extract native/DocsLCExtension_2.0.0.zip to /opt/install/Docs/DocsLCExtension.
  2. Update the cfg.properties file:
    1. Open the cfg.properties file from the previous release in a text editor such as gedit or nano:
      • gedit /opt/IBM/IBMDocs/extension/cfg.properties
    2. Review and update as necessary 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/IBMDocs/extension
      was_dm_profile_root
      • /opt/IBM/WebSphere/AppServer/profiles/dmgr -or-
      • /opt/IBM/WebSphere/AppServer/profiles/DocsLab01
      Note: depending upon where the upgrade is being run from
      was_soap_port 8879
      ic_extension_path /opt/IBM/ConnectionsData/provision/webresources
      deamon_shared_path /opt/IBM/ConnectionsData
      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 because using clusters>
      common_scope Cluster
      common_scope_name ConnectionsCommonCluster
      common_node_name <Leave as Blank because using clusters>
      docs_server_url http://Connections.example.com/docs
      ignore_event false
      auth_type BASIC
      docs_admin_j2c_alias connectionsAdmin
      ic_version 4.5
      restart_connections False
    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 following directory: /opt/install/Docs/DocsLCExtension/installer
    3. Execute the following command: ./upgrade.sh -installRoot /opt/IBM/IBMDocs/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 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 upgrade is finished, the command prompt is displayed. If an error occurred with the upgrade process, the configuration is reversed. Correct the error and try again.
      Note: When you are upgrading the HCL Docs extension, Connections will not be restarted automatically. You must restart Connections manually for best results.
    7. Review the icext_upgrade.log file for errors and repeat this task if necessary. The log file is in the /opt/IBM/IBMDocs/extension/logs directory.
      Note: You can set the following option for the upgrade script:
      • -h: Displays help for the upgrade arguments.