aboutsummaryrefslogtreecommitdiff
path: root/doc/29.RPKI.CA.UI.GUI.Installing.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/29.RPKI.CA.UI.GUI.Installing.md')
-rw-r--r--doc/29.RPKI.CA.UI.GUI.Installing.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/29.RPKI.CA.UI.GUI.Installing.md b/doc/29.RPKI.CA.UI.GUI.Installing.md
new file mode 100644
index 00000000..7e9855ec
--- /dev/null
+++ b/doc/29.RPKI.CA.UI.GUI.Installing.md
@@ -0,0 +1,36 @@
+# Installing the Web Portal for the First Time
+
+This page documents how to install the web portal software. **If you have
+previously installed the software**, see doc/RPKI/CA/UI/GUI/Upgrading for
+instructions.
+
+## Prerequisites
+
+This page assumes that you have already followed the steps to install the CA
+software (see doc/RPKI/Installation)
+
+This page assumes that you have already created `/etc/rpki.conf` (see
+doc/RPKI/CA/Configuration)
+
+## Create Database Tables
+
+This step creates the tables used by the web portal in the database. Run the
+following commands in the shell (you do not need to be _root_, just have
+permission to read `/etc/rpki.conf`):
+
+ rpki-manage syncdb --noinput
+ rpki-manage migrate
+
+Note that at the end of the `syncdb` output you will see the following
+message:
+
+ Not synced (use migrations):
+ - rpki.gui.app
+ (use ./manage.py migrate to migrate these)
+
+You should **ignore the message about running ./manage.py** since that script
+does not exist in our setup (we use `rpki-manage` instead`).
+
+## Next Step
+
+See doc/RPKI/CA/UI/GUI/Configuring