Setup
Diese Bereitstellung erstellt eine iCAS-VM mit einer 20-GB-Demo-Lizenz.
Wenn Sie planen, die iCAS-VM für die Produktion zu nutzen, wenden Sie sich bitte an das iTernity Sales Team, um die nächsten Schritte zu besprechen.
Haben Sie Fragen oder Probleme bei der Bereitstellung? Sie können sich je nach Themenbereich entweder an den STACKIT Support oder den iTernity Support wenden.
-
Bei Fragen zu Terraform oder der Infrastrukturschicht (VMs, Datenträger, Netzwerk, S3 usw.) wenden Sie sich an den STACKIT Support.
-
Bei Fragen zur iCAS-Software und zum Installationsprozess wenden Sie sich an den iTernity Support.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“Terraform
Abschnitt betitelt „Terraform“Um iCAS bereitzustellen, benötigen Sie eine funktionierende Terraform-Umgebung und die neuesten Deployment-Skripte.
-
Sie können Terraform von der offiziellen Website herunterladen: Install Terraform
-
Die Deployment-Skripte für Terraform finden Sie auf GitHub: iTernity Terraform Deployment
Einrichtung der Umgebung
Abschnitt betitelt „Einrichtung der Umgebung“Eine .env-Datei konfiguriert Ihren Server. Die Datei hat die folgende Struktur:
# Required Settingsexport TF_VAR_TENANTID=<OpenStackProjectID>export TF_VAR_USERNAME=<UATUsername>export TF_VAR_PASSWORD=<UATPassword>export TF_VAR_STACKIT_PROJECT_ID=<STACKITProjectID>export TF_VAR_STACKIT_SERVICE_ACCOUNT_TOKEN=<STACKITServiceAccountToken>
#Optional Settingsexport TF_VAR_vm_name=<VMName>export TF_VAR_flavor=<VMFlavor>export TF_VAR_availability_zone=<AvailabilityZone>export TF_VAR_root_storage_type=<StorageTypeRootPartition>export TF_VAR_data_storage_type=<StorageTypeiCasDataPartition>export TF_VAR_metadata_storage_type=<StorageTypeiCasMetaPartition>export TF_VAR_root_storage_size=<StorageSizeRootPartition>export TF_VAR_data_storage_size=<StorageSizeiCasDataPartition>export TF_VAR_metadata_storage_size=<StorageSizeiCasMetaPartition>export TF_VAR_lan_netrange=<InternalLanRange>Die folgenden Tabellen erläutern die erforderlichen und optionalen Parameter.
| Variablenname | Platzhalter | Beschreibung |
|---|---|---|
TF_VAR_TENANTID | OpenStackProjectID | Die OpenStack Project ID. Diese finden Sie im STACKIT Portal unter Zugriff > Infrastructure API. |
TF_VAR_USERNAME | UATUsername | Der Benutzername für das Zugriffstoken (UAT). Wenn Sie kein UAT haben, erstellen Sie eines im STACKIT Portal unter Zugriff > Infrastructure API. |
TF_VAR_PASSWORD | UATPassword | Das Passwort für Ihr UAT. Dieses wird erstellt, wenn Sie das Token generieren. |
TF_VAR_STACKIT_PROJECT_ID | STACKITProjectID | Ihre STACKIT Project ID. Diese finden Sie auf Ihrem Projekt-Dashboard im STACKIT Portal. |
TF_VAR_STACKIT_SERVICE_ACCOUNT_TOKEN | STACKITServiceAccountToken | Das Token für Ihr Service-Konto. |
| Variablenname | Platzhalter | Beschreibung |
|---|---|---|
TF_VAR_vm_name | VMName | Der Name der VM im STACKIT Portal und der Windows-Hostname. |
TF_VAR_flavor | VMFlavor | Das Flavor der VM, das die CPU- und RAM-Konfiguration definiert. Wählen Sie ein Flavor, das die Mindestanforderungen für eine iCAS Object Storage-Installation erfüllt. Weitere Informationen finden Sie im iTernity Support Portal Download Area und in der Virtual Machine flavors-Dokumentation. |
TF_VAR_availability_zone | AvailabilityZone | Die STACKIT-Availability-Zone für den iCAS-Server, zum Beispiel eu01-1. Weitere Informationen finden Sie in der Regions and Availability Zones-Dokumentation. |
TF_VAR_root_storage_type | StorageTypeRootPartition | Der Speichertyp für den Root-Datenträger des iCAS-Servers, auf dem das Betriebssystem installiert wird. Wir empfehlen die Verwendung der Leistungsklasse storage_premium_perf4 oder höher. Weitere Informationen finden Sie in der Block Storage-Servicepläne-Dokumentation. |
TF_VAR_data_storage_type | StorageTypeiCasDataPartition | Der Speichertyp für den Datenträger, auf dem archivierte Daten vorübergehend abgelegt werden, bevor sie in den Object Storage übertragen werden. Wir empfehlen die Verwendung der Leistungsklasse storage_premium_perf4 oder höher. |
TF_VAR_metadata_storage_type | StorageTypeiCasMetaPartition | Der Speichertyp für den Metadaten-Datenträger, auf dem iCAS-Metadaten gespeichert werden. Wir empfehlen die Verwendung der Leistungsklasse storage_premium_perf4 oder höher. |
TF_VAR_root_storage_size | StorageSizeRootPartition | Die Größe des Root-Datenträgers in GB, zum Beispiel 100. Wählen Sie eine Größe, die für das von Ihnen gewählte Betriebssystem empfohlen wird. |
TF_VAR_data_storage_size | StorageSizeiCasDataPartition | Die Größe des Datenträgers in GB, zum Beispiel 1000 (1 TB). Der Wert muss größer als die Größe des Metadaten-Datenträgers sein. Wir empfehlen mindestens 1 TB. |
TF_VAR_metadata_storage_size | StorageSizeiCasMetaPartition | Die Größe des Metadaten-Datenträgers in GB, zum Beispiel 500. Der Wert muss kleiner als die Größe des Datenträgers sein. Wir empfehlen mindestens 500 GB. |
TF_VAR_lan_netrange | InternalLanRange | Der interne STACKIT-LAN-Bereich. Wählen Sie einen IP-Bereich in CIDR-Notation, der für Ihre Umgebung geeignet ist, zum Beispiel 192.168.0.0/24. |
iCAS-Konfiguration
Abschnitt betitelt „iCAS-Konfiguration“Der GitHub-Download enthält 03-config_data, eine JSON-Konfigurationsdatei für iCAS. Passen Sie deren Inhalt an Ihre Bedürfnisse an. Benennen Sie die Datei nicht um und ändern Sie die S3-Einstellungen nicht, da Terraform diese verwaltet.
E-Mail-Konfiguration
Abschnitt betitelt „E-Mail-Konfiguration“Sie können ein iCAS-E-Mail-Benachrichtigungssystem aktivieren, um Fehler- und Warnmeldungen zu erhalten.
| Parameter | Beschreibung |
|---|---|
RecipientMailAddress | Die E-Mail-Adresse, an die iCAS E-Mails sendet. Der Wert muss eine gültige E-Mail-Zeichenfolge oder eine leere Zeichenfolge sein. |
SenderMailAddress | Die E-Mail-Adresse, die iCAS als Absender verwendet. Der Wert muss eine gültige E-Mail-Zeichenfolge oder eine leere Zeichenfolge sein. |
MailServer | Der Server, der zum Senden von E-Mails verwendet wird. Der Wert muss ein gültiger Hostname, eine IPv4-Adresse oder eine leere Zeichenfolge sein. |
{ "MailConfiguration": { "RecipientMailAddress": "icas-info@example.com", "SenderMailAddress": "icas-server@example.com", "MailServer": "mail.example.com" }, ...}S3-Konfiguration
Abschnitt betitelt „S3-Konfiguration“Diese Werte werden automatisch von Terraform ausgefüllt, um eine Verbindung zum Object Storage herzustellen. Ändern Sie diese nicht.
{ ... }, "S3Configuration": { "S3EndpointURL": "https://object.storage.eu01.onstackit.cloud", "S3AccessKey": "${access_key}", "S3SecretKey": "${secret_access_key}" }, ...}Applikationen
Abschnitt betitelt „Applikationen“In diesem Abschnitt wird der Zugriff für Applikationen konfiguriert, die Daten auf iCAS schreiben, archivieren und lesen. Der Zugriff wird über Shares und Repositorys abgebildet. Jede Applikation verfügt in der Regel über einen eigenen Share und ein eigenes Repository.
Wenn Sie unsicher sind, wie Sie Ihre Applikation konfigurieren sollen, wenden Sie sich an den iTernity Support.
| Parameter | Beschreibung |
|---|---|
Application | Konfiguriert, wie die Applikation Daten archiviert. Die zwei möglichen Werte sind: Custom ReadOnly: Die Archivierung wird ausgelöst, wenn die Applikation das Attribut „Schreibgeschützt“ der Datei setzt. Custom Auto-commit: Die Archivierung wird ausgelöst, wenn die Applikation eine Datei schließt. |
Sharename | Der Name für den iCAS-Share und der SMB-Share-Name, den die Applikation für den Zugriff verwendet. Der Wert muss eine Zeichenfolge sein. |
Repositoryname | Der Name für das iCAS-Repository und der Bucket-Name im Object Storage. Der Repository-Name entspricht in der Regel dem Share-Namen. Der Wert muss eine Zeichenfolge sein, die den Namenskonventionen für STACKIT S3-Buckets entspricht (keine Leer- oder Sonderzeichen) und global eindeutig ist. |
DefaultRetentionValue | Definiert den Mindestaufbewahrungswert für diesen Share in Kombination mit DefaultRetentionUnit. Der Wert muss eine Ganzzahl von 0 bis 999 sein. Die Applikation kann einen höheren Wert festlegen, indem sie das Attribut LastAccessTime der Datei anpasst. |
DefaultRetentionUnit | Definiert die Mindestaufbewahrungseinheit für diesen Share in Kombination mit DefaultRetentionValue. Der Wert muss eine Zeichenfolge mit einem der folgenden gültigen Werte sein: Days, Months oder Years. |
Encryption | Steuert, ob Dateien im Backend verschlüsselt werden (true) oder nicht (false). Der Standardwert ist true. |
Compression | Steuert, ob Dateien im Backend komprimiert werden (true) oder nicht (false). Der Standardwert ist false. |
{ ... }, "Applications": [ { "Application": "Custom Autocommit", "Sharename": "share1", "Repositoryname": "repository1", "DefaultRetentionValue": 1, "DefaultRetentionUnit": "Days", "Encryption": true, "Compression": false }, { "Application": "Custom ReadOnly", "Sharename": "share2", "Repositoryname": "repository2", "DefaultRetentionValue": 0, "DefaultRetentionUnit": "Days", "Encryption": true, "Compression": false } ]}