Configure Website

Set up your website parameters before deploying it on Microsoft Azure or on a Windows Server.

Before deploying your website on Microsoft Azure or a Windows Server you need to set up domain name / port bindings and configure some other parameters for the website.

You need to access the blob storage and be able to edit files in it for this. We recommend that you use CloudBerry Explorer for Azure Blob Storage for that. (We assume that you've downloaded and installed CloudBerry Explorer and configured it to access the blob storage where you'll be uploading your website to.)

In the initial setup, you have no configuration file in the blob storage for the website. You should create one locally and then upload it to the blob storage.

Create Website Configuration File

  1. Create and XML file naming it "WebsiteConfiguration.xml".
  2. Add the following:
    <?xml version="1.0" encoding="utf-8"?>
    <Configuration>
      <Runtime writeback="false" websiteType="composite-c1" />
      <Bindings>
    	<Binding port="80" />
      </Bindings>
    </Configuration>
  3. Save the file.
These are default values and with this configuration:
  • C1 CMS Azure will synchronize website changes one-way only - from the blob storage to the web role (writeback="false")
  • The website will be treated as a "C1 CMS" website meaning that some unnecessary and temporary file and folder will not be uploaded to the web role (websiteType="composite-c1").
  • The domain name assigned to the cloud service where the web role is working will be used for website access at port 80 (<Binding port="80" />)

The <Binding/> element should be used to bind one or more domain names and / or port numbers to the website as well as set up SSL support.

For more information on WebsiteConfiguration.xml, please see "WebsiteConfiguration.xml".

For information about configuring SSL support, please see "SSL".

Upload Website Configuration File to the Blob Storage

Now that you have WebsiteConfiguration.xml prepared, upload it to the blob storage into a dedicated folder.

  1. Open your blob storage in CloudBerry Explorer.
  2. Open the website container.
  3. Create a folder named "Configuration".
  4. Upload WebsiteConfiguration.xml to this folder.

Whenever you need to change parameters in this file:

  1. Download it to your local computer.
  2. Edit it locally.
  3. Upload it back to the blob storage overwriting the existing WebsiteConfiguration.xml.

Please note that if you want to run more than one website in the same web role/on the same Windows Server, you'll need to configure each of them creating or updating WebsiteConfiguration.xml in the corresponding website container in the storage. (Please see "Multiple Websites" for more information.)

Once you've uploaded and configured the website in the bob storage, you are ready for the next step: