Upgrading to EditLive! for IWWCM 3.0

EditLive! for IWWCM 3.0 includes a new version of the EditLive! editor, EditLive! 6.0.  To upgrade your install of EditLive! for IWWCM you will require a new license key.  Please contact Ephox support to receive your new key.

The new version of EditLive! packaged with EditLive! for IWWCM also includes a variety of new features which can be enabled via configuration settings.  For more information please see the EditLive! Upgrade Guide.

Also available for licensing with EditLive! for IWWCM 3.0 is the new EditLive! Productivity Pack with track changes, thesaurus and equation editor.  For more information see the EditLive! Productivity Pack homepage.

Upgrade instructions for:

For IBM Web Content Management version 6.0

To upgrade to a new release of the Ephox integration into IWWCM, perform the following steps:

  • If the integration is configured to use the sample_eljconfig.xml configuration file, and you have made changes to this file (e.g. adding your license details, adding additional menu or toolbar items), you'll need to back this configuration file up. Simply rename the file sample_eljconfig.xml.bak.
  • Install the latest release of the Ephox integration as directed in the Installation Instructions.
  • If using the sample_eljconfig.xml configuration file, you'll need to port your desired configurations from your backed-up instance of sample_eljconfig.xml.bak into the new copy of the file.
  • The version 3.x releases Ephox integration into IWWCM use the EditLive! 6.0 editor. If you are currently operating a release of the Ephox integration into IWWCM with a version number less than 3.0.0.1, you'll need to obtain a new EditLive! license from Ephox to use EditLive! 6.0. Apply this license key to any EditLive! configuration files used by your integration.

To locate the version number for your currently installed integration, see the res/editlivejava/versions.txt file in your IWWCM install)

For more information about enabling new functionality in EditLive! for IWWCM 3.0 please see the EditLive! Upgrade Guide.

For IBM Web Content Management versions 5.1.0.x

If you have previously installed an instance of the Ephox integration into IWWCM, you'll need to perform several steps to ensure your desired functionality is carried over to this new release.

First, ensure you backup your entire IWWCM install directory (i.e IBMDIR\PortalServer\installedApps\WCM_Authoring_UI_AUTHORVERSION.ear \AUTHORVERSION.war\).

To locate the current version number for your integration, perform the following steps

  1. Locate your IWWCM install directory (i.e IBMDIR\PortalServer\installedApps\WCM_Authoring_UI_AUTHORVERSION.ear \AUTHORVERSION.war\)
  2. This directory will contain either a folder called ephox or redistributables.  Open this folder.
  3. Open the versions.txt file. This file will display the IBM platform you're currently operating on, as well as the version number for the Ephox integration.

Note
If your install contains a redistributables directory but has no versions.txt file, you'll need to follow the same instructions below outlined below for an install version of 1.6.0.17

If you have been running a release of the integration with a version number of 1.6.0.17
or below, you will need to perform the following steps:

  • Copy any configuration files you've created or edited to a temporary location. After completing the installation of the latest version of the IWWCM integration, you'll have to edit the code in ephoxDefineUser.jsp (located in
    ephox/instantiation    ) to instantiate your desired configuration files. Open this file using a text editor to see examples of how to reference your configuration file.
  • Copy your instance of Editor.jsp to a temporary location. If you've created any customizations to the Editor.jsp file, you will be required to contact Ephox to ensure these changes are ported into the new integration framework.
  • Delete the redistributables directory.

If you have been running a release of the integration with a version number of higher than 1.6.0.17 you will need to perform the following:

  • Copy the ephoxDefineUser.jsp and customFunctionality.jsp files from the ephox/instantiation directory to a temporary directory.  After completing the installation of the IWWCM integration replace the default copies of these files with your backed-up versions.
  • Copy any configuration files you have created or edited to a temporary location.  After completing the installation of the latest version of the IWWCM integration, you will have to edit the code in ephoxDefineUser.jsp (located in ephox/instantiation) to instantiate your desired configuration files.  Open this file using a text editor to see examples of how to reference your configuration file.

For more information about enabling new functionality in EditLive! for IWWCM 3.0 please see the EditLive! Upgrade Guide.

For IBM Web Content Management version 5.1

If you have previously installed an instance of the Ephox integration into IWWCM, you'll need to perform several steps to ensure your desired functionality is carried over to this new release.

