X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=docs%2FREADME;h=5a8950ed84fe9e524c5b1b19d7f58b264e3623e5;hb=5b7e1278fb05c1a86533d65fa24557a6f94dd216;hp=f196a1dac5777c1011884ad10acf0fc35ce365db;hpb=b32994822964093e672d92815c13b70418d46cfd;p=hub.git diff --git a/docs/README b/docs/README index f196a1dac..5a8950ed8 100644 --- a/docs/README +++ b/docs/README @@ -1,4 +1,47 @@ README ------ -This file needs some extending... ;) +-------------------------------------------------------------------------------- +1.) How to launch the hub: +-------------------------------------------------------------------------------- + +At the current stage of code base you need to launch the hub by entering the +following command at at command prompt (Win32) or console (Linux etc.) in the +root directory of this script: + +php index.php app=hub + +Another other (later added) parameters should be added after app=hub in the same +way due to the "design" of the inc/includes.php script. We need to change that +anyway. + +If you want to e.g. temporarily try out an other 'node mode' just add a parameter +'mode=???' to the above command by '???' can be one of the following: + +mode=regular - The default mode for joining the hub network as a regular node. + This mode doesn't have to be entered manually unless you + changed the configuration entry in application/hub/config.php + +mode=boot - Your node acts as a bootstrapping-node. This mode is completely + the same as the master-mode. If you can make sure that your node + is up at least 99%, every downtime of a bootstrapping-node + 'hurts' the network, and that you have the latest SVN changes + you might want to contact me with your static IP number and port + number of your node so I may add it to the hard-coded list of + boostrapping-nodes. + +mode=list - Your node participates as a list-node in the network which + 'aids' the master-nodes by maintaining an identical list of + nodes. + +mode=master - A master-node holds a list of known nodes and which types of + objects they are sharing. + +-------------------------------------------------------------------------------- +2.) Current development notices: +-------------------------------------------------------------------------------- + +These modes are currently not yet finished. If you try an invalid out you now +get a nice and muich smaller error message. We still need to add a 'help' +command-line parameter and many more. This should be done with a nice helper +class and not just 'hey, my code runs' code.