aboutsummaryrefslogtreecommitdiff
path: root/portal-gui/README.apache
blob: 2955061a3f398d56c334506519bc56a8ad4bd626 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
$Id$

This file details how to configure apache+mod_wsgi to serve the
portal-gui.

The web interface must be deployed to work with an existing web
server.  Instructions for using Django with Apache and mod_wsgi can be
found at
http://docs.djangoproject.com/en/1.2/howto/deployment/modwsgi/#howto-deployment-modwsgi

Setup
=====

- Follow the steps in detailed in the $top/portal-gui/README file to
  set up the portal-gui for the self-hosted resource handle that runs
  rpkid.

- After running "make" in $top/portal-gui, there will be a file named
  $top/portal-gui/apache/rpki.conf.  This is a configuration file for
  Apache which does most of the work configuring the portal-gui to
  run under mod_wsgi.

You may need to edit the paths for Django if they are installed in a
different location on your host.  Note that this is only necessary if
you wish to use the Django admin web console.  The portal-gui itself
will operate correctly even if this path is wrong.

NOTE: Apache loads the configuration files sorted alphabetically.
Thus, you need to ensure that your file is renamed as appropriate for
your environment.

  Fedora:
  $ cp $top/portal-gui/apache/rpki.conf /etc/httpd/conf.d/wsgi-rpki.conf
  $ service httpd restart