Maven 目标 - liberty:start-server
在文件系统中,可以使用 liberty:start-server 目标启动 Liberty 服务器。
如果不存在服务器实例,那么 liberty:start-server 目标将自动创建服务器实例。
参数
下表描述了 start-server 目标的参数。
参数 | 描述 | 必需 |
---|---|---|
serverHome | Liberty 服务器安装的目录位置。 | 是,仅当未设置 assemblyArchive 和 assemblyArtifact 参数时才必须设置此参数。 |
assemblyArchive | Liberty 服务器压缩归档所在的位置。此归档将解包到由 installDirectory 参数所指定的目录中。 | 是,仅当未设置 serverHome 和 assemblyArtifact 参数时才必须设置此参数。 |
assemblyArtifact | Liberty 服务器组合件的 Maven 工件名称。该组合件将安装到由 installDirectory 参数所指定的目录中。有关 Liberty 服务器 Maven 组合件的更多信息,请参阅作为 Maven 工件进行安装。 | 是,仅当未设置 serverHome 和 assemblyArchive 参数时才必须设置此参数。 |
installDirectory | 使用组合件归档或工件选项来安装 Liberty 服务器时,该服务器的本地安装目录位置。缺省值为 ${project.build.directory} /liberty。 | 否 |
refresh | 如果值为 true,那么会将 Liberty 服务器重新安装到本地目录中。仅当使用组合件归档或工件选项来安装此服务器时才使用此参数。缺省值为 false。 | 否 |
serverName | Liberty 服务器实例的名称。缺省值为 defaultServer。 | 否 |
configFile | 实例要使用的服务器配置文件所在的位置。缺省值为 ${basedir}/src/test/resources/server.xml。 | 否 |
bootProps | 实例要使用的引导属性文件所在的位置。缺省值为 ${basedir}/src/test/resources/bootstrap.properties。 | 否 |
jvmOptions | 实例要使用的 JVM 选项文件所在的位置。缺省值为 ${basedir}/src/test/resources/jvm.options。 | 否 |
serverEnv | 实例要使用的服务器环境文件所在的位置。缺省值为 ${basedir}/src/test/resources/server.env。 | 否 |
overwrite | 覆盖目标服务器中的现有配置文件(例如,server.xml、bootstrap.properties、jvm.options 或 server.env),即使它们版本更高一些。缺省值为 true。自 liberty-maven-plugin V1.1 开始。 | 否 |
cleanStart | 在服务器实例启动之前,将清除该服务器实例的所有已高速缓存的信息。缺省值为 true。 | 否 |
serverStartTimeout | 验证服务器是否已启动时的最长等待时间(以秒计)。缺省值为 30 秒。 | 否 |
verifyTimeout | 验证应用程序是否已启动时的最长等待时间(以秒计)。仅当设置了 applications 参数时,此超时才有效。缺省值为 30 秒。 | 否 |
applications | 在服务器启动期间,要等待的应用程序名称的以逗号分隔的列表。 | 否 |
- 示例:启动服务器
- 这是可以用在项目的 pom.xml 文件中的代码段。
<build> ... <plugins> <plugin> <groupId>com.ibm.websphere.wlp.maven.plugins</groupId> <artifactId>liberty-maven-plugin</artifactId> <version>1.0</version> <executions> ... <execution> <id>start-server</id> <phase>pre-integration-test</phase> <goals> <goal>start-server</goal> </goals> <configuration> <verifyTimeout>60</verifyTimeout> <configFile>${project.build.testOutputDirectory}/wlp/server.xml</configFile> </configuration> </execution> ... <executions> <configuration> <serverHome>/opt/ibm/wlp</serverHome> <serverName>test</serverName> </configuration> </plugin> </plugins> ... </build>
- 示例:从命令行启动服务器
- 以下是一个可以用来启动服务器的 Maven 命令。
mvn liberty:start-server -DserverHome=/opt/ibm/wlp -DserverName=test