Install manually

The manual install process requires copying files into the right locations and restarting some services.

Before you begin

Before you begin:
  • Determine the host_name of the server hosting HCL Connections™.
  • Get user access as the HCL Connections™ installer or higher administrative permissions, on both:
    • The host server.
    • The WebSphere Application Server Console.

Procedure

  1. Optional: Stop the Common WebSphere enterprise application.
    1. Log in to the web interface of the WebSphere Application Server Console.
      The default address is: https://host_name:9043/ibm/console
    2. Navigate to Applications > Application Types > WebSphere enterprise applications.
      Websphere enterprise applications link
    3. Select the checkbox for Common from the list of applications and click Stop.
      Stop the Common application
      Figure 1. Dialog shown when Common application is stopped
      Message shown when the Common application is stopped
  2. Determine the Connections paths (customization_path and provision_path).
    1. Log in to the web interface of the WebSphere Application Server Console.
      The default address is: https://host_name:9043/ibm/console
    2. Expand Environment and click the WebSphere variables link.
      WebSphere Variables link
    3. Find the CONNECTIONS_CUSTOMIZATION_PATH in the variables list and record the value which will be referred to as customization_path from this point.
      Connections customization path variable
    4. Find the CONNECTIONS_PROVISION_PATH in the variables list and record the value which will be referred to as provision_path from this point.
      Connections provision path variable
  3. In the customization_path/javascript directory, create the subdirectory tiny/editors/connections.
    Note: If the directory already exists, delete or move the contents to a new folder before proceeding.
  4. Install the Tiny Editors for HCL Connections configuration files:
    1. Locate the config directory in the uncompressed Tiny Editors for HCL Connections package.
    2. Copy the contents of the config directory to the customization_path/javascript/tiny/editors/connections directory.
  5. Install the Tiny Editors for HCL Connections jar file:
    1. Locate the editor directory in the uncompressed Tiny Editors for HCL Connections package.
    2. Copy the editor/tiny.editors.connections_version.jar to the provision_path/webresources directory.
  6. Follow the post-customization steps to ensure the server cache is updated.
  7. Optional: Start the Common WebSphere enterprise application.
    1. Log in to the web interface of the WebSphere Application Server Console.
      The default address is: https://host_name:9043/ibm/console
    2. Navigate to Applications > Application Types > WebSphere enterprise applications.
      Websphere enterprise applications link
    3. Select the checkbox for Common from the list of applications and click Start.
      Start the Common application
      Figure 2. Dialog shown when Common application is started
      Message shown when the Common application is started
  8. Verify the install:
    1. Browse to the following URL: http://host_name_and_port/connections/resources/web/tiny.editors.connections/verify.html
      If the installation was successful, a confirmation message appears alongside the installed version numbers.
    2. Browse to the edit screen for a wiki or blog.
      If the installation was successful, the Tiny editors will be loaded.
    Note: If Tiny Editors for HCL Connections is not available, restart the Common enterprise application to force a cache update.