Create an Ion property

Set up a delivery property to determine how your microsite will be delivered to requesting clients. We'll use ​the Akamai​ setup wizard to do this.

Begin the Ion Setup Wizard

  1. Start the setup wizard by following the instructions in Create a new guided Ion property.

  2. Enter the FQDN of your Linode origin server as the Hostname. In this guide, we use the example domain www.test.com.

  3. In the Origin Server section select Web server as the Origin hostname and accept the suggested value for the Origin hostname.

    Origin ServerOrigin Server

Configure the Origin Hostname for your Linode

  1. Add the origin hostname to your origin server domain’s DNS settings.

    For example, if your Linode IP address is 203.0.113.1 and the suggested origin hostname is origin-0361ece-www.test.com, your Linode DNS Manager domain zone needs to have an A record with the following values according to your choice of primary domain:

    Origin ServerOrigin Server

  2. Verify your new origin hostname DNS configuration. For instructions, see the Use dig to Perform Manual DNS Queries guide.

  3. Update your web server to include the origin hostname.

    For example, if you are using NGINX, add the full hostname to the server_name entry as below:

server {
    server_name  origin-0361ece-www.test.com test.com www.test.com;
...
  1. Then reload NGINX.

    systemctl reload nginx

  2. Next, update your origin certificate to include the Origin hostname and reload your web server.

    If using the Node.js Marketplace App, access your origin server via LISH or SSH connection, replacing the example hostnames with your own:

    certbot --expand -d www.test.com -d origin-0361ece-www.test.com

  3. Select 1: No redirect when prompted to complete SSL certificate configuration, then reload your NGINX server:

    systemctl reload nginx

  4. While you are connected, rename the Linode’s system hostname to help identify it later:

    hostnamectl set-hostname server1

Complete the Ion Setup Wizard

  1. In the Ion setup wizard ORIGIN SERVER window, select Validate.

  2. Continue to the EDGE CERTIFICATE configuration in the Ion setup wizard.

  3. Select Standard TLS and add the following TXT record to the FQDN domain zone as guided.

    If using Linode DNS Manager, create a TXT record in a domain zone for the Linode’s full hostname. Refer to the following example settings:

    TXT RecordTXT Record

📘

Ensure that there no extra empty spaces when entering the Record Value.

  1. Verify your domain validation DNS record, then click the Validate button.

  2. Continue through the Ion setup wizard by selecting default values for remaining prompts.

  3. When you reach the Review and activate step, click Activate to enable your Ion configuration and Edge certificates.

    This process takes several minutes to complete. Wait for the Next button to appear, then click it to continue.

  4. Once your Ion configuration is activated, your Ion property should now include an Edge hostname such as www.test.com.edgesuite.net. Follow the instructions under the Verify section of the Ion setup wizard to test connectivity directly to your Edge hostname’s IP address by updating your local hosts file. If the IP address for your Edge hostname does not appear before your domain under Hosts file entry as shown in the screen capture below, refresh the page until it does.

    Verify settingsVerify settings

  5. After you complete the test, remove the line you added to your local hosts file and click Next.

📘

You can also test with staging IP addresses for your Edge hostname. For example, if your edge hostname is www.test.com.edgesuite.net, its staging hostname is www.test.com.edgesuite-staging.net.

Run the nslookup or dig commands on the staging hostname as shown below.

dig www.test.com.edgesuite-staging.net +short

nslookup www.test.com.edgesuite-staging.net

As a result, you will see two staging IP addresses. Add either of them to your local hosts file along with your domain and perform the same Verify section browser test.

  1. Replace existing DNS A/AAAA records with an alias to direct your Ion property hostname to your new Edge hostname.

    If using Linode DNS Manager, you must first remove all A/AAAA records and primary domain zones for your Ion property hostname, then create a CNAME record according to the following example values:

    CNAME RecordCNAME Record

  2. Verify your DNS configuration changes, then click Check CNAME in the Ion setup wizard. Once your CNAME record is confirmed, requests to your domain should now route through Akamai’s Edge CDN.