Skip to content

Commit

Permalink
Updates to README/INSTALL
Browse files Browse the repository at this point in the history
INSTALL requires a major overhaul to account for
deployment via Plack, recommended use of perlbrew
or carton, etc.
  • Loading branch information
ctfliblime committed Nov 29, 2011
1 parent 18a94bc commit 5bf83a7
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 36 deletions.
32 changes: 6 additions & 26 deletions INSTALL
@@ -1,4 +1,4 @@
Koha 3 - the next-generation release of the award-winning Koha open-source
LibLime Koha 4.8 - the next-generation release of the award-winning Koha open-source
integrated library system.

Koha is the first open-source Integrated Library System. Developed initially in
Expand All @@ -10,40 +10,25 @@ more about the Koha project at http://koha.org.
INSTALLATION
============

Koha 3 comes with a new installer, based on MakeMaker, the tool that
LibLime Koha 4 comes with a new installer, based on MakeMaker, the tool that
is usually used to install CPAN modules. This means that if you know
how to customise CPAN-installed modules, the same things should work
for you with Koha. If not, don't worry. If you want to customise the
installation more than described below, run "man ExtUtils::MakeMaker"

You need to have a server running Perl 5.8, MySQL 5 or PostgreSQL 8.2.5, Zebra
2.0.22 or greater and a webserver (preferably Apache2) before installing
Koha.
You need to have a server running Perl 5.10, MySQL 5, Zebra2.0.22 or greater
and a webserver (preferably Apache2) before installing Koha.

MySQL 5: Create a database called 'koha,' owned by 'kohaadmin'
user, with a password set. Note: kohaadmin must have at least the
following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,
ALTER, and LOCK TABLES.

PostgreSQL 8.2.5: Create a database called 'koha,' owned by 'kohaadmin'
user, with a password set. Note: kohaadmin must be a superuser. You
must also add plpgsql to the koha database. NOTE: PostgreSQL support in
Koha is experimental and should not be attempted for production systems
without a heavy investment in testing.

Default installation instructions:

1. perl Makefile.PL
(you will be prompted to answer a number of questions and you will
need to install some Perl dependencies)
WARNING:
1.1 A Perl library Koha depends on, MARC::File::XML may not work with Perl
5.10, see: http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),

1.2 recent versions of CGI::Session have caused some issues for users;
as of this release date, we suggest downloading the CGI::Session::serialize::yaml
tarball direct from CPAN and install it directly rather than using the cpan command

2. make
3.(optional) make test
4. sudo make install
Expand Down Expand Up @@ -75,7 +60,7 @@ $ perldoc rewrite-config.PL

UPGRADE
=======
If you are upgrading from a previous installation of Koha 3, you can
If you are upgrading from a previous installation of LibLime Koha 4, you can
use the following:

perl Makefile.PL --prev-install-log /path/to/koha-install-log
Expand Down Expand Up @@ -105,12 +90,7 @@ WHAT NEXT?
$ misc/migration-tools/rebuild_zebra.pl -b -w

Once the indexing has completed, you will be able to search for records in your
system. NOTE: if you don't run the Fast Index utility, and you have the index
updates scheduled as per 7.3 the indexing process will happen in the background,
Once the indexing has completed, you will be able to search for records in your
system. NOTE: if you don't run the Fast Index utility, and you have the index
updates scheduled as per 7.3 the indexing process will happen in the background,
but it will be orders of magnitude slower.
system.

4. Schedule regular index updates
run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
Expand Down
14 changes: 4 additions & 10 deletions README
@@ -1,13 +1,7 @@
Koha 3 - the next-generation release of the award-winning Koha open-source
integrated library system.
Liblime Koha 4.8 - the next-generation release of the award-winning Koha open-source
integrated library system - http://koha.org/

30 December 2007 - Joshua Ferraro <jmf AT liblime DOT com>

Koha is distributed under the GNU GPL. Please read the file LICENSE for
Liblime Koha is distributed under the GNU GPL. Please read the file LICENSE for
more details.

To install or upgrade Koha, please see the INSTALL file.

Please report any bugs to the koha mailing lists or bug tracker and we
will try to fix them in a future release. The main koha web site is
http://www.koha.org/
To install or upgrade Liblime Koha, please see the INSTALL file.

0 comments on commit 5bf83a7

Please sign in to comment.