* This document was revised on Feb 14, 2014 after LB rollout *

===== Bring your own Domain =====

==== Instructions for customers bringing their own Domain name ====

New customers wishing to use their own domain name for the SaaS learning site need to map our production IP Address to the new domain name they wish to use. This assumes that the customer (or someone on their behalf) is in charge of the parent domain name.
This is shown by the example below (it takes into account the SubdomainFu.tld_sizes for production=>1):


  * Assume our Saas Production IP is 1.2.3.4
  * Assume the customer needs to use learning.mydomain.com as their new site name (this is the name that the customer will enter for "Or use your own domain name" under "Website Address" while creating new site from our SaaS main site)
  * Based on the above, the customer needs to map domain "learning.mydomain.com" to IP "1.2.3.4" in their Internal and/or External DNS servers (services) depending on whether the customer will provide access to the internal and/or external users/clients.


Since the tld_size for production is set to 1, the above format of domain name will be supported: sub-domain-size = 1 (mydomain), sitename (learning).

  * As of now, using one's own domain name **WILL NOT** work if we are using SSL (part or full) for our SaaS site (eg: if https://learning.mydomain.com is referenced in full or part on any specific page, like credit card transaction or login)

==== Steps to be taken for custom domain names ====

At a high level, below needs to happen:
  * Create new site in Crossbow, provide customer with [[https://wiki.exphosted.com/doku.php/ip_assignment|public IP]] : 207.20.42.194
  * Lastly, create the new site from learnexa.com as admin, and provide the public IP address to the customer to have them map it to the domain name via A record.