Aktuelle Version
v3.4.1
Action Pack · Automic
Full Guide · Action Pack

3C Release Manager — installieren, konfigurieren und betreiben

Vollständiger Leitfaden für den 3C Release Manager – die umfassende Referenz zur Installation, Konfiguration und Bedienung der Tools des 3C Release Manager für Snapshots, Diffs, Deployments und Governance für Automic Automation V24+.

Version
3.4.1
Kompatibel mit
Automic AE V24+
Stack
Java 21 · Tomcat 10 · PG 15
Bereitstellung
On-Premise / SaaS
Inhalt
  1. Technischer Umfang & Architektur
  2. Installation — Voraussetzungen, manueller und geführter Weg
  3. Konfiguration — Gateway, Authentifizierung, Backend, In-App-Systemeinstellungen
  4. Nutzung — Administration, Umgebungen, Snapshots, Diffs, Deployments, User Stories
  5. Upgrade & Migration
  6. Versionshinweise
  7. FAQ
Installationsvideo

Video (Deutsch, 1:55): die geführte Installation mit install3c.bat in neun Schritten – von den Voraussetzungen bis zum ersten Login.

1 · Technischer Umfang

Architektur & technischer Umfang

Der 3C Release Manager ist eine dreistufige Webanwendung, die auf einem Java-basierten Technologie-Stack bereitgestellt wird und sichere externe Integrationen zu Automic aufweist. Das Verständnis der Architektur hilft bei Kapazitätsplanung, Fehlerbehebung und Integrationsplanung.

Architekturübersicht

Diagramm der 3-Schichten-Architektur des 3C Release Manager
3C Release Manager — eine dreistufige Webanwendungsarchitektur, die auf einem Java-basierten Technologie-Stack mit sicheren externen Integrationen zu Automic bereitgestellt wird.

Benutzerzugriffsschicht

  • Endbenutzer greifen über HTTPS auf das System zu.
  • Der Datenverkehr wird Ende-zu-Ende mit TLS verschlüsselt.
  • Anfragen werden an das Web-Frontend innerhalb der 3C Release Manager-Umgebung gerichtet.

Anwendungsschicht

Die Kernanwendung ist in einem Tomcat-Anwendungsserver bereitgestellt und besteht aus zwei Hauptkomponenten:

Frontend

  • Implementiert mit Angular.
  • Wird von Tomcat als Teil der 3C Release Manager-Anwendung bereitgestellt.
  • Verantwortlich für das Rendern der Benutzeroberfläche, die clientseitige Logik und die Kommunikation mit dem Backend über REST-APIs.

Backend

  • Implementiert mit Spring (Spring Boot / Spring Framework).
  • Bietet eine RESTful API, die vom Angular-Frontend und externen Systemen (Automic) genutzt wird.
  • Übernimmt Geschäftslogik, Authentifizierung/Autorisierung und Datenbankzugriff.
  • Die Kommunikation zwischen Frontend und Backend erfolgt über REST.

Datenschicht

  • Verwendet PostgreSQL als relationale Datenbank.
  • Das Backend stellt über JDBC eine Verbindung zur Datenbank her.
  • Die Datenbank speichert alle persistenten 3C Release Manager-Anwendungsdaten.

Systemintegration

  • Das System ist an Automic angebunden.
  • Mehrere Automic-Instanzen (System / Clients) werden unterstützt.
  • Die Kommunikation erfolgt über eine Java-API.
  • Die Transportsicherheit wird mittels TLS erzwungen.
  • Verbindungen werden vom 3C Release Manager-Backend zu Automic-Clients initiiert.

Sicherheits- und Kommunikationsübersicht

HTTPS/TLS wird für die gesamte externe Kommunikation verwendet: Benutzer → Frontend und Backend → Automic. Die interne Kommunikation erfolgt über REST zwischen Frontend und Backend und über JDBC zwischen Backend und Datenbank.

Zusammenfassung der logischen Architektur

  • Präsentationsschicht: Angular-Frontend
  • Anwendungsschicht: Spring-basiertes Backend auf Tomcat
  • Datenschicht: PostgreSQL-Datenbank
  • Integrationsschicht: Sichere Java-API-Integration mit Automic

Anforderungen & Kompatibilität

Die technischen Mindestanforderungen für die Bereitstellung und den Betrieb der 3C Release Manager-Anwendung.

Betriebssystem

Der 3C Release Manager ist plattformunabhängig und kann auf folgenden Systemen bereitgestellt werden:

  • Microsoft Windows (64-Bit)
  • Linux (64-Bit) — jede moderne, vom Anbieter unterstützte Distribution (z. B. RHEL, Rocky Linux, Ubuntu LTS)

Das Betriebssystem muss unterstützen: Java 21, PostgreSQL 15, Apache Tomcat 10, TLS-gesicherte Netzwerkkommunikation.

Java Runtime Environment (JRE)

  • Mindestversion: Java 21
  • Edition: Open Edition (OpenJDK)

Die JRE wird benötigt, um den Anwendungsserver Apache Tomcat und die auf Spring basierende Backend-Anwendung des 3C Release Manager auszuführen und eine sichere TLS-Kommunikation mit externen Systemen (Automic) zu unterstützen.

Anwendungsserver

  • Mindestversion: Apache Tomcat 10

Tomcat wird benötigt, um die Anwendung 3C Release Manager zu hosten, das Angular-basierte Frontend bereitzustellen, die Java-Backend-Komponenten auszuführen und REST-Endpunkte für die interne und externe Kommunikation bereitzustellen. Tomcat muss für den Produktiveinsatz so konfiguriert sein, dass es mit Java 21 kompatibel ist, HTTPS/TLS aktiviert ist und die entsprechenden Speicher- und Thread-Einstellungen vorliegen.

Datenbank

  • Mindestversion: PostgreSQL 15

PostgreSQL wird als permanenter Datenspeicher für 3C verwendet. Anforderungen: JDBC-Konnektivität vom 3C Release Manager-Backend, ausreichender Speicherplatz und Leistung für Anwendungsdaten, sichere Zugriffskonfiguration (Authentifizierung, Netzwerkeinschränkungen).

Externe Systemintegration (Automic)

  • Mindestversion: Automic Automation Engine V21

Automic ist über die Java-API und TLS-gesicherte Kommunikation mit 3C integriert. Anforderungen: eine oder mehrere Automic-Instanzen (V21 oder höher), ein oder mehrere konfigurierte Automic-Clients pro Instanz, Netzwerkverbindung zwischen dem 3C-Backend und den Automic-Instanzen, kompatible Zertifikate für die TLS-Kommunikation.

Netzwerk & Sicherheit

HTTPS/TLS muss für den Benutzerzugriff auf das Frontend des 3C Release Manager und für die Backend-Kommunikation mit Automic aktiviert sein.

Erforderliche offene Ports:

  • Tomcat-HTTPS-Port (typischerweise 443 oder benutzerdefiniert)
  • PostgreSQL-Port (Standard 5432)
  • Automic-Kommunikationsports, wie in der Automic-Installation definiert

2 · Installation

Installation

Der 3C Release Manager wird in zwei Installationsvarianten ausgeliefert: manuell (volle Kontrolle, geeignet für netzwerkisolierte oder gehärtete Umgebungen) und geführt (interaktives Installationsskript install3c.bat, schneller für Standard-Setups). Beide liefern das gleiche Ergebnis.

Lieber zuerst zuschauen? Die geführte Installation gibt es auch als Video von knapp zwei Minuten.

Prüfungen vor der Installation

Stellen Sie vor der Installation des 3C Release Manager sicher, dass alle erforderlichen Voraussetzungen installiert, zugänglich und voll funktionsfähig sind.

PostgreSQL-Verfügbarkeit

  • PostgreSQL ist auf dem vorgesehenen Datenbankserver installiert.
  • Der psql Kommandozeilenanwendung ist verfügbar und ausführbar.
  • Eine Verbindung zum PostgreSQL-Server kann hergestellt werden mit psql.
  • Der PostgreSQL-Dienst läuft und lauscht auf dem konfigurierten Port (Standard: 5432).
  • Befehlszeilenüberprüfung: psql –version

Verfügbarkeit von Java Runtime / Development Kit

  • JRE oder JDK Version 17 ist installiert (Open Edition).
  • Der java Programmdatei ist über den System-PATH aufrufbar.
  • Java lässt sich ausführen und meldet die korrekte Version.
  • Der JAVA_HOME Umgebungsvariable ist korrekt gesetzt (empfohlen).
  • Befehlszeilenüberprüfung: java -version

Verfügbarkeit von Apache Tomcat

  • Apache Tomcat Version 10 ist installiert.
  • Tomcat läuft fehlerfrei.
  • Der Tomcat-Dienst ist über eine HTTP-URL von einem Browser oder der Kommandozeile erreichbar.
  • Der konfigurierte HTTP/HTTPS-Port ist offen und zugänglich.
  • Browser-Überprüfung: http://<tomcat_host>:<port>

Installation — manuell

Führen Sie die folgenden Schritte aus, um den 3C Release Manager manuell zu installieren. Die Beispiele verwenden generische Werte; stellen Sie sicher, dass diese durch die korrekten Werte für die Zielumgebung ersetzt werden.

SCHRITT 1
Installationspaket erhalten
  • Laden Sie das neueste 3C Release Manager-Installationspaket von der offiziellen Distributionsquelle herunter.
  • Überprüfen Sie die Paketintegrität gemäß internen Standards (z. B. Prüfsumme, Signatur).
SCHRITT 2
Datenbankvorbereitung (PostgreSQL)

Erstellen Sie einen dedizierten Datenbankbenutzer. Erstellen Sie einen dedizierten PostgreSQL-Benutzer für den 3C Release Manager (Beispiel: db3cuser) mit eingeschränkten Rechten und den folgenden Eigenschaften: NOSUPERUSER, INHERIT, NOCREATEDB, NOCREATEROLE, NOCREATEREPLICATION.

CREATE USER db3cuser WITH PASSWORD ‘<secure_password>’ NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE NOREPLICATION;

Erstellen Sie eine dedizierte Datenbank. Erstellen Sie die 3C Release Manager-Datenbank mit folgenden Eigenschaften: Kodierung UTF8, Besitzer db3cuser, Tablespace pg_default, Verbindungslimit -1 (unbegrenzt), Vorlage template0, Sortierung C, CTYPE C.

CREATE DATABASE threec WITH OWNER = db3cuser ENCODING = ‘UTF8’ TABLESPACE = pg_default CONNECTION LIMIT = -1 TEMPLATE = template0 LC_COLLATE = ‘C’ LC_CTYPE = ‘C’;
SCHRITT 3
Anwendungs-WAR-Dateien bereitstellen

Stellen Sie die Anwendungskomponenten des 3C Release Manager bereit, indem Sie die folgenden WAR-Dateien kopieren nach <TOMCAT_HOME>/webapps/:

  • threec.war
  • threec-auth.war
  • threec-backend.war
  • threec-frontend.war

Tomcat wird die Anwendungen beim Start automatisch bereitstellen.

SCHRITT 4
Konfigurationsdateien der Anwendung kopieren

Erstellen Sie die erforderlichen Konfigurationsverzeichnisse der Anwendung, falls sie noch nicht vorhanden sind, und kopieren Sie dann die Logging-Konfigurationsdateien:

QuelldateiZielort
logback-threec.xml<TOMCAT_HOME>/appconf/threec/logback.xml
logback-threec-auth.xml<TOMCAT_HOME>/appconf/threec-auth/logback.xml
logback-threec-backend.xml<TOMCAT_HOME>/appconf/threec-backend/logback.xml
SCHRITT 5
Konfiguration des Anwendungskontexts

Gateway. Anpassen <TOMCAT_HOME>/appconf/threec/application-prod.properties

ParameterWert
logging.config<TOMCAT_HOME>/appconf/threec/logback.xml
spring.cloud.gateway.mvc.routes[0].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[1].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[2].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[3].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[4].urihttp://<TOMCAT_HOST>:<PORT>

Authentifizierung. Anpassen <TOMCAT_HOME>/appconf/threec-auth/application-prod.properties

ParameterWert
logging.config<TOMCAT_HOME>/appconf/threec-auth/logback.xml
capture.authorization.gateway-urihttp://<TOMCAT_HOST>:<PORT>
spring.datasource.urljdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME>
spring.datasource.username<DBUSER>
spring.datasource.password<DBPASSWORD>

Backend. Anpassen <TOMCAT_HOME>/appconf/threec-backend/application-prod.properties

ParameterWert
logging.config<TOMCAT_HOME>/appconf/threec-backend/logback.xml
spring.datasource.urljdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME>
spring.datasource.username<DBUSER>
spring.datasource.password<DBPASSWORD>
spring.security.oauth2.resourceserver.jwt.jwk-set-urihttp://<TOMCAT_HOST>:<PORT>/threec-auth/oauth2/jwks
SCHRITT 6
Tomcat-Kontextkonfiguration

Konfigurieren Sie die Tomcat-Kontextdateien so, dass sie auf die externen Spring-Konfigurationsorte verweisen. Erstellen Sie die folgenden Dateien unter <TOMCAT_HOME>/conf/Catalina/localhost/:

threec.xml

<Context> <Parameter name=”spring.config.location” value=”<TOMCAT_HOME>/appconf/threec/application-prod.properties” override=”false”/> </Context>

threec-auth.xml

<Context> <Parameter name=”spring.config.location” value=”<TOMCAT_HOME>/appconf/threec-auth/application-prod.properties” override=”false”/> </Context>

threec-backend.xml

<Context> <Parameter name=”spring.config.location” value=”<TOMCAT_HOME>/appconf/threec-backend/application-prod.properties” override=”false”/> </Context>
SCHRITT 7
Finalisierung
  • Stellen Sie sicher, dass die Dateiberechtigungen es Tomcat ermöglichen, Konfigurations- und Protokolldateien zu lesen.
  • Starten Sie Apache Tomcat neu.
  • Warten Sie, bis die Datenbank initialisiert ist.
  • Starten Sie Apache Tomcat ein zweites Mal neu.
  • Überprüfen Sie die erfolgreiche Bereitstellung anhand der Tomcat-Logs und der Anwendungs-URLs.

Installation — geführt

Führen Sie die folgenden Schritte aus, um den 3C Release Manager mithilfe des dedizierten Installationsskripts zu installieren. Die Beispiele verwenden generische Werte; stellen Sie sicher, dass diese durch die korrekten Werte für die Zielumgebung ersetzt werden.

Video (Deutsch, 1:55): die geführte Installation mit install3c.bat in neun Schritten – von den Voraussetzungen bis zum ersten Login.
SCHRITT 1
Installer starten
Starten Sie den 3C Release Manager-Installer über die Kommandozeile durch Ausführen von install3c.bat.
3C-Installer: Eingabeaufforderungsfenster mit der Begrüßung „Welcome to 3C v3.3.5 installer“
Schritt 1 – Installer starten. Das Ausführen von install3c.bat öffnet die Befehlszeile des Installers.
SCHRITT 2
Verzeichniseinstellungen

Geben Sie die folgenden Verzeichnisse ein, die verfügbar sein müssen:

  • Tomcat HOME-Verzeichnis (z. B. c:/Automic/Tomcat-3C)
  • Java HOME-Verzeichnis (z. B. c:/Program Files/Java/jdk-17)
  • PostgreSQL HOME-Verzeichnis (z. B. c:/Program Files/PostgreSQL/17)
3C-Installer: Abfrage der Verzeichniseinstellungen für die Home-Verzeichnisse von Tomcat, Java und PostgreSQL
Schritt 2 – Verzeichniseinstellungen. Das Installationsprogramm fragt nach den Home-Verzeichnissen von Tomcat, Java und PostgreSQL.
SCHRITT 3
Datenbankeinstellungen

Geben Sie die folgenden Datenbankeinstellungen ein:

  • DB-Name (z. B. db3c)
  • DB-Servername (z. B. localhost)
  • DB-Server-Port (z. B. 5432)
  • DB-Benutzername (z. B. db3c)
  • DB-Benutzerpasswort (nicht das PostgreSQL-Masterpasswort)
