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.
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.
Registering HCL Docs in Connections News
You can register HCL Docs in Connections News. Then when you @mention a person in comments, the person can see a notification in their home page. The person can also receive an email depending on their email notification duration settings.

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.
  - 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.
    - Configuring the IBM® HTTP Server
      Configure the IBM® HTTP Server as a reverse proxy server to route HCL Docs, File Viewer, and Conversion requests to the appropriate servers.
    - Configuring the Windows™ task scheduler for the Conversion server
      This task must be completed on each of the Conversion servers. The HCL Docs conversion server has monitors to ensure that the processes that convert the different documents into formats that are used by the HCL Docs editors are available and working properly. It is done through the task schedulers in Windows™. To ensure these schedulers are active and available, they need to be configured properly for your Windows environment.
    - Changing Symantec Endpoint Protection (SEP) settings
      In some customers' environment, SEP (Symantec Endpoint Protection) is running on the Conversion server. Its default configuration causes serious NFS access performance issue. Follow the steps to change SEP settings to avoid this problem.
    - Restarting the Servers
      Once you have set the servers to start automatically and configured the task schedulers, validate that the configuration is correct by restarting the servers on which the HCL Docs components are installed.
    - Registering HCL Docs in Connections News
      You can register HCL Docs in Connections News. Then when you @mention a person in comments, the person can see a notification in their home page. The person can also receive an email depending on their email notification duration settings.
    - Testing your deployment
      Verification of the installation is necessary to ensure HCL Docs is operational. Follow this procedure to verify that all components of HCL Docs are working.
    - Optional post-installation tasks
      Complete the post-installation tasks that are relevant to your deployment.
  - 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.

Registering HCL Docs in Connections News

You can register HCL Docs in Connections News. Then when you @mention a person in comments, the person can see a notification in their home page. The person can also receive an email depending on their email notification duration settings.

Procedure

Start the wsadmin client from the following directory of the system on which you installed the Deployment Manager:
app_server_root\profiles\dm_profile_root\bin

where app_server_root is the WebSphere Application Server installation directory and dm_profile_root is the Deployment Manager profile directory, typically dmgr01.
For example: cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin/ ./wsadmin.sh -lang jython -user {WASADMIN} -password {PASSWORD} -port {PORT}
Start the Jython script interpreter for the News repository.
1. Use the following command to access the News configuration file: execfile("newsAdmin.py")
2. If prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, you must select the node where the file is stored.
Use the following commands: NewsActivityStreamService.listApplicationRegistrations()

Take one of the following actions:

If the result includes ibmdocs as shown in the following sample:

{blogs=blogs, forums=forums, wikis=wikis, communities=communities, files=files, ecm_files=Libraries, profiles=profiles, dogear=dogear, 
activities=activities, homepage=homepage, ibmdocs=Docs}

Run the following command:

NewsActivityStreamService.updateApplicationRegistrationForEmailDigest("IBMDocs", "true", "INDIVIDUAL", "false")

If the result does not include ibmdocs, run the following command:

NewsActivityStreamService.registerApplication("IBMDocs", "Docs", "", "", "", "", "Docs", "true")  
NewsActivityStreamService.updateApplicationRegistrationForEmailDigest("IBMDocs", "true", "INDIVIDUAL", "false")

Note: For more information, see Registering third-party applications in the HCL Connections documentation.

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.