Akamai Integration Process for Sites

2

EXECUTIVE SUMMARY

This document provides an explanation of the changes required for this integration. A typical example being
considered here is www.yourdomain.com.


OVERVIEW
A brief overview of the steps can be found below -

Complete the Gating Process to ensure there are no technical incompatibilities.
Post completion of Contractual formalities a nominated Akamai Solutions Architect will work with a
nominated Technical Project Manager from the Customers technical team for the duration of the
integration. Typical duration is 14 days. This process will involve -
o Creating an Alternate Origin Hostname for Akamai to retrieve content from.
o Procuring an SSL certificate (only if applicable) from Akamais Certificate Authority and deploying
the same on the network.
o Installation of Sureroute and SLA test objects to ensure Akamais routing optimization feature can
work properly. SLA test objects serve to ensure that Akamai is meeting Service Level Agreement as
defined by the product.
o Creating an Akamai configuration, Test the setup functionally on Akamai's Staging Network - in
consultation with Akamai Professional Services. For a first time configuration, it is also
recommended to test on the Production Network.
o CNAME-ing www.yourdomain.com to an Akamai provided Hostname.
o Redirecting any requests on the webserver for yourdomain.com, (Top Level domain)
to www.yourdomain.com - so that they can be served via Akamai.
Once Traffic is live on the Akamai Network - Akamai will run comparative tests on Origin V/S Akamai for a
duration of 5-7 days to demonstrate the performance improvement. A report will be shared documenting
this.





3



NEED FOR ALTERNATE ORIGIN HOSTNAME:

Since www.yourdomain.com will be CNAMEd to Akamai. Akamai will need an alternate Origin hostname to
retrieve content from. It is highly recommended to ensure that the dedicated Origin Hostname is not an easily
guessable one.

For eg.

Before Akamai -
www.yourdomain.com points to an A record 10.10.10.10 (illustrative purposes only)
For Integration

Xcwwfad-origin.yourdomain.com will point to 10.10.10.10
www.yourdomain.com will point an Akamai Hostname like www.yourdomain.com.edgesuite.net


SUREROUTE AND SLA TEST OBJECTS:

The Sureroute and SLA Test Objects need to be placed at the Origin so that Akamai can find out the most
optimal paths to your Origin. The objects can be downloaded from
https://control.akamai.com/dl/customers/other/SLA/SRTO_SLA_test_files.zip. Please unzip the files and upload
them on all your Web Servers inside a directory called /akamai. Once you complete this activity, Akamai will be
able to access these objects using the following URLs
https://{YOUR_DOMAIN}/akamai/sureroute-test-object.html
https://{YOUR_DOMAIN}/akamai/sla-test-object.html

Please note that both these objects should be available without any authentication.

END USER IP ADDRESS:

Akamai will extract the end user IP Address and send it in a special HTTP header True-Client-IP. The
application needs to be modified to extract the end user IP Address from this header.

E.g. True-Client-IP: 60.254.151.41

SSL CERTIFICATE FORM (IF APPLICABLE):

If an SSL Certificate is required, then an SSL Network Access form needs to be filled by your team and provided
to Akamai. This captures all the key information required for Akamai to procure a certificate. Please note that
the technical contact details in the form should be accurate for verification purposes.



4
APPENDIX : TESTING INSTRUCTIONS


Staging Network Test Instructions
For Macs:
a) Open a terminal.
b) Open the host file by running the following command, "sudo nano /etc/hosts
c) Point your hostname(s)to the Akamai Staging network IP address.
You can obtain the IP address by doing a Dig using http://www.digwebinterface.com or via the terminal
on <Hostname>.edgesuite-staging.net

For Windows:
a) Open the file, "c:\windows\system32\drivers\etc\hosts\"
b) Point your hostname(s) ) to the Akamai Staging network IP address.
You can obtain the IP address by doing an NSLookup via Command Prompt or a Dig using
http://www.digwebinterface.com on <Hostname>.edgesuite-staging.net.

For Example:
....
<IP ADDRESS> www.yourdomain.com
....
Save the file.
Browse the site from different browsers to ensure that the functionality is the same across all of them.
Regression Testing is highly recommended.


5

Production Network Test Instructions
For Macs:
a) Open a terminal.
b) Open the host file by running the following command, "sudo nano /etc/hosts
c) Point your hostname(s)to the Akamai Production network IP address.
You can obtain the IP address by doing a Dig using http://www.digwebinterface.com or via the terminal
on <Hostname>.edgesuite-staging.net

For Windows:
a) Open the file, "c:\windows\system32\drivers\etc\hosts\"
b) Point your hostname(s) ) to the Akamai Production network IP address.
You can obtain the IP address by doing an NSLookup via Command Prompt or a Dig using
http://www.digwebinterface.com on <Hostname>.edgesuite-staging.net.
For Example:
....
<IP ADDRESS> www.yourdomain.com
....
Save the file.
Browse the site from different browsers to ensure that the functionality is the same across all of them.
Regression Testing is highly recommended.