Skip to content

Install on Linux or Unix

The installation of Tiny Editors for HCL Connections on Linux or Unix is automated using a shell script.

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.
  • 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

  • Attention: We strongly recommend:

  • Setting up SSH key access to the Connections host server.

  • Using a local SSH agent to avoid password prompts when logging in via SSH. The following script makes numerous connections, and connection prompts for a password if SSH keys are not used.

  • Run the install.sh script located in the root directory of the Tiny Editors for HCL Connections package as follows:

    ./install.sh user@host\_name customization\_path provision\_path/webresources 
    

    CAUTION:

    Remember to append /webresources to the provision_path in the above command.

    Note: This command will automatically backup any existing configuration it finds in

    • customization_path/javascript/tiny/editors/connections
    • customization_path/javascript/ephox/editors/connections
    • customization_path/javascript/ephox/editlive/connections If a backup of configurations is not required, run the install script with the optional --no-backup parameter, e.g.:
    ./install.sh --no-backup user@host\_name customization\_path provision\_path/webresources
    
    ./install.sh root@p-ce-conncr5-01 /shared_content/customization /shared_content/provision/webresources
    Please read and accept the license agreement to continue.
    Use up and down arrow keys to scroll. For other commands please run 'man more' at your shell prompt.
    
    International Program License Agreement
    
    **\*\*LICENSE TEXT OMITTED FOR BREVITY\*\***
    
    Do you accept the terms and conditions outlined in the licence agreement? (Y/N): Y
    
    Installing Tiny Editors for HCL Connections to root@p-ce-conncr5-01
    
    Note: We recommend setting up ssh key access otherwise this process will prompt for the ssh password several times.
    
    Deploying editor to /shared_content/provision/webresources
    ---------------------
    sending incremental file list
    .d..t...... ./
    <f+++++++++ tiny.editors.connections_4.0.1.3.jar
              3.82M 100%  164.35MB/s    0:00:00 (xfr#1, to-chk=0/2)
    ---------------------
    Deploying configuration to /shared_content/customization/javascript/tiny/editors/connections
    ---------------------
    .d..t...... ./
    <f+++++++++ config.js
    <f+++++++++ tiny-editors-lite.css
    <f+++++++++ tiny-editors.css
    ---------------------
    
    Install complete.
    
    For the changes to take effect, please perform the required post-customization step, as described in
      https://help.hcltechsw.com/connections/v6/admin/customize/t_admin_common_customize_postreq.html
    
    And then restart the Common.ear webapp.
    
  • Follow the post-customization steps to ensure the server cache is updated.

  • 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.

Parent topic:Installing Tiny Editors integration