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 サーバーがアセンブリー・アーカイブまたは成果物のオプションを使用してインストールされた場合の、Liberty サーバーのローカル・インストール・ディレクトリーのロケーション。デフォルト値は ${project.build.directory} /liberty です。 | No |
refresh | true の場合は、Liberty サーバーをローカル・ディレクトリーに再インストールします。これは、アセンブリー・アーカイブまたは成果物のオプションを使用してサーバーをインストールした場合のみ使用します。 デフォルト値は false です。 | No |
serverName | Liberty サーバー・インスタンスの名前。デフォルト値は defaultServer です。 | No |
configFile | インスタンスによって使用されるサーバー構成ファイルのロケーション。 デフォルト値は ${basedir}/src/test/resources/server.xml です。 | No |
bootProps | インスタンスによって使用されるブートストラップ・プロパティー・ファイルのロケーション。 デフォルト値は ${basedir}/src/test/resources/bootstrap.properties です。 | No |
jvmOptions | インスタンスによって使用される JVM オプション・ファイルのロケーション。 デフォルト値は ${basedir}/src/test/resources/jvm.options です。 | No |
serverEnv | インスタンスによって使用されるサーバー環境ファイルのロケーション。 デフォルト値は ${basedir}/src/test/resources/server.env です。 | No |
overwrite | ターゲット・サーバーにある server.xml、bootstrap.properties、jvm.options、server.env などの既存の構成ファイルを、それらのほうが新しい場合でも上書きします。デフォルト値は true です。liberty-maven-plugin バージョン 1.1 以降。 | No |
cleanStart | 始動前に、キャッシュされたサーバー・インスタンス情報をすべてクリーンアップします。 デフォルト値は true です。 | No |
serverStartTimeout | サーバーが始動したことを確認するための、最大待機時間 (秒) 。デフォルト値は 30 秒です。 | No |
verifyTimeout | アプリケーションが開始したことを確認するための、最大待機時間 (秒) 。このタイムアウトは、applications パラメーターが設定されている場合のみ有効です。デフォルト値は 30 秒です。 | No |
applications | サーバー始動時に待機する、アプリケーション名のコンマ区切りのリスト。 | No |
- 例: サーバーの始動
- これは、プロジェクトの 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