First, ensure you backup your entire IWWCM install directory (i.e IBMDIR\PortalServer\installedApps\WCM_Authoring_UI_AUTHORVERSION.ear \AUTHORVERSION.war\).

To locate the current version number for your integration, perform the following steps

  1. Locate your IWWCM install directory (i.e IBMDIR\PortalServer\installedApps\WCM_Authoring_UI_AUTHORVERSION.ear \AUTHORVERSION.war\)
  2. This directory will contain either a folder called ephox or redistributables.  Open this folder.
  3. Open the versions.txt file. This file will display the IBM platform you're currently operating on, as well as the version number for the Ephox integration.

Note
If your install contains a redistributables directory but has no versions.txt file, you'll need to follow the same instructions below outlined below for an install version of 1.6.0.5

If you have been running a release of the integration with a version number of 1.6.0.5
or below, you will need to perform the following steps:

  • Copy any configuration files you've created or edited to a temporary location. After completing the installation of the latest version of the IWWCM integration, you'll have to edit the code in ephoxDefineUser.jsp (located in
    ephox/instantiation    ) to instantiate your desired configuration files. Open this file using a text editor to see examples of how to reference your configuration file.
  • Copy your instance of Editor.jsp to a temporary location. If you've created any customizations to the Editor.jsp file, you will be required to contact Ephox to ensure these changes are ported into the new integration framework.
  • Delete the redistributables directory.

If you have been running a release of the integration with a version number of higher than 1.6.0.5 you will need to perform the following:

  • Copy the ephoxDefineUser.jsp and customFunctionality.jsp files from the ephox/instantiation directory to a temporary directory.  After completing the installation of the IWWCM integration replace the default copies of these files with your backed-up versions.
  • Copy any configuration files you have created or edited to a temporary location.  After completing the installation of the latest version of the IWWCM integration, you will have to edit the code in ephoxDefineUser.jsp (located in ephox/instantiation) to instantiate your desired configuration files.  Open this file using a text editor to see examples of how to reference your configuration file.

For more information about enabling new functionality in EditLive! for IWWCM 3.0 please see the EditLive! Upgrade Guide.

For IBM Web Content Management version 2.5

If you have previously installed an instance of the Ephox integration into IWWCM, you'll need to perform several steps to ensure your desired functionality is carried over to this new release.

First, ensure you backup your entire IWWCM install directory (i.e IBMDIR\PortalServer\installedApps\ilwwcm-aut_ng-portlet_AUTHORVERSION.ear \AUTHORVERSION.war\).

To locate the current version number for your integration, perform the following steps

  1. Locate your IWWCM install directory (i.e IBMDIR\PortalServer\installedApps\ilwwcm-aut_ng-portlet_AUTHORVERSION.ear \AUTHORVERSION.war\)
  2. This directory will contain either a folder called ephox or redistributables.  Open this folder.
  3. Open the versions.txt file. This file will display the IBM platform you're currently operating on, as well as the version number for the Ephox integration.

Note
If your install contains a redistributables directory but has no versions.txt file, you'll need to follow the same instructions below outlined below for an install version of 1.6.0.15

If you have been running a release of the integration with a version number of 1.6.0.15
or below, you will need to perform the following steps:

  • Copy any configuration files you've created or edited to a temporary location. After completing the installation of the latest version of the IWWCM integration, you'll have to edit the code in ephoxDefineUser.jsp (located in
    ephox/instantiation    ) to instantiate your desired configuration files. Open this file using a text editor to see examples of how to reference your configuration file.
  • Copy your instance of Editor.jsp to a temporary location. If you've created any customizations to the Editor.jsp file, you will be required to contact Ephox to ensure these changes are ported into the new integration framework.
  • Delete the redistributables directory.

If you have been running a release of the integration with a version number of higher than 1.6.0.15 you will need to perform the following:

  • Copy the ephoxDefineUser.jsp and customFunctionality.jsp files from the ephox/instantiation directory to a temporary directory.  After completing the installation of the IWWCM integration replace the default copies of these files with your backed-up versions.
  • Copy any configuration files you have created or edited to a temporary location.  After completing the installation of the latest version of the IWWCM integration, you will have to edit the code in ephoxDefineUser.jsp (located in ephox/instantiation) to instantiate your desired configuration files.  Open this file using a text editor to see examples of how to reference your configuration file.

For more information about enabling new functionality in EditLive! for IWWCM 3.0 please see the EditLive! Upgrade Guide.