validate service
validate service は Validate サーバーを管理します。
Unix では SSH を使用して、または Windows では Windows Services 管理を使用して、Validate サーバーをリモートで管理できます。それ以外の場合は、start、restart、および stop コマンドをローカルに発行する必要があります。
残りの validate service サブコマンドの場合、ログインしているマシンから projects_root ディレクトリを閲覧できる必要があります。
使用方法
validate service [common-options] <subcommand> [options]
例
validate service --projects-root C:\Validate 2024.3 Server\projects_root start license
共通オプション
| 名前 (および短い名前) | 説明 |
|---|---|
| --help | このヘルプを表示します。 |
| --projects-root (-r) | サーバーが実行されている projects_root ディレクトリのパス。すべての validate service コマンドに必須です。 |
| --verbose | プログラム実行についての詳細情報を表示します。これは、エラーのトラブルシューティングに役立ちます |
| --version | バージョン情報を表示します |
変数の例
この記事の例では、次の変数を使用しています。
- <service_name> は、次のいずれかになります:
- データベース
- ライセンス
- klocwork
- <projects_root> は、サーバーが実行されている projects_root です。
validate service check
validate service check コマンドを使用して、すべての Validate サーバーまたは個々の Validate サーバーのステータスを確認します。
Validate サーバーを Windows Services として実行している場合 (デフォルトの設定)、validate service の代わりに、Windows Services 管理を使用して、Validate サーバーの開始、停止、および確認を行う必要があります。
使用方法
validate service --projects-root <projects_root> check [<service_name>]
例
すべての Validate サーバーのステータスをチェックするには:
validate service --projects-root C:\Validate\projects_root check
ライセンスサーバーのステータスをチェックするには:
validate service --projects-root C:\Validate\projects_root check license
validate service get-service-properties
validate service get-service-properties コマンドを使用して、Validate サーバーのホスト名およびポート番号を表示します。
使用方法
validate service --projects-root <projects_root> get-service-properties <service_name>
例
validate service --projects-root C:\Validate\projects_root get-service-properties klocwork
validate service list-services
このコマンドを使用して、Validate サーバーをリストします。
使用方法
validate service --projects-root <projects_root> list-services
例
validate service --projects-root C:\Validate\projects_root list-services
validate service restart
このコマンドを使用して、すべてのまたは個々の Validate サーバーをワンステップで停止してから再起動します。
Validate サーバーを Windows Services として実行している場合 (デフォルト)、validate service の代わりに。Windows Services 管理を使用して、Validate サーバーの開始、停止、および確認を行う必要があります。
使用方法
validate service --projects-root <projects_root> restart [<service_name>]
例
すべての Validate サーバーを再起動するには:
validate service --projects-root C:\Validate\projects_root restart
ライセンスサーバーを再起動するには:
validate service --projects-root C:\Validate\projects_root restart license
validate service set-service-property
このコマンドを使用して、Validate サーバーのプロパティを設定します。
使用方法
validate service --projects-root <projects_root> set-service-property <service_name> <property> <value>
- <service_name> は、次のいずれかです。
- データベース
- ライセンス
- klocwork
- <property> は、次の表に示した任意のプロパティです
| プロパティ | 説明 | デフォルト値 | 以下のサーバーに適用 |
|---|---|---|---|
| append.license.logging |
サーバーの再起動時に <projects root>/logs/license.report.log ファイルを上書きするのではなく追加するには、このプロパティを「true」に設定して、ライセンスサービスと組み合わせて使用します。 例: この設定は、構成されたプロジェクトルートからライセンスサーバーを実行する場合に必要です。他の場所でホストされているライセンスサーバーを使用するようにプロジェクトルートを設定している場合、これは使用されません。 |
||
| host | 指定されたサーバーのホスト名 | localhost | すべて |
| メモリ | サーバーが使用できるメモリ量。有効な Java -Xmx 値を指定する必要があります。たとえば 2G。 | 1G | Tomcat |
| ポート | 指定されたサーバーが使用するポート番号 | ライセンスサーバー: 27000 データベースサーバー: 3306 Validate サーバー: 8080 | すべて |
validate service setup
このコマンドを使用して、追加の projects_root ディレクトリを設定および初期化します。
インストール時に 1 つの projects_root ディレクトリが自動的に作成されます。
projects_root ディレクトリは、Validate サーバーとアプリケーションのためのデータの場所です。そこには、Validate サーバーの設定と、統合プロジェクトやビルド解析の実行に関する情報が含まれています。また、Validate ライセンスファイルも保管されています。デフォルトの場所は <Server_install>/projects_root です。
使用する project_root ディレクトリがデフォルトの場所にない場合は、その場所および作成する追加の projects_root の場所を指定する必要があります。
追加の projects_root ディレクトリを作成する必要がある場合は、Perforce カスタマーサポートまで詳細をお問い合わせください。
使用方法
validate service --projects-root <new_projects_root> setup [options]
フィールド
- <new_projects_root> は作成する projects_root のパスです。このディレクトリの親ディレクトリは既に存在します。
重要: projects_root へのパスの最大長は 68 ～ 72 文字で、データベースサーバーのポート番号 (1 ～ 5 桁) の長さによって異なります。
例1 (projects_root に使用するデフォルトの場所)
validate service --projects-root C:\Validate\projects_root_2 setup
例2 (projects_root に使用するデフォルト以外の場所)
validate service setup --old-pr C:\mydatabase\projects_root --projects-root C:\mydatabase\projects_root_2
オプション
| 名前 | 説明 |
|---|---|
| --license <arg> | ライセンスファイルを指定します。このオプションを使用して、指定したライセンスファイルを新しい projects_root ディレクトリにコピーします。 |
| --old-pr <arg> | 既存の projects_root ディレクトリを指定します。このオプションを使用して、既存の projects_root からサーバー設定をコピーします。 |
validate service start
このコマンドを使用して、すべてのまたは個々の Validate サーバーを起動します。
Validate サーバーを Windows Services として実行している場合 (デフォルトの設定)、validate service の代わりに、Windows Services 管理を使用して、Validate サーバーの開始、停止、および確認を行う必要があります。
使用方法
validate service --projects-root <projects_root> start [<service_name>]
例
すべての Validate サーバーを起動するには:
validate service --projects-root C:\Validate\projects_root start
Validate サーバーを起動するには:
validate service --projects-root C:\Validate\projects_root start web
移行オプションに関する注意
--migrate オプションは、Validate の以前のバージョンから projects_root を移行するために使用されます。アップグレードについては、前バージョンからのアップグレードを参照してください。
このコマンドを使って、projects_root を移行します。プロジェクトを移行すると、その下にネストされているすべてのストリームも移行されます。サポートされているアップグレードパスと具体的な移行のユースケースについては、「プロジェクトルートディレクトリの移行」を参照してください。
使用方法
validate service start --migrate
例
validate service start --migrate --exclude-projects-file C:/exclude.txt --priority-projects-file C:/priority.txt
オプション
| 名前 (および短い名前) | 説明 |
|---|---|
| --migrate (-m) | projects_root の移行 |
| --exclude-projects-file (-x) <string> | プロジェクトを移行から除外するために、除外ファイルを指定します。除外できるのは基本プロジェクトのみです。個別のストリームを除外することはできません |
| --priority-projects-file (-y) <string> | 移行の順序に優先順位を付けるために、優先プロジェクトファイルを指定します。優先度付けできるのは基本プロジェクトのみです。個別のストリームを優先度付けすることはできません |
validate service stop
このコマンドを使用して、すべてのまたは個々の Validate サーバーを停止します。
Validate サーバーを Windows Services として実行している場合 (デフォルトの設定)、validate service の代わりに、Windows Services 管理を使用して、Validate サーバーの開始、停止、および確認を行う必要があります。
使用方法
validate service --projects-root <projects_root> stop [<service_name>]
例
すべての Validate サーバーを停止するには:
validate service --projects-root C:\Validate\projects_root stop
Validate サーバーを停止するには:
validate service --projects-root C:\Validate\projects_root stop web