Customer Support
International Downloads Documentation Real.com RealNetworks.com
Summary of RealServer 5.0 Configuration File Settings

Arranged Alphabetically

Settings are alphabetized in this section. For detailed information on each section, look up the corresponding category name in the RealServer Administration Guide (see Chapter 4). A categorical listing is also available.

Setting & Syntax
Description
Category in RealServer Administration Guide
AdCfgList [{<path1>, <adinsert type>}, {<path2>, <adinsert type>}, ...] Specifies the location(s) of content media files for which ad insertion is enabled and type of ad insertion for those files. Ad Insertion Settings
AdDefaultCfg <value>Optional. Global default advertising insert method for the RealServer. Ad Insertion Settings
AdEnabled <Boolean>Initializes the RealServer for advertising play. If Ad Insertion is enabled, a plug-in must be defined (see AdPlugin). Ad Insertion Settings
AdLogPath <path/filename.log> The relative path and name of the log file in which RealServer chronicles advertising presentation activity (pnad.log or pnad). Ad Insertion Settings
AdPlugin <filename>Specifies which plug-in is used to drive advertising insertion. Ad Insertion Settings
AuthAllowDuplicateIDs <number> Establishes whether multiple users all using the same user ID and password can retrieve secured content. Authentication Settings
AuthDBName <data source name or location> Name of mSQL or ODBC database, or path to supplied text file data source. Authentication Settings
AuthDBPassword <password>Password RealServer uses to connect to the (optional) commercial database. Authentication Settings
AuthDBPlugin <name>Name of included text file, database, or user-defined data storage. Default is rn-ppv-basic. Authentication Settings
AuthDBUserID <name>Name RealServer uses to connect to the (optional) commercial database. Authentication Settings
AuthMode <number>Can be 0 (Player-based Authentication), 1 (User-based Authentication). Default is 0 (Player-based Authentication). Authentication Settings
AuthPath <path>The path to the secure content directory. Authentication Settings
AuthRegPrefix <word>User-defined keyword that is sent to CGI. Default is "register". Authentication Settings
BandwidthEncoding <value>The default bandwidth for archive files of live broadcasts. Live Broadcasting
BasePath <path>The path to the root directory of your media files. Ownership Information
BindToAllInterfaces <true or false> (This setting is new to version 5.01) This setting binds RealServer to all available IP addresses. 5.01 readme file only
ClientConnections <integer>The maximum number of simultaneous client connections to RealServer. Bandwidth
ConnectControlList [{<address>, <net mask>},...] Addresses from which clients are allowed to access RealServer. IP-Based Access Control
CustomerName <licensename>Your customer name, as received from RealNetworks. Must be correct for the server to operate. Ownership Information
EncoderControlList [ {user1, user1password}, {user2, user2password}, ...] List of users and passwords. Allows multiple people to encode and use the same file name for different files. Live Broadcasting
EncoderPassword <password>Password used by RealAudio Encoder, RealVideo Encoder, and the rvslta utility program to connect to RealServer. Live Broadcasting
EncoderTimeout <seconds>The time in seconds that the Server will wait before disconnecting a RealAudio Encoder or RealVideo Encoder that is not sending data. Live Broadcasting
ErrorLogPath <path>The path and file name of the error log file. Logging
Group <usernames>Default group ID (GID) for server. (UNIX only) Ownership Information
HTTPPort <port number>If no Web server is running on the machine that is running RealServer, the default is to perform HTTP transmission on port 80. The RealServer can also be configured to perform HTTP transmission on other ports. Firewall Settings
HTTPPort <port>Enables players that may be behind firewalls to access content served from your server. Ownership Information
InputFile <filename>The path of a file to convert to a live file. Live Broadcasting
IOBufferSize <size>Determines the amount of memory the RealServer allocates for each sequential read of a RealFlash (.swf) content file. Ownership Information
IPBindingList [{<IPAddress1>}, {<IPAddress2>}, {<IPAddress3>},...] For security or convenience in running a Web server and RealServer on the same machine, you can configure the server to transmit on an alternate IP address. Firewall Settings
LicenseKey <encryptedkey>Encrypted license string from RealNetworks. Must be correct for the server to operate. Ownership Information
LiveFileBandwidthNegotiation <value> Specifies that the rafile program use bandwidth-negotiation style of naming for archive files of live broadcasts. Live Broadcasting
LiveFilePassword <password>Password used for archiving live broadcasts. Live Broadcasting
LiveFileSize <value>Size of file, in megabytes, used for creating archive files of live broadcasts. Live Broadcasting
LiveFileTarget <name>File or directory to use to create the archive files of live broadcasts. Live Broadcasting
LiveFileTime <value>Maximum length, in time, of a archive file of a live broadcast. Live Broadcasting
LocalHost <domain name>Fully-qualified name that overrides the system default name. Ownership Information
LoggingStyle <value>Type and amount of information to capture. Logging
LogPath <path>The path and file name of the access log file, which logs information about client access to RealServer. Logging
MailMessageLevel <level>Minimum severity level for e-mail messages sent by RealServer Notification Settings
MailMessageLimit <number>Maximum number of e-mail messages to sends about a particular event. Notification Settings
MailMessageSMTPHost <address> The mail server that RealServer uses to send e-mail messages. Notification Settings
MailMessageUser <address>E-mail address of the primary contact for RealServer e-mail messages. Notification Settings
MailUsageCC <address>E-mail address of the secondary contact for RealServer e-mail messages Notification Settings
MailUsagePeriod <hours>Specifies the time period over which MailUsageThreshold is calculated. Notification Settings
MailUsageThreshold <percent>Specifies the server usage level that causes RealServer to send a usage e-mail message. Notification Settings
MaxBandwidth <number>The maximum bandwidth that RealServer can use on particular network connection. Bandwidth
MaxThreads <count>Limits the number of threads used by the server. Ownership Information
MinPlayerProtocol <number>The minimum PN protocol that a Player must have to connect to the server. Ownership Information
MobilePlaybackOversendRate <number> The multiple of the streaming rate that is used to determine the effective bit rate at which the server transfers files to Mobile Playback enabled RealPlayers via TCP. Ownership Information
MonitorConnections <count>Maximum number of Java Performance Monitor sessions that can connect to RealServer. Monitor Settings
MonitorPassword <password>Password that Java Performance Monitor must use to connect to RealServer. Monitor Settings
MulticastAddressRange <address>-<address> The range of multicast addresses (host group addresses) to which RealServer can send a live multicast stream. Multicasting Settings
MulticastControlList [{<address>, <net mask>}, ...] The range of client or network addresses (typically on an intranet) which RealServer allows to receive multicast delivery. Multicasting Settings
MulticastDeliveryOnly <value> Restricts the client addresses specified in MulticastControlList to multicast reception only-client addresses so restricted cannot connect to RealServer in unicast mode. Multicasting Settings
MulticastPort <value>The port number for multicast broadcasts. Multicasting Settings
MulticastTTL <value>The Time To Live (TTL) for multicast packets. Multicasting Settings
OutputFile <filename>Name of the simulated live stream sent using the rvslta utility. Live Broadcasting
PidPath <path/filename>The file that records the server's process ID. (UNIX only) Ownership Information
PnaPort <number>The TCP/IP port on which the server listens for connection requests from clients. Ownership Information
Realm <word>Keyword used to encrypt users' passwords in the authentication database when configured for User-based authentication. Default is your customer name. Authentication Settings
ResolverPort <port>The TCP port to use for resolving DNS addresses. Ownership Information
RestoreOriginalPrivilegeOnReload <value> Allows user logged on with name specified by User setting to issue the SIGHUP command to load changed configuration file settings, even if the server has already been started by someone with Root permissions. Ownership Information
ServerHost <host>Name of a RealServer to receive the live file. Live Broadcasting
ServerPassword <password>Password that rvslta must use to connect to RealServer. Live Broadcasting
ServerPort <port>Number of port on the RealServer to receive the live file from rvslta. Live Broadcasting
SplitterAnnouncePort <port#>Defines the server port that a splitter will contact to request the splitting of its live streams. Networked Settings
SplitterBufferDelay <seconds> Amount of data the Splitter will buffer before releasing the stream to players. Networked Settings
SplitterControlList [{<address>, <net mask>}, ...] Splitter domain names that are allowed to access RealServer. IP-Based Access Control
SplitterControlList [{<address>, <net mask>},...] Defines the valid servers that can connect and obtain split streams from this server. Any servers that contact on the SplitterAnnouncePort and are not in this list are ignored. Networked Settings
SplitterMaxResendPPS <pps>Maximum packets per second that a splitter source will output in response to a negative acknowledgement from a splitter. Networked Settings
SplitterResendBuffer <seconds> Depth of the buffer used for UDP resends in the Splitter protocol. Increase if you are getting consistent loss on all players from a split stream. Networked Settings
SplitterSourceList [{host, port}]The Live Servers that this splitter should contact and split all live streams from. Networked Settings
SplitterSourceProbeInterval <seconds> How often the splitter requests details about live streams from a source server. This may need to be adjusted if Timeout values are changed. Networked Settings
SplitterSourceTimeout <seconds> Time before source Server stops sending data to a splitter when the splitter is not responding. Networked Settings
SplitterTimeout <seconds>The number of seconds for the splitter to wait after a stream has been stopped or interrupted. Alter only to shut down streams more quickly or streams are stopping when they shouldn't. Networked Settings
StatsMask <value>Specifies additional access log statistics to request from Players. Logging
Timeout <seconds>The number of seconds the server waits before disconnecting an inactive Player. Ownership Information
URL <url>URL that points to the live media stream to be recorded by rafile. Live Broadcasting
User <UserName>The default user ID (UID) for the server. (UNIX only) Ownership Information
UserDir <string>Path to be appended to the path defined for the account entries defined in the UserList setting. Networked Settings
UserList [ {<user>, <path>, <min>, <max>}, ...] List of accounts that are allocated media streams for private use. Networked Settings

