Zum Inhalt springen

Installation und Deployment

Zuletzt aktualisiert am

Es gibt eine Reihe verschiedener Zugangsdaten für den Zugriff auf das iCAS-System nach dem Deployment.

Um sich am Windows Server anzumelden, sollte der lokale Benutzer admin verwendet werden. Das zugehörige Passwort wird zufällig generiert und im Terraform-Output angezeigt.

Für die Anmeldung am iCAS-Administrationstool iAdmin können die Standard-Zugangsdaten verwendet werden. Diese können nachträglich geändert werden.

Die Zugangsdaten für die erstellten SMB-Freigaben befinden sich im Log-Verzeichnis (Standard: C:\iCASDeployment).

Bitte führen Sie keine manuellen Konfigurationen, Änderungen oder Server-Neustarts durch, bis der Deployment-Prozess abgeschlossen ist. Dies würde zu einer unkontrollierten Unterbrechung führen und das System in einem unbrauchbaren Zustand hinterlassen.

Sobald das Deployment gestartet wurde, wird der iCAS-Server vollständig automatisch bereitgestellt, installiert und konfiguriert. Sobald der Terraform-Output ein erfolgreiches Deployment meldet, können Sie sich beispielsweise über die Web-Konsole im STACKIT Portal mit dem Server verbinden. Im ersten Schritt wird der Server bereitgestellt und einige nachgelagerte Einstellungen werden vorgenommen. Der Abschluss dieses Schritts wird durch ein Meldungsfenster in der Web-Konsole angezeigt.

Anschließend kann die Windows-Anmeldung erfolgen. Standardmäßig wird der lokale Benutzer admin verwendet. Das zugehörige Passwort wird zufällig generiert und im Terraform-Output angezeigt. Nachdem der Windows Server bereit ist, wird die iCAS-Installation und -Konfiguration automatisch im Hintergrund gestartet. Dieser Vorgang wird durch eine README-Datei auf dem Desktop angezeigt. Solange diese Datei existiert, ist die iCAS-Installation und -Konfiguration noch nicht abgeschlossen. Während dieser Zeit dürfen keine manuellen Änderungen am System vorgenommen werden. Der aktuelle Fortschritt kann in der in der README genannten Log-Datei eingesehen werden.

