aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/29.RPKI.CA.UI.GUI.Installing.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/manual/29.RPKI.CA.UI.GUI.Installing.md')
-rw-r--r--doc/manual/29.RPKI.CA.UI.GUI.Installing.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/doc/manual/29.RPKI.CA.UI.GUI.Installing.md b/doc/manual/29.RPKI.CA.UI.GUI.Installing.md
new file mode 100644
index 00000000..bb582b56
--- /dev/null
+++ b/doc/manual/29.RPKI.CA.UI.GUI.Installing.md
@@ -0,0 +1,41 @@
+# 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][1] for
+instructions.
+
+## Prerequisites
+
+This page assumes that you have already followed the steps to install the CA
+software (see [doc/RPKI/Installation][2])
+
+This page assumes that you have already created `/etc/rpki.conf` (see
+[doc/RPKI/CA/Configuration][3])
+
+## 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][4]
+
+[1]: 30.RPKI.CA.UI.GUI.Upgrading.md
+[2]: 01.RPKI.Installation.md
+[3]: 12.RPKI.CA.Configuration.md
+[4]: 32.RPKI.CA.UI.GUI.Configuring.md