The simplest way to get things running is to cd into the src directory and enter the command: python wwInit.py This will create the file tstore.ini (more on this later) and subdirectories wwModules, wwGlobalDB and wwLocalDB. After all these are created wwInit.py will invoke TwistedPeer.py. To restart the system you need only issue the command : python TwistedPeer.py

The file tstore.ini (the default name) holds information about what IP address to use for multicasting (if it is to be used instead of broadcasting) or what ports to use in other cases.

The subdirectory wwModule is used to hold all user provided modules that must be loaded by the system. In a release 0.20 the system will automatically load them on startup and whenever a new module is added by the AddModule call.

The subdirectory wwLocalDB holds the database associated with data stored on this peer. All data read to and from the database is through the LocateObject, StoreObject and RetrieveObject calls.

The subdirectory wwGlobalDB holds all the global configuration information for the system. This database holds information about modules available to the system, categories and tenants, etc. Any change made to this database by any peer in the system is automatically broadcast to all of them.

After you have the system running (you can check your messages log file to see what is happening), you will need to do some simple configurations. You will need to add some categories before you can store and retrieve objects. If you haven't read the Concepts document, now is the time.

To assist you in using the system a number of command line functions have been provided. In the subdirectory cli you will find the following :

1. Control - Control the system
1. Shutdown - shutdown a peer.
2. AddCategory - add a category to the system.
3. ListCategory - list categories.
2. ServicePeer - Issue a service call
1. StoreObject - Store an object in the system.
3. StoragePeer - Talk to the storage peer (for testing only).
1. ftpstore - Test out the ftp transfer between peers.
3. locate - Locate an object in the peer.
4. store - Store an object in the peer.

If you issue the command with a -? you will be given the options of the command.