Server Configuration - pchatd.conf

Home >>> Server Configuration >>> pchatd.conf


Chat Server configuration (pchatd.conf)

The main ParaChat Server configuration file is called 'pchatd.conf'. This file is located in the "config" directory (...\ParaChat\ParaChat550\config\pchatd.conf) of your ParaChat Server. This file contains configuration information for the entire chat server, and is where server-wide and server-related parameters are set. The file contains hundreds of individual lines, but only specific lines may ever need edited. Below is a listing of important configuration parameters, and their function.

The 'pchatd.conf' file is a simple text file which can be edited using a text editor. Please note that any change to the 'pchatd.conf' file must be saved, and the ParaChat Server must be restarted for the change to take effect. Since this action may cause a brief interruption in chat service for your users, your ParaChat Server includes a method to make changes to the server configuration file without requiring a chat server reboot. Details on making and implementing changes to the server configuration file without requiring a chat server restart are found in the Dynamic Settings section of the Documentation.

Feature
Configuration
Parameter
Defaults / Values / Examples
Admin Server Port pchatd.adminport Default:
0

By default this is set to 0 which means it is turned off.

Password for the Admin Server Port

This password is for connecting to the admin server port and not for the Super Admin user.

pchatd.adminpasswd Default:
<randomly set during install>
Port where the ParaChat server should listen for chat connections. pchatd.port Default:
7777
HTTP Port

This specifies where HTTP connections to the ParaChat Server will operate. This port is used for firewall tunneling and save-to-server actions. The default value for this parameter is 100 above the chat port number.

httpd.port Default:
7877
Enable profanity filter pchatd.profanityfilter Allowed Values:
true or false (default is false)
Standard topic for room pchatd.DefaultTopic Example:

pchatd.DefaultTopic=Welcome to my chat room

Maximum idle time (in seconds) before user is disconnected. (Can be set on a per-user level.) pchatd.max_idle_time Default:
10*60=600 (i.e 10 minutes)

Example:
pchatd.max_idle_time=1000

Maximum number of users per room. (Can be set on a per-room basis.) pchatd.maxperchan Example:
pchatd.maxperchan=100
(default=100)
Action taken if URL of entering Web page does not match the creator URL in the room configuration file. (Can be set on a per-room basis.) pchatd.enforce_url Allowed Values:

pchatd.enforce_url=warn
Issues warning message but allows entry to room.

pchatd.enforce_url=allow
Allows any URL without warning.

pchatd.enforce_url=deny
Denies entry to room if URL does not match creator URL.

Number of lines in the Message of the Day (message received when a user logs in to a room) pchatd.motdlines Example:
pchatd.motdlines=2
Message line in Message of the Day pchatd.motdN where N is 1.<message of the day> Example:
pchatd.motd1=Welcome to the Just Talk chat server

pchatd.motd2=Please email support@justtalk.com for help.

Hostname on which the ParaChat server is running pchatd.host Example:
pchatd.host=chat.mycompany.com
Turns on spam detection pchatd.spam_detection Default:

pchatd.spam_detection=true

Allowed Values:
pchatd.spam_detection=true
pchatd.spam_detection=false

Load limit when a user is sent a spam detection warning message. (If user is trying to flood the room with messages, the system checks the load imposed by the user and sends a warning.) pchatd.spamload_warn Default:

pchatd.spamload_warn=2500
(The moving average time between 2 successive commands in the last 10 commands from the user is 2.5 seconds.)

Load limit when a user is disconnected from the chat server. pchatd.spamload_disconnect Default:
pchatd.spamload_disconnect=500
(The moving average time between 2 successive commands in the last 10 commands from the user is 0.5 seconds.)
This value defines the max number of characters a user can type in one message. pchatd.spammaxlength Default:
pchatd.spammaxlength=4096

Comma-separated list of IP addresses or prefixes to allow client connections from. (Can be overridden in room file.) pchatd.allowed_ip Example:
pchatd.allowed_ip=201.234.345, 233.234.555.2,192.168.1.1
The IP suppression mode for the users of the chat room. (Room administrator can always see the entire IP address.) pchatd.ip_suppression Allowed Values:
pchatd.ip_suppression=classc
shows the classc, not the full IP address

pchatd.ip_suppression=suppress
suppresses the entire IP address

