Bug 13914 : Fix UNION in SQL request for reserves statistics
[koha.git] / INSTALL.fedora7
1 THIS FILE IS TOO OLD AND NOT UPDATED.
2 CHECK KOHA WIKI:http://wiki.koha-community.org
3 CHECK OTHERS INSTALL FILES
4 ASK IN KOHA MAILING LIST
5
6 =============================
7 Installation Guide for Installing Koha on Fedora Core 7
8 =============================
9
10 Copyright (C) 2008, Department of Computer and Information
11 Science, Library of the University Lyon 2, France
12
13 Translated by: Google with help from Joshua Ferraro
14 (jmf AT liblime DOT com)
15
16 Feedback/bug reports: Koha Developer's List: 
17 http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
18
19 This document last modified: 30 April 2008
20
21 Installation Instructions
22 =============================
23 This document was prepared in order to help you discover (or
24 test) Koha (Integrated Library System).
25
26 The installation of Linux system described below is a basic, 
27 it is not designed for a production server (e.g., security, 
28 load balancing .. are not described).
29
30 This document describes the different stages of installing 
31 the software to version 3.00 koha beta on a Fedora 7 Linux.
32 Your mileage may vary with different RedHat distributions.
33
34 1. LINUX SYSTEM INSTALLATION
35
36 System: Linux Fedora 7 (May 2007) Linux Redhat
37 The Linux distribution Fedora 7 is downloadable from the 
38 Fedora website:
39
40 http://fedoraproject.org/
41
42 The Fedora website also offers additional content such as
43 documentation, FAQ, etc.
44
45 Using the entire disk (removal of existing partitions and 
46 therefore permanent loss of data stored on the disk) is
47 the easiest method; This is not the best practice for a 
48 production system, but is useful for testing purposes.
49
50 Check that the computer is able to boot from a CD or DVD,
51 perhaps by changing the boot order in the bios.
52
53 Place the CD or DVD in the drive and restart the machine.
54
55 Settings when installing Linux (French specific, may not apply)
56
57 Language: French (French)
58 Choice of keyboard: French (Latin9) recognized by default.
59 Removal of existing Linux partitions
60 Host Name: NomMachine.NomDomaine.fr
61 Time zone: Europe/Paris. Click on the map or select from the
62 list and check system clock to UTC.
63 Informing the root password, which is the administrator account.
64
65 The installation of the system will automatically start and may
66 take between 15 to 30 minutes to complete.
67
68 Click Restart.
69
70 Enter the default options.
71 For Firewall, check www http server (configuration of the firewall).
72 Create a user koha with the password kohakoha (eg)
73 The koha is therefore created and the group koha which this user belongs.
74
75 Setting the homepage
76 Enter root, then the password root.
77
78 With Fedora, GNOME is the default environment.
79
80 To use KDE default (as we at Lyon 2 have done), close the session,
81 having recovered the KDE packages on Add/Remove software. For the
82 french interface,  go through the package manager and seek, then
83 install kde-french.
84
85 On the login prompt, go to Options è Select Session and choose KDE. A
86 the next connection, the system will ask if you want to use KDE or 
87 GNOME by default. Also on the login prompt, go to Languages and 
88 choose the French.
89
90 The installation of Linux system is complete. 
91
92 1.2 Verification of system settings
93
94 You must be logged in as administrator of the system (root).
95
96 -- Make sure the environment is KDE. The taskbar is at the
97 bottom of the screen and left of this bar is the menu K.
98
99 -- Check that the system is in french and click on K.
100
101 -- Create a few shortcuts in making a drag and drop the following
102 items in the taskbar:
103
104 Menu K è è Internet Firefox Web Browser
105 Menu K è è Terminal System
106 Menu K è è Services System Management Services
107
108 -- Check that the koha and the group koha are created:
109 Menu K è è System Users and Groups
110
111 -- Check that web servers Apache and MySQL are installed.
112 Menu K è è Services System Management Services
113
114 The lines httpd (demon Apache) and mysqld (demon MySQL) must be 
115 included in the line of services. You must configure these two 
116 services so that they are lançés automatically at boot. Check th
117 e box to the left of the service, click the Start button at the 
118 top of the list, if the two services start without any problem, 
119 validate the change of manager services by clicking on Save or 
120 File menu è save changes
121
122 Close the services manager.
123
124 If one or both services are absent, it is necessary to install Apache
125 and/or MySQL. To do so, go in the Package Manager, choose and 
126 select Apache server and/or MySQL. In the case of MySQL, we must
127 not forget MySQL-devel (available in packages optional). Finally,
128 start the installation.
129
130 1.3 Installation of additional software
131
132 The software installation Koha requires adding additional programs
133 to your system linux based on a standard installation. This list may
134 be slightly different depending on the version and support (Live
135 CD or DVD).
136
137 List of software to add
138 Libxml2-devel
139 Libxslt-devel
140 TCL
141 Bzip2-devel
142 GCC
143 Perl-CPAN
144 Perl-ExtUtils-AutoInstall
145 Ncftp
146 Wget
147 Gdbm-devel
148 Expat-devel
149 Tcp_wrappers-devel
150 Libicu (see below)
151 git-1.5.3.7-1.fc8 [is not necessary for the installation of koha, but
152   useful if one participates in the development of koha.]
153 PhPMyAdmin
154 Libicu
155 Libicu-devel
156
157 To add software Linux Fedora, you have two tools
158
159 A graphical tool
160 Menu K è è System Add/Remove software
161
162 Click on the Search tab
163 Enter the name of the software in the zone entry and click the
164 Search button;
165
166 The software that match your search are listed.
167 Make sure the check box is checked if the tick and click Apply to
168 add software to your system.
169
170 A tool mode Terminal YUM
171 The YUM documentation is available on the Fedora site
172
173 Open a terminal window (K Menu è è Terminal System)
174
175 Examples of using YUM:
176 Is the web browser Firefox installed?
177 Type the command: yum list firefox
178 This command will launch the software yum, and asked it to list
179 the information on the Firefox.
180 Yum visit the various deposits of software for Fedora (fedora,
181 updates, etc.). And said that the firefox software is installed
182 on this machine (version 2.0.0.3-4.fc7) and there is a
183 downloadable version newer ( version 2.0.0.10-2.fc7)
184
185 ************************************************** ****************
186 Screenshot
187 [root @ nomduserveur ~] # yum list firefox
188 Loading "installonlyn" plugin
189 fedora 100% |=========================| 2.1 kB 00:00
190 updates 100% |=========================| 2.3 kB 00:00
191 Installed Packages
192 firefox.i386 2.0.0.3-4.fc7 installed
193 Packages Available
194 firefox.i386 2.0.0.10-2.fc7 updates
195 ************************************************** ****************
196
197 Updated software firefox by the command yum update firefox.
198 YUM inspect the system to check whether it is necessary to update
199 other software used by firefox.
200 confirm your request y
201
202 Installation of new software by the command yum install firefox.
203
204
205 Verification
206 Check whether these programs are installed using the command rpm
207 with option-q followed by the name of the software, possibly separated
208 by a space.
209 Example:
210 rpm-q libxml2-devel libxslt-devel tcl bzip2-devel gcc mysql-devel-perl CPAN perl-ExtUtils-AutoInstall ncftp wget gdbm devel-expat-devel tcp_wrappers-devel
211
212 NB: The tool rpm (Redhat Package Manager) allows facilities
213 management software under the Linux distribution Fedora.
214
215 Special case: the library libicu under Fedora 8
216 Under Fedora 8:
217 The library libicu, is standard in the distribution Fedora.
218 Version 3.8 of this library installed with Fedora 8 is too recent
219 and poses a problem when installing software and ZEBRA YAZ, the
220 company Indexdata who compiled these two programs with version 3.6
221 of the library, it is therefore necessary to remove the libicu 3.8
222 library and replace it with version 3.6.
223
224 Uninstall the library libicu - 3.8-1.fc8
225
226 With the web browser, download the library libicu-3.6-18.fc7.i386.rpm
227 (old version, choose the version Fedora 7 for i386) here:
228
229   HYPERLINK "http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36" http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36
230
231 Download the package rpm
232 Open a terminal window, a menu K> System> Terminal
233 find the file libicu-3.6-18.fc7.i386.rpm
234 Desktop CD
235 ls-l
236
237 decompress the archive with the command: rpm-ivh libicu-3.6-18.fc7.i386.rpm
238
239 Setting 1.4 for the use of unicode
240
241 VERY IMPORTANT
242 UNICODE must be set up correctly before installing Koha.
243
244 1.4.1 The Linux system is it configured to use UNICODE?
245
246 For more information:
247   HYPERLINK "http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha" http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha
248
249 To check, open a terminal window and type the locale.
250 You must obtain:
251 LANG = en_GB.UTF-8
252 ...
253
254 1.4.2 The web server Apache 2 is it configured to use UNICODE?
255
256 To verify, using a text editor, open the httpd.conf file located
257 in /etc/httpd/conf and look if it contains the directive:
258
259 AddDefaultCharset UTF-8
260
261 1.4.3 The MySQL server is it configured to use UNICODE?
262
263 NB: mysqld service must be started.
264 In a Terminal window, type the command mysql, then an SQL
265 to display variables content server configuration.
266 Text of query:
267
268 show where variable_name variables like 'char%';
269
270 ******************************************************************
271 Screenshot
272 mysql> show where variable_name variables like 'char%';
273 +--------------------------+----------------------------+
274 | Variable_name            | Value |
275 +--------------------------+----------------------------+
276 | Character_set_client     | latin1 |
277 | Character_set_connection | latin1 |
278 | Character_set_database   | latin1 |
279 | Character_set_filesystem | Binary |
280 | Character_set_results    | latin1 |
281 | Character_set_server     | latin1 |
282 | Character_set_system     | utf8   |
283 | Character_sets_dir       | /usr/share/mysql/charsets/ |
284 +--------------------------+----------------------------+
285 8 rows in set (0.00 sec)
286 ******************************************************************
287
288 Some variables are not properly configured (latin1), so we have to
289 change the configuration file server MySQL.
290 Leaving the mysql client by the command quit.
291
292 Using a text editor, open the file my.cnf located in the directory /
293 etc and add these 3 lines in the section [mysqld]:
294
295 default-character-set = utf8
296 character-set-server = utf8
297 skip-character-set-client-handshake
298
299 To ensure that this change is taken into account, restart the server
300 Mysql using the following command in a terminal window:
301 mysqld restart service
302
303 Check that changing the parameters was taken into account by reconnecting
304 the MySQL server with the command mysql, then typing the query:
305
306 show where variable_name variables like 'char%';
307 The variables contain well utf8 /
308 Quit MySQL by the command quit
309
310 ******************************************************************
311 Screenshot
312   MySQL
313 Welcome to the MySQL monitor. Commands end with; or \g.
314 Your MySQL connection id is 2
315 Server version: 5.0.45 Source distribution
316
317 Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
318
319 mysql> show where variable_name variables like 'char%';
320 +--------------------------+----------------------------+
321 | Variable_name            | Value |
322 +--------------------------+----------------------------+
323 | Character_set_client     | utf8   |
324 | Character_set_connection | utf8   |
325 | Character_set_database   | utf8   |
326 | Character_set_filesystem | Binary |
327 | Character_set_results    | utf8   |
328 | Character_set_server     | utf8   |
329 | Character_set_system     | utf8   |
330 | Character_sets_dir       | /usr/share/mysql/charsets/ |
331 +--------------------------+----------------------------+
332 8 rows in set (0.00 sec)
333
334 MySQL> quit
335 Bye
336 ******************************************************************
337
338 Some information for the use of MySQL here: HYPERLINK "http://doc.ubuntu-fr.org/mysql" http://doc.ubuntu-fr.org/mysql
339
340 2 INSTALLATION OF ZEBRA SERVER INDEXING
341
342 For libraries that must manage several tens of thousands of bib records
343 it is recommended that you install the server indexing ZEBRA. Otherwise
344 (far fewer records to manage), it is not necessary to install ZEBRA.
345
346 The software installation ZEBRA requires prior installation of software
347 modules YAZ client and server Z3950.
348
349 The installation is as administrator (root).
350
351 NB: the creation of files yaz and zebra is only necessary if you use
352 the graphical
353
354 Website for downloads: HYPERLINK "http://www.indexdata.dk/software/" http://www.indexdata.dk/software/
355
356
357 2.1 Installation of the software YAZ
358
359 Creating a file needed for the installation of Yaz
360 Create files redhat in the directory /usr/src
361 SOURCES Create a folder in the directory /usr/src/redhat
362 NB: redhat lowercase and uppercase SOURCES.
363
364 Installing Yaz by the command:
365 rpm-ivh ftp://ftp.indexdata.dk/pub/yaz/redhat/fc6/ *- 3.0.24 *.*. rpm
366 Check the final published version and replace -3.0.24 by the number
367 of the current version.
368
369 Check the installation by the command:
370 rpm-q libyaz3 libyaz3-devel yaz yaz-debuginfo yaz-icu-yaz illclient yaz-3.0.24-1.src
371
372
373 2.2 Installation of the software ZEBRA
374
375 To install packages from the version 2.0.26-1:
376 rpm-ivh ftp://ftp.indexdata.dk/pub/zebra/redhat/fc6/ *- 2.0.26-1 .*. rpm
377 Check dernère published version and replace -2.0.26-1 by the
378 number of the current version.
379
380 Check the installation by the command:
381 rpm-q libidzebra-2.0-2.0-libidzebra modules idzebra-2.0 idzebra-2.0-debuginfo libidzebra-2.0-devel idzebra-2.0
382
383 3 INSTALLATION OF KOHA 3.0
384
385 Important Reminder:
386 Make sure, BEFORE you install koha, that the system Linux, the MySQL
387 server and the Apache server are configured to use the Unicode
388 format (cf. 1.4).
389
390
391 Download koha here: HYPERLINK "http://download.koha-community.org/koha-3.00.00-beta2.tar.gz" http://download.koha-community.org/koha-3.00.00-beta2.tar.gz
392
393 3.1 Decompression of the archive koha 3.0
394
395 Save the file in the directory /usr/share.
396 Opening a window Terminal, and placing himself in the directory /usr/share by the command:
397 cd /usr/share
398 verify the presence of compressed file koha by the command:
399 ls-l * Koha
400 Unzip the file with the command tar:
401 tar-xvf koha-3.00.00-beta2.tar.gz
402 You get a folder koha-3.00.00-beta2, which contains folders and files needed for the installation of software koha.
403
404 NB: the installation procedure is described in the text files "INSTALL"
405 and "INSTALL debian", the second is more complete.
406
407
408 3.2 Protect access to the database server MySQL
409
410 Update the password root server MySQL (by default, unprotected access to databases)
411 In a Terminal window:
412 sudo password mysqladmin Koha
413
414 3.3 Creation of a database MySQL test
415
416 The basic test is immediately under Fedora. We must remove the existing basic
417 test and then create a basic test MySQL provisional, which will be deleted
418 after installing koha.
419
420 mysql-u root-p
421 Enter password: kohakoha (eg)
422
423 mysql> drop test database;
424 Query OK, 0 rows affected (0.06 sec)
425
426 mysql> create database test;
427 Query OK, 1 row affected (0.00 sec)
428
429 mysql> grant all on test .* to 'test' @ 'localhost' identified by 'test';
430 Query OK, 0 rows affected (0.00 sec)
431
432 MySQL> flush privileges;
433 Query OK, 0 rows affected (0.00 sec)
434
435 MySQL> quit
436 Bye
437
438
439 3.4 Creation of the MySQL database koha
440
441 Creation of the database, a user kohaadmin with password and defining its
442 privileges.
443
444 In a Terminal window:
445 mysql-u root-p
446 Enter password: type kohakoha (eg a password for root)
447 Create Database Koha;
448 grant all on koha .* to 'kohaadmin' @ 'localhost' identified by 'kohakoha';
449 flush privileges;
450 quit;
451
452 3.5 Configuration CPAN
453
454 The koha software is written in Perl. You have access to deposits modules
455 written in perl (CPAN) to download some libraries on your system. The Perl
456 language of origin is installed on most Linux distributions, but some modules
457 must be installed.
458 During the first use of cpan, you must configure.
459
460 Open a terminal window and type the command cpan
461
462 During the installation of modules, validate the additions of modules when
463 necessary. Indicate the continent and the country. Select 3 or 4 CPAN deposits
464 in the proposed list.
465
466 It is possible to force the installation of a module. In this case, in a
467 Terminal window, type:
468
469 cpan
470 then force install NomDuModule
471 then quit
472
473 ******************************************************************
474 Screenshot:
475 /usr/lib/perl5/5.8.8/CPAN/Config.pm initialized.
476
477
478 CPAN is the world-wide archive of perl resources. It consists of about
479 100 sites that all replicate the same contents all around the globe.
480 Many countries have at least one CPAN site already. The resources
481 found on CPAN are easily accessible with the CPAN.pm module. If you
482 want to use CPAN.pm, you have to configure it properly.
483
484 If you do not want to enter a dialog now, you can answer 'no' to this
485 question and I'll try to autoconfigure. (Note: you can revisit this
486 dialog anytime later by typing 'o conf init' at the cpan prompt.)
487
488 Are you ready for manual configuration? [yes]
489
490
491 The following questions are intended to help you with the
492 configuration. The CPAN module needs a directory of its own to cache
493 important index files and maybe keep a temporary mirror of CPAN files.
494 This may be a site-wide directory or a personal directory.
495
496
497
498 First of all, I'd like to create this directory. Where?
499
500 CPAN build and cache directory? [/ root/.cpan]
501
502
503 If you want, I can keep the source files after a build in the cpan
504 Home directory. If you choose so then future builds will take the
505 files from there. If you do not want to keep them, answer to the 0
506 Next question.
507
508
509
510 How big should the disk cache be for keeping the build directories
511 with all the intermediate files?
512
513 Cache size for build directory (in MB)? [10]
514
515
516 By default, each time the CPAN module is started, scanning cache
517 is performed to keep the cache size in sync. To prevent from this,
518 disable the cache scanning with 'never'.
519
520 Perform cache scanning (atstart or never)? [atstart]
521
522
523 To considerably speed up the initial CPAN shell startup, it is
524 Storable possible to use to create a cache of metadata. If Storable
525 is not available, the normal index mechanism will be used.
526
527 Cache metadata (yes/no)? [yes]
528
529
530 The next option deals with the charset your terminal supports. In
531 general CPAN is English speaking territory, thus the charset does not
532 matter much, but some of the aliens out there who upload their
533 software to CPAN bear names that are outside the ASCII range. If your
534 terminal supports UTF-8, you say no to the next question, if it
535 supports ISO-8859-1 (also known as LATIN1) then you say yes, and if it
536 neither supports nor, your answer does not matter, you will not be
537 able to read the names of some authors anyway. If you answer no, names
538 will be output in UTF-8.
539 Your terminal expects iso-8859-1 (yes/no) [yes]
540
541 If you have one of the readline packages (Term: ReadLine: Perl,
542 Term: ReadLine: Gnu, possibly others) installed, the interactive CPAN
543 Shell will have history support. The next two questions deal with the
544 filename of the history file and with its size. If you do not want to
545 set this variable, please hit SPACE RETURN to the following question.
546
547 File to save your history? [/root/.cpan/histfile]
548 Number of lines to save? [100]
549
550
551 The CPAN module can detect when a module that which you are trying to
552 build depends on prerequisites. If this happens, it can build the
553 prerequisites for you automatically ('follow'), ask you for
554 confirmation ('ask'), or just ignore them ('ignore'). Please set your
555 policy to one of the three values.
556
557 Policy on building prerequisites (follow, ask or ignore)? [ask]
558
559
560 The CPAN module will need a few external programs to work properly.
561 Please correct me, if I guess the wrong path for a program. Do not
562 panic if you do not have some of them, just press ENTER for those. To
563 disable the use of a download program, you can type a space followed
564 by ENTER.
565
566
567 Where is your gzip program?          [/bin/gzip]
568 Where is your tar program?           [/bin/tar]
569 Where is your unzip program?         [/usr/bin/unzip]
570 Where is your make program?          [/usr/bin/make]
571 Where is your links program?         [/usr/bin/links]
572 Where is your wget program?          [/usr/bin/wget]
573 Where is your ncftpget program?      [/usr/bin/ncftpget]
574 Where is your ftp program?           [/usr/bin/ftp]
575 Where is your gpg program?           [/usr/bin/gpg]
576 What is your favorite pager program? [/usr/bin/less]
577 What is your favorite shell?         [/bin/bash]
578
579
580 Every Makefile.PL is run by perl in a separate process. Likewise we
581 run 'make' and 'make install' in processes. If you have any
582 parameters (eg PREFIX, LIB, UNINST or the like) you want to pass
583 to the calls, please specify them here.
584
585 If you do not understand this question, just press ENTER.
586
587 Parameters for the 'perl Makefile.PL' command?
588 Typical frequently used settings:
589
590      PREFIX = ~/perl non-root users (please see manual for more hints)
591
592
593 Every Makefile.PL is run by perl in a separate process. Likewise we
594 run 'make' and 'make install' in processes. If you have any
595 parameters (eg PREFIX, LIB, UNINST or the like) you want to pass
596 to the calls, please specify them here.
597
598 If you do not understand this question, just press ENTER.
599
600 Parameters for the 'perl Makefile.PL' command?
601 Typical frequently used settings:
602
603      PREFIX = ~/perl non-root users (please see manual for more hints)
604
605 Your choice: []
606 Parameters for the 'make' command?
607 Typical frequently used setting:
608
609      J3 dual-processor system
610
611 Your choice: []
612 Parameters for the 'make install' command?
613 Typical frequently used setting:
614
615      UNINST = 1 to always uninstall potentially conflicting files
616
617 Your choice: []
618
619
620 Sometimes you may wish to leave the processes run by CPAN alone
621 without caring about them. As sometimes contains the Makefile.PL
622 question you're expected to answer, you can set a timer that will
623 kill a 'perl Makefile.PL' process after the specified time in seconds.
624
625 If you set this value to 0, these processes will wait forever. This is
626 the default and recommended setting.
627
628
629 Timeout for inactivity during Makefile.PL? [0]
630
631
632 If you're accessing the net via proxies, you can specify them in the
633 CPAN configuration or via environment variables. The variable in
634 the $ CPAN:: Config takes precedence.
635
636 Your ftp_proxy?
637 Your http_proxy?
638 Your no_proxy?
639 You have no/root/.cpan/sources/MIRRORED.BY
640    I'm trying to fetch one
641 CPAN: LWP:: UserAgent loaded ok
642 Fetching with LWP:
643    ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY
644 Fetching with LWP:
645    ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY.gz
646 Fetching with Net: FTP:
647    ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY
648
649
650 Now we need to know where your favorite CPAN sites are located. Push
651 a few sites onto the array (just in case the first on the array will not
652 work). If you are mirroring CPAN to your local workstation, specify a
653 file: URL.
654
655 First, pick a nearby continent and country (you can pick several of
656 each, separated by spaces, or none if you just want to keep your
657 existing selections). Then, you will be presented with a list of URLs
658 CPAN of mirrors in the countries you selected, along with previously
659 selected URLs. Select some of those URLs, or just keep the old list.
660 Finally, you will be prompted for any extra URLs - file:, ftp:, or
661 http:-- that host a CPAN mirror.
662
663 (1) Africa
664 (2) Asia
665 (3) Central America
666 (4) Europe
667 (5) North America
668 (6) Oceania
669 (7) South America
670 Select your continent (or several nearby continents) [] 4
671 Sorry! since you do not have any existing picks, you must make a
672 Geographic selection.
673
674 (1) Austria
675 (2) Belgium
676 (3) Bosnia and Herzegovina
677 (4) Bulgaria
678 (5) Croatia
679 (6) Czech Republic
680 (7) Denmark
681 (8) Finland
682 (9) France
683 (10) Germany
684 (11) Greece
685 (12) Hungary
686 (13) Iceland
687 (14) Ireland
688 (15) Italy
689 (16) Latvia
690 15 more items, hit SPACE RETURN to show them
691 Select your country (or several nearby countries) [] 9
692 Sorry! since you do not have any existing picks, you must make a
693 Geographic selection.
694
695 (1) ftp://cpan.cict.fr/pub/CPAN/
696 (2) ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
697 (3) ftp://distrib-coffee.ipsl.jussieu.fr/pub/mirrors/cpan/
698 (4) ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/
699 (5) ftp://ftp.erasme.org/pub/CPAN/
700 (6) ftp://ftp.inria.fr/pub/CPAN/
701 (7) ftp://ftp.oleane.net/pub/CPAN/
702 (8) ftp://ftp.pasteur.fr/pub/computing/CPAN/
703 (9) ftp://ftp.u-strasbg.fr/CPAN
704 (10) ftp://mir1.ovh.net/ftp.cpan.org
705 (11) ftp://miroir-francais.fr/pub/cpan/
706 (12) http://cpan.ebsd.net/
707 (13) http://cpan.enstimac.fr/
708 (14) http://cpan.univ-paris.com
709 Select URLs as many as you like (by number),
710 put them on one line, separated by blanks, e.g. '1 4 5 [] 1 2 4 10
711
712 Enter another URL or RETURN to quit: []
713 New set of picks:
714    ftp://cpan.cict.fr/pub/CPAN/
715    ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
716    ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/
717    ftp://mir1.ovh.net/ftp.cpan.org
718
719
720 commit: wrote /usr/lib/perl5/5.8.8/CPAN/Config.pm
721 Terminal does not support AddHistory.
722
723 cpan shell - CPAN exploration and modules installation (v1.7602)
724 ReadLine support available (try 'install Bundle: CPAN')
725
726 cpan> quit
727 ************************************************** ****************
728
729 Type quit to break cpan
730
731
732
733 3.6 Installation of additional modules from CPAN
734
735 3.6.1 modules installation
736
737 Install Command: cpan NomDuModule to install and validate the default
738 choice for each question.
739
740 List of modules required to koha need to install:
741 Class::Accessor
742 XML::SAX
743 XML::RSS
744 XML::LibXML::SAX
745 MARC::Record
746 MARC::Charset
747 MARC::Charset::Constants
748 MARC::File::XML
749 Net::Z3950::ZOOM
750 Net::LDAP::Filter
751 HTML::Template::Pro
752 Data::ICal
753 DateTime
754 DateTime::Format::ICal
755 GD::Barcode::UPCE
756 Algorithm::CheckDigits::M43_001
757 Biblio::EndnoteStyle
758 Schedule::At
759 Barcode::Code128
760 CGI::Session
761 Class::Factory::Util
762 Date::Manip
763 Lingua::Stem
764 List::MoreUtils
765 PDF::Reuse
766 PDF::Reuse::Barcode
767 PDF::API2
768 PDF::API2::Util
769 Text::CSV
770 Text::CSV_XS
771 XML::Dumper
772 XML::LibXSLT
773 XML::Simple
774 YAML::Syck
775 Unix::Syslog
776 Date::Calc
777 CHI
778 CHI::Driver::Memcached
779
780
781 3.6.2 Installation of modules - Cases difficult
782
783 In some cases, we must force the installation of modules. The two
784 modules (and sometimes others) need to force the installation.
785 Type the command cpan, then:
786
787 force install Mail: Sendmail ======= force install ok For this unit
788 should be Ctrl + C, when he attempted to send an e-mail.
789 force install Net:: LDAP ======= force install ok
790
791
792
793 3.6.3 Installing module access MySQL DBMS
794
795 Installation of the connector DBD::mysql for perl
796
797 We will have to rebuild this module because koha requires the latest version.
798
799 In a window Terminal:
800 cpan
801 cpan> o conf makepl_arg
802      (search parameters for the CPAN)
803
804 cpan> o conf makepl_arg "- testdb = test - testuser = test - testpass = test"
805
806 cpan> install DBD:: mysql
807
808 cpan> o conf makepl_arg''
809      (clean to avoid interference with future installations modules).
810
811 cpan> quit
812
813
814 Destruction of the basis of test MySQL
815
816 In a terminal window
817 mysql-u root-p
818 Enter password: kohakoha
819 Database drop test;
820 quit
821
822
823 3.7 Test SAX Parser
824
825 In a Terminal window, go to the installation directory koha.
826 CD /usr/share/koha-3.00.00-alpha/misc
827 launch the script sax_parser_print.pl
828 ./sax_parser_print.pl
829 which returns: XML::LibXML::SAX = HASH (0x895a3fc)
830
831 The file /usr/lib/perl5/site_perl/5.8.8/XML/SAX/ParserDetails.ini should be amended to
832 contain the final (save the other lines to comment or delete):
833 [XML::LibXML::SAX::Parser]
834 Http://xml.org/sax/features/namespaces = 1
835
836
837 3.8 Installation of Koha
838
839 Opening a window Terminal and placed in the directory koha
840 CD /usr/share/koha-3.00.00-alpha
841 launch the script Makefile.PL
842 perl Makefile.PL
843
844 Most options are to be validated by default. The data to information are
845 password based koha, format Marc (Marc21 or Unimarc), language indexing
846 Zebra (or en). It should be noted that the three ports will be open:
847 3306, 9998, 9999.
848
849 ************************************************** ****************
850 Screenshot
851 By default, Koha can be installed in one of three ways:
852
853 Standard: Install files in conformance with the Filesystem
854            Hierarchy Standard (FHS). This is the default mode
855            and should be used when installing a production
856            Koha system. On Unix systems, root access is
857            needed to complete a standard installation.
858
859 single: Install files under a single directory. This option
860            is useful for installing Koha without root access, eg,
861            on a web host that allows CGI scripts and MySQL databases
862            but requires the user to keep all files under the user's
863            HOME directory.
864
865 dev: Create a set of symbolic links and configuration files to
866            Koha allow to run directly from the source distribution.
867            This mode is useful for developers who want to run
868            Koha from a git clone.
869
870 Installation mode (dev, single, standard) [standard]
871
872 Please specify the directory under which most Koha files
873 will be installed.
874
875 Note that if you are planning in installing more than
876 one instance of Koha, you may want to modify the last
877 component of the directory path, which will be used
878 as the package name in the FHS layout.
879
880 Base installation directory [/usr/share/koha]
881
882 Since you are using the 'standard' install
883 mode, you should run 'make install' as root.
884 However, it is recommended that a non-root
885 user (on Unix and Linux platforms) have
886 ownership of Koha's files, including the
887 Zebra indexes if applicable.
888
889 Please specify a user account. This
890 user account does not need to exist
891 right now, but it needs to exist
892 before you run 'make install'. Please
893 note that for security reasons, this
894 user should not be the same as the user
895 account Apache runs under.
896
897 User account [koha]
898
899 Please specify the group that should own
900 Koha's files. As above, this group need
901 not exist right now, but should be created
902 before you run 'make install'.
903
904 Group [koha]
905
906 Please specify which database engine you will use
907 to store data in Koha. The choices are MySQL and
908 PostgreSQL; please note that at the moment
909 PostgreSQL support is highly experimental.
910
911 DBMS to use (Pg, mysql) [mysql]
912
913 Please specify the name or address of your
914 database server. Note that the database
915 does not have to exist at this point, it
916 can be created after running 'make install'
917 and before you try using Koha for the first time.
918
919 Database server [localhost]
920
921 Please specify the port used to connect to the
922 DMBS [3306]
923
924 Please specify the name of the database to be
925 used by Koha [koha]
926
927 Please specify the user that owns the database to be
928 used by Koha [kohaadmin]
929
930 Please specify the password of the user that owns the
931 database to be used by Koha [katikoan] kohakoha
932
933 Koha can use the Zebra search engine for high-performance
934 searching of bibliographic and authority records. If you
935 have installed the Zebra software and would like to use it,
936 please answer 'yes' to the following question. Otherwise,
937 Koha will default to using its internal search engine.
938
939 Please note that if you choose *NOT* to install Zebra,
940 koha-conf.xml will still contain some references to Zebra
941 settings. Those references will be ignored by Koha.
942
943
944 Install the Zebra configuration files? (no, yes) [yes]
945
946 Since you've chosen to use Zebra with Koha,
947 you must specify the primary MARC format of the
948 records to be indexed by Zebra.
949
950 Koha provides Zebra configuration files for MARC 21
951 and UNIMARC.
952
953 MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
954
955 Koha supplies Zebra configuration files tuned for
956 searching either English (en) or French (fr) MARC
957 records.
958
959
960 Primary language for Zebra indexing (en, fr) [en] fr
961
962 Please specify Zebra database user [kohauser]
963
964 Please specify the Zebra database password [zebrastripes]
965
966 Since you've chosen to use Zebra, you can enable the SRU/
967 Z39.50 Server if you so choose, but you must specify a
968 few configuration options for it.
969
970 Please note that if you choose *NOT* to configure SRU,
971 koha-conf.xml will still contain some references to SRU
972 settings. Those references will be ignored by Koha.
973
974
975 Install the SRU configuration files? (no, yes) [yes]
976
977 SRU Database host? [localhost]
978
979 SRU port for bibliographic data? [9998]
980
981 SRU port for authority data? [9999]
982
983
984
985
986 Koha will be installed with the following configuration parameters:
987
988 DB_HOST localhost
989 DB_NAME koha
990 DB_PASS koha
991 DB_PORT 3306
992 DB_TYPE mysql
993 DB_USER kohaadmin
994 INSTALL_BASE /usr/share/koha
995 INSTALL_MODE standard
996 INSTALL_SRU yes
997 INSTALL_ZEBRA yes
998 KOHA_GROUP koha
999 KOHA_USER koha
1000 ZEBRA_LANGUAGE fr
1001 ZEBRA_MARC_FORMAT unimarc
1002 ZEBRA_PASS zebrastripes
1003 ZEBRA_SRU_AUTHORITIES_POR9999
1004 ZEBRA_SRU_BIBLIOS_PORT 9998
1005 ZEBRA_SRU_HOST localhost
1006 ZEBRA_USER kohauser
1007
1008 and in the following directories:
1009
1010 DOC_DIR /usr/share/koha/doc
1011 INTRANET_CGI_DIR /usr/share/koha/intranet/cgi-bin
1012 INTRANET_TMPL_DIR /usr/share/koha/intranet/htdocs/intranet-tmpl
1013 INTRANET_WWW_DIR /usr/share/koha/intranet/htdocs
1014 KOHA_CONF_DIR /etc/koha
1015 LOG_DIR /var/log/koha
1016 MAN_DIR /usr/share/koha/man
1017 MISC_DIR /usr/share/koha/misc
1018 OPAC_CGI_DIR /usr/share/koha/opac/cgi-bin
1019 OPAC_TMPL_DIR /usr/share/koha/opac/htdocs/opac-tmpl
1020 OPAC_WWW_DIR /usr/share/koha/opac/htdocs
1021 PERL_MODULE_DIR /usr/share/koha/lib
1022 SCRIPT_DIR /usr/share/koha/bin
1023 ZEBRA_CONF_DIR /etc/koha/zebradb
1024 ZEBRA_DATA_DIR /var/lib/koha/zebradb
1025 ZEBRA_LOCK_DIR /var/lock/koha/zebradb
1026 ZEBRA_RUN_DIR /var/run/koha/zebradb
1027
1028
1029 To change any configuration setting, please run
1030 perl Makefile.PL again. To override one of the target
1031 directories, you can do so on the command line like this:
1032
1033 perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
1034
1035 You can also set different default values for parameters
1036 or override directory locations by using environment variables.
1037
1038 For example:
1039
1040 export DB_USER=my_koha
1041 perl Makefile.PL
1042
1043 or
1044
1045 DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
1046
1047 Checking if your kit is complete...
1048 Looks good
1049 Writing Makefile for koha
1050 ************************************************** ****************
1051
1052 Taper la commande make
1053
1054 Taper la commande make test (ne pas tenir compte des erreurs listées)
1055
1056 Taper la commande make install
1057
1058
1059
1060 4 CONFIGURATION POST INSTALLATION
1061
1062 .1 Saving environment variables
1063
1064 As indicated at the end of the installation (see screen shot), we must add two environment variables:
1065
1066 Entering the two lines below a window in Terminal:
1067 export KOHA_CONF=/etc/koha/koha-conf.xml
1068 export PERL5LIB=/usr/share/koha/lib
1069
1070 Seizures of this event, both variables are recorded on a temporary basis. If these variables are definitely enr
1071 egistrées we must add these two lines in the file. bash_profile or. bashrc users root and koha.
1072
1073
1074 4.2 Creation of the database
1075 The base is not created. It is a bug, we must launch a script to recreate it. In a Terminal window, type:
1076 mysql -user=kohaadmin -password=kohakoha koha </usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql;
1077
1078 Explanation:
1079 mysql è launches client mysql
1080 -- user = kohaadmin è behalf of the user base
1081 -- password = kohakoha è password for this user
1082 koha è the name of the database
1083 <È means setting the result of a script (here, the base koha)
1084 /usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql è address sql script to execute
1085 Do not forget the sign at the end of the investigation.
1086
1087 To check if the base is well rebuilt: mysql-u-p kohaadmin
1088 Enter password: kohakoha
1089
1090
1091 ******************************************************************
1092 Screenshot
1093 Welcome to the MySQL monitor. Commands end with; or \g.
1094 Your MySQL connection id is 51
1095 Server version: 5.0.45 Source distribution
1096
1097 Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
1098
1099 MySQL> use Koha;
1100 Reading table information for completion of table and column names
1101 You can turn off this feature to get a quicker startup with A -
1102
1103 Database changed
1104 MySQL> show tables;
1105 +----------------------------+
1106 | Tables_in_koha |
1107 +----------------------------+
1108 | accountlines |
1109 | accountoffsets |
1110 | action_logs |
1111 | alert |
1112 | aqbasket |
1113 | aqbookfund |
1114 | aqbooksellers |
1115 | aqbudget |
1116 | aqorderbreakdown |
1117 | aqorderdelivery |
1118 | aqorders |
1119 | auth_header |
1120 | auth_subfield_structure |
1121 | auth_tag_structure |
1122 | auth_types |
1123 | authorised_values |
1124 | biblio |
1125 | biblio_framework |
1126 | biblioitems |
1127 | borrowers |
1128 | branchcategories |
1129 | branches |
1130 | branchrelations |
1131 | branchtransfers |
1132 | browser |
1133 | categories |
1134 | cities |
1135 | class_sort_rules |
1136 | class_sources |
1137 | currency |
1138 | deletedbiblio |
1139 | deletedbiblioitems |
1140 | deletedborrowers |
1141 | deleteditems |
1142 | ethnicity |
1143 | import_batches |
1144 | import_biblios |
1145 | import_items |
1146 | import_record_matches |
1147 | import_records |
1148 | issues |
1149 | issuingrules |
1150 | items |
1151 | itemtypes |
1152 | labels |
1153 | labels_conf |
1154 | labels_templates |
1155 | language_descriptions |
1156 | language_rfc4646_to_iso639 |
1157 | language_script_bidi |
1158 | language_script_mapping |
1159 | language_subtag_registry |
1160 | letter |
1161 | marc_matchers |
1162 | marc_subfield_structure |
1163 | marc_tag_structure |
1164 | matchchecks |
1165 | matcher_matchpoints |
1166 | matchpoint_component_norms |
1167 | matchpoint_components |
1168 | matchpoints |
1169 | notifys |
1170 | opac_news |
1171 | overduerules |
1172 | printers |
1173 | repeatable_holidays |
1174 | reports_dictionary |
1175 | reserves |
1176 | reviews |
1177 | roadtype |
1178 | saved_reports |
1179 | saved_sql |
1180 | serial |
1181 | services_throttle |
1182 | sessions |
1183 | special_holidays |
1184 | statistics |
1185 | subscription |
1186 | subscriptionhistory |
1187 | subscriptionroutinglist |
1188 | suggestions |
1189 | systempreferences |
1190 | tags |
1191 | userflags |
1192 | virtualshelfcontents |
1193 | virtualshelves |
1194 | z3950servers |
1195 | zebraqueue |
1196 +----------------------------+
1197 93 rows in set (0.00 sec)
1198
1199 mysql> quit
1200 ******************************************************************
1201
1202 4.3 Changing the configuration of the Apache server
1203
1204 Create a link koha in the directory /etc/httpd/conf.d/ pointing to the configuration file of koha for apache.
1205 Open /etc/koha/koha-httpd.conf and paste the contents of this file at the end of /etc/httpd/conf/httpd.conf
1206
1207 Editing httpd.conf located in the directory /etc/httpd/conf, so the Apache web server is reachable on port 8
1208 0 (standard) and also on port 8080.
1209 Find string Listen 80 and add a new line below with the string Listen 8080
1210 Restarting the service httpd. On a Terminal window, type service httpd restart.
1211
1212 Lancer Zebra Server
1213 zebrasrv east /usr/bin
1214 with the name zebrasrv-2.0
1215 go to the directory /usr/bin
1216 cd /usr/bin
1217 koha become user by typing the command su:
1218 su Koha
1219 zebra start the server by the command:
1220 ./zebrasrv-2.0-f /etc/koha/koha-conf.xml
1221
1222 Starting the daemon Zebraqueue
1223 zebraqueue_daemon.pl is in /usr/share/koha/bin
1224 go in /usr/share/koha/bin
1225 cd /usr/share/koha/bin
1226 and launch the script zebraqueue_daemon.pl
1227 . /zebraqueue_daemon.pl
1228
1229
1230 4.4 loading data for tests
1231
1232 This step helps to have some input in Koha for testing purposes (table cataloguing default, etc.).
1233
1234 Disable temporarily SElinux
1235 SE-LINUX blocking access to KOHA.
1236 Menu K Hotel è è SElinux
1237 Then turn off Selinux and relaunch the service iptables
1238
1239 Unlocking ports
1240 It must grant access to ports 3306, 9998 and 9999
1241 Menu K Hotel è è Firewall and SElinux
1242 Other ports and click Add button.
1243 When the 3 ports are added, click Apply, then click the button.
1244
1245 Using the Web installer
1246 We must move the fr located in /usr/share/koha/intranet/cgi-bin/data/mysql en-US (installer points to the directory
1247 en-ing and not en).
1248
1249 Connect to Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080 and use the Web installer french (en-US).
1250
1251 -- Validate Step 1 (dependencies);
1252 -- Step 2 (settings of the database on two screens);
1253 -- A Phase 3, click on Install the basic settings (screen 1), select the declination Marc (Unimarc_complet in our
1254 Where Unimarc_lecture_pub; screen 2), select default settings and then click on Import (only settings obligat
1255 oires are checked by default; screen 3);
1256 -- The screen 4 summarizes what has been imported;
1257 -- Finally, the screen 5 indicates the end of the installation; then you just have to click Finish.
1258
1259 Complements
1260 Connect to PhPMyadmin: HYPERLINK "http://localhost/phpmyadmin" http://localhost/phpmyadmin
1261 Connect to interface professional Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080
1262 Connect to online catalogue Koha: HYPERLINK "http://localhost:80/" http://localhost:80
1263
1264 Zebra is in /etc/koha
1265 The files perl Koha professional can be found in /usr/share/koha/intranet/cgi-bin (then a large repertoire by fonctionnal
1266 ities of SIGB)
1267 The files perl Koha public are in /usr/share/koha/koha/cgi-bin