Backup and Restoration

1. Version

2. Application scenarios

·       Users need to use the old version of the plug-in, but only the latest version of the plug-in can be found in the plug-in management.

·       Users mistakenly delete important report and dashboard templates.

·       After the user updates the JAR, for some reason they want to roll back.

3. Function introduction

The platform provides the function of backup and restoration, and supports backup and restoration of "Platform Configuration", "Report Template", "BI Template", "JAR Package", and "Plugin" . As shown below:

4. Unsupported scenarios

1) For projects before version 5.1.8, if the platform database is "built-in database", the backup and restore function is not supported. 

To use the backup and restore function, please configure an external database first .

2) The compressed deployment of War package does not support backup and restoration, and the uncompressed deployment of War package supports backup and restoration.

package is deployed under WebLogic , it is compressed and deployed by default. When deploying War packages under WebSphere and Tomcat , the default is uncompressed deployment.

1. Set the backup path

Note: Only super administrators can set this path.

The super administrator logs in to the data decision system, clicks "Manage > Intelligent Operations > Backup and Restore", clicks the "Global Settings" button, and sets the backup path, as shown in the following figure:

default backup path is . ./ backup , and the backup files are stored in the project's % FineBI %/webapps/ webroot /backup folder.

Users can modify the backup folder to other folders, but saving to a non-project path is not supported.

. ./ when modifying the backup path , the backup file will be stored in the project's % FineBI %/webapps/ webroot /WEB-INF folder

2. Backup method

On the "Platform Configuration", "Report Template", "BI Template", "JAR Package", and "Plugin" tab pages, both manual backup and automatic backup are supported.

Note: If you need to back up the "BI Template", please back up the "Platform Configuration" at the same time, in order to successfully restore the dashboard in the future.

1) Manual backup

Click "Manual Backup", a dialog box pops up, you can customize the name, click "OK", the manual backup is completed. As shown below:

2) Automatic Backup

The super administrator can set the "Backup Frequency",  "Number of Copies", "Backup Capacity", and "Backup Failure Reminder" for automatic backup in "Global Settings". As shown below:

of each setting item is shown in the following table:

3. Backed up files

The backup files are stored in the % FineBI %\webapps\ webroot \backup directory by default, and the specific locations are shown in the following table:

Note 1: The super administrator can modify the storage location of backup files, please refer to Section 2.1 of this article.

Note 2: For versions 5.1.14 and later, to improve security, random characters will be added to the names of the files that are automatically backed up, instead of garbled characters.

Taking the platform configuration as an example, the backup files are under % FineBI %\webapps\ webroot \backup\config , where manual: manual backup ; auto: automatic backup . As shown below:

4. Delete backup

Check the backup you want to delete, click "Delete", confirm the deletion, you can delete the previous backup, the automatic backup and manual backup operation steps are the same, as shown in the following figure:

1. Notes

1) The restored version is automatically deleted

·       FineBI projects of version 5.1.11 and later, after restoring the backup of a certain version, the restored version will not be automatically deleted, and the current version will be automatically backed up.

For example, a plug-in is backed up at zero o'clock on the 1st, and backup A is generated.

When No. 2 zero point restores backup A, it will automatically back up the plug-ins used in No. 2 zero point project to generate backup B. And after the restore operation is complete, backup A still exists.

·       FineBI projects of versions before 5.1.11 , after restoring the backup of a certain version, the restored version will be automatically deleted, and the current version will be automatically backed up.

For example, a plug-in is backed up at zero o'clock on the 1st, and backup A is generated. When No.
2 zero point restores backup A, it will automatically back up the plug-ins used in No. 2 zero point project to generate backup B. But after the restore operation is complete, backup A will be automatically deleted.

If the content to be restored is more important, please back up the corresponding folder in Section 2.3 again before restoring. Or contact technical support for assistance with the restore operation.

Technical support contact information: QQ "800049425", telephone "400-811-8890".

2) Some JARs do not support reverting to certain versions at the platform configuration

When restoring, some JARs do not support restoring to certain versions in "Platform Configuration", as shown in the following table:

2. Restoration method

Click the backed up files under manual backup/automatic backup, click the "Restore button", click the "OK" button and then pop up "Restore completed, please restart", restart the server to take effect, as shown in the following figure:

There are some ways in which different content restoration takes effect. The details are shown in the following table:

Note: When restarting the server, it is necessary to ensure that the server is shut down normally, and the server cannot be shut down violently, such as directly forking off the running window of the Tomcat server.