Add missing /

[dak.git] / setup / README

diff --git a/setup/README b/setup/README
index ccc26cf732c28aca3517f3ef3ace3afb93e548e5..37d0be4460f18f5a4075100d6b6a472fcff0d3a8 100644 (file)
--- a/setup/README
+++ b/setup/README
@@ -16,27 +16,55 @@ The following roles are assumed to exist:
 For the purposes of this document, we'll be working in /srv/dak
 
 Set up the dak user on both the system and in postgres:
-sudo adduser dak
-sudo addgroup ftpmaster
-sudo addgroup dak ftpmaster
-sudo -u postgres createuser -s dak
+# sudo adduser dak
+# sudo addgroup ftpmaster
+# sudo addgroup dak ftpmaster
+# sudo -u postgres createuser -s dak
 
 Set up the dak directory:
-sudo mkdir /srv/dak
-sudo chown dak:ftpmaster /srv/dak
-sudo chmod 2775 /srv/dak
+# sudo mkdir /srv/dak
+# sudo chown dak:ftpmaster /srv/dak
+# sudo chmod 2775 /srv/dak
 
 Become the dak user:
-sudo -u dak -s -H
+# sudo -u dak -s -H
 
 Create the additional roles:
-createuser -S -R -D ftpmaster
-createuser -S -R -D ftpteam
-createuser -S -R -D ftptrainee
+# createuser -S -R -D ftpmaster
+# createuser -S -R -D ftpteam
+# createuser -S -R -D ftptrainee
 
 Create an empty database with SQL_ASCII encoding:
-createdb -T template0 -E SQL_ASCII -O dak projectb
+# createdb -T template0 -E SQL_ASCII -O dak projectb
 
 Import the schema:
-psql -f current_schema.sql -d projectb
+# psql -f current_schema.sql -d projectb
+
+Set up some core data in projectb to get started (read the init_vars file if
+you wish to customise various aspects):
+# ./init_core
+
+Create a minimal dak.conf
+# ./init_minimal_conf
+# cp dak-minimal.conf /etc/dak/dak.conf
+
+Set up a symlink somewhere
+# mkdir ~dak/bin
+# ln -s /path/to/dak.py ~dak/bin/dak
+
+Set up a private signing key
+# gpg --no-default-keyring --secret-keyring /srv/dak/keyrings/s3kr1t/dot-gnupg/secring.gpg --keyring /srv/dak/keyrings/s3kr1t/dot-gnupg/pubring.gpg --gen-key
+Remember the signing key id for when creating the suite below.
+Here we'll pretend it is DDDDDDDD for convenience
+
+Import some developer keys (here AAAAAAAA)
+# gpg --no-default-keyring --keyring /srv/dak/keyrings/upload-keyring.gpg --recv-key AAAAAAAA
+
+Add some architectures you care about:
+# dak admin architecture add i386 "Intel x86 port"
+# dak admin architecture add amd64 "AMD64 port"
+
+Add a suite (origin=, label= and codename= are optional)
+signingkey= will ensure that Release files are signed
+# dak admin suite add-all-arches unstable x.y.z origin=MyDistro label=Master codename=sid signingkey=DDDDDDDD