From: Brian Warner <warner@allmydata.com>
Date: Fri, 27 Apr 2007 03:16:48 +0000 (-0700)
Subject: add some simple create-client/start-client targets, document htem briefly
X-Git-Tag: allmydata-tahoe_v0.1.1-1-UNSTABLE~13
X-Git-Url: https://git.rkrishnan.org/architecture.txt?a=commitdiff_plain;h=1e8d4c9bfdcf03fb8aab2f39fbd4170989074424;p=tahoe-lafs%2Ftahoe-lafs.git

add some simple create-client/start-client targets, document htem briefly
---

diff --git a/GNUmakefile b/GNUmakefile
index 43cd0cfd..8553935f 100644
--- a/GNUmakefile
+++ b/GNUmakefile
@@ -66,18 +66,33 @@ clean-Crypto:
 	cd src/Crypto && python ./setup.py clean --all
 
 
-.PHONY: run-queen run-client test
+# RUNNING
+#
+# these targets let you create a client node in the current directory and
+# start/stop it.
 
-run-queen:
-	cd queen-basedir && PYTHONPATH=.. twistd -noy ../queen.tac
+.PHONY: create-client start-client stop-client run-client
+.PHONY: create-introducer start-introducer stop-introducer
 
-run-client: build
-	cd client-basedir && $(PP) twistd -noy ../client.tac
+create-client: build
+	$(PP) $(PYTHON) bin/allmydata-tahoe create-client -C CLIENTDIR
+start-client: build
+	$(PP) $(PYTHON) bin/allmydata-tahoe start -C CLIENTDIR
+stop-client: build
+	$(PP) $(PYTHON) bin/allmydata-tahoe stop -C CLIENTDIR
 
-run-client2:
-	cd client-basedir2 && PYTHONPATH=.. twistd -noy ../client.tac
-run-client3:
-	cd client-basedir3 && PYTHONPATH=.. twistd -noy ../client.tac
+create-introducer: build
+	$(PP) $(PYTHON) bin/allmydata-tahoe create-introducer -C INTRODUCERDIR
+start-introducer: build
+	$(PP) $(PYTHON) bin/allmydata-tahoe start -C INTRODUCERDIR
+stop-introducer: build
+	$(PP) $(PYTHON) bin/allmydata-tahoe stop -C INTRODUCERDIR
+
+
+
+# TESTING
+
+.PHONY: test
 
 ifeq ($(TEST),)
 TEST=allmydata zfec
diff --git a/README b/README
index 313e3063..8c828697 100644
--- a/README
+++ b/README
@@ -143,3 +143,12 @@ RUNNING:
  client node to run a webserver on the desired port, through which you can
  view, upload, download, and delete files.
 
+ A client node directory can also be created without installing the code
+ first. Just use 'make create-client', and a new directory named 'CLIENTDIR'
+ will be created inside the top of the source tree. Copy the relevant .furl
+ files in, set the webport, then start the node by using 'make start-client'.
+ To stop it again, use 'make stop-client'. Similar makefile targets exist for
+ making and running an introducer node.
+
+ There is a public mesh available for testing. Look at the wiki page
+ (http://allmydata.org) for the necessary .furl data.