doc: initial install notes

1 files changed, 101 insertions, 0 deletions

diff --git a/docs/install_notes.txt b/docs/install_notes.txt
new file mode 100644
index 0000000..0b531de
--- /dev/null
+++ b/docs/install_notes.txt
@@ -0,0 +1,101 @@
+List of runtime dependencies: apache2 libconfig-simple-perl libcrypt-blowfish-perl libcrypt-cbc-perl libdigest-hmac-perl libdigest-sha1-perl libemail-valid-loose-perl libgetopt-tabular-perl libjson-perl libmath-gmp-perl libmime-base32-perl libmoose-perl libmoosex-singleton-perl libmoosex-strictconstructor-perl moreutils ssl-cert libapache2-mod-auth-pam libapache2-mod-auth-sys-group git libsearch-xapian-perl libcgi-session-perl libcgi-formbuilder-perl
+List of source dependencies: dpkg-dev debhelper devscripts fakeroot texlive-extra-utils libxml-simple-perl wdg-html-validator perlmagick po4a libfile-chdir-perl libtext-markdown-discount-perl cdbs zlib1g-dev libssl-dev libcurl4-openssl-dev
+
+# wheezy is best-tested at this point
+
+# ikiwiki
+cd ~
+git clone git://git.ikiwiki.info
+cd git.ikiwiki.info
+sed '/<\/pre>/,/<pre>/ d' < doc/todo/headless_git_branches.mdwn | patch -p1
+dpkg-buildpackage -tc -uc -us
+debi
+
+# if dpkg-buildpackage fails, you can also
+#   apt-get install ikiwiki
+#   cd /usr/share/perl5
+#   sed '/<\/pre>/,/<pre>/ d' < ~/git.ikiwiki.info/doc/todo/headless_git_branches.mdwn | patch -p1
+
+echo ikiwiki hold | dpkg --set-selections
+
+# piny
+cd ~
+git clone git://piny.be/piny-code
+cd piny-code
+./builddebs
+dpkg -i libpiny-perl*.deb pinyadmin*.deb pinyconfigs*.deb pinyweb*.deb
+
+a2enmod ssl
+a2enmod auth_pam
+a2enmod auth_sys_group
+
+url="some.url"
+
+ikiwikiurl="http://$url/"
+ikiwikidestdir="/srv/http/$url/"
+ikiwikisrcdir="/srv/ikiwiki"
+ikiwikisecurepath="/srv/https/secure.$url/"
+ikiwikisecureurl="https://secure.$url/"
+adminemail="some.jerk@$url"
+
+(
+echo    "[piny]"
+echo -e "\tikiwikiurl = $ikiwikiurl"
+echo -e "\tikiwikidestdir = $ikiwikidestdir"
+echo -e "\tikiwikisrcdir = $ikiwikisrcdir"
+echo -e "\tikiwikisecurepath = $ikiwikisecurepath"
+echo -e "\tikiwikisecureurl = $ikiwikisecureurl"
+echo -e "\tadminemail = $adminemail"
+) > /etc/piny-override.conf
+
+mkdir -p "$ikiwikidestdir" "$ikiwikisrcdir" "$ikiwikisecurepath"/write "$ikiwikisecurepath"/read /etc/ikiwiki/piny /srv/rbin
+
+# If you want to offer optional SSL:
+# ln -s /srv/http/"$url" /srv/https/"$url"
+
+cat /etc/ssl/certs/ssl-cert-snakeoil.pem /etc/ssl/private/ssl-cert-snakeoil.key > /etc/ssl/private/secure."$url".pem
+
+perl -pe s/piny.be/"$url"/g\;s/SSLCertificateChainFile.+//g < /etc/apache2/sites-available/piny > /etc/apache2/sites-available/piny-"$url"
+
+perl -pe 's/^(    Listen 443)$/    NameVirtualHost *:443\n\1/' < /etc/apache2/ports.conf | sponge /etc/apache2/ports.conf
+
+a2dissite piny
+a2ensite piny-"$url"
+
+# cgit
+# available prebuilt for amd64 and i386: http://debian.stbuehler.de/debian/pool/main/binary/
+# normally sort of a pain to build due to the git developers failing to maintain a stable interface
+perl -pe s/piny.be/"$url"/g < /etc/cgitrc | sponge /etc/cgitrc
+
+# pinyshell
+perl -pe 's|USERGROUPS=yes|USERGROUPS=no|' < /etc/adduser.conf | sponge /etc/adduser.conf 
+for i in $(awk -F: '$4 >= 1000 && $4 < 65534 {print $1}' < /etc/passwd); do adduser $i users; done
+# or find some other way to fix the /etc/sudoers.d/piny situation; it would be nice if sudo supported gid ranges
+
+ln -sv /usr/bin/addaccess \
+/usr/bin/appendkeys \
+/usr/bin/lsaccess \
+/usr/bin/lsrepo \
+/usr/bin/pinyconfig \
+/usr/bin/pinyhelp \
+/usr/bin/readkeys \
+/usr/bin/rebuildrepo \
+/usr/bin/rmaccess \
+/usr/bin/rmrepo \
+/usr/bin/writekeys \
+/usr/bin/git \
+/usr/bin/git-receive-pack \
+/usr/bin/git-upload-archive \
+/usr/bin/git-upload-pack \
+/usr/bin/git-shell \
+/usr/bin/passwd \
+/srv/rbin
+
+ln -sv /usr/bin/newrepo /srv/rbin # enables creation of new repositories from piny shell accounts
+ln -sv /usr/bin/newuser /srv/rbin # enables creation of new piny shell accounts from piny shell accounts
+
+# git-daemon
+apt-get install git-daemon-run
+perl -pe 's|GIT_DAEMON_ENABLE=false|GIT_DAEMON_ENABLE=true|;s|GIT_DAEMON_DIRECTORY=/var/cache/git|GIT_DAEMON_DIRECTORY=/srv/git|;' < /etc/default/git-daemon | sponge /etc/default/git-daemon
+echo 'GIT_DAEMON_BASE_PATH=/srv/git' >> /etc/default/git-daemon
+/etc/init.d/git-daemon restart