3C-Installer: Abfrage der Datenbankeinstellungen (DB-Name, Host, Port, Benutzer und Passwort)
Schritt 3 — Datenbankeinstellungen. Der Installer fragt nach DB-Name, Host, Port, Benutzer und dem Passwort des Datenbankbenutzers (nicht dem PostgreSQL-Masterpasswort).
SCHRITT 4
Datenbankerstellung
Entscheiden Sie, ob eine neue Datenbank erstellt werden soll (Y/N), und geben Sie das PostgreSQL-Masterpasswort ein. Nach Eingabe des Masterpassworts starten die DB-Erstellung und die Migration sofort. Die Erstellung des DB-Benutzers wird übersprungen, falls dieser bereits vorhanden ist.
3C-Installer, Schritt Datenbankerstellung: PostgreSQL-Masterpasswort und Migration mit CREATE DATABASE
Schritt 4 – Datenbankerstellung. Nach der Bestätigung mit Y und der Eingabe des PostgreSQL-Masterpassworts erstellt das Installationsprogramm das Schema und führt die Migration durch.
SCHRITT 5
Lizenzimport
Legen Sie fest, ob ein Lizenzschlüssel importiert werden soll (Y/N). Dieser Import erfordert eine gültige license_data.txt Datei im Installationsordner. Eine entsprechende Datei kann von Tricise bereitgestellt werden, falls sie nicht verfügbar ist.
Schritt „Lizenzschlüssel importieren“ im 3C-Installer mit LICENSE UPDATE READY
Schritt 5 – Lizenzimport. Der Installer importiert den Lizenzschlüssel aus license_data.txt.
SCHRITT 6
Tomcat-Einstellungen
Geben Sie die Tomcat-Einstellungen für den zu verwendenden Domainnamen und Port ein (z. B. http://localvm:8061).
3C-Installer: Tomcat-Einstellungen mit Abfrage von Server-Domainname und Port
Schritt 6 – Tomcat-Einstellungen. Der Installer fragt nach dem Tomcat-Domainnamen und Port.
SCHRITT 7
Anwendungsbereitstellung
Der Installer kopiert die WAR-Dateien in die entsprechenden Tomcat-Ordner.
3C-Installer, Schritt Anwendungsbereitstellung: COPYING FILES kopiert die WAR-Dateien nach Tomcat
Schritt 7 — Bereitstellung der Anwendung. Der Installer kopiert die vier WAR-Dateien nach <TOMCAT_HOME>/webapps.
SCHRITT 8
Erstellung der Konfigurationsdateien
Der Installer erstellt die Konfigurationsdateien für die entsprechenden 3C-Tomcat-Anwendungen.
3C-Installer, Schritt Erstellung der Konfigurationsdateien: CREATING CONFIGURATION FILES
Schritt 8 — Erstellung der Konfigurationsdateien. Der Installer erstellt application-prod.properties für die Module Gateway, Auth und Backend.
SCHRITT 9
Windows-Dienstinstallation
Entscheiden Sie, ob Tomcat 3C als Windows-Dienst installiert werden soll (Y/N). Nach diesem letzten Schritt ist die Installation abgeschlossen.
3C-Installer: Bildschirm INSTALLATION READY mit Abfrage zum Tomcat-Dienst und Standard-Anmeldedaten des Superusers
Schritt 9 – Installation des Windows-Dienstes. Nachdem Sie die Aufforderung zum Tomcat-Dienst beantwortet haben, gibt das Installationsprogramm die Standardanmeldedaten für den Superuser aus und wird mit INSTALLATION READY beendet.
SCHRITT 10
Finalisierung
  • Stellen Sie sicher, dass die Dateiberechtigungen es Tomcat ermöglichen, Konfigurations- und Protokolldateien zu lesen.
  • Starten Sie Apache Tomcat neu.
  • Überprüfen Sie die erfolgreiche Bereitstellung anhand der Tomcat-Logs und der Anwendungs-URLs.

Prüfung nach der Installation

Unabhängig vom gewählten Installationsweg überprüfen Sie die erfolgreiche Bereitstellung, indem Sie die Tomcat-Protokolle der vier WAR-Anwendungen auf Startfehler kontrollieren, die Gateway-URL aufrufen (der 3C-Anmeldebildschirm sollte erscheinen) und sich mit dem Standard-Superuser anmelden (siehe Konfiguration → Standardwerte) — ändern Sie das Passwort sofort.


3 · Konfiguration

Konfigurationsreferenz

Der 3C Release Manager wird über drei application-prod.properties Dateien konfiguriert, eine pro Modul: 3C-Gateway, 3C-Auth, und 3C-Backend. Neben diesen Eigenschaftsdateien kann ein SUPERUSER mehrere Laufzeitparameter des 3C Release Manager über die In-App-Maske Systemeinstellungen anpassen. Die vollständige Parameterreferenz folgt.

3C-Gateway (threec)

Das Gateway-Modul leitet eingehende Anfragen an den entsprechenden Backend-Dienst weiter.

ParameterBeschreibung
logging.configStandard-Logging-Eigenschaft von Spring Boot / Java. Gibt den genauen Speicherort der Logging-Konfigurationsdatei an. Beispiel: file:/c:/Automic/Tomcat-3C/appconf/threec/logback.xml
spring.application.nameLegt den logischen Namen der Spring-Anwendung fest. Standard: 3c-gateway
spring.cloud.gateway.mvc.routes[N].idDefiniert eine Routen-ID für Spring Cloud Gateway (MVC-basiert).
spring.cloud.gateway.mvc.routes[N].uriGibt den Ziel-Backend-Service für diese Route an.
spring.cloud.gateway.mvc.routes[N].predicates[0]Definiert ein Routenprädikat (eine Bedingung zum Abgleichen von Anfragen). Beispiel: Path=/oauth2/**
spring.cloud.gateway.mvc.routes[N].filters[0]Wendet einen Filter an, der den Anforderungspfad ändert. Beispiel: StripPrefix=1
spring.cloud.gateway.mvc.routes[N].filters[1]Fügt dem Anforderungspfad nach StripPrefix ein neues Präfix hinzu. Beispiel: PrefixPath=/threec-auth

3C-Auth (threec-auth)

Das Authentifizierungsmodul übernimmt die Anmeldung, die Ausstellung von JWTs und die Verwaltung der Anmeldedaten.

ParameterBeschreibung
logging.configPfad zur Logback-Konfigurationsdatei.
spring.datasource.driverClassNameJDBC-Treiberklasse für die Verbindung zu PostgreSQL. Standard: org.postgresql.Driver
spring.datasource.urlJDBC-Verbindungs-URL für die Datenbank. Beispiel: jdbc:postgresql://localhost:5432/db3c
spring.datasource.usernameBenutzername, der von der Anwendung für die Authentifizierung bei PostgreSQL verwendet wird.
spring.datasource.passwordPasswort, das von der Anwendung für die Authentifizierung bei PostgreSQL verwendet wird.
capture.authorization.gateway-context-pathDefiniert den Kontextpfad, unter dem das Gateway die Anwendung verfügbar macht. Standard: /threec
capture.authorization.gateway-uriBasis-URL des Autorisierungs-Gateway-Dienstes.
capture.authorization.rsa-keyEnthält den RSA-Schlüssel (Base64-kodiert), der in Autorisierungsabläufen verwendet wird.

3C-Backend (threec-backend)

Das Backend-Modul enthält die zentrale Anwendungslogik. Es verfügt über die meisten einstellbaren Parameter, die im Folgenden nach Themen gruppiert sind.

Logging

ParameterBeschreibung
logging.configLädt die Logback-Konfiguration aus einem externen Dateipfad (Levels, Appender, Logdatei-Speicherorte/Rotation, Formate usw.).

JSON-Serialisierung

ParameterBeschreibung
spring.jackson.mapper.default-view-inclusionAktiviert die standardmäßige Einbeziehung von Eigenschaften bei Verwendung von Jackson @JsonView. Bei true können Eigenschaften, die nicht explizit in einer Ansicht enthalten sind, dennoch eingeschlossen werden (kann beeinflussen, welche Felder in API-Antworten angezeigt werden).
spring.jackson.property-naming-strategySerialisiert/deserialisiert JSON-Eigenschaften in SNAKE_CASE (z. B. created_at) anstelle von camelCase.
spring.data.web.pageable.one-indexed-parametersPaginierungsparameter sind 0-basiert bei Einstellung auf false (page=0 ist die erste Seite). Wenn true, page=1 wäre die erste Seite.

Datenbank & Verbindungspool

ParameterBeschreibung
spring.datasource.driverClassNameJDBC-Treiberklasse für PostgreSQL.
spring.datasource.urlJDBC-Verbindungs-URL.
spring.datasource.usernameDB-Benutzer, der von der Anwendung verwendet wird.
spring.datasource.passwordDB-Passwort, das von der Anwendung verwendet wird.
spring.datasource.hikari.pool-nameName des Hikari-Pools (erscheint in Logs/Metriken). Standard: db-pool
spring.datasource.hikari.maximum-pool-sizeMaximale Anzahl von DB-Verbindungen im Pool. Standard: 30
spring.datasource.hikari.minimum-idleMinimale Anzahl inaktiver Verbindungen, die bereitgehalten werden. Standard: 1
spring.datasource.hikari.idle-timeoutWie lange (ms) eine inaktive Verbindung bestehen bleiben kann, bevor sie geschlossen wird (wenn mehr als minimum-idle Verbindungen vorhanden sind). Standard: 30000
spring.datasource.hikari.connection-timeoutMaximale Wartezeit (ms) auf eine Verbindung aus dem Pool, bevor ein Fehler auftritt. Standard: 5000
spring.datasource.hikari.max-lifetimeMaximale Lebensdauer (ms) einer Verbindung, bevor diese ersetzt wird. Wird oft niedriger als DB-/Netzwerk-Limits eingestellt, um veraltete Verbindungen zu vermeiden. Standard: 60000
spring.jpa.database-platformTeilt Hibernate mit, welcher SQL-Dialekt verwendet werden soll. Standard: org.hibernate.dialect.PostgreSQLDialect
spring.jpa.open-in-viewDeaktiviert „Open Session in View“ bei Einstellung auf false (verhindert Lazy Loading während der Darstellung von Webantworten; generell besser für Performance und saubere Architektur).
spring.jpa.properties.hibernate.id.db_structure_naming_strategyNamensstrategie des Hibernate-ID-Generators für DB-Strukturen (betrifft die Benennung von Sequenzen/Tabellen, die für IDs verwendet werden). Standard: single
spring.flyway.out-of-orderErmöglicht das Anwenden von Migrationen „außer der Reihe“ (z. B. wenn eine niedrigere Version nach einer bereits angewendeten höheren Version erscheint). Nützlich in einigen Release-Flows, kann aber riskant sein, wenn es nicht kontrolliert erfolgt.

Sicherheit & Authentifizierung

ParameterBeschreibung
spring.security.oauth2.resourceserver.jwt.jwk-set-uriURL, von der die App das JWK-Set (öffentliche Schlüssel) zur Prüfung von JWT-Signaturen abruft.
capture.authorization.rsa-keyRSA-Schlüsselmaterial (oft ein JWK/JWKS-ähnlicher Block) zur Signierung/Verifizierung in Autorisierungsabläufen.
capture.encryption.secret.keyGeheimer Schlüssel der Anwendung für die Verschlüsselung (wird je nach Implementierung zur Verschlüsselung sensibler Daten / Token / Konfigurationswerte verwendet).
capture.encryption.saltSalt für Hashing/Schlüsselableitung (schützt vor Rainbow-Table-Angriffen).
server.servlet.session.cookie.secureKennzeichnet Sitzungs-Cookies als Secure (nur über HTTPS gesendet). Wenn Sie keinen durchgängigen HTTPS-Betrieb haben, können Sitzungen in Browsern nicht beibehalten werden.

Lizenz & Cache

ParameterBeschreibung
capture.license.server.urlEndpunkt des Lizenzservers (leer → entweder nicht gesetzt, deaktiviert oder woanders angegeben).
capture.system.cache-time-to-liveTTL für einen internen Cache in Sekunden. Standard: 86400 (24 Stunden).

XOG (externe Systemkommunikation)

ParameterBeschreibung
capture.xog.timeout-in-secondsAnforderungs-Timeout für XOG-Aufrufe. Standard: 300
capture.xog.connection-timeout-in-secondsVerbindungsaufbau-Timeout für XOG-Aufrufe. Standard: 20
capture.xog.http-buffersize-bytesHTTP-Puffergröße in Bytes. Standard: 33554432 (≈ 32 MiB). Nützlich für große Payloads.
capture.xog.soap-cache-time-to-liveTTL für SOAP-bezogenen Cache in Sekunden. Standard: 60

Scheduler & Aufgabenausführung

ParameterBeschreibung
capture.scheduler.enabledSchaltet den Scheduler der Anwendung ein/aus.
capture.worker.settings.refresh.intervalWie oft die Worker-Einstellungen aktualisiert werden (ms). Standard: 30000 (30 Sekunden).
capture.task.execution.pool.core-sizeGrundanzahl der Worker-Threads. Standard: 30
capture.task.execution.pool.max-sizeMaximal zulässige Anzahl von Threads unter Last. Standard: 60
capture.task.execution.pool.queue-capacityWarteschlangengröße für ausstehende Aufgaben, bevor neue Threads/Maximalgrenzen greifen. Standard: 300
capture.task.execution.pool.keep-aliveWie lange zusätzliche Threads (über die Kerngröße hinaus) aktiv gehalten werden (oft in Sekunden). Standard: 10
spring.task.scheduling.pool.sizeThread-Pool-Größe für geplante Spring-Aufgaben (@Scheduled), getrennt vom benutzerdefinierten Ausführungspool. Standard: 10

Parallelitätslimits & Agentenintervalle

ParameterBeschreibung
capture.limit.parallel.diffMaximale Anzahl paralleler Diff-Jobs. Standard: 10
capture.limit.parallel.snapshotMaximale Anzahl paralleler Snapshot-Jobs. Standard: 4
capture.interval.diff.populator.agentDiff-Populator-Agent-Intervall (ms). Standard: 300000
capture.interval.diff.worker.agentDiff-Worker-Agent-Intervall (ms). Standard: 300000
capture.interval.snapshot.populator.agentSnapshot-Populator-Agent-Intervall (ms). Standard: 300000
capture.interval.snapshot.worker.agentSnapshot-Worker-Agent-Intervall (ms). Standard: 300000
capture.interval.deployment.worker.agentDeployment-Worker-Agent-Intervall (ms). Standard: 300000
capture.interval.cleanup.worker.agentCleanup-Worker-Agent-Intervall (ms). Standard: 300000
capture.interval.diff.status.agentDiff-Status-Agent-Intervall (ms). Standard: 30000
capture.interval.snapshot.status.agentSnapshot-Status-Agent-Intervall (ms). Standard: 30000

Watchdog

ParameterBeschreibung
capture.watchdog.external-internalWählt zwischen internem und externem Watchdog-Modus. Für On-Premise: INTERNAL
capture.watchdog.snapshot-intervalSnapshot-Watchdog-Intervall (ms). Standard: 1800000
capture.watchdog.diff-intervalDiff-Watchdog-Intervall (ms). Standard: 1800000

AWS-Integration (bei On-Premise standardmäßig deaktiviert)

ParameterBeschreibung
spring.cloud.aws.sqs.enabledDeaktiviert die automatische Konfiguration/Integration von AWS SQS bei Einstellung auf false.
spring.cloud.aws.sns.enabledDeaktiviert die automatische Konfiguration/Integration von AWS SNS bei Einstellung auf false.
cloud.aws.region.autoDeaktiviert die automatische Regionserkennung bei Einstellung auf false.
cloud.aws.region.staticLegt die AWS-Region explizit fest. Standard: eu-central-1 (Frankfurt).

Server-Lebenszyklus & Fehlerbehandlung

ParameterBeschreibung
server.shutdownAktiviert das ordnungsgemäße Herunterfahren bei Einstellung auf graceful (nimmt keine neuen Anfragen mehr an und schließt laufende Vorgänge ab).
spring.lifecycle.timeout-per-shutdown-phaseZulässige Zeit pro Abschaltphase, bevor ein erzwungenes Beenden ausgelöst wird. Standard: 3s
server.error.include-messageNimmt Ausnahme/Meldung in Fehlerantworten auf (hilfreich beim Debuggen, kann aber in der Produktion Details preisgeben).

Systemeinstellungen in der App

3C-Bildschirm Systemeinstellungen mit der Anzahl interner Agenten für Snapshots, Diffs, Deployments und Cleanup
Der In-App-Bildschirm Systemeinstellungen – Anzahl interner Agenten für Snapshots, Diffs, Deployments und Cleanup.

Neben den Properties-Dateien kann ein SUPERUSER mehrere Laufzeitparameter über die In-App-Maske Systemeinstellungen anpassen.

Warnung. Dieser Bildschirm ist nur mit einem Benutzer mit der Rolle SUPERUSER zugänglich. Das Ändern dieser Werte kann die Leistung und Stabilität des 3C Release Manager und der verbundenen externen Systeme beeinträchtigen. Bitte wenden Sie sich vor der Änderung dieser Zahlen an den technischen Support von Tricise für den 3C Release Manager.

Interne Agenten

  • Snapshot-Agenten: die Anzahl der Agenten, die parallel an einem neuen Snapshot arbeiten. Zu viele Agenten können das verbundene externe System verlangsamen und bedeuten eine höhere Ressourcennutzung auf dem 3C-Server. Auf älteren Servern mit begrenzten CPU- und Speicherressourcen raten wir zu einer geringeren Agentenanzahl.
  • Snapshot-Status-Agenten: empfohlen wird der Wert 1.
  • Snapshot-Populator-Agenten: empfohlen wird der Wert 1.
  • Diff-Agenten: die Anzahl der Agenten, die parallel an einem neuen Diff arbeiten. Zu viele Agenten erfordern mehr Ressourcen auf dem 3C-Server. Auf älteren Servern mit begrenzten CPU- und Speicherressourcen raten wir, eine geringere Anzahl von Agenten zu verwenden.
  • Diff-Status-Agenten: empfohlen wird der Wert 1.
  • Diff-Populator-Agenten: empfohlen wird der Wert 1.
  • Deployment-Agenten: empfohlen wird der Wert 1.
  • Cleanup-Agenten: empfohlen wird der Wert 1.

Externe Agenten

Wird in On-Premise-Versionen nicht verwendet.

Standardanmeldeinformationen

Nach der Installation des 3C Release Manager lautet der Standard-Superuser:

  • Benutzername: super
  • Passwort: super
Sofort ändern. Ändern Sie immer das Standardpasswort des Superusers sofort nach der ersten Anmeldung.

4 · Bedienung

Bedienung — Arbeiten mit dem 3C Release Manager

Nach Installation und Konfiguration des 3C Release Manager folgt der typische Workflow im 3C Release Manager dieser Struktur: Mandanten → Benutzer → Umgebungen → Snapshots → Diffs → User Stories → Deployments. In den folgenden Abschnitten werden die einzelnen Funktionsbereiche beschrieben, wie sie in der Weboberfläche angezeigt werden.

Layout & Navigation

Das allgemeine Layout des 3C Release Manager besteht aus folgenden Modulen: Hauptmenü, Benutzer-Symbolleiste, Tabellen und Inhalte.

Hauptlayout

Hauptlayout der 3C-Weboberfläche mit nummerierten UI-Elementen 1 bis 12
Die Weboberfläche des 3C Release Manager – Menüleiste, Benutzer-Symbolleiste, Seitentitel, Aktionsschaltflächen, Listenfilter, Inhalt und Paginierung.

Die Weboberfläche des 3C Release Manager enthält die folgenden Elemente:

  1. Menüleiste
  2. Benutzer-Symbolleiste
  3. Seitentitel
  4. Aktionsschaltflächen der Seite
  5. Informationen und Hilfe
  6. Inhaltliche Sonderaktionen
  7. Filtersteuerung für Listen
  8. Listeninhalt
  9. Paginierung
  10. Listeneinträge — in der Regel öffnen die Felder ID und Titel die Detailansicht
  11. Aktionen für Listeneinträge, z. B. Bearbeiten, Löschen
  12. Steuerung der Anzahl angezeigter Datensätze

Benutzer-Symbolleiste

Profil-Untermenü der 3C-Benutzer-Symbolleiste mit den Einträgen Angemeldet als SUPER und Abmelden
Ein Klick auf das Profilsymbol oben rechts öffnet das Benutzermenü mit „Angemeldet als Benutzername“ und „Abmelden“.

Wenn Sie auf das kleine Profilsymbol oben rechts auf dem Bildschirm klicken, öffnet sich das Benutzermenü. Der erste Menüpunkt öffnet das Mein Profil anpassen.

Menü

3C-Hauptmenüstruktur mit geöffnetem Untermenü Administration, das Mandanten, Benutzer, Systemeinstellungen, Git-Einstellungen, Audit-Protokoll und Lizenz-Einstellungen anzeigt
Das 3C-Hauptmenü – Home, Umgebungen, Snapshots, Diffs, Deployments, User Stories und das Untermenü Administration.

Die Menüstruktur des 3C Release Manager ist wie folgt aufgebaut:

  • Home: diese Schaltfläche bringt Sie zurück zur Startseite des 3C Release Manager.
  • Umgebungen: navigiert zur Seite „Umgebungsliste“, um die Liste der verbundenen Umgebungen anzuzeigen oder neue Verbindungen zu erstellen.
  • Snapshots: navigiert zur Snapshot-Liste, um die Liste der vorhandenen Snapshots anzuzeigen oder neue zu erstellen.
  • Diffs: navigiert zur Diff-Liste, um die Liste der bestehenden Diffs anzuzeigen oder neue zu erstellen.
  • Deployments: navigiert zur Seite „Deployment-Pakete“, um die Liste vorhandener Deployment-Pakete anzuzeigen oder neue zu erstellen.
  • User Stories: navigiert zur Seite „User-Story-Liste“, um die vorhandenen User Stories anzuzeigen oder neue zu erstellen.
  • Administration:
    • Mandanten: nur sichtbar für den SUPERUSER
    • Benutzer: navigiert zur Seite „Benutzerliste“, um Benutzer zu verwalten
    • Systemeinstellungen: systemweite Parameter
    • GIT-Einstellungen: Git-Repository-Konfiguration
    • Audit-Protokoll: navigiert zur Seite „Audit-Protokoll“, um Informationen zum Audit-Trail anzuzeigen
    • Lizenz-Einstellungen: ein Bildschirm zur Verwaltung des Lizenzschlüssels
    • Über: navigiert zur Seite „Über“, um zusätzliche Anwendungsinformationen anzuzeigen

Die Sichtbarkeit der Menüpunkte hängt von den tatsächlichen Rollen des angemeldeten Benutzers ab (siehe Rechte und Rollen).

Anmelden & Abmelden

Anmeldung

3C-Anmeldebildschirm mit Feldern für Benutzername und Passwort sowie dem Kontrollkästchen „Angemeldet bleiben“
Der 3C-Anmeldebildschirm – Benutzername, Passwort und das optionale Kontrollkästchen „Angemeldet bleiben“.

Beim Aufrufen der korrekten URL der Anwendung werden die Benutzer zuerst aufgefordert, sich auf dem Anmeldebildschirm anzumelden. Die benötigten Anmeldedaten sind:

  • Benutzername
  • Password

Durch Auswahl der Option Angemeldet bleiben wird der Benutzername für spätere Anmeldeversuche gespeichert. Nach erfolgreicher Anmeldung werden die Benutzer zur Startseite des 3C Release Manager weitergeleitet.

Hinweis. Das System bietet keine Möglichkeit zur Selbstregistrierung. Verwenden Sie zur Erstellung neuer Benutzer den bereitgestellten Administratorbenutzer und erstellen Sie die erforderlichen Benutzer manuell.

Abmeldung

3C-Benutzer-Symbolleiste mit Abmelde-Aktion
Die Abmelde-Aktion in der Benutzer-Symbolleiste – ein Klick darauf leitet zum Anmeldebildschirm weiter.

Um sich von der Anwendung abzumelden, klicken Benutzer auf die Aktion Abmeldung in der Benutzer-Symbolleiste. Das Abmelden leitet zum Anmeldebildschirm weiter.

Mein Profil

Mein Profil

3C-Seite Mein Profil mit den Abschnitten Hauptdaten, Passwort ändern und Meine Rollen
Die Profilseite – Bereiche Hauptdaten, Passwort ändern und Meine Rollen.

Die Seite „Mein Profil“ ist in drei Abschnitte unterteilt:

  • Bereich Hauptdaten: die wichtigsten persönlichen Daten — Benutzername (LoginID), Vorname, Nachname, E-Mail-Adresse.
  • Bereich Passwort ändern: bietet die Möglichkeit, das aktuelle Passwort zu ändern.
  • Bereich Meine Rollen: Informationen über die aktuellen Rollen des angemeldeten Benutzers. Die Rollen können nur über den Bildschirm Benutzerdetails in der Benutzerliste von einem Benutzer mit der Rolle „Benutzeradministrator“ geändert werden.

Seite „Mein Profil“ aufrufen

Untermenü des Kontosymbols in der 3C-Benutzer-Symbolleiste mit dem Eintrag Angemeldet als SUPER
Rufen Sie die Seite „Mein Profil“ auf, indem Sie das Kontosymbol auswählen und auf „Angemeldet als Benutzername“ klicken.

Benutzer können zur Seite Mein Profil navigieren, um persönliche Informationen einzusehen und zu bearbeiten oder ihr aktuelles Passwort zu ändern. Um auf die Seite Mein Profil zuzugreifen, wählen Sie das Kontosymbol in der Benutzer-Symbolleiste aus und klicken Sie auf die Aktion Angemeldet als Benutzername .

Persönliche Daten bearbeiten

3C-Formular Hauptdaten in Mein Profil mit bearbeitbaren Feldern für Vorname, Nachname und E-Mail
Persönliche Daten bearbeiten — Vorname, Nachname und E-Mail-Adresse ändern. Die LoginID ist schreibgeschützt.

Benutzer können ihre persönlichen Daten auf der Seite „Mein Profil“ bearbeiten, indem sie die eingegebenen Informationen ändern:

  • Vorname
  • Nachname
  • E-Mail-Adresse
Hinweis. Der Benutzername (LoginID) kann von Endbenutzern nicht geändert werden.

Nach der Bearbeitung auf die Schaltfläche Speichern klicken. Nach erfolgreichem Speichern wird eine Benachrichtigung angezeigt.

3C-Benachrichtigung „Profil aktualisiert“
Nach dem Speichern erscheint die Benachrichtigung „Profil aktualisiert“.

Passwort ändern

Benutzer haben die Möglichkeit, auf der Seite „Mein Profil“ ihr aktuelles Passwort zu ändern, indem sie:

  • Das aktuelle Passwort eingeben
  • Das neue Passwort eingeben
  • Das neue Passwort im Feld „Passwort bestätigen“ erneut eingeben
  • Auf die Schaltfläche Passwort ändern klicken

Nach erfolgreicher Passwortänderung wird eine Benachrichtigung angezeigt.

3C-Benachrichtigung „Passwort geändert“
Nach dem Ändern des Passworts erscheint die Benachrichtigung „Passwort geändert“.

Administration

Dieser Abschnitt enthält alle administrativen Funktionen und Einstellungsmöglichkeiten des 3C Release Manager: Mandanten, Benutzer, Systemeinstellungen, Git-Einstellungen, Audit-Protokoll, Lizenz-Einstellungen. Um auf diese Funktionen zugreifen zu können, sind erhöhte Administratorrollen erforderlich.

Mandanten

3C-Mandantenliste mit dem Mandanten DEFAULT und Lizenzinformationen
Die Mandantenliste – Mandant DEFAULT mit Lizenzstatus und lizenzierten Modulen.

Mandanten sind spezielle Container in 3C, die bestimmte Unternehmen oder Abteilungen darstellen. Sie sind nur für Benutzer mit der Rolle SUPERUSER zugänglich. Für die SaaS-Version sind diese Einstellungen für Benutzer nicht zugänglich. Für die On-Premise-Version wird empfohlen, den DEFAULT-Mandanten zu verwenden, und allgemeine Administratorbenutzer sollten unter diesem Mandanten erstellt werden.

Mandantenliste. Zeigt die aktuell im System verfügbaren Mandanten an. Der Mandant DEFAULT kann nicht gelöscht werden.

Funktionen:

  • Aktualisieren: aktualisiert die aktuelle Listenansicht
  • Neuer Mandant: navigiert zum Bildschirm Mandant erstellen
  • Info: zeigt das Informationsfenster an

Felder:

  • ID: technisch generierte ID
  • Name: der Titel des Mandantendatensatzes
  • Lizenz: aktiv oder inaktiv, basierend auf den Lizenzeinstellungen
  • Lizenzierte Module: Clarity, Automic oder beides, basierend auf den Lizenzeinstellungen
  • Erstellt am: Erstellungszeitpunkt des Datensatzes
  • Bearbeiten: navigiert zum Bildschirm Mandantendetails
  • Löschen: löscht den Mandanten

Mandant erstellen. Erforderliche Felder: Mandantenname (muss eindeutig sein), Beschreibung (Freitext). Nach der Erstellung können Benutzer im Mandanten nur auf Objekte desselben Mandanten zugreifen. Dies trennt sie von den Objekten anderer Mandanten.

3C-Bildschirm Mandant erstellen mit den Feldern Mandantenname und Beschreibung
Der Bildschirm Mandant erstellen – erforderlicher Mandantenname und Beschreibung als Freitext.

Mandant bearbeiten. Der Benutzer kann die Details des Mandanten einsehen und einige seiner Attribute ändern. Felder: Mandanten-ID (schreibgeschützt), Mandantenname, Beschreibung, Erstellt von, Erstellt am. Funktionen: Abbrechen, Speichern.

3C-Bildschirm Mandant bearbeiten mit den Abschnitten Hauptdaten, Lizenzdaten und Nutzungsdaten
Der Bildschirm Mandant bearbeiten – Hauptdaten (Mandanten-ID schreibgeschützt, Name und Beschreibung bearbeitbar), Lizenzdaten und Nutzungsdaten.

Benutzer

3C-Benutzerliste mit LoginIDs, Namen, E-Mail-Adressen, Mandanten und Aktiv-Status
Benutzerliste — LoginID, Name, E-Mail, Mandantenzuweisung und aktiver Status.

Benutzer stellen Anmeldekonten im System dar. Die Verwaltungsbildschirme ermöglichen die Verwaltung von Benutzerdetails, Passwörtern und Rollen.

Felder der Benutzerliste:

  • LoginID: die ID des Benutzers, die für die Anmeldung bei 3C verwendet wird
  • Name: der tatsächliche Name des Benutzers
  • E-Mail: die E-Mail-Adresse des Benutzers
  • Mandant: der Mandant, dem der Benutzer zugeordnet ist
  • Aktiv: zeigt an, ob der Benutzer aktiv ist (sich im System anmelden kann)
  • Erstellt am: Erstellungszeitpunkt des Benutzers
  • Bearbeiten / Löschen

Felder beim Erstellen eines Benutzers: LoginID (erforderlich, eindeutig), Vorname (erforderlich), Nachname (erforderlich), E-Mail (erforderlich), Aktiv (standardmäßig deaktiviert – nur aktive Benutzer können sich anmelden), Passwort (initial), Passwort bestätigen. Die Rollen des Benutzers können erst nach der Erstellung festgelegt werden.

3C-Bildschirm Benutzer erstellen mit allen erforderlichen Feldern
Der Bildschirm Benutzer erstellen – LoginID, Namen, E-Mail, Aktiv-Flag und initiales Passwort. Rollen können erst nach der Erstellung festgelegt werden.

Benutzer bearbeiten. Der Benutzer kann Details einsehen und einige Attribute ändern, das Passwort wechseln oder aktive Rollen ändern. Die LoginID kann nach der Erstellung nicht mehr geändert werden.

3C-Bildschirm Benutzer bearbeiten mit den Bereichen Hauptdaten, Passwortänderung und aktive Rollen
Der Bildschirm Benutzer bearbeiten – Hauptdaten, Passwortänderung und Zuweisung aktiver Rollen. Die LoginID kann nicht geändert werden.

Verfügbare Rollen:

  • USER_USER: kann auf die Benutzerliste und die Details des Benutzers zugreifen
  • USER_MANAGER: kann auf die Benutzerliste zugreifen, kann Benutzer löschen, kann neue Benutzer erstellen, kann Benutzer bearbeiten
  • ENVIRONMENT_USER: kann auf die Umgebungsliste und die Details der Umgebung zugreifen
  • ENVIRONMENT_MANAGER: kann auf die Umgebungsliste zugreifen, Umgebungen löschen, neue Umgebungen erstellen, Details von Umgebungen bearbeiten (einschließlich Verbindungseinstellungen, Passwort, Filter, Git-Einstellungen)
  • SCHEDULE_USER: kann auf die geplanten Snapshots der Umgebung zugreifen
  • SCHEDULE_MANAGER: kann auf die geplanten Snapshots der Umgebung zugreifen und diese ändern, sie löschen oder neue erstellen
  • SNAPSHOT_USER: kann auf die Snapshot-Liste und die Details des Snapshots zugreifen
  • SNAPSHOT_MANAGER: kann die Snapshot-Liste aufrufen, kann Snapshots löschen, kann einen neuen Snapshot starten, kann Metadaten von Snapshots bearbeiten
  • DIFF_USER: kann auf die Diff-Liste und die Details des Diffs zugreifen
  • DIFF_MANAGER: kann auf die Diff-Liste zugreifen, bestehende Diffs löschen, einen neuen Diff erstellen, die Metadaten eines Diffs bearbeiten
  • DEPLOYMENT_USER: kann auf die Deployment-Liste zugreifen und die Details des Deployments, einschließlich der Ausführungen, einsehen
  • DEPLOYMENT_MANAGER: kann die Deployment-Liste einsehen, bestehende Deployments löschen, neue Deployments erstellen, neue Deployment-Prozesse starten, deren Inhalte bearbeiten
  • USER_STORY_USER: kann auf die User-Story-Liste und die Details der User Stories zugreifen
  • USER_STORY_MANAGER: kann auf User Stories zugreifen und sie ändern, vorhandene User Stories löschen, neue erstellen, deren Inhalte bearbeiten
  • SUPERUSER: kann auf jede Funktion in 3C zugreifen, Mandanten bearbeiten, neue Lizenzschlüssel festlegen

Git-Einstellungen

3C-Konfigurationsbildschirm für die Git-Einstellungen auf Mandantenebene
Mandantenweite Git-Einstellungen — Repository-URL, Anmeldeinformationen oder SSH-Schlüssel und Verbindungstest.

Diese Einstellungen sind erforderlich, um die Konfiguration des verbundenen Systems mit einem externen Git-Repository zu synchronisieren. Es handelt sich um einen globalen, mandantenbasierten Parameter. Um eine Verbindung zu einem Git-Repository herzustellen, muss der Benutzer die URL des Repositorys sowie die Anmeldeinformationen eines technischen Benutzers mit der Berechtigung, in dieses Repository zu committen und zu pushen, festlegen. Alternativ kann ein SSH-Schlüssel verwendet werden.

Felder:

  • Git-Repository-URL: die URL des Repositories
  • Verbindungstyp: Anmeldeinformationen oder SSH
  • Anmeldeinformationen: Benutzername, Passwort, Passwort bestätigen
  • SSH: privater SSH-Schlüssel, den der Git-Anbieter verlangt
  • Verbunden: nach der Erstellung oder Änderung versucht der 3C Release Manager, mit diesen Einstellungen eine Verbindung zum Repository herzustellen, und meldet zurück, ob die Verbindung funktioniert

Funktionen: Speichern speichert die geänderten Werte; Verbindung testen versucht, sich mit den aktuellen Einstellungen mit dem Repository zu verbinden.

Audit-Protokoll

3C-Audit-Protokolltabelle mit Zeitstempeln, Protokollebenen und Modulen
Das Audit-Protokoll — Protokoll-ID, Anmelde-ID, Level (INFO/WARNING/ERROR), Zeitstempel, Nachricht und Modul.

Diese Tabelle enthält eine repräsentative Liste der wichtigen Ereignisse und der im System durchgeführten Aktionen für Audit-Zwecke und die Fehlerverfolgung.

Felder:

  • Protokoll-ID: technisch generierte ID
  • Login-ID: die ID des zugehörigen Benutzers
  • Protokollebene: die Ebene der Nachricht (INFO, WARNING, ERROR)
  • Protokollzeit: der Zeitstempel der Nachricht
  • Protokollnachricht: die eigentliche Nachricht
  • Modul: der Name des Systemmoduls, von dem die Nachricht stammt

Lizenz-Einstellungen

3C-Bildschirm Lizenz-Einstellungen mit Gültigkeit, Ablaufdatum und lizenzierten Modulen
Der Bildschirm mit den Lizenz-Einstellungen — Gültigkeit, Inhaber, Ablaufdatum, Umgebungslimit und lizenzierte Module.

Auf diesem Bildschirm kann der Administrator den aktuellen Lizenzschlüssel überprüfen und ändern.

Felder:

  • Lizenz ist gültig: true, wenn die Lizenz für diese Instanz gültig und aktiv ist
  • Lizenziert für: der Inhaber der Lizenz
  • Lizenz ist gültig bis: das Ablaufdatum der Lizenz
  • Maximal zulässige Umgebungsanzahl: die Höchstzahl der Umgebungen, die mit dieser Lizenz verwaltet werden können
  • Lizenzierte Module: die Liste der externen Systeme, die mit 3C verwaltet werden können (CLARITY, AUTOMIC oder beides)
  • Lizenzschlüssel ändern: der Benutzer kann einen neuen Lizenzschlüssel hinzufügen
  • Schaltfläche Lizenzschlüssel ändern: ersetzt den Lizenzschlüssel durch den neu angegebenen
Hinweis. Die Verwendung falscher Lizenzschlüssel kann 3C unbrauchbar machen. Verwenden Sie nur die von Tricise bereitgestellten Schlüssel.

Umgebungen

Umgebungen sind Verbindungen zu Automic- (oder Clarity-)Instanzen. Sie werden für jede Analyse, jeden Snapshot und jedes Deployment benötigt. Eine erfolgreiche Umgebungsverbindung liefert außerdem eine Liste der verfügbaren Objekte einer Instanz als Übersicht auf oberster Ebene.

Umgebungsliste

3C-Umgebungsliste mit Typ, Host, Client, Verbindungsstatus und Snapshot-Zeitstempeln
Die Umgebungsliste – Verbindungen mit Typ, Host, Client, Verbindungsstatus und Zeitstempeln für den letzten/nächsten Snapshot.

Die Umgebungsliste zeigt die erstellten Clarity PPM- und Automic-Verbindungen sowie zusätzliche Details dazu an und bietet gleichzeitig die Möglichkeit, Elemente zu erstellen, zu bearbeiten oder zu löschen.

Funktionen: Aktualisieren, Neue Umgebung, Info.

Filter: Produktfilter (nur sichtbar, wenn Ihre Lizenz für Automic und Clarity gültig ist).

Felder:

  • ID: eindeutiger Bezeichner des Umgebungsverbindungsdatensatzes. Automatisch vom System generiert.
  • Titel: Name der Umgebungsverbindung, der vom Benutzer, der sie erstellt hat, vergeben wurde.
  • Host: Adresse des Servers, auf dem die externe Anwendung läuft.
  • Client: nur sichtbar für Automic-Instanzen.
  • Typ: der Verwendungstyp der Umgebung, z. B. DEVELOPMENT, TEST, PRODUCTION usw.
  • Datenbank: der DB-Anbieter des externen Systems. Nur sichtbar für Clarity-Umgebungen.
  • Initialisiert: zeigt an, ob die notwendigen Abfragen bereits im System installiert sind. Nur sichtbar für Clarity-Umgebungen.
  • Verbunden: zeigt an, ob die Anmeldeinformationen und Verbindungseinstellungen korrekt sind und 3C auf das System zugreifen kann.
  • Letzter Snapshot: der Zeitstempel des letzten erfolgreichen Snapshots, der für das System generiert wurde.
  • Nächster Snapshot: das Datum des nächsten geplanten Backup-Snapshots für das System.
  • Anzeigen: navigiert zum Bildschirm Umgebungsdetails.
  • Löschen: löscht die Umgebung.
Warnung. Das Löschen einer Umgebung löscht auch alle zugehörigen Snapshots und Diffs.

Umgebung erstellen

3C-Bildschirm Umgebung erstellen mit Systemparametern und Anmeldeinformationen
Der Bildschirm Umgebung erstellen — Systemparameter, Serveradressen, Zertifikat und Anmeldedaten des technischen Benutzers.

Erstellen Sie einen Umgebungsdatensatz, um die Verbindungsdetails zu speichern, die für die Erstellung von Snapshots verwendet werden. Wenn Sie sowohl über Clarity- als auch über Automic-Lizenzen verfügen, müssen Sie zuerst den Produkttyp auswählen.

Systemparameter:

  • Titel: kurze Kennung der Umgebung. Dieser Titel erscheint auch auf anderen Seiten. Er sollte möglichst eindeutig sein.
  • Serveradressen: Adresse der Automic-Umgebung im URL:PORT Format, ohne http oder https. Ports können über Bereiche (xyurl:10-20) oder Kommas (yyurl:1,2,3) hinzugefügt werden. Verwenden Sie die + Schaltfläche zum Hinzufügen neuer Datensätze zu den Verbindungseinstellungen für verschiedene Hostnamen.
  • Umgebungstyp: der Nutzungstyp. Werte: DEVELOPMENT, TEST, MIGRATION, PRODUCTION.
  • Umgebungszertifikat: Der 3C Release Manager benötigt das Verbindungszertifikat. Kopieren Sie den Text in dieses Feld aus der .cert Datei, einschließlich der —–BEGIN CERTIFICATE—– und —–END CERTIFICATE—– Zeilen.
Wichtig. Der 3C Release Manager wird die erste funktionierende URL verwenden und versuchen, sie auch das nächste Mal zu verwenden. Wenn Sie Verbindungszeichenfolgen zu verschiedenen Automic-Instanzen hinzufügen, können die Snapshot-Daten in Zukunft inkonsistent sein.

Anmeldeinformationen:

  • Client-Nummer: die Client-Nummer des technischen Benutzers in Automic.
  • Benutzername: der Benutzername des technischen Benutzers, z. B. UC. Der 3C Release Manager kann nur die Objekte aus Automic herunterladen oder bereitstellen, auf die der technische Benutzer Zugriff hat.
  • Abteilung: die Fachabteilung des technischen Benutzers.
  • Passwort speichern: empfohlen. Sie können 3C auch ohne diese Option verwenden, aber dann werden Sie vor jeder Verbindungsanforderung vor der Erstellung eines Snapshots oder Deployments aufgefordert, das Passwort einzugeben.
  • Passwort: das Passwort des technischen Benutzers.
  • Beschreibung: Freitextfeld für zusätzliche Informationen zur Umgebungsverbindung.

Umgebung bearbeiten

Sobald eine Umgebungsverbindung erstellt und gespeichert wurde, kann sie von der Seite „Umgebungsliste“ aus geöffnet und jede zugehörige Einstellung geändert werden. Ein Klick auf den Titel der Verbindung auf der Listenübersichtsseite öffnet die Seite „Umgebung bearbeiten“. Die Seite „Umgebung bearbeiten“ hat mehrere Registerkarten:

  • Basis: allgemeine Informationen zur Umgebungsverbindung
  • Verbindung: Indikatoren für den Verbindungsstatus
  • Anmeldeinformationen: Möglichkeit, das Login-Passwort der Verbindung zu ändern
  • Geplante Aufträge: Einstellungen zur automatischen Erzeugung von Backup-Snapshots für die Umgebung
  • Gespeicherte Filter: benutzerdefinierte Objektfilter — nur für Automic
  • Filter: Möglichkeit, bestimmte Elemente in die Snapshots einzuschließen oder auszuschließen — nur für Clarity
  • Objekte: Liste identifizierter Objekte
  • Git-Einstellungen: um die Git-Synchronisierung für diese Umgebung einzurichten
  • Deployment-Regeln: Regeln für automatisierte Deployment-Skripte — nur für Automic

Basisbildschirm

3C-Bildschirm Umgebung bearbeiten, Registerkarte Basis mit Verbindungsmetadaten
Die Registerkarte „Basis“ — Titel, Serveradressen, Umgebungstyp, Client-Nummer, Benutzername, Abteilung und Beschreibung.

Die grundlegenden Verbindungseinstellungen und Metadaten für die Umgebung. Gleiche Felder wie bei Umgebung erstellen (Titel, Serveradressen, Umgebungstyp, Client-Nummer, Benutzername, Abteilung, Beschreibung). Funktionen: Abbrechen, Speichern.

Verbindungsbildschirm

3C-Bildschirm Umgebung bearbeiten, Registerkarte Verbindung mit Verbindungsstatusanzeigen
Die Registerkarte „Verbindung“ — Flag Verbunden, Fehlermeldung, Initialisierungsstatus und REST-Verbindungsstatus.

Zeigt an, ob die Verbindungseinstellungen korrekt sind.

Felder:

  • Verbunden: true, wenn die Verbindung in Ordnung ist
  • Verbindungsfehler: enthält die Fehlermeldung während der Verbindungsanforderung, falls vorhanden (nur für Automic)
  • Initialisiert: gibt an, ob die Verbindung ordnungsgemäß hergestellt wurde und die Anwendung zumindest einmal eine Verbindung zur Clarity-PPM-Instanz herstellen konnte (nur für Clarity)
  • REST-Verbindung: gibt an, ob die REST-API für 3C zugänglich ist (nur für Automic)

Funktionen:

  • Verbindungsprüfung: aktualisiert den Verbindungsstatus
  • Neu initialisieren / Initialisieren: führt in der Umgebung die Abfrageskripte aus, die für den Betrieb des 3C Release Manager erforderlich sind (nur für Clarity)

Bildschirm Anmeldedaten

3C-Bildschirm Umgebung bearbeiten, Registerkarte Anmeldedaten mit Option zum Speichern des Passworts
Die Registerkarte „Anmeldedaten“ — Schalter Passwort speichern und Passwortfeld mit Zertifikatsdialog.

Felder: Passwort speichern (empfohlen), Password (das Passwort des technischen Benutzers). Funktionen: Änderungen speichern (speichert das neue Passwort und versucht, eine Verbindung zum externen System herzustellen), Neu hinzufügen (öffnet ein Dialogfenster, in dem der Benutzer das Zertifikat der Verbindung festlegen kann).

Bildschirm für geplante Aufträge

3C-Bildschirm Umgebung bearbeiten, Liste Geplante Jobs mit Aktiv-Flag, Auto-Diffs und nächstem Lauf
Die Liste der geplanten Aufträge – Titel, Aktiv-Flag, Auto-Diffs, letzter/nächster Lauf und Laufanzahl.

Zeigt die Liste der geplanten Snapshot-Jobs für diese Umgebung an. Der 3C Release Manager startet zu den hier angegebenen Zeiten automatisch einen neuen Snapshot, um eine Sicherung der Konfiguration zu erstellen.

Felder:

  • Titel des Zeitplans: Freitext-Titel
  • Aktiv: der Job wird nur ausgeführt, wenn das Flag Active auf true gesetzt ist
  • Auto-Diffs: wenn auf true gesetzt, erstellt 3C zusätzlich automatisch eine Diff-Analyse im Vergleich zum letzten geplanten Snapshot
  • Letzter Lauf: der Zeitstempel des letzten Job-Laufs
  • Nächster Lauf: der nächste geplante Ausführungszeitpunkt des Jobs
  • Durchläufe: wie oft der Job bereits erfolgreich gelaufen ist
  • Einzelheiten: navigiert zum Bildschirm Zeitplan bearbeiten
  • Löschen: löscht den geplanten Job

Funktionen: Zeitplan erstellen (navigiert zum Bildschirm Neuer Zeitplan).

Bildschirm für geplante Aufträge — Neuer Zeitplan

3C-Dialog Neuer Zeitplan mit Titel, Sicherungszeit, Zeitzone und Häufigkeitseinstellungen
Das Dialogfeld „Neuer Zeitplan“ – Titel, Beschreibung, Auto-Diffs, Filter, Startzeit der Sicherung (HH:MM), Zeitzone und Häufigkeit (Täglich/Wöchentlich/Monatlich/Jährlich).

Verwenden Sie diese Seite, um einen neuen geplanten Snapshot-Job für die Umgebung zu definieren.

Felder:

  • Titel: erforderlicher Name als Freitext
  • Beschreibung: Feld für Freitextbeschreibung
  • Auto-Diffs: wenn aktiviert, löst jeder Snapshot automatisch auch einen Diff-Analysejob aus, der die aktuelle Konfiguration mit dem zuletzt gespeicherten Zustand vergleicht
  • Filter: optional — ist er nicht gesetzt, wird ein vollständiger Snapshot erstellt
  • Startzeit der Sicherung: HH:MM Format. Der Job beginnt zur angegebenen Zeit.
  • Zeitzone: Stellen Sie die Zeitzone für die Startzeit der Sicherung ein
  • Planungshäufigkeit: Legen Sie die Häufigkeit fest. Folgende Optionen stehen zur Verfügung:
    • Täglich: der Job wird jeden Tag zur angegebenen Zeit gestartet
    • Wöchentlich: Legen Sie die Wochentage fest, an denen der Job starten soll
    • Monatlich: Legen Sie die Tage des Monats fest, an denen der Job beginnen soll
    • Jährlich: Legen Sie die Tage des Jahres fest, an denen der Job beginnen soll

Funktionen: Abbrechen (kehrt ohne Änderungen zur Liste der Zeitpläne zurück), Speichern (erstellt den neuen geplanten Job).

Bildschirm für geplante Aufträge — Zeitplan bearbeiten

3C-Dialog Zeitplan bearbeiten mit denselben Feldern wie Neuer Zeitplan
Der Dialog „Zeitplan bearbeiten“ — dieselben Felder wie bei „Neuer Zeitplan“, wird verwendet, um einen bestehenden geplanten Job zu ändern.

Verwenden Sie diese Seite, um einen geplanten Snapshot-Job für die Umgebung zu ändern. Die Felder sind identisch mit dem Bildschirm „Neuer Zeitplan“: Titel, Beschreibung, Auto-Diffs, Filter, Startzeit der Sicherung (HH:MM), Zeitzone und Häufigkeit der Zeitplanung (Täglich, Wöchentlich, Monatlich, Jährlich). Funktionen: Abbrechen, Speichern.

Bildschirm für gespeicherte Filter (nur Automic)

3C-Liste der gespeicherten Filter für eine Automic-Umgebung
Die Liste der gespeicherten Filter – wiederverwendbare Objektfilter, die aus benutzerdefinierten Snapshots erstellt wurden.

Verwenden Sie diese Seite, um die gespeicherten Filter für die Umgebung zu verwalten. Wenn der Benutzer einen benutzerdefinierten Snapshot erstellen möchte, gibt es eine Option, den aktuell verwendeten Filter für die spätere Verwendung zu speichern. Dieser Bildschirm zeigt die Liste dieser Filter.

Felder:

  • Titel: der Name des Filters
  • Erstellt von: der Besitzer des Filters
  • Erstellt am: Erstellungsdatum
  • Bearbeiten: navigiert zum Bildschirm „Neuer Snapshot“ mit den geladenen Filtern
  • Löschen: löscht den Filter

Bildschirm Objektliste

3C-Bildschirm Objektliste mit dem Konfigurationskatalog einer Umgebung
Die Objektliste – ein Konfigurationskatalog der Umgebung, der nach jedem Snapshot aktualisiert wird.

Der Objektbildschirm bietet einen allgemeinen Konfigurationskatalog der Umgebung. Nach jedem Snapshot wird diese Liste aktualisiert und kann auch auf diesem Bildschirm manuell aktualisiert werden. Sie dient zwei grundlegenden Zwecken: Erstens können Sie überprüfen, welche Objekte im System verfügbar sind; zweitens können Sie mit der Schaltfläche Verlauf die vorherigen Änderungen am Objekt einsehen.

Hinweis. Wenn ein Objekt aus dem System gelöscht wird, bleibt es aufgrund der früheren Snapshots im Verlauf von 3C erhalten.

Verlaufsansicht

3C-Ansicht Objektverlauf mit Versionsliste und Text-Diff
Die Verlaufsansicht — jede vorherige Version des Objekts links, die tatsächlichen Änderungen als Textunterschied rechts.

Die Verlaufsansicht zeigt links jede frühere Version des Objekts an. Durch Auswahl eines bestimmten Eintrags in der Liste zeigt die rechte Ansicht die tatsächlichen Änderungen an dem Konfigurationselement als Textunterschied an.

Bildschirm Git-Einstellungen

3C-Einstellungen für Git-Sync pro Umgebung mit Branch-Namen und Schalter „Git-Sync aktiviert“
Git-Sync pro Umgebung — Branch-Name und Schalter „Git-Sync aktiviert“.

Wenn das globale Git-Repository korrekt eingerichtet ist, ist diese Seite verfügbar, auf der der Benutzer die Git-Sync-Funktion für die Umgebung aktivieren oder deaktivieren und den Namen des Branches festlegen kann, der im Repository zur Nachverfolgung der Konfigurationen verwendet wird.

Felder:

  • Branch-Name: Dieser Branch wird im Repository erstellt, falls er nicht existiert, und zum Speichern der Konfiguration verwendet.
  • Git-Sync aktiviert: wenn aktiviert, schreibt der 3C Release Manager nach jedem Snapshot die Konfiguration ins Dateisystem und committet und pusht die Änderungen anschließend automatisch in das definierte Git-Repository.
  • Speichern: speichert die Werte im Formular.

Bildschirm Deployment-Regeln (nur Automic)

3C-Editor für Deployment-Regeln pro Umgebung mit der Syntax von AEDB Change
Der Editor für Deployment-Regeln – Regelsatz der Umgebung in der Syntax des Utilitys AEDB Change, mit Validierung.

Der Benutzer kann die Standardregeln für diese Umgebung festlegen, die während des Deployment-Prozesses verwendet werden. Der Textänderungsprozess funktioniert ähnlich wie das Utility AEDB Change – die spezifischen Regeln, die in den Regeldateien verwendet werden können, sind die gleichen wie in der Automic-Dokumentation zu AEDB Change.

Felder:

  • Umgebungsregelsatz: der Text, der die Regeln enthält (jede Zeile ist eine Regel)
  • Validieren: überprüft den Regelsatz und zeigt bei Syntaxfehlern eine Fehlermeldung an
  • Speichern: speichert den Regelsatz für die Umgebung. Immer wenn ein neues Deployment für diese Umgebung definiert wird, wird dieser Regelsatz kopiert und als Standard für das Deployment verwendet.

Filterbildschirm (nur Clarity)

3C-Filterbildschirm (nur Clarity) mit Sprach-, Objekt- und weiteren Filterkategorien
Der Filterbildschirm (nur Clarity) — Sprachfilter, Objektfilter und andere XML-Filter.

Der Benutzer kann spezifische Filter für diese Umgebung festlegen, die beeinflussen, wie die Snapshots für diese Instanz erstellt werden müssen. Es gibt drei Kategorien:

  • Sprachfilter: 3C löscht aus den XML-Dateien jede Zeile, die Labels für die hier herausgefilterten Sprachen enthält
  • Objektfilter: 3C wird nur die Objekttypen in den Snapshot aufnehmen, die in dieser Filterliste aktiviert sind
  • Weitere Filter: spezifische Filter für die XML-Dateien, die Attribute, Tags oder Teile der XML-Dateien herausfiltern, die für die Vergleichsanalyse nicht notwendig sind, wie generierte IDs und dergleichen

Snapshots

Snapshots sind eine der Grundfunktionen des 3C Release Manager. Ein Snapshot ist eine Darstellung der Konfiguration der verwalteten Instanz zu einem bestimmten Zeitpunkt. Der 3C Release Manager verbindet sich mit dem Clarity- oder Automic-System und findet und lädt basierend auf den Filtern und Einstellungen jedes Konfigurationsobjekt vom System. Diese Sätze können benannt und gespeichert werden, um später als Konfigurationshistorie, System-Backup, Grundlage für Differenzanalysen oder als Quelle für ein Deployment-Paket verwendet zu werden.

Inkrementelle Snapshots

Der 3C Release Manager exportiert und speichert die Objekte inkrementell. Immer wenn ein neuer Snapshot gestartet wird, überprüft der 3C Release Manager anhand der Filter und Einstellungen alle Objekte, die im ausgewählten System verfügbar sind. Nur die Elemente werden gespeichert, die sich seit dem letzten gespeicherten Snapshot geändert haben, um die für den Prozess benötigte Zeit und den Datenbankverbrauch zu reduzieren. Der erste Snapshot einer frischen Instanz dauert länger, danach werden die folgenden Snapshots schneller erstellt.

Vollständige und partielle Snapshots

Wenn der Benutzer keine Filter oder Objektauswahl angibt, wird ein vollständiger Snapshot (Full Snapshot) erstellt – jedes Objekt wird heruntergeladen. Es wird empfohlen, die Filter so einzurichten, dass nur die wichtige Konfiguration gespeichert wird, um den Vorgang zu beschleunigen.

Snapshot-Liste

3C-Snapshot-Liste mit Status, Statistiken und Tags
Die Snapshot-Liste – Umgebung, Status (DONE/ERROR/IN_PROGRESS/WAITING), Objektstatistiken und Tags.

Funktionen: Aktualisieren, Snapshot erstellen, Info.

Filter:

  • Quelle: die Umgebung, die die Quelle des Snapshots war
  • Typ: Manuell erstellt, Automatisch generiert, Geplantes Backup, Backup vor Deployment, Deployment-Validierung
  • Datumsbereich: der Startzeitpunkt des Snapshots
  • Suchfeld: Freitextsuche in Titel und Beschreibung

Spezielle Steuerelemente: Das erste Symbol schaltet zwischen der Auswahl von User Stories und der Auswahl von Deployments um. Die Dropdown-Liste zeigt die verfügbaren User Stories oder Deployments zur Verwaltung an; wenn etwas ausgewählt ist, navigiert eine Schaltfläche „Deployment öffnen“ oder „User Story öffnen“ zu dem ausgewählten Element.

Felder:

  • Id: die technische ID des Snapshots
  • Titel: der Titel des Snapshots
  • Umgebung: die Quellumgebung des Snapshots
  • Status: DONE, ERROR, IN_PROGRESS, WAITING
  • Statistik: Gesamtzahl der Objekte in Blau, fehlerhafte Objekte in Rot
  • Tags: benutzerdefinierte oder automatisch erstellte Tags
  • Start: die Startzeit
  • Anzeigen: öffnet den Bildschirm Snapshot-Details
  • Löschen: löscht den Snapshot
  • Ausgewählte Elemente: wenn auf der Seite ein Deployment oder eine User Story ausgewählt ist, zeigt diese Spalte die Anzahl der Objekte an, die aus dem jeweiligen Snapshot zu dieser User Story oder diesem Deployment hinzugefügt wurden

Snapshot erstellen

3C-Bildschirm Snapshot erstellen mit Umgebungsauswahl und Tags
Der Bildschirm „Snapshot erstellen“ – Titel, Quellumgebung, Beschreibung, Tags und Umschalter für benutzerdefinierte Snapshots.

Felder:

  • Snapshot-Titel: erforderlich, automatisch generiert mit einem Standardwert
  • Ausgewählte Umgebung: die Umgebungsverbindung, die als Quelle verwendet wird
  • Beschreibung: Freier Text
  • Tags: manuelle Tags für den Snapshot
  • Benutzerdefinierter Snapshot: wenn nicht aktiviert, startet 3C einen vollständigen Snapshot (Full Snapshot)

Funktionen: Abbrechen, Snapshot starten.

Benutzerdefinierter Snapshot

3C-Konfigurationskatalog für einen benutzerdefinierten Snapshot mit auswählbaren Ordnern und Elementen
Die Ansicht „Benutzerdefinierter Snapshot“ – Konfigurationskatalog mit manueller Ordner-/Elementauswahl und wiederverwendbaren Filtern.

Wenn die Option „Benutzerdefinierter Snapshot“ aktiviert ist, wird der gesamte Konfigurationskatalog für die Umgebung angezeigt, in dem der Benutzer manuell auswählen kann, welche Elemente in den Snapshot aufgenommen werden sollen. Der Benutzer kann Ordner (die Elemente werden rekursiv heruntergeladen) oder einzelne Elemente auswählen. Diese Auswahl kann über die Schaltfläche Neuer Filter als Filter gespeichert werden. Zuvor gespeicherte Filter können über die Auswahl Filter angewendet werden.

Snapshot-Erstellung

3C-Snapshot-Erstellung läuft, mit Fortschrittsbalken
Erstellung von Snapshots läuft — Fortschrittsbalken zeigt Downloadstatus pro Objekt.

Basierend auf den Objekten in der Umgebung, den Filtern und den ausgewählten Elementen des Benutzers kann ein Snapshot länger dauern. Während dieser Zeit zeigt der 3C Release Manager einen Fortschrittsbalken an.

Snapshot-Details

3C-Bildschirm Snapshot-Details mit Metadaten und heruntergeladenen Objekten
Der Bildschirm „Snapshot-Details“ – Metadaten, Status, Statistiken und die heruntergeladenen Konfigurationselemente.

Die Details eines bestimmten Snapshots, einschließlich seiner Metadaten und der heruntergeladenen Konfigurationselemente.

Metadaten: Snapshot-ID (schreibgeschützt), Umgebung (schreibgeschützt), Snapshot-Titel (erforderlich), Status, Startzeit, Endzeit, Beschreibung, Tags.

Funktionen: Aktualisieren, Zurück, Info, Speichern (speichert Änderungen im Metadaten-Formular), Neustart — wenn Objekte im Fehlerzustand waren oder der Snapshot mit einem Fehler endete, kann der Benutzer versuchen, die verbleibenden Objekte herunterzuladen.

Objekt-Baumansicht

Die Hauptinhalte des Snapshots. Auf der linken Seite werden für Clarity die Objektkategorien in der Baumansicht und für Automic die Ordnerstruktur der gegebenen Instanz angezeigt. Die Ordner können geöffnet und geschlossen werden; durch Anklicken wird auf der rechten Seite der Inhalt des Ordners oder der Kategorie angezeigt.

Für den gesamten Snapshot und für die spezifischen Ordner zeigen die blauen Zahlen die Gesamtzahl der Objekte, die grünen Zahlen die erfolgreich heruntergeladenen Objekte und die roten Zahlen die Objekte im Fehlerzustand an. Ein Objekt-Download kann aufgrund von Verbindungsproblemen, Programmfehlern oder Autorisierungsfehlern fehlschlagen, wenn der technische Benutzer nicht über die erforderlichen Rechte verfügt.

Felder: ID, Objektcode, Objekttyp, Status (WAITING, IN_PROGRESS, DONE, ERROR), Details (öffnet den Dialog „Snapshot-Objekt“), Verlauf (öffnet die Verlaufsansicht des Objekts).

Deployment-/User-Story-Verwaltung

Wenn eine User Story oder ein Deployment in der oberen rechten Ecke ausgewählt ist, ändert sich das Bildschirm-Layout. Mit dem zusätzlichen Steuerelement können Sie Ordner, den Inhalt von Ordnern oder bestimmte Elemente auswählen, die der ausgewählten User Story oder dem ausgewählten Deployment hinzugefügt werden sollen.

3C-Snapshot-Baumansicht mit Steuerelementen zur Auswahl von Deployment und User Story
Deployment-/User-Story-Verwaltung innerhalb eines Snapshots — Auswahl von Ordnern und Elementen, die einem Zielpaket hinzugefügt werden sollen.

Bildschirm Objektdetails

3C-Bildschirm mit den Details eines Snapshot-Objekts und schreibgeschütztem Konfigurationscode
Der Bildschirm mit den Objektdetails – Konfigurationscode, Änderungs-/Verschiebungsflags, ursprünglicher Snapshot-Verweis und Metadaten.

Zeigt die Details des Objekts an, wobei der eigentliche Konfigurationscode in einem schreibgeschützten Feld steht.

Felder:

  • Id: die technische ID des Objekts
  • Code: der Code des Objekts
  • Startzeit: Startzeitpunkt des Objekt-Downloads
  • Zuletzt aktualisiert am: Zeit der Konfigurationsänderung des Objekts im externen System
  • Objekt wurde geändert: true, wenn es seit dem letzten Snapshot geändert wurde
  • Objekt wurde verschoben: true, wenn es seit dem letzten Snapshot aus einem anderen Ordner verschoben wurde
  • Konfigurationstyp: XML / JSON
  • Status: der Status des Exports
  • Objekttyp: der Objekttyp im System
  • Endzeit: die Zeit, zu der das Objekt in 3C gespeichert wurde
  • Zuletzt aktualisiert von: falls verfügbar, die ID des Benutzers, der den Eintrag im externen System geändert hat
  • Original-Snapshot: wenn das Element nicht geändert wurde: die ID des Snapshots, der die aktuelle Konfiguration zuerst enthielt
  • Originalordner: wenn das Element verschoben wurde: der vorherige Ordner, der in 3C gespeichert wurde
  • Inhalt: die tatsächlich gespeicherte Konfiguration

Diffs

Die Diff-Analysen sind die zweite wichtige Funktion im 3C Release Manager. Ein Diff ist ein Vergleich zwischen zwei Snapshots. Je nach Anwendungsfall kann er verwendet werden, um die Unterschiede zu analysieren zwischen:

  • Die gleiche Umgebung zu verschiedenen Zeiten – nützlich für tägliche Backups und die Fehlerverfolgung, um Änderungen während einer Entwicklungsphase zu sammeln oder um ein Deployment zu validieren
  • Unterschiedliche Umgebungen – nützlich, um Unterschiede zwischen einer Test- und einer Entwicklungsumgebung zu finden, um zu sehen, was bereitgestellt werden muss, um zu prüfen, ob das Test-Deployment dem Stand nach der Entwicklung entspricht, zwischen einer Produktions- und einer Testumgebung, um zu sehen, was in das Release gehört, oder zwischen einer Produktionsumgebung und einem Standardsystem, um alle am System vorgenommenen Anpassungen zu erfassen

Der Benutzer kann auch Umgebungen auswählen, nicht nur Snapshots – mit dieser Funktion erstellt der 3C Release Manager während des Vorgangs automatisch einen neuen Snapshot und verwendet ihn für den Vergleich. Diffs können, wie die Snapshots, auch als Quelle für Deployment- oder User-Story-Inhalte dienen.

Diff-Liste

3C-Diff-Liste mit Statistiken für erstellte, gelöschte, geänderte und verschobene Objekte
Die Diff-Liste — neu erstellte Objekte in Grün, gelöschte in Rot, geänderte in Gelb, verschobene in Blau.

Funktionen: Aktualisieren, Neuer Diff, Info.

Spezielle Steuerelemente: User-Story-/Deployment-Auswahl mit demselben Verhalten wie in der Snapshot-Liste.

Filter: Quellumgebung, Zielumgebung, Startzeitintervall, Suchfeld.

Felder:

  • Id: generierte technische ID für den Diff
  • Titel: der Titel des Diffs
  • Status: DONE, ERROR, WAITING, IN_PROGRESS
  • Startzeit: die Zeit der Diff-Erstellung
  • Tags: die für den Diff festgelegten Tags
  • Statistik: neu erstellte Objekte in Grün, gelöschte oder fehlende Objekte in Rot, geänderte Elemente in Gelb, verschobene Elemente in Blau
  • Anzeigen: öffnet den Bildschirm Diff-Details
  • Löschen: löscht den Diff-Datensatz
  • Ausgewählte Elemente: wenn ein Deployment oder eine User Story ausgewählt ist, zeigt diese Spalte die Anzahl der aus jedem Diff hinzugefügten Objekte an

Diff erstellen

3C-Bildschirm Diff erstellen mit Auswahl von Quell- und Ziel-Snapshot oder -Umgebung
Der Bildschirm „Diff erstellen“ – wählen Sie Quelle und Ziel als Snapshots oder Umgebungen, mit optionalen Vorfiltern.

Der Benutzer kann diesen Bildschirm verwenden, um einen neuen Diff-Prozess zu starten. Wenn die 3C-Lizenz für Clarity und Automic gültig ist, muss der Benutzer zuerst das zu verwendende Produkt auswählen.

Felder:

  • Quellumgebung: wenn ausgewählt, startet der Diff-Prozess zuerst einen neuen Snapshot-Prozess für die ausgewählte Umgebung
  • Quell-Snapshot: die Liste der verfügbaren Snapshots in 3C. Die Filter können verwendet werden, um die Auswahlliste zu reduzieren. Es muss entweder eine Quellumgebung oder ein Quell-Snapshot ausgewählt werden.
  • Zielumgebung: wenn ausgewählt, startet der Diff-Prozess zuerst einen neuen Snapshot-Prozess für die ausgewählte Umgebung
  • Ziel-Snapshot: die Liste der verfügbaren Snapshots in 3C. Es muss entweder eine Zielumgebung oder ein Ziel-Snapshot ausgewählt werden.
  • Titel: Freitexttitel für den Diff, erforderlich
  • Beschreibung: Feld für Freitextbeschreibung
  • Tags: der Benutzer kann spezifische Tags für einen Diff festlegen
  • Benutzerdefinierte Vorfilter: der Benutzer kann bestimmte Teile der Konfiguration von den Diff-Analysen ausschließen, z. B. generierte IDs und Ähnliches

Funktionen: Abbrechen, Erstellen.

Diff-Details

3C-Diff-Detailansicht mit Verweisen auf Quell- und Ziel-Snapshot
Der Bildschirm „Diff-Details“ – Quell-Snapshot, Ziel-Snapshot, Status, Statistiken und Metadaten.

Nach Abschluss des Diff-Prozesses können die Analysen im Bildschirm Diff-Details eingesehen werden.

Felder: ID (schreibgeschützt), Titel, Status, Start-/Endzeit, Quell-Snapshot, Ziel-Snapshot, Beschreibung, Tags.

Funktionen: Aktualisieren, Zurück, Info, Speichern.

Objekt-Baumansicht

Gleiches Layout wie die Snapshot-Baumansicht. Zusätzlich wird ein spezieller Datensatz namens == All diffs == angezeigt, der alle Diffs auf der rechten Seite des Bildschirms zeigt. Für den gesamten Diff und für die einzelnen Ordner zeigen die blauen Zahlen die Gesamtzahl der verschobenen Objekte, die grünen Zahlen die neu erstellten Objekte, die gelben Zahlen die geänderten Objekte und die roten Zahlen die fehlenden oder gelöschten Objekte an.

Felder:

  • Objektcode: der Name des Objekts. Die Farbe des Objektsymbols stellt auch die Änderung dar (rot für Löschung, grün für Hinzufügung, gelb für Änderung, blau für Verschiebung)
  • Quelle geändert: die Zeit der Objektänderung in der Quellumgebung
  • Ziel geändert: die Zeit der Objektänderung in der Zielumgebung
  • Unterschiede: öffnet den XML- oder Baumvergleichsbildschirm für die Änderungen
  • Quelle: navigiert zum Quell-Snapshot
  • Ziel: navigiert zum Ziel-Snapshot

Deployment-/User-Story-Verwaltung

Wenn im oberen rechten Bereich eine User Story oder ein Deployment ausgewählt ist, ändert sich der Bildschirm. Mit dem zusätzlichen Steuerelement können Sie Ordner, den Inhalt von Ordnern oder bestimmte Elemente auswählen, die der ausgewählten User Story oder dem ausgewählten Deployment hinzugefügt werden sollen.

3C-Diff-Baumansicht mit Steuerelementen zur Auswahl von Deployments und User Stories
Deployment-/User-Story-Verwaltung innerhalb eines Diffs — Elemente, zugehörige Objekte oder rekursiv zugehörige Objekte hinzufügen.

In der Baumansicht auf der linken Seite fügt die Schaltfläche + rekursiv jedes Element unter dem Ordner zum ausgewählten Objekt hinzu. Die Schaltfläche – entfernt rekursiv alles daraus. Die Zahlen in Grau zeigen an, wie viele Objekte sich in dem Ordner befinden, die potenziell hinzugefügt werden können, und wie viele davon bereits hinzugefügt wurden.

Ganz oben in der Liste fügt Alles hinzufügen jedes Element aus der oben angezeigten Liste hinzu, und Alles entfernen entfernt die Elemente.

Bei einzelnen Datensätzen gibt es drei Optionen: Element hinzufügen fügt genau dieses Element hinzu; Zugehörige hinzufügen fügt das Element mit direkt zugehörigen Objekten hinzu; Zugehörige rekursiv hinzufügen fügt alle Elemente hinzu, die mit dem aktuellen in Beziehung stehen, zusammen mit ihren Referenzen.

Vorsicht. Die Funktion „Zugehörige rekursiv hinzufügen“ kann mehrere andere Elemente auf einmal zum Deployment hinzufügen.

Diff-Objektdetails

3C-Bildschirm Diff-Objektdetails mit den Registerkarten Quelle, Ziel und Diff für den XML-Vergleich
Der Bildschirm „Diff-Objektdetails“ — Registerkarten „Quelle“, „Ziel“ und „Diff“ für den Textvergleich von XML/JSON.

Der XML-Vergleich öffnet den Bildschirm mit den Konfigurationsänderungen. Die Registerkarte Quelle zeigt die Konfiguration auf der Quellseite, die Registerkarte Ziel zeigt die Konfiguration auf der Zielseite und die Registerkarte Diff zeigt die Unterschiede im XML- oder JSON-Code in einer Textvergleichsansicht an.

Analyseansicht

3C-Analyseansicht eines Diffs mit der Baumansicht der XML-Konfigurationselemente
Die Analyseansicht – Baumdarstellung der Konfigurationselemente im XML eines Objekts.

Bietet einen weiteren Visualisierungsbildschirm, auf dem die Konfigurationselemente im XML des Objekts zum leichteren Verständnis in einer Baumansicht angezeigt werden.

Deployments

Deployments sind das dritte wichtige Element im 3C Release Manager. Ein Deployment-Paket ist eine Sammlung von Konfigurationselementen, die direkt aus Snapshots oder Diffs gesammelt oder über User Stories hinzugefügt werden können. Ein Deployment hat immer ein Zielsystem, auf das der Benutzer die gesammelten Konfigurationen schreiben möchte.

Sobald das Deployment eingerichtet und vorbereitet ist, kann es gestartet werden, und der 3C Release Manager führt automatisch jeden Schritt nacheinander in der vorgegebenen Reihenfolge aus. Der 3C Release Manager kann außerdem vor dem Start des Deployments einen Backup-Snapshot und nach dessen Ende einen Validierungs-Snapshot erstellen, damit die Änderungen anschließend validiert werden können. Im Fehlerfall kann automatisch ein Rollback-Deployment erstellt werden.

Sobald ein Deployment abgeschlossen ist, kann es nicht mehr geändert werden, sodass die Deployment-Protokolle als Audit-Nachweis für die Zielsysteme verwendet werden können.

Deployment-Liste

3C-Deployment-Liste mit Status, Typ und Zielumgebung
Die Deployment-Liste – Status (DRAFT/PREPARED/IN_PROGRESS/DONE/ERROR), Typ, Zielumgebung und Erstellungsdatum.

Funktionen: Aktualisieren, Neues Deployment, Info.

Filter: Umgebungen, Statusauswahl (eine oder mehrere), Intervall für das Erstellungsdatum, Textfeld (Freitext in Titel oder Beschreibung).

Felder:

  • Id: generierte technische ID
  • Titel: der Titel des Deployment-Pakets
  • Status: DRAFT, PREPARED, IN_PROGRESS, DONE, ERROR
  • Typ: Deployment oder Rollback
  • Erstellungsdatum: Erstellungszeitpunkt des Deployment-Pakets
  • Ziel: die Zielumgebung
  • Anzeigen: navigiert zum Bildschirm „Deployment bearbeiten“
  • Löschen: löscht das Deployment

Deployment-Paket erstellen

3C-Bildschirm Deployment-Paket erstellen mit Zielumgebung und Titel
Der Bildschirm „Deployment-Paket erstellen“ – Zielumgebung, Titel und Beschreibung.

Felder: Zielumgebung, Titel (erforderlich), Beschreibung. Funktionen: Abbrechen, Erstellen.

Die zusätzlichen Werte können nach der Erstellung gesetzt werden.

Deployment-Paket bearbeiten

Der Bildschirm „Deployment-Paket bearbeiten“ hat 5 Registerkarten:

  • Basis: die Basisdaten des Deployments
  • Regeln: nur für Automic: Hier kann der Benutzer automatische Regeln definieren, die vor dem Deployment auf die Konfigurationselemente angewendet werden
  • Paket vorbereiten: wo der Benutzer die Deployment-Schritte bearbeiten kann
  • Ausführungsprotokoll: wo der Benutzer das Deployment-Paket starten und überwachen kann
  • Validierung: wo der Benutzer nach Abschluss des Deployments die Validierungsschritte überprüfen kann

Registerkarte Basis

3C-Bildschirm Deployment bearbeiten, Registerkarte Basis mit User Stories und Quellliste
Die Registerkarte Basis unter Deployment bearbeiten – Titel, Ziel, Status, User Stories und Quellliste (verwendete Snapshots und Diffs).

Wenn es widersprüchliche Einträge in den Deployment-Schritten gibt, wird eine Warnmeldung angezeigt. Eine weitere Meldung erscheint, wenn dem Deployment Objekte hinzugefügt wurden, deren Änderung in einer Automic-Instanz generell nicht ratsam ist.

Felder:

  • Titel: der Titel des Deployments
  • Zielumgebung: die Umgebung, in der das Deployment erfolgt
  • Status: der Status des Deployments
  • Deployment-ID: automatisch generierte technische ID
  • Deployment-Typ: Deployment oder Rollback
  • Beschreibung: Feld für Freitextbeschreibung
  • Erweiterte Optionen: manuelles Deaktivieren der Erstellung von Backup-Snapshot und Validierungs-Snapshot

User Stories: die Liste der User Stories, die im Deployment-Paket enthalten sind.

Quellliste: die Liste der Snapshots und Diffs, die als Quelle für die Schritte des Deployment-Pakets dienten, direkt oder indirekt über User Stories.

Funktionen: Abbrechen, Speichern, Deployment klonen (klont das aktuelle Deployment und erstellt ein neues mit demselben Inhalt und denselben Einstellungen), Deployment-Regeln (navigiert zur nächsten Registerkarte).

Registerkarte Regeln (nur Automic)

3C-Bildschirm Deployment bearbeiten, Registerkarte Regeln mit Regelsatz-Editor für AEDB Change
Die Registerkarte „Regeln“ – Regelsatz je Deployment in der Syntax des Utilitys AEDB Change.

Der Benutzer kann die tatsächlichen Regeln für dieses Deployment festlegen, die während des Prozesses verwendet werden. Wenn für die Zielumgebung ein Standardregelsatz definiert ist, wird dieser automatisch hierher kopiert, kann aber auch vom Benutzer gelöscht werden. Der Textänderungsprozess funktioniert ähnlich wie das Utility AEDB Change.

Felder:

  • Umgebungsregelsatz: der Text, der die Regeln enthält (jede Zeile ist eine Regel)
  • Validieren: überprüft den Regelsatz und zeigt bei Syntaxfehlern eine Fehlermeldung an
  • Speichern: speichert den Regelsatz für das Deployment. Alle Objekte, die dem Deployment hinzugefügt werden, lösen die Regeln aus, und ihr Inhalt wird entsprechend geändert.

Registerkarte Paket vorbereiten

3C-Registerkarte Paket vorbereiten mit Deployment-Schritten und neu anordenbarer Liste
Die Registerkarte „Paket vorbereiten“ – Deployment-Schritte mit Typ (Erstellen/Ändern/Löschen/Verschieben/Manuell), Quell- und Zielvorschau.

Ähnlich wie der Inhalt von User Stories enthält das Deployment-Paket Schritte, die während des Prozesses ausgeführt werden sollen. Die Schritte können von folgenden Typen sein:

  • Erstellen ein neues Objekt (Aktion Erstellen)
  • Löschen ein Objekt (Aktion Entfernen) — für Clarity funktioniert die Löschung aufgrund von Einschränkungen des externen Systems nicht automatisch
  • Ändern die Konfiguration eines bestehenden Objekts
  • Verschieben ein vorhandenes Objekt in einen anderen Ordner — nur relevant für Automic-Instanzen
  • Manuelle Schritte — benutzerdefinierte Schritte während des Deployment-Prozesses, bei denen der Prozess angehalten werden soll, damit der Administrator manuelle Aufgaben erledigen kann

Die Objekte können aus einem Snapshot hinzugefügt werden; Änderungen durch Löschen/Erstellen/Verschieben können aus einem Diff hinzugefügt werden.

Filter: Freitextsuche in Objektcodes oder Objekttypen.

Felder:

  • Nummer: die Reihenfolge der Schritte. Datensätze können per Drag-and-Drop vom Benutzer neu angeordnet werden. Die Deployment-Schritte werden während des Prozesses in Skriptreihenfolge ausgeführt.
  • Id: generierte technische ID. Wenn für den Datensatz eine Warnung besteht (z. B. Konflikte), wird hier auch ein Warnsymbol angezeigt.
  • User Story: der Link zur ursprünglichen User Story
  • Quelle: der Link zum Snapshot oder Diff, von dem die Konfiguration stammt
  • Schritttyp: AUTO oder MANUAL
  • Objekttyp: wenn sich im Deployment Objekte befinden, die generell nicht geändert werden sollten, wird hier ein Warnsymbol angezeigt
  • Objektcode: der Code des Objekts
  • Konfigurationstyp: XML oder JSON
  • Aktion: die Aktion, die während des Deployments durchgeführt wird
  • XML bereitstellen: zeigt den Code des Objekts, der auf dem Zielsystem bereitgestellt wird
  • Zielkonfiguration: zeigt den Code des Objekts, der auf dem Zielsystem überschrieben wird
  • Operationen:
    • Haltepunkt: der Deployment-Prozess wird nach diesem Schritt angehalten, bis der Benutzer das Deployment fortsetzt
    • Nach oben / unten verschieben: Schritte neu anordnen
    • +: fügt einen manuellen Schritt nach dem ausgewählten Schritt ein
    • Notiz: öffnet die Notiz für den Deployment-Schritt
    • Löschen: entfernt den Schritt aus dem Deployment

Funktionen: Aus Diff hinzufügen (navigiert zur Diff-Liste, in der das aktuelle Deployment zum Hinzufügen ausgewählt ist), Aus Snapshot hinzufügen, Vorbereitung fertig (ändert den Status des Deployments auf „Prepared“), Start (nur sichtbar für Deployments im Status „Prepared“ – startet den Prozess und navigiert zur Registerkarte „Ausführungsprotokoll“).

Hinweis. Nur der Inhalt eines Deployments mit dem Status „Draft“ kann geändert werden. Wenn es bereits vorbereitet wurde, verwenden Sie zuerst die Schaltfläche Auf Entwurf setzen zum Entsperren der Inhalte.

Dialog Deployment-Schritt

3C-Dialog Deployment-Schritt mit Quellkonfiguration und Notizen
Der Dialog „Deployment-Schritt“ – Quelltyp, Code, Objekttyp und die zu deployende Konfiguration.

Zeigt die Details des Deployment-Schritts mit der Konfiguration, die während des Deployments verwendet wird.

Felder: Quelltyp (Snapshot oder Diff), ID, Objektquelle, Code, Objekttyp, Quelle (die Konfiguration des Objekts), Beschreibung, Notizen.

Registerkarte Ausführungsprotokoll

3C-Registerkarte Ausführungsprotokoll während eines Deployment-Prozesses mit Statuskarten der Schritte und Steuerelementen zum Pausieren
Die Registerkarte „Ausführungsprotokoll“ – Steuerelemente zum Pausieren, Fortsetzen und Abbrechen sowie Statuskarten pro Schritt.
3C-Registerkarte Ausführungsprotokoll mit einem erfolgreich abgeschlossenen Deployment, alle Schritte DONE
Ein erfolgreiches Deployment auf der Registerkarte „Ausführungsprotokoll“ – jeder Schritt im Status DONE.

Nachdem der Deployment-Prozess gestartet wurde, kann dieses Protokoll verwendet werden, um den Prozess zu überwachen. Wenn die Option „Backup-Snapshot“ aktiviert ist, erstellt der 3C Release Manager zuerst einen Snapshot, der jedes Element enthält, das während des Deployment-Prozesses geändert wird. Sobald dies abgeschlossen ist, wird mit dem ersten Schritt begonnen.

Wenn für die Schritte keine manuellen Schritte oder Haltepunkte festgelegt sind, wird jeder Schritt automatisch ausgeführt und anschließend ein Validierungs-Snapshot der Änderungen erstellt. Wenn der Deployment-Prozess anhält, kann er mit der Schaltfläche Fortsetzen fortgesetzt werden, oder Sie beenden den gesamten Vorgang, indem Sie auf Abbrechen klicken.

Wenn der Prozess pausiert ist, können Deployment-Schritte wiederholt oder übersprungen und sogar zusätzliche Haltepunkte hinzugefügt werden.

Funktionen:

  • Pause: pausiert den Deployment-Prozess
  • Fortsetzen: setzt einen pausierten Deployment-Prozess fort
  • Abbrechen: Panic-Button – stoppt den Deployment-Prozess vollständig und setzt das Deployment in den Status „Cancelled“

Karten der Deployment-Schritte:

  • Nummer: die laufende Nummer des Schritts
  • Status: DONE, WAITING, IN_PROGRESS, ERROR
  • ID: ID des Deployment-Schritts
  • Typ: Auto oder Manual
  • Objekt: der Objekttyp
  • Code: der Objektcode
  • Konfigurationstyp: XML oder JSON
  • Titel: der Titel der Änderung
  • Ausführungsliste: wenn der Schritt bereits ausgeführt wurde, wird hier das Ausführungsprotokoll angezeigt
  • Einzelheiten: zeigt die Details und Notizen des Schritts an
  • Wiederholen: nur sichtbar, wenn der Prozess pausiert ist — 3C wird versuchen, denselben Schritt erneut auszuführen
  • Überspringen: nur sichtbar, wenn der Prozess pausiert ist — 3C führt den Schritt nicht aus
  • Abschließen: nur sichtbar für manuelle Schritte – der Benutzer muss die Aufgabe manuell abschließen, bevor der Prozess fortgesetzt wird

Fenster Ausführungsdetails

3C-Fenster Ausführungsdetails mit Startzeit, Endzeit und Ergebnis
Das Fenster „Ausführungsdetails“ – Ausführungsnummer, Status (SUCCESS/ERROR), Zeiten, Ergebnis und Konfiguration der Anfrage.

Zeigt die Details der Ausführung eines Deployment-Schritts an.

Felder: Ausführungsnummer (1, falls keine Wiederholungen), Ausführungsstatus (SUCCESS oder ERROR), Startzeit, Endzeit, Ergebnis (OK bei Erfolg, andernfalls die Fehlermeldung vom externen System), Anfrage (die für das Deployment verwendete Konfiguration).

Registerkarte Validierung

3C-Registerkarte Validierung mit Backup-Snapshot, Validierungs-Snapshot und Schaltfläche Rollback
Die Registerkarte „Validierung“ – Backup-Snapshot, Validierungs-Snapshot, Validierungs-Diff und die Schaltfläche „Rollback“.

Nur sichtbar, nachdem das Deployment abgeschlossen ist. Dieser Bildschirm fasst die Details zu Backup-Snapshot, Validierungs-Snapshot und Validierungs-Diff an einem Ort zusammen. Wenn alles gut gelaufen ist, sollten die Diff-Analysen genau das anzeigen, was Sie in der Zielumgebung bereitstellen wollten.

Funktionen:

  • Rollback: Im Falle eines Fehlers oder eines fehlgeschlagenen Deployments verwenden Sie die Schaltfläche „Rollback“. Sie erstellt ein spezielles Rollback-Deployment, das das genaue Gegenteil des aktuellen Deployments ist und den Zustand der Objekte mithilfe des Backup-Snapshots zurücksetzt. Nach der Erstellung funktioniert das Rollback-Deployment wie ein Standard-Deployment und muss manuell gestartet werden.

User Stories

User Stories dienen als logischer Container für Änderungen, die mit einer Geschäftsanforderung verbunden sind. Für den 3C Release Manager wird folgende Vorgehensweise empfohlen:

  • Definieren Sie User Stories im System, die höchstwahrscheinlich aus einem externen User-Story-Management-System stammen
  • Erstellen Sie einen Snapshot der Entwicklungsumgebung, bevor die Entwicklung beginnt
  • Erstellen Sie einen Snapshot der Entwicklungsumgebung, nachdem die Entwicklung beendet wurde
  • Erstellen Sie eine Diff-Analyse zwischen den beiden Snapshots
  • Basierend auf den Unterschieden sammeln Sie die einzelnen Änderungen und verknüpfen sie mit den User Stories. Auf diese Weise hat das Team ein klares Verständnis dafür, warum jede Konfigurationsänderung vorgenommen wurde und welche Geschäftsanforderungen davon betroffen sind.

Später können die User Stories zu Deployments hinzugefügt werden, um die Änderungen in das gewünschte System zu überführen.

User-Story-Liste

3C-User-Story-Liste mit Status, Sprint und aktivem System
Die User-Story-Liste – Status, Sprint, aktives System und die Deployments, zu denen die Story gehört.

Funktionen: Aktualisieren, Neue User Story, Info.

Filter: Statusfilter (sichtbare Status), Sprintauswahl, Suchfeld (Freitext in Titeln und Beschreibungen).

Felder:

  • ID: generierte technische ID
  • Name: der Name der User Story
  • Status: der aktuelle Status (DRAFT, WORK IN PROGRESS, READY FOR DEVELOPMENT, TESTING, DONE usw.)
  • Sprint: der Sprint, mit dem die User Story verbunden ist
  • Aktives System: das System, mit dem der aktuelle Status verbunden ist
  • Deployments: die Liste der Deployments, zu denen die User Story gehört
  • Anzeigen: navigiert zum Detailbildschirm der User Story
  • Löschen: löscht die User Story

User Story erstellen

3C-Bildschirm User Story erstellen mit Name, externem Link und verantwortlichem Benutzer
Der Bildschirm User Story erstellen — Name, Referenz zum externen Ticketsystem und zuständiger Benutzer.

Dieser Bildschirm kann verwendet werden, um neue User Stories im 3C Release Manager zu erstellen. Beachten Sie, dass neue User Stories auch auf den Seiten Snapshot und Diff erstellt werden können.

Felder:

  • Produktname: nur sichtbar, wenn der 3C-Lizenzschlüssel für Clarity und Automic gültig ist
  • Name: erforderlich, Freitextfeld
  • User-Story-Nummer: optional, um die ID der User Story in externen Ticketsystemen wie Jira zu speichern
  • Externer Link: optional, um den Link für das externe Ticket zu speichern
  • Beschreibung: Feld für Freitextbeschreibung
  • Verantwortlicher Benutzer: optional, der Benutzer im 3C Release Manager, der für die User Story verantwortlich ist

Funktionen: Abbrechen, Speichern.

User Story bearbeiten

Der Bildschirm enthält 5 verschiedene Registerkarten: Beschreibung, Inhalt, Konfliktanalyse, Deployment, Aktivitäten.

Registerkarte Beschreibung

3C-Bildschirm User Story bearbeiten, Registerkarte Beschreibung mit über- und untergeordneten User Stories und Sprint
Die Registerkarte „Beschreibung“ — übergeordnete/untergeordnete User Stories, Sprintverwaltung und Verweise auf externe Tickets.

Zum Bearbeiten der Basisdaten der User Story.

Felder:

  • Produkt: nur sichtbar, wenn sowohl Clarity- als auch Automic-Lizenzen gültig sind
  • Story-ID: generierte technische ID
  • Name: erforderlich, Freitextfeld
  • User-Story-Nummer: optional, als Referenz auf ein externes Ticketsystem
  • Externer Link: optional, für die externe Ticket-URL
  • Beschreibung: Freier Text
  • Verantwortlicher Benutzer: optional
  • Übergeordnete User Story: User Stories können in Hierarchien organisiert werden – hier kann der Benutzer eine andere User Story als übergeordnete Story auswählen
  • Untergeordnete User Stories: die Liste der User Stories, die sich auf diese beziehen
  • Status: der aktuelle Status (Informationsfeld)
  • Aktives System: das aktuelle externe System, in dem die Änderungen der User Story bereits bereitgestellt wurden
  • Sprint: Steuerelement für die Sprintverwaltung zum Auswählen eines bestehenden Sprints oder zum Erstellen eines neuen per Dialog
  • Erstellt / Zuletzt geändert: schreibgeschützte Zeitstempel

Funktionen: Abbrechen, Speichern.

Registerkarte Inhalt

3C-Bildschirm User Story bearbeiten, Registerkarte Inhalt mit Konfigurationsänderungen aus Snapshots und Diffs
Die Registerkarte „Inhalt“ – Konfigurationsänderungen, die aus Snapshots und Diffs hinzugefügt wurden, mit Aktionstyp und Notizen.

Der Benutzer kann den Inhalt der User Story verwalten: die eigentlichen Konfigurationsänderungen.

Filter: Objekte suchen (Freitextsuche in Objektcodes und -typen).

Felder:

  • Id: generierte technische ID des Konfigurationselements
  • Quelle: die Quelle, aus der das Objekt oder die Objektänderung hinzugefügt wurde (Snapshot- oder Diff-Element)
  • Objekttyp: der Objekttyp
  • Objektcode: der Code des Objekts
  • Aktion: Hinzufügung, Löschung, Änderung, Verschiebung oder Benutzerdefiniert (bei einem manuellen Schritt)
  • XML bereitstellen: zeigt den Konfigurationscode des Objekts
  • Notizen: zeigt die Benutzernotizen zum Objekt
  • Löschen: löscht das Objekt aus der User Story

Funktionen: Aus Snapshot hinzufügen (navigiert zur Snapshot-Liste, in der die aktuelle User Story zum Hinzufügen ausgewählt ist), Aus Diff hinzufügen, Manuellen Schritt hinzufügen (fügt einen benutzerdefinierten Schritt zur Liste hinzu).

Dialog Konfigurationselement

3C-Dialog Konfigurationselement einer User Story mit den Details des ausgewählten Konfigurationselements
Der Dialog „Konfigurationselement“ — Quelltyp, Code, Objekttyp und die gespeicherte Konfiguration.

Zeigt die Details des ausgewählten Konfigurationselements mit seinem aktuellen Code und anderen Metadaten an.

Felder: Quelltyp (Snapshot oder Diff), ID, Objektquelle, Code, Objekttyp, Quelle (die Konfiguration), Beschreibung, Notizen.

Registerkarte Konfliktanalyse

3C-Registerkarte Konfliktanalyse einer User Story mit User Stories, die überlappende Objektänderungen enthalten
Die Registerkarte „Konfliktanalyse“ – andere User Stories, die dieselben Konfigurationselemente betreffen.

Diese Liste zeigt alle anderen User Stories, die mit der aktuellen in Konflikt stehen können. Aufgelistet werden alle User Stories, die Änderungen an denselben Konfigurationselementen enthalten. Die Liste zeigt auch das kollidierende Objekt. Diese Funktion dient der Koordination von Objektänderungen für große Entwicklungsgruppen.

Felder:

  • Story-ID: die 3C-ID der kollidierenden User Story
  • User Story: der Name der kollidierenden User Story
  • Status: der aktuelle Status der kollidierenden User Story
  • Besitzer: der Besitzer der kollidierenden User Story
  • Konfliktobjekt: der Typ und der Code des Objekts, das in der User Story enthalten ist
  • Anzeigen: navigiert zur kollidierenden User Story

Registerkarte Deployment

3C-Registerkarte Deployment einer User Story mit Deployment-Auswahl
Die Registerkarte „Deployment“ der User Story – fügen Sie die User Story bestehenden Deployments hinzu oder erstellen Sie ein neues.

Dient dazu, User Stories zu Deployments hinzuzufügen. Außerdem werden alle Deployments angezeigt, die die User Story enthalten. Für den 3C Release Manager wird empfohlen, die Änderungen in User Stories zu sammeln und dieselbe User Story zunächst dem Deployment der Testumgebung und später dem der Produktionsumgebung hinzuzufügen.

Felder: ID, Titel, Zielumgebung, Status, Erstellt am, Anzeigen, Löschen.

Funktionen: Deployment-Auswahl (listet verfügbare Deployments auf). Nach Auswahl eines Deployments wird die Schaltfläche Zum Deployment hinzufügen angezeigt. Wenn – Neues Deployment – ausgewählt ist, wird die Schaltfläche Neues Deployment erstellen angezeigt, die das Dialogfeld zum Erstellen von Deployments öffnet.

Registerkarte Aktivitäten

3C-Registerkarte Aktivitäten einer User Story mit Audit-Änderungen und manuellen Kommentaren
Die Registerkarte „Aktivitäten“ – ein Audit-Trail von Änderungen mit der Option, manuelle Kommentare hinzuzufügen.

Dient Audit-Zwecken – zeigt die an der User Story vorgenommenen Änderungen an. Hier können auch manuelle Kommentare hinzugefügt werden.


5 · Upgrade & Migration

Upgrade & Migration

3C Release Manager Upgrades folgen denselben zwei Varianten wie die Erstinstallation des 3C Release Manager: manuell und geführt. Die Beispiele verwenden generische Werte; stellen Sie sicher, dass diese durch die korrekten Werte für die Zielumgebung des 3C Release Manager ersetzt werden.

Upgrade — manuell

SCHRITT 1
Tomcat stoppen
Stoppen Sie den Apache-Tomcat-Dienst vor allen Dateiänderungen.
SCHRITT 2
WAR-Bereitstellung

Kopieren Sie die neuen WAR-Dateien nach <TOMCAT_HOME>/webapps/:

  • threec.war
  • threec-auth.war
  • threec-backend.war
  • threec-frontend.war
SCHRITT 3
Entfernung temporärer Dateien

Entfernen Sie die folgenden Ordner aus <TOMCAT_HOME>/work/Catalina/localhost:

  • threec
  • threec-auth
  • threec-backend
  • threec-frontend
SCHRITT 4
Finalisierung
  • Starten Sie Apache Tomcat neu.
  • Überprüfen Sie die erfolgreiche Bereitstellung anhand der Tomcat-Logs und der Anwendungs-URLs.

Upgrade — geführt

SCHRITT 1
Update starten
Starten Sie das dedizierte Updateskript.
3C-Upgrade-Installer: Eingabeaufforderung mit der Meldung „Welcome to 3C v3.2.0 upgrade installer“
Schritt 1 – Update starten. Das Ausführen von upgrade3c.bat öffnet die Eingabeaufforderung des Upgrade-Installationsprogramms.
SCHRITT 2
Verzeichniseinstellungen

Geben Sie die folgenden Verzeichnisse ein, die verfügbar sein müssen:

  • Tomcat HOME-Verzeichnis (z. B. c:/Automic/Tomcat-3C)
  • Java HOME-Verzeichnis (z. B. c:/Program Files/Java/jdk-17)
3C-Upgrade-Installer: Abfrage der Verzeichniseinstellungen für das Tomcat- und das Java-Home-Verzeichnis
Schritt 2 – Verzeichniseinstellungen. Das Upgrade-Installationsprogramm fragt nach den Tomcat- und Java-Home-Verzeichnissen.
SCHRITT 3
Tomcat-Einstellungen
Geben Sie die Tomcat-Einstellungen für den zu verwendenden Domainnamen und Port ein (z. B. http://localvm:8061). Nach der Eingabe der Tomcat-Einstellungen beginnt die Migration sofort.
3C-Upgrade-Installer: Abfrage der Tomcat-Einstellungen mit MIGRATE DATABASE SCHEMA
Schritt 3 – Tomcat-Einstellungen. Nach Eingabe von Tomcat-Host und -Port startet die Datenbank-Schema-Migration sofort.
SCHRITT 4
WAR-Bereitstellung
Das Entfernen der alten Dateien und die Bereitstellung der neuen WAR-Dateien erfolgen automatisch.
3C-Upgrade-Installer, Schritt WAR-Deployment mit REMOVING OLD FILES und COPYING NEW FILES
Schritt 4 — WAR-Bereitstellung. Alte Dateien werden entfernt und die neuen WAR-Dateien nach <TOMCAT_HOME>/webapps kopiert.
SCHRITT 5
Konfigurationsaktualisierung
Die Konfigurationsdateien für die Tomcat-Anwendung werden automatisch aktualisiert.
3C-Upgrade-Installer, Schritt Konfigurationsaktualisierung mit UPDATING CONFIGURATION FILES
Schritt 5 — Konfigurationsaktualisierung. Das Upgrade-Installationsprogramm überschreibt die Dateien application-prod.properties für alle drei Module.
SCHRITT 6
Finalisierung
  • Starten Sie Apache Tomcat neu.
  • Überprüfen Sie die erfolgreiche Bereitstellung anhand der Tomcat-Logs und der Anwendungs-URLs.

6 · Versionshinweise

Versionshinweise

Die neuesten Versionen des 3C Release Manager und ihre Änderungen.

v3.3.4

TypBeschreibung
VerbesserungVier-Augen-Prinzip
FehlerbehebungFehlerbehebungen im GUI-Installer

v3.3.3

TypBeschreibung
VerbesserungGUI-Installer hinzugefügt
FehlerbehebungVerschiedene Fehlerbehebungen

v3.3.2

TypBeschreibung
FehlerbehebungBegrenzungen der Objektanzahl behoben — Abfragen verbessert
VerbesserungDeployment-Geschwindigkeit verbessert

v3.3.1

TypBeschreibung
VerbesserungImport-/Exportfunktion für Snapshots als ZIP-Dateien hinzugefügt
VerbesserungVerbessertes Parsing beim JSON- und XML-Import zur Verarbeitung von Blueprint-Strukturen und zur Beibehaltung der Objektidentität
VerbesserungVerfeinerte Behandlung der Start- und Endzeitstempel von Snapshots beim Import

v3.3.0

TypBeschreibungNotizen
VerbesserungBenutzerdefinierte Rollen hinzugefügt
VerbesserungBlueprint-Verwaltung in 3CUnterstützung für Clarity 16.3.3
VerbesserungUnterregisterkarten im Blueprint-ModulUnterstützung für Clarity 16.3.3
FehlerbehebungKleine Fehlerbehebungen zur Verbesserung der Stabilität und Wartbarkeit

7 · Häufig gestellte Fragen

Häufig gestellte Fragen

Klicken Sie auf eine Frage, um die Antwort aufzuklappen.

Was ist der 3C Release Manager und was macht er?

Der 3C Release Manager ist ein Transport-, Vergleichs- und Deployment-Tool für Automic Automation, das die Art und Weise revolutioniert, wie Konfigurationen zwischen DEV-, TEST-, UAT- und PROD-Umgebungen verschoben werden. Er erweitert den Standard-Transportfall von Automic um eine Snapshot-basierte Konfigurationserfassung, eine Diff-Analyse zwischen Umgebungen und Zeitpunkten, Deployment-Pakete mit automatischem Rollback, eine User-Story-basierte Gruppierung von Änderungen und optionale Git-Synchronisierung.

Der 3C Release Manager läuft als Java/Spring-Webanwendung auf Apache Tomcat mit einem PostgreSQL-Backend und wird über die Java-API per TLS an die Automic Automation Engine V21 oder höher angebunden.

Welche Automic-Versionen werden unterstützt?

Der 3C Release Manager erfordert die Automic Automation Engine V21 oder höher. Die Integration nutzt die Automic Java API über eine TLS-gesicherte Kommunikation. Sie benötigen pro Instanz einen oder mehrere konfigurierte Automic-Mandanten und TLS-kompatible Zertifikate.

Der 3C Release Manager unterstützt auch Clarity PPM als alternatives Zielsystem, wenn Ihre Lizenz das Clarity-Modul enthält – beide können von derselben 3C-Instanz aus verwaltet werden.

Was sind die technischen Voraussetzungen für die Installation des 3C Release Manager?

Der 3C Release Manager ist plattformunabhängig und kann unter Microsoft Windows (64-Bit) oder Linux (64-Bit, jede moderne, vom Anbieter unterstützte Distribution wie RHEL, Rocky Linux, Ubuntu LTS) eingesetzt werden. Die erforderlichen Komponenten sind:

  • Java 21 (Open Edition / OpenJDK)
  • Apache Tomcat 10 mit aktiviertem HTTPS/TLS
  • PostgreSQL 15 mit JDBC-Konnektivität
  • Netzwerkzugriff vom 3C-Backend auf Ihre Automic-Instanzen
  • TLS-kompatible Zertifikate für die Automic-Kommunikation
Wie werden Passwörter gespeichert?

Für 3C-Benutzer werden die Passwörter im gehashten Format gespeichert. Für die externen Umgebungen (Automic-Instanzen) wird das Passwort mittels Zwei-Wege-Verschlüsselung gespeichert – dies ist notwendig, damit 3C im Namen des konfigurierten technischen Benutzers eine Verbindung zum externen System herstellen kann.

Wie lauten der Standard-Benutzername und das Standardpasswort nach der Installation?

Die Standard-Anmeldedaten des Superusers nach einer Neuinstallation lauten: Benutzername super, Passwort super. Ändern Sie diese sofort nach der ersten Anmeldung über die Seite Mein Profil.

Was ist der Unterschied zwischen einem Snapshot und einem Diff?

Ein Snapshot ist eine Darstellung der Konfiguration einer Automic-Umgebung zu einem bestimmten Zeitpunkt. 3C verbindet sich mit der Umgebung und lädt jedes Konfigurationsobjekt basierend auf den konfigurierten Filtern herunter. Snapshots dienen als Konfigurationshistorie, System-Backups und als Quelle für Deployment-Pakete.

Ein Diff ist ein Vergleich zwischen zwei Snapshots – oder zwischen zwei Umgebungen; in diesem Fall erstellt 3C die Snapshots automatisch während des Vorgangs. Diffs zeigen, was sich zwischen Quelle und Ziel unterscheidet: neu erstellte Objekte, gelöschte Objekte, Änderungen und Verschiebungen. Sie sind typischerweise der Ausgangspunkt für die Abgrenzung eines Deployments.

Warum dauert mein erster Snapshot länger als spätere?

Der 3C Release Manager exportiert und speichert Objekte inkrementell. Der erste Snapshot einer neuen Umgebung muss jedes Konfigurationsobjekt herunterladen, was Zeit in Anspruch nimmt. Jeder nachfolgende Snapshot speichert nur die Objekte, die sich seit dem vorherigen Snapshot geändert haben – das reduziert sowohl die Laufzeit als auch den Datenbankverbrauch erheblich.

Um Snapshots im Allgemeinen zu beschleunigen, sollten Sie Filter konfigurieren, die irrelevante Konfigurationstypen ausschließen, sodass nur die wichtigen Objekte erfasst werden.

Wie funktioniert der Rollback, wenn ein Deployment fehlschlägt?

Jedes Deployment erstellt vor dem Start automatisch einen Backup-Snapshot mit allen Elementen, die während des Deployment-Prozesses geändert werden. Nach dem Deployment wird ein Validierungs-Snapshot erstellt, um die Änderungen zu verifizieren.

Wenn etwas schiefgeht, bietet die Registerkarte Validierung die Schaltfläche Rollback. Sie erstellt ein spezielles Rollback-Deployment, das exakt das Gegenteil des ursprünglichen Deployments ist und die betroffenen Objekte aus dem Backup-Snapshot wiederherstellt. Das Rollback funktioniert wie ein Standard-Deployment und muss manuell gestartet werden.

Können mehrere Entwicklungsteams parallel arbeiten, ohne sich gegenseitig Änderungen zu überschreiben?

Ja. Die Registerkarte Konfliktanalyse jeder User Story listet automatisch alle anderen User Stories auf, die Änderungen an denselben Konfigurationselementen enthalten. Die Ansicht zeigt, welches kollidierende Objekt betroffen ist, wem die kollidierende Story gehört und welchen Status sie aktuell hat – und ermöglicht die direkte Navigation zur kollidierenden Story.

Dies ist speziell für die Koordination von Objektänderungen in großen Entwicklungsgruppen konzipiert, in denen parallele Arbeiten an denselben Automic-Objekten ansonsten zu unbemerkten Überschreibungen während des Deployments führen würden.

Wie integriere ich 3C mit Git (GitHub oder Bitbucket)?

Die Git-Integration im 3C Release Manager wird in zwei Schritten eingerichtet:

1. Mandantenweite Git-Einstellungen. Ein Administrator konfiguriert die Git-Repository-URL und die Verbindungsmethode (Anmeldeinformationen mit Benutzername/Passwort oder SSH mit privatem Schlüssel) unter Administration → Git-Einstellungen. Der technische Benutzer muss Commit- und Push-Berechtigungen für das Repository haben.

2. Umgebungsspezifischer Git-Sync. Legen Sie auf der Registerkarte Git-Einstellungen jeder Umgebung einen Branch-Namen fest (er wird automatisch erstellt, falls er nicht existiert) und aktivieren Sie den Schalter Git-Sync aktiviert. Von da an schreibt jeder erfolgreiche Snapshot die Konfiguration auf das Dateisystem und committet/pusht die Änderungen automatisch in den konfigurierten Branch.

Was geschieht mit Objekten im Verlauf, wenn sie im externen System gelöscht werden?

Gelöschte Objekte bleiben aufgrund der früheren Snapshots, die sie erfasst haben, im Verlauf von 3C sichtbar. Sie können über die Verlaufsansicht der Objektliste weiterhin auf ihre frühere Konfiguration zugreifen, obwohl das Objekt in der Automic-Quellinstanz nicht mehr existiert. Dadurch ist 3C eine zuverlässige Quelle für Audits und forensische Analysen, selbst für Objekte, die aus dem laufenden System entfernt wurden.

Wie kann ich bei einem Deployment Massenänderungen (z. B. Umbenennung von Hosts) durchführen?

Der 3C Release Manager unterstützt regelbasierte Massenänderungen während des Deployments mit der gleichen Syntax wie das Utility Automic AEDB Change. Sie können Regelsätze auf zwei Ebenen definieren:

  • Pro Umgebung — auf der Registerkarte Deployment-Regeln der Umgebung. Diese Regeln werden standardmäßig in jedes neue Deployment kopiert, das auf diese Umgebung abzielt.
  • Pro Deployment — auf der Registerkarte Regeln des Deployments. Der Standardregelsatz der Umgebung wird hier automatisch hineinkopiert und kann bearbeitet oder entfernt werden.

Wenn ein Deployment ausgeführt wird, werden die Regeln automatisch auf jedes Objekt angewendet, bevor es in das Zielsystem geschrieben wird. Verwenden Sie die Schaltfläche Validieren zur Prüfung des Regelsatzes auf Syntaxfehler vor dem Speichern.

Wie prüfe ich die Größe der Datenbank, und mit welchem Wachstum ist zu rechnen?

Um die Datenbankgröße zu überprüfen, verwenden Sie die PostgreSQL-Befehlszeile:

[postgres install folder]\bin\pgsql -U postgres \l+

Oder verwenden Sie diese SQL-Abfrage:

SELECT t1.datname AS db_name, pg_size_pretty(pg_database_size(t1.datname)) AS db_size FROM pg_database t1 ORDER BY pg_database_size(t1.datname) DESC;

Referenzwert: 20 MB ist die typische Größe für 1 Snapshot von 2.600 Konfigurationselementen (mit einem Filter für 2 Sprachen) plus 5 Diffs mit jeweils etwa 300 Änderungen.

Wie funktioniert das Vier-Augen-Prinzip für Transportfreigaben?

Das Vier-Augen-Prinzip wurde in Version 3.3.4 des 3C Release Manager eingeführt, um Umgebungen zu unterstützen, in denen Transportaktionen eine explizite Nachverfolgbarkeit erfordern – typischerweise regulierte Branchen oder IT-Organisationen mit formalem Change-Management. Es erfordert die Genehmigung von Transportfreigaben durch einen zweiten Benutzer, bevor diese ausgeführt werden können, was sicherstellt, dass keine Einzelperson unkontrolliert Änderungen in einer Zielumgebung bereitstellen kann.

In Verbindung mit dem Audit-Protokoll (das jede wichtige Systemaktion mit Benutzer, Zeitstempel und Modul erfasst) bietet dies die Nachverfolgbarkeit, die für Compliance-getriebene Umgebungen erforderlich ist.

Brauchen Sie Unterstützung bei 3C in Ihrer Umgebung?
Sprechen Sie mit unseren Experten über Installation, Integration, Schulung oder Lizenzierung.
Nach oben scrollen