Installing an Ephox Editor manually

Installing an Epoxy editor manually is provided as a fallback in case, for whatever reason, the automated installers don't work or you prefer to install manually rather than using the installation wizard.

Before you begin

Before beginning installation, be sure to review the information in the IBM Connections documentation on customizations.

About this task

Procedure

  1. Locate the IBM Connections Customizations directory, which is where the Ephox Editors for IBM Connections will be installed.
    The value for this path is provided by the CONNECTIONS_CUSTOMIZATION_PATH variable within WebSphere Application Server. For more information on IBM Connections customizations and the CONNECTIONS_CUSTOMIZATION_PATH, see theIBM Connections documentation on customizations..
  2. Within the CONNECTIONS_CUSTOMIZATION_PATH/javascript directory, create the installation location for the Ephox Editors for IBM Connections as follows:
    Create the following subdirectory structure: ephox/editors/connections, resulting in the following complete path: CONNECTIONS_CUSTOMIZATION_PATH/javascript/ephox/editors/connections.
    Note: If this directory already exists, then it indicates that previous Ephox editor customizations have been made to your IBM Connections environment. Any existing files in the CONNECTIONS_CUSTOMIZATION_PATH/javascript/ephox/editors/connections directory must be either deleted or moved to a new folder. It is best to back up these customizations to a separate folder before proceeding.
  3. Copy the Ephox Editors for IBM Connections integration files as follows:
    1. Locate the config directory within the root directory of the uncompressed Ephox Editors for IBM Connections package.
    2. Copy the contents of the config directory to the CONNECTIONS_CUSTOMIZATION_PATH/javascript/ephox/editlive/connections directory.
  4. Locate the IBM Connections Web Resources Provisioning directory, which is where the extension enabling Ephox Editors for IBM Connections will be installed.
    The Web Resources Provisioning directory was created during installation of IBM Connections. By default, this is CONNECTIONS_HOME/data/shared/provision/webresources, for example /opt/IBM/Connections/data/shared/provision/webresources.
  5. Copy the Ephox Editors for IBM Connections extension files as follows:
    1. Locate the editor directory within the root directory of the uncompressed installer package.
    2. Copy the editor directory and all of its contents to the Web Resources Provisioning directory.
  6. Update the IBM Connections cache as follows:
    Once Ephox Editors for IBM Connections has been deployed, the IBM Connections server must be notified of the changes.
    1. Clear the cache to ensure users download the new files from the server.
    2. Update the IBM Connections server cache by performing the steps outlined by the IBM Connections Post-Customization documentation.
    3. Restart the Common.ear enterprise application.
  7. Verify that all Epoxy editor services have installed correctly by navigating to the following URL in any web browser: http://<your server and port>/connections/resources/web/ephox.editors.connections/verify.HTML.
    If the installation has been successful, a confirmation message appears alongside installed version numbers.