Um das gesamte Deployment abzuschließen, wird der Server neu gestartet. Danach kann der iCAS-Server verwendet werden. Sobald der Server neu gestartet wurde, können Sie das System nutzen.

  1. Öffnen Sie eine Eingabeaufforderung. Für dieses Beispiel gehen wir von einer Bash-Shell (z. B. Git-Bash) aus und davon, dass sich alle Dateien (terraform.exe, .env, Terraform-Dateien und Deployment-Dateien von GitHub) im selben Verzeichnis befinden. Wenn Sie keine Bash-Shell, sondern ein anderes Tool verwenden, müssen die Variablen aus der .env angepasst oder direkt in den Terraform-Dateien gesetzt werden. Wenn Sie die .env-Datei anders benannt haben, ersetzen Sie die Datei im Folgenden entsprechend. Screenshot eines Git-Bash-Terminalfensters, das im Pfad „/e/iCAS/Terraform“ geöffnet ist. Die Ausgabe zeigt das Ergebnis des „ls“-Befehls und listet verschiedene Konfigurationsdateien auf, darunter mehrere nummerierte Terraform-Dateien von „00-provider.tf“ bis „07-icas.tf“, eine README.md-Datei, eine iCAS.env-Datei und die ausführbare Datei terraform.exe.

  2. Stellen Sie sicher, dass alle Werte in der .env-Datei gesetzt sind. Screenshot eines Git-Bash-Terminalfensters, das die Ausgabe des Befehls „cat iCAS.env“ zeigt. Die Datei enthält mehrere Umgebungsvariablen, die per „export“ definiert wurden, einschließlich Terraform-Variablendeklarationen für Zugangsdaten-Parameter wie Tenant-ID, Benutzername, Passwort, Projekt-ID und Dienstkonto-Schlüssel, gefolgt von VM-Infrastruktureigenschaften wie Flavor, Verfügbarkeitszone, Speicheroptionen und Konfigurationen von Netzwerken.

  3. Stellen Sie sicher, dass alle Werte in der iCAS-Konfigurationsdatei 03-config_data gesetzt sind. Screenshot eines Git-Bash-Terminalfensters, das den Inhalt der JSON-Konfigurationsdatei „03-config_data“ mittels des „cat“-Befehls anzeigt. Die JSON-Struktur enthält verschachtelte Objekte für MailConfiguration, S3Configuration mit vordefinierter Endpunkt-URL und Variablenschlüsseln sowie einen Applications-Block, der Eigenschaften wie Freigabename, Aufbewahrungszeitraum und Komprimierung für die Anwendungen „Custom Autocommit“ und „Custom ReadOnly“ definiert.

  4. Initialisieren Sie die .env-Variablen.

    Terminal-Fenster
    source.env

    Screenshot eines Git-Bash-Terminalfensters, das die Ausführung des Befehls „source iCAS.env“ im Pfad „/e/iCAS/Terraform“ zeigt. Der Befehl wird erfolgreich und ohne Ausgabe im Terminal abgeschlossen, sodass direkt die nächste Eingabeaufforderung angezeigt wird.

  5. Initialisieren Sie die Umgebung (nur bei der ersten Ausführung erforderlich).

    Terminal-Fenster
    terraform init

    Screenshot eines Git-Bash-Terminalfensters, das die Ausgabe des Befehls „./terraform.exe init“ zeigt. Das Terminal protokolliert die Initialisierung des Backends sowie das erfolgreiche Herunterladen und Installieren von Provider-Plugins für OpenStack, STACKIT, HashiCorp Random und HashiCorp Template. Es endet mit einer grünen Bestätigungsmeldung „Terraform has been successfully initialized!“.

  6. Planen Sie das Deployment (optional).

    Terminal-Fenster
    terraform plan

    Screenshot eines Git-Bash-Terminalfensters, das den ersten Teil der Ausgabe des Befehls „./terraform.exe plan“ zeigt. Das Protokoll meldet das erfolgreiche Einlesen einer Daten-Template-Datei, gefolgt von einer Erklärung der Plan-Symbole, wobei „plus“ für das Erstellen einer Ressource und „kleinergleich“ für das Einlesen einer Datenressource steht. Screenshot eines Git-Bash-Terminalfensters, das die Zusammenfassung einer „terraform plan“-Ausführung zeigt. Der Text gibt an: „Plan: 19 to add, 0 to change, 0 to destroy“ und weißt auf eine neue Ausgabe-Variable „+ windows_password = (known after apply)“ hin. Ein Hinweis am unteren Rand warnt, dass der Plan nicht mit der Option „-out“ gespeichert wurde.

  7. Führen Sie das Deployment aus.

    Terminal-Fenster
    terraform apply

    Screenshot eines Git-Bash-Terminalfensters, das den Beginn der Ausführung des Befehls „./terraform.exe apply“ im Pfad „/e/iCAS/Terraform“ zeigt. Die erste Protokollzeile meldet, dass eine Daten-Template-Datei eingelesen wird. Überprüfen Sie die angezeigten Informationen und geben Sie „yes“ ein, um das Deployment zu starten. Screenshot eines Git-Bash-Terminalfensters, das den Ausgabeblock nach erfolgreicher Ausführung von Terraform zeigt. Unter der grünen Überschrift „Outputs:“ wird der generierte Wert für „windows_password“ angezeigt, der aus Sicherheitsgründen stark verpixelt ist. Notieren Sie sich das Windows-Passwort für die zukünftige Verwendung.

  8. Warten Sie, bis der erste Deployment-Schritt abgeschlossen ist und durch ein Meldungsfenster angezeigt wird. Screenshot eines Windows-Meldungsfensters (Message Box). Die Titelzeile lautet „Message from 1/22/2024 11 AM“. Der Meldungstext besagt „We have completed the access configuration, you can log in now.“ und unten rechts befindet sich eine „OK“-Schaltfläche, auf die der Mauszeiger zeigt.

  9. Nun ist eine Anmeldung möglich. Die noch laufende iCAS-Installation wird durch eine Textdatei auf dem Desktop angezeigt. Nahaufnahme-Screenshot eines Desktop-Datei-Icons. Das Symbol zeigt das Bild eines Dokuments auf hellblauem Grund mit dem Text „README - iCAS installation in progress“.

  10. Warten Sie, bis der Server automatisch neu startet. Dies kann einige Zeit in Anspruch nehmen. Nach dem Neustart und einer Anmeldung ist die iCAS-Installation abgeschlossen.

Wenn die iCAS-VM produktiv genutzt werden soll, wenden Sie sich bitte an das iTernity Sales Team, um die nächsten Schritte zu besprechen.

Wenn Sie Fragen oder Probleme mit dem Deployment haben, wenden Sie sich bitte an den STACKIT Support oder den iTernity Support, je nach Bereich Ihrer Anfrage. Für Anfragen zum Terraform-Deployment und zur virtuellen Infrastruktur wenden Sie sich bitte an STACKIT. Für Anfragen zur iCAS-Installation wenden Sie sich bitte an iTernity.