| Many of these settings can be modified using the Config Editor. The Config Editor is easier to use and will modify this file. You may also directly modify this .ini file using a text editor (Microsoft Notepad or Wordpad are examples.) Do not make changes directly to this file unless you fully understand the changes. Otherwise, the server may need to be installed again and all information will be lost. It is best to use the Config Editor unless you fully understand the direct file edit. Once changes are made, you must restart the voice server for changes to take affect. Server - General configuration info. Intf - Accept connections only from specific IP interfaces. Each category is contained in [ brackets ] and each option is entered using key=value formatting. This document will use the settings included in the example INI file. [Server] Name=Server 1 This is the name of the server that appears at the top of the active user list when someone connects. (Required) Phonetic= This is the phonetic pronunciation of the server name. If left blank the servers Name will be used in all TTS events that involve the servers name being announced. Comment= This option has been removed. It is now controlled via the client by using the Server Properties window. Port=assigned and should not be changed This is the TCP/IP port number that the server will listen on waiting for clients to connect. If you start multiple instances of the server on the same computer then they must have different INI files with unique TCP port numbers assigned to them. Auth=0 This is the authentication mode. (Required) 0 = No authentication and anyone can connect. 1 = Global password authentication. 2 = Specific user/password authentication. Duplicates=1 Enables or disables duplicate login names. (Required) 0 = Disables duplicates. 1 = Allows duplicate login names. If disabled and someone logs in with a user name identical to that of a currently connected user, the server will disconnect the first user. This setting should only be used when Auth=2 for sanity reasons but it can be disabled for any Auth mode. Note: When this option is set to 0 it creates problems for clients that had auto-reconnect enabled, however, starting with version 2.0.0 this is no longer a problem. AdminPassword= This is the remote server administration password. Leaving this option blank will disable remote admin logins. This password is used by normal login accounts and they activate a menu option to have admin rights assigned to their login. (Optional) Password= This is the global login password for when Auth=1. All users connecting to this server must have this password, otherwise the server will send back an error message saying that they could not be authenticated. (Optional) MaxClients=Do not Change This option is not available on Public versions of the server. It is hard coded to a maximum of 8 simultaneous clients (also called slots). If you need more then 8 slots then you will need to rent a server from a licensed professional hosting company. This option specifies the maximum number of clients that can be connected to the server at the same time. Pro servers have a hard coded maximum limit of 400 clients, however, your servers network connection might not be able to handle a large number of simultaneous connections. (Required) SendBuffer=0 This option specifies the size of the TCP outbound buffers to each client. The value is in bytes. A value of 0 will force the program to use a default value of 131072 bytes. If you have a smaller value then I recommend setting it to 0 and let the program use its default. In the servers log file there will be a line starting with "MSG_CONN" when a new client connects. At the end of this line will be two pairs of numbers (A,B) (C,D). The A number is the buffer size as defined by your platform. The B number is the buffer size as reported by the system after the Ventrilo server has changed it. The number could be larger or smaller depending on the platform. RecvBuffer=0 This option specifies the size of the TCP inbound buffers for each client. The value is in bytes. A value of 0 will force the program to use it's default settings of 131072 bytes per client connection. In the servers log file there will be a line starting with "MSG_CONN" when a new client connects. At the end of this line will be two pairs of numbers (A,B) (C,D). The C number is the buffer size as defined by your platform. The D number is the buffer size as reported by the system after the Ventrilo server has changed it. The number could be larger or smaller depending on the platform. Diag=0 0 = Diagnostics off. 1 = Diagnostics on. This option has no use to end users and is for developer use only. LogonTimeout=5 This option specifies in seconds how long a client has to logon to the server before it is automatically disconnected. Once logged on the option has no meaning. CloseStd=1 0 = Don't close standard input, output and error handles. 1 = Close standard input, output and error handles. This option instructs the server to close or leave-intact the standard input, output and error file handles when starting in daemon mode. At the time of this writing the Ventrilo server is compiled on RedHat 7.2 systems but there seems to be an incompatibility with closing these standard file handles on RedHat80 systems thus causing the program to crash. Setting this option to 0 will force the program to leave the file handles open and prevent it from crashing on RH80 systems. The only downside to this will be if the program was started in daemon mode via an SSH terminal session. When you "exit" the terminal session it will hang waiting for all file handles in spawned processes to close, and you will be forced to manually kill the SSH terminal program. This doesn't seem to happen with normal xterm, gnome-terminal or telnet sessions. *shrug* Note: Starting with version 2.0.0 this doesn't seem to be an issue anymore due to changes made to the build process. However, the option remains available in case it is needed in the future. FilterWave=0 FilterTTS=0 These options have been removed. They are now controlled via the client by using the Server Properties window. TimeStamp=0 0 = Disable console timestamp's. 1 = Enable console timestamp's. This option enables or disables timestamp's being displayed in console messages. This includes remote consoles. PingRate=10 This option allows the administrator to change the interval at which the server pings the clients. The value is specified in seconds and defaults to 10. Setting to a lower value might be useful for diagnosing problem clients especially when the remote console command "pingtrace" is used. ExtraBuffer=0 This option allows the administrator to give each outbound client data stream additional buffer space but it's allocated and controlled by the server instead of relying on the TCP stack implementation. A value of 0 instructs the server to use it's default value of 128K bytes of extra buffer space. Any attempt to change the value will usually make any existing problems worse. It remains intact for historical purposes. ChanWidth=0 This option specifies a maximum number of parallel sub-channels that can be created in each channel. It has no effect on root level channels which only server admin's can create. A value of 0 means there is no limit. ChanDepth=0 This option specifies the maximum number of nested sub-channels (depth) that can be created. A value of 0 means the server will use it's default max value of 8 nested channels. ChanClients=0 This option specifies the maximum number of clients allowed in any channel. A value of 0 means there is no limit to the number of clients per channel. DisableMaxClients=1 This option has has been removed . DisableQuit=1 0=Allow remote consoles to issue the "quit" command. 1=Disable (prevent) remote console from issuing the "quit" command. This option prevents remote console commands (those typed into the chat window when logged in with server admin rights) from issuing the "quit" command which would instruct the server to exit the system. However, if the server was started in a non-daemon mode the local console can still issue the quit command. VoiceCodec=0 This option tells the server which codec all clients must use. The value is a 0 based index into a list of possible codec's. To see the list of currently supported codec types issue the command "ventrilo_srv -?" and the program will display a table of codec's and their associated formats. VoiceFormat=1 This option is the second part of VoiceCodec. Each codec can have one or more possible formats that control the quality and bandwidth usage of the specified codec. To see the list of currently supported codec formats issue the command "ventrilo_srv -?" and the program will display a table of codec's and their associated formats. SilentLobby=0 0 = Allow replication. 1 = Suppress replication, thus making the lobby silent. This option allows or suppresses replication of voice, wave binds and TTS binds when the client is in the main lobby. AutoKick=0 This option enables auto-kicking of a client after it has been connected for X number of seconds. A value of 0 disables the autokick feature, otherwise it specifies the number of seconds that a client is allowed to remain connected before the server will automatically disconnect them. This feature is primarily intended for professional hosting services who setup servers for potential customers to test the quality of the hosters network and machines, while at the same time prevent people from hijacking the server for their own private use. [Intf] Do Not Change |
MammothGames - Gaming for Everyone
