Mapping modules to servers

Each module of a deployed application must be mapped to one or more target servers. The target server can be an application server or web server.

Before you begin

You can map modules of an application or stand-alone Web module to one or more target servers during or after application installation using the console. This topic assumes that the module is already installed on a server and that you want to change the mappings.

Before you change a mapping, check the deployment targets. You must specify an appropriate deployment target for a module. Modules that use Version 8.x features cannot be installed onto Version 7.x or 6.x target servers. Similarly, modules that use Version 7.x features cannot be installed onto Version 6.x target servers.

About this task

During application installation, different deployment targets might have been specified.

You use the Manage modules page of the administrative console to view and change mappings. This page is displayed during application installation using the console and, after the application is installed, can be accessed from the enterprise application settings page.

On the Manage modules page, specify target servers where you want to install the modules contained in your application. Modules can be installed on the same application server or dispersed among several application servers. Also, specify the web servers as targets that will serve as routers for requests to your application. The plug-in configuration file, plugin-cfg.xml, for each web server is generated based on the applications which are routed through it.

Attention: If an application is running, changing an application setting causes the application to restart. On stand-alone servers, the application restarts after you save the change. On multiple-server products, the application restarts after you save the change and files synchronize on the node where the application is installed. To control when synchronization occurs on multiple-server products, deselect Synchronize changes with nodes on the Console preferences page.

Procedure

  1. Click Applications > Application Types > WebSphere enterprise applications > application_name > Manage modules in the console navigation tree.

    The Manage modules panel is displayed.

  2. Examine the list of mappings.

    Ensure that each Module entry is mapped to one or more targets, identified under Server.

  3. Change a mapping as needed.
    1. Select each module that you want mapped to the same targets.

      In the list of mappings, select check boxes for the modules.

    2. From the Clusters and servers list, select one or more targets.

      Select only appropriate deployment targets for a module. You cannot install modules that use WebSphere® Application Server Version 8.x features on a Version 7.x or 6.x target server.

      Use the Ctrl key to select multiple targets. For example, to have a web server serve your application, use the Ctrl key to select an application server and the Web server together to have the plugin-cfg.xml plug-in configuration file for that web server generated based on the applications that are routed through it.

    3. Click Apply.
  4. Repeat steps 2 and 3 until each module maps to the desired targets.
  5. Click OK.

Results

The application or module configurations are changed. The application or stand-alone web module is restarted so the changes take effect.

Example

To install an application that has modules which support Java™ Platform, Enterprise Edition (Java EE) 5 or 6 to two servers, do the following:

  1. Click the Select All icon to select all of the modules in the application.
  2. While pressing Ctrl, select two Version 8 application servers from the Clusters and servers list.
  3. Click Apply.
  4. Click OK.

What to do next

Save changes to your administrative configuration.