Icecast Server/2.5 Maintenance: Difference between revisions
Initial stub |
→Sources list: Added list of messages |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
Icecast versions 2.5.x report a list of "Maintenance" items in the dashboard within the admin interface. Those messages are meant to provide help to keep a deployment in best shape. | Icecast versions 2.5.x report a list of "Maintenance" items in the dashboard within the admin interface. Those messages are meant to provide help to keep a deployment in best shape. | ||
The Following levels are defined: | |||
=== Info === | === Info === | ||
Info level messages are just there to aid e.g. in case of a problem. No active action is required. | Info level messages are just there to aid e.g. in case of a problem. No active action is required. | ||
=== Warning === | |||
Warnings should be considered thoroughly and the problems generally should be resolved in a timely manner. It is possible that the operation is affected by the problems reported with warnings. | |||
=== Error === | |||
Errors record actual problems and should be taken care of as soon as possible. | |||
== Dashboard == | |||
The following messages can be found on the global dashboard. | |||
=== Info === | |||
==== Core files are disabled. / Core files are enabled. ==== | ==== Core files are disabled. / Core files are enabled. ==== | ||
| Line 14: | Line 27: | ||
This information may be hidden if Icecast seems to be configured correctly to avoid spamming the section. | This information may be hidden if Icecast seems to be configured correctly to avoid spamming the section. | ||
==== chroot configured and active. ==== | |||
chroot was configured and is active. See your operation system's documentation on the details of chroot. | |||
==== Change of UID/GID configured and active. ==== | |||
Changing of the user ID and/or group ID was configured and was successful. | |||
==== Currently no sources are connected to this server. ==== | |||
There are currently no sources connected. The server is in idle state. | |||
==== More than 75% of the server's configured maximum clients are connected ==== | |||
The server reached at least 75% of it's configured client limit. If that is a reason to take action depends on the current relative load (base load, peak hours, ...) of the server and the type of listeners. | |||
==== Environment is noisy. ==== | |||
The user environment contains entries that should not be present in a daemon environment. This is a indication for the server being started as a user process instead of as a daemon. This should not be seen in production. | |||
=== Warning === | === Warning === | ||
| Line 20: | Line 50: | ||
Icecast is build with developer logging active. This should never be seen in production. If seen without an Icecast developer asked for it it should be disabled. To disable this Icecast needs to be recompiled. | Icecast is build with developer logging active. This should never be seen in production. If seen without an Icecast developer asked for it it should be disabled. To disable this Icecast needs to be recompiled. | ||
=== Hostname is not set to anything useful in <hostname>. === | ==== Hostname is not set to anything useful in <hostname>. ==== | ||
The hostname tag is not set correctly in the Icecast configuration. Some features such as directory support may be disabled. There is generally more details in the error log. | The hostname tag is not set correctly in the Icecast configuration. Some features such as directory support may be disabled. Playlist generation may not work correctly. There is generally more details in the error log. See https://icecast.org/faq/#faqentry-what-should-i-set-hostname-to for details. | ||
==== No useful location is given in <location>. ==== | |||
The location tag is not set to anything useful in the configuration. See https://icecast.org/faq/#faqentry-what-should-i-set-location-to for details. | |||
==== No admin contact given in <admin>. YP directory support is disabled. ==== | |||
No valid admin contact details are given. Some features such as directory support may be disabled. See https://icecast.org/faq/#faqentry-what-should-i-set-admin-to for details. | |||
==== Legacy sources are connected. See mount list for details. ==== | |||
Sources using legacy features or protocols are connected. This for example includes ICY sources. The list of sources should be checked for possibility of upgrading those sources. | |||
==== More than 90% of the server's configured maximum clients are connected ==== | |||
More than 90% of the server's configured client limit is connected. This might be a sign that the limit should be lifted higher. However this might also be normal (for example in peak hours or when the number of listeners is very stable and the limit is set close to that). | |||
==== No secure password hash support detected. ==== | |||
No secure password hashing scheme was detected. Icecast will fall back to legacy support. It is best to contact the support with the full details from the admin's version page. | |||
=== Error === | === Error === | ||
==== Global client, and source limit is bigger than suitable for current open file limit. ==== | ==== Global client, and source limit is bigger than suitable for current open file limit. ==== | ||
| Line 33: | Line 77: | ||
==== IPv6 not enabled. ==== | ==== IPv6 not enabled. ==== | ||
Icecast is configured with only legacy IP enabled. The current IP version (IPv6) needs to be enabled. | Icecast is configured with only legacy IP enabled. The current IP version (IPv6) needs to be enabled. | ||
==== No PRNG seed configured. PRNG is insecure. ==== | |||
No configuration for the PRNG is given. The generator may return weak values. libigloo defaults are used. See libigloo's documentation for details. | |||
==== Unknown tags are used in the config file. See the error.log for details. ==== | |||
Unknown tags are found in the configuration file. Those are invalid and future versions of Icecast may not load with them present. See the error log for details. | |||
Unknown tags are often a result of typos. | |||
==== Obsolete tags are used in the config file. See the error.log for details and update your configuration accordingly. ==== | |||
Obsolete tags are found in the configuration file. Those should be updated or removed accordingly. Future versions of Icecast may not load with them present. See the error log for details. | |||
==== Invalid tags are used in the config file. See the error.log for details and update your configuration accordingly. ==== | |||
Invalid tags (for example tags with invalid values) are found in the configuration file. Those must be corrected. Future versions of Icecast may not load with them present. See the error log for details. | |||
==== The configuration did not validate. See the error.log for details and update your configuration accordingly. ==== | |||
The configuration file is not valid. It may contain logical errors such as invalid combinations of values. Those must be corrected. Future versions of Icecast may not load with them present. See the error log for details. | |||
==== File permissions are wrong. See the error.log for details and update your configuration accordingly. Future versions of Icecast may reject affected files. ==== | |||
Some of the files used by Icecast (such as the configuration or logfiles) have wrong permissions. Please check the permissions and correct them accordingly. The error log will contain more information on which files are the problem. | |||
==== Potentially unsafe file permissions. See the error.log for details and update your configuration accordingly. Future versions of Icecast may reject affected files. ==== | |||
Some of the files used by Icecast seem to have unsafe permissions. This may result in leakage of credentials, secret keys, or similar data. It is strongly recommended to check the files reported in the error log and change credentials and secret keys accordingly. | |||
Future versions of Icecast may reject those files, including rejecting to start at all or only starting in a limited fashion if unresolved. | |||
==== chroot configured but failed. ==== | |||
chroot was configured but failed. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details. | |||
==== chroot configured but not supported by operating system. ==== | |||
chroot was configured but is not supported by the operating system. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details. | |||
==== Change of UID/GID configured but failed. ==== | |||
Changing of the user ID and/or group ID was configured but failed. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details. | |||
==== Change of UID/GID configured but not supported by operating system. ==== | |||
Changing of the user ID and/or group ID was configured but is not supported by the operating system. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details. | |||
== Sources list == | |||
=== Info === | |||
==== Legacy HTTP/1.0 listener ==== | |||
One or more legacy listeners has accessed the stream. | |||
The client should upgrade. | |||
No action is required on Icecast's side. | |||
==== Listener without usable Host:-header ==== | |||
One or more listeners connected without sending a usable `Host:`-header. | |||
Icecast may not provide the best service to such clients as the value needs to be guessed. | |||
This is a problem more common with ancient clients. | |||
No action is required on Icecast's side. | |||
==== No content language set ==== | |||
The source did not set a language for the stream. | |||
The source client's configuration should be checked and updated accordantly. | |||
No action is required on Icecast's side. | |||
=== Warning === | |||
==== Legacy or unsupported streaming format is used. ==== | |||
The stream is sent in an legacy or an unsupported format. | |||
Icecast falls back to a generic handler which might or might not work. | |||
No formal support is provided for such streams. | |||
It is best to only stream in fully supported formats. | |||
The format can be selected in most source clients. | |||
No action is required on Icecast's side. | |||
==== Character set is not UTF-8 ==== | |||
The character set of the stream is not UTF-8. | |||
This can be a problem with legacy streams (ICY). | |||
This can result in metadata not being shown correctly. | |||
It is recommended to consider setting the stream's character set to UTF-8. | |||
However, this can also upset legacy clients. | |||
Caution is advised. | |||
==== The stream did not mature yet. ==== | |||
The stream is still very new. | |||
This message will resolve itself after a few seconds on a healthy stream. | |||
If the message seems to be persistent or is often reported over a span of several minutes there is a problem with the source client's connection or the data the source client sends. | |||
If unresolved for several minutes, the source client's connection should be checked. | |||
If the source client's connection is fine, the source client seems to not work properly. | |||
No action is required on Icecast's side. | |||
=== Error === | |||
==== No data has yet been received. ==== | |||
This message is reported when no data has yet been received by Icecast from the source client. | |||
If this message persists for several seconds, the source client is most likely not working properly. | |||
It is possible but highly unlikely, that this is caused by a bad network connection. | |||
If so, the connection is likely not suitable for a source client at all (independent on the source's settings such as bitrate). | |||
No action is required on Icecast's side. | |||
==== Legacy metadata on non-legacy source received. This is likely a bug in the source client. ==== | |||
A legacy metadata update request was sent on a non-legacy source. | |||
This is most likely a bug in the source client. | |||
It is also possible that other components try to update the metadata in a way unsuitable for the stream. | |||
Icecast may reject such requests for security reasons. | |||
Metadata might not work correctly on such streams. | |||
It is best to report this to the source client's vendor. | |||
No action is required on Icecast's side. | |||
Latest revision as of 23:29, 19 January 2026
Icecast 2.5.x Maintenance
Overview
Icecast versions 2.5.x report a list of "Maintenance" items in the dashboard within the admin interface. Those messages are meant to provide help to keep a deployment in best shape.
The Following levels are defined:
Info
Info level messages are just there to aid e.g. in case of a problem. No active action is required.
Warning
Warnings should be considered thoroughly and the problems generally should be resolved in a timely manner. It is possible that the operation is affected by the problems reported with warnings.
Error
Errors record actual problems and should be taken care of as soon as possible.
Dashboard
The following messages can be found on the global dashboard.
Info
Core files are disabled. / Core files are enabled.
This informs whether or not core files are enabled. Core files are a classic mean of debugging offered by some operating systems. Support may ask for this value.
IPv4-mapped IPv6 is available on this system.
The operation system supports legacy IP via current IP sockets. This means that only an IPv6 socket needs to be configured to also handle legacy IP.
This information may be hidden if Icecast seems to be configured correctly to avoid spamming the section.
chroot configured and active.
chroot was configured and is active. See your operation system's documentation on the details of chroot.
Change of UID/GID configured and active.
Changing of the user ID and/or group ID was configured and was successful.
Currently no sources are connected to this server.
There are currently no sources connected. The server is in idle state.
More than 75% of the server's configured maximum clients are connected
The server reached at least 75% of it's configured client limit. If that is a reason to take action depends on the current relative load (base load, peak hours, ...) of the server and the type of listeners.
Environment is noisy.
The user environment contains entries that should not be present in a daemon environment. This is a indication for the server being started as a user process instead of as a daemon. This should not be seen in production.
Warning
Developer logging is active. This mode is not for production.
Icecast is build with developer logging active. This should never be seen in production. If seen without an Icecast developer asked for it it should be disabled. To disable this Icecast needs to be recompiled.
Hostname is not set to anything useful in <hostname>.
The hostname tag is not set correctly in the Icecast configuration. Some features such as directory support may be disabled. Playlist generation may not work correctly. There is generally more details in the error log. See https://icecast.org/faq/#faqentry-what-should-i-set-hostname-to for details.
No useful location is given in <location>.
The location tag is not set to anything useful in the configuration. See https://icecast.org/faq/#faqentry-what-should-i-set-location-to for details.
No admin contact given in <admin>. YP directory support is disabled.
No valid admin contact details are given. Some features such as directory support may be disabled. See https://icecast.org/faq/#faqentry-what-should-i-set-admin-to for details.
Legacy sources are connected. See mount list for details.
Sources using legacy features or protocols are connected. This for example includes ICY sources. The list of sources should be checked for possibility of upgrading those sources.
More than 90% of the server's configured maximum clients are connected
More than 90% of the server's configured client limit is connected. This might be a sign that the limit should be lifted higher. However this might also be normal (for example in peak hours or when the number of listeners is very stable and the limit is set close to that).
No secure password hash support detected.
No secure password hashing scheme was detected. Icecast will fall back to legacy support. It is best to contact the support with the full details from the admin's version page.
Error
Global client, and source limit is bigger than suitable for current open file limit.
Icecast is configured in a way allowing for more connections than the operating system permits. This may result in strange behaviour when the operating system's limit is reached.
Usually this is due to Icecast being set to some aggressively high client limit. However it can also be due to a low limit enforced by the operating system. In general the limit of the operating system must be higher than the one set by Icecast for Icecast to actually handle the number of clients.
IPv6 not enabled.
Icecast is configured with only legacy IP enabled. The current IP version (IPv6) needs to be enabled.
No PRNG seed configured. PRNG is insecure.
No configuration for the PRNG is given. The generator may return weak values. libigloo defaults are used. See libigloo's documentation for details.
Unknown tags are used in the config file. See the error.log for details.
Unknown tags are found in the configuration file. Those are invalid and future versions of Icecast may not load with them present. See the error log for details.
Unknown tags are often a result of typos.
Obsolete tags are used in the config file. See the error.log for details and update your configuration accordingly.
Obsolete tags are found in the configuration file. Those should be updated or removed accordingly. Future versions of Icecast may not load with them present. See the error log for details.
Invalid tags are used in the config file. See the error.log for details and update your configuration accordingly.
Invalid tags (for example tags with invalid values) are found in the configuration file. Those must be corrected. Future versions of Icecast may not load with them present. See the error log for details.
The configuration did not validate. See the error.log for details and update your configuration accordingly.
The configuration file is not valid. It may contain logical errors such as invalid combinations of values. Those must be corrected. Future versions of Icecast may not load with them present. See the error log for details.
File permissions are wrong. See the error.log for details and update your configuration accordingly. Future versions of Icecast may reject affected files.
Some of the files used by Icecast (such as the configuration or logfiles) have wrong permissions. Please check the permissions and correct them accordingly. The error log will contain more information on which files are the problem.
Potentially unsafe file permissions. See the error.log for details and update your configuration accordingly. Future versions of Icecast may reject affected files.
Some of the files used by Icecast seem to have unsafe permissions. This may result in leakage of credentials, secret keys, or similar data. It is strongly recommended to check the files reported in the error log and change credentials and secret keys accordingly. Future versions of Icecast may reject those files, including rejecting to start at all or only starting in a limited fashion if unresolved.
chroot configured but failed.
chroot was configured but failed. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details.
chroot configured but not supported by operating system.
chroot was configured but is not supported by the operating system. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details.
Change of UID/GID configured but failed.
Changing of the user ID and/or group ID was configured but failed. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details.
Change of UID/GID configured but not supported by operating system.
Changing of the user ID and/or group ID was configured but is not supported by the operating system. This is a security problem and requires immediate handling. See the error log and your operation system's documentation for more details.
Sources list
Info
Legacy HTTP/1.0 listener
One or more legacy listeners has accessed the stream. The client should upgrade. No action is required on Icecast's side.
Listener without usable Host:-header
One or more listeners connected without sending a usable `Host:`-header. Icecast may not provide the best service to such clients as the value needs to be guessed. This is a problem more common with ancient clients. No action is required on Icecast's side.
No content language set
The source did not set a language for the stream. The source client's configuration should be checked and updated accordantly. No action is required on Icecast's side.
Warning
Legacy or unsupported streaming format is used.
The stream is sent in an legacy or an unsupported format. Icecast falls back to a generic handler which might or might not work. No formal support is provided for such streams.
It is best to only stream in fully supported formats. The format can be selected in most source clients.
No action is required on Icecast's side.
Character set is not UTF-8
The character set of the stream is not UTF-8. This can be a problem with legacy streams (ICY). This can result in metadata not being shown correctly.
It is recommended to consider setting the stream's character set to UTF-8. However, this can also upset legacy clients. Caution is advised.
The stream did not mature yet.
The stream is still very new. This message will resolve itself after a few seconds on a healthy stream. If the message seems to be persistent or is often reported over a span of several minutes there is a problem with the source client's connection or the data the source client sends.
If unresolved for several minutes, the source client's connection should be checked. If the source client's connection is fine, the source client seems to not work properly.
No action is required on Icecast's side.
Error
No data has yet been received.
This message is reported when no data has yet been received by Icecast from the source client. If this message persists for several seconds, the source client is most likely not working properly.
It is possible but highly unlikely, that this is caused by a bad network connection. If so, the connection is likely not suitable for a source client at all (independent on the source's settings such as bitrate).
No action is required on Icecast's side.
Legacy metadata on non-legacy source received. This is likely a bug in the source client.
A legacy metadata update request was sent on a non-legacy source. This is most likely a bug in the source client. It is also possible that other components try to update the metadata in a way unsuitable for the stream.
Icecast may reject such requests for security reasons. Metadata might not work correctly on such streams.
It is best to report this to the source client's vendor. No action is required on Icecast's side.