how to set up a co2 satellite
the co2 implementation in python is developed and tested under linux. the code should run without problems on any other *nix like system for which the required python version is available. for the sorry rest, it should run with some minor modifications (i definitely don't care...).
you'll need a 'real' IP address (i.e. one that is accessible from the internet) for the machine you want to run the satellite on (or appropriate forwarding on the firewall in case the machine is in a LAN).
# python >= version 2.3. no additional libraries are needed.
# bzip2: to unpack the co2 archive. if you don't have it, install your linux distribution's package or get it from here.
download the archive from the download page to some place in your filesystem
unpack it with
that's it, the software runs out of anywhere, no files must be installed in system directories.
open config.py in the toplevel co2 directory with your favourite editor. this configuration file is a python module. don't be afraid if you don't know a thing about python, it's easier to read and edit than many a config file that comes with it's own proprietary format. and, it is heavily commented. read and follow the information provided there. basically, all you have to change is the server address and the co2 home directory. for the other variables, the supplied default values should be OK.
while testing, it is recommended that you set
cd to your co2 home directory and type
subsequently, there will be regular apache style entries like:
those are ping requests by the relay, that is looking if you're still there, and more co2 stuff like:
that's a message from satellite
some remarks on network setup
in order to connect your co2 satellite to a co2 network whose relay is somewhere on the internet, your host must have a 'real' IP address. a 'private' address such as
in the unlikely case of two or more satellites behind one firewall, they will have to use different ports.
Last modified: Thu Oct 16 20:33:02 CEST 2003 - elektro/lu