old.kete.net.nz :Documentation

Topic: Installation

Topic type:
Topic

An introduction and table of contents for how to install Kete.

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

Introduction

This guide will walk you through how to install the Kete software, a knowledge basket of topics, images, audio, video, web links, documents, and discussion.

Kete, like most Ruby on Rails applications, has many installation options. Installing Kete, therefore, can be simple or complex, depending on your needs and situation. We have chosen to outline a simple installation path that is most useful for setting up a Kete demo site or a development environment (but could also be used for a full blown site), as well as a "best practice" for deploying a production ready Kete with an eye toward making it easy to roll out future site upgrades.

To keep things concise, we assume that supporting software, such as the MySQL database, will be installed on the same host as the Kete software itself. In other words you'll be installing everything one computer (or virtual computer, as the case may be). Kete is quite capable of having it's different supporting pieces of software on other hosts though. For the timebeing, we'll also assume you are using MySQL. If you install via another database like PostgreSQL, please post your details in the comments.

You might find reading these background topics useful before you proceed:

Important Note: This guide doesn't cover creating backups. You should probably look at Backup Procedures for Kete.

Simple Installation:

Step	Described for:
Preinstall Assumptions:	All platforms
Installing Required Software	Debian Squeeze \| Mac OS X \| Debian Lenny \| openSUSE^{needs updating} \| Solaris 10^{needs updating} \| Debian Etch^Depreciated
Setting up Environment	All platforms
Acquiring Kete code	All platforms
Setting up Databases	All platforms
Configure the Backgroundrb Plugin	All platforms
Prepare the Kete Application	All platforms
Setting up HTTP Requests server	All platforms
Configuring your Kete site	All platforms

Optional Best Practices - Managing your Kete application's codebase and deploying it to a production host:

Katipo has found these additional steps provide a more complete set of tools for managing a Kete application's life cycle and a better fit for sites in production. Most notably, upgrading your Kete application's codebase as new features, security fixes, and refinements are added to the Kete software project becomes much easier.

Appendices:

Here are additional notes that you might also find useful, as well as some supporting links.

Deprecated

Some older articles. May no longer be relevant.

Walter McGinnis

was the last to edit Installation

on Aug 4th, 2011 at 9:41 AM

Walter McGinnis

created Installation

on Jan 5th, 2008 at 3:20 AM

Flag as:

Discuss This Topic

There are 2 comments in this discussion.

Read and join this discussion

petert

said CentOS install

Walter,

Thank you. You guessed right we did do this part with a direct connection and decided to carry on rather than spend too much time on the problem. We have got kete installed but just have to iron out a few (small, we hope) things.

When we're happy with our installation, i am hoping to send you copy of our installation instructions.

regards

Peter