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