Upgrading HCL Docs 1.0.6 to 2.0 on Linux

Follow these steps to upgrade HCL Connections™ Docs 1.0.6 for Linux to version 2.0.

About this task

Make sure you upgrade databases when upgrading to 2.0 following instructions in Upgrading the database.

Procedure

  1. Download the DOCS_INSTALLPKG_FILENAME.zip file, for example, CNNCTNS_DOCS_2.0.0_WINLNX_ML.zip, from IBM Passport Advantage. Extract the contents to /opt/software.
  2. Depending on whether Installation Manager is 32 byte or 64 byte, do one of the following actions:
    • For the 32-byte Installation Manager:
      1. Copy /opt/software/upgrade/106/linux/32/com.ibm.docs.im.installer_1.0.6.20141106_1604.jar and /opt/software/upgrade/105/32/com.ibm.docs.im.installer_1.0.6.20141106_1604_SE.jar to /var/ibm/InstallationManager/installRegistry/metadata/Offerings.
        Note: A non-root user must copy the files to user home/var/ibm/InstallationManager/installRegistry/metadata/Offerings.
      2. Open /opt/software/upgrade/106/32/installed.xml and copy the "IBM Connections Docs" section to /var/ibm/InstallationManager/installed.xml.
      3. Open /opt/software/upgrade/106/32/installed.xml and copy the "IBM Connections Docs" section to /var/ibm/InstallationManager/installed.xml.
    • For the 64-byte Installation Manager:
      1. Copy /opt/software/upgrade/106/linux/64/com.ibm.docs.im.installer_1.0.6.20141105_2328.jar and /opt/software/upgrade/106/64/com.ibm.docs.im.installer_1.0.6.20141105_2328_SE.jar to /var/ibm/InstallationManager/installRegistry/metadata/Offerings.
        Note: A non-root user must copy the files to user home/var/ibm/InstallationManager/installRegistry/metadata/Offerings.
      2. Open /opt/software/upgrade/106/32/installed.xml and copy the "IBM Connections Docs" section to /var/ibm/InstallationManager/installed.xml.
      3. Open /opt/software/upgrade/106/64/installRegistry.xml and copy the "IBM Connections Docs" section to /var/ibm/InstallationManager/installRegistry.xml.
  3. Manage the properties files. For example, if the installation directory is /opt/IBM/ConnectionsDocs, use the following table to create each new directory and identify the 1.0.6 properties file to copy to it.
    Table 1. Sample new directories and 1.0.6 properties files to copy to them

    Table showing 1.0.7 directories to create and which 1.0.6 properties files to copy to them.
    Command to create new directory Properties file to copy to new directory
    mkdir /opt/IBM/ConnectionsDocs/Docs 1.0.6 Docs cfg.properties/cfg.node.properties
    mkdir /opt/IBM/ConnectionsDocs/Conversion 1.0.6 Conversion cfg.properties/cfg.node.properties
    mkdir /opt/IBM/ConnectionsDocs/Viewer 1.0.6 Viewer cfg.properties
    mkdir /opt/IBM/ConnectionsDocs/DocsExt 1.0.6 Docs Ext cfg.properties
    mkdir /opt/IBM/ConnectionsDocs/ViewerExt 1.0.6 Viewer Ext cfg.properties
    mkdir /opt/IBM/ConnectionsDocs/DocsProxy/proxy 1.0.6 Docs Proxy cfg.properties
    mkdir /opt/IBM/ConnectionsDocs/Docs/config 1.0.6 %docs_install_root%/config/*
    mkdir /opt/IBM/ConnectionsDocs/Conversion/config 1.0.6 %conversion_install_root%/config/*
    mkdir /opt/IBM/ConnectionsDocs/Viewer/config 1.0.6 %viewer_install_root%/config/*
    mkdir /opt/IBM/ConnectionsDocs/Docs/version 1.0.6 Docs %docs_install_root%/version/version.txt
    mkdir /opt/IBM/ConnectionsDocs/Conversion/version 1.0.6 Conversion %conversion_install_root%/version/version.txt
    mkdir /opt/IBM/ConnectionsDocs/Viewer/version 1.0.6 Viewer %viewer_install_root%/version/version.txt
    mkdir /opt/IBM/ConnectionsDocs/DocsExt/version 1.0.6 Docs Ext %docs_install_root%/extension/version/version.txt
    mkdir /opt/IBM/ConnectionsDocs/ViewerExt/version 1.0.6 Viewer Ext %viewer_install_root%/extension/version/version.txt
    mkdir /opt/IBM/ConnectionsDocs/DocsProxy/proxy/version 1.0.6 Docs Proxy %docs_install_root%/proxy/version/version.txt
  4. Start the installation program and click Update.
    Note: Keep the selections for the products integration and components unchanged when you update.