Zum Hauptinhalt springen
Version: 14

ADOGRC Setup-Anleitung

Dieses Dokument führt Sie durch den Einrichtungsprozess von ADOGRC. Da ADOGRC auf ADONIS basiert, sind zunächst die Schritte zur Einrichtung von ADONIS erforderlich zusätzlich zu den ADOGRC-spezifischen Schritten, die in diesem Dokument beschrieben werden.

Vorbereitung

Dieses Dokument bietet einen Überblick über alle notwendigen Konfigurationen für eine Standardinstallation von ADOGRC.

Installations-Checkliste

Bevor Sie beginnen:

  1. Lesen Sie die ADOGRC Hardware-/Software-Anforderungen, um sicherzustellen, dass alle Systemanforderungen erfüllt sind.

  2. Halten Sie das Installationsmedium bereit.

  3. Halten Sie die ADOGRC-Anwendungsbibliothek und die ADOGRC Lizenzdatei bereit. Optional halten Sie auch die Beispieldaten-Migrationspakete bereit.

  4. Konsultieren Sie das ADONIS-Installationshandbuch, um die Software einzurichten.

  5. Lesen Sie dieses Dokument, um zu erfahren, welche ADOGRC-spezifischen Änderungen im Vergleich zu einer Standard ADONIS Installation vorgenommen werden müssen.

Inhalt des Release Pakets

Kunden erhalten ein ADOGRC Release Paket von ihrem BOC Berater. Dieses Paket enthält alle notwendigen Dateien, um ADOGRC Standard einzurichten.

Das ADOGRC Paket enthält die folgenden Ordner:

  • 01 Installation Manual

    • Installationshandbuch
      Dies ist das ADONIS Installationshandbuch und beschreibt alle notwendigen Schritte, um eine neue Installation in Betrieb zu nehmen. Der Einrichtungsprozess ist für ADONIS und ADOGRC gleich, jedoch gibt es zusätzliche Schritte, die speziell für die ADOGRC Installation erforderlich sind und in diesem Dokument beschrieben werden.

    • Datenbank Handbücher
      Für eine gewöhnliche Installation kann die Datenbank automatisch mit dem von BOC bereitgestellten Befehlszeilentool erstellt und vorbereitet werden. Details und Paramter zum Aufruf des Befehlszeilentools finden Sie im jeweiligen Datenbank Handbuch. Wenn Sie mehr Kontrolle darüber haben möchte, wie genau die Datenbank erstellt wird, ist es möglich eine Datenbank manuell nur mit SQL-Skripten und den vom Datenbanksystem-Anbieter bereitgestellten Tools zu erstellen. Die Anleitung finden Sie ebenfalls im jeweiligen Datenbank Handbuch, die Skripte befinden sich im Ordner "02 Application Server\dbinfo".

  • 02 Application Server

    • BOC
      Dieser Ordner enthält die BOC Application Server-Komponente, die Sie mit dem bereitgestellten Installationsprogramm oder durch manuelles Kopieren der Dateien an einen Ort Ihrer Wahl installieren können.

    • dbinfo
      Dieser Ordner enthält SQL-Skripte, mit denen Sie eine ADOGRC-Datenbank manuell ohne das von BOC bereitgestellte Tool erstellen können.

  • 03 Web Application

    • Dieser Ordner enthält die ADOGRC Webapplikation sowie eine Beispielkonfiguration für Apache Tomcat und Drittanbietertools.
  • 04 Sample Data

    • Dieser Ordner enthält Beispieldaten von ADONIS und ADOGRC, die deren Verwendung veranschaulichen.

Einrichtung von ADOGRC

Die Installation der ADOGRC Server- und Webserver-Komponenten wird auf die selbe Weise durchgeführt wie die Installation von ADONIS. Gehen Sie dazu gemäß dem ADONIS Installationshandbuch vor. Anschließend sind einige zusätzlichen Schritten notwendig, welche im folgenden beschrieben werden.

Datenbank erstellen

