寺田　佳央 – Yoshio Terada

GlassFish ドメイン管理サーバのバックアップとリストア

※ GlassFish のドメイン管理サーバのバックアップとリストアは
管理コンソールからは行えません．コマンドを使用してください．

ドメイン管理サーバが稼働するサーバが何らかの障害により起動できなくなった場合，ドメインの管理ができなくなります．ドメイン管理サーバが稼働していない状態でもサーバインスタンスを稼働させることはできますが，ドメイン管理サーバが壊れている状態ではアプリケーションの更新やリソースの設定変更等ができなくなります．このような場合、ドメイン管理サーバの設定をバックアップしておくことで，他のサーバをドメイン管理サーバの代替えとして利用することができます．バックアップはドメイン管理サーバ上で何らかの設定変更を行った際，その都度取得しておくことを推奨します．

バックアップを取得する前に，ドメイン管理サーバを停止してください．ドメイン管理サーバを停止しても提供しているサービスに影響は及びませんのでこの作業は本番稼働中に行っても問題ありません．

次にドメイン管理サーバのバックアップを行います．–domaindirには対象のドメインが含まれるディレクトリを指定します．

バックアップコマンドを実行すると，sjsas_backup_vXXXXX.zipと名付けられたバックアップファイルが作成されます．このファイルをドメイン管理サーバのバックアップ用のサーバにFTP等を利用してコピーしておきます．ここではドメイン管理サーバのバックアップ用のサーバとしてnodeagent1を使用します．本番環境ではノードエージェントとは別のマシン上に構築することを推奨します．

展開したファイル中よりドメイン管理サーバ名が記載されている箇所を手動で編集します．domains/clusterDomain/config /domain.xml中より修正する必要のある該当箇所を表示し，dashostからnodeagent1に変更します．

新しい環境上で再度環境変数を設定した後，ドメインを起動します．

上記で，ドメインのリストアは完了です．仮にドメイン管理サーバにアクセスするためにSSLを有効にしている場合にドメイン管理サーバのホスト名が変わる場合，サーバ証明書の更新も必要です．デフォルトでインストールされている自己署名サーバ証明書は変更前のドメイン管理サーバ名が記載されていますので更新の必要があります．
最後に，念のためノードエージェントが保持するドメイン管理サーバへの参照情報が更新されているか確認してください．全てのノードエージェントはagentディレクトリ中にconfigディレクトリが存在しています．このディレクトリ配下にdas.propertiesファイルが存在しており，ドメイン管理サーバへ接続するための接続情報などが記載されています．そこでファイルの内容を確認しdashostからnodeagent1に変更されていることを確認してください．仮に変更されていない場合は手動で変更してください．

2010年2月5日 at 4:35 午後

GlassFish クラスタとクラスタインスタンス管理(作成、削除、起動、停止)

ここでは管理ツールを使用しクラスタの管理を行う方法について紹介します．

クラスタの作成

クラスタ構成を作成するためにはcreate-clusterコマンドを使用します．コマンド引数にクラスタ名を指定してクラスタを作成します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペインの「新規…」ボタンを押すことによって作成することができます．

クラスタの作成

クラスタサーバインスタンスの作成

クラスタに所属するサーバインスタンスを作成するためには，create-instanceコマンドを実行します．コマンド引数にインスタンスを配置するノードエージェント名とクラスタ名を指定してインスタンスを作成します．

また，クラスタに所属するサーバインスタンスは「クラスタ」作成のウィザードから「作成するサーバインスタンス(2)」のテーブルから，「新規…」ボタンを押すことによって作成することができます．この時ノードエージェントの選択コンボボックスからサーバインスタンスが稼働するノードエージェントを選択します．

クラスタインスタンスの作成

クラスタの一覧表示

ドメイン内に存在するクラスタの一覧を表示するためにはlist-clustersコマンドを使用します．またコマンドを実行すると一覧表示の他クラスタの稼働状態も表示します．

