<?xml version="1.0" encoding="UTF-8"?>
<OAI-PMH xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.openarchives.org/OAI/2.0/">
  <responseDate>2010-03-11T20:59:59Z</responseDate>
  <request identifier="oai:kete.net.nz:documentation:Topic:114" verb="GetRecord" metadataPrefix="oai_dc">http://kete.net.nz/documentation/topics/show/114-installation</request>
  <GetRecord>
    <record>
      <header>
        <identifier>oai:kete.net.nz:documentation:Topic:114</identifier>
        <datestamp>2009-10-05T23:14:02Z</datestamp>
      </header>
      <metadata>
        <oai_dc:dc xmlns:dcterms="http://purl.org/dc/terms/" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/">
          <dc:identifier>http://kete.net.nz/documentation/topics/show/114-installation</dc:identifier>
          <dc:title>Installation</dc:title>
          <dc:publisher>kete.net.nz</dc:publisher>
          <dc:description><![CDATA[An introduction and table of contents for how to install Kete.]]></dc:description>
          <dc:description><![CDATA[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&nbsp;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.&nbsp; 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:

So you want a Kete of your own?
Things to consider when planning a Kete installation
Technical Requirements

Important Note: This guide doesn't cover creating backups. You should probably look at Backup Procedures for Kete.
Simple Installation:



Step&nbsp;
Described for: 


Preinstall Assumptions:
All platforms


Installing Required Software
Debian Etch | Debian Lenny | openSUSE | Mac OS X | Solaris 10


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.

Establish a Development Environment
Add Your Kete Application's Code to Version Control
Deploy to Your Production Host with Capistrano

Appendices:
Here are additional notes that you might also find useful, as well as some supporting links.

Add Your Kete Application to /etc/hosts
Don't Forget Log Rotation (and Statistics)
Additional Development Niceties (Emacs and Aquamacs mainly)
Managing Zebra
Bulk Delete Records from both Search Index and Kete Application
Delete Orphaned Search Records from Zebra
Troubleshooting
Upgrading to Kete 1.2 Release Branch
Upgrading Ruby Enterprise Edition
Improving private file download (send_file) performance
Using Content Licenses in Kete 1.1

Deprecated
Some older articles. May no longer be relevant.

Start Your Mongrel Cluster at Boot
Example Nginx Configuration File for Simple Installation
Example Nginx Configuration File for use with Capistrano
Upgrading Kete to 1.0 Stable Release Branch
Upgrading to Kete 1.1 Release Branch
Set Up Your Production Host for Your Kete Application
]]></dc:description>
          <dc:date>2008-01-04T14:20:31Z</dc:date>
          <dc:creator>Walter McGinnis</dc:creator>
          <dc:creator>walter</dc:creator>
          <dc:contributor>Walter McGinnis</dc:contributor>
          <dc:contributor>walter</dc:contributor>
          <dc:contributor>Steven Upritchard</dc:contributor>
          <dc:contributor>Steven</dc:contributor>
          <dc:contributor>k776</dc:contributor>
          <dc:contributor>James Stradling</dc:contributor>
          <dc:contributor>jstradling</dc:contributor>
          <dc:contributor>Kieran P</dc:contributor>
          <dc:contributor>kieran</dc:contributor>
          <dc:description/>
          <dc:subject><![CDATA[CentOS install]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/comments/show/42</dc:relation>
          <dc:subject><![CDATA[Re: CentOS install]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/comments/show/43</dc:relation>
          <dc:subject><![CDATA[Securing your Memcached daemon]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/web_links/show/88</dc:relation>
          <dc:subject><![CDATA[Configure Nginx to use SSL]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/167</dc:relation>
          <dc:subject><![CDATA[Limiting Passengers/mod_rails memory usage]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/239</dc:relation>
          <dc:subject><![CDATA[Upgrading to Kete 1.2 Release]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/258</dc:relation>
          <dc:subject><![CDATA[Preinstall Assumptions]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/115</dc:relation>
          <dc:subject><![CDATA[Debian Etch Installing Required Software]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/116</dc:relation>
          <dc:subject><![CDATA[Mac OS X Installing Required Software]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/117</dc:relation>
          <dc:subject><![CDATA[Setting Up Environment on Host for Kete]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/118</dc:relation>
          <dc:subject><![CDATA[Acquire Kete Code]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/119</dc:relation>
          <dc:subject><![CDATA[Create Databases Needed by Kete]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/120</dc:relation>
          <dc:subject><![CDATA[Prepare the Kete Application]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/121</dc:relation>
          <dc:subject><![CDATA[Configure and Start Mongrel Cluster for a Simple Installation]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/122</dc:relation>
          <dc:subject><![CDATA[Configure Nginx Web Proxy]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/123</dc:relation>
          <dc:subject><![CDATA[Configure Your Kete Site]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/124</dc:relation>
          <dc:subject><![CDATA[Establish a Development Environment]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/127</dc:relation>
          <dc:subject><![CDATA[Add Your Kete Application's Code to Version Control]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/128</dc:relation>
          <dc:subject><![CDATA[Set Up Your Production Host for Your Kete Application]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/129</dc:relation>
          <dc:subject><![CDATA[Deploy to Your Production Host with Capistrano]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/130</dc:relation>
          <dc:subject><![CDATA[Start Mongrel Cluster at Boot]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/126</dc:relation>
          <dc:subject><![CDATA[Add Your Kete Application to /etc/hosts or via ghost gem]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/125</dc:relation>
          <dc:subject><![CDATA[Configure the Backgroundrb Plugin]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/131</dc:relation>
          <dc:subject><![CDATA[Managing Zebra]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/139</dc:relation>
          <dc:subject><![CDATA[Troubleshooting]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/140</dc:relation>
          <dc:subject><![CDATA[Upgrading to Kete 1.0 Release Branch]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/142</dc:relation>
          <dc:subject><![CDATA[Updating to the latest Kete code]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/151</dc:relation>
          <dc:subject><![CDATA[Solaris 10: Installing Required Software]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/160</dc:relation>
          <dc:subject><![CDATA[openSUSE Installing Required Software]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/170</dc:relation>
          <dc:subject><![CDATA[Improving send_file Performance]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/180</dc:relation>
          <dc:subject><![CDATA[Using Content Licenses in Kete]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/181</dc:relation>
          <dc:subject><![CDATA[Upgrading to Kete 1.1 Release]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/177</dc:relation>
          <dc:subject><![CDATA[Upgrading Ruby Enterprise Edition]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/198</dc:relation>
          <dc:subject><![CDATA[Configuring sudo PATH in Capistrano Deployments]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/240</dc:relation>
          <dc:subject><![CDATA[Adding SSL to Apache2 on Debian]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/241</dc:relation>
          <dc:subject><![CDATA[Debian: Restarting Backgroundrb And Zebra on Reboot]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/299</dc:relation>
          <dc:subject><![CDATA[Passenger Configuration Options]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/topics/show/301</dc:relation>
          <dc:subject><![CDATA[Example Nginx Configuration File Simple Installation]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/documents/show/17</dc:relation>
          <dc:subject><![CDATA[Example Nginx Configuration File for Use with Capistrano]]></dc:subject>
          <dc:relation>http://kete.net.nz/documentation/documents/show/18</dc:relation>
          <dc:type>InteractiveResource</dc:type>
          <dc:subject><![CDATA[Kete]]></dc:subject>
          <dc:subject><![CDATA[Installation]]></dc:subject>
          <dc:subject><![CDATA[download]]></dc:subject>
          <dc:subject><![CDATA[install]]></dc:subject>
          <dc:subject><![CDATA[setup]]></dc:subject>
          <dc:subject><![CDATA[documentation]]></dc:subject>
          <dc:subject><![CDATA[downloads]]></dc:subject>
          <dc:subject><![CDATA[mongrel]]></dc:subject>
          <dc:subject><![CDATA[svn]]></dc:subject>
          <dc:subject><![CDATA[backgroundrb]]></dc:subject>
          <dc:subject><![CDATA[Nginx]]></dc:subject>
          <dc:subject><![CDATA[capistrano]]></dc:subject>
          <dc:subject><![CDATA[Debian]]></dc:subject>
          <dc:subject><![CDATA[Mac OS X]]></dc:subject>
          <dc:subject><![CDATA[Troubleshooting]]></dc:subject>
          <dc:rights>http://creativecommons.org/licenses/by-sa/3.0/nz/</dc:rights>
          <dc:format>text/html</dc:format>
          <dc:coverage>Topic</dc:coverage>
        </oai_dc:dc>
      </metadata>
      <kete>
        <related_items comments="2" topics="34" documents="2" web_links="1"/>
      </kete>
    </record>
  </GetRecord>
</OAI-PMH>
