WebAdminを使用して、インスタンスを作成する方法について説明します。
インストール時に、WebAdminのセットアップを行っていない場合には、“E.1 WebAdminセットアップ”を参照してセットアップを行ってください。
ブラウザには、Windows(R)のInternet Explorer 8.0、9.0、10.0、11.0 を使用し、Cookiesを受け入れ、Symfoware Serverがインストールされたサーバからのポップアップ要求を許可してください。
ポップアップ要求の設定変更の方法と、その他の推奨設定は、“付録D WebAdminの推奨環境”を参照してください。
注意
Windows(R)のセーフモードでは動作しません。
同一のインスタンスに対して複数のWebAdminの画面から操作すると正しく動作しません。
ブラウザの[前のページに戻る]機能を使用した場合には正しく動作しません。使用してしまった場合には、ブラウザを閉じて再度ログインしなおしてください。
一定時間（約15分）ブラウザを操作しなかった場合には、次の操作でログイン画面に戻ります。ただし、[監視]メニュー画面を表示している場合には、このような動作はしません。
WebAdminへのログイン方法を説明します。
ブラウザのURLにWebAdmin画面の起動URLを、以下の形式で指定します。
http://ホスト名またはIPアドレス:ポート番号/
ホスト名またはIPアドレス：Symfoware Serverをインストールしたサーバのホスト名またはIPアドレス
ポート番号：WebAdminのポート番号。デフォルトのポート番号は26515です。
以下の起動画面が表示されます。
起動画面の“Symfoware WebAdmin”をクリックすると、WebAdminの[ログイン]画面が表示されます。インスタンス管理のユーザ名（OSのユーザーアカウント名）とパスワードを入力してSymfoware Serverにログインしてください。
インスタンスの作成方法について説明します。
参考
WebAdminは、“PostgreSQL文書”の“サーバの管理”の“カーネルリソースの管理”で示される計算式を使って算出した値を、カーネルパラメータに設定します。設定するパラメータ名などは“付録L カーネルパラメータの設定”を参照してください。
設定値を導出するために必要なpostgresql.confの設定値は、“付録F 設定パラメータ”を参照してください。
WebAdminを起動し、データベースサーバにログインします。
[監視]メニューの[インスタンス一覧]画面にある[新規作成]ボタンをクリックします。
作成するインスタンスの情報を入力します。
以下の項目を入力してください。
「インスタンス名」: 管理するデータベースインスタンスの名前
インスタンス名の命名規約は以下です。
16バイト以内
先頭の文字は、ASCIIアルファベット
先頭以外の文字は、ASCIIアルファベット、ASCII数字
「データ格納先」: データベースのデータを格納するディレクトリ
「バックアップデータ格納先」: データベースのバックアップを格納するディレクトリ
「ポート番号」:データベースサーバのポート番号
注意
データ格納先、バックアップデータの格納先、および、トランザクションログ格納先は、“4.2.2 資源配置用のディレクトリの準備”の“資源の配置の考え方”を参照して、慎重に決定してください。
ポート番号以外は、インスタンス作成後に変更することができません。
データ格納先、バックアップデータ格納先には、シンボリックリンクファイル、および、マルチバイト文字を含むディレクトリを指定しないでください。
トランザクションログ格納先およびデータベースエンコードを変更する場合は[高度な設定]をクリックします。
以下の項目を入力してください。
「トランザクションログ格納先」: トランザクションログを格納するディレクトリ
「エンコード」: データベースの符号化方式
注意
トランザクションログ格納先は、“4.2.2 資源配置用のディレクトリの準備”の“資源の配置の考え方”を参照して、慎重に決定してください。
トランザクションログ格納先には、シンボリックリンクファイル、および、マルチバイト文字を含むディレクトリを指定しないでください。
WebAdminで作成したインスタンスでは、データベースで使用する文字セットと照合順序のロケールはCで固定されます。
[作成]ボタンをクリックしてインスタンスの作成を行います。
インスタンスの作成が完了すると以下の画面が表示されます。
インスタンスの作成が成功するとインスタンスが起動されます。
設定した基本情報のバックアップ
以下のファイルのバックアップを取得してください。本画面で指定した基本情報が記録されており、システムディスクが故障したときに、WebAdminの管理情報をリカバリするときに必要です。
インストールディレクトリ/gui/data/gui-instances
インスタンス作成時に設定される以下の情報を変更することができます。
文字コードや最大接続数など、Symfoware Serverの動作・運用環境に合わせて変更してください。
参考
これらの設定は以下のファイルで設定可能なパラメータと同じです。項目名とパラメータの対応関係は、“付録F 設定パラメータ”を参照してください。
postgresql.conf
pg_hba.conf
注意
以下のファイルを直接変更することもできますが、“付録F 設定パラメータ”に記載されていないパラメータを誤って編集した場合には、WebAdminが正しく動作しない場合があります。
postgresql.conf
pg_hba.conf
WebAdminを起動し、データベースサーバにログインします。
[設定]メニューから、[文字コード]を選択します。
[編集]ボタンをクリックします。
“文字コードの変換”と“メッセージロケール”を修正し、[変更]ボタンをクリックします。
参照
クライアント側の符号化方式には、データベースの符号化方式との間で変換可能な符号化方式を選択してください。変換可能な組み合わせは、“PostgreSQL文書”の“サーバの管理”の“サーバ・クライアント間の自動文字セット変換”を参照してください。
WebAdminを起動し、データベースサーバにログインします。
[設定]メニューから、[クライアント認証]を選択します。
新たに認証情報を登録する場合は、[追加]ボタンをクリックします。
すでに設定済みの認証情報を変更する場合は、該当する情報をチェックして[編集]ボタンをクリックします。
すでに設定済みの認証情報を削除する場合は、該当する情報をチェックして[削除]ボタンをクリックします。
注意
インスタンス作成時に生成されている以下のエントリーは削除しないでください。WebAdminがデータベースの動作状況を監視するために必要としている接続です。
接続形式=local, データベース=all、ユーザー=all、かつ認証方式=md5
[追加]ボタンをクリックすると、以下の画面が表示されます。
WebAdminを起動し、データベースサーバにログインします。
インスタンスを停止します。
[設定]メニューから、[通信]を選択します。
[編集]ボタンをクリックします。
“ポート番号”、“最大接続数”を修正し[変更]ボタンをクリックします。
注意
最大接続数は、以下の計算式で算出してください。
最大接続数 = アプリケーションからの最大接続数 + 3 (注)
注) “3”は、システムが必要とする接続数です。デフォルトは 3 です。
postgresql.confのmax_wal_senders(ストリーミングレプリケーションを使用している)、または、superuser_reserved_connections(スーパユーザーによる接続のために予約されている接続数)を変更している場合は、以下の計算式で最大接続数を算出してください。
最大接続数 = アプリケーションからの最大接続数＋superuser_reserved_connections＋max_wal_senders
postgresql.confについては、“付録F 設定パラメータ”を参照してください。
メモリ使用量が搭載メモリを超えていないか確認してください。確認方法は、“WebAdminがメモリ量に応じて自動的に設定しているパラメータ”を参照してください。
最大接続数を増やした場合には、カーネルパラメータを編集してください。詳細は、“付録L カーネルパラメータの設定”および“PostgreSQL文書”の“サーバの管理”の“カーネルリソースの管理”を参照してください。
WebAdminを起動し、データベースサーバにログインします。
[設定]メニューから、[SQLオプション]を選択します。
[編集]ボタンをクリックします。
“expr = NULL形式の解釈”、“DATE型の出力形式”、“INTERVAL型の出力形式”、“浮動小数点値の検索結果の精度”、“トランザクションのISOLATIONレベル”、“通貨の表現形式”、“日時の表現形式”、“数値の表現形式”を修正し、[変更]ボタンをクリックします。
注意
“DATE型の出力形式”で“postgres”を選んだ場合、PostgreSQL文書に記載してある“Wed Dec 17 1997”という形式ではなく、“12-17-1997”という形式で出力されます。
WebAdminを起動し、データベースサーバにログインします。
インスタンスを停止します。
[設定]メニューから、[使用メモリ]を選択します。
[編集]ボタンをクリックします。
“ソート処理に使用するメモリ量(単位:KB)”、“データベースのバッファサイズ(単位:KB)”を修正し[変更]ボタンをクリックします。
注意
メモリ使用量が搭載メモリを超えていないか確認してください。確認方法は、“WebAdminがメモリ量に応じて自動的に設定しているパラメータ”を参照してください。
データベースのバッファサイズを変更した場合には、カーネルパラメータを編集してください。詳細は、“付録L カーネルパラメータの設定”および“PostgreSQL文書”の“サーバの管理”の“カーネルリソースの管理”を参照してください。
