Migrate Content to Other Catalogs

You can copy catalog content from one environment to another using the catalog archive and unarchive options. Archiving saves your content to a .catalog file on your local file system. Unarchiving uploads content from catalog files to another catalog location.

Topics

Save Content to a Catalog Archive

You can copy or move content you create in one environment to another environment using the catalog archive/unarchive feature. Archiving saves one or more objects or folders that contain multiple objects to a .catalog file on your local file system.

You can upload the .catalog file at a different location.

On the Classic Home page, click Catalog.
Select one or more folders or objects to copy or move to another catalog.

To select multiple items, press and hold the Ctrl key, and click the folders or objects you want to copy.
In the Tasks pane beneath the Folders pane, click Archive.
Select Keep Permissions to save the permission settings, if any.
If you don’t select this option, permissions are excluded. This can be useful if you're migrating content from a test environment and none of the permissions you assigned to test users are required in the production system. When you unarchive, the content inherits permissions from the parent folder on the target system.
Select Keep Timestamps to save information such as time created, last modified, and last accessed.
When you unarchive, timestamp information is retained and you can choose to only overwrite items that are older than those in the catalog archive.

If you don’t select Keep Timestamps, the original age of content isn’t saved or considered when you unarchive the content.
Click OK.
Select Save File.
If you want to, change the name of the catalog file.
Select a folder and click Save.

Upload Content from a Catalog Archive

You can upload content from Oracle Analytics and Oracle BI Enterprise Edition 11.1.1.9.0 or later. Select the custom catalog folder where you want the content to go, and , if you have BI Consumer permissions, you'll see an Unarchive option. Point to a catalog archive, any valid .catalog file, to copy its content to this folder.

On the Classic Home page, click Catalog.
Navigate to a custom folder where you want to unarchive the content of your file.
In Unarchive, click Browse to select the archive file.
In Replace, select an option:
- None: Never overwrite existing content. This is the default setting.
- All: Overwrite existing content, except for content marked Read-Only.
- Old: Overwrite existing content if it’s older than the content in the file.
- Force: Overwrite all content, even newer content and content marked Read-Only.
In ACL, select how to apply Access Control List permissions.
- Create: Preserves objects' permissions as they were in the original, creating and mapping users and application roles as necessary. If the user or role is not available, objects inherit their owner from the new parent folder, which is similar to the Inherit option.
- Inherit: Inherit objects' permissions from its new parent folder. (Default)
- Preserve: Preserve objects' permissions as they were in the original, mapping users and application roles as necessary.
Click OK.

Track the Progress of Your Catalog Unarchive Tasks

You can track the progress and current status of any catalog unarchive operations that you initiate from the Unarchive Tasks tab.

Large catalogs might take some time to process. Check the information on this tab to find out when your task starts or completes, and troubleshoot any errors that might occur.

Navigate to the Classic Home page.
Click My Profile, and select Background Tasks.
Click Unarchive Tasks.

If the tab doesn't display, clear the browser cache.
Check the status to see whether your unarchive operation is complete, still in progress, not started yet (submitted), or failed for some reason.