Bug 10606: Remove MySQLism in GetUpcomingDueIssues
[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 MARC::Crosswalk::DublinCore
750 Net::Z3950::ZOOM
751 Net::LDAP::Filter
752 HTML::Template::Pro
753 Data::ICal
754 DateTime
755 DateTime::Format::ICal
756 GD::Barcode::UPCE
757 Algorithm::CheckDigits::M43_001
758 Biblio::EndnoteStyle
759 Schedule::At
760 Barcode::Code128
761 CGI::Session
762 Class::Factory::Util
763 Date::Manip
764 Lingua::Stem
765 List::MoreUtils
766 PDF::Reuse
767 PDF::Reuse::Barcode
768 PDF::API2
769 PDF::API2::Util
770 Text::CSV
771 Text::CSV_XS
772 XML::Dumper
773 XML::LibXSLT
774 XML::Simple
775 YAML::Syck
776 Unix::Syslog
777 Date::Calc
778 CHI
779 CHI::Driver::Memcached
780
781
782 3.6.2 Installation of modules - Cases difficult
783
784 In some cases, we must force the installation of modules. The two
785 modules (and sometimes others) need to force the installation.
786 Type the command cpan, then:
787
788 force install Mail: Sendmail ======= force install ok For this unit
789 should be Ctrl + C, when he attempted to send an e-mail.
790 force install Net:: LDAP ======= force install ok
791
792
793
794 3.6.3 Installing module access MySQL DBMS
795
796 Installation of the connector DBD::mysql for perl
797
798 We will have to rebuild this module because koha requires the latest version.
799
800 In a window Terminal:
801 cpan
802 cpan> o conf makepl_arg
803      (search parameters for the CPAN)
804
805 cpan> o conf makepl_arg "- testdb = test - testuser = test - testpass = test"
806
807 cpan> install DBD:: mysql
808
809 cpan> o conf makepl_arg''
810      (clean to avoid interference with future installations modules).
811
812 cpan> quit
813
814
815 Destruction of the basis of test MySQL
816
817 In a terminal window
818 mysql-u root-p
819 Enter password: kohakoha
820 Database drop test;
821 quit
822
823
824 3.7 Test SAX Parser
825
826 In a Terminal window, go to the installation directory koha.
827 CD /usr/share/koha-3.00.00-alpha/misc
828 launch the script sax_parser_print.pl
829 ./sax_parser_print.pl
830 which returns: XML::LibXML::SAX = HASH (0x895a3fc)
831
832 The file /usr/lib/perl5/site_perl/5.8.8/XML/SAX/ParserDetails.ini should be amended to
833 contain the final (save the other lines to comment or delete):
834 [XML::LibXML::SAX::Parser]
835 Http://xml.org/sax/features/namespaces = 1
836
837
838 3.8 Installation of Koha
839
840 Opening a window Terminal and placed in the directory koha
841 CD /usr/share/koha-3.00.00-alpha
842 launch the script Makefile.PL
843 perl Makefile.PL
844
845 Most options are to be validated by default. The data to information are
846 password based koha, format Marc (Marc21 or Unimarc), language indexing
847 Zebra (or en). It should be noted that the three ports will be open:
848 3306, 9998, 9999.
849
850 ************************************************** ****************
851 Screenshot
852 By default, Koha can be installed in one of three ways:
853
854 Standard: Install files in conformance with the Filesystem
855            Hierarchy Standard (FHS). This is the default mode
856            and should be used when installing a production
857            Koha system. On Unix systems, root access is
858            needed to complete a standard installation.
859
860 single: Install files under a single directory. This option
861            is useful for installing Koha without root access, eg,
862            on a web host that allows CGI scripts and MySQL databases
863            but requires the user to keep all files under the user's
864            HOME directory.
865
866 dev: Create a set of symbolic links and configuration files to
867            Koha allow to run directly from the source distribution.
868            This mode is useful for developers who want to run
869            Koha from a git clone.
870
871 Installation mode (dev, single, standard) [standard]
872
873 Please specify the directory under which most Koha files
874 will be installed.
875
876 Note that if you are planning in installing more than
877 one instance of Koha, you may want to modify the last
878 component of the directory path, which will be used
879 as the package name in the FHS layout.
880
881 Base installation directory [/usr/share/koha]
882
883 Since you are using the 'standard' install
884 mode, you should run 'make install' as root.
885 However, it is recommended that a non-root
886 user (on Unix and Linux platforms) have
887 ownership of Koha's files, including the
888 Zebra indexes if applicable.
889
890 Please specify a user account. This
891 user account does not need to exist
892 right now, but it needs to exist
893 before you run 'make install'. Please
894 note that for security reasons, this
895 user should not be the same as the user
896 account Apache runs under.
897
898 User account [koha]
899
900 Please specify the group that should own
901 Koha's files. As above, this group need
902 not exist right now, but should be created
903 before you run 'make install'.
904
905 Group [koha]
906
907 Please specify which database engine you will use
908 to store data in Koha. The choices are MySQL and
909 PostgreSQL; please note that at the moment
910 PostgreSQL support is highly experimental.
911
912 DBMS to use (Pg, mysql) [mysql]
913
914 Please specify the name or address of your
915 database server. Note that the database
916 does not have to exist at this point, it
917 can be created after running 'make install'
918 and before you try using Koha for the first time.
919
920 Database server [localhost]
921
922 Please specify the port used to connect to the
923 DMBS [3306]
924
925 Please specify the name of the database to be
926 used by Koha [koha]
927
928 Please specify the user that owns the database to be
929 used by Koha [kohaadmin]
930
931 Please specify the password of the user that owns the
932 database to be used by Koha [katikoan] kohakoha
933
934 Koha can use the Zebra search engine for high-performance
935 searching of bibliographic and authority records. If you
936 have installed the Zebra software and would like to use it,
937 please answer 'yes' to the following question. Otherwise,
938 Koha will default to using its internal search engine.
939
940 Please note that if you choose *NOT* to install Zebra,
941 koha-conf.xml will still contain some references to Zebra
942 settings. Those references will be ignored by Koha.
943
944
945 Install the Zebra configuration files? (no, yes) [yes]
946
947 Since you've chosen to use Zebra with Koha,
948 you must specify the primary MARC format of the
949 records to be indexed by Zebra.
950
951 Koha provides Zebra configuration files for MARC 21
952 and UNIMARC.
953
954 MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
955
956 Koha supplies Zebra configuration files tuned for
957 searching either English (en) or French (fr) MARC
958 records.
959
960
961 Primary language for Zebra indexing (en, fr) [en] fr
962
963 Please specify Zebra database user [kohauser]
964
965 Please specify the Zebra database password [zebrastripes]
966
967 Since you've chosen to use Zebra, you can enable the SRU/
968 Z39.50 Server if you so choose, but you must specify a
969 few configuration options for it.
970
971 Please note that if you choose *NOT* to configure SRU,
972 koha-conf.xml will still contain some references to SRU
973 settings. Those references will be ignored by Koha.
974
975
976 Install the SRU configuration files? (no, yes) [yes]
977
978 SRU Database host? [localhost]
979
980 SRU port for bibliographic data? [9998]
981
982 SRU port for authority data? [9999]
983
984
985
986
987 Koha will be installed with the following configuration parameters:
988
989 DB_HOST localhost
990 DB_NAME koha
991 DB_PASS koha
992 DB_PORT 3306
993 DB_TYPE mysql
994 DB_USER kohaadmin
995 INSTALL_BASE /usr/share/koha
996 INSTALL_MODE standard
997 INSTALL_SRU yes
998 INSTALL_ZEBRA yes
999 KOHA_GROUP koha
1000 KOHA_USER koha
1001 ZEBRA_LANGUAGE fr
1002 ZEBRA_MARC_FORMAT unimarc
1003 ZEBRA_PASS zebrastripes
1004 ZEBRA_SRU_AUTHORITIES_POR9999
1005 ZEBRA_SRU_BIBLIOS_PORT 9998
1006 ZEBRA_SRU_HOST localhost
1007 ZEBRA_USER kohauser
1008
1009 and in the following directories:
1010
1011 DOC_DIR /usr/share/koha/doc
1012 INTRANET_CGI_DIR /usr/share/koha/intranet/cgi-bin
1013 INTRANET_TMPL_DIR /usr/share/koha/intranet/htdocs/intranet-tmpl
1014 INTRANET_WWW_DIR /usr/share/koha/intranet/htdocs
1015 KOHA_CONF_DIR /etc/koha
1016 LOG_DIR /var/log/koha
1017 MAN_DIR /usr/share/koha/man
1018 MISC_DIR /usr/share/koha/misc
1019 OPAC_CGI_DIR /usr/share/koha/opac/cgi-bin
1020 OPAC_TMPL_DIR /usr/share/koha/opac/htdocs/opac-tmpl
1021 OPAC_WWW_DIR /usr/share/koha/opac/htdocs
1022 PERL_MODULE_DIR /usr/share/koha/lib
1023 SCRIPT_DIR /usr/share/koha/bin
1024 ZEBRA_CONF_DIR /etc/koha/zebradb
1025 ZEBRA_DATA_DIR /var/lib/koha/zebradb
1026 ZEBRA_LOCK_DIR /var/lock/koha/zebradb
1027 ZEBRA_RUN_DIR /var/run/koha/zebradb
1028
1029
1030 To change any configuration setting, please run
1031 perl Makefile.PL again. To override one of the target
1032 directories, you can do so on the command line like this:
1033
1034 perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
1035
1036 You can also set different default values for parameters
1037 or override directory locations by using environment variables.
1038
1039 For example:
1040
1041 export DB_USER=my_koha
1042 perl Makefile.PL
1043
1044 or
1045
1046 DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
1047
1048 Checking if your kit is complete...
1049 Looks good
1050 Writing Makefile for koha
1051 ************************************************** ****************
1052
1053 Taper la commande make
1054
1055 Taper la commande make test (ne pas tenir compte des erreurs listées)
1056
1057 Taper la commande make install
1058
1059
1060
1061 4 CONFIGURATION POST INSTALLATION
1062
1063 .1 Saving environment variables
1064
1065 As indicated at the end of the installation (see screen shot), we must add two environment variables:
1066
1067 Entering the two lines below a window in Terminal:
1068 export KOHA_CONF=/etc/koha/koha-conf.xml
1069 export PERL5LIB=/usr/share/koha/lib
1070
1071 Seizures of this event, both variables are recorded on a temporary basis. If these variables are definitely enr
1072 egistrées we must add these two lines in the file. bash_profile or. bashrc users root and koha.
1073
1074
1075 4.2 Creation of the database
1076 The base is not created. It is a bug, we must launch a script to recreate it. In a Terminal window, type:
1077 mysql -user=kohaadmin -password=kohakoha koha </usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql;
1078
1079 Explanation:
1080 mysql è launches client mysql
1081 -- user = kohaadmin è behalf of the user base
1082 -- password = kohakoha è password for this user
1083 koha è the name of the database
1084 <È means setting the result of a script (here, the base koha)
1085 /usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql è address sql script to execute
1086 Do not forget the sign at the end of the investigation.
1087
1088 To check if the base is well rebuilt: mysql-u-p kohaadmin
1089 Enter password: kohakoha
1090
1091
1092 ******************************************************************
1093 Screenshot
1094 Welcome to the MySQL monitor. Commands end with; or \g.
1095 Your MySQL connection id is 51
1096 Server version: 5.0.45 Source distribution
1097
1098 Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
1099
1100 MySQL> use Koha;
1101 Reading table information for completion of table and column names
1102 You can turn off this feature to get a quicker startup with A -
1103
1104 Database changed
1105 MySQL> show tables;
1106 +----------------------------+
1107 | Tables_in_koha |
1108 +----------------------------+
1109 | accountlines |
1110 | accountoffsets |
1111 | action_logs |
1112 | alert |
1113 | aqbasket |
1114 | aqbookfund |
1115 | aqbooksellers |
1116 | aqbudget |
1117 | aqorderbreakdown |
1118 | aqorderdelivery |
1119 | aqorders |
1120 | auth_header |
1121 | auth_subfield_structure |
1122 | auth_tag_structure |
1123 | auth_types |
1124 | authorised_values |
1125 | biblio |
1126 | biblio_framework |
1127 | biblioitems |
1128 | borrowers |
1129 | branchcategories |
1130 | branches |
1131 | branchrelations |
1132 | branchtransfers |
1133 | browser |
1134 | categories |
1135 | cities |
1136 | class_sort_rules |
1137 | class_sources |
1138 | currency |
1139 | deletedbiblio |
1140 | deletedbiblioitems |
1141 | deletedborrowers |
1142 | deleteditems |
1143 | ethnicity |
1144 | import_batches |
1145 | import_biblios |
1146 | import_items |
1147 | import_record_matches |
1148 | import_records |
1149 | issues |
1150 | issuingrules |
1151 | items |
1152 | itemtypes |
1153 | labels |
1154 | labels_conf |
1155 | labels_templates |
1156 | language_descriptions |
1157 | language_rfc4646_to_iso639 |
1158 | language_script_bidi |
1159 | language_script_mapping |
1160 | language_subtag_registry |
1161 | letter |
1162 | marc_matchers |
1163 | marc_subfield_structure |
1164 | marc_tag_structure |
1165 | matchchecks |
1166 | matcher_matchpoints |
1167 | matchpoint_component_norms |
1168 | matchpoint_components |
1169 | matchpoints |
1170 | notifys |
1171 | opac_news |
1172 | overduerules |
1173 | printers |
1174 | repeatable_holidays |
1175 | reports_dictionary |
1176 | reserveconstraints |
1177 | reserves |
1178 | reviews |
1179 | roadtype |
1180 | saved_reports |
1181 | saved_sql |
1182 | serial |
1183 | services_throttle |
1184 | sessions |
1185 | special_holidays |
1186 | statistics |
1187 | stopwords |
1188 | subscription |
1189 | subscriptionhistory |
1190 | subscriptionroutinglist |
1191 | suggestions |
1192 | systempreferences |
1193 | tags |
1194 | userflags |
1195 | virtualshelfcontents |
1196 | virtualshelves |
1197 | z3950servers |
1198 | zebraqueue |
1199 +----------------------------+
1200 94 rows in set (0.00 sec)
1201
1202 mysql> quit
1203 ******************************************************************
1204
1205 4.3 Changing the configuration of the Apache server
1206
1207 Create a link koha in the directory /etc/httpd/conf.d/ pointing to the configuration file of koha for apache.
1208 Open /etc/koha/koha-httpd.conf and paste the contents of this file at the end of /etc/httpd/conf/httpd.conf
1209
1210 Editing httpd.conf located in the directory /etc/httpd/conf, so the Apache web server is reachable on port 8
1211 0 (standard) and also on port 8080.
1212 Find string Listen 80 and add a new line below with the string Listen 8080
1213 Restarting the service httpd. On a Terminal window, type service httpd restart.
1214
1215 Lancer Zebra Server
1216 zebrasrv east /usr/bin
1217 with the name zebrasrv-2.0
1218 go to the directory /usr/bin
1219 cd /usr/bin
1220 koha become user by typing the command su:
1221 su Koha
1222 zebra start the server by the command:
1223 ./zebrasrv-2.0-f /etc/koha/koha-conf.xml
1224
1225 Starting the daemon Zebraqueue
1226 zebraqueue_daemon.pl is in /usr/share/koha/bin
1227 go in /usr/share/koha/bin
1228 cd /usr/share/koha/bin
1229 and launch the script zebraqueue_daemon.pl
1230 . /zebraqueue_daemon.pl
1231
1232
1233 4.4 loading data for tests
1234
1235 This step helps to have some input in Koha for testing purposes (table cataloguing default, etc.).
1236
1237 Disable temporarily SElinux
1238 SE-LINUX blocking access to KOHA.
1239 Menu K Hotel è è SElinux
1240 Then turn off Selinux and relaunch the service iptables
1241
1242 Unlocking ports
1243 It must grant access to ports 3306, 9998 and 9999
1244 Menu K Hotel è è Firewall and SElinux
1245 Other ports and click Add button.
1246 When the 3 ports are added, click Apply, then click the button.
1247
1248 Using the Web installer
1249 We must move the fr located in /usr/share/koha/intranet/cgi-bin/data/mysql en-US (installer points to the directory
1250 en-ing and not en).
1251
1252 Connect to Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080 and use the Web installer french (en-US).
1253
1254 -- Validate Step 1 (dependencies);
1255 -- Step 2 (settings of the database on two screens);
1256 -- A Phase 3, click on Install the basic settings (screen 1), select the declination Marc (Unimarc_complet in our
1257 Where Unimarc_lecture_pub; screen 2), select default settings and then click on Import (only settings obligat
1258 oires are checked by default; screen 3);
1259 -- The screen 4 summarizes what has been imported;
1260 -- Finally, the screen 5 indicates the end of the installation; then you just have to click Finish.
1261
1262 Complements
1263 Connect to PhPMyadmin: HYPERLINK "http://localhost/phpmyadmin" http://localhost/phpmyadmin
1264 Connect to interface professional Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080
1265 Connect to online catalogue Koha: HYPERLINK "http://localhost:80/" http://localhost:80
1266
1267 Zebra is in /etc/koha
1268 The files perl Koha professional can be found in /usr/share/koha/intranet/cgi-bin (then a large repertoire by fonctionnal
1269 ities of SIGB)
1270 The files perl Koha public are in /usr/share/koha/koha/cgi-bin