PostgreSQL-Datenbankinstallation
PostgreSQL-Datenbank vorbereiten
Codebeamer unterstützt PostgreSQL und erfordert für einige optionale und leistungsverbessernde Funktionen die contrib-Erweiterungen. In einigen Fällen müssen diese separat installiert werden, beispielsweise für einige Linux Verteilungen wie CentOS. Weitere Informationen finden Sie in den versionsspezifischen Anforderungen für Codebeamer.
 |
Seit Codebeamer Version 2.1 ist die integrierte PostgreSQL-Datenbank-Setup-Option nicht mehr im Codebeamer Installationsassistenten verfügbar.
Bevor Sie eine Aktion ausführen, wird empfohlen, die vorhandene Datenbank zu sichern. Stellen Sie außerdem sicher, dass die Datenbank während der Migration nicht verwendet wird, da dies zu Datenverlust führen kann.
|
Windows, Unix
Weitere Informationen zum Herunterladen und Installieren der PostgreSQL-Datenbank finden Sie im Thema PostgreSQL.
Linux
Installieren Sie PostgreSQL über den Paketmanager Ihrer Verteilung. Bei einigen Verteilungen befinden sich die zusätzlichen contrib-Erweiterungen in einem separaten Paket. Es wird empfohlen, auch dieses Paket zu installieren, um einige optionale Funktionen und Funktionen zur Leistungsverbesserung zu aktivieren.
 |
PTC empfiehlt, die gleiche Version zu verwenden, mit der Codebeamer getestet wurde. Diese Version finden Sie in den Release Notes der aktuellen Version.
|
PostgreSQL-Konfiguration
Wenn Sie PostgreSQL installieren, müssen Sie ein robustes Stamm-Passwort festlegen und sich dieses merken.
Stellen Sie sicher, dass die folgenden Einstellungen in Ihrer Datenbank konfiguriert sind. Sie finden diese Einstellungen in der Datei postgresql.conf, die sich in der Regel im PostgreSQL-Datenverzeichnis befindet. Beispiel: in Windows unter C:\Program Files\PostgreSQL\<PostgreSQL_version>\data\postgresql.conf oder in Linux/Unix unter /var/lib/postgresql/data/postgresql.conf oder (/etc/postgresql/<PostgreSQL_version>/main/postgresql.conf).
effective_io_concurrency = 200
jit = off
max_locks_per_transaction = 5000
random_page_cost = 1.1
temp_buffers = 64MB
work_mem = 80000
default_statistics_target = 1000
checkpoint_timeout = 2700
jit = off
max_locks_per_transaction = 5000
random_page_cost = 1.1
temp_buffers = 64MB
work_mem = 80000
default_statistics_target = 1000
checkpoint_timeout = 2700
Weitere Informationen finden Sie unter https://pgtune.leopard.in.ua.
Datenbank erstellen
In diesem Schritt gehen wir davon aus, dass PostgreSQL auf dem standardmäßigen Port 5432 ausgeführt wird.
Damit Codebeamer auf eine PostgreSQL-Datenbank zugreifen kann, müssen ein entsprechendes Datenbankschema und ein entsprechender Benutzer vorbereitet werden. Sie können jeden Benutzernamen und jedes Passwort anstelle von cbroot und cbpassword unten verwenden:
1. Öffnen Sie eine Eingabeaufforderung in Windows, führen Sie "cmd" aus, und navigieren Sie zu Ihrem $POSTGRESQL_HOME$/bin Verzeichnis. In Windows könnte dies beispielsweise C:\Program Files\PostgreSQL\<PostgreSQL_version>\bin sein.
2. Führen Sie den folgenden Befehl aus: psql -U postgres. Wenn Sie gefragt werden, geben Sie das Passwort ein, das während der Installation konfiguriert wurde.
3. Führen Sie die Befehle aus. Verwenden Sie, wenn Sie Postgres auf Windows Server ausführen, die Zeichensortierung en_US anstelle von en_US.UTF-8:
CREATE DATABASE codebeamer LC_COLLATE='en_US.UTF-8' LC_CTYPE='en_US.UTF-8' ENCODING 'UTF8' TEMPLATE = template0;
CREATE USER cbroot WITH PASSWORD 'CbPassword01!';
ALTER DATABASE codebeamer OWNER TO cbroot;
CREATE USER cbroot WITH PASSWORD 'CbPassword01!';
ALTER DATABASE codebeamer OWNER TO cbroot;
4. Wenn das contrib-Paket von PostgreSQL ebenfalls installiert ist, führen Sie Folgendes aus:
\c codebeamer
CREATE EXTENSION pg_trgm;
CREATE EXTENSION pg_trgm;
|
|
Bei einer Neuinstallation werden die oben genannten Schritte automatisch vom Codebeamer Assistenten ausgeführt. Daher sind keine manuellen Maßnahmen erforderlich.
|
Codebeamer so konfigurieren, dass die PostgreSQL-Datenbank verwendet wird
Bearbeiten/erstellen Sie die Konfigurationsdatei: <installdir>/config/configuration.properties
database.driver=org.postgresql.Driver
database.connectionURL=jdbc:postgresql://localhost:5432/codebeamer
database.username=cbroot
database.password=CbPassword01!
database.passwordStorageType=PLAIN
database.connectionURL=jdbc:postgresql://localhost:5432/codebeamer
database.username=cbroot
database.password=CbPassword01!
database.passwordStorageType=PLAIN
Starten Sie Codebeamer.
Beachten Sie, dass der erste Codebeamer Serverstart nach dem Wechsel zu einer neuen Datenbank länger als üblich dauert, da Codebeamer zunächst das neue leere Datenbankschema initialisiert.
Volltextindex in TASK-Tabelle
Diese Funktion erfordert, dass die PostgreSQL-Erweiterungen contrib auf dem Datenbankserver installiert sind. Bei einigen Verteilungen (z.B. CentOS) befinden sich diese in einem separaten Paket und müssen separat installiert werden.
Weitere Informationen zum datenbankspezifischen Konfigurationsprozess finden Sie unter Datenbankspezifische Konfigurationen.