The dopewars metaserver

Every dopewars server is different, due to their differing locations and configurations. Thus some centralised system for listing the currently available servers and displaying some sort of comment about the games running on them is necessary, to enable client players to pick the game that most suits them. This is the function of the dopewars metaserver.

The metaserver is really just a collection of CGI scripts. It lives on the same webserver as the main dopewars webpage, and dopewars servers that wish to make themselves public (the default behaviour) inform it of their existence via. the CGI script at /~ben/cgi-bin/server.pl. This script can also be communicated with "manually", by filling out the form here. dopewars clients also use the metaserver to obtain the list of available servers, to facilitate connection to a dopewars server.

Players who want to use the metaserver to list the currently available servers should go to this link, or just follow the "Servers" link from the main dopewars web page. It cannot be guaranteed that all the listed servers are functional - they may, for example, have been registered in error, or a server may have crashed since being added to the list - but the list is checked daily for service, and so there is at least a good chance that the servers listed there will be working.

People running servers who do not want their details listed by the metaserver should disable the metaserver comunication of the server with the MetaServer.Active=0 configuration file setting, or the -S command line option. Servers which do register their details can have their accompanying comment set with the MetaServer.Comment configuration file setting.

The metaserver, being a collection of CGI scripts, should work happily on most machines which have web access. A problem occurs, however, if your connection to the Web is via. an enforced proxy server (i.e. traffic on port 80 from your machine is blocked by firewall). dopewars can be configured to connect via. a proxy server without too much difficulty; if your proxy server is at proxy.com on port 8080 then you should add the following lines to your dopewars configuration file:-
MetaServer.Name=proxy.com
MetaServer.Port=8080
MetaServer.Path=http://bellatrix.pcl.ox.ac.uk/~ben/cgi-bin/server.pl

Finally, once connected to the metaserver, you may find that it incorrectly displays the domain name of your server machine. It may display the name of the proxy server if you are connecting through one, or it may be that the metaserver cannot resolve your IP address to a domain name.

In this case, you will need to override the hostname that the metaserver guesses for your machine with one you choose yourself. This is done by specifying the hostname with the MetaServer.LocalName variable in your dopewars configuration file. In order to prevent abuse of this facility, you must obtain a password from the metaserver maintainer to authenticate your chosen hostname. Email the maintainer, giving the exact hostname you want to use (be aware that this is case-sensitive) and you will be given a password. Specify this password with the MetaServer.Password variable in the dopewars configuration file.

For example, if you wish your server to be known as dope-serv.com and you have emailed the maintainer, receiving the password Dope-Auth, then add the following to the dopewars configuration file:-
MetaServer.LocalName=dope-serv.com
MetaServer.Password=Dope-Auth

Restart your dopewars server for the change to take effect. Bear in mind that if you make up a non-existent or invalid domain name, the metaserver will accept it, but the server will be removed from the metaserver's list when it is checked daily for service.


Last update: 14-01-2000