aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRPKI Documentation Robot <docbot@rpki.net>2013-01-31 22:00:15 +0000
committerRPKI Documentation Robot <docbot@rpki.net>2013-01-31 22:00:15 +0000
commit6f630dd97125cb984944ada9d978334e51f1dc9d (patch)
treebc4831b45d4e8f504ff6da20314179d1419fd53d /doc
parente5bee68cd0f3a6d065a3af471ffeae1c8cb63ea2 (diff)
Automatic pull of documentation from Wiki.
svn path=/trunk/; revision=4996
Diffstat (limited to 'doc')
-rw-r--r--doc/doc.RPKI.CA.UI.GUI30
-rw-r--r--doc/manual.pdfbin484924 -> 487115 bytes
2 files changed, 29 insertions, 1 deletions
diff --git a/doc/doc.RPKI.CA.UI.GUI b/doc/doc.RPKI.CA.UI.GUI
index 4b887e60..5fad466f 100644
--- a/doc/doc.RPKI.CA.UI.GUI
+++ b/doc/doc.RPKI.CA.UI.GUI
@@ -8,7 +8,7 @@ sets $PYTHONPATH and $DJANGO_SETTINGS_MODULE.
***** Prerequisites *****
-* Django
+* Django 1.3 or later
* Django South 0.7.6 or later
@@ -83,6 +83,34 @@ If you've only done the above bootstrap, there will only be a single handle to
manage, so the GUI will automatically bring you to the dashboard for that
handle.
+**** Running the web portal as a different user ****
+
+By default, the web portal is run in embedded mode in mod_wsgi, which means it
+runs inside the apache process. However, you can make the web portal run in
+daemon mode as a different user using mod_wsgi.
+
+ $ ./configure --enable-daemon-mode[=user[:group]]
+
+Where user is the optional user to run the web portal as, and group is the
+optional group to run the web portal as. If user is not specified, it will run
+in a separate process but the same user as apache is configured to run.
+
+Note that when run in daemon mode, a unix domain socket will be created in the
+same directory as the apache log files. If the user you have specified to run
+the web portal as does not have permission to read a file in that directory,
+the web interface will return a 500 Internal Server Error and you will see a
+permission denied error in your apache logs. The solution to this is to use the
+WSGISocketPrefix apache configuration directive to specify an alternative
+location, such as:
+
+ WSGISocketPrefix /var/run/wsgi
+
+Note that this directive must not be placed inside of the VirtualHost section.
+It must be located at the global scope.
+
+see http://code.google.com/p/modwsgi/wiki/
+ConfigurationDirectives#WSGISocketPrefix for more information.
+
****** Installation of Route Views Support for the GUI ******
If you want ROA creation to tell the user what routes are in the global routing
diff --git a/doc/manual.pdf b/doc/manual.pdf
index 8f6912cf..f9f1de13 100644
--- a/doc/manual.pdf
+++ b/doc/manual.pdf
Binary files differ