From 83a9b3ff0dd30fa092c059ed8496a7c81ade3dd0 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Roland=20H=C3=A4der?= Date: Wed, 25 Mar 2009 19:40:50 +0000 Subject: [PATCH] Updated documentation, typo fixed: - Updated the README file and described a little the node-modes. - Typo fixed when a new node-id got created - Database files in db/node_data are now ignored --- .gitignore | 1 + .../hub/main/nodes/class_BaseHubNode.php | 2 +- docs/README | 33 ++++++++++++++++++- 3 files changed, 34 insertions(+), 2 deletions(-) diff --git a/.gitignore b/.gitignore index 5e4afd2d1..4c440df27 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ /.cache /.project /.settings +db/node_data/*.serialized diff --git a/application/hub/main/nodes/class_BaseHubNode.php b/application/hub/main/nodes/class_BaseHubNode.php index 6ca6aacb4..c000f64d7 100644 --- a/application/hub/main/nodes/class_BaseHubNode.php +++ b/application/hub/main/nodes/class_BaseHubNode.php @@ -111,7 +111,7 @@ class BaseHubNode extends BaseFrameworkSystem implements Updateable { $wrapperInstance->registerNodeId($this, $requestInstance); // Output message - $this->getDebugInstance()->output('Creating new node-id: ' . $this->getNodeId() . ''); + $this->getDebugInstance()->output('Created new node-id: ' . $this->getNodeId() . ''); } } diff --git a/docs/README b/docs/README index 2f4c925e2..8639c614e 100644 --- a/docs/README +++ b/docs/README @@ -1,8 +1,9 @@ README ------ +-------------------------------------------------------------------------------- 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 @@ -13,3 +14,33 @@ 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 may +get an exception called 'ClassNotFoundException' which has to be rewritten to +test if the mode is valid and output a nicer message to the user. -- 2.39.5