websphere-maven-plugin
This plugin is a fork of Jenkins plugin - websphere-deployer-plugin. It uses all deploying code from Jenkins plugin.
Dependencies
Plugin depends on some IBM libraries. They must be installed in your local repository to compile the plugin:
- WebSphere Application Server deployer
- com.ibm.ws.admin.client_*.jar - ($WAS_INSTALL_ROOT/runtimes)
mvn install:install-file -Dfile=com.ibm.ws.admin.client_*.jar \ -DgroupId=com.ibm.ws -DartifactId=admin -Dversion=8.5.0 \ -Dpackaging=jar
- com.ibm.ws.orb_*.jar - ($WAS_INSTALL_ROOT/runtimes)
mvn install:install-file -Dfile=com.ibm.ws.orb_*.jar \ -DgroupId=com.ibm.ws -DartifactId=orb -Dversion=8.5.0 \ -Dpackaging=jar
- WebSphere Liberty Profile
- com.ibm.websphere.appserver.api.basics_*.jar - ($LIBERTY_INSTALL_ROOT/dev/api/ibm)
mvn install:install-file -Dfile=com.ibm.websphere.appserver.api.basics_*.jar \ -DgroupId=com.ibm.ws -DartifactId=liberty-basic -Dversion=8.5.5 \ -Dpackaging=jar
- com.ibm.websphere.appserver.api.endpoint_*.jar - ($LIBERTY_INSTALL_ROOT/dev/api/ibm)
mvn install:install-file -Dfile=com.ibm.websphere.appserver.api.endpoint_*.jar \ -DgroupId=com.ibm.ws -DartifactId=liberty-endpoint -Dversion=8.5.5 \ -Dpackaging=jar
- com.ibm.websphere.appserver.api.restConnector_*.jar - ($LIBERTY_INSTALL_ROOT/dev/api/ibm)
mvn install:install-file -Dfile=com.ibm.websphere.appserver.api.restConnector_*.jar \ -DgroupId=com.ibm.ws -DartifactId=liberty-connector -Dversion=8.5.5 \ -Dpackaging=jar
- restConnector.jar - ($LIBERTY_INSTALL_ROOT/clients)
mvn install:install-file -Dfile=restConnector.jar \ -DgroupId=com.ibm.ws -DartifactId=liberty-rest-connector -Dversion=8.5.5 \ -Dpackaging=jar
Use Maven plugin
To use plugin you have to append dependencies to plugin definition in pom.xml. E.g.
<plugin>
<groupId>com.offbytes.websphere</groupId>
<artifactId>websphere-maven-plugin</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency> <!-- WebSphere AS dependencies -->
<groupId>com.ibm.ws</groupId>
<artifactId>admin</artifactId>
<version>8.5.0</version>
</dependency>
<dependency>
<groupId>com.ibm.ws</groupId>
<artifactId>orb</artifactId>
<version>8.5.0</version>
</dependency>
</dependencies>
</plugin>
WebSphere Application Server deployment
Deployment is triggered using websphere:deployWAS
goal.
Configuration: (property - required)
- host (property: was.host) - Application server host name (example: 10.0.0.1)
- port (property: was.port) - Server access port for SOAP (example: 8880)
- node (property: was.node) - Node name (example: AppSrvNode01)
- cell (property: was.cell) - Cell name (example: AppSrvNode01Cell)
- server (property: was.server) - Server name (example: server1)
- username (property: was.username) - (example: admin)
- password (property: was.password) - (example: password)
- clientKeyFile (property: was.clientKeyFile) - Absolute path to copy of Client Key file (example: /home/bob/secret/DummyClientKeyFile.jks)
- clientKeyPassword (property: was.clientKeyPassword) - Key file password (example: WebAS)
- clientTrustFile (property: was.clientTrustFile) - Absolute path to copy of Client Trust file (example: /home/bob/secret/DummyClientTrustFile.jks)
- clientTrustPassword (property: was.clientTrustPassword) - Trust file password (example: WebAS)
- earLevel (property: was.earLevel) - Generated EAR api level (5 for JavaEE 5, 6 for JavaEE 6) - used when deploying WAR file
- precompile (property: was.precompile) - Precompile JSP pages
- reloading (property: was.reloading) - JSP reloading
- warContextPath (property: was.warContextPath) - allows to set context path of deployed WAR file
- warFile (property: was.warFile) - you can specify your own path to WAR file (not only target/${finalName}.war)
- warPath (property: was.warPath) - deprecated - see warFile