Skip to main content
Matrix42 Self-Service Help Center

Exporting and importing user/computer settings

ID: 18041301
Languages: EN, DE
Components: EgoSecure Server, EgoSecure Agents
Operating system: Windows

Task

Transfer settings of directory service objects
  • when changing/renewing the used directory service (structure, object names) and unchanging EgoSecure server environment
    or
  • when merging multiple EgoSecure Servers on different databases and changing the main server

Solution

 
Perform a backup of the used database first. For details, see Database migration: Saving a database.
 
If you have several databases and servers and want to transfer directory object settings:
Make sure that the EgoSecure version of all used servers is the same. If not, perform an update first.

Exporting data from directory service objects

1. Open the command prompt with the path where the EgoSecure application AdminTool.exe is located.
2. Enter the following command line, followed by one of the following parameters. You can use a different path or file name:
  • AdminTool.exe /exportDB "C:\BackupData.dat"
  • /products - exports products activated for user/computer
  • /acl - exports access rights
  • /pd - exports permitted devices, device groups and media
  • /es - exports encryption settings
  • /keys - exports encryption keys
  • /chf - exports content filter and filter settings for users
Example:
  • AdminTool.exe /exportDB "C:\BackupData.dat" /products /acl /pd /chf
For details about exporting data, see the Database Migration section of the document EgoSecure AdminTool - commands (sign in required to download).
 
⇒ The exported data is stored in the BackupData .dat file on disc C: and can now be imported into a renewed structure or on a new main server.
 

A. Transferring data of directory service objects to renewed directory service structure

To transfer settings of users/computers when you change or renew the used directory service (structure, object names) while keeping the EgoSecure Server environment unchanged:
 
1. Export the object settings.
2. Delete the old structure in the Directory Service structure section.
3. Perform a synchronization of the directory service.
For details about configuring default policies, synchronization and installation, see EgoSecure Console - Quick Start Guide (sign in required to download).
⇒ The new directory service structure appears in the Directory Service structure of the Rights management section.
 
4. Import the previously exported object settings:
 
a. Open the command prompt with the path where the EgoSecure application AdminTool.exe is located.
b. Enter the following command line. You can use a different path or file name.
  • AdminTool.exe /importDB "C:\ BackupData .dat"
By default, the objects are sorted by their SID. To sort by another value (e.g. if the object SID changed), add the /identity command followed by an identifying parameter (guid/email/name):
  • AdminTool.exe /importDB "C:\ BackupData .dat" /identity name
⇒ The data is imported.

B. Transferring data of directory service objects to new main server

To transfer settings of users/computers when you merge multiple EgoSecure Servers into different databases and change the main server:
1. Configuring new main server
1. Open the EgoSecure Console on the new server and import the license file.
For details, see: Activating product licenses: Renew or expand licenses
2. Configure the default rights.
3. Perform a synchronization of the directory service.
For details about configuring default policies, synchronization and installation, see EgoSecure Console - Quick Start Guide (sign in required to download).
4. Import the previously exported settings of the previous main server:
a. Open the command prompt with the path where the EgoSecure application AdminTool.exe is located.
b. Enter the following command line. You can use a different path or file name.
  • AdminTool.exe /importDB "C:\ BackupData .dat"
By default, the objects are sorted by their SID. To sort by another value (e.g. if the object SID changed), add the /identity command followed by an identifying parameter (guid/email/name):
  • AdminTool.exe /importDB "C:\ BackupData .dat" /identity name
⇒ The data is imported.
 
5. Configure the client settings and the installation settings for generating the MSI package.
6. Generate the MSI package.
7. Copy the MSI package in the MSI directory of the previous main server.
2. Assigning EgoSecure Agents to the new main server
1. Open the EgoSecure Console on the previous main server.
2. Start the update of the Agents under Installation » EgoSecure agents » Install/Update .
⇒ The clients now log in to the new main server and are listed in the EgoSecure Console on the new main server.