Lines 1-13
Link Here
|
1 |
============================= |
1 |
============================= |
2 |
Installation Guide for Installing Koha on Debian Lenny with MySQL 5 |
2 |
Installation Guide for Installing Koha on Debian |
3 |
============================= |
3 |
============================= |
4 |
|
4 |
|
5 |
Some parts copyright 2010 Chris Nighswonger |
5 |
Some parts copyright 2010 Chris Nighswonger |
|
|
6 |
Some parts copyright 2011 MJ Ray and software.coop |
6 |
|
7 |
|
7 |
Feedback/bug reports: Koha Developer's List: |
8 |
Feedback/bug reports: Koha Developer's List: |
8 |
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel |
9 |
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel |
9 |
|
10 |
|
10 |
This document last modified: October 8, 2010 |
11 |
This document last modified: 2011-06-19 |
11 |
|
12 |
|
12 |
Installation Instructions |
13 |
Installation Instructions |
13 |
============================= |
14 |
============================= |
Lines 17-35
as indicated or by running the command directly as root.
Link Here
|
17 |
|
18 |
|
18 |
1. Prepare System and Install Dependencies |
19 |
1. Prepare System and Install Dependencies |
19 |
|
20 |
|
20 |
1.1 Install Debian Lenny via Businesscard CD |
21 |
1.1 Install Debian via Business Card CD |
21 |
|
22 |
|
22 |
See http://www.debian.org/releases/lenny/debian-installer/ |
23 |
See http://www.debian.org/CD/netinst/ |
23 |
|
24 |
|
24 |
1.2 Set up Indexdata apt sources for Yaz and Zebra packages |
25 |
1.2 Set up Indexdata apt sources for Yaz and Zebra packages |
25 |
|
26 |
|
26 |
Edit your /etc/apt/sources.list file and add the following: |
27 |
See the instructions from indexdata at |
|
|
28 |
http://ftp.indexdata.com/pub/debian/README |
29 |
|
30 |
At the time of writing, you need to create |
31 |
/etc/apt/sources.list.d/indexdata.list containing the following: |
27 |
|
32 |
|
28 |
# Index Data |
33 |
# Index Data |
29 |
deb http://ftp.indexdata.dk/debian lenny main |
34 |
deb http://ftp.indexdata.dk/debian squeeze main |
30 |
deb-src http://ftp.indexdata.dk/debian lenny main |
35 |
deb-src http://ftp.indexdata.dk/debian squeeze main |
31 |
|
36 |
|
32 |
The Index Data packages are signed with a key you can install as follows: |
37 |
and add their archive signing key to your system: |
33 |
|
38 |
|
34 |
$ wget -O- http://ftp.indexdata.dk/debian/indexdata.asc | sudo apt-key add - |
39 |
$ wget -O- http://ftp.indexdata.dk/debian/indexdata.asc | sudo apt-key add - |
35 |
|
40 |
|
Lines 53-98
Note: for more information about Git, please see the Koha Git Usage Guide:
Link Here
|
53 |
1.3.2 Option B: Download Koha from http://download.koha-community.org |
58 |
1.3.2 Option B: Download Koha from http://download.koha-community.org |
54 |
|
59 |
|
55 |
Find the latest Koha stable version on http://download.koha-community.org |
60 |
Find the latest Koha stable version on http://download.koha-community.org |
56 |
and get it: |
61 |
and download it to your server with something like: |
57 |
|
62 |
|
58 |
$ wget <URL> found on download.koha-community.org |
63 |
$ wget <URL found on download.koha-community.org> |
59 |
|
64 |
|
60 |
1.4 Install additional Debian dependencies |
65 |
1.4 Install additional Debian dependencies |
61 |
|
66 |
|
62 |
IMPORTANT: You should only use CPAN for Perl dependencies which are NOT |
67 |
IMPORTANT: You should only use CPAN for Perl dependencies which are NOT |
63 |
available from the package maintainer. You have been warned! |
68 |
available from the package maintainer. You have been warned! |
64 |
|
69 |
|
65 |
Run shell script installing all necessary Debian packages, MySQL Server, |
70 |
Installing all necessary Debian packages, MySQL Server, |
66 |
Zebra and all Debian packaged Perl module required by Koha: |
71 |
Zebra and all Debian packaged Perl module required by Koha: |
67 |
|
72 |
|
68 |
$ sudo install_misc/apt-get-debian-lenny.sh |
73 |
$ sudo dpkg --set-selections < installer_misc/debian.packages |
|
|
74 |
$ sudo apt-get dselect-upgrade |
69 |
|
75 |
|
70 |
1.5 Install Perl dependencies that aren't packaged into Debian Lenny |
76 |
1.5 Install Perl dependencies that aren't packaged into Debian |
71 |
sources |
|
|
72 |
|
77 |
|
73 |
Run the following command: |
78 |
Run the following command: |
74 |
|
79 |
|
75 |
$ sudo cpan Algorithm::CheckDigits SMS::Send HTTP::OAI IPC::Cmd \ |
80 |
$ perl koha_perl_deps.pl -m -u |
76 |
Memoize::Memcached PDF::API2::Simple PDF::Table Storable Test::More \ |
|
|
77 |
Locale::Currency::Format DateTime Lingua::Stem::Snowball Text::CSV::Encoded \ |
78 |
UNIVERSAL::require YAML Authen::CAS::Client |
79 |
|
81 |
|
80 |
Note: you may need to run CPAN initialization if you've not run cpan |
82 |
This will list whether any Perl dependencies are missing or need a |
81 |
before: |
83 |
later version and whether they are required. You can then install |
|
|
84 |
them another way. There may be packages on |
85 |
http://debian.koha-community.org or maybe you can build packages |
86 |
yourself or maybe you will need to install them locally with a command |
87 |
similar to |
82 |
|
88 |
|
83 |
/etc/perl/CPAN/Config.pm initialized. |
89 |
$ sudo cpan Graphics::Magick |
84 |
|
90 |
|
85 |
CPAN is the world-wide archive of perl resources. It consists of about |
91 |
Note: you may need to run CPAN initialization if you've not run cpan |
86 |
100 sites that all replicate the same contents all around the globe. |
92 |
before. See http://search.cpan.org/~andk/CPAN/lib/CPAN.pm#CONFIGURATION |
87 |
Many countries have at least one CPAN site already. The resources |
|
|
88 |
found on CPAN are easily accessible with the CPAN.pm module. If you |
89 |
want to use CPAN.pm, you have to configure it properly. |
90 |
|
91 |
If you do not want to enter a dialog now, you can answer 'no' to this |
92 |
question and I'll try to autoconfigure. (Note: you can revisit this |
93 |
dialog anytime later by typing 'o conf init' at the cpan prompt.) |
94 |
|
95 |
Are you ready for manual configuration? [yes] |
96 |
|
93 |
|
97 |
When the configuration is completed CPAN will install the Perl modules. |
94 |
When the configuration is completed CPAN will install the Perl modules. |
98 |
|
95 |
|
Lines 194-200
Note: you may still see the usual Apache default site if your VirtualHost
Link Here
|
194 |
configuration isn't correct. If Koha is the only web application running on the server, |
191 |
configuration isn't correct. If Koha is the only web application running on the server, |
195 |
the command "sudo a2dissite default" may be a quick fix. For servers running other sites |
192 |
the command "sudo a2dissite default" may be a quick fix. For servers running other sites |
196 |
alongside Koha, see the Apache HTTPD manual section on virtual hosts for full |
193 |
alongside Koha, see the Apache HTTPD manual section on virtual hosts for full |
197 |
instructions (http://httpd.apache.org/docs/2.0/vhosts/). |
194 |
instructions (http://httpd.apache.org/docs/2.2/vhosts/). |
198 |
|
195 |
|
199 |
5. Run the Web Installer, populate the database, initial configuration of settings |
196 |
5. Run the Web Installer, populate the database, initial configuration of settings |
200 |
|
197 |
|
Lines 374-379
Uninstall Instructions
Link Here
|
374 |
Tested on the following operating environments |
371 |
Tested on the following operating environments |
375 |
============================================== |
372 |
============================================== |
376 |
- Debian Lenny 5.0 |
373 |
- Debian Lenny 5.0 |
|
|
374 |
- Debian Squeeze 6.0 |
377 |
|
375 |
|
378 |
Other Notes |
376 |
Other Notes |
379 |
===================== |
377 |
===================== |