Kete.net.nz: Documentation

Topic: openSUSE Installing Required Software

Topic Type: Topic

Describes the steps necessary for installing Kete's required software on an openSUSE 11.0 host.

Originally written by Kieran Pilkington, Kete Developer for Katipo Communications, Ltd.

An appendix to the Installation Guide

---

Install Required Software for Running Kete

We'll jump right into what we can grab from openSUSE packages. Open a new console and run the following commands

$ su
root@host: # yast2 -i gcc gcc-c++ make automake git ruby ruby-devel rubygems mysql mysql-client libmysqlclient15 ruby-mysql zlib gzip unzip memcached ImageMagick ruby-RMagick ruby-RMagick-doc libxml2 libxml2-devel libxslt libxslt-devel

(optional - enables conversion of uploaded HTML, Plain Text, PDF, and Microsoft Word documents to the description of the document)

$ su
root@host: # yast2 -i wv wv-devel poppler-tools libpoppler3 poppler-data lynx

Installing Rails

Now to install both rails (framework) and mongrel (server) that Kete will run on. You may encounter something like "could not find blah..." when running the following commands. Rubyforge and the gem mirrors can be flaky, just try again and it will usually come right.

$ sudo gem update --system
$ sudo gem update
$ sudo gem install rails mongrel mongrel_cluster -y

Additional Setup Instructions

MySQL

If this is the first time MySQL is being used on the system, run the following commands (change [your_new_password] to a password of your choosing) :

$ sudo /etc/init.d/mysql start
$ mysqladmin -u root password [your_new_password]

Kete also supports unicode characters, so we'll want to adjust mysql to make unicode the default for new databases. Make utf8 he default by editing /etc/my.cnf (as root) and adding this in the [mysqld] section:

# making utf8 the default
init-connect = 'SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_general_ci

Save the file, and restart mysql with

$ sudo /etc/init.d/mysql restart

Memcached

You also need to turn on memcached to run at startup. To do that, open a new console and run

$ su
root@host: # chkconfig -a memcached
root@host: # chkconfig memcached on
root@host: # memcached -du root

YAZ and Zebra

Kete relies on specific versions of YAZ and Zebra, so the older versions must be compiled from source.

$ sudo mkdir /usr/local/src
$ sudo chmod 777 /usr/local/src
$ cd /usr/local/src
$ wget http://ftp.indexdata.dk/pub/yaz/yaz-2.1.54.tar.gz
$ tar xfz yaz-2.1.54.tar.gz
$ wget http://ftp.indexdata.dk/pub/zebra/idzebra-2.0.6.tar.gz
$ tar xfz idzebra-2.0.6.tar.gz
$ cd yaz-2.1.54
$ ./configure --prefix=/usr
$ make
$ sudo make install
$ cd ../idzebra-2.0.6
$ ./configure --prefix=/usr --with-yaz=../yaz-2.1.54 --enable-mod-alvis
$ make
$ sudo make install

Now add the install directory to the systems path (incase it isn't already there):

$ PATH=/usr/bin/:/usr/local/bin/:$PATH
$ export $PATH

Nginx

(complete this step if you plan on using Kete in production mode. For development or testing, this is not required)

Grab the latest tarball from http://sysoev.ru/nginx/download.html and do the following (adjust version numbers accordingly).

$ cd /usr/local/src
$ wget http://sysoev.ru/nginx/nginx-0.6.32.tar.gz
$ tar xfz nginx-0.6.32.tar.gz
$ cd nginx-0.6.32/
$ ./configure --prefix=/usr/local/nginx --sbin-path=/usr/local/sbin --with-http_ssl_module
$ make
$ sudo make install

Lastly grab a /etc/init.d/nginx script for managing the daemon by doing this:

$ sudo wget http://notrocketsurgery.com/files/nginx -O /etc/init.d/nginx
$ sudo chmod 750 /etc/init.d/nginx

You'll probably want to get nginx to start up automatically at boot. To do that, open a new console and run

$ su
root@host: # chkconfig -a nginx
root@host: # chkconfig nginx on

Important Note: At this point, Nginx is installed but not yet configured for our Kete site. We'll handle that in a separate step once we have Kete installed. Until then, web requests will throw an error until you have actually deployed your Kete application and started a mongrel cluster to match your settings in /usr/local/nginx/conf/nginx.conf

You may want to add /usr/local/sbin to your PATH by running:

$ PATH=/usr/local/sbin/:$PATH
$ export $PATH