Home
Deploying HCL Connections Docs 2.0.1
Welcome to the HCL Connections Docs 2.0.1 documentation, where you can find information about installing and deploying HCL Docs 2.0.1. HCL Docs is a collaborative productivity suite that enables you to work on documents, spreadsheets and presentations together in the cloud.
Installing
To install HCL Docs, complete the following procedures in the sequence shown.
Pre-installation tasks
A series of pre-installation tasks must be completed before you can deploy the HCL Docs infrastructure. These tasks include installing the system prerequisites and configuring both Windows™ and Linux™ operating systems.
Configuring CCM and other repositories for use with Docs
You can use HCL Docs with repositories other than HCL Connections Files. This section describes how to configure Connections Content Manager (CCM) as the repository, or, how to configure a repository outside of Connections, IBM Content Navigator (ICN).
Configuring other repositories for use with Docs
You can integrate HCL Docs with repositories outside of HCL Connections, such as IBM Content Navigator or other content management systems.
Other repositories: Configuring IBM Content Navigator for use with Docs
To integrate HCL Docs with an IBM Content Navigator(ICN) repository, you must change your ICN configuration profile to include IBM Content Management Interoperability Services(CMIS) and IBM FileNet Collaboration Services(FNCS). Make sure you have installed IBM Content Navigator 2.0.3 FP3 or above.

Deploying HCL Connections Docs 2.0.1
Welcome to the HCL Connections Docs 2.0.1 documentation, where you can find information about installing and deploying HCL Docs 2.0.1. HCL Docs is a collaborative productivity suite that enables you to work on documents, spreadsheets and presentations together in the cloud.
- Overview
  HCL Connections™ Docs extends HCL Connections, offering real-time, co-editing support designed to help users collaborate on documents together.
- Planning
  Before installing HCL Docs, review the system requirements and deployment options, and then complete the worksheets.
- Installing
  To install HCL Docs, complete the following procedures in the sequence shown.
  - Pre-installation tasks
    A series of pre-installation tasks must be completed before you can deploy the HCL Docs infrastructure. These tasks include installing the system prerequisites and configuring both Windows™ and Linux™ operating systems.
    - Install HCL Connections
      Install HCL Connections, including the WebSphere® Deployment Manager at the minimum fix pack level, and create a Connections cell to contain HCL Docs. For details on system compatibility, see the System Requirements.
    - Configuring the operating systems
      Before you install any more applications, you need to make some changes to the operating systems on the servers.
    - Installing Python
      The HCL Docs deployment requires a Python 2.7.3 or later runtime environment. For non-Windows installations, ensure that Python is installed on the Connections Deployment Manager and on all Linux™ servers hosting an File Viewer, HCL Docs, or HCL Docs proxy node.
    - Installing WebSphere® Application Server
      The IBM® WebSphere® Application Server installation consists of two parts: IBM Installation Manager and the WebSphere Application Server itself.
    - Configuring HCL Docs shared storage
      The shared storage for the Editor Server and Document Format Conversion Server uses NFSv3 or CIFS, and the shared storage for the Viewer Server and Document Format Conversion Server uses either NFSv3 or CIFS. Procedures for both the NFS and CIFS cases are provided -- complete the tasks appropriate to your deployment.
    - Preparing the HCL Docs database infrastructure
      HCL Connections™ Docs has dependencies on IBM DB2 or Oracle database products.
    - Removing clusters and servers
      Before you install, check whether any cluster and server names that you want to use already exist, for example, IBMDocsCluster, IBMDocsMember 1,...,n, IBMConversionCluster, IBMConversionMember1,...,n , IBMViewerCluster, IBMViewerMember1,...,n, IBMDocsProxyCluster and IBMDocsProxyMember1,...,n. If they already exist, you must remove them.
    - Installing extra language packs
      For some locales, you might have to install extra language packs for an operating system.
    - Preparing the Sametime® chat infrastructure
      If you want to use HCL Connections™ Docs with HCL Sametime® to add presence awareness and chat capability inside documents, you must set up the integration between these two products.
    - Configuring CCM and other repositories for use with Docs
      You can use HCL Docs with repositories other than HCL Connections Files. This section describes how to configure Connections Content Manager (CCM) as the repository, or, how to configure a repository outside of Connections, IBM Content Navigator (ICN).
      - Configuring CCM for use with Docs
        To integrate HCL Connections™ Docs with CCM (Connections Content Manager), you must install IBM CMIS and the add-on IBM Content Navigator 2.0.3 HCL Docs Extensions.
      - Configuring other repositories for use with Docs
        You can integrate HCL Docs with repositories outside of HCL Connections, such as IBM Content Navigator or other content management systems.
        Other repositories: Configuring IBM Content Navigator for use with Docs
        To integrate HCL Docs with an IBM Content Navigator(ICN) repository, you must change your ICN configuration profile to include IBM Content Management Interoperability Services(CMIS) and IBM FileNet Collaboration Services(FNCS). Make sure you have installed IBM Content Navigator 2.0.3 FP3 or above.
  - Installing the HCL Docs components
    You can run theHCL Docs GUI Installer or use the scripts to install the components.
  - Post-installation tasks
    These post-install steps are required after an installation or uninstall/install of HCL Docs. During an upgrade, these changes are preserved so do not need to be repeated during the upgrade process.
  - Uninstalling HCL Docs components
    You can use the installer or use uninstall scripts to uninstall HCL Docs automatically.
