JasperReports Server provides functionality to import and export resources and users through the user interface:
Exporting From the Repository
Only system administrators can export folders and individual resources from the repository.
To export individual resources or an entire folder of the repository:
| 1. | Log in as system administrator (superuserjasperadmin by default). |
| 2. | Select View > Repository. You can also export reports, Ad Hoc views, dashboards, and OLAP views from the Library page. |
| 3. | Select one or more resources in the main panel, or when viewing the repository, select a folder in the left-panel. |
| 4. | Right-click the selected folder or resources and select Export from the context menu. The Export Resources dialog appears: |
| Export Resources Dialog in the Repository |
|  |
| 5. | If desired, change the default name of the zip file for the exported catalog. This dialog allows only the zip archive format. |
| 6. | Choose one or both of the export options: |
| • | Include report jobs – When checked, the export includes scheduled report jobs with any reports in your repository selection. |
| • | Include repository permissions – When checked, the export includes any explicit permissions on all items in your repository selection. Clear this check box if you want the exported items to inherit the permissions of the destination repository. |
| 7. | Click Export. The server generates the catalog zip file and your browser prompts you to save the file. Depending on the size of your repository and the options you've selected, it may take several minutes to generate the catalog file. |
| | Resources are exported along with any dependencies, even if they're not included in your repository selection. For more information, see Dependencies During Import and Export. Catalogs may be very large and take a long time to generate and then download. During this time, the export operation may affect server performance. |
Exporting From the Settings
For more export options, use the server settings page for system administrators. The settings page lets you export the following resources:
| • | Everything – The entire repository, including all resources in all organizations, as well as all users, roles, and other settings stored internally. With the proper options, this creates a backup of the server. |
| • | Any combination of users and roles – Lets choose from lists of users and roles, with options to include users by role or roles by user. |
| • | Categories of resources by type – For example all reports or all dashboards. |
To export resources from the settings page:
| 1. | Log in as system administrator (superuserjasperadmin by default). |
| 2. | Select Manage > Server Settings, then click Export in the left-hand panel. |
| User Interface for Export |
| |
| 3. | If desired, change the default name of the zip file for the exported catalog. This dialog allows only the zip archive format. |
| 4. | Use the check boxes and radio buttons to choose the contents of your exported catalog file. |
Select Export Everything (default) to export the entire repository, including permissions report jobs, all organizations, users and roles, and all types of assets. Select the check boxes under Events to Export to include the different types of events in your export catalog.
| 5. | Clear Export Everything to select users and roles or resource types to export. |
| a. | To export users and roles, choose one of the radio buttons, then select individual users and roles from the lists. |
| • | Selected roles and users – Only the roles and users you select explicitly are exported. |
| • | Users with selected roles – Select one or more roles, and all users with those roles are exported, along with the selected roles. |
| • | Roles with selected users – Select one or more users, and all roles assigned to those users are exported, along with the selected users. |
| b. | If you only want users and roles, clear all check boxes under Resources to Export. |
| c. | Or if you only want resources, do not select any users and roles, then select the resource types you want to export. |
| d. | Select the check boxes under Assets to Export to include these various resources in your export catalog. |
| e. | Select the check boxes under Events to Export to include the different types of events in your export catalog. |
| 6. | Click Export. The server generates the catalog zip file and your browser prompts you to save the file. Depending on the size of your repository and the options you've selected, it may take several minutes to generate the catalog file. |
| | Resources are exported along with any dependencies, even if they're not included in your repository selection. For more information, see Dependencies During Import and Export. Catalogs may be very large and take a long time to generate and then download. During this time, the export operation may affect server performance. |
Exporting From Organizations
Both system admins and organization admins can use the Manage Organizations page to select organizations for export. For example, an organization admin can use this feature to back up his entire organization or to move suborganizations from one parent to another.
To export organizations:
| 1. | Log in as administrator that has access to the organizations you want to export. |
For example, to move an organization, you must log in as the administrator of the parent organization.
| 2. | Select Manage > Organizations to display the hierarchy of organizations. |
| 3. | In the left-hand panel, right-click the organization you want to export and select Export from the context menu. |
| User Interface for Organization Export |
| |
| 4. | If desired, change the default name of the zip file for the exported catalog. This dialog allows only the zip archive format. |
| 5. | Use the check boxes and radio buttons to choose the items to be exported from this organization. |
Select Export Everything (default) to export the entire organization, including all resources, report jobs, users, and roles.
| 6. | Clear Export Everything to select users and roles or resource types to export. |
| a. | To export users and roles, choose one of the radio buttons, then select individual users and roles from the lists. |
| • | Selected roles and users – Only the roles and users you select explicitly are exported. |
| • | Users with selected roles – Select one or more roles, and all users with those roles are exported, along with the selected roles. |
| • | Roles with selected users – Select one or more users, and all roles assigned to those users are exported, along with the selected users. |
| b. | If you only want users and roles, clear all check boxes under Resources to Export. |
| c. | Or if you only want resources, do not select any users and roles, then select the resource types you want to export. |
| d. | Select the check boxes under Assets to Export to include these various resources in your export catalog. |
| 7. | Click Export. The server generates the catalog zip file and your browser prompts you to save the file. The server displays a message if there are any broken dependencies. |
| | Resources are exported along with any dependencies, unless you do not have permission to access them or they are located in a parent organization. Broken dependencies may block the export or import operations. For more information, see Dependencies During Import and Export. When logged on as system admin (superuser) and exporting from the root node, the dialog is functionally equivalent to exporting from the Settings page. In this case, there are additional options to export events. Catalogs may be very large and take a long time to generate and then download. During this time, the export operation may affect server performance. |
Importing From Organizations
Both system admins and organization admins can use the Manage Organizations page to import an organization. An import merges the content of the export catalog into the selected organization. When merging organizations with the update option, the contents of the import override the target organization for any user, role or resource with the same name. If the imported organization has a different ID than the destination, the merged organization takes the organization ID of the imported organization
To move an organization, create an empty organization as the destination, and then import into it.
| | If you're importing from a different server, you must configure an encryption key on both servers, as described in Setting the Import-Export Encryption Key. You'll need to enter the keystore password when prompted by the import operation. |
To import organizations:
| 1. | Log in as administrator that has access to the destination organization. |
| 2. | Select Manage > Organizations to display the hierarchy of organizations. |
| 3. | In the left-hand panel, right-click the organization you want to import into and select Import from the context menu. |
| User Interface for Organization Import |
| |
| 4. | Click Browse to choose the catalog zip file to import. The dialog allows only the zip archive format. You can import only catalog files created by the export of an organization. |
| 5. | Use the check boxes to change the behavior of the import operation: |
| • | When checked, the Update option will import only resources that are newer than ones with the same URI in the current organization. The Skip user updates option allows you to keep the current definition of any users that also exist in the imported organization. |
| • | When checked, the Include themes option will import any themes that exist in the imported organization. |
The server uploads the catalog zip file and imports its contents into the organization. If there are any broken dependencies in the catalog, the server displays a message with three choices:
| • | Skip – Does not import the resource with the broken dependency, but continues to import other resources. |
| • | Include – Attempts to import the resource with the broken dependency. The import succeeds if there is already a resource in the destination that satisfies the dependency. If the dependency is not satisfied in the destination, the resource is skipped and the import continues. |
| • | Cancel – Stops the import operation. |
| | For more information, see Dependencies During Import and Export. When logged on as system admin (superuser) and importing to the root node, the dialog is functionally equivalent to importing on the Settings page. In this case, there are additional options to import events. But you can't import an organization to the root. Catalogs may be very large and take a long time to upload and then process. During this time, the import operation may affect server performance. |
Importing From the Settings
The Settings pages for system administrators include a user interface to simplify the import procedure.
This import operates on a running instance of the server, and all imported resources are visible immediately. In addition, any configuration or security settings in the imported catalog take effect immediately, with no need to restart the server.
| | If you're importing from a different server, you must configure an encryption key on both servers, as described in Setting the Import-Export Encryption Key. . You'll need to enter the keystore password when prompted by the import operation. |
To import data from the Settings page:
| 1. | Log in as system administrator (superuserjasperadmin by default). |
| 2. | Select Manage > Server Settings and choose Import in the left-hand panel. |
| User Interface for Import |
| |
| 3. | Click Browse to choose the catalog zip file to import. The dialog allows only the zip archive format. This dialog cannot import a catalog file that was created from the export of an organization. |
| 4. | Use the check boxes to change the behavior of the import operation: |
| • | When checked, the Update option will import only resources that are newer than ones with the same URI in the current repository. The Skip user updates option allows you to keep the current definition of any users that also exist in the imported catalog. |
| • | When checked, the Include access events option imports the modification times of resources from the catalog. When cleared, resources keep their existing access times if they already exist. |
| • | The Include audit events and Include monitoring events determine whether access and monitoring events from the catalog, if any, are imported. |
| • | The Include server settings option determines whether the system configuration is updated from the catalog. There are two prerequisites in order for the catalog to contain configuration settings: |
| • | The originating server settings must be modified through the UI. Thus, only Log Settings, Ad Hoc Settings, AWS Settings, and OLAP Settings are affected. For more information, see Configuration Settings in the User Interface |
| • | The catalog must be exported with the “everything” option or the specific Server Settings option. |
When server settings are imported, they take effect immediately and appear in the Settings UI.
| • | The Include themes option determines whether you want to import themes from the catalog. |
The server uploads the catalog zip file and imports its contents into the repository. Depending on the size of the catalog and the options you've selected, it may take several minutes to perform the import.
| | When you import a catalog from a JasperReports Server 5.2 or earlier that was created with the "export everything" option, you must uncheck the Include themes option. Theme files contained in export catalogs from previous versions of the server are not compatible and cause HTML display errors. If you have a custom theme to import, you can use the Theme UI to download it from the source server and upload it to the target server. If your theme contains the file pageSpecific.css, you must remove it from the ZIP file before uploading, and then redo your changes to the file based on pageSpecific.css in the target server from 5.5 or later. For more information, see Downloading and Uploading Theme ZIP Files. |
| | Resources are imported along with any dependencies, unless you do not have permission to write at the dependency's location in the organization. Broken dependencies may block the import operation. For more information, see Dependencies During Import and Export. Catalogs may be very large and take a long time to upload and then process. During this time, the import operation may affect server performance. |
Recommended Comments
There are no comments to display.