Um eine neue Datenbank für ADOGRC erfolgreich zu erstellen, können Sie das von BOC bereitgestellte Befehlszeilentool verwenden. Zusätzlich zu den Dateien des Application Servers benötigen Sie die ADOGRC-Anwendungsbibliothek und die ADOGRC-Lizenz.

  • Informationen und Beispiele zur Erstellung einer Datenbank finden Sie im Datenbank Handbuch des jeweiligen Datenbanksystems im Verzeichnis "\01 Installation Manual\".

  • Wählen Sie die Standard ADOGRC Anwendungsbibliothek aus, die im Release Paket im Ordner "\02 Application Server\BOC\ADOGRC 14.0.0_ADONIS 17.0\data" enthalten ist, oder eine benutzerdefinierte Bibliothek, die von Ihrem BOC-Berater bereitgestellt wurde.

  • Wählen Sie die von Ihrem BOC-Berater bereitgestellte ADOGRC Lizenz aus.

Technische Benutzer und Rollen

ADOGRC prüft beim Start, ob die notwendigen Technischen Benutzer und Systemrollen vorhanden sind und legt diese bei Bedarf automatisch an.

Konfiguration der Technischen Benutzer

Die ADOGRC Technischen Benutzer stellen entscheidende Dienste für ADOGRC bereit und müssen daher korrekt konfiguriert werden, um ADOGRC erfolgreich ausführen zu können. ADOGRC verwendet drei technische Benutzer: GRC-Scheduler, GRC-Notification und Technical. Details zur Konfiguration finden Sie im entsprechenden Abschnitt des ADOGRC Administrationshandbuchs.

  • Überprüfen Sie, ob die Technischen Benutzer über Berechtigungen für Vertrautes Login verfügen.

    Vertrautes Login ermöglicht es den Technischen Benutzern, Hintergrunddienste bereitzustellen, ohne ein Passwort anzugeben. Dies ist erforderlich, damit ADOGRC korrekt funktioniert, und ist bereits voreingestellt. Details zum Vertrauten Login finden Sie im ADOGRC Administrationshandbuch.

    ADOGRC Technical Users

  • Überprüfen Sie, ob die Technischen Benutzer in den Systemeinstellungen korrekt konfiguriert sind

    Technische Benutzer müssen in den Systemeinstellungen festgelegt werden. Dies ist bereits voreingestellt, Details dazu finden Sie im entsprechenden Abschnitt des ADOGRC Administrationshandbuchs.

    System Settings

  • Überprüfen Sie, ob die Technischen Benutzer in den ADOGRC Einstellungen korrekt konfiguriert sind

    Die Technischen Benutzer müssen auch in ihren jeweiligen ADOGRC Einstellungen festgelegt werden: Konfiguration von GRC Benachrichtigungen, Konfiguration von GRC Scheduler und Allgemeine technische Benutzereinstellungen. ADOGRC kommt bereits mit einer vordefinierten Konfiguration, die für die meisten Fälle passend sein sollte.

  • Überprüfen Sie, ob die Technischen Benutzer allen Repositories zugewiesen sind, in denen sie ihre Dienste ausführen sollen.

    Die Technischen Benutzer benötigen für ihre Dienst Zugriff auf die Objekte, für welche sie zuständig sind. Weisen Sie die gewünschten Repositorys zu, wie im entsprechenden Abschnitt des ADOGRC Administrationshandbuch beschrieben.

    Select Repository

  • Überprüfen Sie, ob die Technischen Benutzer die erforderlichen System-Rollen zugewiesen bekommen haben

    Um Objekte für Freigabeworkflow-Aufgaben einzuplanen und Benutzer über anstehende Aktionen zu benachrichtigen, benötigen die Technischen Benutzer die erforderlichen Freigabeworkflow-Rollen. Weitere Informationen zu diesen Systemrollen finden Sie im ADOGRC Administrationshandbuch.

    Die technischen Benutzer Technical, GRC-Scheduler und GRC-Notification benötigen die Administrator Rolle jedes aktiven Freigabeworkflows, um Aktionen an ADOGRC Objekten sowie dem ADOGRC (CIP) Maßnahme-Freigabeworkflow ausführen zu können.
    Details zum Zuweisen von Systemrollen finden Sie im ADOGRC Administrationshandbuchs. Alternativ können Sie Benutzern auch über die Benutzerverwaltung Systemrollen zuweisen.

    System Roles

Hinweis

Änderungen der Konfiguration der Technischen Benutzer und Systemrollen erfordern einen Neustart.

Optional: ADOGRC-Beispieldaten importieren

