Deploy WAR/EAR Archive Action

InstallAnywhere 2020

The Deploy WAR/EAR Archive action deploys a Web application to an application server. This action requires an existing application server host in the Hosts view on the Organization page. Once the application server has been added in the Hosts view, you can add the Deploy WAR/EAR Archive action to an application server host in a view on the Sequence page.

Properties Tab

The Properties tab of the Deploy WAR/EAR Archive action customizer has the following subtabs:

•

General Settings Subtab

•

Optional Settings Subtab

•

Tomcat Settings Subtab

•

WebSphere Settings Subtab

General Settings Subtab

The General Settings subtab on the Properties tab includes the following settings:

General Settings Tab in the Deploy WAR/EAR Archive Action Customizer

Setting

Description

Application Name

Enter a name to identify the archive file.

Source

Specify the source for the EAR or WAR file. Available options are:

•

Selected Archive—To bundle the EAR or WAR file with the installer, select this check box and click the Choose Archive button to select the appropriate archive.

•

Existing Archive—To deploy an EAR or WAR file that is on target systems, select this check box and enter the path and file name for the archive on the target system.

Undeploy During Uninstall

To ensure that the archive is undeployed when the uninstaller runs, select this check box. This check box is selected by default.

Note that undeploying WAR files is not supported for remote Tomcat servers.

Optional Settings Subtab

The Optional Settings subtab is available for the following types of Web servers: Geronimo, JBoss, and WebLogic.

The Optional Settings subtab on the Properties tab includes the following settings:

Optional Settings Tab in the Deploy WAR/EAR Archive Action Customizer

Setting

Description

Deployment Plan

For servers that support the JSR-88 standard, you can optionally choose an archive for the deployment plan. A deployment plan is an XML file that contains server-specific information that is not included in the EAR or WAR file’s deployment descriptor.

Available options are:

•

Selected Archive—To choose an archive that you want to bundle with the installer, select this check box and click the Choose Archive button to select the appropriate deployment plan file.

•

Existing Archive—To choose an archive that is on target systems, click the Existing Archive button and enter the path and file name for the deployment plan file on target systems.

Tomcat Settings Subtab

The Tomcat Settings subtab is applicable for Tomcat application server hosts.

The Tomcat Settings subtab on the Properties tab includes the following settings:

Tomcat Settings Tab in the Deploy WAR/EAR Archive Action Customizer
Setting	Description
Deployment Option	Specify what kind of server to use for deploying WAR files. By default, the entry in this setting is the user-defined variable $TOMCAT_DEPLOYMENT_OPTION$. You can specify a different variable if needed. To learn more, see Specifying Which Deployment Options to Support for Apache Tomcat Servers.
Server Path	Enter the path on the server where you want to deploy the Web application. By default, the entry in this setting is the user-defined variable $TOMCAT_SERVER_PATH$. You can specify a different variable if needed. This setting applies to local Tomcat servers; this setting is available if the Local Tomcat check box is selected for the associated Tomcat server host.
Host Name	Enter the name of the Tomcat server or its IP address. By default, the entry in this setting is the user-defined variable $TOMCAT_HOSTNAME$. You can specify a different variable if needed. This setting applies to remote Tomcat servers; this setting is available if the Remote Tomcat check box is selected for the associated Tomcat server host.
Port	Enter the port number on which Tomcat is running. By default, the entry in this setting is the user-defined variable $TOMCAT_PORT$. You can specify a different variable if needed. This setting applies to remote Tomcat servers; this setting is available if the Remote Tomcat check box is selected for the associated Tomcat server host.
User Name	Enter the user name for the account that is specified in the tomcat-users.xml file (which is in the conf folder in the Tomcat directory). By default, the entry in this setting is the user-defined variable $TOMCAT_USERNAME$. You can specify a different variable if needed. This setting applies to remote Tomcat servers; this setting is available if the Remote Tomcat check box is selected for the associated Tomcat server host.
Password	Enter the password that corresponds with the specified user name for an account that is specified in the tomcat-users.xml file (which is in the conf folder in the Tomcat directory). By default, the entry in this setting is the user-defined variable $TOMCAT_PASSWORD$. You can specify a different variable if needed. This setting applies to remote Tomcat servers; this setting is available if the Remote Tomcat check box is selected for the associated Tomcat server host.
SSL Enabled	Indicate whether SSL is enabled on the remote Tomcat server. By default, the entry in this setting is the user-defined variable $TOMCAT_SSL_CONNECTION_STATUS$. You can specify a different variable if needed. If this variable is set to Yes at run time, the action uses SSL for deployment to the server. This setting applies to remote Tomcat servers; this setting is available if the Remote Tomcat check box is selected for the associated Tomcat server host.

WebSphere Settings Subtab

The WebSphere Settings subtab is applicable for WebSphere application server hosts.

The WebSphere Settings subtab on the Properties tab includes the following settings:

WebSphere Settings Tab in the Deploy WAR/EAR Archive Action Customizer
Setting	Description
Deployment Option	Specify what kind of server to use for deploying EAR or WAR files. By default, the entry in this setting is the user-defined variable $WEBSPHERE_DEPLOYMENT_OPTION$. You can specify a different variable if needed. To learn more, see Specifying Which Deployment Options to Support for IBM WebSphere Servers.
Host Name	Enter the name of the WebSphere server or its IP address. By default, the entry in this setting is the user-defined variable $WEBSPHERE_HOSTNAME$. You can specify a different variable if needed. This setting applies to remote WebSphere servers.
SOAP Port	Enter the SOAP port number on which WebSphere is running. By default, the entry in this setting is the user-defined variable $WEBSPHERE_PORT$. You can specify a different variable if needed. This setting applies to remote WebSphere servers.
Admin Security Enabled	Enter the value that indicates whether administrative security is enabled on the WebSphere application server. If this variable is set to Yes at run time, the action uses the credentials in the User Name and Password settings to connect to the server. By default, the entry in this setting is the user-defined variable $WEBSPHERE_IS_SECURITY_ENABLED$. You can specify a different variable if needed. The available values are Yes and No. This setting applies to remote WebSphere servers.
User Name	Enter the user name for the account that should be used to connect to the WebSphere server if administrative security is enabled. By default, the entry in this setting is the user-defined variable $WEBSPHERE_USERNAME$. You can specify a different variable if needed. This setting applies to remote WebSphere servers.
Password	Enter the password that corresponds with the specified user name for an account that should be used to connect to the WebSphere server. By default, the entry in this setting is the user-defined variable $WEBSPHERE_PASSWORD$. You can specify a different variable if needed. This setting applies to remote WebSphere servers.
SSL TrustStore File Path	Specify the path to the SSL TrustStore file. By default, the entry in this setting is the user-defined variable $WEBSPHERE_TRUSTSTORE_PATH$. You can specify a different variable if needed. This setting applies to remote WebSphere servers.
SSL TrustStore Password	Specify the password to the SSL TrustStore. By default, the entry in this setting is the user-defined variable $WEBSPHERE_TRUSTSTORE_PASSWORD$. You can specify a different variable if needed. This setting applies to remote WebSphere servers.

Rules, Tags, and Rollback Tabs

For information on the other tabs on this customizer, see the following:

•

Rules—Use this tab to add rules to the selected action. For more information, see Assigning a Rule to an Action and Rules Reference.

•

Tags—Use this tab to add build configuration tags to the selected action. For more information, see Assigning Tags to Project Elements.

•

Rollback—Use this tab to specify rollback behavior for the selected action. For more information, see Configuring Installation Rollback Behavior.

Deploy WAR/EAR Archive Action

InstallAnywhere 2020 Help Library

October 2019