|
Lines 1-157
Link Here
|
| 1 |
Koha 3 - the next-generation release of the award-winning Koha open-source |
1 |
For instructions on how to install Koha on Ubuntu from packages, please |
| 2 |
integrated library system. |
2 |
consult http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages |
| 3 |
|
3 |
|
| 4 |
Koha is the first open-source Integrated Library System. Developed initially in |
4 |
For instructions on how to install Koha on Debian from packages, please |
| 5 |
New Zealand by Katipo Communications, Ltd and first deployed in January of 2000 |
5 |
consult https://wiki.koha-community.org/wiki/Debian |
| 6 |
for the Horowhenua Library Trust, it is currently maintained by a team of |
|
|
| 7 |
software providers and library technology staff from around the globe. Learn |
| 8 |
more about the Koha project at http://koha-community.org. |
| 9 |
|
6 |
|
| 10 |
INSTALLATION |
7 |
If you are a developer, you should take a look at KohaDevBox |
| 11 |
============ |
8 |
https://github.com/digibib/kohadevbox |
| 12 |
|
|
|
| 13 |
You need to have a server running Perl 5.10 or later, MySQL 5, Zebra |
| 14 |
2.0.22 or greater and a webserver (preferably Apache2) before installing |
| 15 |
Koha. |
| 16 |
|
| 17 |
MySQL 5: Create a database called 'koha,' owned by 'kohaadmin' |
| 18 |
user, with a password set. Note: kohaadmin must have at least the |
| 19 |
following privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, |
| 20 |
ALTER, and LOCK TABLES. |
| 21 |
|
| 22 |
Default installation instructions: |
| 23 |
|
| 24 |
1. perl Makefile.PL |
| 25 |
(you will be prompted to answer a number of questions and you will |
| 26 |
need to install some Perl dependencies) |
| 27 |
WARNING: |
| 28 |
|
| 29 |
1.1 recent versions of CGI::Session have caused some issues for users; |
| 30 |
as of this release date, we suggest downloading the CGI::Session::serialize::yaml |
| 31 |
tarball direct from CPAN and install it directly rather than using the cpan command |
| 32 |
|
| 33 |
1.2. Optional foreign language installation: |
| 34 |
If you would like more languages and not only English, |
| 35 |
cd misc/translator |
| 36 |
perl translate install fr-FR # or use your preferred language codes |
| 37 |
|
| 38 |
2. make |
| 39 |
3.(optional) make test |
| 40 |
4. sudo make install |
| 41 |
5. sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha |
| 42 |
(note that the path to koha-httpd.conf may be different depending on your |
| 43 |
installation choices) |
| 44 |
6. sudo a2enmod rewrite deflate |
| 45 |
7. sudo a2ensite koha && /etc/init.d/apache2 reload |
| 46 |
8. sudo zebrasrv -f /etc/koha/koha-conf.xml |
| 47 |
(note that you will want to run Zebra in daemon mode for a production |
| 48 |
system) |
| 49 |
9. Browse to http://servername:8080/ and answer the questions |
| 50 |
10. Optionally add a robots.txt file. See README.robots for details |
| 51 |
|
| 52 |
OR if you want to install all dependencies from CPAN and are root, you can |
| 53 |
replace steps 1-3 with "perl install-CPAN.pl" but this is non-standard and |
| 54 |
may not be safe. Nevertheless, it's pretty cool when it works. |
| 55 |
|
| 56 |
The defaults will install Koha to places that follow relevant standards, |
| 57 |
such as the File Hierarchy Standard. If you want to install Koha to a |
| 58 |
different directory like /opt/koha, then replace step 1 with (for example): |
| 59 |
|
| 60 |
1. perl Makefile.PL INTRANET_CGI_DIR=/www/cgi-bin |
| 61 |
|
| 62 |
You can change most of the defaults in a similar way, such as DB_HOST. |
| 63 |
For full instructions on how to override the default settings, run |
| 64 |
|
| 65 |
$ perldoc rewrite-config.PL |
| 66 |
|
| 67 |
UPGRADE |
| 68 |
======= |
| 69 |
If you are running in another language other than english, please |
| 70 |
switch to english before doing the upgrade, the templating system has |
| 71 |
changed and the templates will need to be regenerated. |
| 72 |
Once you have upgraded, please regenerate your templates in your |
| 73 |
chosen languages. |
| 74 |
|
| 75 |
If you are upgrading from a previous installation of Koha 3.x, you can |
| 76 |
use the following: |
| 77 |
|
| 78 |
./koha_perl_deps.pl -u -m # to identify new Perl dependencies |
| 79 |
|
| 80 |
Install any missing modules |
| 81 |
IMPORTANT: Koha 3.4.0 and greater uses Template::Toolkit, this must be installed |
| 82 |
before the webinstaller can run |
| 83 |
|
| 84 |
On debian/ubuntu |
| 85 |
sudo apt-get install libtemplate-perl |
| 86 |
|
| 87 |
Other Linux/Unix platforms |
| 88 |
Use the packaged version or install from CPAN |
| 89 |
cpan Template |
| 90 |
|
| 91 |
perl Makefile.PL --prev-install-log /path/to/koha-install-log |
| 92 |
make |
| 93 |
make test |
| 94 |
sudo make upgrade |
| 95 |
|
| 96 |
Koha 3.4.x or later no longer stores items in biblio records. |
| 97 |
If you are upgrading from an older version ou will need to do the |
| 98 |
following two steps, they can take a long time (several hours) to |
| 99 |
complete for large databases |
| 100 |
|
| 101 |
misc/maintenance/remove_items_from_biblioitems.pl --run |
| 102 |
misc/migration_tools/rebuild_zebra.pl -b -r |
| 103 |
|
| 104 |
WHAT NEXT? |
| 105 |
|
| 106 |
1. Running the Web Installer allows you to install sample data for libraries, patrons, etc. |
| 107 |
but you may want to install additional data such as bibliographic and authorities. |
| 108 |
|
| 109 |
Once the installer has completed, you can import and index MARC records from the |
| 110 |
command line thusly (Note: you can also use the 'Stage MARC records for import' from |
| 111 |
the Tools area of Koha's Staff Client to import a batch of MARC records): |
| 112 |
|
| 113 |
$ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml |
| 114 |
(note: use the correct path to your koha-conf.xml) |
| 115 |
|
| 116 |
2. Import: |
| 117 |
Bibliographic data in MARC21 format |
| 118 |
$ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709 |
| 119 |
Authority data in MARC21 format |
| 120 |
$ misc/migration_tools/bulkauthimport.pl -file /path/to/auth.iso2709 |
| 121 |
|
| 122 |
3. Fast Index: |
| 123 |
$ misc/migration_tools/rebuild_zebra.pl -b -w |
| 124 |
|
| 125 |
Once the indexing has completed, you will be able to search for records in your |
| 126 |
system. NOTE: if you don't run the Fast Index utility, and you have the index |
| 127 |
updates scheduled as per 7.3 the indexing process will happen in the background, |
| 128 |
but it will be orders of magnitude slower. |
| 129 |
|
| 130 |
4. Schedule regular index updates |
| 131 |
run rebuild_zebra.pl -b -a -z as a regular cron job, check the 'misc/cronjobs/crontab.example' file for usage examples |
| 132 |
|
| 133 |
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra |
| 134 |
|
| 135 |
5. To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and |
| 136 |
change the <listen> options to listen on a TCP port; then restart the zebra daemon. |
| 137 |
|
| 138 |
|
| 139 |
IF YOU HAVE PROBLEMS |
| 140 |
==================== |
| 141 |
|
| 142 |
IF THIS IS A PRE-RELEASE TREE: please contact developers by email via |
| 143 |
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel |
| 144 |
or |
| 145 |
http://dir.gmane.org/gmane.education.libraries.koha.devel |
| 146 |
|
| 147 |
IF THIS IS A RELEASED VERSION: please see the support pages at |
| 148 |
http://www.koha-community.org/ |
| 149 |
|
| 150 |
Released versions usually have three-digit numbers, like 3.06.00, |
| 151 |
while other version number styles are usually snapshots or previews. |
| 152 |
|
| 153 |
|
| 154 |
DEVELOPER NOTES |
| 155 |
=============== |
| 156 |
|
| 157 |
For instructions on how to package releases, run perldoc Makefile.PL |
| 158 |
- |
|
|