Start of change

Upgrade considerations

This topic contains information about upgrading iSeries™ Access for Web from a previous release.

Upgrade process

Upgrading iSeries Access for Web from a previous release is performed in two steps.
  1. Install the new release of iSeries Access for Web on the iSeries server. This overlays the previous release of the product.
  2. Configure, or reconfigure, iSeries Access for Web. This enables the new functions provided in the new release and preserves all of the existing user-generated data.

Portal environment considerations

If the iSeries Access for Web default pages were created during the original portal configuration and you changed those pages, it is recommended that you do not re-create the default pages when you upgrade. If you re-create the pages, all customizations and configurations settings are lost.

The page creation option is a parameter on the iSeries Access for Web configuration command CFGACCWEB2. Specify WPDFTPAG(*NOCREATE) if you do not want to re-create the default pages. Specify WPDFTPAG(*CREATE) to create the default pages. Refer to the help text for the CFGACCWEB2 command and its parameters for more detail.

Note: If you used the IBM® Web Administration for iSeries wizard interface to create the portal instance and deploy the iSeries Access for Web portlets, the iSeries Access for Web default pages were created automatically.

Upgrade from V5R1 iSeries Access for Web

If you have V5R1 iSeries Access for Web (5722-XH1) installed on your server, installing V5R4 iSeries Access for Web (5722-XH2) has no impact on the V5R1 installation. V5R1 and V5R4 iSeries Access for Web can coexist on the same server.
When V5R4 iSeries Access for Web is configured using the CFGACCWEB2 command, the following automatically occur the first time the command is run:
  • V5R1 iSeries Access for Web user generated data is copied to the V5R4 iSeries Access for Web directory structure.
  • The V5R1 iSeries Access for Web policy information is copied to the V5R4 iSeries Access for Web configuration.
  • The V5R1 iSeries Access for Web file content-type (MIME-type) mappings are copied to the V5R4 iSeries Access for Web configuration.
To prevent these from happening automatically, follow these steps before running the CFGACCWEB2 command:
  1. Create the file /QIBM/UserData/Access/Web2/config/migration.properties.
  2. Using an editor, add was35migrationrun=true to the migration.properties file.
Related concepts
Checklist: Plan, install, and configure
Related tasks
Install iSeries Access for Web
Related reference
Configure iSeries Access for Web in a Web application server environment
Configure iSeries Access for Web in a portal environment
Related information
CFGACCWEB2 CL command
End of change