AHP Portal Database Cloning

Verfügt eine Kundenumgebung grundsätzlich über ein Testsystem, kann über die AHP Portal (vormals AHP One) Database Cloning Funktion neben der produktiven Datenbank und Rollen Installation ein Testsystem erstellt werden. Sie können dies beispielsweise nutzen, um neue AHP Portal Versionen auf einer Kundenumgebung hin zu testen und vom Kunden abnehmen zu lassen, bevor die Versionen in die Produktion gelangen.

Damit ein Testsystem eine aussagekräftige Qualität liefern kann, muss zuvor die Produktionsdatenbank mit allen Inhalten und Konfigurationen in die Testinstanz übernommen werden. Da es sich um eine SQL Datenbank handelt, könnte das vom SQL Administrator vorgenommen werden. Hat man allerdings eine 1:1 Kopie der produktiven AHP One Datenbank im Testsystem und installiert dazu die AHP Portal Rollen und Dienste, hätte man an ein existierendes Active Directory nun zwei aktive AHP Portal Instanzen angeschlossen, in denen mit denselben Servicekonto-Rechten und nun zwei AD Sync Jobs gearbeitet wird.

Würde man in der produktiven AHP Portal Instanz die Buchung eines Applikations-Produktes vornehmen, gelangt diese in die AD Gruppenmitgliedschaft. Der AD Sync vom AHP Portal Testsystem würde eine veränderte AHP Applikationsgruppenmitgliedschaft vorfinden, aber in der Test AHP Portal Datenbank keine dazugehörige Applikations-Produkt-Buchung. Dies hätte zur Folge, dass der Benutzer wieder aus der Gruppe entfernt wird, weil nur das AHP Portal das führende System für Applikations-Produkt-Buchungen ist. Weiter würde der AD Sync dem produktiven AHP Portal eine immer noch richtige Buchung vorfinden, aber eine fehlende AD Gruppenmitgliedschaft, würde das entsprechend korrigieren und neu buchen. Der AD Sync auf dem AHP One Portal Testsystem würde erneut einschreiten und nach seinen Konfigurationen korrigieren. Es würde ein Buchungs-Pingpong entstehen.

 
Vorsicht

Um das vorangehende Szenario zu vermeiden, hat die AHP Portal Database Cloning Funktion Folgendes integriert:

Alle AHP Portal Servicekonten (S-AHPOneServer) der Provider werden entfernt.

Diese müssen manuell vom Administrator wieder eingerichtet werden
[S-AHPOneServerDev].

Der AD Sync wird abgeschaltet. Dieser wird zu Testzwecken in der Regel nicht gebraucht.

Es ist nicht erforderlich die AHP Portal Dienste zu deaktivieren, weil die Daten der Dienste aus dem laufenden Betrieb genutzt werden können. Ziehen Sie dennoch das Deaktivieren der Dienste vor, müssen diese entsprechend nach dem Database Cloning wieder aktiviert werden.

  • Folgende Konfigurationen werden von der Cloning Funktion vorgenommen:
  • Es wird ein neuer SQL Benutzer für die Test-Datenbanken angelegt.
  • Alle AD Sync Jobs (die ggf. noch laufen) werden beendet.
  • Der AD Sync wird permanent abgeschaltet.
  • Der AHP One Reporting Provider wird permanent abgeschaltet.
  • Der AHP One Service Account wird entfernt und muss an allen Providern wieder neu eingetragen werden.
 
Warnung

Um den Ressourcenbedarf und den Zeitaufwand des Clonens zu minimieren, empfehlen wir das "Schrumpfen" (Shrink) der Microsoft SQL Datenbank. Kontaktieren Sie im Zweifesfall Ihren Datenbank-Administrator.
Database Shink Q2 2023

AHPONEdatabase.exe
Abbildung: AHP One Database.exe

Es ist erforderlich die drei Datenbanken (Content, Reporting und Config) nacheinander zu klonen.

  1. Wählen Sie die Datenbanken aus, mit der Sie das Klonen beginnen möchten. Über Rechtsklick auf die Datenbank öffnet sich die Option Clone Database.
Database Setup Cloning
Abbildung: AHPOneDatabase Setup > Common information
  1. Geben Sie den Ziel-Datenbank-Namen in der sich öffnenden Dialogbox ein, in der Regel D1 und das neu zu vergebende Passwort.
Cloning Database
Abbildung: Clone Database > Target Database
  1. Wenn Sie in einem Zwischenschritt überprüfen möchten, wieviel Arbeitsspeicher vorhanden ist und ob die notwendigen Rechte vorliegen, können Sie dies über die Check Environment-Schaltfläche (1) überprüfen.
  2. Es öffnet sich ein Pop-up indem Sie nach einer Aktualisierung (Refresh) den Datenbank Namen, den Pfad, die Berechtigung und die vorhandene und belegte Arbeitsspeicher-Kapazität angezeigt bekommen. Der Default-Pfad ist C:\temp, der geändert werden kann. Der UNC-Pfad wird ebenfalls unterstützt, wobei sichergestellt sein muss, dass das SQL Server AD Konto ordnungsgemäße Berechtigung auf den Ordner hat.
DB Cloning_Arbeitsspeicher
Abbildung: Überprüfung Berechtigung und Arbeitsspeicher-Kapazität
  1. Ist genug Arbeitsspeicher vorhanden, klonen Sie die Datenbank durch das Klicken der entsprechenden Schaltfläche.
  2. Die AHP Portal Rollen werden installiert und eine zur Produktion identische, aber passive Datenbank ist angelegt.
  1. Gehen Sie nun auf die gleiche Weise für die verbleibenden Datenbanken vor.
  1. Eine zur Produktion identische, aber passive AHP Portal Dev ist angelegt.

Handelt es sich um ein neues System, können selbstverständlich keine Daten ausgelesen werden und entsprechend werden keine Datenbanken angezeigt. Nutzen Sie in diesem Fall die Clone Database-Schaltfläche.

keine DB_Cloning Button
Abbildung: Configure AHP Database > Clone Database
  1. Die Dialogbox zur Eingabe der Daten der Datenbanken öffnet sich.
  2. Geben Sie die Daten der Quell-Datenbank ein.
  3. Geben Sie die Daten der Ziel-Datenbank ein, vergeben Sie ein Password und bestätigen Sie die Eingabe durch Klicken der Clone Database-Schaltfläche.
Clone Database Dialog
Abbildung: Clone Database > Source und Target Database
  1. Gehen Sie nun auf die gleiche Weise für die verbleibenden Datenbanken vor.
  1. Eine zur Produktion identische, aber passive AHP Portal Dev ist angelegt.
 
Warnung

Es besteht auch die Möglichkeit eine einzelne Datenbank direkt zu clonen. Ist nur eine der Datenbanken ausgewählt, ist automatisch die Schaltfläche Clone Database aktiviert und der Vorgang kann direkt gestartet werden.

Clonen einer Datenbank Q2 2023