Oracle-Datenbankinstallation
Oracle-Datenbank für die Installation vorbereiten
Auf dieser Seite wird beschrieben, wie Sie Codebeamer mit einer Oracle-Datenbank der Version 19.3c verwenden.
Voraussetzungen
Sie sollten mit Oracle-Datenbanken und der Datenbankverwaltung vertraut sein, um dieses Dokument besser zu verstehen.
Für die Installation/Migration werden Oracle-DBA-Berechtigungen benötigt.
 |
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.
|
Neues Oracle-Schema vorbereiten
1. Codebeamer erfordert UTF8 (AL32UTF8)-Codierung. Überprüfen Sie die Kodierung der Datenbank, indem Sie die folgende Abfrage als 'sys' Benutzer ausführen:
SQL> SELECT value$ FROM sys.props$ WHERE name = 'NLS_CHARACTERSET';
VALUE$
-----------------------------------------------
AL32UTF8
VALUE$
-----------------------------------------------
AL32UTF8
2. Planen und gestalten Sie das Zuordnungsschema für den Datenbank-Tabellenbereich sorgfältig. Entscheiden Sie, welcher Tabellenbereich für Codebeamer verwendet werden soll. Eine ausführliche Dokumentation finden Sie unter: http://download.oracle.com/docs/cd/B10501_01/server.920/a96521/tspaces.htm#636 In diesem Handbuch wird der Tabellenbereich USERS verwendet.
3. Erstellen Sie den Datenbankbenutzer cbroot. Das muss ein sys-Benutzer erledigen.
4. Führen Sie sqlplus aus, und verbinden Sie sich als sys as sysdba, um das folgende Skript auszuführen (verwenden Sie den gewünschten Tabellenbereich anstelle von USERS):
◦ Führen Sie den folgenden SQL-Befehl aus, um zu prüfen, ob Oracle 19.3c von einer Multitenant-Umgebung abhängig ist:
SELECT cdb FROM v$database;
▪ Wenn NEIN:
CREATE USER cbroot IDENTIFIED BY cbpassword DEFAULT TABLESPACE USERS QUOTA UNLIMITED ON USERS;
GRANT CREATE SESSION, CREATE TYPE, CREATE TABLE, CREATE CLUSTER, CREATE TRIGGER, CREATE OPERATOR, CREATE SEQUENCE, CREATE INDEXTYPE, CREATE PROCEDURE, CREATE VIEW To cbroot;
GRANT EXECUTE ON dbms_obfuscation_toolkit TO cbroot;
GRANT EXECUTE ON DBMS_LOB TO cbroot;
GRANT UNLIMITED TABLESPACE TO cbroot;
GRANT CREATE SESSION, CREATE TYPE, CREATE TABLE, CREATE CLUSTER, CREATE TRIGGER, CREATE OPERATOR, CREATE SEQUENCE, CREATE INDEXTYPE, CREATE PROCEDURE, CREATE VIEW To cbroot;
GRANT EXECUTE ON dbms_obfuscation_toolkit TO cbroot;
GRANT EXECUTE ON DBMS_LOB TO cbroot;
GRANT UNLIMITED TABLESPACE TO cbroot;
▪ Wenn JA:
Es ist ein Common
Oracle Account erforderlich:
Oracle Account erforderlich:CREATE USER c##cbroot IDENTIFIED BY cbpassword DEFAULT TABLESPACE USERS QUOTA UNLIMITED ON USERS;
GRANT CREATE SESSION, CREATE TYPE, CREATE TABLE, CREATE CLUSTER, CREATE TRIGGER, CREATE OPERATOR, CREATE SEQUENCE, CREATE INDEXTYPE, CREATE PROCEDURE, CREATE VIEW To c##cbroot;
GRANT EXECUTE ON dbms_obfuscation_toolkit TO c##cbroot;
GRANT EXECUTE ON DBMS_LOB TO c##cbroot;
GRANT UNLIMITED TABLESPACE TO c##cbroot;
GRANT CREATE SESSION, CREATE TYPE, CREATE TABLE, CREATE CLUSTER, CREATE TRIGGER, CREATE OPERATOR, CREATE SEQUENCE, CREATE INDEXTYPE, CREATE PROCEDURE, CREATE VIEW To c##cbroot;
GRANT EXECUTE ON dbms_obfuscation_toolkit TO c##cbroot;
GRANT EXECUTE ON DBMS_LOB TO c##cbroot;
GRANT UNLIMITED TABLESPACE TO c##cbroot;
◦ Die Funktion muss in Oracle aktiviert sein, um die VOLLTEXTSUCHE im Berichtmodul zu verwenden: Datenbankspezifische Konfigurationen
5. Passen Sie das Verhalten des Optimierers für Zugriffspfade relativ zu den vollständigen Tabellen-Scans an, indem Sie den folgenden Befehl ausführen:
ALTER SYSTEM SET OPTIMIZER_INDEX_COST_ADJ = 25 SCOPE = BOTH;
6. Richten Sie die Volltext-Indizierung ein. Dies ist für eine erfolgreiche Datenbankvorbereitung zwingend erforderlich. Führen Sie die folgenden SQL-Skripte aus, bevor Sie Codebeamer starten:
GRANT EXECUTE ON DBMS_LOB TO <database user>;
GRANT EXECUTE ON CTXSYS.CTX_DDL TO <database user>;
Weitere Informationen finden Sie unter Datenbankspezifische Konfigurationen.
Codebeamer für den Zugriff auf die neue Oracle-Datenbank konfigurieren
1. Codebeamer darf nicht ausgeführt sein.
2. Bearbeiten Sie die Konfigurationsdatei: <installdir>/config/configuration.properties
database.driver=oracle.jdbc.driver.OracleDriver
database.connectionURL=jdbc:oracle:thin:@//localhost:1521/ORCLCDB
database.username=user
database.password=pass
database.passwordStorageType=PLAIN
database.connectionURL=jdbc:oracle:thin:@//localhost:1521/ORCLCDB
database.username=user
database.password=pass
database.passwordStorageType=PLAIN
3. Starten Sie Codebeamer.
Die Datenbanktabellen werden beim ersten Start von Codebeamer automatisch erstellt. Dieser erste Start dauert deutlich länger als nachfolgende Startvorgänge.
Upgrade einer vorhandenen Codebeamer Oracle-Datenbank auf eine neuere Codebeamer Version durchführen
Nur die neue Codebeamer Installation muss für den Zugriff auf die vorhandene Oracle-Datenbank konfiguriert werden (siehe oben). Alle erforderlichen Datenbank-Upgrades werden automatisch ausgeführt, wenn die neue Codebeamer Instanz zum ersten Mal gestartet wird.
Sie müssen das Schema aus der alten Instanz exportieren und in die neue Instanz importieren, um ein Codebeamer Schema von einer Oracle-Instanz in eine andere zu migrieren. Konfigurieren Sie danach Codebeamer (neu), um auf die neue Instanz zuzugreifen.
| | Sichern Sie alle Daten. Legen Sie ein Backup der vorhandenen Datenbank an, bevor Sie etwas tun. Stellen Sie außerdem sicher, dass niemand die Datenbank während der Migration verwendet, da sonst Datenverlust droht. Bevor Sie eine vorhandene Datenbank aktualisieren, sollten Sie sicherstellen, dass die alte Codebeamer Installation heruntergefahren ist. Eine Rückkehr zur alten Codebeamer Version ist unter Umständen nur schwer möglich, da diese Version höchstwahrscheinlich mit der aktualisierten Datenbank nicht kompatibel ist. Der einzig sichere Weg, das Upgrade rückgängig zu machen, besteht darin, die alte Datenbank aus einem Backup wiederherzustellen. |
| | Beim Upgrade auf Version 10.0.x und höher müssen Sie den folgenden Befehl ausführen, der für die Datenmigration erforderlich ist, andernfalls schlägt das Upgrade fehl: GRANT EXECUTE ON SYS.DBMS_CRYPTO TO {Codebeamer Database User} |