Migrating Web server configurations

You can migrate a Web server from supporting an earlier version of WebSphere® Application Server to support the current version.

Procedure

  1. Configure an HTTP server instance.

    Read the "Configuring an HTTP server instance" article in the information center for more information.

    There are two options from which to choose:
    • Create a new HTTP server instance to be used by the WebSphere Application Server Version 7.0 profile.

      This method allows WebSphere Application Server Version 5.1.x or Version 6.x and Version 7.0 profiles to continue operating correctly.

    • Update the HTTP server instance configuration for the WebSphere Application Server Version 5.1.x or Version 6.x profile that is being migrated.

      This method changes the HTTP instance configuration to work with the WebSphere Application Server Version 7.0 profile and makes the WebSphere Application Server Version 5.1.x or Version 6.x profile no longer usable.

  2. Configure the virtual host for the WebSphere Application Server Version 7.0 profile.

    Read the "Configuring virtual hosts" article in the information center for more information.

    This step ensures that both the host and HTTP transport port number exist in the virtual host list.

    If you created a new HTTP server in the previous step or if you used the -portBlock parameter when performing the migration, the virtual host will not contain the correct port for communication with your HTTP server. You need to add a host alias for the port used by your HTTP server.

  3. Configure communication with Web servers.

    Read the "Communicating with Web servers" article in the information center for more information.

    This step regenerates the plug-in configuration file, plugin-cfg.xml. It needs to be done after any configuration changes have been made.

    Additional configuration is required if Secure Sockets Layer (SSL) is enabled on a plug-in transport. In addition to copying the .kdb file to the Version 7.0 profile, you must edit the plug-in to specify the .kdb file required for the plug-in to use the transport.

    For more information on copying the .kbd files to the Version 7.0 profile, read the section on J2EE security in Configuration mapping during product-configuration migration.

What to do next

Plug-in considerations when you are migrating from WebSphere Application Server Version 5.1.x to Version 7.0In WebSphere Application Server Version 7.0, the plug-in configuration file has a one-to-one relationship with a Web server.
  • The plug-in configuration file (plugin-cfg.xml) generated after successful migration from Version 5.1.x to Version 7.0 is topology centric—that is, it includes all the applications within a cell. You can manage this cell-wide plug-in configuration file from the Version 7.0 administrative console, by using the GenPluginCfg command, or by using the Plug-in Config Generator MBean.

    Be aware that regenerating the plug-in configuration can overwrite manual configuration changes that you might want to preserve.

  • The application-centric generation of the plugin-cfg.xml file is supported using the Version 7.0 administrative console. Being application centric means that the plugin-cfg.xml file generated in the administrative console has a granularity that allows each application to be mapped to its specific Web or application server.
  • To set up the administrative console so that you can use it to manage the Web server plug-in configuration, you must first create a default Web server configuration and then use the administrative console to add the plug-in properties from your migrated plugin-cfg.xml file to this Web server configuration.
    • To create a default Web server configuration and then add the plug-in properties from your migrated plugin-cfg.xml file in a Network Deployment configuration, use the Version 6.x administrative console to perform the following tasks:
      1. Create a default Web server configuration.

        Read the "Selecting a Web server topology diagram and roadmap" article or the "Setting up a remote Web server" article in the information center for more information.

      2. Add the plug-in properties from your migrated plugin-cfg.xml file to this Web server configuration.

        Read the "Communicating with Web servers" and "Web server plug-in configuration properties" articles in the information center for more information.

    • To create a default Web server configuration and then add the plug-in properties from your migrated plugin-cfg.xml file in a standalone application server configuration, perform the following tasks:
      1. Create a default Web server configuration.

        Read the "Selecting a Web server topology diagram and roadmap" article or the "Setting up a remote Web server" article in the information center for more information.

      2. Use the Version 7.0 administrative console to edit the configuration and define the plug-in properties.

        Read the "Communicating with Web servers" and "Web server plug-in configuration properties" articles in the information center for more information.

Migrating from WebSphere Application Server Version 6.x: This information is only applicable if you migrated from WebSphere Application Server Version 6.x; it is not applicable if you migrated from Version 5.1.x.
  • Only Web servers defined on managed nodes are migrated to WebSphere Application Server Version 7.0.
  • If you are migrating a Web server and plug-ins from WebSphere Application Server Version 6.x to Version 7.0 and the Web server is defined on an unmanaged node, the Web server creation and application mapping must be done manually.
    To create the Web server definition manually, perform one of the following actions:
    • Use the administration console wizard.

      To generate mapping to all applications that are installed at Web server creation, use the mapping ALL option in the wizard.

    • Use the wsadmin command.
      $AdminTask createWebServer -interactive 
      and reply ALL to the mapping applications prompt.
    • Use the configureWebserverDefintion.jacl script.

      This script maps all installed applications to the Web server. The script updates all of the information related to the Web server plug-in such as the locations of the plug-in installation root, log file, configuration file, and key stores on the Web server system. However, the script does not update other properties related to the Web server if the Web server definition already exists.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 22, 2010 2:45:02 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-iseries&topic=tins_migWebserver
File name: tins_migWebserver.html