cscrepctl(インポート/エクスポート)
形式
cscrepctl [-h] -user <ログインユーザID> -pass <ログインパスワード> {-import <ファイル名> [-overwrite] [{-check|-compo [{-name {<サービスID>|<ユーザ定義受付(呼出先選択)の受付ID>} |-namelist <HCSCコンポーネント指定ファイル名>}] [-nouoc] }] |-export <ファイル名> |-autoexport |-delete {-name {<サービスID>|<ユーザ定義受付(呼出先選択)の受付ID>} |-namelist <HCSCコンポーネント指定ファイル名>}}
機能
リポジトリ内の情報をZIP形式ファイルに出力したり,ZIP形式で保存された情報をリポジトリに展開したりします。また,リポジトリ内のコンポーネントの削除もできます。
ログインユーザIDなどの必須オプションは,HCSC-Managerコマンド共通定義ファイルにデフォルト値を設定することで,このコマンドでの指定を省略できます。
このコマンドの使用方法については,目的にあわせてマニュアル「サービスプラットフォーム システム構築・運用ガイド」の次に示す個所を参照してください。
引数
-h
コマンドの使用方法が表示されます。このオプションを指定している場合は,ほかのオプションを指定しても無視されます。
-user <ログインユーザID> 〜<半角英数字およびアンダーバー(_)> ((1−16文字))
HCSC-Managerログイン時に使用するユーザIDを指定します。
-pass <ログインパスワード> 〜<半角英数字およびアンダーバー(_)> ((1−16文字))
HCSC-Managerログイン時に使用するパスワードを指定します。
-import <ファイル名> 〜 ((1−200バイト))
展開するZIP形式ファイルを絶対パス,または相対パスで指定します。
-overwrite
インポート時にZIP形式で保存されたHCSCコンポーネントを運用環境のリポジトリに展開します。このオプションは,-import指定時に有効になります。
-overwriteオプションを指定した場合は,変更されていないHCSCコンポーネントを含め,ZIP形式ファイルに保存されたHCSCコンポーネントのすべてを運用環境のリポジトリに展開します。
-overwriteオプションを省略した場合は,ZIP形式ファイルに保存されたHCSCコンポーネントのうち変更されたHCSCコンポーネントだけが,ZIP形式ファイルから運用環境のリポジトリに展開されます。このとき,変更のないHCSCコンポーネントは,現在ある運用環境のリポジトリのHCSCコンポーネントをそのまま使用します。
-check
現在の運用環境のリポジトリ情報とインポートするリポジトリ情報で,HCSCサーバの構成情報が同じかどうかをチェックします。HCSCサーバの構成情報が異なる場合は,エラーになります。このオプションは,-import指定時に有効になります。なお,標準インポートの場合は,このオプションを指定しないでください。
-compo
コンポーネント単位でインポートします。
-name {<サービスID>|<ユーザ定義受付(呼出先選択)の受付ID>} 〜<半角英数字およびアンダーバー(_)> ((1−8文字))
インポートまたは削除の対象を次のどちらかで指定します。
- <サービスID>
-
ビジネスプロセスまたはサービスアダプタのサービスIDを指定します。
- <ユーザ定義受付(呼出先選択)の受付ID>
-
ユーザ定義受付(呼出先選択)の受付IDを指定します。
-compoオプションの指定時にこのオプションを省略した場合,すべてのHCSCコンポーネントがインポートの対象となります。
-namelist <HCSCコンポーネント指定ファイル名> 〜((1−200バイト))
インポートまたは削除するHCSCコンポーネントをHCSCコンポーネント指定ファイルで指定します。
絶対パスまたは相対パスで指定します。ファイルが存在しない場合は異常終了します。HCSCコンポーネント指定ファイルについては,「6.5.5 HCSCコンポーネント指定ファイル」を参照してください。
なお,指定されたHCSCコンポーネントの実行順序に決まりはありません。
-nouoc
コンポーネント単位でのインポート時にUOCを更新しない場合に指定します。UOCとは,開発環境のHCSCTEプロジェクト内でユーザが独自に作成したソース,クラスおよびライブラリを示します。
このオプションは-compoオプションの指定時だけ指定できます。
-export <ファイル名> 〜 ((1−200バイト))
出力するZIP形式ファイルのファイル名を絶対パス,または相対パスで指定します。指定したファイルまでのディレクトリがない場合,異常終了になります。指定したファイルがすでにある場合,上書きされます。指定したファイルの拡張子を「.zip」にしなかった場合は,「.zip」が付けられます。
-autoexport
ZIPファイルをデフォルトファイル名で出力する場合に指定します。デフォルトファイル名は,次の形式で付与されます。
-
IPv4の場合:aaabbbcccddd_YYYYMMDDhhmmss.zip
-
IPv6の場合:aaaabbbbccccddddeeeeffffgggghhhh_YYYYMMDDhhmmss.zip
- aaabbbcccddd:
-
コマンドを実行したマシンのIPv4アドレスを示します。
- aaaabbbbccccddddeeeeffffgggghhhh:
-
コマンドを実行したマシンのIPv6アドレスを示します。
- YYYYMMDDhhmmss:
-
バックアップした時間を示します。
YYYY:西暦年,MM:月,DD:日,hh:時,mm:分,ss:秒
出力先はcscmng.properties(HCSC-Manager定義ファイル)に指定できます。出力先を指定しなかった場合はカレントディレクトリに出力されます。
-delete
運用環境のリポジトリから,指定されたサービスIDのコンポーネントを削除します。このオプションの後ろに,削除対象のサービスIDを-nameオプションまたは-namelistオプションで指定してください。
このオプションを指定してサービスを削除すると,ほかのビジネスプロセスから呼び出されるサービスも削除されます。そのため,削除するサービスは適切に選択してください。
入力例
- (1)repository.zipの内容をリポジトリに展開する場合
cscrepctl -user admin -pass admin -import repository.zip
- (2)カレントディレクトリにリポジトリ情報を収集したrepository.zipを出力する場合
cscrepctl -user admin -pass admin -export repository.zip
- (3)デフォルトファイル名で出力する場合
cscrepctl -user admin -pass admin -autoexport
- (4)repository.zipの内容をコンポーネント単位でインポートする場合
cscrepctl -user admin -pass admin -import repository.zip -compo
- (5)サービスID,またはユーザ定義受付(呼出先選択)の受付IDが1のHCSCコンポーネントをインポートする場合
cscrepctl -user admin -pass admin -import repository.zip -compo -name 1
- (6)repository.zipの内容のうちHCSCコンポーネント指定ファイルhcsccomponent.txtに指定されているすべてのHCSCコンポーネントをインポートする場合
cscrepctl -user admin -pass admin -import repository.zip -compo -namelist hcsccomponent.txt
- (7)サービスID,またはユーザ定義受付(呼出先選択)の受付IDが1のHCSCコンポーネントを削除する場合
cscrepctl -user admin -pass admin -delete -name 1
- (8)HCSCコンポーネント指定ファイルhcsccomponent.txtに指定されているHCSCコンポーネントをすべて削除する場合
cscrepctl -user admin -pass admin -delete -namelist hcsccomponent.txt
戻り値
戻り値 |
意味 |
---|---|
0 |
正常終了しました。 |
1 |
コマンドが異常終了しました。 |
3 |
排他エラーが発生しました。 |
9 |
実行権限のチェックエラーが発生しました。 |
注意事項
-
運用環境にログイン中の場合は,このコマンドを実行できません。
-
インポートする場合は,必ずリポジトリに設定したディレクトリ以下のディレクトリおよびファイルを参照していないことを確認してから,cscrepctlコマンドを実行してください。
-
現在の運用環境のリポジトリ情報とインポートするリポジトリ情報で,データベースおよびReliable Messagingを使用するかどうかの設定が異なる場合,インポート時にエラーになることがあります。
-
現在の運用環境のリポジトリ情報と,インポートするリポジトリ情報のSOAPモードが異なる場合,インポート時にエラーになります。