Deploying an existing Commerce site
This topic describes first-time onboarding deployment of an existing Commerce website to the Integration environment, as part of the Episerver DXC Service.
When is this applicable?
This is an onboarding scenario for an existing site which you want to move to a cloud-based environment for the first time, for further development and maintenance there. In this case you already have a database with content, and you will need to get that restored to the correct application, which will be done by Episerver.
Before you start
Here we will use Visual Studio with the EPiServer extensions and publish profiles, however you can also use other deployment methods.
- See Requirements for recommended versions of software, tools and services to use when deploying.
- See Getting started for information needed to deploy.
Note: if not already done, remember to change the default login credentials (admin/store) provided in the Commerce installation, before deploying. See Installing Episerver for more information.
Output and file formats
To deploy from your local development environment, you need to create a set of output files, and provide these to Episerver for deployment to the Integration environment.
A Commerce solution consists of two websites, a front-end site and the back-end Commerce Manager site, and two databases, one for CMS and one for Commerce. This means that there will be additional output components compared to a plain CMS site.
The following output is needed for deployment of a Commerce site:
- The web application as a zip file; one for the front-end site and one for the Commerce Manager back-end site.
- The database as a bacpac file; one for the CMS database and one Commerce.
- The media/BLOB files in a zip file; (only one).
1. Creating the output files
Open your solution in Visual Studio, and repeat steps 1-5 below for the front-end site, and for the back-end Commerce Manager site, to create the output files for the web application.
Note: For the Commerce Manager site you need to include the Apps folder manually in the zip file.
- Right-click on your project and select Publish.
- Select Custom, provide a name for the publish profile and click OK to go to Connection.
- Select File system as Publish method, select a target location for the files and click Next.
- Under Settings, select Release for publishing configuration and click Publish.
- Locate the application files in the target folder you selected in step 3, and zip them using a zip tool of your choice.
In MS SQL Server Studio, repeat steps 1-5 below for the front-end site database, and for the back-end Commerce Manager database, to create the bacpac output files.
- Connect to the database to use. Select and right-click on the database, select Tasks and Export Data-tier Application...
- In Export Settings, select Save to local disk, select a target location for the files, provide a name for the bacpac file, and click Next.
- After the export, verify the results and click Close.
For the front-end site, follow the steps below to create the output file for the media/BLOB content.
- In Visual Studio, right-click on your project and select Open folder in File Explorer.
- Locate the "blobs" folder under "App_Data", and zip the content of the blobs folder using a zip tool of your choice.
2. Uploading the output files
When you have created the output files, contact Episerver, and follow the instructions provided to upload them to the assigned area. The deployment will then be finalized by Episerver.