Installing WebSphere Commerce Developer fix packs with the IBM Installation Manager

You can install WebSphere Commerce Developer fix packs by using the IBM Installation Manager that you used to install WebSphere Commerce Developer. WebSphere Commerce fix packs should be installed and then tested. Fix packs contain fixes that correct known problems, so installing them might prevent you from having to place a service call. Before you install a WebSphere Commerce fix pack, review this information.

Before you begin

Install Rational Application Developer. To review the levels of Rational Application Developer that are supported by WebSphere Commerce Developer, see WebSphere Commerce Developer Version 7 software requirements. To determine the level of Rational Application Developer we recommend you install, see Recommended fixes and settings for WebSphere Commerce Version 7.
Ensure the machine on which you are installing meets all WebSphere Commerce Version 7 software requirements.
Stop any Java applications that are running on your machine.
Disable any Web server that you configured on your machine.
Log in to Windows as a user with Administrator privileges.
Ensure that the WebSphere Commerce Developer fix pack is downloaded and if necessary, unpackaged on your machine.
For each 7.0.0.x fix pack release there are three different fix pack packages for WebSphere Commerce Developer:
- A fix pack for WebSphere Commerce Developer Enterprise. For example, 7.0.0-WS-WCDeveloperEnterprise-FP00x.zip
- A fix pack for WebSphere Commerce Developer Professional. For example, 7.0.0-WS-WCDeveloperProfessional-FP00x.zip
- A fix pack for WebSphere Commerce Developer - Express. For example, 7.0.0-WS-WCDeveloperExpress-FP00x.zip
Where x is the fix pack number.
Additional steps are required after fix pack installation to incorporate the fixes into your configuration files and customization. It is important to review the steps before you begin your fix pack installation. Review Updating the WebSphere Commerce Build and Deployment tool after installing a WebSphere Commerce fix pack.
Back up any customized files that are to be altered during fix pack installation.
WebSphere Commerce fix packs update many files. Files that might be changed include the JSP files for starter stores and WebSphere Commerce Accelerator, LZX files for Management Center, and more. To see whether any files that you customized are altered by the fix pack:
1. Open the Fix packs for WebSphere Commerce technote.
2. Click the link to the fix pack you are installing.
3. See the Files Changed link on the fix pack install technote.
4. Review the files that are listed in the Files Changed document. If you made any custom modifications to any of these files, you must back them up before you apply the fix pack.
After the fix pack is applied, you must reimplement your customization against the updated files. For example, the fix pack updates the starter store archive files that are used only at store publish time. If you have a published store, review the Files Changed list to see whether any of the file changes are relevant to the store you published.
If you are installing Fix Pack 2 on a system that already has Feature Pack 1 installed, then, you must obtain and install the fix for JR38159 before you install Fix Pack 2.

Note: You can install WebSphere Commerce Developer, fix packs, and feature packs simultaneously on a machine where WebSphere Commerce is not previously installed, by adding all repositories to your IBM Installation Manager and then installing WebSphere Commerce Developer.

About this task

Important:

Ensure that WebSphere Commerce and WebSphere Commerce Developer are at the same fix pack level.
The database updates that are included in this fix pack cannot be undone. If you want to undo the database update after you apply the WebSphere Commerce fix pack, you must restore your database backup. For information about backing up your database, see your database documentation.

Procedure

Open Installation Manager.
Add the WebSphere Commerce Developer fix pack repository location to the Installation Manager:
1. On the Start page of Installation Manager, click File > Preferences, and then click Repositories.
  The Repositories page opens, showing any available repositories, their locations, and whether they are connected.
2. On the Repositories page, click Add Repository.
3. In the Add Repository dialog box, click Browse. Navigate to the location of your WebSphere Commerce Developer fix pack directory, select the repository.config file, then click OK.
  The new repository location is listed.
4. Click Test Connections to ensure that the Repository URL is available.
5. On the Start page of Installation Manager, click File>Preferences, and then click Files for Rollback. Ensure the option Save files for rollback is enabled.
From the Start page, click Update. The Installation Manager searches its defined repositories for available packages.
Select the WebSphere Commerce Developer package and click Next.
The Update packages wizard detects all of the applicable fixes. Recommended features are automatically selected. Select the updates that you want to apply and click Next.
The fix pack is automatically preselected. Click Next.
Accept the license agreement and click Next.
The Select the features to install panel is displayed. The feature is automatically selected. Click Next.
Review the summary information and click Update to install the updates.
Optional: Review the installation history by selecting File > Installation History
Check for the update in the logs in WCDE_installdir\logs\update\7.0.0-WS-WCDeveloperEnterprise-FP00x.install\updatelog.txt

Results

You successfully installed an update.

Note: WebSphere Commerce Developer fix packs and interim fixes might include updates to the workspace_dir folder, the WCDE_installdir/components folder and the workspace_dir/Stores folder. If you restore the development environment to a previous state, the updates to those folders will still exist.

What to do next

Refresh the workspace and republish the application after the fix pack is installed:

Open the WebSphere Commerce Developer and switch to the Enterprise Explorer view.
In the Explorer view, select all projects and select File > Refresh (or the F5 shortcut key) to refresh the projects in the workspace.
Start the WebSphere Commerce Test Server.
Right-click the test server in the Servers view and select Publish.
Wait for the application to finish publishing and to restart.

Update the files in your version control system:

The files that are listed in the wc700x_files_changed.txt file were replaced during the fix pack installation. If you customized any files that are listed in the wc700x_files_changed.txt file, you must merge the customized file into the new file.