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 1.1 版開始。 | 否 |
cleanStart | 在啟動之前,清除伺服器實例的所有快取資訊。 預設值為 true。 | 否 |
serverStartTimeout | 等待確認伺服器已啟動的時間上限(秒)。 預設值為 30 秒。 | 否 |
verifyTimeout | 等待確認應用程式已啟動的時間上限(秒)。 只有在已設定 applications 參數時,這個逾時值才有用。預設值為 30 秒。 | 否 |
applications | 在伺服器啟動期間,所要等待的應用程式名稱逗點區隔清單。 | 否 |
- 範例:啟動伺服器
- 這是可以在產品的 pom.xml 檔中使用的程式碼 Snippet。
<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