CallSite Server Installation
 
 

Section: II.E

Server Configuration: server.cfg file

Introduction: The file 'server.cfg' is an ASCII file consisting of a list of 'variable=value' pairs that can be edited to affect the operation of the CallSite server. It should always be noted that if you make any changes in this file, you will have to restart the CallSite server so that the changes that you have made will come into effect.

Location of the server.cfg file: The server.cfg file is located in the directory '/callsite/server/'.

Example: A typical server.cfg file is shown below:

 

[.default]
Filters=darn, fuck, putain, connard, salope
AppletPath=/callsite/call/applet/
ServerPath=/callsite/
SMTPServer=localhost
AllowGuests=false
AllowPagers=true
LimitMessagesSpeed=false
HistoryTimeStamped=true
Modules=com.netdive.server.module.callsite.CallSiteModule,com.netdive.server.module.
multivoice.MultiVoiceModule

VoiceConferenceHost=IP address of your machine
VoiceConferenceUDPPort=8888
VoiceConferenceTCPPort=80

UpdateType=FILE
UpdateType#=URL
UpdateType##=NONE
UpdateCompleteURL=http://www.netdive.com/callsite/agent_app/install.htm UpdateURL=http://www.netdive.com/callsite/CLIENT_UPDATE/WeMessage.zip
UpdateFileName=WeMessage.zip

HelpURL=http://www.netdive.com/callsite/help/agent/
SearchFriendURL=http://www.netdive.com/index-search.htm

PlugIns=plugins.cobrowsing.CoBrowsing,plugins.games.tictactoe.TicTacToe,plugins.games.
chess.ChessGame,plugins.games.ReflexGame

MessengerDirectory=com.netdive.server.module.callsite.UserFileConfigDirectory MessengerDirectory#=com.netdive.server.module.callsite.UserSQLConfigDirectory

 

You are able to change the following values for custom tailoring your CallSite server:

1. Filters:

Filters=<string>

The words or phrases that you want to filter so that your CallSite users will not be able to use them. You can place as many words as you want separated by commas.

2. Applet Path:

AppletPath=<string>

The exact CallSite applet path (directory where the applets files are located). This parameter must be an absolute reference to the web server root directory (starts with "/"). The default value is : /callsite/call/applet/

3. Server Path:

ServerPath=<string>

The exact CallSite server path (directory where CallSite is located). This parameter must be an absolute reference to the web server root directory (starts with "/"). The default value is : /callsite/

4. Location of the SMTP Server:

SMTPServer=<host>

Host of your SMTP email server. Your CallSite agents can, by using the "Tell A Friend" button, send emails to their friends telling them what a marvellous product CallSite is!

5. Allow Guests:

AllowGuests=<true/false>

This checks whether or not to allow people other than the CallSite registered users to be connected to your CallSite.

5. Allow Pagers:

AllowPagers=<true/false>

This checks whether or not to allow people to page to your agents. This value should always be set to true so that your customers can page your CallSite agents.

6. Limit unwanted messages:

LimitMessagesSpeed=<true/false>

This is an optional feature.The 'LimitMessagesSpeed' variable controls the flooding of unwanted messages. This value should always be set to "false" because, for example, in CallSite White Board, if a user sends a lot of messages, he/she gets blocked and in eventually disconnected from the CallSite server. In order to prevent such a situation, this value is always set to false.

7. Time stamped history:

HistoryTimeStamped=<true/false>

This checks whether or not the message history logs have the time when the messages were sent. This value should be set to true so that later on when you view the message logs, you will be able to view the time when those messages were sent.

8. Modules:

Modules=<string>

This is the server extension mechanism. It is set to:

com.netdive.server.module.callsite.CallSiteModule,com.netdive.server.module.
multivoice.MultiVoiceModule

and this should not be changed, or else CallSite will be disconnected from the server.

9. Voice Conference Host:

VoiceConferenceHost=<IP address of your server>

This is the host of the voice conference server.

10. Voice Conference UDP Port:

VoiceConferenceUDPPort=<port number >

This is the UDP port number of the Voice conference server. The default value is 8888. In case you are behind a firewall, this will not work as most of the firewalls disable UDP communication.

11. Voice Conference TCP Port:

VoiceConferenceTCPPort=<port number >

This is the TCP port number of the Voice conference server. The default value is 80. Now, if you are behind a firewall, you will have your web server listening at the port 80. So, if your server has two IP addresses attached to it, you can set the port 80 of one IP address to listen to your web server and the port 80 of the other IP address can listen to the voice conference server.


12. Updating the version of CallSite:

This is an automatic upgrade mechanism. This feature is useful when the server has a different or newer version of CallSite than the Client. Then you can set the update to take place in any one of the following three ways in the server.cfg file of the CallSite server:

(1) UpdateType=FILE
The update is made with a file.
UpdateURL=http://www.netdive.com/callsite/CLIENT_UPDATE/WeMessage.zip
This downloads the class file only.
UpdateFileName=WeMessage.zip
This is the filename of the bytecodes file in the client side that will be saved. It can have a different name from the filename mentioned in the UpdateURL.

(2) UpdateType=URL
This redirects the client to a new URL.
UpdateCompleteURL=http://www.netdive.com/callsite/agent_app/install.htm
This is the URL of the Installer alongwith the Java Virtual Machine.

(3) UpdateType=NONE
This means that there is no update to offer to the clients.

13. Help documents location:

The "Help" button in CallSite, located in the top tool bar of the agent application and also in the "New Users" window can be made to point to the help documents in your server by adding the following parameter in the server.cfg file of the CallSite server:

HelpURL= URL of the help pages that you want the button to point to.

For example:
HelpURL=http://www.netdive.com/callsite/help/agent/

14. Search a Friend location:

CallSite agents can search for another CallSite agent in your system in three different ways:(1) in the "Search A Friend" button in the "New User" window, (2) by clicking the "Add a Friend" button in the agent application and then clicking on "Search for a user..." and (3) also in the main drop down menu of the agent application, they can search for another agent. This page can be made to point to the Search engine in your server by adding the following parameter in the server.cfg file of the CallSite server:

SearchFriendURL=URL of the HTML page where the "Search Friend" tool is located.

For example:
SearchFriendURL=http://www.netdive.com/index-search.htm

15. Plug-ins:

PlugIns=<string>

Here you can mention the number of PlugIns that are available with your CallSite. You can place as many plug-in names as you want separated by commas.

16. Users Directory:

You can manage your users in the SQL database. For that the MessengerDirectory parameter is set to the following:

MessengerDirectory=com.netdive.server.module.callsite.UserSQLConfigDirectory

In case you want to manage your agents in a flat text file, then you need to set the MessengerDirectory parameter to be as follows:

MessengerDirectory=com.netdive.server.module.callsite.UserFileConfigDirectory