Custom hostnames instead of IP addresses in self-referencing links

Question:

When I click the Server Administration link in the Centova Cast user control panel, I see my server's IP address in the URL bar instead of a hostname. This is also true of the .pls files generated by Centova Cast's Tune In links. Can I use a custom hostname instead?

Answer:

Yes, this is configurable in /usr/local/centovacast/etc/centovacast.conf. There are two ways to configure this:

Per-Account Hostnames

If you want the self-referencing links to use the individual hostnames you've entered in the configuration for each stream, look for:

SELFREF_HOSTNAME=false

...and change false to true.

Note that THIS WILL BREAK YOUR STREAMS if you failed to specify a hostname for any of your streams, and/or if that hostname is not configured in DNS to point to the correct IP address of the stream. If you do not fully understand how DNS works, it is advisable to avoid modifying this setting.

Server-wide Hostname

If you want all streams to use the same, custom hostname, look for:

SELFREF_OVERRIDE=

...and specify your own custom hostname here. For example, to have all self- referencing links point to foo.example.com, you might use:

SELFREF_OVERRIDE=foo.example.com

Again, note that THIS WILL BREAK YOUR STREAMS if the hostname you specify here is not configured in DNS to point to the correct IP address for your streams. If you do not fully understand how DNS works, it is advisable to avoid modifying this setting.

Further, be aware that the SELFREF_OVERRIDE feature is only useful if your Centova Cast web interface controls only ONE Centova Cast back-end hosting server. If your web interface controls multiple hosting servers, you cannot use this option (for obvious reasons -- multiple servers cannot all share the same hostname).

Please understand that these are advanced options and are only provided as a convenience for more advanced systems administrators. If after enabling these options you find that you cannot tune into streams and/or access the ShoutCast/IceCast status pages, you will need to troubleshoot your DNS configuration. Centova Technologies cannot provide technical support for this, and our helpdesk staff will ask you to disable these options prior to providing technical support for such issues.

NOTE: This article is for Centova Cast v3 only; an alternate version exists for Centova Cast v2.