Migration des données d’un BIMcloud Basic

Le contenu de cet article est destiné aux utilisateurs avec des notions d'informatique ou leurs prestataire informatique.

Description

Lors de la migration d’un BIMcloud Basic, tous les Projets, Bibliothèques et Utilisateurs doivent être importés sur un nouveau serveur avec une nouvelle installation de BIMcloud Basic.
L’export manuel des projets et des bibliothèques un par un via l’interface Web du BIMcloud Manager, puis leur import dans le BIMcloud Manager de la nouvelle installation, est toutefois trop chronophage en raison du nombre de projets.

Solution

Remarques générales sur l’installation

• Une installation de BIMcloud Basic ne prend en charge qu’une seule version d’Archicad. Les projets doivent donc être importés dans un BIMcloud Basic configuré pour la même version d’Archicad.
• Le numéro de build du BIMcloud n’a pas d’incidence dans ce cas.
• l’installateur BIMcloud peut être téléchargé sur la page de téléchargement Graphisoft.
  Ensuite, suivre l’article : Installer BIMcloud Basic.

Remarque :
Les outils peuvent également être utilisés pour l’export d’un BIMcloud défectueux ou pour la modification des chemins de stockage.

Utiliser l’outil Teamwork Server Backup pour l’export des projets et des bibliothèques

Au lieu de l’export manuel, l’outil TeamworkServerBackupTool  présent dans le dossier d’installation du composant BIMcloud Server peut être utilisé pour exporter tous les projets, bibliothèques et la base de données des messages.

Remarque :
Lors de l’export, les données sont temporairement stockées sur la partition système, puis copiées vers la destination définie.
Il faut donc veiller à ce qu’il y ait suffisamment d’espace libre sur la partition système.
La quantité de stockage nécessaire correspond approximativement à la taille des données à exporter.
Le volume total peut être réduit en excluant les instantanés de l’export.

1. macOS

   • Chemin de stockage du TeamworkServerBackupTool :
     /Applications/Graphisoft/BIMcloud/Server-20xx-xx-xx/TeamworkServerBackupTool
   • Chaque instance BIMcloud Basic pour Archicad XX possède ses propres outils d’export et d’import dans le dossier d’installation du composant Server.
     Pour l’export, le TeamworkServerBackupTool de l’installation BIMcloud Basic concernée peut être utilisé.
   • Les outils doivent être exécutés dans le Terminal, dans le chemin du composant BIMcloud Basic Server correspondant.
     1. Il faut ouvrir le Terminal et se placer dans le répertoire approprié.
     2. Pour afficher l’aide, exécuter TeamworkServerBackupTool sans paramètres dans l’Invite de commandes :
        ./TeamworkServerBackupTool
        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

   ---

   Exemples :

   Exporter tous les projets, les bibliothèques, les fichiers de projets solo ".pln" et les instantanés Teamwork dans le dossier Export sur le bureau :

   ./TeamworkServerBackupTool -include-automatic-backups 
   -include-manual-backups "/Users/<NomUtilisateur>/Desktop/Export"

   Exporter tous les projets et bibliothèques, sans les instantanés, dans le dossier Export sur le bureau :

   ./TeamworkServerBackupTool "/Users/<NomUtilisateur>/Desktop/Export"

   ---

2. Windows

   • Chemin de stockage du TeamworkServerBackupTool :
     C:\Programmes\Graphisoft\BIMcloud\Server-20xx-xx-xx\TeamworkServerBackupTool.exe
   • Chaque instance BIMcloud Basic pour Archicad XX possède ses propres outils d’export et d’import dans le dossier d’installation du composant Server.
     Pour l’export, le TeamworkServerBackupTool de l’installation BIMcloud Basic concernée peut être utilisé.
   • Les outils doivent être exécutés dans l'Invite de commandes, dans le chemin du composant BIMcloud Basic Server correspondant.
     1. Il faut ouvrir l'Invite de commandes et se placer dans le répertoire approprié.
     2. Pour afficher l’aide, exécuter TeamworkServerBackupTool.exe sans paramètres dans l’Invite de commandes :
        TeamworkServerBackupTool.exe
        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

Exemples :

Exporter tous les projets, les bibliothèques, les fichiers de projets solo ".pln" et les instantanés Teamwork vers D:\Export :

TeamworkBackupTool.exe -include-automatic-backups -include-manual-backups
"D:\Export"

Exporter tous les projets et bibliothèques, sans les instantanés, vers  D:\Export :

TeamworkServerBackupTool.exe "D:\Export"

Export des utilisateurs

Les utilisateurs doivent être exportés directement via le BIMcloud Manager, car l’outil ne peut pas les exporter.
La procédure est décrite dans l’aide BIMcloud sous Exporter des utilisateurs.

Remarque :
Dans le panneau Utilisateurs, accessible via la liste des utilisateurs dans la colonne de gauche, il est possible d’ouvrir une barre via la coche à côté de Tous pour sélectionner tous les utilisateurs en une seule fois.

Import des projets et des bibliothèques

Ensuite, il est possible de commencer l’import de tous les projets et bibliothèques à partir d’un dossier sur le nouveau serveur.

Remarque :
Lors de l’import, les données sont également temporairement stockées sur la partition système.
Un espace libre suffisant doit donc être disponible.

1. macOS

   • Chemin de stockage du TeamworkServerRestoreTool :
     /Applications/Graphisoft/BIMcloud/Server-20xx-xx-xx/TeamworkServerRestoreTool (même arborescence que le BackupTool).
   • Là aussi, il faut d’abord ouvrir le Terminal et se placer dans le répertoire du composant BIMcloud Server pour lequel les données doivent être restaurées.
   • Pour afficher l’aide, exécuter TeamworkServerRestoreTool sans paramètres dans l’Invite de commandes :
     ./TeamworkServerRestoreTool
     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

   ---

   Exemple :

   Importer les projets et bibliothèques depuis le dossier Export sur le bureau :

   ./TeamworkServerRestoreTool "/Users/<NomUtilisateur>/Desktop/Export"

   ---

2. Windows

   • Chemin de stockage du TeamworkServerRestoreTool :
     C:\Programmes\Graphisoft\BIMcloud\Server-20xx-xx-xx\TeamworkServerRestoreTool.exe
   • Là aussi, il faut d’abord ouvrir l'Invite de commandes et se placer dans le répertoire du composant BIMcloud Server pour lequel les données doivent être restaurées.
   • Pour afficher l’aide, exécuter TeamworkServerRestoreTool.exe sans paramètres dans l’Invite de commandes :
     TeamworkServerRestoreTool.exe
     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

Exemple :

Importer les projets et bibliothèques à partir du dossier  D:\Export :

TeamworkServerRestoreTool.exe "D:\Export"

Associer les projets dans le BIMcloud Manager

Après l’import, les projets et bibliothèques doivent être réassignés dans le BIMcloud Manager sous :
Serveur / BIMcloud Server / Projets.
Sélectionner les projets ou les bibliothèques dans la liste, puis utiliser Charger comme nouveau projet/bibliothèque pour les créer.
Une procédure détaillée se trouve dans l’article d’aide BIMcloud Projets/Bibliothèques hébergés.

Import des utilisateurs

Pour l’import des utilisateurs dans le BIMcloud Manager sur le nouveau serveur, il faut suivre l’article d’aide BIMcloud Importer des utilisateurs.