Dobrica Pavlinušić's random unstructured stuff
SocialText Open Wiki Install: Revision 14

Here are some quick notes about installation on clean Debian etch machine

Install source

svn co https://socialtext.svn.sourceforge.net/svnroot/socialtext
cd socialtext
./configure --hostname saturn.ffzg.hr --server-admin admin@saturn.ffzg.hr \
  --support-address support@saturn.ffzg.hr --force-ssl-login 1
make
make install
update-rc.d -f apache-perl remove
update-rc.d st-apache defaults
update-rc.d ceqlotron defaults
/etc/init.d/st-apache start
/etc/init.d/ceqlotron start

Add new admin user

sudo -u www-data st-admin create-user --email dpavlin@rot13.org --password wikidream \
  --first-name Dobrica --last-name Pavlinusic
sudo -u www-data st-admin add-workspace-admin --email dpavlin@rot13.org

Configuring mailer

Execute commands as root to install masqmail and configure mail routing

apt-get install masqmail
echo mjesec.ffzg.hr > /etc/masqmail/mjesec.route
echo mjesec > /var/run/masqmail-route
vi /etc/masqmail/masqmail.conf

Add following to end of file:

online_routes.mjesec=/etc/masqmail/mjesec.route
local_hosts=localhost;saturn;saturn.ffzg.hr
listen_addresses=localhost:25;saturn.ffzg.hr:25
alias_file=/etc/aliases.deliver

Then again as root

/etc/init.d/masqmail restart

You may want to add all addresses from /etc/alaiases to /etc/aliases.deliver (like root, postmaster and so on...)

Customize template

Remove "Did you know?" box from dashboard

sudo vi /usr/share/nlw/template/view/homepage

Fix RSS feed errors

If you are using {getchrss http://blog.rot13.org/index.xml} and having problems with RSS feeds, try to re-installing two perl modules:

sudo cpan XML::RSS XML::Atom

New skin (CSS design) creation

cd /usr/share/nlw/css/
cp -r st rot13
st-admin set-workspace-config --workspace rot13 skin_name rot13
vi rot13/screen.css

Be sure to backup your changes, because next make install will overwrite your changes!

Change e-mail address of workspace

This configuration change will feed responses to e-mails generated by wiki back into wiki. You might not want to do that! :-)

st-admin set-workspace-config --workspace rot13 email_notification_from_address '"random unstructured stuff" <rot13@wiki.rot13.org>'