Loading...

Last updated: Feb 04 2019

Area: Episerver DXC Service Applies to versions: Not applicable

DXC Service self-deployment guide

This topic describes how to access the DXC Service Management Portal, and the steps to deploy changes between the Integration, Preproduction, and Production environments, with Episerver Digital Experience Cloud Service

Prerequisites

You need an Episerver cloud account to access the self-services for Episerver DXC Service. See Creating an Episerver cloud account how to get an account.

Note: Generic accounts like access@somedomain.com, or private hotmail-type accounts like my-private-mail@live.com, cannot be used. The self-deployment portal works best with browsers Chrome or Firefox.

Verifying site access before deployment

Before starting a deployment, make sure the site in the source environment is running by accessing it in a browser. If the site has IP restrictions preventing you from navigating to it, ask the technical contact for the site to add your IP address in the exclusions list.

If you cannot reach the site, something is probably wrong and deployment cannot be done. Contact the technical contact for the site to solve the issue, and try again. When you have verified site availability, you can start the deployment.

Deployment steps

In this example we will deploy from the Integration to Preproduction environments, but the procedure is similar when deploying from Preproduction to Production.

If you have issues when deploying to Production and need urgent assistance, contact Episerver (24/7): Worldwide: +46 8 555 827 50; North America: 1-(877)-383-0885 (Toll Free); United Kingdom: +44 800 066 4784 (Toll Free); Australia: +61 2 9248 7215.

  1. Go to the DXC Service management portal on https://paasportal.episerver.net and log in with your account credentials.
  2. When logged in, you will be taken to the Organizations section. Locate the organization and project for which you want to deploy changes, and click on the project name to open it.
     

     
  3. The upper part of the Project page provides the deployment options, with the option to add project notes. The lower part provides information about provisioned environments, site URLs for site verifications, and access to application logs for troubleshooting.
      

       
  4. Before deploying, ensure that the source site (Integration), is up and running. Select the environment in the drop-down, and use the displayed URL to browse to the site. When you have verified that it works, you can deploy.
       

       
  5. Click Deploy to start the deployment. In the dialog that appears, select applicable options:
      
    • If the deployment includes database schema updates or changes to content types, select Use maintenance page, to display a maintenance page while the site is offline.
    • If it is a first-time deployment to the target environment, select Include Blobs & DB to copy these items over. Note that existing BLOBS and database will be overwritten if the option is selected. If this option is not selected, only code will be copied
    • In case of multiple web applications, you can select which ones to deploy.
         

         
  6. Click Start Now. A progress bar displays the progress of the deployment. Click View output log to see deployment step details. See Deployment process, for an explanation of the procedure. You can also click Cancel to stop the deployment and roll back the changes, if needed.
      

       
  7. When the first part of the deployment is done, you will see a confirmation message in the portal. Click the Preview... link to verify that the site(s) in the slot is working as expected.
        

        
    An email is also sent to the technical contact for the target site, with link(s) to the slot URL(s) that can be used for site verification.



    Note: DO NOT continue with the deployment if a site in a slot cannot be properly verified.   
  8. When you have successfully verified the site(s) in the previous step, click Complete to finalize the deployment. Alternatively, if the deployment did not succeed, click Reset to revert the changes, and continue to step 11.
  9. The progress bar appears, and the site in the slot is swapped into the Preproduction environment.
  10. When completed, the project page will display the Deploy option again. You can click the information icon next to the environment name to see when the latest deployment was completed.
        

       
  11. If you clicked Reset in step 8, the Preproduction environment will be reverted to its initial state if a site did not work as expected in the first deployment part. Click Reset in the confirmation dialog, to complete the reset, and go to the troubleshooting section below to solve the issues.
      

       
  12. If the deployment succeeded, verify that the Preproduction environment works as expected.

Troubleshooting deployments

In case of an unsuccessful deployment, you will see an error message in the Project page. 

Click error log for detailed information, to see a summary of the deployment issues. 

If the information here is not sufficient to identify the issues, click View Job Log to open the Job output view. This contains detailed deployment information as described below.

Deployment job log output

This view provides information about the site(s) and environments involved in the deployment. You can also find exceptions, error messages, warnings and deployment output steps, useful when troubleshooting deployment issues.

Click Get Detailed Log to receive the same information in an email. This is useful if you want to share the information with someone without access to the portal.

Log Stream

The Log Stream options allows you to view output from Episerver log files to help in troubleshooting deployment errors. This option requires diagnostics logging to a Blob storage being enabled, as described in the article Enable diagnostics logging for web apps in Azure App Service.

Click Open Log Stream Window to access the log stream. Here you can hook on the Episerver logs to monitor the live log stream from all sites instances. Click Pause or Resume to stop or continue the streaming of log information. Click Clear to remove the recent log output.

Log stream view

 


Do you have feedback on this documentation? Send an email to documentation@episerver.com. For development-related questions and discussions, refer to our Forums on https://world.episerver.com/forum/