- Upgrading or migrating
  You can upgrade HCL 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.
- Security
  You might need to refer to this section during deployment. HCL Docs supports WebSEAL. This section is for setting up single sign-on (SSO) if installing HCL Docs in the same cell as IBM® Connections.
- Performance tuning
- Troubleshooting and support
  To isolate and resolve problems with your deployment, you can use the troubleshooting and support information.

Other repositories: Configuring IBM Content Navigator for use with Docs

To integrate HCL Docs with an IBM Content Navigator(ICN) repository, you must change your ICN configuration profile to include IBM Content Management Interoperability Services(CMIS) and IBM FileNet Collaboration Services(FNCS). Make sure you have installed IBM Content Navigator 2.0.3 FP3 or above.

About this task

Important: The following steps apply only to using HCL Docs directly with ICN repositories. They do not apply to the requirement to use ICN in conjunction with CCM (Connections Content Manager) repositories for HCL Docs.

Note: There is a known issue of integrating HCL Docs with ICN 2.0.3 FP5. Upgrade to 2.0.3 FP6 if you want to integrate HCL Docs.

Procedure

Install IBM CMIS for FileNet Content Manager. Refer to Installing IBM CMIS for CCM and HCL Docs integration for details.

Note: In the ICN environment, by default the ICN profile is not configured to include the CMIS application. If you want to change the ICN profile or creating a new one, see Creating a configuration profile .
Configure and deploy IBM FNCS. Refer to IBM FileNet Collaboration Services.
Install the HCL Docs extension and grant users permission on the object store. Refer to Installing the IBM Content Navigator add-ons.
Install HCL Docs Integration plug-in in ICN console. Go to Configuring the HCL Docs Integration plug-in.
Create configuration xml file for server to server communication.
1. Check the file ${DMGR_PROFILE_PATH}/config/cells/${CELL_NAME}/LotusConnections-config/LotusConnections-config.xml. If you cannot find this file, create a new one with following content:
```
<?xml version="1.0" encoding="UTF-8"?>
<config id="LotusConnections" xmlns="http://www.ibm.com/LotusConnections-config" 
xmlns:sloc="http://www.ibm.com/service-location" xmlns:tns="http://www.ibm.com/LotusConnections-config" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com/LotusConnections-config LotusConnections-config.xsd">
<customAuthenticator name="DefaultAuthenticator"/>
</config>
```
2. If the file ${DMGR_PROFILE_PATH}/config/cells/${CELL_NAME}/LotusConnections-config/LotusConnections-config.xml already exists, make sure it contains customAuthenticator element.
3. Synchronize HCL Docs nodes and restart HCL Docs.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.