また，管理コンソールから左ペインの「クラスタ」を選択して確認できます．

クラスタの一覧表示

クラスタの起動

クラスタの起動はstart-clusterコマンドを使用します．コマンド引数にクラスタ名を指定して起動します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペイン中より対象のクラスタにチェックを付け「クラスタの起動」ボタンを押すことによって作成することができます．

クラスタの起動

クラスタの停止

クラスタの停止はstop-clusterコマンドを実行します．コマンド引数にクラスタ名を指定して停止します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペイン中より対象のクラスタにチェックを付け「クラスタの停止」ボタンを押すことによってクラスタを停止することができます．

クラスタの停止

クラスタの削除

クラスタを削除するためには，クラスタに所属している全てのインスタンスを停止/削除した後に削除を行います．
まず，クラスタの一覧とクラスタに所属するインスタンスを表示します．

次に，cluster1に属するinstance1,instance2を削除します．

最後にcluster1を削除します．

また，管理コンソールから左ペインの「クラスタ」を選択し右ペイン中より対象のクラスタにチェックを付け「削除」ボタンを押すことによってクラスタを削除することができます．管理コンソールから削除を実行すると，クラスタ内に属する全てのインスタンスも同時に削除する事ができます．

クラスタの削除

2010年2月5日 at 3:31 午後

GlassFish スタンドアローンインスタンス管理(作成、削除、起動、停止)

スタンドアローンサーバインスタンスの作成

スタンドアローンサーバインスタンスを追加するためにはcreate-instanceコマンドを実行します．サーバインスタンスが稼働するノードエージェント名を指定して作成します．複数のインスタンスを作成する際は，必ずノードエージェントの指定が必要です．そこで，開発者プロファイルを利用している場合，もしくはノードエージェントを作成していない場合は，新たにサーバインスタンスを作成することができませんので，ご注意ください．

上記のようにサーバインスタンスで使用する各種ポート番号を明示的に指定せずにサーバインスタンスを作成する場合は，極力既存の全てのサーバインスタンスを起動している状態で作成作業を行ってください．ポート番号を指定せずに実行した場合，コマンド内部で自動的に未使用のポート番号を探し出して新規インスタンス用に割り当てます．他のサーバインスタンスが停止している状態でコマンドを実行した場合，他で使用しているポート番号と競合する可能性があり，正常にサーバインスタンスが起動できない場合があります．作成するインスタンスで使用する各種ポート番号を指定したい場合は，下記のように–systempropertiesを付加して各種ポート番号を指定する事もできます．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「新規…」ボタンを押すことによって新規インスタンスを追加することができます．

新規スタンドアローンインスタンスの追加

サーバインスタンスの一覧表示

サーバインスタンスの一覧を確認するためにはlist-instancesコマンドを使用します．コマンドを実行すると一覧表示の他インスタンスの稼働状態も表示します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択して確認できます．

インスタンスの一覧表示

サーバインスタンスの起動

サーバインスタンスの起動はstart-instanceコマンドを使用します．実行時にインスタンス名を指定して起動します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「起動」ボタンを押すことによってインスタンスを起動することができます．

サーバインスタンスの起動

もしくは，管理コンソールから左ペインから対象の「スタンドアロンインスタンス」を選択し右ペインの「インスタンスの起動」ボタンを押すことによってインスタンスを起動することができます．

サーバインスタンスの起動

サーバインスタンスの停止

サーバインスタンスの停止はstop-instanceコマンドを実行します．コマンド引数にインスタンス名を指定して停止します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「停止」ボタンを押すことによってインスタンスを停止することができます．

サーバインスタンスの停止

もしくは，直接左ペインから対象の「スタンドアロンインスタンス」を選択して右ペインの「インスタンスの停止」ボタンを押すことによってインスタンスを停止することができます．

サーバインスタンスの停止

サーバインスタンスの削除

インスタンスの削除はdelete-instanceコマンドを実行します．コマンド引数にインスタンス名を指定して削除します．

