Application Installation
Purpose
This is an optional WebSphere Phase.
This phase is used to bind, install, update or uninstall an EAR application. It supports the actions that need to be executed on the WebSphere Application Server in order to deploy a Web Application with a WAR or EAR file.
The wasApp.installCommands parameter is the main parameter for this Phase. Depending on the command specified in that parameter, other parameters need to be defined or not. |
Usage
The Application Installation Phase can be used on Build and Deploy environments. However, it is not recommended to use it on Build environments, because conceptually it uses “environment_deploy” property file(s)
Parameters
Parameter | M/O | Description | Default Value |
---|---|---|---|
alm.phase.builder |
M |
Script Type |
|
alm.phase.extractBundle |
M |
TRUE |
|
alm.phase.mainScript |
M |
WAS Application Installation |
wasAppInstall.xml |
dir.langModels |
Language Models Location |
${dir.wasModels} |
|
dir.wasModels |
Application Models Location |
./models |
|
dir.wasResources |
Property files Location |
./resources |
|
propsfile.environment |
Property File of WAS environment |
${dir.wasResources}/environment_deploy.properties |
|
propsfile.languages |
Property File of WAS languages for managing the Application with installScript command |
${dir.wasResources}/languages_${phase.mainScriptName}.properties |
|
propsfile.waslogRules |
Property File of WebSphere Log Rules |
${dir.wasResources}/wasLogRules.properties |
|
propsfile.webapp |
Property File of WAS Application wsadmin parameters and options |
${source}/webapp_${alm.project.vcrProjectName}.properties |
|
stopOnError |
Option for stopping at the end. |
TRUE |
|
was.admin.password |
WAS Administrator password |
* |
|
was.admin.username |
WAS Administrator ID |
Admin |
|
was.cellname |
WAS Cellule name |
${was.nodename}Cell |
|
was.fail |
Fail the phase if Websphere answer is not OK |
FALSE |
|
was.install.root |
i.e. [WAS_INSTALL_ROOT] |
||
was.installableApps |
WAS installableApps location |
${was.install.root}/installableApps |
|
was.nodename |
WAS Node name |
[hostname]Node01 |
|
was.profile |
WAS Profile name |
AppSrv01 |
|
was.servername |
WAS Server name |
server1 |
|
wasApp.installCommands |
M |
Available commands: bindingEAR;installApp;uninstallApp;updateApp;installScript,ignore |
installApp |
wasApp.scriptArgs |
Arguments for the wsadmin script to run.(Except default:[cell] [node] [server] [appName] [earName] [profile.path]/installableApps) |
||
wasApp.scriptLang |
The 'wsadmin' script language (jacl or jython) |
jacl |
|
wasApp.scriptLocation |
For installScript, the location of the script to run. |
jacl |
|
wasApp.scriptName |
For installScript command, the script to run or unknown file. |
WASadmin.jacl |
|
wasApp.scriptProperties |
For installScript command, the property file to use by the ${wasApp.scriptName}. |
||
webapp.applicationName |
Websphere name of this Application. |
||
webapp.contextPath |
Url Path of application (with in first '/') |
/${webapp.applicationName} |
|
webapp.dirDist |
Distribution location of EAR file or files for creating it. |
dist |
|
webapp.earName |
The ear file name for WebSphere |
${webapp.applicationName}.ear |
|
webapp.languageKey |
M |
For installScript command, the language key to use in the propsfile.languages file. |
JACL |