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 appserver, cluster of appservers or Web server.
We 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 page 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. Specify an appropriate deployment target for a module. Modules that use V7.x features cannot be installed onto V6.x or 5.x target servers.
During application installation, different deployment targets might have been specified.
You use the Manage modules panel of the admin console to view and change mappings. This panel 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 panel, specify target servers where you want to install the modules contained in the application. Modules can be installed on the same appserver or dispersed among several appservers. Also, specify the Web servers as targets that will serve as routers for requests to the application. The plug-in configuration file, plugin-cfg.xml, for each Web server is generated based on the applications which are routed through it.
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.
- Click Applications > Application Types > WebSphere enterprise apps > application_name > Manage modules
The Manage modules panel is displayed.
- Examine the list of mappings.
Ensure that each Module entry is mapped to one or more targets, identified under Server.
- Change a mapping as needed.
- Select each module that you want mapped to the same targets.
In the list of mappings, select check boxes for the modules.
- If the security configuration supports multiple domains, select the domain that has the desired clusters or servers, or keep the All domains default.
Select a domain causes the Clusters and servers list to show only the deployment targets that are configured in the domain. You cannot deploy the modules in an application across deployment targets that belong to different security domains.
- From the Clusters and servers list, select one or more targets.
Select only appropriate deployment targets for a module. We cannot install modules that use WAS V 7.x features on a V6.x or 5.x target server.
Use the Ctrl key to select multiple targets. For example, to have a Web server serve the application, use the Ctrl key to select an appserver or cluster 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.
- Click Apply.
- Repeat steps 2 and 3 until each module maps to the desired targets.
- 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 EE 5 to two servers, do the following:
- Click the Select All icon to select all of the modules in the application.
- While pressing Ctrl, select two V7 appservers from the Clusters and servers list.
- Click Apply.
- Click OK.
Next steps
If the application or module is deployed on a cluster and the configuration changes are complete, click Rollout Update on the Enterprise applications page to propagate the changed configuration on all cluster members of the cluster on which the application or module is deployed. Rollout Update sequentially updates the configuration on the nodes that contain cluster members.
Save changes to the admin configuration.
The application binaries are transferred to nodes when the configuration changes on the dmgr synchronize with configurations for individual nodes on which the application will run.
Avoid trouble: If, at a future time, you intend to delete the server or cluster to which the modules are mapped, add a new server or cluster and then remap the modules to it before deleting the previous server or cluster. If we do not remap the modules to a new server or cluster before deleting the previous one, uninstall each application or module and then reinstall them on an existing server or cluster. After a server or cluster to which modules are mapped is deleted, the modules cannot be remapped to another existing server or cluster.
Installable enterprise module versions
Multiple security domains
Related tasks
Set enterprise application files
Related
Manage modules settings