Upgrading Leap on a traditional platform

The following instructions describe how to upgrade Leap by using the WebSphere® Application Server Administrative console.

Before you begin

  • Download the upgrade package from HCL License Portal.
  • Back up your existing installation prior to installing the update.
  • Back up your DB2® or Oracle database before you install the update.

Procedure

To back up your current Leap installation:
  1. Export the Leap EAR file.
    1. Open the WebSphere® Application Server Administrative console.
    2. Go to Applications > Application Types > WebSphere enterprise applications.
    3. Select Leap.
    4. Click Export.
    5. Click Leap.ear to download the installation file as a backup.

After the backup is complete, use the following instructions to install the upgrade file.

  1. Stop the Leap server.
    1. Go to Applications > Application Types > WebSphere enterprise applications
    2. Select Leap, and click Stop.
  2. Check the version of your currently installed Leap.
    You need the version number in step 4c.
    1. Go to Modules > Display module build Ids.
    2. Check the version for the HCL Leap WAR. An example module version is  Leap 9.0.0.0 GA.
  3. Update the Leap installation.
    1. Return to Applications > Application Types > WebSphere enterprise applications > Leap, and click Update.
    2. In the Application update options, select Replace the entire application.
    3. In Specify the path to the replacement ear file, select Local file system, and provide the location of the EAR file you downloaded from HCL License Portal.
    4. Click Next.
    5. In Preparing for the application update, click Next.
      Do not change the default settings on the page.
    6. On the Install New Application page, go to Step 3: Map resource references to resources.
      • In the javax.mail.Session table, set the Target Resource JDMI Name. Click Browse and select <Leap Mail Session>.
      • In the javax.sql.DataSource table, set the Target Resource JDMI Name. Click Browse and select <Leap Data Source>.
    7. Click Next.
    8. Go to Step 4: Map virtual hosts for Web modules to validate that both Virtual host names are identical and correct, then click Next.
    9. Click Finish to save the update.

If Leap is running on nodes that are managed by Deployment Manager, you must synchronize all nodes where Leap is installed.

  1. Open the WebSphere® Application Server Administrative console.
  2. Go to System Administration > Nodes.
  3. Select all nodes where Leap is installed.
  4. Click Synchronize.

When the upgrade is complete, restart the Leap server.

  1. Go to Applications > Application Types > WebSphere enterprise applications
  2. Select Leap.
  3. Click Start.
If you use Leap with WebSphere® Portal , you must update the Leap Portlet.
  1. Log in to WebSphere® Portal as an administrative user.
  2. Go to Portlet Management > Web Modules and locate LeapPortlet.war.
  3. Click the Update Web module icon.
    The Update Web module icon is located to the right of the Web module properties icon.
  4. Click Browse to select the updated version of the Leap Portlet, and click Next.
  5. Review your changes and click Finish.