# Vorbereitung

# 01 – Überblick und Voraussetzungen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Du beschreibst ein neues Freeze-Projekt (Archiv-Hosting für Otris EAS/EDA) vollständig in Bitwarden. Die Plattform liest die Angaben automatisch, stellt die benötigte Serverkapazität bereit und richtet das Archiv ein. Als Consultant brauchst du dafür keinen Zugriff auf die technischen Systeme dahinter und startest nichts selbst.

## So läuft die Bereitstellung ab

**Bitwarden → Projektzuweisung → Server-Bereitstellung → Projekt-Bereitstellung → Prüfung in Bitwarden und im EAS Manager**

| Schritt | Was passiert? |
|---|---|
| Bitwarden | Du hinterlegst Projektangaben, Lizenz und Verschlüsselungsschlüssel. |
| Projektzuweisung | Die automatische Verarbeitung liest die Projekte und weist ihnen einen passenden Server zu. Sie gilt gemeinsam für Breeze und Freeze. |
| Server-Bereitstellung | Die benötigten Server werden bereitgestellt oder abgeglichen. |
| Projekt-Bereitstellung | Das EAS-Archiv wird eingerichtet. In der Projekt-Collection entstehen zusätzliche Einträge. |
| Abschluss | Du prüfst die Einträge und die Anmeldung am EAS Manager. |

Das Speichern in Bitwarden startet keinen sofortigen Lauf. Die Änderung wird beim nächsten automatischen Durchlauf berücksichtigt (Zeiten siehe **04 – Automatische Bereitstellung abwarten**). Danach braucht die eigentliche Bereitstellung zusätzliche Zeit.

## Breeze und Freeze zusammen

Ein vollständiger Kundenstack besteht aus Breeze (Otris DOCUMENTS) und Freeze (Otris EAS/EDA als Archiv). Beide Projekte beschreibst du getrennt: je eine eigene Projekt-Collection mit eigener Notiz (`brz_project` bei Breeze, `frz_project` bei Freeze). Die Plattform richtet sie unabhängig voneinander ein, kein Feld verweist auf das jeweils andere Projekt. Du kannst die beiden Projekte also in beliebiger Reihenfolge anlegen. Die Anbindung von DOCUMENTS an das EAS-Archiv richtest du nach der Bereitstellung beider Projekte in DOCUMENTS selbst ein. Details dazu klärst du mit dem Plattformteam.

