Create an affiliate site

Step-by-step guide

To deploy a new affiliate member website follow these steps in order;

• Edit the member record in MMS.
• Retrieve the canonical domain for the website from Chassis.
• Update the member record in MMS with the canonical domain.
• Create a Route53 record in AWS.
• Check the DNS is properly configured.
• Request an HTTP certificate.

Edit the member record in MMS

1. Login to MMS.
2. Edit the member record for which you would like to create the affiliate site.
3. In the Affiliate details section update Has website? to Yes.
4. In the Profile publishing section set Publish profile? to Yes.
5. Save the record.

Retrieve the canonical domain from Chassis

1. Login to Chassis.
2. Click on the Websites menu item. 
3. Filter the website record to find the website for the member you need to create a website for.
4. With the member located copy the value of the Canonical domain field.

Update the canonical domain in MMS

1. Login to MMS.
2. Find the appropriate affiliate member record and edit it.
3. In the Website details section add the canonical URL value copied into the Website domain field.
4. Save the record.

Create a Route53 record

1. Login to AWS.
2. Search for Route 53 in the services and visit it.
3. Click on the 1 hosted zone and select repcoservice.net.
4. Click on Create record.
5. Create a new CNAME record using the value from the Canonical domain field in Chassis. Set it up like the following example
6. To create the new CNAME record use the value from the Canonical domain field in Chassis. Use the following as a guide;
   
   Record name:
   Enter the subdomain (i.e. untypical-affiliate).
   
   Record type:
   Choose CNAME.
   
   Value:
   Enter the {subdomain}.repcoservice.net.c.section.io.
   
   TTL:
   300
   
   Routing policy:
   Simple routing
7. Click Create records to save.

Notes: 

1. The value is always `{memberName}-affiliate.repcoservice.net.c.section.io`  

For example, if the member name is Redhead Automotive Centre then the value is: `redheadautomotivecentre-affiliate.repcoservice.net.c.section.io`

2. Important: please leave an hour before continuing. This will allow the DNS to propagate and ensure the Let's Encrypt cert can be acquired in a timely fashion.

Info: An affiliate member record must be active and must have Has website? set to `yes` in MMS for Chassis to create a website record for affiliate member.

Check the DNS is properly configured

1. Login to Chassis.
2. Click on the Websites menu item. 
3. Filter the website record to find the website for the member you need to create a website for.
4. With the website located, click the drop-down menu in the Actions column.
5. Choose Check DNS.
6. If you can see a Yes in the DNS setup? column, you can continue. If you not, either give it more time or check the AWS set up to ensure everything is accurate.

Request an HTTP certificate

1. Login to Chassis.
2. Click on the Websites menu item. 
3. Filter the website record to find the website for the member you need to create a website for.
4. With the website located, click the drop-down menu in the Actions column.
5. Choose “Add domain”. Wait two minutes.
6. Choose Request HTTPS certificates.
7. Allow 5 minutes for Section to acquire the certificates (please note, this can sometimes take up 24 hours).
8. Check everything is working by visiting the URL of the domain you've just setup, ensuring you're using

Custom domains

If an affiliate member has a custom domain follow these steps;

1. Find the website record in Chassis under websites and edit.
2. Copy the default canonical URL found under website details and save it (you will need to add this default canonical URL in domain list later).
3. Update canonical URL with the custom domain URL.
4. Now add the default canonical URL (from step 2) in the domains field and add it to domains list.
5. Save the website record.
6. Update the website URL of affiliate member in MMS with the custom domain.
7. Create the CNAME record using the new canonical URL.