1.6.6 importservicetemplate(サービステンプレートのインポート)
機能
サービステンプレートをJP1/AOに追加します。JP1/AOにサービステンプレートを追加することを,サービステンプレートのインポートといいます。
1つのサービステンプレートパッケージ,または複数のサービステンプレートパッケージをまとめたzipファイルを指定してコマンドを実行すると,指定したサービステンプレートパッケージをJP1/AOにインポートできます。
形式
importservicetemplate /file サービステンプレートパッケージまたは複数のサービステンプレートパッケージをまとめたzipファイル /user ユーザーID {/password パスワード | /passwordfile パスワードファイルパス}
引数
- /file サービステンプレートパッケージまたは複数のサービステンプレートパッケージをまとめたzipファイル
インポートするサービステンプレートパッケージまたは複数のサービステンプレートパッケージをまとめたzipファイルを絶対パスまたは相対パスで指定します。
- /user ユーザーID
JP1/AOのユーザーIDを指定します。
指定できる文字数は,1~256文字です。
使用できる文字の種類は,半角英数字および「!」,「#」,「$」,「%」,「&」,「'」,「(」,「)」,「*」,「+」,「-」,「.」,「=」,「@」,「\」,「^」,「_」,「|」です。
大文字と小文字は区別しません。
- /password パスワード
userオプションで指定した,ユーザーのパスワードを指定します。
このオプションまたはpasswordfileオプションのどちらかを指定する必要があります。両オプションが指定されている場合,およびどちらのオプションも指定されていない場合はエラーとなります。
指定できる文字数は,1~256文字です。
使用できる文字の種類は,userオプションと同じです。
- /passwordfile パスワードファイルパス
userオプションで指定した,ユーザーのパスワードが格納されているファイルのパスを絶対パスまたは相対パスで指定します。
このオプションまたはpasswordオプションのどちらかを指定する必要があります。両オプションが指定されている場合,およびどちらのオプションも指定されていない場合はエラーとなります。
格納先
- Windowsの場合
JP1/AOのインストール先フォルダ\bin
- Linuxの場合
/opt/jp1ao/bin
実行権限
AdminロールまたはDevelopロールかつOSのAdministrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は,権限昇格を求めるメッセージが表示されます。
注意事項
-
複数のサービステンプレートパッケージをまとめたzipファイルをインポートする場合,一部のサービステンプレートパッケージのインポートに失敗してもインポートを続行します。特定のサービステンプレートパッケージのインポートに失敗したことを示すメッセージが表示されたときは,メッセージの内容を確認し,失敗の原因を取り除いた上で,インポートに失敗したサービステンプレートパッケージを再度インポートしてください。
-
インポートするサービステンプレートに定義された外部リソースプロバイダと同じUUIDの外部リソースプロバイダがすでに存在していた場合,サービステンプレートのインポート時に,サービステンプレートに定義された外部リソースプロバイダの内容で既存の外部リソースプロバイダを上書きします。
戻り値
コマンドの戻り値を次の表に示します。
戻り値 |
説明 |
---|---|
0 |
正常に終了しました。 |
1 |
引数が不正です。 |
2 |
コマンドの実行を中断しました。 |
3 |
サービスの状態が不正です。 |
4 |
ほかのコマンドを実行中です。 |
5 |
通信に失敗しました。 |
6 |
認証に失敗しました。 |
7 |
パスの指定が不正です。 |
9 |
指定したパスが存在しません。 |
14 |
コマンドの実行権限がありません。 |
180 |
サービステンプレートのインポートに失敗しました。 |
255 |
異常終了しました。 |
使用例
次の場合のコマンドの使用例を示します。
Windowsで,指定したサービステンプレートパッケージ(C:\temp\aaa.st)をJP1/AOにインポートする場合
importservicetemplate /file C:\temp\aaa.st /user user1 /password pass1
Windowsで,指定した複数のサービステンプレートパッケージをまとめたzipファイル( C:\temp\bbb.zip)をJP1/AOにインポートする場合
importservicetemplate /file C:\temp\bbb.zip /user user1 /password pass1