eShare Backup Restore tool

You can backup and restore CADMATIC eShare server, server and project databases, server configuration files, and individual eShare projects using eShare Backup Restore tool from the command line by running it as an administrator. The eShareBackupRestore.exe is located in Program Files\Cadmatic\eShareAdminTools\eShareBackupRestore.

Note: Running the tool stops eShare server and restarts it again after the tool has finished running.

Prerequisites

  • CADMATIC eShare server must have appropriate permissions in the database. It should be able to create, delete, and rename databases, and also be able to insert, update, delete, and select data in the database tables.

Do the following:

Run the tool from the command line without any options to display usage information.

eShareBackupRestore

Project backup

Perform the following to create a backup of CADMATIC eShare project.

eShareBackupRestore backupproject <option>

Required Options

Description

-u

--url

eShare server's URL

-d

--directory

directory where to store the backup file

-p

--project

name of the project to backup

Optional Options

Description

--pointclouds

flag which specifies whether to backup point clouds and textured meshes

--force

flag which specifies whether to not ask for confirmation before proceeding with the backup

--help

show help and usage information

Examples

To run a command, you need to know the URI of the CADMATIC eShare server. In the examples below the server address and port is localhost:81.

  • Creates a backup of the project:

    eShareBackupRestore backupproject -u http://localhost:81 -p DemoProject -d c:\temp\

  • Creates a backup of the project, including point clouds and textured meshes:

    eShareBackupRestore backupproject -u http://localhost:81 -p DemoProject -d c:\temp\ --pointclouds

  • Creates a backup of the project without asking for confirmation:

    eShareBackupRestore backupproject -u http://localhost:81 -p DemoProject -d c:\temp\ --force

Server backup

Perform the following to create a backup of CADMATIC eShare server.

eShareBackupRestore backupserver <option>

Required Options

Description

-u

--url

eShare server's URL

-d

--directory

directory where to store the backup file

Optional Options

Description

--pointclouds

flag which specifies whether to backup point clouds and textured meshes

--force

flag which specifies whether to not ask for confirmation before proceeding with the backup

--help

show help and usage instructions

Examples

To run a command, you need to know the URI of the CADMATIC eShare server. In the examples below the server address and port is localhost:81.

  • Creates a backup of the server:

    eShareBackupRestore backupserver -u http://localhost:81 -d c:\temp\

  • Creates a backup of the server, including point clouds and textured meshes:

    eShareBackupRestore backupserver -u http://localhost:81 -d c:\temp\ --pointclouds

  • Creates a backup of the server without asking for confirmation:

    eShareBackupRestore backupserver -u http://localhost:81 -d c:\temp\ --force

Restoring eShare project from backup

Perform the following to restore a CADMATIC eShare project from backup.

eShareBackupRestore restoreproject <option>

Required Options

Description

-u

--url

eShare server's URL

-f

--file

the backup file to restore from

-p

--project

Original name of the project to restore if the backup file contains multiple projects. If the file contains only one project this is not needed.

Optional Options

Description

--newdb

renames the project database

If another database with the name already exists, it will not be overwritten

--force

flag which specifies whether to not ask for confirmation before proceeding with the restore

--help

show help and usage information

Examples

To run a command, you need to know the URI of the CADMATIC eShare server. In the examples below the server address and port is localhost:81.

  • Restores the project from backup, when there is only one project in the backup file:

    eShareBackupRestore restoreproject -u http://localhost:81 -f c:\temp\eShareServer_DemoProject_2024T1R4_2024-04-04-123456.7z

  • Restores the project from backup when there are multiple projects in the backup file:

    eShareBackupRestore restoreproject -u http://localhost:81 -f c:\temp\EShareProject_DemoProject_2024T1R4_2024-04-04-123456.7z -p DemoProject

  • Restores the project from backup and renames the project database with a new name:

    eShareBackupRestore restoreproject -u http://localhost:81 -f c:\temp\EShareProject_DemoProject_2024T1R4_2024-04-04-123456.7z --newdb DemoProjectDatabase

Restoring eShare server from backup

Perform the following to restore CADMATIC eShare server from backup.

eShareBackupRestore restoreserver <option>

Required Options

Description

-u

--url

eShare server's URL

-f

--file

the backup file to restore from

Optional Options

Description

--configs

flag which specifies whether to restore the server's configuration files

These files are AppSettings.config, ConnectionStrings.config, and Web.config in the installation directory of eShare server, and NLog.config in the bin folder of the installation directory of eShare server.

--force

flag which specifies whether to not ask for confirmation before proceeding with the restore

--help

show help and usage information

Examples

To run a command, you need to know the URI of the CADMATIC eShare server. In the examples below the server address and port is localhost:81.

  • Restores the server from backup:

    eShareBackupRestore restoreserver -u http://localhost:81 -f c:\temp\EShareServer_2024T1R4_2024-04-04-123456.7z

  • Restores the server from backup, including the server's configuration files:

    eShareBackupRestore restoreserver -u http://localhost:81 -f c:\temp\EShareServer_2024T1R4_2024-04-04-123456.7z --configs

  • Restores the server from backup without asking for confirmation:

    eShareBackupRestore restoreserver -u http://localhost:81 -f c:\temp\EShareServer_2024T1R4_2024-04-04-123456.7z --force