Add a hostname
Why use a hostname?
For TVMS, you must have domain names for a user application and for a streaming.
TV apps require a hostname to be linked to CRM. Then, a service will be available by this hostname.
For a TV application, a hostname will work in this way:
A built app is pointed to a hostname that is bound to CRM, all the info that users see is got from there.
This is a quick overview, for the detailed documentation, refer to the Hostnames guide.
Which domain name to use?
The difference between production and test domains:
Pre-defined domain is a third-level domain issued by MwareTV
Production domain is your own hostname that will be constantly used in your app, like
app.company.com
Only third-level domains are allowed. Use domain names like watch.companyname.com or app.companyname.com.
SSL certificate
You can request certificate creation at any time. However, it requires a URL to be added in the TVMS as a secure one and CNAMED to securecloudmap.akamaized.net.
You can check a URL by opening the WebTV app. Highly probable that your browser shows you the security warning, just ignore it. The app should start on the language selection page.
Do not create an SSL certificate for this domain yourself, but notify the MwareTV support team. They will create the SSL certificate at Akamai CDN for you.
CNAME
Your domain like app.company.com must be CNAME to our edgename: securecloudmap.akamaized.net.
A Canonical Name (CNAME) Record is used in the Domain Name System (DNS) to create an alias from one domain name to another domain name
If you use a hosting company service, please refer to its documentation or contact the support. Also, refer for manual examples of GoDaddy and CloudFlare.
If you use BIND, add a record to your domain's zone file and then reload the zone. On Ubuntu, for instance, the zone file will usually be in /etc/bind/db.example.com. The new line in the zone file should look like this:
Instructions for adding a CNAME record to Windows Server 2008 can be found at http://technet.microsoft.com/en-us/library/cc772053.aspx
MwareTV support team can add the CNAME for your domain. In this case, please provide us with access to the domain name hosting. For the security sake, you can change the login afterward.
Adding to TVMS
Go to the TVMS, click My Deployments, select desired UI Toolkit, click Hostnames.
Specify a hostname:
To use a test hostname, toggle the Hostname Type. Specify a Test Hostname, it can be your company name. This domain is unsecured and used for test purposes only.
To use a production hostname, leave Hostname Type and toggle Is Secure. Then, specify Production Hostname. It must be a third-level domain name. Only third-level domains are allowed. Use domain names like watch.companyname.com or app.companyname.com. Your domain like app.company.com must be CNAME to our edgename: securecloudmap.akamaized.net. Refer to the examples of GoDaddy and CloudFlare.
Ask MwareTV team to make it secured.
Specify a company website in Support URL. You may specify Login Text to be used as a greeting message your users will see when logging in to this hostname.
Upload a logo of 2:1 aspect ratio and background image of 16:9 ratio.
Click Add Hostname to finish.
You may combine multiple CRM and its hostnames into one Superhost name, so users can access different services from one place. Refer to the Super hostname guide to learn more.
Prepare streaming server
In case your server is mapped to Akamai CDN, IP address is sufficient. In other cases, a hostname is required. A Record must be created, pointing to the IP address of the server. E.g. streamer01.myhostname.com.
Akamai
When using Akamai CDN there is no need to use SSL certificate on the streaming server. Akamai will perform HTTPS Downgrade to Origin.
If the app url is http, no need to use https for the streams. However, using https for the app and streams is highly recommended. If the protocol downgrade is not done by CDN and the app url is https, the stream url must be https as well.
Flussonic
For Flussonic there is an easy way to enable a letsencrypt certificate: https://flussonic.com/doc/admin/let-s-encrypt-and-flussonic-media-server/#admin-letsencrypt-page.
For other configurations contact your network administrator.
Last updated
