Importing and Exporting DX Site
Overview
What You Will Learn In This Tutorial
- How to export parts of a DX Site
- How to import parts of a DX Site from exported files
- What to look out for when exporting and deploying DX sites
Reference Site
- WoodBurn Insurance Demo Site could be used as reference to try and test the steps detailed in this guide. You can find it here.
Common Set-up
Config File
-
Create a config file that you can use to set up your frequently used environment variables. Save the config file in your working directory.
sample.config
# the protocol with which to connect to the server export DXPROTOCOL=https # the hostname of the target server export HOSTNAME=localhost # the port on which to connect to the server (for Kubernetes Environment, dxPort is 443) export DXPORT=10041 # the port number of the cw_profile (for Kubernetes Environment, dxConnectPort is 443) export DXCONNECTPORT=10202 # the profile name of the DX core server export DXPROFILENAME=wp_profile
sample.bat
:: The protocol with which to connect to the server set "DXPROTOCOL=https" :: the hostname of the target server set "HOSTNAME=localhost" :: the port on which to connect to the server (for Kubernetes Environment, dxPort is 443) set "DXPORT=10041" :: the port number of the cw_profile (for Kubernetes Environment, dxConnectPort is 443) set "DXCONNECTPORT=10202" :: the profile name of the DX core server set "DXPROFILENAME=wp_profile"
Tip
For Windows batch files, enabling delayed expansion and using ! (i.e: !DXPROTOCOL!) instead of % (i.e: %DXPROTOCOL%) is encouraged to avoid unwanted reuse of old values from previous runs.
How to export parts of a DX Site
- Manual export of a DX Theme via Practitioner Studio
- Manual export of a DX site's_page_hierarchy
- Export a DX Theme via commandline
- Export a DX site's page hierarchy via commandline
- Export the DX site's WCM libraries via commandline
How to import parts of a DX Site from exported files
Here are the steps in order to deploy your exported DX Site:
- Deploy all DX Modules required by your DX Theme.
- Deploy the DX Theme you have created for your site. (Skip if you are using one of the out the box themes).
- Import all of WCM library that have your components.
- Import your site page hierarchy.
- Update all of WCM library that have references to site pages.
- (Optional) Update the script applications
XML files
Sample XML files are available in the WoodBurn Insurance reference site. DXClient samples are also available in the DX server located in the following directory: <portal_server_home>/doc/xml-samples
.
When using Woodburn Insurance Demo
The following xml files are already included in the demo named theme-export.xml and site-export.xml respectively.
Theme Metadata Export XML
This xml will be used to export the metadata xml of theme.
theme-export.xml
<?xml version="1.0" encoding="UTF-8"?>
<!--
=================================================================
* Licensed Materials - Property of IBM
* (c) Copyright IBM Corp. 2012. All rights reserved.
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM
* Corp.
*
* DISCLAIMER OF WARRANTIES. The following [enclosed] code is
* sample code created by IBM Corporation. This sample code is
* not part of any standard or IBM product and is provided to you
* solely for the purpose of assisting you in the development of
* your applications. The code is provided "AS IS", without
* warranty of any kind. IBM shall not be liable for any damages
* arising out of your use of the sample code, even if they have
* been advised of the possibility of such damages.
*
=================================================================
-->
<request
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="PortalConfig_8.0.0.xsd"
type="export">
<portal action="locate">
<skin action="export" objectid="custom.portal.skin.Woodburn%20Insurance.Standard" />
<theme action="export" objectid="custom.portal.theme.Woodburn%20Insurance" />
</portal>
</request>
-
Modify the objectid to match yours.
<portal action="locate"> <skin action="export" objectid="custom.portal.skin.Woodburn%20Insurance.Standard" /> <theme action="export" objectid="custom.portal.theme.Woodburn%20Insurance" /> </portal>
-
You can find the objectid by going to Theme Manager and then clicking the cog.
- Skin objectid.
- Theme objectid.
Page Hierarchy Export XML
This xml is used to export the Page metadata and hierarchy xml of your site.
site-export.xml
<?xml version="1.0" encoding="UTF-8"?>
<!--
=================================================================
*Licensed Materials - Property of IBM
* (c) Copyright IBM Corp. 2003, 2010. All rights reserved.
*
* US Government Users Restricted Rights - Use, duplication or
*disclosure restricted by GSA ADP Schedule Contract with IBM
* Corp.
*
* DISCLAIMER OF WARRANTIES. The following [enclosed] code is
*sample code created by IBM Corporation. This sample code is
* not part of any standard or IBM product and is provided to you
*solely for the purpose of assisting you in the development of
* your applications. The code is provided "AS IS", without
*warranty of any kind. IBM shall not be liable for any damages
* arising out of your use of the sample code, even if they have
*been advised of the possibility of such damages.
*
=================================================================
-->
<request
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="PortalConfig_8.0.0.xsd"
type="export">
<!-- sample for exporting a page -->
<portal action="locate">
<content-node action="export" uniquename="Woodburn Insurance" export-descendants="true"/>
</portal>
</request>
-
Modify the uniquename to match yours.
<content-node action="export" uniquename="Woodburn Insurance" export-descendants="true"/>
-
You can find it in
Administration > Site Management
under theUnique name or Identifier
Column.