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:

1. 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

2. 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