10.2. Backup and Restore


You are looking at documentation for an older release. Not what you want? See the current release documentation.

If you do not customize and configure eXo Platform, the whole data is located in one directory. So you just need to backup and restore the folder:


The above locations are the default ones, you may have different path to the data folder which is shared and accessible by your sever node(s).

However it is not the case in production. As introduced in Planning your backup, the eXo Platform data consists of JCR File System data and JCR/IDM/JPA SQL datasources. The backup/restore does not require any specific tools. You just need to know the data location and use OS utilities to backup/restore file system data and DBMS tools to backup/restore SQL databases.

The data folder contains these directories:


JCR Directory and JCR database must be consistent. Then you should stop eXo Platform, backup both before restarting. All nodes should be stopped if you are running the cluster mode.

File System Data

You can check the data location in the customized configuration file:

Open the file and find EXO_DATA_DIR. This variable indicates the folder you need to backup or restore. As explained above, EXO_DATA_DIR takes by default the values cited in the top page but you can customize it.

You may disregard the background storage system (device and protocol) and let the OS take care of it. However, to make it efficiently, the background storage should be considered. There are working storage (that eXo Platform uses) and backup storage. Each of two can be on local drives, or a mount point of a network shared device. Each can be a SAN or a NAS storage. You should use different hard drives for working storage and backup storage, for safety, and conditionally for speed.

JCR Data

As said above, the whole JCR file system data is located in one root directory (EXO_DATA_DIR). However, there is a possibility that an element (a workspace for instance) is configured to be different. To handle such cases, look inside the file system data. There may be:

By default, all are located under EXO_DATA_DIR and each workspace has its index, value and swap directories. Also, the portal default configurations may be changed or overwritten, however it is not recommended to do this. To see how it can happen, see JCR Configuration.

SQL Databases

Check your database configurations to see which databases are being used. The database configurations are described in Configuring eXo Platform of the Database configuration section.

There should be three datasources: JCR, IDM and JPA.

You should backup and restore the whole database. If you want to backup and restore tables separately, make sure your backup parts are consistent.

See also

Copyright ©. All rights reserved. eXo Platform SAS
blog comments powered byDisqus