Documentation

Importing/Exporting Sites and Content

Export/Import lets you export and restore your Site and app data as a LAR (Liferay Archive). There are two primary places Export/Import is used: Sites and apps. You can learn more about exporting/importing app data in Exporting/Importing Widget Content. In this section, you’ll learn how to export and import content and pages for Sites.

Site LAR Properties and Requirements

LARs have these properties and requirements:

  • LARs are version dependent. They can be imported into a Site on another Liferay Portal server, as long as the Liferay Portal versions on each server are the same.

  • Some naming collisions are handled automatically. For example, if the LAR you’re importing and the Site both have a page with the same friendly URL, a number is appended to the friendly URL and incremented until the collision no longer occurs. The same is true for category names that collide.

  • You can restore your Site with the latest LAR, but to do so you must delete your Site entirely and then create a new Site with the same name to import the LAR into. This avoids potential data conflicts between content that exists both in the LAR and in the Site.

Note

Periodically exporting LARs is not a backup solution; it should only be used to migrate information between two environments. Please refer to the Backing up a Liferay Portal Installation section for information on backing up Liferay Portal.

Importing and Exporting Pages

Follow these steps to export and import your Site’s pages:

  1. Open the Site Menu and go to PublishingExport.

  2. Click the Add icon (Add icon).

    A New Custom Export page loads. You can choose the pages and content you want to export from your Site:

    • Site pages (you can select exactly which ones)

    • Page settings

    • Theme

    • Theme settings

    • Logo

    • Application configurations

    • Application content

    • Archived setups

    • User preferences

    Create a New Custom Export to specify what to export from your Site.

  3. Enter a Title.

  4. Under Pages, select Public or Private Pages and the settings you want to export.

  5. Under the Content category, select All to export all content or specify a date range or time to filter the content to export.

    Note

    If you select one of the Choose radio selectors or Change links, you’re given checkboxes for options to choose. Application content can also be selected for export, including the Documents and Media Library, Message Boards, and Web Content assets. You can even export the theme you’re using.

  6. Select whether the permissions for your exported pages and content are included.

    You can configure your export options manually by selecting pages, content, and permissions.

  7. Click Export. The menu automatically switches to the Processes tab, where you see the status of your exported LAR file.

  8. Select the Download icon (Download) to download the export to your local machine and copy it to a secure location for safekeeping or import it into another installation of Liferay Portal.

  9. To rebuild or revert back to this version of your Site, you can import this file by clicking the Import button from the Publishing menu, browsing to it, and selecting it. You can also drag a LAR file inside the dotted area, which also executes the import process.

Creating Export Templates

Instead of manually creating an export process every time you export pages and/or content, you can create an Export Template to store the export process settings so they can be reused. To create an Export Template, follow these steps:

  1. Open the Site Menu and navigate to PublishingExport

  2. Select the Options icon (Options) from the top right corner of the screen and select Export Templates.

    You can create Export Templates to store export process settings.

  3. Click the Add button (Add Export Template).

  4. Provide a Name and Description for the template.

  5. Fill out the configuration options for your export process.

  6. Click Save.

Your template is now available to use from the Export Templates menu.

Using Export Templates

To use an Export Template, follow these steps:

  1. Click the Actions (Actions) Menu next to the Export Template and select Export.

    This automatically fills in the fields and options for exporting pages and their content.

  2. Give the export a name.

  3. Click Export to generate your LAR file.