Step 4: Complete the migration

This topic describes the manual steps that you might need to perform to complete the migration process. These are steps that are not performed automatically by the WebSphere Application Server - Express migration tools.

Enable the administrative console

The administrative console is disabled by default in Express instances, and must be enabled before it can be used. Even if you migrate from a 5.0.x instance where the administrative console is enabled, the console is not enabled automatically in the 5.1.x instance. For instructions on enabling the administrative console, see Start the WebSphere administrative console.

Note: If migrating a secured 5.0.x Express instance, the migrated 5.1.x instance will also have security enabled. Secure instances cannot be managed through the HTTP Server Administration interface, so to enable the administrative console in a secured instance, follow the instructions for starting the console without using the HTTP Server Administration interface.

Change the HTTP transport after migration
If the -portBlock parameter was not specified in the WASPostUpgrade script, you need to use the WebSphere Application Server - Express administrative console to adjust the ports manually after migration has completed."

1. Use the WebSphere Application Server - Express administrative console to change the HTTP transport port:
   1. Navigate to Servers --> Application Servers --> my_server where my_server is the name of the application server that was migrated.
   2. Click Web Container.
   3. Click HTTP transports.
   4. Click on a host.
   5. Adjust the Port property by entering a port not currently in use on your iSeries server. Record both the old and new port numbers; they are needed for step 2.
   6. Click OK.
   7. Repeat for each host.
2. Adjust your Virtual hosts to correspond to your HTTP transport.
   1. Click Environment --> Virtual Hosts.
   2. Select your virtual host.
   3. Click Host Aliases.
   4. Click New.
   5. Select one of the ports that were changed in step 1.
   6. Enter the port that this was changed to in step 1.
   7. Click OK.
   8. Repeat for each port that was changed in step 1.
3. Click Save.
4. Regenerate your plugin configuration.
   1. Navigate to Environment --> Update Web Server Plugin.
   2. Click OK.

Migrate the web server plug-in
If the WebSphere Application Server Version 3.5.x plug-in for your web server uses Open Servlet Engine (OSE) transport, you must switch to HTTP transport when migrating to WebSphere Application Server - Express.

The following instructions are specific to the Web server being supported and assume that you can successfully migrate existing Web applications:

Plug-in migration has been tested with the following Web server products:

• IBM HTTP Server (original) for iSeries (V4R5)
• IBM HTTP Server (powered by Apache) for iSeries (V5R1)
• Lotus Domino HTTP Server

Use the following steps to migrate the plug-in configuration:

1. Configure an HTTP server instance
   There are two options to chose from:
   • Create a new HTTP server instance to be used by the WebSphere Application Server - Express instance. This method allows both Websphere Version 3.5.x and WebSphere Application Server - Express instances to continue operating correctly.

   • Update the HTTP server instance configuration for the Websphere Version 3.5.x instance that is being migrated. This method changes the HTTP instance configuration to work with the WebSphere Application Server - Express instance and makes the Websphere Version 3.5.x instance no longer usable.

   For more information, see Start the HTTP Server Administration interface.

2. Configure the virtual host for the WebSphere Application Server - Express instance.
   This step ensures that both the host and HTTP transport port number exist in the virtual host list. For more information, see Manage virtual hosts for your application server in the Administration topic.

3. Regenerate the Web server plugin configuration
   This step needs to be done after any configuration changes have been made.

Change the ConnectionIOTimeOut properties for the Web container

Peformance changes to the WebSphere HTTP plug-ins may result in InterruptedIOTimeout exceptions while reading large requests, such as receiving file uploads to a servlet. Increase the ConnectionIOTimeout value in the Web Container of your application as follows:

1. In the topology tree, expand Servers and click Application Servers.
2. On the Application Servers page, click the name of the server that you want to modify.
3. On the server's detail page, click Web Container.
4. On the Web Container page, click HTTP Transports.
5. On the HTTP Transports page, click the transport that you want to modify.
6. Click Custom properties.
7. Click New and add a property named ConnectionIOTimeout. Set the property to the maximum time a servlet or JSP waits for a client to transmit request data.

8. After you add a virtual host alias, you must restart the application server. See Start and test your application server in the Administration topic for more information.