Gemeinsam sind beiden Büchern Tresor, Partner, Standort, Zeitplan der automatischen Durchläufe und die persönlichen Zugänge. Wie du das Breeze-Projekt anlegst, steht im Buch [Breeze from Pipeline](https://docs.squeeze.one/books/breeze-from-pipeline). Gemeinsame Abläufe sind hier kurz beschrieben und verweisen dorthin. Alles, was nur für Freeze gilt, steht vollständig in diesem Buch.

## Das brauchst du vorher

- Zugriff auf die vorgesehene Bitwarden-Organisation und die Projekt-Collection. Zum Anlegen einer Collection gegebenenfalls Unterstützung durch die Bitwarden-Verwaltung.
- Die EAS-Lizenz des Kunden.
- Einen Verschlüsselungsschlüssel für das Projekt (siehe **02 – Projekt in Bitwarden anlegen**). Ohne ihn wird das Projekt nicht eingerichtet.
- Die vereinbarten Projektangaben: Partner, Standort, Größe, technischer Kurzname und Store-Namen (siehe **03 – Projektfelder ausfüllen**).
- Optional: einen persönlichen SSH-Zugang für Server-Zugriffe.

### Persönlichen SSH-Zugang vorbereiten (optional)

Freeze nutzt dieselben persönlichen Logins wie Breeze. Sie liegen in Bitwarden unter **Kundensysteme → Breeze User**. Hast du dort bereits einen Login, verwende ihn weiter. Andernfalls legst du ihn wie im Breeze-Buch auf der Seite **01 – Überblick und Voraussetzungen** beschrieben an. Trage anschließend den eindeutigen Namen des Login-Eintrags in das Feld `freeze_custom_admins` der Notiz `frz_project` ein, bei mehreren Personen durch Kommas getrennt.

<p class="callout warning">Der Wert in <code>freeze_custom_admins</code> bezeichnet den Namen des Bitwarden-Login-Eintrags. Der Login-Eintrag muss eindeutig auffindbar sein. Das Feld legt keine EAS-Benutzer an.</p>

## Drei Namen, die du auseinanderhalten solltest

| Name | Beispiel | Bedeutung |
|---|---|---|
| Projekt-Collection | `Musterfirma Archiv` | Ihr vollständiger Name wird zum Projektnamen. Er steht später als Präfix in den erzeugten Einträgen. |
| Bitwarden-Eintrag | `frz_project` | Fester Name, an dem die Plattform die Projektbeschreibung erkennt. Daneben braucht jedes Projekt das Login `frz_encryption`. |
| Technischer Kurzname | `musterfirma-archiv` | Wert von `freeze_unique_name`. Wird unter anderem für die interne Adresse des EAS Managers und die Namen der Speicherbereiche verwendet. |

## Der Tresor bestimmt die Zielumgebung

Wie bei Breeze ergibt sich die Zielumgebung aus dem Bitwarden-Tresor, in dem du die Projekt-Collection anlegst. Du wählst nichts weiter aus:

- **Kundensysteme:** Systeme realer Kunden, einschließlich Kunden-Testsystemen, sowie Demo-Systeme.
- **Interne Systeme:** interne Entwicklungs- und Vorabsysteme des Plattformteams.

Innerhalb von **Kundensysteme** entscheidet der Partner, ob es ein Produktivsystem oder ein Demo-System ist (siehe **03 – Projektfelder ausfüllen**).

Weiter: **02 – Projekt in Bitwarden anlegen**

# 02 – Projekt in Bitwarden anlegen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Für jedes neue Freeze-Projekt brauchst du eine eigene Collection mit genau einer sicheren Notiz namens `frz_project` und genau einem Login namens `frz_encryption`. Diese Seite zeigt, wie du Collection, Notiz, Lizenz und Schlüssel anlegst.

## 1. Die Projekt-Collection vorbereiten

1. Öffne den für die Zielumgebung vorgesehenen Tresor in Bitwarden (siehe **01 – Überblick und Voraussetzungen**).
2. Lege eine neue Collection an oder verwende die dafür bereitgestellte, noch nicht belegte Projekt-Collection.
3. Verwende einen eindeutigen Projektnamen, beispielsweise `Musterfirma Archiv`. Wähle einen einfachen Namen aus Buchstaben ohne Umlaute, Zahlen, Leerzeichen, Bindestrich und Unterstrich. Beginne mit einem Buchstaben oder einer Zahl und vermeide Leerzeichen am Anfang oder Ende. Verwende keine Schrägstriche, Punkte oder `&`.
4. Stelle sicher, dass sowohl die zuständigen Personen als auch der Automatisierungszugang Zugriff haben. Lass fehlende Berechtigungen durch die Verwaltung ergänzen.

Der vollständige Collection-Name wird als Projektname übernommen. Die Screenshots zur Collection-Anlage findest du im Breeze-Buch auf der Seite **02 – Projekt in Bitwarden anlegen**. Der Ablauf ist bei Freeze identisch.

## 2. Die sichere Notiz anlegen

1. Erstelle in der Collection einen Eintrag vom Typ **Sichere Notiz**.
2. Vergib exakt den Namen `frz_project`.
3. Lege in dieser Collection genau eine Notiz mit diesem Namen an.
4. Trage die Projektfelder als benutzerdefinierte Textfelder ein. Die Feldnamen und Werte stehen auf **03 – Projektfelder ausfüllen**.

## 3. Die EAS-Lizenz einfügen

Kopiere die vollständige, mehrzeilige EAS-Lizenz (`.pem`-Inhalt) in den großen Notiztext der Notiz `frz_project`. Die Zeilenumbrüche müssen erhalten bleiben. Schreibe keine Erläuterungen dazu und verwende weder ein einzeiliges Feld noch einen Anhang. Ohne Zeilenumbrüche im Notiztext wird das Projekt nicht eingerichtet. Der Lizenzinhalt gehört nicht in Chats, Tickets oder E-Mails.

## 4. Das Login `frz_encryption` anlegen

Jedes Freeze-Projekt braucht einen Verschlüsselungsschlüssel. Er verschlüsselt alle Stores des Projekts. Die Plattform erzeugt ihn nie selbst. Du erzeugst ihn mit dem Passwortgenerator von Bitwarden und hinterlegst ihn vor der Bereitstellung in der Projekt-Collection.

1. Erstelle in **derselben** Collection einen Eintrag vom Typ **Login**.
2. Vergib exakt den Namen `frz_encryption`.
3. Erzeuge im Feld **Passwort** mit dem Passwortgenerator einen Schlüssel: Typ **Passwort**, Länge **64**, Groß- und Kleinbuchstaben und Zahlen an, **Sonderzeichen aus**. So enthält der Schlüssel keine verbotenen Zeichen.
4. Lege genau ein Login mit diesem Namen in der Collection an.

| Regel | Wert |
|---|---|
| Länge | 32 bis 128 Zeichen |
| Verbotene Zeichen | Leerraum jeder Art sowie `$`, `;` und `#` |
| Anzahl | genau ein Login `frz_encryption` je Projekt-Collection |
| Änderung | nie ändern, überschreiben oder löschen |

<p class="callout danger">Der Schlüssel darf nach der ersten Verwendung nie geändert oder gelöscht werden. Ein anderer Schlüssel macht alle bereits verschlüsselten Archive des Projekts unlesbar. Der Schlüssel liegt ausschließlich in Bitwarden. Das gilt auch nach einer Kündigung des Projekts.</p>

## 5. Speichern und gegenprüfen

Speichere erst, wenn Projektfelder, Lizenz und Schlüssel vollständig sind. Öffne beide Einträge danach erneut und prüfe Collection-Zuordnung, Feldwerte, Zeilenumbrüche der Lizenz und die Schlüsselregeln. Der nächste automatische Durchlauf berücksichtigt die gespeicherten Einträge (Zeiten siehe **04 – Automatische Bereitstellung abwarten**).

## Die Statusnotiz `frz_project_status`

Neben `frz_project` legt die Plattform in der Projekt-Collection selbst eine zweite Notiz an: `frz_project_status`. Sie ist nur zum Lesen gedacht und deine Änderungen daran werden überschrieben. Sie nennt in Klartext:

- ob das Projekt in Ordnung ist (`Projekt: ok`) oder was an der Projektbeschreibung fehlerhaft ist, zum Beispiel ein fehlendes Pflichtfeld oder ein fehlendes Schlüssel-Login,
- welcher Server zugeteilt wurde, oder dass noch keiner zugeteilt ist,
- einen Hinweis, wenn eine Kündigung vorgemerkt ist, und
- einen Hinweis, wenn eine gelöschte Notiz wiederhergestellt wurde.

<p class="callout success">Die Statusnotiz ist deine erste Anlaufstelle, wenn etwas nicht wie erwartet läuft. Sie prüft allerdings nicht alles: Kurzname, Store-Liste und Lizenz fallen erst bei der Einrichtung auf (siehe <strong>06 – Probleme und spätere Änderungen</strong>).</p>

Weiter: **03 – Projektfelder ausfüllen**

# 03 – Projektfelder ausfüllen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Lege die folgenden Angaben als **benutzerdefinierte Textfelder** in `frz_project` an. Kopiere die Feldnamen exakt und lege jeden Namen nur einmal an. Die Beispielwerte sind fiktiv und müssen zu deinem Auftrag passen.

## Angaben für ein neues Projekt

| Feldname | Was trägst du ein? | Beispiel |
|---|---|---|
| `freeze_partner` | Den für diesen Tresor eingerichteten Partnerwert, siehe Tabelle unten. Kleinschreibung. | `dexpro` |
| `freeze_ressource_sizing` | Die vereinbarte Größe: `small`, `medium` oder `large`. | `small` |
| `freeze_deployment_site` | Das vereinbarte Standortkürzel. Derzeit gibt es nur `bre1`. | `bre1` |
| `freeze_unique_name` | Einen abgestimmten, eindeutigen technischen Kurznamen. Verwende kleine Buchstaben, Zahlen und bei Bedarf Bindestriche, und halte ihn kurz (siehe unten). | `musterfirma-archiv` |
| `freeze_eas_stores` | Die Namen der Stores, durch Kommas getrennt (siehe unten). Mindestens ein Store. | `archiv,rechnungen` |

**Achte auf die Schreibweise `freeze_ressource_sizing`:** Sie ist mit doppeltem „s“ geschrieben und muss genau so angelegt werden.

Die EAS-Lizenz gehört nicht in ein Feld, sondern in den Notiztext (siehe **02 – Projekt in Bitwarden anlegen**).

### Welche Partner gibt es?

Je nach Tresor sind nur bestimmte Partner freigeschaltet:

| Tresor und Umgebung | Partner |
|---|---|
| Kundensysteme, Produktivsysteme | `dexpro`, `mdt`, `easycompetence` |
| Kundensysteme, Demo-Systeme | `demo` |
| Interne Systeme des Plattformteams | `dev`, `pre-dev` |

Eine nicht freigeschaltete Kombination aus Partner und Standort wird nicht eingerichtet.

<p class="callout warning">Ein Wechsel von <code>freeze_partner</code> oder <code>freeze_deployment_site</code> bei einem bestehenden Projekt ist gesperrt und blockiert die automatische Verarbeitung der gesamten Umgebung, bis die Änderung zurückgenommen ist, nicht nur dieses Projekts. Beides erfordert einen Auftrag an das Plattformteam.</p>

### Was sind Stores?

Ein Store ist ein eigener Archivbereich innerhalb des EAS-Projekts. Das Archiv selbst liegt nicht auf dem Server, sondern je Store in einem eigenen Speicherbereich (Bucket). Für jeden Store legt die Plattform einen Speicherzugang an und hinterlegt ihn als Eintrag in der Projekt-Collection (siehe **05 – Ergebnis prüfen und übergeben**). Du trägst keine Speicherzugangsdaten ein.

Für `freeze_eas_stores` gilt:

- Namen durch Kommas trennen, zum Beispiel `archiv,rechnungen`.
- Erlaubt sind Kleinbuchstaben, Ziffern und Bindestrich. Ein Name beginnt mit einem Buchstaben oder einer Ziffer.
- Kein Name darf der Anfang eines anderen Namens sein. `store1` und `store10` zusammen sind also nicht erlaubt.
- Der Name des Speicherbereichs setzt sich aus Umgebung, Partner, Kurzname und Store-Name zusammen und darf höchstens 63 Zeichen lang sein. Halte Kurzname und Store-Namen deshalb kurz.

Stimme nachträgliche Änderungen an der Store-Liste immer vorher mit dem Plattformteam ab.

## Optionale Angaben

| Feldname | Wann verwenden? | Eingabe |
|---|---|---|
| `freeze_disk_gb` | Wenn das Projekt mehr lokalen Platz als die Standardvorgabe braucht. Das Feld betrifft nur Index, Registry, Audit und Schlüssel auf dem Server, nicht das Archiv. | Ganze Zahl in GB. Ohne Wert rechnet die Plattform mit 10 GB. Ein nicht numerischer Wert macht die Projektbeschreibung fehlerhaft. |
| `freeze_custom_admins` | Wenn vorhandene Consultant-/Administrator-Zugänge eingerichtet werden sollen. | Abgestimmte Namen von Login-Einträgen, durch Kommas getrennt, zum Beispiel `nachname-a,nachname-b`. |
| `freeze_version` | Wenn für das Projekt eine bestimmte freigegebene EAS-Version vorgegeben wurde. | Exakt die freigegebene Versionskennung. Ohne Wert gelten die Plattformvorgaben. |
| `freeze_eas_s3_provider` | Nur nach Absprache, um den Speicheranbieter festzulegen. | `gridscale` oder `wasabi`. Ohne Wert gilt `gridscale`. In Kundensystemen und Demo-Systemen ist nur `gridscale` zulässig. |
| `freeze_decommission` | Nur zum Stilllegen eines Projekts. | Datum `YYYY-MM-DD`. Lies zuerst **07 – Projekt kündigen**. |

Die Benutzer für `freeze_custom_admins` müssen als eindeutig auffindbare Login-Einträge in der Organisation **Kundensysteme**, Collection **Breeze User**, vorhanden sein. Die Plattform übernimmt daraus Benutzername und Zugang für administrative Server-Zugänge. Das Feld legt keine EAS-Benutzer an.

<p class="callout warning">Ein Größenwechsel (<code>freeze_ressource_sizing</code>) bestehender Projekte sowie eine Änderung von <code>freeze_disk_gb</code> sind Änderungen an der Serverzuweisung. Stimme sie vorher mit dem Plattformteam ab. Die Größe <code>enterprise</code> gibt es bei Freeze nicht; sie macht die Projektbeschreibung fehlerhaft.</p>

## Welche Projektgröße?

| Größe | Einordnung für die Planung |
|---|---|
| `small` | Kleinste Stufe. |
| `medium` | Mittlere Stufe. |
| `large` | Größte Stufe. |

Übernimm die im Auftrag vereinbarte Größe. Die Plattform entscheidet über die konkrete Serverzuweisung; du musst keinen Servernamen eintragen.

## Kurz-Checkliste vor dem Speichern

- ☐ Alle fünf Projektangaben ausgefüllt, Partner und Standort passen zum Tresor.
- ☐ Kurzname eindeutig und kurz, Store-Namen gültig und ohne Präfix-Überschneidung.
- ☐ Vollständige, mehrzeilige Lizenz im Notiztext.
- ☐ Genau ein Login `frz_encryption` mit gültigem Schlüssel in derselben Collection.
- ☐ Optionale Admin-Einträge vorhanden und eindeutig auffindbar.
- ☐ Eintrag gespeichert; keine Beispielwerte versehentlich übernommen.

Weiter: **04 – Automatische Bereitstellung abwarten**