Use this panel to specify options for the installation of an application onto a WebSphere Application Server deployment target. Default values for the options are used if you do not specify a value. After application installation, you can specify values for many of these options on an administrative console Enterprise Application settings page.
To view this administrative console panel, click Applications > Install New Application and then specify values as needed for your application on the Preparing for application installation pages. The Select installation options panel is the same for the application installation and update wizards.
Specify whether to precompile JavaServer page (JSP) files as a part of installation. The default is not to precompile JSP files.
Install onto a 6.x deployment target. If you select Pre-compile JSP and try installing your application onto a 5.x deployment target, the installation is rejected. For this option, install only onto a 6.x deployment target.
Data type | Boolean |
Default | False |
Specifies the directory to which the enterprise application (EAR) file will be installed. The default value is the value of APP_INSTALL_ROOT/cell_name, where the APP_INSTALL_ROOT variable is install_root/installedApps; for example, C:\WebSphere\AppServer\profiles\profile_name\installedApps\cell_name.
You can specify an absolute path or use a pathmap variable such as ${MY_APPS}. You can use a pathmap variable in any installation.
This Directory to install application field is the same as the Application binaries setting on an Enterprise Application settings page.
Data type | String |
Units | Full path name |
Specifies whether WebSphere Application Server expands or deletes application binaries in the installation destination. The default is to enable application distribution. Application binaries for installed applications are expanded to the directory specified. The binaries are also deleted when you uninstall and save changes to the configuration. If you disable this option, then you must ensure that the application binaries are expanded appropriately in the destination directories of all nodes where the application runs.
This Distribute application field is the same as the Enable distribution setting on an Enterprise Application settings page.
Data type | Boolean |
Default | true |
Specifies whether the application server uses the binding, extensions, and deployment descriptors located with the application deployment document, the deployment.xml file (default), or those located in the enterprise application resource (EAR) file. Select this setting for applications installed on 6.x deployment targets only. This setting is not valid for applications installed on 5.x deployment targets.
This Use Binary Configuration field is the same as the Use metadata from binaries setting on an Enterprise Application settings page.
Data type | Boolean |
Default | false |
Specifies whether the EJBDeploy tool runs during application installation.
Enabling this setting might cause the installation program to run for several minutes. Also, if you select Deploy enterprise beans, install only onto a 6.x deployment target.
Data type | Boolean |
Default | true |
Specifies a logical name for the application. An application name must be unique within a cell and cannot contain characters that are not allowed in object names.
An application name cannot begin with a period (.), cannot contain leading or trailing spaces, and cannot contain any of the following characters:
Unallowed characters | ||
---|---|---|
/ forward slash | $ dollar sign | ' single quote mark |
\ backslash | = equal sign | " double quote mark |
* asterisk | % percent sign | | vertical bar |
, comma | + plus sign | < left angle bracket |
: colon | @ at sign | > right angle bracket |
; semi-colon | # hash mark | & ampersand (and sign) |
? question mark | ]]> No specific name exists for this character combination |
This Application name field is the same as the Name setting on an Enterprise Application settings page.
Data type | String |
Specifies whether to create MBean files for various resources (such as servlets or JSP files) within an application when the application starts. The default is to create MBean files.
Data type | Boolean |
Default | true |
Specifies whether to enable class reloading when application files are updated. The default is not to enable class reloading.
For EJB modules or any non-Web modules, selecting Enable class reloading sets reloadEnabled to true in the deployment.xml file for the application. If an application's class definition changes, the application server run time stops and starts the application to reload application classes.
For Web modules such as servlets and JavaServer page (JSP) files, a Web container reloads a Web module only when the IBM extension reloadingEnabled in the ibm-web-ext.xmi file is set to true. You can set reloadingEnabled to true when editing your Web module's extended deployment descriptors in an assembly tool.
To disable reloading of a Web module, set the IBM extension reloadingEnabled in the ibm-web-ext.xmi file to false. Or, if the Web module has the IBM extension reloadingEnabled in the ibm-web-ext.xmi file set to true, enable class loading, and set the Reload interval property to zero (0).
Data type | Boolean |
Default | false |
Specifies the number of seconds to scan the application's file system for updated files. The default is the value of the reloading interval attribute in the IBM extension (META-INF/ibm-application-ext.xmi) file of the EAR file.
The reloading interval attribute takes effect only if class reloading is enabled.
To enable reloading, specify a value greater than zero (for example, 1 to 2147483647). To disable reloading, specify zero (0). The range is from 0 to 2147483647.
This Reload interval in seconds field is the same as the Reloading interval setting on an Enterprise Application settings page.
Data type | Integer |
Units | Seconds |
Default | 3 |
Specifies whether the Web services deploy tool wsdeploy runs during application installation.
The tool generates code needed to run applications using Web services. The default is not to run the wsdeploy tool. You must enable this setting if the EAR file contains modules using Web services and has not previously had the wsdeploy tool run on it, either from the Deploy menu choice of an assembly tool or from a command line.
If you select Deploy and try installing your application onto a 5.x deployment target, the installation is rejected. For this option, install only onto a 6.x deployment target.
Data type | Boolean |
Default | false |
Specifies whether WebSphere Application Server examines the application references specified during application installation or updating and, if validation is enabled, warns you of incorrect references or fails the operation.
An application typically refers to resources using data sources for container managed persistence (CMP) beans or using resource references or resource environment references defined in deployment descriptors. The validation checks whether the resource referred to by the application is defined in the scope of the deployment target of that application.
Select off for no resource validation, warn for warning messages about incorrect resource references, or fail to stop operations that fail as a result of incorrect resource references.
This Validate Input off/warn/fail field is the same as the Validation setting on an Enterprise Application settings page.
Data type | String |
Default | warn |
Specifies whether the embedded configuration should be processed. An embedded configuration consists of files such as resource.xml and variables.xml. When selected or true, the embedded configuration is loaded to the application scope from the .ear file. If the .ear file does not contain an embedded configuration, the default is false. If the .ear file contains an embedded configuration, the default is true.
Data type | Boolean |
Default | false |
Related concepts
Enterprise (J2EE) applications
Installable module versions
Assembly tools
Related tasks
Installing application files with the console
Related reference
Enterprise application settings
Object names
wsdeploy command