Manage modules settings

Manage modules settings

Use this page to specify deployment targets where to install the modules contained in the application. Modules can be installed on the same deployment target or dispersed among several deployment targets.
On single-server products, a deployment target can be an application server or web server.
On multiple-server products, a deployment target can be an application server, cluster of application servers, or web server. To view this console page, click Applications > Application Types > WebSphere enterprise applications > application_name > Manage modules. This page is the similar to the Map modules to servers page on the application installation and update wizards.
On this page, each Module must map to one or more targets, identified under Server. To change a mapping:

In the list of mappings, select each module we want mapped to the same target or targets.

If the security configuration supports multiple domains, select the domain that has the desired clusters or servers or keep the All domains default.

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 WebSphere Application Server Version 8.x features on a Version 7.x or 6.x target server. Similarly, we cannot install modules that use Version 7.x features on a Version 6.x target server.
Use the Ctrl key to select multiple targets. For example, to have a web server serve the application, press the Ctrl key and then select an application server and the web server together. The product generates the plug-in configuration file, plugin-cfg.xml, for that web server based on the applications which are routed through it.

Click Apply.

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.
If we accessed this Manage modules page from a console enterprise application page for an already installed application, we can also use this page to view and manage modules in the application.
To view the values specified for a module configuration, click the module name in the list. The displayed module settings page shows the values specified. On the settings page, we can change existing configuration values and link to additional console pages that assist you in configuring the module.
To manage a module, select the module name in the list and click a button:

Button Resulting action
Remove Removes the selected module from the deployed application. The module is deleted from the application in the configuration repository and also from all of the nodes where the application is installed and running or expected to run.
On multiple-server products, if the application is running on a node when the module file is deleted from the node as a result of configuration synchronization then the product stops the application, deletes the module file from the file system of the node, and restarts the application.
Update Opens a wizard that helps you update modules in an application. If a module has the same URI as a module already existing in the application, the new module replaces the existing module. If the new module does not exist in the application, it is added to the deployed application.
On multiple-server products, if the application is running on a node when the module file is updated on the node as a result of configuration synchronization then the product stops the application, updates the module file on the file system of the node, and restarts the application. If the application is running on a node when the module file is added as a result of configuration synchronization then the product starts the newly added module without stopping and restarting the running application.
Remove File Delete a file from a module of a deployed application.
On multiple-server products, the file is also deleted from all the nodes where the module is installed after configuration is synchronized with nodes. If the application is running on a node when the module file is deleted from the node as a result of configuration synchronization then the product stops the application, deletes the module file from the file system of the node, and restarts the application.
Export File Accesses the Export a file from an application page, which you use to export a file of an enterprise application or module to a location of the choice.
If the browser does not prompt for a location to store the file, click File > Save as and specify a location to save the file that is shown in the browser.

Display clusters and servers in the following domain

Lists the domains that the security configuration supports. This setting displays only on multiple-server products with a security configuration that supports multiple domains.
From this list, select the domain that has the clusters or servers on which to deploy an application or module. To see all available deployment targets, select All Domains.
Select a domain causes the Clusters and servers list to show only the deployment targets configured in the domain. We cannot deploy the modules in an application across deployment targets that belong to different security domains.

Clusters and servers

Lists the names of available deployment targets. This list is the same for every application installed in the cell.
From this list, select only appropriate deployment targets for a module. We must install an application, enterprise bean (EJB) module, Session Initiation Protocol(SIP) archive (SAR), web module, or client module on a Version 8.x target under any of the following conditions:

The module supports Java EE 6.

The module calls an 8.x runtime (API).

The module uses an 8.x product feature.

We must install an application, EJB, SAR, or web module on a Version 8.x or 7.x target under any of the following conditions:

The module supports Java EE 5.

The module calls a 7.x runtime API.

The module uses a 7.x product feature.

If a module supports J2EE 1.4, then install the module on a Version 6.x, 7.x or 8.x deployment target. Modules that call a 6.1.x API or use a 6.1.x feature can be installed on a 6.1.x, 7.x or 8.x deployment target. Modules that require 6.1.x feature pack functionality can be installed on a 6.1.x deployment target that has been enabled with that feature pack or on a 7.x or 8.x deployment target.
We can install an application or module developed for a Version 5.x product on any deployment target.

Module

Name of a module in the installed (or deployed) application.

URI

Location of the module relative to the root of the application (EAR file).

Module type

Type of module, for example, a web module or EJB module.
This setting is shown on the Manage modules page accessed from a console enterprise application page.

Server

Name of each deployment target to which the module currently is mapped.
To change the deployment targets for a module, select one or more targets from the Clusters and servers list and click Apply. The new mapping replaces the previous mapping.

Related concepts

Installable enterprise module versions
Multiple security domains

Related tasks

Mapping modules to servers
Configure enterprise application files

Enterprise application settings

Button	Resulting action
Remove	Removes the selected module from the deployed application. The module is deleted from the application in the configuration repository and also from all of the nodes where the application is installed and running or expected to run. On multiple-server products, if the application is running on a node when the module file is deleted from the node as a result of configuration synchronization then the product stops the application, deletes the module file from the file system of the node, and restarts the application.
Update	Opens a wizard that helps you update modules in an application. If a module has the same URI as a module already existing in the application, the new module replaces the existing module. If the new module does not exist in the application, it is added to the deployed application. On multiple-server products, if the application is running on a node when the module file is updated on the node as a result of configuration synchronization then the product stops the application, updates the module file on the file system of the node, and restarts the application. If the application is running on a node when the module file is added as a result of configuration synchronization then the product starts the newly added module without stopping and restarting the running application.
Remove File	Delete a file from a module of a deployed application. On multiple-server products, the file is also deleted from all the nodes where the module is installed after configuration is synchronized with nodes. If the application is running on a node when the module file is deleted from the node as a result of configuration synchronization then the product stops the application, deletes the module file from the file system of the node, and restarts the application.
Export File	Accesses the Export a file from an application page, which you use to export a file of an enterprise application or module to a location of the choice. If the browser does not prompt for a location to store the file, click File > Save as and specify a location to save the file that is shown in the browser.