ADOGRC stellt Beispieldaten zur Verfügung, die in eine bestehende Datenbank importiert werden können. Das Beispieldatenpaket enthält auch die oben beschriebenen Technischen Benutzer und Rollen, sodass es in diesem Fall nicht erforderlich ist, sie separat zu importieren.

Importieren Sie die Beispieldaten aus dem Paket "\04 Sample Data\Migration Package\ADOGRC 14.0.0 - Sample Data Migration Package.axr". Weitere Informationen zum Importieren eines Migrationspakets in der Repository-Verwaltung der ADONIS + ADOGRC Administration finden Sie im entsprechenden Abschnitt des ADOGRC Administrationshandbuchs.

Konfiguration der ADOGRC System-Rollen

ADOGRC ermöglicht eine granulare Konfiguration von Rollen, die der Rolle eines Benutzers in der Organisation und den Prozessen des Kunden entsprechen sollten. Es ist entscheidend, diese Rollen richtig zu konfigurieren, damit jeder Benutzer die entsprechenden Berechtigungen hat, um seine Aufgaben in den ADOGRC Freigabeworkflows zu erledigen. Details zu den von ADOGRC bereitgestellten Systemrollen finden Sie im ADOGRC Administrationshandbuch.

ADOGRC Freigabeworkflow-Varianten

Einige ADOGRC Freigabeworkflows unterstützen mehrere Varianten wie die Genehmigung des Freigabeworkflows gehandhabt wird. Diese Konfigurationen können von BOC implementiert werden. Bitte kontaktieren Sie Ihren BOC Berater für weitere Informationen.

ADOGRC unterstützt auch die Implementierung verschiedener kundenspezifischer Anpassungen. Für solche kundenspezifischen Anpassungen muss ein separates Projekt mit BOC Spezialisten eingerichtet werden, um eine Lösung nach den Spezifikationen des Kunden zu liefern. Bitte kontaktieren Sie Ihren BOC Berater für weitere Informationen zu diesen fortgeschrittenen Themen.

Einstellungen für den ADOGRC Webclient

Die unten aufgeführten Einstellungen sind in der mit ADOGRC ausgelieferten Webapplikation bereits vorkonfiguriert. Falls Sie von ADONIS zu ADOGRC wechseln und zu einem früheren Zeitpunkt die Datei adoxx_web.properties im Ordner "/Tomcat Installationsordner/webapps/ADONIS Version/adoxx_web.properties" geändert haben sowie diese Datei während der Einrichtung von ADOGRC wiederhergestellt wurde, ist es wichtig zu überprüfen, ob die unten aufgeführten Einstellungen (erneut) angewendet wurden.

GRC-Scheduler und GRC-Notification Benutzer
Um den ADOGRC-Scheduler und die Benachrichtigungen zu aktivieren, muss die Datei "adoxx_web.properties" angepasst werden und die Benutzer GRC-Scheduler und GRC-Notification der Liste der job users hinzugefügt werden.

adoxx_web.properties

Maximale E-Mail-Größe für ADOGRC-Benachrichtigungen

ADOGRC sendet Benachrichtigungen an Benutzer mit Erinnerungen an bevorstehende und aktuelle Aufgaben und enthält Links zu jedem Objekt, damit die Benutzer das relevante Objekt direkt in ADOGRC öffnen können. Falls es viele Objekte gibt, für die Benachrichtigungen erforderlich sind, kann es notwendig sein die maximale E-Mail-Größe in den E-Mail-Einstellungen der Datei adoxx_web.properties zu erhöhen.
Die standardmäßige maximale E-Mail-Größe beträgt 50 KB und sollte für E-Mails mit bis zu 100 Links ausreichen. Pro 100 zusätzlichen Objekt-Links sollte dieses Limit um 50 KB erhöht werden (z.B. für 300 Links sollte eine maximale Größe von 150 KB festgelegt werden).

Beachten Sie bitte, dass bei einer zu geringen Einstellung die E-Mail nicht gekürzt werden kann und folglich nicht gesendet wird.

max mail size

Konfiguration von ADOGRC Funktionen

Bestimmte ADOGRC Funktionen, wie z.B. Dashboards, können an die Benutzerpräferenzen angepasst werden. Details dazu finden Sie im ADOGRC Administrationshandbuch.