Server umziehen

Hier erfahren Sie, wie Sie einen unter Linux installierten SpaceBuilder auf einen neuen Server umziehen. Kopieren Sie den Konfigurationsordner und den Datenspeicherpfad auf den neuen Server und registrieren Sie dort die Lizenz neu.

Bevor Sie beginnen

Die Schritte führen Sie im Terminal des bisherigen und des neuen Servers aus.
Während des Umzugs ist die Verbindung unterbrochen. Führen Sie ihn daher zu einer Zeit mit wenigen Benutzern durch.
Prüfen Sie, ob der neue Server über genügend Speicherplatz für die vorhandenen Daten verfügt.
Es empfiehlt sich, auf dem neuen Server denselben Benutzerkontonamen und dieselben Pfade wie auf dem bisherigen Server zu verwenden. Bei abweichenden Pfaden müssen Sie die Konfigurationsdatei anpassen.

Zu übertragende Elemente prüfen

Ort	Inhalt
`~/.config/SetFN`	Konfigurationsdateien, Benutzerkonten und Servereinstellungsdaten
Datenspeicherpfad	Von Teams und Benutzern gespeicherte Dateien

Den Datenspeicherpfad ermitteln Sie auf dem bisherigen Server mit folgendem Befehl.

~/setfn-spacebuilder homepath get

Auf dem bisherigen Server vorbereiten

Führen Sie in der Lizenzverwaltung auf der Administrator-Startseite Lizenz freigeben aus. Die Lizenz ist an das Gerät gebunden und kann erst nach der Freigabe auf dem neuen Server registriert werden.
Stoppen Sie SpaceBuilder.
```
sudo systemctl stop setfn-spacebuilder
```

Kopieren Sie den Konfigurationsordner und den Datenspeicherpfad an denselben Pfad auf dem neuen Server. Das folgende Beispiel verwendet rsync.

rsync -a ~/.config/SetFN/ <Benutzer>@<Adresse des neuen Servers>:~/.config/SetFN/
rsync -a <Datenspeicherpfad>/ <Benutzer>@<Adresse des neuen Servers>:<Datenspeicherpfad>/

Auf dem neuen Server starten

Bereiten Sie die Installationsdatei gemäß Installation unter Linux vor. Verwenden Sie dieselbe Version wie auf dem bisherigen Server. Die Version ermitteln Sie auf dem bisherigen Server mit ~/setfn-spacebuilder version.
Weicht der Datenspeicherpfad vom bisherigen Server ab, passen Sie den Pfad in ~/.config/SetFN/config.yaml an.
```
server:
  homeFolder: <neuer Datenspeicherpfad>
```
Richten Sie den automatischen Start gemäß Installation unter Linux ein und starten Sie SpaceBuilder.
```
sudo systemctl start setfn-spacebuilder
```
Melden Sie sich auf der Administrationsseite an und registrieren Sie die Lizenz in der Lizenzverwaltung erneut.
Ändern Sie die Adresse, über die Benutzer zugreifen, so, dass sie auf den neuen Server zeigt. Lesen Sie dazu Zugriffsadresse ermitteln (lokal/internes Netzwerk) und Methode für den externen Zugriff auswählen.

Ergebnis des Umzugs prüfen

Prüfen Sie, ob die Anmeldung mit den bisherigen Konten funktioniert.
Prüfen Sie, ob die Dateien in den Teamordnern und persönlichen Ordnern sichtbar sind.
Prüfen Sie auf der Administrator-Startseite den Lizenzstatus.
Wenn Sie eine externe Vektordatenbank wie Qdrant oder Milvus verwenden, prüfen Sie im Wissensspeicher, ob der neue Server eine Verbindung zu diesem Server herstellt.

Parallel zum bisherigen Server betreiben

Wenn Sie den bisherigen Server weiterbetreiben und den kopierten Server getrennt davon betreiben möchten, führen Sie vor dem ersten Start des kopierten Servers die folgenden Befehle aus.

~/setfn-spacebuilder admin vector-instance-id
~/setfn-spacebuilder admin prepare-clone <ausgegebene UUID>

Der erste Befehl gibt die aktuelle Instanz-UUID aus. Der zweite Befehl weist dem kopierten Server eine neue Instanz-UUID zu und legt den mitkopierten Wissensindex gesondert ab. Beim Start des Servers wird der Wissensindex aus den gespeicherten Dateien neu aufgebaut.

Auch auf dem kopierten Server müssen Sie eine Lizenz registrieren. Die Anzahl der betreibbaren Server hängt vom Tarif ab.

Hinweise

Löschen Sie die Daten des bisherigen Servers erst, nachdem der Umzug abgeschlossen ist und Sie geprüft haben, dass der neue Server einwandfrei läuft. Das Vorgehen beim Löschen finden Sie unter SpaceBuilder deinstallieren.
Führen Sie die Befehle bei gestopptem SpaceBuilder aus. Weitere Informationen finden Sie unter Server über Befehle verwalten.