DominicHargreaves has created some Debian packages for OpenGuides. To use them, simply add the following line to your /etc/apt/sources.list file:

deb        unstable/

The packages should work with the current stable (3.1), testing and unstable branches, but are not rigourously tested. For current bugs and information, see Debian_package_bug_tracking.

Installing With the Debian Packages

To install the OpenGuides software with the Debian packages, add the above line to your sources.list file, then:

apt-get update

Before we install the OpenGuides software itself, we need to know which database backend(s) we're planning on using, which webserver(s), and which search indexers. By default, OpenGuides will install the MySQL database backend and Apache 2 webserver, so if you're planning on using SQLite or Postgres, or Apache 1, we need to specify this when installing the software. The Debian packages will note that you're installing one of the backends and won't force its own choices on you. To see what alternatives are available, look at the dependencies for the openguides package in your manager of choice and look for alternatives. For database backends, check the dependencies of libcgi-wiki-perl which openguides will install for you.

So for a setup using SQLite as a database, Apache 1 as a webserver, and Search::InvertedIndex? for searching, you would use

apt-get install apache libdbd-sqlite3-perl libsearch-invertedindex-perl openguides

(NOTE: we don't recommend that you use Search::InvertedIndex? and, if you don't already have a web server installed, there probably isn't any good reason to install Apache 1).

Other than this, the standard

apt-get install openguides

should give you a system which works. Either way, apt will now install an awful lot of Perl libraries for you, and hopefully set them up as well.

Once you've installed the Debian packages, take a look in /usr/share/doc/openguides/ for tips on setting up guides.

Last modified 11 years ago Last modified on May 12, 2006, 9:16:03 AM