Back Up Management Console
Use the Backup tab to copy all or part of the Management Console configuration into a file for backup or export purposes. If necessary, you can use the file to perform a restore or import operation.
It is important to understand the difference between creating/restoring a backup and exporting/importing a project.
A backup contains all of the Management Console configuration including all schedules and all projects in the repository, and can be restored only in its entirety. It may be used to restore the system after data loss, or when upgrading to a later version of Kofax RPA. In the latter case, you will create a backup of the old instance of the Management Console and restore it into the new instance. See Restore a Backup for more information on restoring from an instance of the Management Console prior to release 8.1.
Use Export Project to create a file with information pertaining to a single project. This comprises the schedules, robots, types, and resources within the project. Such a file may be used to copy schedules, robots, and so on, from one Kofax RPA system to another, for example when moving from a test environment into production. It is possible to import into an existing project on the target system; in this case, items from the file are merged into the project, overriding present items when names match. It is also possible to do a selective import that includes only some items.
Create a Backup
-
To create a backup, in
Create Backup.
, click
The Create Backup window appears.
- Click Create Backup.
-
When the backup is complete, select
Click to download.
You can open the backup files, or click Save.
Export a Project
When exporting a project, you must select the desired project in this window. Then click Create to create the desired backup/export file; this may take a while. When the file is ready, a download link appears. The link is active only while the window is open; you cannot copy the link and use it after closing the window.
-
To export a project, in
Export Project.
, click
The Create Export window appears.
- Select the project to export.
- Click Create Export.
-
When the export project is complete, select
Click to download.
You can open the export files, or click Save.
Export a Project by Name
You can export a project by name using the following URL. For example, it can be useful if you need to back up a project using API.
http://user:password@localhost:8080/ManagementConsole/secure/BackupProjectByName?projectName=MyProject
In this URL, replace the following parts with you actual data:
-
user:password: User credentials to access the Management Console.
-
localhost:8080/ManagementConsole: URL to the Management Console.
-
MyProject: Name of the project to export.
Restore a Backup
When restoring an export from a Management Console prior to release 8.1: As described above, it is possible to restore from a backup made with an earlier release of the Management Console. Three caveats should be kept in mind: First, the terminology was changed in release 8.1. Previously, the term "export" was used for what is now named "backup". That is, if you want to migrate contents from a Management Console prior to release 8.1, you must use its "Export" function to create an export file. Secondly, this file must be converted to the new backup file format with the aid of the "Upgrade Pre-8.1 Management Console Export" feature in the Tools menu of Design Studio. Thirdly, the new project based permissions introduced in 8.2 mean that permissions from a previous version can not be upgraded automatically. After you restore an older backup, you have to assign project permissions manually.
-
To restore a backup, in
Restore Backup.
, click
The Restore Backup window appears.
- Browse to the backup file to restore.
-
Choose either
Merge or
Reset from the drop-down list.
-
Choose Merge to merge the settings of the backup into the current version of the Management Console.
Those settings that are missing in the backup, that is settings that did not exist in an earlier version when the backup was created, keep their custom value.
-
Choose Reset to reset all the settings before restoring a backup.
Those settings that are missing in the backup, that is settings that did not exist in an earlier version when the backup was created, are reset to their default value.
-
- Click Restore.
- When the restore is complete, click OK and then click Close.
Importa Project
-
To import a backup, in
Import Project.
, Click
The Import Project window appears.
-
Select the items to import.
Available options include:
-
Import Schedules
-
Import Robots, Types and Snippets
-
Import Resources
-
Import OAuth
-
Import Master Kapplets (Classic Kapplets)
-
Import Permissions
-
- Browse to the backup file to import.
- Click Import.
- When the import is complete, click OK and then click Close.