amsessiondb スクリプトは、Berkeley DB クライアント (amsessiondb) の起動、データベースの作成、および特定のデータベース値の設定を行うために、amsfo スクリプトから呼び出されます。
Access Manager セッションフェイルオーバーコンポーネントの起動と停止には、amsfo スクリプトを実行し、そのスクリプトから amsessiondb スクリプトを呼び出す方法をお勧めします。次の情報は、amsessiondb スクリプトを単独で実行する必要が生じた場合のためにのみ提供されています。
amsessiondb スクリプトを実行する前に、「4–amsessiondb スクリプトの編集 (必要な場合)」の説明に従ってパスが正しく設定されていることを確認してください。
amsessiondb スクリプトを実行する場合、Message Queue ブローカーパスワードをコマンド行にテキストで入力できます (-w または --password オプション)。ただし、ファイル内で暗号化パスワードを使用する場合(-f または --passwordfile オプション) は、最初に amsfopasswd スクリプトを実行してMessage Queue ブローカテキストパスワードをファイル内に暗号化します。次に、このファイルを -f または --passwordfile オプションに使用して、amsessiondb スクリプトを実行します。
次の構文を使用して amsessiondb スクリプトを実行します。
amsessiondb [ -u username | --username username ] [ -w password | --password password | -f filename | --passwordfile filename ] [ -c cachesize | --cachesize cachesize ] [ -b dbdirectory | --dbdirectory dbdirectory ] -a MQServerAddressList | --clusteraddress MQServerAddressList [ -s numcleanexpiredsessions | --numcleansessions numcleanexpiredsessions ] [ -v | --verbose ] [ -i statsinterval | --statsInterval statsinterval ] amsessiondb -h | --help amsessiondb -n | --version
次の表は、amsessiondb スクリプトの引数を示しています。
表 6–6 amsessiondb スクリプトの引数
引数 |
説明 |
---|---|
-u username | --username username |
Message Queue ブローカーに接続するユーザー名。「3–Message Queue サーバーでの新規ユーザーの追加」で指定したユーザーを指定します。 デフォルトは「guest」です。 |
-w password | --password password |
Message Queue ブローカに接続するために使用するユーザー名のテキストパスワード。「3–Message Queue サーバーでの新規ユーザーの追加」で指定したパスワードを指定します。 デフォルトは「guest」です。 |
-f filename | --passwordfile filename |
Message Queue ブローカーにアクセスするための暗号化パスワードを格納するファイル。 このオプションを指定する場合は、-w または --password オプションを指定しないでください。 |
-c cachesize | --cachesize cachesize |
M バイト単位でのキャッシュサイズ。デフォルトは 8M バイトです。 |
-b dbdirectory | --dbdirectory dbdirectory |
Berkeley DB データベース (amsessions.db) が作成されるベースディレクトリ。 デフォルトは “sessiondb” です。amsessiondb スクリプトを実行しているディレクトリに作成されます。 注: データベースを作成するディスク領域を十分に確保するには、100,000 セッションあたり 1G バイト必要です。 |
-a MQServerAddressList | --clusteraddress MQServerAddressList |
次の形式の Message Queue ブローカアドレスリスト。 host1: port[,host2: port,host 3:port,...] 次に例を示します。mqsvr1:7777,mqsvr2:7777 |
-s numcleanexpiredsessions | --numcleansessions numcleanexpiredsessions |
クリーンアップ間隔ごとに削除される期限切れのセッション数。 デフォルトは 1000 です。 |
-v | --verbose |
冗長モードで実行します。結果は標準出力に送られます。 デフォルトは、非冗長モードです。 |
-i statsinterval | --statsInterval statsinterval |
要求、読み取り、書き込み、削除の合計の統計情報を標準出力に出力する秒単位の間隔。 デフォルトは 60 秒です。 |
-h | --help |
amsessiondb コマンドの使用例を表示して、終了します。 |
-n | --version |
現在インストールされている Access Manager のバージョンを返し、終了します。 |
次の例は、amsessiondb スクリプトを示しています。
amsessiondb -u amsvrusr -f pwfile -c 128 -b sessiondb -a host1:7777,host2:7777