Liberty: Maven goal - liberty:stop-server
You can use the liberty:stop-server goal to stop a Liberty server.
The server must exist and must be running.
Parameters
The following table describes parameters of the stop-server goal.
Parameter | Description | Required |
---|---|---|
serverHome | Directory location of the Liberty server installation. | Yes, only when assemblyArchive and assemblyArtifact parameters are not set. |
assemblyArchive | Location of the Liberty server compressed archive. The archive will be unpacked into a directory as specified by the installDirectory parameter. | Yes, only when serverHome and assemblyArtifact parameters are not set. |
assemblyArtifact | Maven artifact name of the Liberty server assembly. The assembly will be installed into a directory as specified by the installDirectory parameter. For more information on Liberty server Maven assemblies, see Liberty: Installation as a Maven artifact. | Yes, only when serverHome and assemblyArchive parameters are not set. |
installDirectory | Local installation directory location of the Liberty server when the server is installed using the assembly archive or artifact option. The default value is ${project.build.directory} /liberty. | No |
refresh | If true, re-install Liberty server into the local directory. This is only used when when the server is installed using the assembly archive or artifact option. The default value is false. | No |
serverName | Name of the Liberty server instance. The default value is defaultServer. | No |
configFile | Location of a server configuration file to be used by the instance. The default value is ${basedir}/src/test/resources/server.xml. | No |
bootProps | Location of a bootstrap properties file to be used by the instance. The default value is ${basedir}/src/test/resources/bootstrap.properties. | No |
jvmOptions | Location of a JVM options file to be used by the instance. The default value is ${basedir}/src/test/resources/jvm.options. | No |
serverEnv | Location of a server environment file to be used by the instance. The default value is ${basedir}/src/test/resources/server.env. | No |
overwrite | Overwrite existing configurtion files such as server.xml, bootstrap.properties, jvm.options, or server.env in the target server even if they are newer. The default value is true. Since liberty-maven-plugin version 1.1. | No |
timeout | Maximum time to wait (in milliseconds) to verify that the server has stopped. The default value is 40 seconds. | No |
- Example: stopping a server
- This is the code snippet that you can use in the pom.xml file of your project.
<build> ... <plugins> <plugin> <groupId>com.ibm.websphere.wlp.maven.plugins</groupId> <artifactId>liberty-maven-plugin</artifactId> <version>1.0</version> <executions> ... <execution> <id>stop-server</id> <phase>post-integration-test</phase> <goals> <goal>stop-server</goal> </goals> <configuration> <timeout>60000</timeout> </configuration> </execution> ... </executions> <configuration> <serverHome>/opt/ibm/wlp</serverHome> <serverName>test</serverName> </configuration> </plugin> </plugins> ... </build>
- Example: stopping a server from command line
- This is the Maven command that you can use to stop a running server.
mvn liberty:stop-server -DserverHome=/opt/ibm/wlp -DserverName=test