Sv translation |
---|
|
Section |
---|
Column |
---|
Preface Info |
---|
| These instructions will help you connect the BellaDati application to a PostgreSQL | 8.4+ database. |
1. Before You BeginAre You Migrating BellaDati to Another Server?If you are migrating BellaDati to another server, create an export of your data as an XML backup. You will then be able to transfer data from your old database to your new databasedatabase. We recommend using database engine PostgreSQL 12. This database engine is supported now.
PostgreSQL 12 is supported starting from BellaDati 2.10 release. |
|
|
|
...
Create and Configure the PostgreSQL Database Warning |
---|
title | Setup the pg_hba.conf file to allow accessing the database via TCP socket. Here is an example: |
---|
|
Code Block |
---|
host belladati_db belladati_dbuser 0.0.0.0/0 md5 |
|
Create a database user which BellaDati will connect as (e.g. belladati_dbuser ).
|
...
Remember this database user name, as it will be used to configure BellaDati's connection to this database in subsequent steps. Do not forget to configure the pg_hba.conf file, which controls the database access.
|
...
...
Create a database for BellaDati to be used as data warehouse (e.g. belladati_db ) with Unicode collation. Code Block |
---|
CREATE DATABASE belladati_db WITH ENCODING 'UNICODE' TEMPLATE template0; |
Or from the command-line: Code Block |
---|
$ createdb -E UNICODE -O belladati_dbuser belladati_db -T template0 |
- Ensure that the user has permissions to connect to the database, and to create and write to tables in the database.
Warning |
---|
title | Step 4 can be skipped for PostgreSQL 10 and above |
---|
| Check if your database has the plpgsql language |
|
...
. If not, you can define it using |
|
...
command below(template0 has plpgsql installed so belladati_db database inherits it: Code Block |
---|
CREATE LANGUAGE plpgsql |
Or from the command |
|
...
line (this option is no longer available since PostgreSQL 10. Use command above): Code Block |
---|
$ createlang -U belladati_dbuser plpgsql belladati_db |
Note |
---|
When using the default PostgreSQL configuration file pg_hba.conf , you have to execute this command by connecting via TCP socket:
createlang -h 127.0.0.1 -U belladati_dbuser plpgsql belladati_db |
|
this , as ; it will be used to configure BellaDati's connection to | this subsequent steps. |
3. Copy the PostgreSQL JDBC Driver to Your Application Server (BellaDati WAR Only)
Skip this step if you are using BellaDati virtual applicance distribution. BellaDati virtual appliance includes the PostgreSQL JDBC driver.
- Download the PostgreSQL JDBC driver from http://jdbc.postgresql.org/download.html. (Obtain version 9.0 of the JDBC 4 driver.)
- Add the PostgreSQL JDBC driver jar to the
lib/
directory of your application server.
4. Next steps
Continue configuring BellaDati WAR for your application server as described on:
...
the applications server configuration. |
PostgreSQL configurationWe strongly recommend performing the following PostgreSQL configuration changes in $POSTGRES_HOME/data/postgresql.conf . This example specifies parameters when you run the BellaDati application and database on a single server with 4GB memory. 2GB are allocated for the BellaDati application server running on Java (using the -Xmx parameter). The rest should be available for the operating system and database server. Warning |
---|
This configuration may change according to real usage needs. Example below shows the minimal configuration for single server installation. |
Name | Value | Description | Note |
---|
max_connections | 50 | Sets the maximum number of concurrent connections. |
| shared_buffers | 512MB | Sets the number of shared memory buffers used by the server. | min 1/4 RAM, 1/2 RAM recommended | temp_buffers | 2MB | Sets the maximum number of temporary buffers used by each session. | per session | work_mem | 16MB | Sets the maximum memory to be used for query workspaces. | min 16MB, RAM / 128 recommended | maintenance_work_mem | 64MB | Sets the maximum memory to be used for maintenance operations. | min 64MB, RAM / 32 recommeneded | max_stack_depth | 2MB | Sets the maximum stack depth, in kilobytes. |
| wal_buffers | 512kB | Sets the number of disk-page buffers in shared memory for WAL. |
| effective_cache_size | 1024MB | Sets the planner's assumption about the size of the disk cache. | RAM / 2 recommended | log_statement | none | Sets the type of statements logged. |
| autovacuum | on | Starts the autovacuum subprocess. |
| autovacuum_analyze_scale_factor | 0.05 | Number of tuple inserts, updates, or deletes prior to analyze as a fraction of reltuples. |
| autovacuum_analyze_threshold | 10 | Minimum number of tuple inserts, updates, or deletes prior to analyze. |
| autovacuum_freeze_max_age | 200000000 | Age at which to autovacuum a table to prevent transaction ID wraparound. |
| autovacuum_max_workers | 5 | Sets the maximum number of simultaneously running autovacuum worker processes. |
| autovacuum_multixact_freeze_max_age | 400000000 | Multixact age at which to autovacuum a table to prevent multixact wraparound. |
| autovacuum_naptime | 15s | Time to sleep between autovacuum runs. |
| autovacuum_vacuum_cost_delay | 10ms | Vacuum cost delay in milliseconds, for autovacuum. |
| autovacuum_vacuum_cost_limit | 1000 | Vacuum cost amount available before napping, for autovacuum. |
| autovacuum_vacuum_scale_factor | 0.1 | Number of tuple updates or deletes prior to vacuum as a fraction of reltuples. |
| autovacuum_vacuum_threshold | 25 | Minimum number of tuple updates or deletes prior to vacuum. |
|
Info |
---|
We recommend set the archive_mode parameter to off , using the pg_dump command instead. |
Backup and restoreYou can backup the BellaDati database using the PostgreSQL dump command: Code Block |
---|
pg_dump -U user -F c -v -f "path_to_dump/dump.backup" belladati_db
|
To restore a backup, use the pg_restore command: Code Block |
---|
pg_restore -v -c -O -d belladati_db -U user path_to_dump/dump.backup
|
Next stepsInstalling BellaDati on Linux - continue Installing BellaDati on Linux HIDDEN OLD, step "check that default ports"
Installing BellaDati WAR continue installing the BellaDati.war application on your application server as described in:
|
Sv translation |
---|
|
Section |
---|
Column |
---|
Info |
---|
BellaDatiアプリケーションとPostgreSQLデータベースを接続するための手順を説明します。 データベースエンジンPostgreSQL 12の使用を推奨します。このデータベースエンジンは現在サポートされています。 PostgreSQL 12は、BellaDati 2.10リリースからサポートされています。 |
|
|
PostgreSQLのデータベース作成と設定 Warning |
---|
title | TCPソケットでデータベースにアクセスできるようにpg_hba.confファイルを設定します。以下はその例です。 |
---|
|
Code Block |
---|
host belladati_db belladati_dbuser 0.0.0.0/0 md5 |
|
BellaDatiが接続するデータベースユーザー(例:belladati_dbuser)を作成します。このデータベースユーザー名は、以降のステップでBellaDatiのこのデータベースへの接続を設定するために使用されますので、覚えておいてください。データベースへのアクセスを制御するpg_hba.confファイルの設定も忘れずに行ってください。 Code Block |
---|
$ createuser -SDRP belladati_dbuser |
Unicode照合順序で(例えばbelladati_db)データ・ウェアハウスとしてBellaDatiが使用するためのデータベースを作成します。 Code Block |
---|
CREATE DATABASE belladati_db WITH ENCODING 'UNICODE' TEMPLATE template0; |
または以下のコマンドライン: Code Block |
---|
$ createdb -E UNICODE -O belladati_dbuser belladati_db -T template0 |
- ユーザーがデータベースに接続する権限を持って、データベース内のテーブルに作成する及び書き込めることを確認してください
Warning |
---|
PostgreSQL 10 以降では、ステップ 4 は省略可能です。 |
データベースがplpgsql言語を持っているかどうかを確認してください。ない場合は、このコマンドを使用して定義できます。 Code Block |
---|
CREATE LANGUAGE plpgsql |
または以下にコマンド行から Code Block |
---|
$ createlang -U belladati_dbuser plpgsql belladati_db |
Note |
---|
pg_hba.confファイル構成のPostgreSQLデフォルトを使用するときは、TCPソケット経由で接続することによりこのコマンドを実行する必要があります。
createlang -h 127.0.0.1 -U belladati_dbuser plpgsql belladati_db |
Info |
---|
データベース名を覚えておいてください。以降のデータベースへのBellaDatiの接続を設定するために使用されます。 |
PostgreSQL構成私たちは次のように$POSTGRES_HOME/data/postgresql.confにPostgreSQL構成の変更を行うことを強くお勧めします。この例では、4GBのメモリを備えた単一のサーバー上でBellaDatiアプリケーションとデータベースを実行する時にパラメータを指定します。 2GB以上(-Xmxパラメータを使用)は、Java上で動作しているBellaDatiアプリケーション・サーバー用に指定します。残りは、オペレーティングシステム及びデータベース・サーバに利用可能であるべきです。 Warning |
---|
この構成は、実際の使用状況のニーズに応じて変更されることがあります。 次の例では、単一サーバーインストールの最小限の構成を示します。 |
名前 | 値 | 説明 | 備考 |
---|
max_connections | 50 | 同時接続の最大数を設定すること |
| shared_buffers | 512MB | サーバにより使用した共有メモリバッファの数を設定すること | min 1/4 RAM, 1/2 RAM recommended | temp_buffers | 2MB | 各セッションが使用した一時バッファの最大数を設定すること。 | セッションごと | work_mem | 16MB | クエリーワークスペースのために使用される最大メモリを設定すること。 | 16MB以上、RAM128推奨 | maintenance_work_mem | 64MB | 保守作業のために使用される最大メモリを設定すること。 | 64MB以上、RAM32以上推奨 | max_stack_depth | 2MB | 単位の最大スタックの深さを設定すること。 |
| wal_buffers | 512kB | WAL向けの共有したメモリにディスクページバッファの数を設定すること。 |
| effective_cache_size | 1024MB | ディスクキャッシュのサイズに関するプランナの推測を設定すること。 | RAM / 2を推奨 | log_statement | none | ログしたステートメントタイプを設定すること。 |
| autovacuum | on | 自動バキュームサブプロセスを起動すること。 |
| autovacuum_analyze_scale_factor | 0.05 | タプル挿入、更新数、またはreltuplesの一部として分析する前に削除すること。 |
| autovacuum_analyze_threshold | 10 | タプル挿入、更新の最小数、または分析の前に削除される事。 |
| autovacuum_freeze_max_age | 200000000 | トランザクションIDの周回を防ぐためにテーブルを自動バキュームする年齢です。 |
| autovacuum_max_workers | 5 | 同時に実行されている自動バキュームワーカー・プロセスの最大数を設定すること。 |
| autovacuum_multixact_freeze_max_age | 400000000 | 周回を防ぐためにテーブルを自動バキュームするMultixact 年齢です。 |
| autovacuum_naptime | 15s | 自動バキューム実行の間にスリープ時間です |
| autovacuum_vacuum_cost_delay | 10ms | 自動バキューム用ミリ秒に延長バキュームコストです。 |
| autovacuum_vacuum_cost_limit | 1000 | 自動バキュームのため、昼寝前に使用可能なバキュームコストです |
| autovacuum_vacuum_scale_factor | 0.1 | reltuplesの一部として真空の前に削除するまたはタプル更新数です。 |
| autovacuum_vacuum_threshold | 25 | 真空の前に削除するまたはタプル更新の最小回数 |
|
Info |
---|
代わりのpg_dumpコマンドを使用して、archive_modeパラメータをオフに設定することをお勧めします。 |
バックアップと復元PostgreSQLのダンプ・コマンドを使用することでBellaDatiデータベースをバックアップできます: Code Block |
---|
pg_dump -U user -F c -v -f "path_to_dump/dump.backup" belladati_db
|
バックアップを復元するには、pg_restoreのコマンドを使用します Code Block |
---|
pg_restore -v -c -O -d belladati_db -U user path_to_dump/dump.backup
|
次のステップInstalling BellaDati on Linux - continue Installing BellaDati on Linux, step "check that default ports" Installing BellaDati WAR 以下の説明したように、アプリケーションサーバー上でBellaDati WARの設定を続行します。 |
...