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

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

Helper packages

sudo apt-get install wv xpdf-utils unrtf unzip

Install source

svn co
cd socialtext
./configure --hostname --server-admin \
  --support-address --force-ssl-login 1
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 --password wikidream \
  --first-name Dobrica --last-name Pavlinusic
sudo -u www-data st-admin add-workspace-admin --email

Configuring mailer

Install and configure postfix for mail delivery

apt-get install postfix
vi /etc/postfix/main

Important lines are following:

alias_maps = hash:/etc/aliases, hash:/etc/aliases.deliver
alias_database = hash:/etc/aliases, hash:/etc/aliases.deliver

They add /etc/aliases.deliver (which SocialText generates with names of wiki workspaces) to configuration.

Next, we need to create /etc/aliases.deliver.db which is binary version of database needed for postfix. It's a bit tricky (and looks awfully wrong), but here it goes:

chmod 1777 /etc
postalias /etc/aliases.deliver
chmod 644 /etc

Now restart postfix as root user

/etc/init.d/postfix restart

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} 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
tar cfvpz ~/css-rot13.tar.gz rot13/

 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" <>'