Archiving and Unarchiving Using Catalog Manager

Catalog Manager provides the ability to archive and unarchive either an individual catalog folder or an entire catalog.

See the following list for important information on this functionality:

• When you archive an individual catalog folder, all objects in the folder and the folder's subfolders are saved in single compressed file. Properties and attributes of objects are included in the archive file.

• When you unarchive an individual catalog folder, the archive file is uncompressed and all objects in the folder and the folder's subfolders are then stored in the current offline catalog. Existing folders that have the same names as folders being unarchived are overwritten without warning.

• Archiving and unarchiving an entire catalog using Catalog Manager or the Catalog page in Presentation Services is not recommended. Instead, use either the 7-Zip utility or .tar.gz files on UNIX systems for archiving and unarchiving an entire catalog.

• Do not archive an entire catalog by starting at the root level (\). Always specify specific folder names when archiving.

• Do not use the following utilities when archiving and unarchiving an entire catalog:

  • WinZip — The WinZip utility does not always handle extended UNIX file permissions properly. Using the WinZip utility to move catalogs in heterogeneous environments might lead to corrupted catalog files.

  • FTP — Some third-party FTP programs rename internal files, which might lead to corrupted catalog files. Before moving a catalog using an FTP program, use the 7-Zip utility to compress the catalog into one file.

You can use the Catalog page in Presentation Services to archive and unarchive objects. For information, see Archiving Objects in User's Guide for Oracle Business Intelligence Enterprise Edition.

Archiving a Folder Using Catalog Manager

Use the following procedure to archive a catalog folder.

To archive an individual catalog folder in the catalog to a file that you specify:

1. In Catalog Manager, open the catalog in offline mode.
2. Highlight the catalog folder and from the File menu, select Archive.
3. In the Archive File Path field, specify the path name of the file in which to archive the folder. Click Browse to display a dialog for selecting the path name.
4. To archive the folder:

   • Timestamps that are assigned to the objects and folders that you are archiving, then select the Keep file time stamps option.

     If you do not select this option, then the archiving process does not include timestamp information and the Old option in the Paste Overwrite area of the Preferences dialog is ignored. Upon unarchiving, the system applies a timestamp that indicates the time at which the object or folder is unarchived.

     See Advanced Options for Pasting Objects for more information.

   • Permissions that are assigned to each object or folder, then select the Keep permissions option.

     If you do not select this option, then the archiving process does not include any permissions and the options in the Paste ACL area of the Preferences dialog are ignored. Upon unarchiving, the system assigns the parent folder's permissions to all of the objects and folders.

5. Click OK.

Unarchiving a Folder Using Catalog Manager

You can use Catalog Manager to remove a folder from archive.

Unarchiving is similar to pasting and therefore requires that you understand the issues that relate to permissions and ACLS as described in Advanced Options for Pasting Objects. Use the following procedure to unarchive a catalog folder.

To unarchive a catalog folder:

1. In Catalog Manager, open the catalog in offline mode.
2. To unarchive a catalog folder, navigate to the location where you want to unarchive the folder.
3. From the File menu, select Unarchive.
4. In the Archive File Path field, specify the path name of the catalog folder to unarchive. Click Browse to display a dialog for selecting the path name.
5. Click OK.