Topic: Prepare the Kete Application

Topic type: Topic

Outlines the steps to prepare a kete application itself to run in the context of the installation guide.

Originally written by Walter McGinnis, Kete Project Lead for Katipo Communications, Ltd.

Part of the Installation Guide


Important Note: This step assumes that you are logged in as the user who will be running your Kete. For demos and development this is likely your normal account, for production this is the "kete" account if you have followed the conventions laid forth in the last step.

Prepare Kete

We have some more set up to do before the first time we run Kete. Most of the Kete specific gem installs are done in a command but there are a two other commands to run.

$ sudo su
# cd /home/kete/apps/your_app
# rake manage_gems:required:install
# gem install rmagick

There is an additional required step for Mac OS X Leopard (10.5.1). On 10.5 you probably noticed that the Zoom gem failed to installed above. We reinstall it by hand like so:

# env ARCHFLAGS="-arch i386" gem install zoom

Warning for users of Kete 1.2: Kete 1.2 is not compatible with the latest Nokogiri gem and causes issues with search results. You can fix this by downgrading to Nokogiri version 1.3.3, which is known to work. The following commands will help to do that.

# gem install nokogiri --version=1.3.3
# gem uninstall nokogiri (all versions except 1.3.3)

If you want metadata extracted from uploads, you will also need to run the following:

# sudo gem install mini_exiftool

You now need to load the default data into your new Kete before it is ready to run. You need to do this for each database you will be using. If you are just doing this for a demo or development, simply using the default Rails environment of "development" is sufficient. Do this:

$ rake kete:tools:set_locales
$ rake db:bootstrap
...

However, if you are setting up a production site, do this instead:

$ RAILS_ENV=production rake db:bootstrap
...

If you get an error like "No such file or directory - /tmp/mysql.sock", try replacing "localhost" with 127.0.0.1 in your config/database.yml file.



Next step:
Apache2 and Passenger

Discuss This Topic

There are 31 comments in this discussion.

Read and join this discussion

join this discussion