Migrating web server configurations | HCL Digital Experience
Migrate a web server so that it supports the latest version of WebSphere® Application Server. The Application Migration Toolkit for WebSphere® Application Server supports migrating applications from previous versions of WebSphere® Application Server to the latest product version.
- Install the new version in a new directory
- Install the new version in the same directory as the previous version
For information about migrating applications, read more about the Application Migration Toolkit at HCL Software Support.
Installing the new version of IBM® HTTP Server in a new directory
Procedure
- Install the Version 8.5 IBM® HTTP Server in a new directory.
- Optional: If you installed IBM® HTTP Server into a new directory and retained your previous version of IBM® HTTP Server, by default the administration server and the web server use the same ports as the previous version administration server and web server. If you ever run both versions of the IBM® HTTP Server simultaneously, port conflicts occur unless you change the port numbers for one of the server versions. To modify the port numbers for one of the IBM® HTTP Servers, edit the server configuration files for that IBM® HTTP Server. These files are in the http_server_install/conf directory.
- Optional:
Migrate web server definitions. A web server definition is used to manage the web server from a
stand-alone profile or the deployment manager.
- If you updated IBM® HTTP Server on the original host but in a new directory, update the path by selecting the web server: in the WebSphere® Integrated Solutions Console.
- If the updated IBM® HTTP Server is on a new host, follow the procedure in Selecting a web server topology diagram and roadmap to create a new web server definition. You can remove the old web server definition when you confirm that the new web server is working properly.
- Install the latest IBM® HTTP Server cumulative fix. Learn more about Recommended fixes for IBM HTTP Server.
Installing the new version of IBM® HTTP Server in the same directory as the previous version
Procedure
-
Migrate web server configurations.
- Change port assignments for coexisting IBM® HTTP Servers. To modify the port numbers for one of the IBM® HTTP Servers, edit the server configuration files for that IBM® HTTP Server. These files are in the http_server_install/conf directory.
-
Upgrade Apache plug-in modules.
There are no Apache API (application programming interface) changes from the previous major release, so there should be no need to rebuild modules that worked with the previous release. However, if you use modules from third-party vendors, contact your vendors to verify that they support the module with the version of IBM® HTTP Server to which you are upgrading.
Apache plug-in modules from sources other than the Version 8.5 IBM® HTTP Server must be built to support Apache 2.2. The distributors of modules that are used with older versions of IBM® HTTP Server might need to recompile the modules to support Apache 2.2.- WebSphere® Application Server provides a new plug-in for Apache 2.2 and IBM® HTTP Server 8.5.
- If you use modules from third-party vendors, contact your vendor for a version of the module that works with the Apache 2.2 API.
- If you use modules that were developed in-house, you must rebuild your modules to support Apache 2.2. The modules might also require some modifications.
-
Update the IBM® HTTP Server service name in the WebSphere® Application Server web server definition if the following conditions
are true:
- The server is a Windows™ server.
- You installed IBM® HTTP Server into the same directory where an earlier version was located.
- You are using a web server definition from that prior installation.
For an IBM® HTTP Server on a Windows™ server system, use 'Services' to determine the name that is used for the new IBM® HTTP Server service, and then update the web server definition to use this service name.
-
Migrate web server definitions. A web server definition is used to manage the web server from a
stand-alone profile or the deployment manager.
- If you updated IBM® HTTP Server on the same host and in the same directory, no action is required. The current web server definition suffices.
- If the updated IBM® HTTP Server is on a new host, follow the procedure in Selecting a web server topology diagram and roadmap to create a new web server definition. You can remove the old web server definition when you confirm that the new web server is working properly.
- Install the latest IBM® HTTP Server cumulative fix. Learn more about Recommended fixes for IBM HTTP Server.