| Sun ONE Application Server 7, Enterprise Edition インストールガイド |
第 3 章
HADB の設定準備高可用性コンポーネントをクラスタの一部になるサーバー上にインストールしたあと、この章で説明するタスクを実行して高可用性の設定を準備します。Sun ONE Application Server 7, Enterprise Edition 実装に必要なイベントのすべての流れを確認するには、「インストールの概要」を参照してください。
ここでは次の項目について説明します。
ここで説明するタスクを実行したあと、クラスタ、ロードバランサプラグイン、および高可用性データベース (HADB) の設定と管理の詳細な手順について『Sun ONE Application Server 管理者ガイド』を参照してください。
高可用性のトポロジについては、『Sun ONE Application Server システム配備ガイド』を参照してください。
共有メモリーとセマフォの設定HADB の使用を始める前に、HADB ホストマシンの共有メモリーを設定する必要があります。
- root としてログインします。
注
必要に応じて、root 以外のユーザーとして HADB を管理するための正しいアクセス権が設定されていることを確認します。「HADB 管理のための RSH の設定」、手順 5 を参照してください。
- /etc/system ファイルに次のような行がまだ存在していない場合は、ファイルにこれらの行を追加します。
共有メモリーの場合 :
set shmsys:shminfo_shmmax=0x80000000
set shmsys:shminfo_shmseg=20この例では、共有メモリー shmmax を 2G バイト (16 進 0x80000000) に設定しています。これは、ほとんどの設定に十分な値です。
shmsys:shminfo_shmmax の設定は 256M バイトごとに 10,000,0000 として計算され、ホストのメモリーサイズと同じに設定します。ホストのメモリーを決定するには、次のコマンドを実行します。
prtconf | grep Memory
そのあと、ホストのメモリー値を次の式に入力します。
((<host> M バイト / 256M バイト) * 10,000,000)
セマフォの場合 :
/etc/system ファイルには、あらかじめ semmni、semmns、および semmnu エントリが含まれている場合があります。次に例を示します。
set semsys:seminfo_semmni=10
set semsys:seminfo_semmns=60
set semsys:seminfo_semmnu=30
このエントリが存在する場合は、次のように 16、128、および 1000 をそれぞれ追加することで、値を増加させます。
set semsys:seminfo_semmni=26
set semsys:seminfo_semmns=188
set semsys:seminfo_semmnu=1030/etc/system ファイルに上述のエントリが含まれていない場合は、ファイルの末尾に次のエントリを追加します。
set semsys:seminfo_semmni=16
set semsys:seminfo_semmns=128
set semsys:seminfo_semmnu=1000これは、コンピュータ上の最大 16 個の HADB ノードを起動するために十分な値です。
- マシンを再起動して、変更を有効にします。
HADB ノードの説明については、『Sun ONE Application Server 管理者ガイド』の「高可用性データベースの管理」を参照してください。
ホスト通信の設定HADB の管理用のリモートアクセスを実装するには、HADB サーバーと HADB 管理クライアントを稼働させるために使用するすべてのマシンが、リモートシェル (RSH) またはセキュアシェル (OpenSSH/SSH) 用に設定されている必要があります。
RSH は単純なリモートシェルコマンドであり、セキュリティ機能はありません。SSH 通信チャネルは、HADB ノード間で渡されるデータを暗号化することによって、一定レベルのセキュリティを提供します。
注
Solaris 9 の場合は、SSH のデフォルトのインストールを使用することをお勧めします。ただし、必要であれば RSH を使用することができます。この場合は、「HADB 管理のための RSH の設定」の手順を実行してから、「clsetup コマンドの実行」の説明に従って、特定の RSH 用に clresource.conf ファイルを編集します。
Solaris 8 では、デフォルトでは SSH はインストールされません。SSH が使用している Solaris 8 システム上にない場合は、「Solaris 8 への SSH のインストール」の手順に従ってください。
SSH を使用したいが設定されていない、または使用できない場合は、hadbm コマンドを使用することはできません。SSH が認識されていることを確認するには、「SSH の要件と制限事項」を参照してください。
ここでは、次のタスクの手順を示します。
HADB 管理のための RSH の設定
SSH ではなく RSH を使用する場合は、set managementProtocol オプションを使って RSH を明示的に指定する必要があります。clresource.conf ファイルでこのパラメータを設定する方法については、表 3-3 を参照してください。
RSH を実装するには、次の手順を実行します。
- root としてログインします。
- /etc/hosts ファイルを編集して、ローカルホストのホスト名など、選択したすべての HADB ホストのエントリを組み込みます。localhost の形式を使用します。次に例を示します。
computer1.xbay.company.com
computer99.zmtn.company.com- このファイルを、選択したすべてのインストールホストの /etc/hosts ファイルに追加します。
- HADB ユーザーの $HOME ディレクトリに .rhosts ファイルが存在していない場合は、このファイルを作成します。
vi .rhosts
- グループやその他に対して読み取り専用のアクセス権が設定されていることを確認します。次に例を示します。
rw-r--r--
- 各 HADB ホストのホスト名を追加します。このホスト名にはローカルホストの名前が含まれ、そのあとにデータベースユーザーの名前が続きます。たとえば、データベースユーザーが Jon の場合は次のようになります。
computer1.xbay.company.com Jon
computer99.zmtn.company.com Jon
mine456.red.mycompany.com Jon- このファイルを各 HADB ホストの .rhosts に追加します。
- 各ホストのホスト通信をチェックします。次に例を示します。
rsh computer99.zmtn.company.com uname -a
すべて正常に完了すると、その他のホストから ID が戻されます。
HADB 管理のための SSH の設定
SSH は RSH よりも安全であるため、hadbm create コマンドを使用する場合に強くお勧めします。
注
セキュリティの観点から、RSA ベースのバージョン 1 のプロトコルではなく、DSA ベースのバージョン 2 のプロトコルをお勧めします。選択するバージョンは、サイトで使用している SSH クライアントソフトウェアによって異なります。
この節では、次のトピックを取り上げます。
SSH の要件と制限事項
注
SSH は、Solaris 9 システムにはデフォルトでインストールされますが、Solaris 8 にはデフォルトでインストールされません。Solaris 8 向けの SSH のインストール手順については、「Solaris 8 への SSH のインストール」を参照してください。
SSH を設定するときは、次の要件の一部またはすべてを考慮する必要があります。
/usr/bin
- バイナリがシステム上にあっても、その場所が正しくない場合は、/usr/bin から正しい場所へのシンボリックリンクを作る必要があります。
- Solaris 8 システムの場合、SSH バイナリはデフォルトではインストールされないため、存在しない可能性があります。この場合は、「Solaris 8 への SSH のインストール」の手順に進んでください。
- root 特権で実行 - HADB 管理クライアントを root として実行している場合は、すべてのマシンの sshd 設定 (/etc/ssh/sshd_config) で PermitRootLogin パラメータを必ず yes に設定してください。
注
デフォルトでは、Sun SSH は root 特権でのログインを許可しないため、これは no に設定されています。sshd 設定を変更した場合は、sshd を再起動する必要があります。サービスを再起動するには、次のように入力します。
/etc/init.d/sshd stop/start
- SSH プロトコルのバージョン 2 をサポートしない - SSH クライアントおよびデーモンが SSH プロトコルのバージョン 2 をサポートしていない場合は、オプションを付けずに ssh-keygen を実行する必要があります。このキーファイルに、id_dsa.pub ではなく identity.pub という名前が付きます。このファイルは ~/.ssh/authorized_keys に追加する必要があります。
- 混在した SSH 環境 - 混在した SSH 環境で操作する場合は、~/.ssh/authorized_keys2 ファイルと ~/.ssh/authorized_keys ファイルの両方を作成する必要があります。後者には、バージョン 1 とバージョン 2 の両方のキーが含まれている場合があります。
- 同じ場所に置く - Sun ONE Application Server と HADB を同じマシン上の同じ場所に置く場合は、次のコマンドのどちらかを実行して、.ssh ディレクトリの下に known_hosts ファイルを作成する必要があります。
ssh localhost
または
ssh hostname
Solaris 8 への SSH のインストール
Solaris 8 システムでは、ssh バイナリおよび scp バイナリはデフォルトではインストールされません。これらのバイナリが Solaris 8 システム上にない場合は、次の手順を実行します。
- 次のサイトに移動します。
http://www.sunfreeware.com/openssh8.html
このサイトでは、次のようなメッセージが表示されることがあります。
===PLEASE NOTE!!!............ make a note of some of the mirror sites so that if the servers are down, you can still download from a mirror site.
このようなメッセージが表示された場合は、「FTP/Mirror Sites」のリンクのリストにあるミラーサイトのいずれかにアクセスしてみてください。次に例を示します。
http://sunfreeware.secsup.org/
- このサイトで、「Installation Steps」の手順に従って、必要な OpenSSH のパッケージとパッチのすべてをダウンロードしてインストールします。
- OpenSSH をインストールしたあと、「SSH の設定」の次の節に進みます。
SSH の設定
ssh バイナリおよび scp バイナリがすでにインストールされているシステム上に SSH を設定するには、次の節で説明する手順のどちらかを実行します。
マウントされていないホームディレクトリの SSH
ホームディレクトリがマウントされていないシステムに SSH を実装するには、次の手順を実行します。
- SSH 要件が理解されていて、「SSH の要件と制限事項」に示す要件が満たされていることを確認します。
- HADB ユーザーとしてホストにログインします。
- 次のコマンドを実行して、キーを生成します。
ssh-keygen -t dsa
SSH1 と OpenSSH/1 の場合、通常は ssh-keygen コマンドにパラメータを付ける必要はありません。
- 次の 3 つのプロンプトに対して、Enter を押してデフォルトのオプションを受け入れます。
- クラスタ内のすべてのマシンに対して手順 1、2、および 3 を繰り返します。
~/.ssh ディレクトリ内にある identity.pub または id_dsa.pub というファイル (SSH のバージョン 1 とバージョン 2 のどちらを使うかによって異なる) に公開鍵が格納されます。マシンに接続する際のパスワード入力を不要にするには、このファイルの内容を、すべてのマシン上の authorized_keys というファイルに追加する必要があります。
- ログイン ID を設定するには、ユーザーディレクトリに移動します。
~/.ssh.
SSH1、OpenSSH/1 の場合、次の手順を行います。
- uthorized_keys ファイルを、すべての HADB マシンの ~/.ssh ディレクトリにコピーします。
- .ssh ディレクトリ、HADB ユーザーのホームディレクトリ、および .ssh/authorized_keys ファイルに対して、グループとその他の書き込み権がないことを確認します。
必要に応じて、これらのグループやその他の書き込み権を、次のようにして無効にします。
chmod og-w ~/.ssh
chmod og-w ~/.ssh/authorized_keys
chmod og-w $HOME$HOME を HADB ユーザーのホームディスクと置き換えます。たとえば、次のようにします。
chmod og-w ~/johnsmith
- ユーザーが入力しなくてもログインできるようにするには、はじめて SSH を使用するときに (SSH 環境を設定したあと)、/.ssh ディレクトリの下の known_hosts ファイルに、次のようにノードマシン名を追加する必要があります。
- SSH が正しく設定されたことを確認するには、HADB の管理ツールを実行する前に、クラスタ内の各ホストに SSH します。
パスワードの要求なしで自動ログインします。
マウントされているホームディレクトリの SSH
ホームディレクトリがマウントされているシステムに SSH を実装するには、次の手順を実行します。
- SSH 要件が理解されていて、「SSH の要件と制限事項」に従って要件が満たされていることを確認します。
- HADB ユーザーとしてホストにログインします。
- 次のコマンドを実行して、キーを生成します。
ssh-keygen -t dsa
SSH1 と OpenSSH/1 の場合、通常は ssh-keygen コマンドにパラメータを付ける必要はありません。
- 次の 3 つのプロンプトに対して、Enter を押してデフォルトのオプションを受け入れます。
~/.ssh ディレクトリ内にある identity.pub または id_dsa.pub というファイル (SSH のバージョン 1 とバージョン 2 のどちらを使うかによって異なる) に公開鍵が格納されます。マシンに接続する際にパスワードの入力が求められないようにするには、このファイルの内容を、すべてのマシン上の authorized_keys2 というファイルに追加する必要があります。これは次のようにして行います。
- ログイン ID を設定するには、ユーザーディレクトリに移動します。
~/.ssh.
SSH1、OpenSSH/1 - identity.pub ファイルをコピーし、それに authorized_keys という名前を付けます。
OpenSSH/2 - id_dsa.pub ファイルをコピーし、それに authorized_keys という名前を付けます。
- .ssh ディレクトリと .ssh/authorized_keys ファイルに、グループとその他に対する書き込み権がないことを確認します。
必要に応じて、これらのグループやその他の書き込み権を、次のようにして無効にします。
chmod og-w ~/.ssh
chmod og-w ~/.ssh/authorized_keys
chmod og-w /$HOMEHOME を HADB ユーザーのホームディスクと置き換えます。次に例を示します。
chmod og-w ~/johnsmith.
- ユーザーが入力しなくてもログインできるようにするには、はじめて SSH を使用するときに (SSH 環境を設定したあと)、/.ssh ディレクトリの下の known_hosts ファイルに、ノードマシン名を追加する必要があります。
- SSH が正しく設定されたことを確認するには、HADB の管理ツールを実行する前に、クラスタ内の各ホストに SSH します。
パスワードの要求なしで自動ログインします。
ユーザー環境の設定ホスト通信を設定すると、次のようにして、hadbm コマンドを install_dir/SUNWhadb/4/bin ディレクトリから実行できます。
ただし、高可用性の管理クライアントのコマンドをどこからでも使用できるようにローカル環境を設定すると、より便利です。これを設定するには、次の手順を実行します。
- PATH 変数を次のように設定します。
setenv PATH ${PATH}:install_dir/bin:install_dir/SUNWhadb/4/bin
- 次のコマンドを実行して、PATH 設定が正しいことを確認します。
which asadmin
which hadbm- システムに Java の複数のバージョンがインストールされている場合は、JAVA_HOME 環境変数が正しい Java バージョン (Enterprise Edition の場合は 1.4.1_03) を指していることを必ず確認してください。
setenv JAVA_HOME java_install_dir
setenv PATH ${PATH}:${JAVA_HOME}/bin
root 以外の特権に対する管理の設定デフォルトでは、Sun ONE Application Server の初期インストールまたは設定時、Sun ONE Application Server 用に作成されたファイルとパスの書き込み権はルートのみに与えられます。ルート以外のユーザーが Sun ONE Application Server を作成したり管理したりする場合、関連するファイルの書き込み権を、その特定のユーザー、またはそのユーザーが属するグループに与える必要があります。影響を受けるファイルとそのデフォルトの場所は次のとおりです。
次の手順で説明するように、Sun ONE Application Server を管理するためのユーザーグループを作成できます。(もう 1 つの方法は、特定のユーザーにアクセス権と所有権を設定することです。)
Sun ONE Application Server のユーザーグループを作成し、インストールルートディレクトリのアクセス権を設定するには、影響を受けるファイルのそれぞれに対して次の手順を繰り返します。
- root としてログインします。
- コマンドプロンプトから、Sun ONE Application Server ユーザーグループを作成します。次に例を示します。
# groupadd s1asuser
コマンド行で groupadd と入力して、適切な使用法を表示します。
- 影響を受けるファイルのそれぞれのグループ所有権を、新たに作成したグループに変更します。次に例を示します。
chgrp -R s1asuser install_config_dir/cl*.conf
- 新しく作成したグループの書き込み権を設定します。
chmod -R g+rw install_config_dir/cl*.conf
- 影響を受けるファイルのそれぞれで、手順 3 と 4 を繰り返します。
- clsetup コマンドと cladmin コマンドを、新しく作成したグループで作成できるようにします。次に例を示します。
chmod -R g+x install_dir/bin/cl*
- --sysuser オプションを使って、デフォルトのドメインである domain 1 を削除してから再度作成します。sysuser も新たに作成したグループに属する必要があります。次に例を示します。
asadmin delete-domain domain1
asadmin create-domain --sysuser bleonard --adminport 4848 --adminuser admin --adminpassword password domain1
clsetup コマンドの使用clsetup コマンドの目的は、一般的な設定で基本クラスタを設定するプロセスを自動化することです。clsetup コマンドは install_dir/bin にあります。install_dir は、Sun ONE Application Server ソフトウェアがインストールされているディレクトリです。
clsetup コマンドは、cladmin コマンドと一緒に Sun ONE Application Server ソフトウェアにバンドルされています。
注
cladmin コマンドは、インストールと設定のすべてのタスクが完了したあとで、クラスタの設定と管理のプロセスを効率化するために使用します。ただし、ここでは説明しません。
『インストールガイド』で説明しているタスクが完了したら、HADB の作成と cladmin コマンドの使用の手順について、『Sun ONE Application Server 管理者ガイド』を参照してください。
この節では次の項目について説明します。
clsetup コマンドの動作
clsetup コマンドは、スクリプト内に集められた Sun ONE Application Server コマンドのセットです。スクリプトを使えば、事前に内容が設定されている入力ファイルに基づいて、自動的にクラスタを設定できます。HADB はクラスタの設定の一環として作成されますが、その場合でも、『Sun ONE Application Server 管理者ガイド』に記載されているように、hadbm コマンドを使って作業用クラスタを設定する必要があります。
注
clsetup コマンドインタフェースは不確定です。不確定なインタフェースは試験的または一時的なインタフェースであるため、次のリリースで互換性がなくなったり、削除されたり、または安定したインタフェースに置き換えられたりする場合があります。
この節では次の項目について説明します。
入力ファイルの機能
clsetup コマンドでは、次の 3 つの入力ファイルを使ってクラスタを設定します。
- clinstance.conf - このファイルは、アプリケーションサーバーインスタンスの server1 と server2 に関する情報が事前に設定されています。このファイルの内容の詳細については、「clinstance.conf ファイル」を参照してください。
- clpassword.conf - このファイルには、Sun ONE Application Server 7, Enterprise Edition ソフトウェアをインストールしたときに指定した、domain1 の Admin Server パスワードが事前に設定されています。このファイルの内容の詳細については、「clpassword.conf ファイル」を参照してください。
- clresource.conf - このファイルには、クラスタリソース (HADB、JDBC 接続プール、JDBC リソース、およびセッションストアと持続性) に関する情報が事前に設定されています。このファイルの内容の詳細については、「clresource.conf ファイル」を参照してください。
一般的なクラスタの設定をするようあらかじめ設定されている、clsetup 設定パラメータを使用できます。別の設定をサポートするには、設定ファイルの一部かすべてを編集することができます。
clsetup コマンドが実行する内容
clsetup 入力ファイルに事前に設定されている値を使って、clsetup コマンドは次のことを行います。
- domain1 というデフォルトのドメイン内に、server2 という新しいサーバーインスタンスを作成します。server2 の HTTP ポート番号は、インストール時に server1 に指定した HTTP ポート番号の次に続く番号です。たとえば、インストール時に server1 にポート番号 80 を指定すると、server2 のポート番号は 81 です。
- ローカルマシン上に 2 つのノードを持つ hadb という HADB を作成します。ポートベースは 15200 で、データベースパスワードは password です。
- HADB にセッション情報を格納するために必要な HADB 表を作成します。
- clinstance.conf ファイル (server1、server2) にリストされているすべてのインスタンスに、appservCPL という接続プールを作成します。
- clinstance.conf ファイル (server1、server2) にリストされているすべてのインスタンスに、jdbc/hastore という JDBC リソースを作成します。
- clinstance.conf ファイル (server1、server2) にリストされているすべてのインスタンスに、セッション持続性情報を設定します。
- clinstance.conf ファイル (server1、server2) にリストされているすべてのインスタンスで高可用性を有効にします。
clsetup コマンドで使用するコマンド
clsetup コマンドは、多数の hadbm コマンドと asadmin コマンドを使ってクラスタ設定手順を実行します。表 3-1 では、左側の列に clsetup のタスクを示し、右側の列にタスクの実施に使われるコマンドを示しています。
clsetup の要件と制限事項
clsetup コマンドには、次の要件と制限が適用されます。
- インストールパス、デバイスパス、設定パスなどは、クラスタを構成するすべてのマシン上で同じでなければなりません。
- clsetup コマンドを使用するには、asadmin コマンドと hadbm コマンドがローカルマシン上で使用可能であることが必要です。このため、このコマンドを実行できるのは、次のものがインストールされているマシン上のみです。
- clsetup コマンドを使用するには、「共有メモリーとセマフォの設定」の説明に従って、共有メモリーが設定されている必要があります。clsetup コマンドは共有メモリーの値を設定しません。
- clsetup コマンドを使用するには、「ホスト通信の設定」の説明に従って、SSH または RSH 用の HADB クラスタホスト通信が設定されている必要があります。
- RSH (デフォルトではない) を使用する場合は、clresource.conf ファイルの次の行のコメント指定を外す必要があります (# 記号を削除します)。
- SSH を使用する同じマシン上で Application Server と HADB を同じ場所に置く場合は、known_hosts ファイルが .ssh ディレクトリの下に存在しなければなりません。このファイルが存在しない場合は、clsetup コマンドを使用する前に、ssh localhost または ssh hostname コマンドのどちらかを実行します。
- clsetup コマンドを実行する前に、クラスタの一部である Sun ONE Application Server のすべてのインスタンスの管理サーバーを起動する必要があります。
- 管理者のパスワードは、クラスタの一部であるすべてのドメインのパスワードと同じである必要があります。
- 処理するエントリ (HADB ノードと Application Server インスタンス) がすでに存在する場合、clsetup コマンドはそれらを削除したり再設定したりしないで、各設定手順は省略されます。
- 入力ファイルに指定した値は、クラスタ内のすべてのインスタンスの値と同じになります。clsetup コマンドは、インスタンスを別の値で設定するようには設計されていません。たとえば、このコマンドでは、インスタンスごとに設定が異なる JDBC 接続プールは作成できません。
- clsetup コマンドでは、inetd は設定されません。HADB は inetd 設定なしで作成されます。inetd の設定手順については、『Sun ONE Application Server 管理者ガイド』を参照してください。
- シェル初期化ファイル内のホスト名 - .cshrc または .login ファイルにホスト名とともにプロンプトを組み込むと、clsetup コマンドが停止したように見えることがあります。プロンプトと、リモートコマンド起動の中の余分な出力を削除する必要があります。たとえば、hostB で hostname コマンドを実行したときに、プロンプトなしで hostB が印刷される必要があります。
- clsetup コマンドを root 以外のユーザーとして実行するには、「root 以外の特権に対する管理の設定」の説明に従って、変更を加える必要があります。
clsetup 入力ファイルの編集
clsetup コマンドに必要な入力ファイルは、インストール処理の中で設定インストールディレクトリ (デフォルトは /etc/opt/SUNWappserver7) の下にインストールされます。インストールプログラムでは一般的な設定を行うための値がこれらのファイルに事前に設定されますが、テキストエディタを使ってそれらの一部またはすべてを必要に応じて編集できます。
この節では次の項目について説明します。
clinstance.conf ファイル
clsetup コマンドを正しく動作させるため、クラスタの一部であるすべてのアプリケーションサーバーのインスタンスが clinstance.conf ファイルに定義されている必要があります。インストール時にインストールプログラムにより、2 つのインスタンス用のエントリを含む clinstance.conf ファイルが作成されます。クラスタにインスタンスを追加する場合は、そのインスタンスに関する情報を追加する必要があります。
clinstance.conf ファイルの形式は次のとおりです。
クラスタの一部であるインスタンスごとに 1 組のエントリが必要です。ハッシュマーク (#) で始まる行はコメントとして扱われます。
注
これらのエントリの clinstance.conf ファイルでの順序は重要であるため、ここで示す順序は変更しないでください。
その他のアプリケーションサーバーインスタンスに関する情報を追加する場合、これらのインスタンスのエントリはこの順序で表示される必要があります。
コメントはファイルの任意の場所に追加できます。
表 3-2 では、clinstance.conf ファイル内のエントリに関する情報を説明しています。左側の列にはパラメータ名、中央の列にはパラメータの定義、右側の列にはインストールプログラムにより指定されるデフォルト値を示しています。
clinstance.conf ファイルの例
この clinstance.conf ファイルには、2 つのインスタンスに関する情報が含まれています。
#Instance 1
instancename server1
user admin
host localhost
port 4848
domain domain1
instanceport 80#Instance 2
instancename server2
user admin
host localhost
port 4848
domain domain1
instanceport 81clpassword.conf ファイル
clsetup コマンドを実行するとき、asadmin コマンドには管理サーバーのパスワードが必要です。このパスワードは、インストール時に clpassword.conf ファイルに指定されます。
clpassword.conf ファイルの形式は次のとおりです。
password は管理サーバーのパスワードです。
アクセス権 0600 が clpassword.conf ファイルに事前設定されています。このファイルにアクセスできるのは root ユーザーのみです。
clresource.conf ファイル
インストール時にインストールプログラムにより、一般的な設定を行うための clresource.conf ファイルが作成されます。clresource.conf ファイルには、クラスタの一部である次のリソースに関する情報が含まれています。
アクセス権 0600 が clresource.conf ファイルに事前設定されています。これにアクセスできるのはルートユーザーのみです。
注
clsetup コマンドを実行する前に、最適化や別の設定のために、clresource.conf ファイルに指定した値を変更することができます。値を編集する場合は、ファイルの順序と形式を変更しないでください。
ハッシュマーク (#) で始まる行はコメントとして扱われます。
次の表では、clresource.conf ファイルのパラメータについて説明しています。左側の列にはパラメータ名、中央の列にはパラメータの定義、右側の列にはインストールプログラムにより指定されるデフォルト値を示しています。
表 3-3 では、clresource.conf ファイルの HADB パラメータについて説明しています。
表 3-4 では、clresource.conf ファイルのセッションストアパラメータについて説明しています。
表 3-4 clresource.conf ファイルのセッションストアパラメータ
パラメータ
定義
デフォルト値
storeurl
HADB ストアの URL
REPLACEURL
注 : 値は実行時の実際の URL と置き換えられます
storeuser
セッションストアへのアクセス権を持つユーザー
appservusr
注 : 表 3-5 の username プロパティと一致する必要があります
storepassword
storeuser のパスワード
password
注 : 表 3-5 の password プロパティと一致する必要があります
dbsystempassword
HADB システムユーザーのパスワード
password
表 3-5 では、clresource.conf ファイルの JDBC 接続プールパラメータについて説明しています。
表 3-6 では、clresource.conf ファイルの JDBC パラメータについて説明しています。
表 3-6 clresource.conf ファイルの JDBC リソースパラメータ
パラメータ
定義
デフォルト値
connectionpoolid
接続プールの名前
appservCPL
注 : 接続プール名は表 3-5 に指定されています。
表 3-7 では、clresource.conf ファイルのセッションの持続性パラメータについて説明しています。
表 3-7 clresource.conf ファイルのセッション持続性パラメータ
パラメータ
定義
デフォルト値
type
セッション持続性タイプ
ha
frequency
セッション頻度
web-method
scope
セッションの範囲
セッション
store
セッションストア
jdbc/hastore
注 : ストア名は、[JDBC_RESOURCE] セクションの末尾に定義されています
clresource.conf ファイルの例
[HADBINFO]
historypath /var/tmp
devicepath /opt/SUNWappserver7/SUNWhadb/4
datadevices 1
portbase 15200
spares 0
#set managementProtocol=rsh
inetd false
inetdsetupdir /tmp
devicesize 512
dbpassword password
hosts machine1,machine1
hadb[SESSION_STORE]
storeurl REPLACEURL
storeuser appservusr
storepassword password
dbsystempassword password[JDBC_CONNECTION_POOL]
steadypoolsize 8
maxpoolsize 32
datasourceclassname com.sun.hadb.jdbc.ds.HadbDataSource
isolationlevel repeatable-read
validationmethod meta-data
property username=appservusr:password=password:cacheDataBaseMetaData=false:e liminateRedundantEndTransaction=true:serverList=REPLACEURLappservCPL
[JDBC_RESOURCE]
connectionpoolid appservCPL
jdbc/hastore[SESSION_PERSISTENCE]
type ha
frequency web-method
scope session
store jdbc/hastoreclsetup コマンドの実行
clsetup コマンドの実行の構文は次のとおりです。
引数が指定されていない場合、clsetup コマンドは次のデフォルトを使用します。
カスタムの入力ファイルの場所を指定することで、これらの引数を無効にできます。次に例を示します。
./clsetup --resourcefile /tmp/myappservresource.conf
注
カスタムの入力ファイルを指定するときは、入力ファイルにある必須形式に従ってください。この手順については、「clsetup 入力ファイルの編集」を参照してください。
clsetup コマンドを実行するには、次の手順を実行します。
- 「clsetup の要件と制限事項」に記載されている要件が満たされていることを確認します。
注
clsetup コマンドを root 以外のユーザーとして実行する場合は、「root 以外の特権に対する管理の設定」の手順に従って設定してください。
- 入力ファイルにクラスタの設定に必要な情報があることを確認します。必要に応じて、「clsetup 入力ファイルの編集」のガイドラインに従って入力ファイルを編集します。
- RSH を使用する場合は、clresource.conf ファイルを編集して次の行のコメント指定を外します (# 記号を削除します)。
#set managementProtocol
- Sun ONE Application Server インストールディレクトリ下にある install_dir/bin ディレクトリに移動します。
cd install_dir/bin
- 適切な構文を使って clsetup コマンドを起動します。たとえば、デフォルトでコマンドを実行するには次のようにします。
./clsetup
clsetup コマンドにより、Welcome メッセージ、クラスタ設定の必要条件、および次のメッセージが表示されます。
Do you want to start configuring your cluster? [Yes/No]
- 設定を開始するには、Yes と入力して Enter を押します。
clsetup コマンドにより詳細モードで実行されます。さまざまなコマンドが実行中に画面に表示され、出力はログファイル /var/tmp/clsetup.log にリダイレクトされます。
非常に重要なエラー (たとえば、存在しない HADB の作成の失敗など) が発生すると、設定が停止してログファイルにエラーが記録されます。ログファイルがすでに存在している場合は、出力が既存のログファイルに追加されます。
注
処理するエントリ (HADB ノードと Application Server インスタンス) がすでに存在する場合、clsetup コマンドはそれらを削除したり再設定したりしないで、各設定手順は省略されます。この種のイベントは、ログファイルに記録されます。
- clsetup コマンドで設定が完了すると、ログファイルの場所を示すメッセージが表示されます。実行後に毎回ログファイルをスキャンすることをお勧めします。
- 完了すると、clsetup コマンドにより、表 3-8 に記載されている終了コードが返されます。
clsetup コマンドを実行した直後にコマンド行から次のコマンドを実行することによって、終了コードのリストを取得できます。
clsetup コマンドのクリーンナップ手順
clsetup コマンドを実行したあと、発生したエラーがログファイル /var/tmp/clsetup.log に記録されます。clsetup コマンドの実行後に毎回ログファイルを調べ、報告される重大なエラー (たとえば、存在しないインスタンスの作成に失敗) を修正してください。
設定のすべてまたは一部は、次のようにして元に戻すことができます。
この章のタスク（および必要に応じて次の章のインストール後のタスク）を終了したら、『Sun ONE Application Server 管理者ガイド』を参照して、HADB の設定とクラスタ、ロードバランサプラグイン、および HADB の管理の手順に進んでください。
