Upgrade considerations

 

When upgrading iSeries™ Access for Web from a previous release, there are considerations when using the portal environment and when upgrading from V5R1.

 

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.

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 system, 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 system.

When V5R4 iSeries Access for Web is configured using the CFGACCWEB2 command, the following automatically occur the first time the command is run:

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.

 

Parent topic:

Prerequisites for installing iSeries Access for Web

Related concepts
Checklist: Planning, installing, and configuring

Related tasks
Installing iSeries Access for Web
Related reference
Configuring iSeries Access for Web in a Web application server environment Configuring iSeries Access for Web in a portal environment
Related information
CFGACCWEB2 CL command