Export and Import Sites

When you need to move a site from one Oracle Content Management instance to another, rather than copy the site, it is easier to export it from one instance and import it to another instance. This is useful, for example, when moving a site from testing to production.

Export a Site

You export a site to a folder with one or more .zip site archives, depending the size of the site and number of assets it uses. That folder can easily be moved for import into another Oracle Content Management instance.

Note:

If a site is configured to use assets from more than one repository, the exported site archive will include assets for the primary repository only. Use Oracle Content Management Toolkit if you must export assets from multiple repositories.

To export a site:

  1. Click Sites and select the site you want to export on the Sites page.

  2. Click Export site icon on the action bar or select Export from the right-click menu.

  3. Specify a name for the export job, add an optional description, and click Select to navigate to a folder in Oracle Content Management as the destination.

  4. Optionally, enable Include unpublished content items and digital assets in your job. If enabled, the export job will include unpublished content items and digital assets. If disabled, then published versions are exported.

  5. Click Export. The site is exported to one or more .zip archives created in the folder you specified. If the exported site uses a large number of assets, then more than one .zip archive may be generated. There is also a .zip archive of the export report that you can use to validate the site export.

    The .zip archives and report can be downloaded and used to import the site to another Oracle Content Management instance or stored as a site backup.

Import a Site

You import a site from a .zip site archive that was exported from an Oracle Content Management site. Exported sites contain one or more .zip archives, depending the the size of the site and the number of assets it uses, as well as a report .zip archive.

Note:

If you import a site to a different server, some links in the site may not be valid in the new server context. If the site uses reference links to images or other content rather than copying the content directly into the site, that content is not available on the new server. Even if you copy the content to the new server, the content will have a different internal ID, and the link will not be valid.

To import a site:

  1. Upload the .zip archive files to a folder in the Documents section of the Oracle Content Management instance to which you are importing the site.

  2. Click Import Site on the Sites page.

  3. Select the folder containing a site archive in the Oracle Content Management instance to which you are importing the site. If the site archive has not yet been uploaded, click Upload to upload a .zip archive of the site to the Documents section of the target instance.

  4. Once you have selected a folder containing the site archive, click Next and then choose the import type.

    • Update Site from Archive—This type replaces a site that already exists on an Oracle Content Management instance.

    • Duplicate Site from Archive—This type copies the archived site to an Oracle Content Management instance.

    • Import Site from Archive—This type creates a new site from the selected archive package.

  5. Click Next.

  6. Select the repository to use for the site assets or create a new one.

    Note:

    Not Ready for Use Assets must be enabled in the selected repository or the import will fail. This allows assets to be saved with default or missing values in required fields, to be completed later. All required fields must still be completed before an asset can be submitted for review or publication.

    You can enable Not Ready for Use Assets when creating a new repository, or enable it on an existing repository by editing the repository if you are a repository administrator.

  7. Specify how the selected repository should handle assets.

  8. Verify or change the localization policy and publishing channels.

  9. Optionally, enable Accept all validation warning messages to override any conflicting changes to the import.

    • If you enable this, the import job will complete regardless of any warnings. Once the job has completed, you can open the Report tab of the job details panel to review any issues or download a full report.
    • If you leave this option disabled, the job will pause each time it encounters a problem and you will need to manually assess the validation and resume the job. To resume a paused job:
    1. In the job list, click the pending job you need to review to open the job details panel.
    2. Click the Report tab to review the validation summary report. You may need to select the report section to find the issue you need to review.
    3. Expand the issue to see why the import has paused. If the reason is acceptable, click Resume Import. If it is not acceptable, return to the job list and cancel the import.

View Export Site and Import Site Job Details

To view a listing of export site or import site jobs, select the option from the View Jobs menu on the Sites page to open the jobs panel. In the listing, you can search for jobs, download log files, see job status, and resubmit jobs that completed, but with errors.

Status Icon Meaning
Job complete icon Complete—The job has successfully finished without issues.
Job complete with errors icon Complete with Errors—The job finished but has some minor issues requiring attention. Review the reports and address the errors, then resubmit.
Job pending icon Pending—The job is currently in progress.
Job paused icon Paused—The job is currently in progress but has paused and needs attention. Review the reports and address the errors.
Job canceled icon Canceled—The job has been canceled.
Job failed icon Failed—The job has failed. Review the reports to help fix issues and resubmit.

Select a job to enable the action bar with actions to cancel, delete, or view details of a job (See details icon). To see details, click on a job name to open a panel with a tab showing job details and a report tab showing a summary of validation warnings, if any, such as changes in content types or other problems with the specific job.

If the import job has completed but has errors ( Job complete with errors icon ), selecting the job also gives you the option to resubmit the job ( Resubmit icon ). This option is available to you only if you created the import job.