Getting CIS running with a new subdomain

Follow these steps to practice using CIS with a subdomain or CNAME. This example uses the GoDaddy domain registrar. Your case might be different, depending on which registrar you use.

1. Deploy a CIS instance by using the IBM Cloud console or API.

   It is recommended that you mirror the name of your CIS instance with the domain or subdomain.

2. Click Let’s get started.

3. Enter the subdomain in the Domain name field and click Connect and continue.

4. For new subdomains click Next Step, for existing subdomains click Import records.

5. Make note the New NS records for entry into the GoDaddy DNS Management system.

6. Log in to GoDaddy domain Registrar.

7. Navigate to the DNS Management page for the candidate CIS domain. IBM Cloud® must be updated through the API.

8. Click ADD to create an NS Host record for each name server entry provided from CIS.

9. Set up a DNS record with the supplied CIS NS Records

   • Type Nameserver
   • Host subdomain (the name of the subdomain, for example, subdomain.example.com)
   • Points to ns004.name.cloud.ibm.com
   • TTL ½ hour

10. The DNS Management page now reflects the two new NS records for the subdomain.

11. Go back to the IBM Cloud Internet Services instance.

12. After the NS Records are DNS propagated, it is reflected in the DNS tools, and you are ready to proceed.

13. With completed NS propagation, click Check name servers.

14. CIS starts checking NS configuration for the subdomain and might be in a Pending State.

    Any typographical errors in can produce a "silent" failure. If your subdomain is in the pending state for more than 30 minutes, you might have an error.

Upon successful subdomain name server and NS record confirmation, the CIS instance reports Active. Customers are now ready to start configuring the service and routing traffic to their services.