また，管理コンソールから左ペインの「スタンドアロンインスタンス」を選択し右ペインの「削除」ボタンを押すことによってインスタンスを削除することができます．

サーバインスタンスの削除

2010年2月5日 at 2:40 午後

GlassFish ノードエージェント管理(作成、削除、起動、停止、ログ設定)

ノードエージェントの作成

ノードエージェントを作成するためには，ドメイン管理サーバ上で create-node-agent-config コマンドを実行しノードエージェント(参照情報のみ)を作成します．下記の例では2つのノードエージェントを作成しています．

次にノードエージェントを稼働させるマシン上でそれぞれ create-node-agent コマンドを実行します．この時ドメイン管理サーバ上で指定したノードエージェント名と同一のエージェント名を指定する必要があります．

便宜上ノードエージェントを稼働させるマシン上で create-node-agent コマンドを実行すると，「参照情報」と，「ノードエージェントの実体」の両方が同時に生成されます．しかし内部的には参照情報の設定とノードエージェントの実体は別々に作成されていることに注意してください．
このように，参照情報とノードエージェントの作成が別々に行われる理由は，ノードエージェントをオフラインで管理ができるようにするためです．例えば，実体であるノードエージェントが停止状態でも，ドメイン管理サーバ上で管理しているノードエージェントの参照情報に対してインスタンスを追加することができます．そしてノードエージェントの実体を起動した時にドメイン管理サーバで保持するノードエージェントの参照（設定）情報と同期をとりインスタンスの実体が生成されます．
管理コンソールからは，ドメイン管理サーバで管理する参照情報のみ作成することができます．参照情報を作成した後，別途ノードエージェントが稼働するマシン上でノードエージェントの実体を作成してください．
管理コンソールの左ペインから「ノードエージェント」を選択し、右ペインより「新規…」ボタンを押すことによってノードエージェントの参照情報を作成することができます．

ノードエージェントの参照情報の作成

ノードエージェントの一覧表示

ノードエージェントの一覧を確認するためにはlist-node-agentsコマンドを使用します．コマンドを実行すると一覧表示の他ノードエージェントの稼働状態も表示します．

また，管理コンソールからは，左ペインの「ノードエージェント」を選択して確認できます．

ノードエージェントの一覧表示

ノードエージェントの起動

ノードエージェントを起動するためには，ノードエージェントが稼働するマシン上で start-node-agent コマンドを実行します．

ノードエージェントの停止

ノードエージェントを停止するためには，ノードエージェントが稼働するマシン上で stop-node-agent コマンドを実行します．

ノードエージェントのログ設定

ノードエージェントのログに関する設定を行う前に，現在設定されているログの設定情報を get コマンドを実行して確認します．

ここで例えば、set コマンドを実行しログローテーションのファイルサイズを 500Kb から 1Mb に変更してみます。
下記を実行してください．

上記の設定内容を確認するため get コマンドを実行します．

また，ノードエージェントに関する各種設定は，管理コンソールからも行えます．

ノードエージェントの各種設定

ノードエージェントの削除

ノードエージェントを削除する前に，ノードエージェント上で稼働している全てのインスタンス，全てのアプリケーションを停止していることを確認してください．ノードエージェント上にリソースが残っている場合，ノードエージェントの削除に失敗します．
全てのリソースを削除した後に，ノードエージェントが稼働するマシン上で delete-node-agent コマンドを実行し実体を削除します．下記のコマンドを実行するとファイルやディレクトリを全て削除します．

次に、delete-node-agent-configコマンドを実行し，ドメイン管理サーバ上で保持するノードエージェントの参照情報を削除します．

ノードエージェントの参照情報は管理コンソールからも削除できます．管理コンソールの左ペインから「ノードエージェント」を選択し，右ペインより削除対象のノードエージェントにチェックを付け，削除ボタンを押す事により削除できます．

ノードエージェントの参照情報の削除

2010年2月5日 at 1:35 午後