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