Installing Fix Packs for IBM Worklight V5.0

Several installation methods are available and listed in the table below with an 'X'.

Installation Option	Worklight Studio	Worklight Server
Passport Advantage used by IBM Installation Manager	X	X
Archive file download from Fix Central used by IBM Installation Manager	X	X
Archive file download from Fix Central used as an Eclipse Update Site	X

Detailed instructions are provided in the sections below to step through each method of installation with one exception. A separate installation guide should be used when leveraging Passport Advantage. Also, where applicable, the supported version of IBM Installation Manager is 1.5.2 or above.

Note that when upgrading a Worklight Studio formerly installed with IBM Installation Manager, upgrades to that installation must also be done with IBM Installation Manager. The Eclipse P2 update version for an upgrade installation is not supported in that scenario.

Upgrading an existing version installed with IBM Installation Manager

If IBM Installation Manager was used to install a previous version (from either the IBM website or a local repository), upgrading to the fix pack can be done with the following steps. Note, an Internet connection is necessary.

1. Start IBM Installation Manager, which was used to install the existing 5.0 installation
2. Click Update
3. A list of installable packages will be presented
4. Click the packages you wish to update (Worklight for IBM Worklight Server, and IBM Software Delivery Platform for IBM Worklight Studio), or click Update all
5. Click Next and follow the instructions to complete the installation

Downloading the Fix Pack Archive from IBM Fix Central

From IBM Fix Central, fix packs are provided in archive (zip) file format for each of the product editions.

• Worklight Studio, as an Eclipse Update (P2)
• Worklight Studio, as an IBM Installation Manager repository
• Worklight Server, as an IBM Installation Manager repository

Follow these instructions to access the fix pack archives.

1. Visit the IBM Fix Central website
2. Under Product Group, click Other Software
3. Under Select from Other Software, click one of the following product editions
   • IBM Worklight Consumer Edition
   • IBM Worklight Enterprise Edition
   • IBM Mobile Foundation Consumer Edition
   • IBM Mobile Foundation Enterprise Edition
4. Under Installed Version, click the version you already have installed
5. Under Platform, click the target platform for the installation
6. Click Continue to enter the Identify fixes page
7. Click Browse for fixes
8. Click Continue to enter the Select fixes page
9. Click Show contained fixes to see the fixes included in the fix group
10. Select the group fix to download all or only the fixes you want.
11. Click Continue and follow the instructions to complete the download.

Installing the Fix Pack Archive with IBM Installation Manager

The instructions that follow apply to both the Worklight Studio and Worklight Server components, but are specific to using the archive file downloaded from IBM Fix Central in the format of an IBM Installation Manager repository. Once the fix pack has been accessed, there are two options based on the state of the base installation. If an existing install is being upgraded to a fix pack, the first set of instructions apply. Otherwise, if there is no base installation, then the second set of instructions apply.


Upgrading an existing 5.0 installation to a Fix Pack

Special Note: If upgrading from a Worklight Server version prior to 5.0.0.3, it is optimal to first uninstall and then use the instructions to do the installation with 5.0 and the fix pack concurrently. This will enable several installation features only present in 5.0.0.3 and later releases which handle automatic installation into existing application servers and databases.

1. Unzip the fix pack archive into a temporary_directory
2. Start IBM Installation Manager, which was used to install the existing 5.0 installation
3. Open the File menu and click Preferences
4. Click Add Repository
   • For Worklight Server: temporary_directory/500X/update/repository/repository.config
     where 500X represents the fix back being installed (5001, 5002, etc)
   • For Worklight Studio: temporary_directory/edition_identifier/disk1/diskTag.inf
     where edition_identified is one of IWSMFEE, IWSMFCE, IWSWEE or IWSWCE representing the name of the product edition
5. Click OK in the Add Repository window
6. Make sure the added repository is selected
7. Click OK in the Preferences window
8. Click Update and follow the steps presented to complete the installation

Installing 5.0 and a Fix Pack concurrently

1. Unzip the fix pack archive into a temporary_directory
2. If you don't have IBM Installation Manager 1.5.2 or later, perform the additional installation steps:
   • Download and unzip the archive file of the IBM Rational Enterprise Deployment
   • Install IBM Installation Manager from the archive
3. Start IBM Installation Manager
4. Open the File menu and click Preferences
5. Click Add Repository
6. Enter the location of the 5.0 repository
7. Click OK in the Add Repository window
8. A second time, click Add Repository
9. Enter the location of the fix pack repository configuration:
   • For Worklight Server: temporary_directory/500X/update/repository/repository.config.
     where 500X represents the fix back being installed (5001, 5002, etc)
   • For Worklight Studio: temporary_directory/edition_identifier/disk1/diskTag.inf
     where edition_identified is one of IWSMFEE, IWSMFCE, IWSWEE or IWSWCE representing the name of the product edition
10. Click OK in the Add Repository window
11. Make sure the added repositories are selected
12. Click OK in the Preferences window
13. Click Install and follow the steps presented to complete the installation

Installing the Fix Pack Archive as an Eclipse Update

The instructions that follow apply to the Worklight Studio component only, specific to using the archive file downloaded from IBM Fix Central in the format of an Eclipse Update (P2) site. Once the fix pack has been accessed, there are two options based on the state of the base installation. The fix pack can be installed directly into an Eclipse workspace without any existing version of the product installed. Alternatively, the fix pack can be applied as an update to an existing installation.

1. Start the Eclipse workbench
2. Open the Window menu and click Preferences
3. In the left panel, click Install/Update which will expand options below it
4. Click Available Software Sites
5. Click Add...
6. In the Add Site window enter a value in the Name field such as "IBM Worklight Update"
7. Click Archive..., navigate to the fix pack archive and click Open
8. Back in the Add Repository window, the Location field should now be filled in
9. Click OK to exit the Preferences window
10. Open the Help menu and click Check for Updates
11. In the Available Updates window, select the items you'd like to install or update
12. Click Next and follow the instructions to complete the installation