付録A.4 jslmmgrsetup(JP1/SLM - Managerのセットアップ)
機能
JP1/SLM - Managerの実行環境を新規作成します。また,構築済みのJP1/SLM - Managerの実行環境を再構築します。
JP1/SLM - Managerのインストール後に実行してください。
コマンドの実行結果は標準出力に出力され,コンソール画面上に表示されます。
コマンド実行時の実行環境の状態に応じて,次のどちらかの処理が実行されます。
- 実行環境の新規作成(実行環境がない場合)
JP1/SLM - Managerの新規インストール直後,またはアンセットアップによってJP1/SLM - Managerの実行環境を破棄した状態でこのコマンドを実行すると,実行環境が新規に作成されます。
- 構築済みの実行環境の再構築(実行環境がある場合)
JP1/SLM - Managerの実行環境がすでにある状態でこのコマンドを実行すると,構築済みのJP1/SLM - Managerの実行環境が再構築されます。
次のような場合に,実行環境の再構築を実行してください。
構築済みのJP1/SLM - Managerの実行環境で,ホスト名,IPアドレス,またはポート番号の設定値を変更する場合
構築済みのJP1/SLM - Managerの実行環境で,組み込みWebサーバの環境を再構築する場合
構築済みのJP1/SLM - Managerの実行環境に対してバージョンアップインストールを実行したあと,実行環境を再構築する場合
なお,JP1/SLM - Managerの実行環境の再構築では,組み込みデータベースのRDエリアの作成は実行されません。
形式
jslmmgrsetup△オプションファイルの絶対パス
実行権限
OSのAdministratorsグループに属するユーザーアカウント
格納先フォルダ
JP1/SLM - Managerのインストール先フォルダ\mgr\bin\
引数
オプションファイルの絶対パス
オプションファイルは,テキスト形式で作成して任意の場所に格納します。オプションファイルの格納先は,ファイル名称(任意)を含めた格納先での絶対パスが255バイト以内の文字列になるようにしてください。
オプションファイルのテンプレートは,次のとおり格納されています。
JP1/SLM - Managerのインストール先フォルダ\mgr\template\mgr\conf\jp1itslm_setup.opt
オプションファイルの定義内容を次に示します。
manager_host=JP1/SLM - Managerのホスト名またはIPアドレス manager_port=JP1/SLM - Managerのポート番号 psb_Listen=組み込みWebサーバのListenポート番号 psb_ServerName=組み込みWebサーバのホスト名またはIPアドレス psb_connector_port=組み込みWebサーバの内部通信ポート番号 psb_shutdown_port=組み込みWebサーバの終了メッセージ受信ポート番号 hdb_port=組み込みデータベースのListenポート番号 hdb_area_path=組み込みデータベースのRDエリア格納フォルダ名 hdb_area_size=組み込みデータベース領域の容量
定義項目の詳細を次の表に示します。
項番 |
定義項目 |
指定の要否 |
説明 |
デフォルト値 |
---|---|---|---|---|
1 |
manager_host |
○ |
JP1/SLM - Managerの実行環境を特定するための情報として,JP1/SLM - Managerをインストールしたホストのホスト名またはIPアドレスを指定します。 |
− |
2 |
manager_port |
△ |
JP1/SLM - Managerが使用するポート番号を,半角数字で1〜65535の範囲※1で指定します。 |
20904 |
3 |
psb_Listen |
△ |
組み込みWebサーバが使用するListenポート番号を,半角数字で1〜65535の範囲※2で指定します。 |
20900 |
4 |
psb_ServerName |
○ |
組み込みWebサーバのホスト名またはIPアドレスを指定します。 |
localhost |
5 |
psb_connector_port |
△ |
組み込みWebサーバの内部通信ポート番号を,半角数字で1〜65535の範囲※1で指定します。 |
20901 |
6 |
psb_shutdown_port |
△ |
組み込みWebサーバの終了メッセージ受信ポート番号を,半角数字で1〜65535の範囲※1で指定します。 |
20902 |
7 |
hdb_port |
△ |
組み込みデータベースのListenポート番号を,半角数字で5001〜65535の範囲で指定します。 次の番号を指定した場合はエラーになります。
なお,エフェメラルポート番号(一時的な利用のために自由に使用できるポート番号)を指定した場合は,使用済みのポート番号に該当しやすいため注意してください。 |
20903 |
8 |
hdb_area_path※3 |
○ |
組み込みデータベースのRDエリアを格納するフォルダの絶対パスです。ローカルディスクのフォルダを130文字以内で指定します。 ただし,ドライブ名(半角文字でA〜Z,a〜zの1文字,および「:」(コロン)で構成される文字列)で始まり,半角文字でA〜Z,a〜z,0〜9,「_」(下線),「.」(ピリオド),「( )」(丸括弧),「\」,半角スペースで構成された文字列でなければなりません。 また,次の指定はできません。
|
− |
9 |
hdb_area_size※3 |
△ |
JP1/SLM - Managerが扱うデータを格納するための,組み込みデータベース領域の容量を指定します。半角数字で5000〜1048575の整数で指定します(単位:MB)。 範囲外の値を指定した場合はエラーになります。 この定義は,再構築の場合には有効になりません。 |
39000 |
- (凡例)
○:必ず指定します。
△:指定は任意です。
−:該当しません。
- 注※1
指定範囲外の値を指定した場合,セットアップは完了しますが,JP1/SLM - Managerのサービス「JP1/SLM - Manager Service」(サービス名:JP1_ITSLM_MGR_Service)の起動時に失敗します。
- 注※2
指定範囲外の値を指定した場合,セットアップは完了しますが,JP1/SLM - Managerのサービス「JP1/SLM - Manager Web Service」(サービス名:JP1_ITSLM_MGR_Web_Service)の起動時に失敗します。
- 注※3
構築済みのJP1/SLM - Managerの実行環境の再構築の場合,指定値を変更しないでください。
注意事項
セットアップ中にエラーが発生した場合は,エラーの要因を取り除いたあとに再度このコマンドを実行してください。ただし,実行環境の新規作成に失敗し,かつ前回実行時とコマンドの引数を変える場合は,アンセットアップをしてからコマンドを再実行してください。
セットアップで使用したオプションファイルは,このコマンドの実行後にファイル名称が「jp1itslm_setup.opt」に変更され,次のとおり格納されます。
JP1/SLM - Managerのインストール先フォルダ\mgr\conf\jp1itslm_setup.opt
このコマンドの実行中に,このコマンドを含むほかのコマンドを実行しないでください。
コマンドの実行時に下記のフォルダにシステム定義ファイルが存在する場合,システム定義ファイルのファイル名に「.bk」を付けたファイル名で同じフォルダに待避されてから新しいシステム定義ファイルが生成されます。
JP1/SLM - Managerのインストール先フォルダ\mgr\conf\
待避時に同じ名前のファイルがある場合は上書きされます。待避に失敗した場合はセットアップに失敗します。新しいシステム定義ファイルは,待避したシステム定義ファイルの定義項目の指定値が引き継がれます。ただし,コマンドの実行時にシステム定義ファイルで指定した定義項目については,システム定義ファイルで指定した定義項目の指定値が設定されます。コメントは引き継がれません。
セットアップ中に,キーボードの「Ctrl」キー+「C」キーやウィンドウを閉じるなどの操作で,セットアップを終了しないでください。異常が発生した場合も,セットアップが完了するまで待ってください。
セットアップでは,ほかのインストーラー,ほかのアプリケーションなど,常駐ソフトを終了させてからセットアップを実行してください。ほかのアプリケーションには,jslmursetupコマンドも含まれます。
定義項目を省略した場合はデフォルト値が使用されます。
構築済みのJP1/SLM - Managerの実行環境の再構築の場合は,前回構築時のセットアップオプションを使用するよう注意してください。
-
データベースをリストアまたは移行する場合,リストア環境または移行先環境をセットアップするときのオプションファイルの定義項目「hdb_area_size」には,バックアップした環境または移行元の環境と同じサイズ以上の値を指定してください。
現在のデータベース領域の容量は,jslmmgrsetupコマンドを実行した際に作成される次のファイルを参照してください。
JP1/SLM - Managerのインストール先フォルダ\mgr\conf\jp1itslm_setup.opt
ただし,再セットアップを実行した場合,上記のファイルは更新されます。
このため,誤った手順でデータベースの容量を変更しようとした場合,現在の容量が上記のファイルから判断できなくなります。
現在の容量は,セットアップファイルで指定した次のフォルダサイズから判断してください。
hdb_area_pathで指定したフォルダ\ITSLMSYS04
戻り値
戻り値 |
説明 |
---|---|
0 |
セットアップが正常に終了しました。 |
1 |
セットアップに失敗しました。 |
使用例
C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmmgrsetup△C:\Users\Administrator\Desktop\jp1itslm_setup.opt