2 files changed, 54 insertions, 1 deletions
diff --git a/portal-gui/README b/portal-gui/README
index a06c3f58..e5a509ad 100644
--- a/portal-gui/README
+++ b/portal-gui/README
@@ -219,7 +219,7 @@ database with your data.
 Here are the steps for reseting to the initial state:
 
     cd $datarootdir/portal-gui/rpkigui
-    python reset --pythonpath=$top/rpkid myrpki
+    python manage.py reset --pythonpath=$top/rpkid myrpki
 
     >>> answer "yes" to really reset it <<<
 
diff --git a/portal-gui/README.rpkidemo b/portal-gui/README.rpkidemo
new file mode 100644
index 00000000..3ab90eea
--- /dev/null
+++ b/portal-gui/README.rpkidemo
@@ -0,0 +1,53 @@
+$Id$
+
+This file details how to use the rpkidemo script with the portal-gui.
+
+requirements
+============
+
+- the portal-gui must be run using apache with mod_wsgi
+
+Fedora:
+	$ yum install httpd mod_wsgi
+
+setup
+=====
+
+- follow the steps in detailed in the README file to set up the portal-gui
+  for the self-hosted resource handle that will act as parent to all other
+  users.
+
+- after running "make" in $top/portal-gui, there will be a file named
+  $top/portal-gui/apache/zmyrpki.conf.  This is a configuration file for
+  apache which does most of the work configuring the portal-gui to run
+  under mod_wsgi.
+
+Fedora:
+	cp $top/portal-gui/apache/zmyrpki.conf /etc/httpd/conf.d/
+
+- edit `zmyrpki.conf' and change the URL to match your own environemnt.  by
+  default it uses http://localhost/myrpki/, which is probably not what you
+  want.
+
+- run the `adduser' script to configure the portal-gui with a new account.  you
+  need to specify the user's parent on the command line, as this acts as an
+  implicit authorization when rpkidemo uploads its identity.xml.
+
+testing with yamltest
+=====================
+
+- you can specify
+	CONFDIR=$top/rpkid/tests/yamltest.dir
+  to make the portal-gui be a front-end for the resource handles created by
+  a yamltest run.
+
+- you will need to periodically run the lists_resources script in
+	$top/rpkid/tests/yamltest.dir/RIR
+  to update the portal-gui database with the current state of children and
+  received resources
+
+- the web server runs as the `apache' user by default under Fedora, which won't
+  have permissions to write to the yamltest.dir directory.  easiet thing to do
+  is chown the entire tree so that the `apache' user has full access:
+
+	# chown -R apache $top/rpkid/tests/yamltest.dir