Ändern der Speicherpfade einer BIMcloud (Basic) mit vorhandenen Daten

Problemstellung

Die Speicherpfade für Projekte und Bibliotheken einer BIMcloud Basic oder BIMcloud on Premise sollen verändert werden. Es sind am aktuellen Speicherort bereits Daten vorhanden.

Troubleshooting

Daten werden bei einer Änderung der Speicherpfade nicht automatisiert übertragen. Es muss ein Export der vorhandenen Daten durchgeführt, die Projekte und Bibliotheken anschließend auf der BIMcloud gelöscht, die Speicherpfade im Konfigurator geändert und die Daten dann wieder importiert werden.

Hinweis:

Die Speicherpfade einer installierten BIMcloud für Projekte und Bibliotheken sollten nicht einfach geändert werden, wenn bereits Daten vorhanden sind, da diese nicht automatisch in den neuen Speicherort verschoben werden.

Es muss ausreichend freier Speicherplatz auf der Systempartition zur Verfügung stehen, da die Daten dort beim Export und Import zwischengespeichert werden.

1. Export der bestehenden Daten

Für den Export von Projekten und Bibliotheken bestehen zwei Möglichkeiten:

1. Mit dem TeamworkServerBackupTool über die Kommandozeile:
   • Exportiert alle Projekte, Bibliotheken und die Nachrichtendatenbank auf einmal.
   • Das TeamworkServerBackupTool befindet sich im Installationsverzeichnis der entsprechenden BIMcloud Server Komponente:
     • Windows:
       C:\Programme\Graphisoft\BIMcloud\Server-20xx-xx-xx\TeamworkServerBackupTool.exe
     • macOS:
       /Programme/Graphisoft/BIMcloud/Server-20xx-xx-xx/TeamworkServerBackupTool
   • Starten des TeamworkServerBackupTools in einer Eingabeaufforderung/einem Terminal ohne Parameter zeigt die Hilfe:
     Usage: TeamworkServerBackupTool [-include-automatic-backups] [-include-
     manual-backups] [-include-mailboxes] <archive folder path>
     Creates complete server archive.
     <archive folder path> the full or relative path of the folder where the created
     server archive files are placed to
   • Beispiel:
     Export aller Projekte und Bibliotheken, ohne die Snapshots unter Windows nach D:\Export und unter macOS in den Ordner Export auf dem Schreibtisch.
     • Windows
       TeamworkServerBackupTool.exe „D:\Export“
     • macOS
       ./TeamworkServerBackupTool "/Users/<Nutzername>/Desktop/Export"
   • Beispiel:
     Export aller Projekte und Bibliotheken, inklusive Teamwork- und PLN-Snapshots unter Windows nach D:\Export und unter macOS in den Ordner Export auf dem Schreibtisch.
     • Windows
       TeamworkServerBackupTool.exe -include-automatic-backups -include-manual-backups “D:\Export”
     • macOS
       ./TeamworkServerBackupTool -include-automatic-backups -include-manual-backups "/Users/<Nutzername>/Desktop/Export"
   • Nach dem Export erscheint im Terminal eine Zusammenfassung, wie viele Projekte und Bibliotheken exportiert worden sind und ob der Export erfolgreich abgeschlossen wurde.
     Hinweis:
     Es sollte ggf. überprüft werden, ob alle Dateien des Exports vorhanden sind.
     
2. Über den BIMcloud Manager:
   • Wenn nicht ausreichend Speicherplatz auf der Systempartition zur Verfügung steht, um alle Projekte und Bibliotheken gleichzeitig mit dem TeamworkServerBackupTool, zu exportieren, können sie einzeln über den BIMcloud Manager exportiert werden.
   • Weitere Informationen hierzu bietet die BIMcloud Hilfe unter Teamwork-Projekte oder Bibliotheken exportieren.

2. Löschen der Projekte und Bibliotheken im BIMcloud Manager

Wenn alle Projekte und Bibliotheken erfolgreich exportiert wurden, können sie über das BIMcloud Manager Webinterface gelöscht werden.

3. Einrichten neuer Ordner und Umstellung der Speicherpfade