pchatd.ip_suppression=show
shows the entire IP address

Enable HTTP tunneling (firewall support)
pchatd.allowTunneling
Allowed Values:
true or false
(default=false)
Enable cross-room private chat messages
pchatd.allow_remote_privmsg
Allowed Values:
true or false
(default=true)
Enable server roaming
pchatd.AllowRoaming
Allowed Values:
true or false
(default=true)
Enable private chat is allowed
pchatd.allowprivate
Allowed Values:
true or false
(default=true)
Similar to creator-URLs, but these contain just the domain
pchatd.CreatorDomains
Example:
mydomain.com,something.net
banned URL list
pchatd.DisallowedUrl
Example:
http://www.mydomain.com
Max length of a message that a user can send.
pchatd.MessageMaxLength
Allowed Values:
Integer (recommend a value between 500 and 4000)
Allowed characters (letters and digits)
pchatd.RoomAuth.AllowedChars
Allowed Values:
By default, any character is legal. If this param is enabled, only the characters in this string, (letters and digits) will be legal.
Allowed characters in a user name besides letters and digits.
pchatd.UserAuth.AllowedChars
Allowed Values:
By default, any character is legal. If this param is enabled, only the characters in this string, (besides letters and digits) will be legal.

pchatd.UserAuth.CaseSensitive
Default:
false
Allowed Values:
true or false
Consult ParaChat support due to Windows and Unix/Linux issues.
(default=false)
Max length of a user name
pchatd.UserAuth.NameMaxLength
Allowed Values:
integer
Allowed characters in a group name
pchatd.GroupAuth.AllowedChars
Allowed Values:
By default, any character is legal. If this param is enabled, only the characters in this string, (letters and digits) will be legal.
Enable private room in a roaming environment
pchatd.roam.RoomPrivate
Allowed Values:
true or false
Enable the ability to write the chat room stats to a file
pchatd.usage.Schedule
Allowed Values:
true or false
Refresh Rate
pchatd.usage.RefreshRate
Default:
3
Allowed Values:
integer
File path of log file of the total number of users at present
pchatd.usage.file.TotalUsers

File path of log file of all active users
pchatd.usage.file.AllUsers

File path of log file of all active rooms
pchatd.usage.file.AllRooms

File path of log file of all public rooms
pchatd.usage.file.PublicRooms

Enable the ability to log private/hidden rooms
pchatd.usage.ShowAllRooms
Allowed Values:
true or false
(default=false)
The time a user profile is cached (web HTTP user auth)
pchatd.UserAuth.Web.CacheMinutes
Allowed Values:
inetger in minutes
(default=60)
The time a user profile is cached (user profiles on local file system)
pchatd.UserAuth.LocalCacheMinutes
Allowed Values:
inetger in minutes
(default=60)
a room name can only contain chars defined by this config
pchatd.RoomAuth.HardDefinedCharSet
Allowed Values:
text
(example: abcdefg123)
a user name can only contain chars defined by this config
pchatd.UserAuth.HardDefinedCharSet
Allowed Values:
text
(example: abcdefg123)

Examples

Example of a Standard Server Setting

Your pchatd.conf file contains hundreds of lines of code. To make any changes to your standard settings, scroll down to the "#pchatd parameters" area. All you need to do is change the current line with your customized setting. Make sure you only change settings listed above. Making additional changes are not recommended and could disable your chat server.

#pchatd parameters
#Fri Jul 05 15:53:17 PDT 2002
pchatd.maxsessions=1000
pchatd.userclasses.auth.lynx.simple=paralogic.io.SimpleFileDirector(true,false,profile)
pchatd.userclasses.auth=paralogic.chat.auth.LynxAuthenticator
pchatd.logfile.dir=slogs
pchatd.reservedPrefix=
pchatd.adminpasswd=conan
pchatd.allowTunneling=true
pchatd.allow_remote_privmsg=false
pchatd.special.replace=>
pchatd.userclasses.auth.lynx.fileDirector=simple
pchatd.paralynx.enable=true
pchatd.logformat=extended
pchatd.messages.en.class=paralogic.chat.PChatMessages_en
pchatd.spamload_disconnect=500
pchatd.logfile.contstring=...
pchatd.port=7777
pchatd.motdlines=2
more ...........

©1996 - 2006   M Square, Inc. |  Privacy Policy