Using the automated Uninstall for Unix, Linux, and AIX systems

For Unix, Linux and AIX server deployments, a shell script is provided that automates the uninstall process.

Procedure

  1. Note the Location of the HCL Connections Customizations directory.
    The Tiny Editor for HCL Connections uninstaller needs to be provided with the location of your HCL Connections Customization path. The value for this is provided by the CONNECTIONS_CUSTOMIZATION_PATH variable within the WebSphere Application Server. For more information on HCL Connections customizations and the CONNECTIONS_CUSTOMIZATION_PATH see the HCL Connections documentation on customizations.
    Note: The Tiny Editor for HCL Connections uninstaller only requires the root customizations directory as provided by this variable.
  2. Note the Location of the HCL Connections Web Resources Provisioning directory.
    The Tiny Editors for HCL Connections installer needs to be provided with the path to your Web Resources Provisioning directory. This folder allows extensions for Connections to be installed. For information on locating the HCL Connections Web Resources Provisioning directory, please see the HCL Connections Documentation Extending JavaScript in HCL Connections.
  3. Run the Uninstall script.
    The uninstallation script, uninstall.sh, is located in the root directory of the Tiny Editors for HCL Connections package. This script can be executed from any AIX, UNIX, OS X or LINUX environment that has SSH access to the HCL Connections server. To uninstall the Tiny editors for HCL Connections, execute the uninstall.sh script as follows:
    ./uninstall.sh USER@HOSTNAME CUSTOMIZATIONS_DIR WEBRESOURCES_DIR
    This script requires the following parameters:
    • USER The user name to use for SSH access to the HCL Connections server. This user must have write access to both the Customizations directory and the Web Resources Provisioning directory.
    • HOSTNAME The hostname for the HCL Connections server. If running the script on the same machine that the integration is to be installed on, localhost should be used.
    • CUSTOMIZATIONS_DIR The exact value of the CONNECTIONS_CUSTOMIZATION_PATH variable.
    • WEBRESOURCES_DIR The location of the Web Resources Provisioning directory.
      Note: This script will automatically perform a backup of the information currently contained in the CONNECTIONS_CUSTOMIZATION_PATH/javascript/ephox/textbox/connections directory and the 'Web Resources Provisioning' directory. The backup will be contained in a subdirectory of Textbox.io. This ensures previously customized configuration is not deleted by accident. If you do not wish for a backup to be created run the uninstall script with the optional --no-backup parameter, for example:
      ./uninstall.sh --no-backup USER@HOSTNAME CUSTOMIZATIONS_DIR WEBRESOURCES_DIR
    The Tiny Editor for HCL Connections integration files in the Web Resources Provisioning directory will not be backed up regardless of whether --no-backup is used.
  4. Update the HCL Connections cache. To ensure that the Tiny Editor is immediately removed and made unavailable the HCL Connections server cache must be notified to update itself.
    To update the HCL Connections server cache, perform the steps outlined by the HCL Connections Post-Customization documentation.
    Note: If after performing this step, the Tiny Editor is still available (see the next verification step on how to verify the uninstall), then restarting the Common enterprise application may be necessary to force a cache update.
  5. Verify Uninstall.
    Browse to the edit screen for a wiki or blog to verify that the Tiny Editor is no longer available as the rich text editor within HCL Connections and that rich text editing has reverted to the default editor.