This section provides information about upgrading from a previous version of IBM® HTTP Server.
About this task
IBM HTTP Server can coexist with earlier versions if you
install the recent version into a different directory. You can also upgrade earlier versions of IBM HTTP Server by installing the recent version into the
directory where an the earlier version of IBM HTTP Server is
located. Using the same installation path on the same system for the new IBM HTTP Server version preserves the validity of the WebSphere® Application Server web server definition, but with a minor exception
for a Windows server where the service name must be
modified in the server definition to the service name used for the new version.
If you migrate from an IBM HTTP Server earlier than a
previous major release, read the product documentation for the interim IBM HTTP Server version(s) and review the migration information. You may need
to complete additional steps.
For an alternative procedure that preserves the current installation path and starts with the
httpd.conf
file from the earlier release, see Migrating IBM
HTTP Server 8.5 configurations to 9.0 in place.
Procedure
-
Upgrade IBM HTTP Server from your previous
installation.
When you upgrade IBM HTTP Server from a previous version,
complete the following steps to install the new version in the same directory location as the
previous version. If the new version is installed in a different directory, you do not need to
complete Steps 1 - 4. Whether you need to complete the remaining steps depends on how similar you
want to make the current configuration to the configuration of a previous version of IBM HTTP Server.
- Stop the IBM HTTP Server and the IBM HTTP Server administration server.
-
Copy the existing installation directory to a new location.
-
Uninstall the previous IBM HTTP Server version.
-
Remove the previous installation directory.
-
Install IBM HTTP Server.
If upgrading your existing version, install into the directory where the previous installation
was located.
If installing the new version alongside an existing version, install the new version into a
different directory.
-
Run the Plug-ins Configuration Tool, the pct tool, to configure your web server plug-ins. Refer
to the Configuring a web server plug-in using the pct tool topic for information on
running the pct tool.
- Restore any custom configurations that were made to your previous version of IBM HTTP Server and IBM HTTP
Server administration server. For an alternative procedure on migrating the configuration files, see
Migrating IBM HTTP Server configuration files from a previous release.
- Identify your previous customizations.
If you used the httpd.conf
configuration files provided with the previous version of IBM
HTTP Server as the starting point for your configuration files, compare the content of each
configuration file, with its corresponding .default
file, within the directory
containing your previous IBM HTTP Server installation. For
example, if you compare the content of the httpd.conf
file with the
httpd.conf.default
file you should see any customization that were made to the
httpd.conf
file since the original installation. Then perform similar comparisons
for the other configuration files.
If you did not use the httpd.conf
configuration files that are provided with the previous version of IBM HTTP Server as the starting point for your configuration files, you must complete a more
manual analysis to determine your previous settings. In this scenario, you might want to compare the
settings in the httpd.conf.default
file that is provided with the new IBM HTTP Server, with the settings in the
httpd.conf.default
file that is provided with the previous IBM HTTP Server version. This comparison enables you to identify configuration
differences in the two httpd.conf.default
files. You can then use this information
to modify your customized configuration file to work with the current IBM HTTP Server.
Compare the bin/envars
file to the
bin/envars-std
file within the directory containing your previous IBM HTTP Server installation. This identifies what customizations, if any, that
were made to this file.
- Merge the customizations into the newly installed IBM HTTP
Server configuration and
envars
files. After you identify the configuration
customizations you made to your previous version of IBM HTTP
Server, make these same changes, when applicable, to the configuration files for the current IBM HTTP Server.
- Restore HTML content.
If your web page content was previously stored under
your IBM HTTP Server installation directory, copy those
content files from the directory that contains your prior version of IBM HTTP Server into the installation directory for the new
version.
- Copy any SSL KeyFiles, that might be within the installation directory of the previous
IBM HTTP Server, into the new installation
directory.
-
Change port assignments for coexisting IBM HTTP Servers.
If you installed the IBM HTTP Server into a new directory
and retained your previous version of the 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 will 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 located in the http_server_install/conf
directory.
-
Upgrade Apache plug-in modules.
All Apache modules used with IBM HTTP Server 9.0 must be
built for the Apache 2.4 API or they will fail to load.
- WebSphere Application Server provides a new plug-in
for Apache 2.4 and IBM HTTP Server.
- If you use modules from third party vendors, contact your vendor for a version of the module
that works with the Apache 2.4 API (application programming interface).
- If you use modules developed in-house, you must rebuild your modules to support Apache 2.4. The
modules might also require some modifications.
-
Update the IBM HTTP Server service name.
Update the IBM HTTP Server service name in the WebSphere Application Server web server definition if the
following conditions apply:
- You are using 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 used for the
new IBM HTTP Server service, and then update the web server
definition to use this service name.