8. コマンドラインモードによるインストール¶
特定のオプション引数を付加してインストーラを実行することにより、コマンドラインモードによるインストールを行うことができます。 各設定項目を対話形式で指定するのではなく、必要な設定値をオプションとして指定することで、千手システムを非対話で導入できます。 あわせて各種ツールを使用することで千手システムの導入を自動化することが可能です。
コマンドラインモードによるインストールは、一部のコンポーネントのみ対応しています。
| 千手システム | OS | 対応状況 |
|---|---|---|
| 千手マネージャ | Linux | ○ |
| 千手エージェント | Linux | ○ |
| 千手マネージャ | Windows | ○ |
| 千手エージェント | Windows | ○ |
| 千手DBコンポーネント | Windows | ✕ |
| 千手WEBコンポーネント | Windows | ✕ |
8.1. コマンドラインモードの制限事項¶
8.1.1. 制限事項¶
コマンドラインモードに関する制限事項は以下の通りです。
- Linux
- 特にありません。
- Windows
- 千手稼働アカウントとしてドメインユーザーを利用することはできません。
- 千手エージェントをマルチエージェントとしてインストールを行うことはできません。
- インストーラの終了コードでインストールの可否を判別することはできません。
- ライセンスキーの登録はインストール後、別途千手ブラウザなどから実施する必要があります。詳細については ユーザーズガイド 千手ブラウザの使い方(共通編) の 「ライセンスキーの変更」 を参照してください。
- コマンドラインモードを使用して千手DBコンポーネント、千手WEBコンポーネントをインストールすることはできません。
参考
- コマンドラインモード利用有無によらない千手システムの制限事項は下記を参照して下さい。
%s章:千手マネージャ(Linux)の制限事項%s章:千手エージェント(Linux)の制限事項%s章:千手マネージャ(Windows)の制限事項%s章:千手エージェント(Windows)の制限事項%s章:マルチエージェントの制限事項
8.2. コマンドラインモードによるインストール(Linux)¶
8.2.1. コマンドラインモード実行例(Linux)¶
(例) 千手マネージャの場合
# ./senju_mgr-XXXX-XX-linux-x64-XXXXXXXX.bin -s -D domain -K ja_JP.EUC -F /tmp/sjKEY_domain
(例) 千手エージェントの場合
# ./senju_agt-XXXX-XX-linux-x64-XXXXXXXX.bin -s -u user -D domain -N agent -L agent.long -K ja_JP.UTF8
8.2.2. 利用できるオプション(Linux)¶
コマンドラインモードによるインストール時に指定できるコマンドオプションを記載します。
千手マネージャ
TABLE 8.2 オプション一覧(千手マネージャ)¶ オプション 引数 省略 未指定時の既定値 説明 -s 不要 可 無し インストール継続の確認や、インストール後の千手システム起動の際に自動で処理を継続します。 -D 必要 可 ホスト名 千手ドメイン名を指定します。 -K 必要 可 ja_JP.EUC 千手システムの文字コードを指定します。 -F 必要 可 トライアルライセンス 千手システムのライセンスキーファイルの場所を絶対パスで指定します。 -h 不要 可 無し ヘルプメッセージが表示されます。 千手エージェント
TABLE 8.3 オプション一覧(千手エージェント)¶ オプション 引数 省略 未指定時の既定値 説明 -s 不要 可 無し インストール継続の確認や、インストール後の千手システム起動の際に自動で処理を継続します。 -u 必要 可 senju 千手システムをインストールする千手稼働アカウントを指定します。 -D 必要 不可 無し 所属する千手ドメイン名を指定します -N 必要 可 ホスト名 ノードIDを指定します。 -L 必要 可 設定無し ロングホスト名を指定します。 -K 必要 可 ja_JP.EUC 千手システムの文字コードを指定します。 -h 不要 可 無し ヘルプメッセージが表示されます。
注釈
- -s オプションを指定せずに実行した場合、設定項目を対話形式で確認しながらインストールします。
- 千手システムのインストール先は千手稼働アカウントのホームディレクトリとなります。
- サブエージェントとしてインストールする場合、-K オプション未指定時の既定値は、デフォルトエージェントの文字コードとなります。
- サポートされている文字コードは
%s章:サポートする文字コード一覧を参照してください。
8.3. コマンドラインモードによるインストール(Windows)¶
8.3.1. コマンドラインモード実行例(Windows)¶
(例) 千手マネージャの場合
> senju_mgr-XXXX-XX-windows-x64-XXXXXXXX.exe /SILENT /LOADINF=mgr.inf
(例) 千手エージェントの場合
> senju_agt-XXXX-XX-windows-x64-XXXXXXXX.exe /SILENT /LOADINF=agt.inf
8.3.2. 利用できるオプション(Windows)¶
Windows向けコンポーネントのコマンドラインモードによるインストールを実施する場合、インストーラーと同じディレクトリに以下の設定ファイルが必要です。
- setup.ini : 千手ドメイン名などを設定します。
- {任意名}.inf : インストール言語など指定します。
千手マネージャ・千手エージェント共通して、以下のオプション（スイッチ）を指定可能です。
| オプション | 引数 | 省略 | 未指定時の既定値 | 説明 |
|---|---|---|---|---|
| /SILENT | 不要 | 可 | 無し | 指定した場合、コマンドラインモードでインストーラを起動します。 |
| /LOADINF | 必要 | 可 | 無し | 設定ファイルを絶対パスで指定します。 |
注釈
- /SILENT オプションを指定せずに実行した場合は、対話形式でのインストールとなります。
- .inf ファイルは任意のファイル名を使用できますが、 setup.ini ファイルのファイル名は固定となります。
8.3.2.1. setup.iniの設定¶
setup.ini ファイルにて、 InputParameter セクションを作成し、以下のパラメータを設定してください。
千手マネージャ
TABLE 8.6 オプション一覧(千手マネージャ)¶ オプション 省略 未指定時の既定値 説明 SENJUHOME 可 C:\senju 千手システムをインストールする千手ホームディレクトリを指定します。 DOMAINNAME 可 ホスト名 千手ドメイン名を指定します。 PASSWORD 不可 無し 千手稼働アカウントのパスワードを指定します。 RESTART 可 True インストール完了時に千手システムの起動を行うか指定します。起動しない場合は False を指定します。 設定ファイル内容の例）
[InputParameter] SENJUHOME=C:\senju DOMAINNAME=domain PASSWORD=password RESTART=False
千手エージェント
TABLE 8.7 オプション一覧(千手エージェント)¶ オプション 省略 未指定時の既定値 説明 USERNAME 可 senju 千手システムをインストールする千手稼働アカウントを指定します。 SENJUHOME 可 C:\senju 千手システムをインストールする千手ホームディレクトリを指定します。 DOMAINNAME 不可 無し 所属する千手ドメイン名を指定します。 NODEID 可 ホスト名 ノードIDを指定します。 ALIAS 可 設定無し ロングホスト名を指定します。 PASSWORD 不可 無し 千手稼働アカウントのパスワードを指定します。 RESTART 可 True インストール完了時に千手システムの起動を行うか指定します。起動しない場合は False を指定します。 ENABLE_LOCALSYSTEM_USER 可 False 千手稼働アカウントとしてローカルシステムアカウントを使用する場合に True を指定します。 設定ファイル内容の例）
[InputParameter] USERNAME=user SENJUHOME=C:\senju DOMAINNAME=domain NODEID=agent ALIAS=agent.long PASSWORD=password RESTART=False
8.3.2.2. infファイルの設定¶
inf ファイルの作成方法について記載します。
コマンドプロンプトにて パッケージ名 /SAVEINF=保存先ファイルパス\ファイル名 のように指定して実行します。
通常のインストールと同様にインストールが完了後、 /SAVEINF にて指定したパスおよび inf ファイルが作成されます。
以下は、 inf ファイル作成のためのインストーラ実行の例です。
千手マネージャ
> senju_mgr-XXXX-XX-windows-x64-XXXXXXXX.exe /SAVEINF=mgr.inf
千手エージェント
> senju_agt-XXXX-XX-windows-x64-XXXXXXXX.exe /SAVEINF=agt.inf
上記の手順で作成後、コマンドラインモードによるインストールで利用するにあたり、変更が必要となる inf ファイルの項目を下記に記載します。
inf ファイルの設定項目（千手マネージャ・千手エージェント共通）
TABLE 8.8 オプション一覧(infファイル)¶ オプション 値 説明 Lang japanese | english 千手インストール言語を指定します。 設定例）
[Setup] Lang=japanese Dir=C:\senju Group=(Default) NoIcons=0 SetupType=main Components=base Tasks=
8.3.3. 終了ステータス(Windows)¶
Windows向けコンポーネントのコマンドラインモードによるインストールを行った場合、終了コードでインストールの可否を判別することはできません。
インストールの処理結果については、千手ホームディレクトリの log ディレクトリ下、もしくは %temp% ディレクトリ下のインストール時のログを確認してください。