Sage X3 uses Mongo DB as a storage database for the Administration Module. It also acts as part of the first layer of security alongside the Syracuse Component. Just like Microsoft SQL and Oracle DB; Mongo DB also needs to be backed up. In this blog we will see how to take a backup of MongoDB and how to restore the procedure.

New Stuff:- Top 3 Benefits of Greytrix Professional Services

To take the backup first need to check below pre-requisite.

  • Sage X3 needs to be installed on the server with same version and patch level.
  • Both the server needs to have MongoDB Compass downloaded i.e. from where the data of MongoDB will be extracted and to where it will be restored.

Below are the steps needs to be followed to export and import data from MongoDB from one server to another:

  • Download the stable version MongoDb Compass as per the platforms you use.
  • Run the Application file with the name “”MongoDBCompass” from the downloaded folder.
MongoDB-Compass Setup
MongoDB-Compass Setup
  • Enter the connection string as “ mongodb://127.0.0.1:27017 ” and click on CONNECT button to connect to the link.
Creation of New-Connection
Creation of New-Connection
  • After the successful connection application will take you to the home page which will show the database.
Database-List
Database-List

In the above screenshot you can see the “syracuse” is the one in which Sage X3 saves all the data of Administration module.

Click on Syracuse Option.

  • After clicking on the syracuse database it will take you to Administration
Syracus-database-list
Syracus-database-list

Out of all the functions the one can decide which all functions data needs to be extracted from one server and restore it in another server.

  • Below we will see exporting the MongoDB data.

From the above list user can extract data of below mentioned function. (As per requirement this is just an example.)

Below are the steps to extract data from the function through MongoDB compass.

  1. Groups :

In Sage X3 currently we have 4 groups out of which 1 “Super Administrator” is the standard group which comes with the Sage X3 installation.

List-of-group
List-of-group

a. Click on Group on MongoDb compass.

Group-selection
Group-selection

b. Once clicked it will take you to the below screen. In which this symbol   is the export button through data gets extracted.

Syracus Group-Export
Syracus Group-Export

c. Click on the export button it will take to the following screen.

Export-group
Export-group
  • Click on Browse and select the path where you want to store the data and name the file with .json extension. In the above image we have named the file as Groups.json.
  • Once finished go back to the selected path you will see a .json file. This file has all the groups available in Sage X3.

2. Roles :

In Sage X3 currently we have 57 roles out of which 3 “Purchase, Sales, Finance” are the ones manually created rest all are the standard ones.

List-of-Roles
List-of-Roles

a. Click on Role

Roles-selection
Roles-selection

b. Once clicked it will take you to the below screen. In which this symbol   is the export button through data gets extracted.

Syracus.Role
Syracus.Role

c. Click on the export button it will take to the following screen

Export-Roles
Export-Roles
  • Click on Browse and select the path where you want to store the data and name the file with .json extension. In the above image we have named the file as Roles.json.
  • Once finished go back to the selected path you will see a .json file. This file has all the roles available in Sage X3.

In a same way you can export rest of the data.

Here we will see how to restore the exported .json files into another server.

Move all the exported .json files to the new server where there is already Sage X3 is installed with same version and patch level.

Note: As mentioned earlier the exported files contains all the data from their respective function even the standard data which comes automatically after the Sage X3 installation. We need to delete the standard data so that it doesn’t get duplicated after the import.

To delete the standard data open the .json file through Notepad ++, this make easier to identify and delete the data:

Once you delete the date, the .json file is ready to get imported. Below are the steps to import the extracted data:

a. Open the MongoDB Compass by following the steps mentioned in point  1 mentioned above at the start.

b. Click on Syracuse database and from the following window click on Group function.

c. Click on the Import Data as highlighted in the below image.

Import-group
Import-group

d. Click on Browse and select the json file and click on Import.

Group.Json-Import
Group.Json-Import

e. Now login Sage X3 and click on Groups from Administrator module there you will see new groups added.

f. Edit all the new groups added. In Endpoint section add all the folders and Save

Roles:

Even for roles we have to delete the Standard roles and import the manually created roles. Below are the steps:

a. Open the Roles.json file using Notepad ++. Identify the standard roles and delete them by selecting the lines and Save the file. All the new roles created in Sage X3 you will find it in the bottom of the json file above that line all are standard ones.

b. Now the .json file is ready to get imported next go to MongoDB compass click on Roles function going to Syracuse database and click on Import Data.

Role-Import
Role-Import

About Us

Greytrix – a globally recognized and one of the oldest Sage Development Partner is a one-stop solution provider for Sage ERP and Sage CRM organizational needs. Being acknowledged and rewarded for multi-man years of experience, we bring complete end-to-end assistance for your technical consultations, product customizations, data migration, system integrations, third-party add-on development and implementation competence.

Greytrix caters to a wide range of Sage X3, a Sage Business Cloud Solution, offerings. Our unique GUMU™ integrations include Sage X3 for Sage CRMSalesforce.com, Dynamics 365 CRM and Magento eCommerce along with Implementation and Technical Support worldwide for Sage X3. Currently we are Sage X3 Implementation Partner in East Africa, Middle East, Australia, Asia, US, UK. We also offer best-in-class Sage X3 customization and development services, integrated applications such as POS | WMS | Payment Gateway | Shipping System | Business Intelligence | eCommerce and have developed add-ons such as Catch – Weight  and Letter of Credit and India Legislation for Sage X3 to Sage business partners, end users and Sage PSG worldwide.

Greytrix is a recognized Sage champion ISV Partner for GUMU™ Sage X3 – Sage CRM integration also listed on Sage Marketplace; GUMU™ integration for Sage X3 – Salesforce is a 5-star rated app listed on Salesforce AppExchange and GUMU™ integration for Dynamics 365 CRM – Sage ERP listed on Microsoft AppSource.

For more information on Sage X3 Integration and Services, please contact us at x3@greytrix.com, We will like to hear from you.

c.. Click on Browse and select the json file and click on Import the same way we did for groups.

d. Now login Sage X3 and navigate to roles function you will notice 3 new roles added apart from 54 roles which are standard ones.

e. Edit all the 3 newly added roles. Select badges as ERPFULL and security profile as User and click on Save.

Similarly you can import data for users also.

This is how we can extract the data from the mongodb backup database using the MongoDB Compass from one system and Import the same in to another system. This MongoDb backup and restore process is mostly used to move groups, Roles, Users, LDAP from one x3 system to another.

Welcome
Book an Appointment img

Book Your Appointment

Our schedule for October 2025

 
MoTuWeThFrSaSu
 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

 
MoTuWeThFrSaSu
October 1, 2025
8:00 am
8:15 am
8:30 am
8:45 am
9:00 am
9:15 am
9:30 am
9:45 am
10:00 am
10:15 am
10:30 am
10:45 am
11:00 am
11:15 am
11:30 am
11:45 am
12:00 pm
12:15 pm
12:30 pm
12:45 pm
1:00 pm
1:15 pm
1:30 pm
1:45 pm
2:00 pm
2:15 pm
2:30 pm
2:45 pm
3:00 pm
3:15 pm
3:30 pm
3:45 pm
4:00 pm
4:15 pm
4:30 pm
4:45 pm
Holiday
Not Possible
Busy
Free
Today

Please check the appointment details below and confirm: