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.