Access Manager 7 2005Q4 には、次の機能を実行するための amsfo スクリプトが用意されています。
セッションフェイルオーバー配備用に指定されている Java Message Queue (MQ) ブローカを起動および停止します。
セッションフェイルオーバー配備用に指定されている amsessiondb クライアン トを起動および停止します。
amsfo.conf 設定ファイルを読み取り、ファイル内の変数に基づいた特定の操作を実行します。たとえば、スクリプトで、最初に Berkeley DB データベースを削除し、次に再作成するように設定できます。
/tmp/amsession/logs/ ディレクトリ内の amsessiondb.log、jmq.pid、および amdb.pid の各ファイルに書き込みます。デフォルトのログディレクトリは、amsfo.conf ファイル内の LOG_DIR 変数によって決定されます。
Access Manager セッションフェイルオーバーコンポーネントを起動するには、次の手順に従います。
配備の必要に応じて、amsfo.conf 設定ファイル内の変数を設定します。これらの変数については、表 6–4を参照してください。
amsfo スクリプトを実行して、Java Message Queue (MQ) ブローカおよび amsessiondb クライアントを起動します。詳細は、「amsfo スクリプトの実行」を参照してください。
各 Access Manager インスタンスを、それぞれの Web コンテナを起動することに より起動します。詳細は、『Sun Java System Access Manager 7 2005Q4 管理ガイド』を参照してください。
amsfo スクリプトには、次の起動および停止オプションが含まれています。
使用法: amsfo { start | stop }
amsfo スクリプトを実行するには、次の手順に従います。
スーパーユーザー (root) としてログインするか、スーパーユーザーになります。
配備の必要に応じて、amsfo.conf ファイル内の変数を設定します。これらの変数については、表 6–4を参照してください。
スクリプトを実行します。たとえば、Access Manager がデフォルトディレクトリにインストールされた Solaris システムでセッションフェイルオーバーコンポーネントを起動するには、次のように入力します。
# cd /opt/SUNWam/bin # ./amsfo start
スクリプトの結果をチェックするには、/tmp/amsession/logs/amsessiondb.log ファイルを確認します。
次の表は、amsfo.conf 設定ファイル内の変数を示しています。amsfo スクリプトを実行する前に、これらの変数を配備の必要に応じて設定します。
表 6–4 amsfo.conf 設定ファイル
変数 |
説明 |
---|---|
AM_HOME_DIR |
Access Manager のデフォルトのインストールディレクトリ。デフォルトディレクトリは、次のようにプラットフォームによって異なります。 Solaris システム: AccessManager-base/SUNWam/opt Linux システム: AccessManager-base/identity/opt AccessManager-base は、Access Manager のベースインストールディレクトリを表します。デフォルト値は、Solaris システムでは /opt、Linux システムでは /opt/sun です。 |
AM_SFO_RESTART |
スクリプトで amsessiondb クライアントを自動的に再起動するかどうかを指定します (true または false)。 デフォルトは true (amsessiondb クライアントを再起動する) です。 |
CLUSTER_LIST |
クラスタに参加している Message Queue ブローカのリスト。形式は次のとおりです。 host1:port, host2:port,host3: port 次に例を示します。 jmq1.example.com:7777,jmq2.example.com:7777,jmq3.example.com:7777 デフォルトはありません。 |
DATABASE_DIR |
セッションデータベースファイルを作成するディレクトリ。 デフォルトは "/tmp/amsession/sessiondb" です。 |
DELETE_DATABASE |
スクリプトで amsessiondb プロセスを再起動するときに、新規データベースを削除してから作成するかどうかを指定します (true または false)。 デフォルトは true です。 |
LOG_DIR |
ログディレクトリの場所。 デフォルトは "/tmp/amsession/logs" です。 |
START_BROKER |
amsessiondb プロセスとともに Message Queue ブローカを起動するかどうかを指定します (true または false)。この変数を次のように設定します。 true - Message Queue ブローカは、amsessiondb プロセスと同じマシン上で実行されます。 false - Message Queue ブローカと amsessiondb プロセスは、別のマシン上で実行されます。 デフォルトは true です。 |
BROKER_INSTANCE_NAME |
起動する Message Queue ブローカインスタンスの名前。 デフォルトは aminstance です。 |
BROKER_PORT |
ローカル Message Queue ブローカインスタンスのポート。 デフォルトは 7777 です。 |
BROKER_VM_ARGS |
Java VM の引数。デフォルトは "-Xms256m -Xmx512m" です。これにより、システムリソースに基づく最大値が設定されます。 |
USER_NAME |
Message Queue ブローカーへの接続に使用されるユーザー名。 デフォルトは「guest」です。「3–Message Queue サーバーでの新規ユーザーの追加」 の手順で別のユーザー名を指定した場合は、USER_NAME にその名前を設定します。 |
PASSWORDFILE |
Message Queue ブローカへの接続に使用される暗号化パスワードを含むパスワードファイルの場所。暗号化パスワードを生成するには、「amsfopasswd スクリプト」の説明に従って amsfopasswd スクリプトを使用します。 デフォルトは $AM_HOME_DIR/.password です。$AM_HOME_DIR は、Access Manager のデフォルトのインストールディレクトリを指定します。 |
amsfopasswd スクリプトはテキスト形式の Message Queue ブローカパスワードを受け取り、暗号化パスワードをファイル内に格納して返します。次に、このファイルを amsfo スクリプトへの入力 (PASSWORDFILE 変数) として使用できます。
amsfopasswd スクリプトは、次のディレクトリに格納されています。
Solaris システム: AccessManager-base /SUNWam/bin
Linux システム: AccessManager-base /identity/bin
デフォルトの AccessManager-base インストールディレクトリは、Solaris システムでは /opt、Linux システムでは /opt/sun です。
次の構文を使用して amsfopasswd スクリプトを実行します。
amsfopasswd -f filename | --passwordfile filename -e password | --encrypt password amsfopasswd -h | --help
次の表は、amsfopasswd スクリプトの引数を示しています。
表 6–5 amsfopasswd スクリプトの引数
引数 |
説明 |
---|---|
-f filename | --passwordfile filename |
amsfopasswd が暗号化パスワードを保存するファイルのパス。 |
-e password | --encrypt password |
amsfopasswd が暗号化するテキストパスワード。 |
-h | --help |
amsfopasswd コマンドの使用例を表示して、終了します。 |
次の例は、amsfopasswd スクリプトを示しています。暗号化パスワードは、/opt/SUNWam/.password ファイルに格納されます。
# ./amsfopasswd -f /opt/SUNWam/.password -e mypassword