• Danach müssen neue Ordner für Bibliotheken, Projekte, BlobCache und den Data Ordner auf dem neuen Laufwerk erstellt und die Speicherpfade im BIMcloud Manager/Server Konfigurator umgestellt werden.
  • Neue Ordner für Bibliotheken, Projekte, BlobCache und den Data Ordner auf dem neuen Laufwerk erstellen.
    Hinweis nur Windows:
    Das BlobCache Verzeichnis der BIMcloud Server Komponente benötigt, seit der Version 2020.2, einen Windows 8.3 Kurznamen. Ist dieser nicht vorhanden, erscheint im BIMcloud Server Konfigurator die folgende Meldung:
    The Cache is not a valid directory.
    Auf Systempartitionen (C: ) sind die Windows 8.3 Namen i.d.R. bereits aktiv, jedoch nicht auf Datenpartitionen (z.B. D:). Möchte man das BlobCache Verzeichnis der BIMcloud Server Komponente auf einer anderen Festplatte als C: speichern, muss zuerst diese Regel aktiviert werden.
    Eine Anleitung für Aktivierung der Windows 8.3 Kurznamen bietet der Troubleshooting Artikel Fehlermeldung bei BIMcloud Installation: The cache is not a valid directory
    Nach der Aktivierung der Regel, muss ein neuer Ordner auf der obersten (root) Ebene der Verzeichnishierarchie erstellt werden, in dem dann die Ordner für die BIMcloud erstellt werden, z.B.:
    • BIMcloud 28 Ordner, mit folgenden Unterordnern:
      • Data (BIMcloud Manager)
      • Projekte (BIMcloud Server)
      • Bibliotheken (BIMcloud Server)
      • BlobCache (BIMcloud Server)
        
  • Wenn Projekte und Bibliotheken über den Manager entfernt und alle Ordner vorbereitet wurden, können die Speicherpfade über die beiden Konfiguratoren geändert werden.
    • BIMcloud Manager Konfigurator:
      • Windows
        C:\Programme\Graphisoft\BIMcloud\Manager-20xx-xx-xx\BIMcloudManager Configurator\BIMcloud Manager Configurator.exe
      • macOS
        /Programme/Graphisoft/BIMcloud/BIMcloud Manager-20xx-xx-xx/BIMcloudManager Configurator/BIMcloud Manager Configurator
    • BIMcloud Server Konfigurator:
      • Windows
        C:\Programme\Graphisoft\BIMcloud\Server-20xx-xx-xx\BIMcloud ServerConfigurator\BIMcloud Server Configurator.exe
      • macOS:
        /Programme/Graphisoft/BIMcloud/BIMcloud Server-20xx-xx-xx/BIMcloudServer Configurator/BIMcloud Server Configurator

4. Importieren der Projekte und Bibliotheken

Nachdem die Speicherpfade umgestellt wurden, müssen die Projekte und Bibliotheken wieder importiert werden. Für den Import bestehen zwei Möglichkeiten:

1. Import über den BIMcloud Manager:
   • Wenn nicht ausreichend freier Speicherplatz für den Import mit dem TeamworkServerRestoreTool zur Verfügung steht, können die Projekte einzeln über den BIMcloud Manager importiert werden.
   • Weitere Informationen hierzu bietet die BIMcloud Hilfe unter Teamwork-Projekte oder Bibliotheken importieren.
2. Import über das TeamworkServerRestoreTool:
   • Der vorherige Export aller Projekte und Bibliotheken mit dem TeamworkServerBackupTool kann aus einem Ordner importiert werden.
   • Das TeamworkServerRestoreTool befindet sich im Installationsverzeichnis der entsprechenden BIMcloud Server Komponente, in welche die Daten importiert werden sollen:
     • Windows:
       C:\Programme\Graphisoft\BIMcloud\Server-20xx-xx-xx\TeamworkServerRestoreTool.exe
     • macOS:
       /Applications/Graphisoft/BIMcloud/Server-20xx-xx-xx/TeamworkServerRestoreTool
   • Starten des TeamworkServerRestoreTool in einer Eingabeaufforderung/einem Terminal ohne Parameter zeigt die Hilfe:
     Usage: TeamworkServerRestoreTool <archive folder path>
     Restores server from the specified server archive folder.
     <archive folder path> the full or relative path of the folder from where the server archive files to be restored
   • Beispiel:
     Import der Projekte und Bibliotheken, unter Windows aus D:\Export und unter macOS aus dem Ordner Export auf dem Schreibtisch.
     • Windows
       TeamworkServerRestoreTool “D:\Export”
     • macOS
       ./TeamworkServerRestoreTool "/Users/<Nutzername>/Desktop/Export"

5. Neue Zuordnung der Projekte über den BIMcloud Server

Da die Projekte und Bibliotheken direkt in die BIMcloud Server Komponente importiert wurden, weiß der BIMcloud Manager noch nichts von den neu importierten Daten. Diese müssen deswegen noch unter Server > BIMcloud Server > Projekte neu zugeordnet werden.

Dafür müssen die Projekte/Bibliotheken in der Liste markiert und über Als neues Teamwork-Projekt bzw. neue Bibliothek laden angelegt werden.