HCL TECHNOLOGIES ABOUT US PRODUCTS & SOLUTIONS RESOURCES CONTACT US

Home
Deploying IBM Connections Docs 2.0 CR3Welcome to the IBM Connections Docs 2.0 CR3 documentation, where you can find information about installing and deploying IBM Docs 2.0 CR3. IBM Docs is a collaborative productivity suite that enables you to work on documents, spreadsheets and presentations together in the cloud. If you have IBM Docs 2.0, IBM Docs 2.0 CR1, or CR2 already installed, to install CR3, you only need to download the IBM Docs 2.0 CR3 zip package from FixCentral and extract the package. Then follow the instructions in the PDF file to install CR3. But if you have a version prior to IBM Docs 2.0, before installing CR3 package, you must follow instructions in this guide to install and deploy IBM Docs 2.0.
Upgrading or migratingYou can upgrade IBM® Connections Docs from the previous two releases to the current release by using the installer or upgrade scripts. You can also install the latest release on new hardware and then do a side-by-side migration from the old to the new.
Upgrading to IBM Docs 2.0You can upgrade IBM® Connections Docs from the previous two releases to the current release by using the installer or upgrade scripts.
Upgrading IBM Docs using the scriptsIf you do not want to use the installer to upgrade, perform the procedures to upgrade IBM Docs using the scripts.
Upgrading Editor ProxyDo a silent upgrade of Editor proxy.

Upgrading Editor Proxy

Do a silent upgrade of Editor proxy.

About this task

The steps are based on Linux, but are basically the same for Windows.

Procedure

Extract the Installation Files
1. Log into the server where Editor Proxy is installed with an administrative account.
2. Extract native/DocsProxyFilter_2.0.0.zip to /opt/install/Docs/DocsProxyFilter.

Update the cfg.properties file

Open the cfg.properties file from previous releases in a text editor such as gedit or nano.
- gedit /opt/IBM/IBMDocs/proxy/cfg.properties

Review and update as needed, the following parameters in the file. An example is provided in the table.

Table 1. Default values for file
Field	Value
docs_install_root	/opt/IBM/IBMDocs
was_proxy_profile_root	/opt/IBM/WebSphere/AppServer/profiles/Docs01 -or- /opt/IBM/WebSphere/AppServer/profiles/dmgr Note: depending upon where the upgrade is being run from
was_soap_port	8879
was_ipc_port	<Leave as Blank>
scope	Cluster
proxy_scope_name	IBMDocsProxyCluster
proxy_node_name	<Leave as Blank since using cluster>
docs_context_root	/docs

Save the file and exit the editor.

Run the upgrade
1. Open a terminal window under the root account
2. Navigate to the directory: /opt/install/Docs/DocsProxyFilter/installer
3. Execute the following command: ./upgrade.sh -installRoot /opt/IBM/IBMDocs
4. You will be presented with a License agreement. If you accept the agreement, press the 'a' key followed by enter.
5. When prompted, enter your WebSphere® Application Server credentials.
  Table 2. WebSphere Application Server credentials
  
  Field Value
  
  WAS Administrative Username wasadmin
  
  WAS Administrator password password
6. When the upgrade is finished, it will return you to the command prompt. If an error occurred with the upgrade process, it will revert the configuration. Correct the error and try again.
7. Check the proxy_upgrade.log file for errors. If some WebSphere Application Server settings are updated, the detailed upgrade information is in was_config_upgrade.log. These logs will be located in the /opt/IBM/IBMDocs/proxy/logs directory.
  Note: You can set options for the upgrade scripts:
  - -h: Displays help for the installation arguments.