Arranged by Category
Information on this page is arranged according to where it is described in the RealServer Administration Guide. An alphabetical listing of settingsis also available.

Category in RealServer Administration Guide
Setting & Syntax
Description
Ownership Information BasePath <path>The path to the root directory of your media files.
CustomerName <licensename> Your customer name, as received from RealNetworks. Must be correct for the server to operate.
Group <usernames>Default group ID (GID) for server. (UNIX only)
LicenseKey <encryptedkey> Encrypted license string from RealNetworks. Must be correct for the server to operate.
LocalHost <domain name> Fully-qualified name that overrides the system default name.
MaxThreads <count>Limits the number of threads used by the server.
MinPlayerProtocol <number> The minimum PN protocol that a Player must have to connect to the server.
PnaPort <number>The TCP/IP port on which the server listens for connection requests from clients.
PidPath <path/filename> The file that records the server's process ID. (UNIX only)
Timeout <seconds>The number of seconds the server waits before disconnecting an inactive Player.
User <UserName>The default user ID (UID) for the server. (UNIX only)
RestoreOriginalPrivilegeOnReload <value> Allows user logged on with name specified by User setting to issue the SIGHUP command to load changed configuration file settings, even if the server has already been started by someone with Root permissions.
HTTPPort <port>Enables players that may be behind firewalls to access content served from your server.
ResolverPort <port>The TCP port to use for resolving DNS addresses.
IOBufferSize <size>Determines the amount of memory the RealServer allocates for each sequential read of a RealFlash (.swf) content file.
MobilePlaybackOversendRate <number> The multiple of the streaming rate that is used to determine the effective bit rate at which the server transfers files to Mobile Playback enabled RealPlayers via TCP.
Firewall Settings HTTPPort <port number>If no Web server is running on the machine that is running RealServer, the default is to perform HTTP transmission on port 80. The RealServer can also be configured to perform HTTP transmission on other ports.
IPBindingList [{<IPAddress1>}, {<IPAddress2>}, {<IPAddress3>},...] For security or convenience in running a Web server and RealServer on the same machine, you can configure the server to transmit on an alternate IP address.
Logging ErrorLogPath <path>The path and file name of the error log file.
LogPath <path>The path and file name of the access log file, which logs information about client access to RealServer.
LoggingStyle <value> Type and amount of information to capture.
StatsMask <value>Specifies additional access log statistics to request from Players.
Notification Settings MailMessageLevel <level>Minimum severity level for e-mail messages sent by RealServer
MailMessageLimit <number> Maximum number of e-mail messages to sends about a particular event.
MailMessageSMTPHost <address> The mail server that RealServer uses to send e-mail messages.
MailMessageUser <address> E-mail address of the primary contact for RealServer e-mail messages.
MailUsageCC <address> E-mail address of the secondary contact for RealServer e-mail messages
MailUsagePeriod <hours> Specifies the time period over which MailUsageThreshold is calculated.
MailUsageThreshold <percent> Specifies the server usage level that causes RealServer to send a usage e-mail message.
Bandwidth ClientConnections <integer>The maximum number of simultaneous client connections to RealServer.
MaxBandwidth <number> The maximum bandwidth that RealServer can use on particular network connection.
IP-Based Access Control ConnectControlList [{<address>, <net mask>},...] Addresses from which clients are allowed to access RealServer.
SplitterControlList [{<address>, <net mask>}, ...] Splitter domain names that are allowed to access RealServer.
Monitor Settings MonitorConnections <count>Maximum number of Java Performance Monitor sessions that can connect to RealServer.
MonitorPassword <password> Password that Java Performance Monitor must use to connect to RealServer.
Networked Settings SplitterSourceList [{host, port}]The Live Servers that this splitter should contact and split all live streams from.
SplitterAnnouncePort <port#> Defines the server port that a splitter will contact to request the splitting of its live streams.
SplitterControlList [{<address>, <net mask>},...] Defines the valid servers that can connect and obtain split streams from this server. Any servers that contact on the SplitterAnnouncePort and are not in this list are ignored.
SplitterBufferDelay <seconds> Amount of data the Splitter will buffer before releasing the stream to players.
SplitterTimeout <seconds> The number of seconds for the splitter to wait after a stream has been stopped or interrupted. Alter only to shut down streams more quickly or streams are stopping when they shouldn't.
SplitterSourceProbeInterval <seconds> How often the splitter requests details about live streams from a source server. This may need to be adjusted if Timeout values are changed.
SplitterResendBuffer <seconds> Depth of the buffer used for UDP resends in the Splitter protocol. Increase if you are getting consistent loss on all players from a split stream.
SplitterSourceTimeout <seconds> Time before source Server stops sending data to a splitter when the splitter is not responding.
SplitterMaxResendPPS <pps> Maximum packets per second that a splitter source will output in response to a negative acknowledgement from a splitter.
UserDir <string>Path to be appended to the path defined for the account entries defined in the UserList setting.
UserList [ {<user>, <path>, <min>, <max>}, ...] List of accounts that are allocated media streams for private use.
Ad Insertion Settings AdEnabled <Boolean>Initializes the RealServer for advertising play. If Ad Insertion is enabled, a plug-in must be defined (see AdPlugin).
AdPlugin <filename>Specifies which plug-in is used to drive advertising insertion.
AdDefaultCfg <value> Optional. Global default advertising insert method for the RealServer.
AdCfgList [{<path1>, <adinsert type>}, {<path2>, <adinsert type>}, ...] Specifies the location(s) of content media files for which ad insertion is enabled and type of ad insertion for those files.
AdLogPath <path/filename.log> The relative path and name of the log file in which RealServer chronicles advertising presentation activity (pnad.log or pnad).
Authentication Settings AuthMode <number>Can be 0 (Player-based Authentication), 1 (User-based Authentication). Default is 0 (Player-based Authentication).
AuthPath <path>The path to the secure content directory.
AuthRegPrefix <word> User-defined keyword that is sent to CGI. Default is "register".
AuthDBPlugin <name>Name of included text file, database, or user-defined data storage. Default is rn-ppv-basic.
AuthDBName <data source name or location> Name of mSQL or ODBC database, or path to supplied text file data source.
AuthDBUserID <name>Name RealServer uses to connect to the (optional) commercial database.
AuthDBPassword <password> Password RealServer uses to connect to the (optional) commercial database.
AuthAllowDuplicateIDs <number> Establishes whether multiple users all using the same user ID and password can retrieve secured content.
Realm <word>Keyword used to encrypt users' passwords in the authentication database when configured for User-based authentication. Default is your customer name.
Live Broadcasting EncoderPassword <password>Password used by RealAudio Encoder, RealVideo Encoder, and the rvslta utility program to connect to RealServer.
EncoderControlList [ {user1, user1password}, {user2, user2password}, ...] List of users and passwords. Allows multiple people to encode and use the same file name for different files.
EncoderTimeout <seconds> The time in seconds that the Server will wait before disconnecting a RealAudio Encoder or RealVideo Encoder that is not sending data.
LiveFilePassword <password> Password used for archiving live broadcasts.
LiveFileSize <value> Size of file, in megabytes, used for creating archive files of live broadcasts.
LiveFileTarget <name> File or directory to use to create the archive files of live broadcasts.
LiveFileTime <value> Maximum length, in time, of a archive file of a live broadcast.
URL <url>URL that points to the live media stream to be recorded by rafile.
BandwidthEncoding <value> The default bandwidth for archive files of live broadcasts.
LiveFileBandwidthNegotiation <value> Specifies that the rafile program use bandwidth-negotiation style of naming for archive files of live broadcasts.
InputFile <filename> The path of a file to convert to a live file.
OutputFile <filename> Name of the simulated live stream sent using the rvslta utility.
ServerHost <host>Name of a RealServer to receive the live file.
ServerPassword <password> Password that rvslta must use to connect to RealServer.
ServerPort <port>Number of port on the RealServer to receive the live file from rvslta.
Multicasting Settings MulticastAddressRange <address>-<address> The range of multicast addresses (host group addresses) to which RealServer can send a live multicast stream.
MulticastControlList [{<address>, <net mask>}, ...] The range of client or network addresses (typically on an intranet) which RealServer allows to receive multicast delivery.
MulticastDeliveryOnly <value> Restricts the client addresses specified in MulticastControlList to multicast reception only-client addresses so restricted cannot connect to RealServer in unicast mode.
MulticastPort <value> The port number for multicast broadcasts.
MulticastTTL <value> The Time To Live (TTL) for multicast packets.
5.01 readme file onlyBindToAllInterfaces <true or false> (This setting is new to version 5.01) This setting binds RealServer to all available IP addresses.