INSTALL.opensuse

   1 ====== Installation Guide for Installing Koha 3 on openSUSE 11 ======
   2
   3 Original version created by Ricardo Dias Marques - koha@ricmarques.net
   4
   5 No liability for the contents of this document can be accepted.
   6
   7 Feedback/bug reports: Koha Developer's List:
   8
   9 http://lists.koha.org/mailman/listinfo/koha-devel
  10
  11 This document last modified: 20 June 2008
  12
  13
  14 ===== Installation Instructions =====
  15
  16 This document was prepared in order to help you discover (or test) Koha (Integrated Library System).
  17
  18 The installation of Linux system described below is a basic, it is not designed for a production server (e.g., security, load balancing ... are not described).
  19
  20 This document describes the different stages of installing the software Koha 3 on the openSUSE 11 Linux distribution
  21 in a "new" computer, that is, a computer that will have its hard disk contents COMPLETELY ERASED to install openSUSE and Koha!
  22
  23 In this example, it's assumed that your server gets an IP address by DHCP that will be later changed to 192.168.0.2.
  24
  25 You'll have to change this to the real IP address that your machine should get (or use DHCP, if that's the case).
  26
  27 This tutorial assumes a Koha installation that does NOT use Zebra ("Zebra is a high-performance, general-purpose structured text indexing and retrieval engine" - http://www.indexdata.dk/zebra/). Additional steps would be required to set up Zebra for Koha.
  28
  29 ==== LINUX System Installation ====
  30
  31
  32 Download openSUSE 11 DVD at:
  33 http://software.opensuse.org/
  34
  35 Place the DVD in the drive and restart the machine.
  36
  37
  38 After the "Welcome" screen, you'll get a First menu, with the following options:
  39
  40 ----
  41 Boot from Hard Disk
  42
  43 Installation
  44
  45 Repair Installed System
  46
  47 Rescue System
  48
  49 Firmware Test
  50
  51 Memory Test
  52 ----
  53
  54 Choose "Installation" (second command)
  55
  56
  57 === "Initializing" screen ===
  58
  59 (Dialog box appears saying "Probing Mouse")
  60
  61
  62 === "Welcome" screen ===
  63
  64 You'll see two Dropdown Lists: "Language" and "Keyboard Layout"
  65
  66 This depends of your place and preference, naturally.
  67 I live in Portugal, so I want a Portuguese Keyboard Layout but I prefer an Operating System in English.
  68 So I leave the default option selected for "Language" (English (US))
  69 and change "Keyboard Layout" to "Portuguese".
  70
  71 Check the "I Agree to the License Terms" checkbox (under the "License Agreement" textbox).
  72
  73 Click the "Next" button.
  74
  75
  76
  77 === "System Probing" screen ===
  78
  79
  80 [just watch it...]
  81
  82
  83
  84 === "Installation Mode" screen ===
  85
  86
  87 Leave "New Installation" radio button checked
  88
  89 Click the "Next" button
  90
  91
  92 === "Initializing" screen ===
  93
  94
  95 [just watch it...]
  96
  97
  98
  99 === "Clock and Time Zone" screen ===
 100
 101
 102 Again, I live in Portugal, so I select the following options:
 103
 104 "Region" listbox: click on "Europe"
 105
 106 "Time Zone" listbox: click on "Portugal"
 107
 108 "Hardware Clock Set To" dropdown list: I leave "UTC" selected
 109
 110 Click the "Next" button
 111
 112
 113 === "Desktop Selection" screen ===
 114
 115
 116 You should see four radio buttons: "GNOME", "KDE 4.0", "KDE 3.5" and "Other".
 117
 118 Click on the "Other" radio button.
 119
 120 Three radio buttons should become visible then:
 121
 122 "XFCE Desktop"
 123
 124 "Minimal X Window"
 125
 126 "Minimal Server Selection (Text Mode)"
 127
 128 click on this last "Minimal Server Selection (Text Mode)" radio button.
 129
 130 Click the "Next" button
 131
 132
 133
 134 === "Suggested Partitioning" screen ===
 135
 136
 137 Partitioning choices are really up to you. In this example, I will create a 9 GB / ("root") partition and a 712 Swap Megs partition.
 138
 139 So, to do this I click on the "Create Partition Setup..." button.
 140
 141 === "Preparing Hard Disk: Step 1" screen ===
 142
 143
 144 I click on the first radio button:
 145 "1: 1.IDE 10.0 GB,/dev/sda"
 146
 147 I click the "Next" button
 148
 149
 150 === "Preparing Hard Disk: Step 2" screen ===
 151
 152
 153 I uncheck the "Propose separate Home Partition" checkbox.
 154
 155 I click the "Next" button.
 156
 157 This takes me back to the Suggested Partitioning screen.
 158
 159
 160 === "Suggested Partitioning" screen ===
 161
 162
 163 In my case, I now have this:
 164
 165 - Create swap partition /dev/sda1 (760.8 MB)
 166
 167 - Create root partition /dev/sda2 (9.2 GB with ext3)
 168
 169 I click the "Next" button.
 170
 171
 172 === "Create New User" screen ===
 173
 174
 175 I use this screen to create a regular user.
 176
 177 User's full name: Your Full name (e.g: John Smith)
 178
 179 Username: Your preferred username (e.g.: jsmith)
 180
 181 Password:
 182
 183 Confirm Password:
 184
 185 I uncheck the "Use this password for System Administrator" checkbox.
 186
 187 I uncheck the "Automatic Login" checkbox.
 188
 189 I click the "Next" button (you may be "nagged" with a dialog box by the YAST2 installer warning that you selected a password that it considers to be too simple. Click "Yes" to keep the password you chose, or "No" to change it).
 190
 191
 192 === "Installation Settings" screen ===
 193
 194
 195 Scroll down to the "User Settings" section and click on the "Root Password" link to change the root password.
 196
 197
 198 === Password for the System Administrator "root" screen ===
 199
 200
 201 Enter your password (in the "Password for root User" text box) and repeat it (in the "Confirm Password" text box).
 202
 203 Click the "Accept" button to return to the "Installation Settings" screen.
 204
 205
 206 === "Installation Settings" screen ===
 207
 208
 209 Click on the "Software" link
 210
 211
 212 === "Software Selection and System Tasks" screen ===
 213
 214
 215 Scroll down the listbox (that begins with the "Base Technologies" group) until you find the "Server Functions" group.
 216
 217 In that "Server Functions" group click on the "Web and LAMP Server" checkbox (to check it)
 218
 219 Click on the "OK" button to return to "Installation Settings"
 220
 221
 222
 223 === "Installation Settings" screen ===
 224
 225
 226 Click on the "Install" button (placed in the same place where usually appear the "Accept" or "Next" button).
 227
 228 You should see a "Confirm Installation" dialog box. Click on the "Install" button of that dialog box.
 229
 230
 231 === "Preparing Your Hard Disk" screen ===
 232
 233
 234 [just watch it...]
 235
 236
 237 === "Deploying Installation Images" screen ===
 238
 239
 240 [just watch it... ]
 241
 242
 243
 244 === "Package Installation" screen ===
 245
 246
 247
 248 [just watch it... or click on the "Details" tab if you want to see what packages are being installed.]
 249
 250
 251 === "Finishing Basic Installation" screen ===
 252
 253
 254 [just watch it... ]
 255
 256 After some time you'll see a dialog box warning that the system will reboot in 10 seconds.
 257
 258
 259
 260 === After reboot ===
 261
 262
 263 Leave "Boot from Hard Disk" selected and click ENTER
 264
 265 You'll have to wait a while (or press ESC to see what the operating system is "doing"). After some moments, you'll
 266 be taken to the "Yast2 - installation @ Linux" screen (a text installer).
 267
 268
 269 === "Writing the System Configuration" screen ===
 270
 271
 272 [just watch it... ]
 273
 274 After a while you'll see a prompt:
 275 |--------------------
 276 Welcome to openSUSE 11.0 (i586) - Kernel 2.6.25.4-8-default (tty1)
 277
 278 linux-3r10 login:
 279 |--------------------
 280
 281 You may now login with your "root" user.
 282
 283
 284
 285 ==== Changing the Hostname and Domain Name ====
 286
 287
 288 I want to change my hostname, domain name and switch from DHCP to a Static IP address.
 289
 290 So, the first thing I do, is to run yast (the setup tool) by entering the yast command in the command prompt:
 291 |--------------------
 292 linux-3r10:~ # yast
 293 |--------------------
 294
 295 Yast should appear.
 296
 297 On the listbox of the left hand side select "Network Devices" (press TAB to turn focus on that listbox, and press the down arrow key several times to reach it). Then, on the listbox of the righ hand side, select "Network Settings" (you'll have again to press TAB to turn focus on that listbox, and press the down arrow key several times to reach it).
 298
 299 Press the ENTER key.
 300
 301
 302 === "Initializing Network Configuration" screen ===
 303
 304
 305 [just watch it...]
 306
 307 === "Network Settings" screen ===
 308
 309
 310 I want to disable IPv6, so I first go to the "Global Options" section (by pushing the key combination ALT+G to press the "G" letter in Global Options that is highlighted). In the next screen, I push ALT+E to uncheck the "Enable IPv6" checkbox. I'll get a dialog box with a Warning saying that "To apply this change a reboot is needed.". I just press ENTER on that dialog box, but I do NOT reboot (at least not yet).
 311
 312 Then I press Alt+O to go to the "Overview" (still in "Network Settings"). Then I press ALT+i to "Edit" the information for this Network Card.
 313
 314 === "Network Card Setup" screen ===
 315
 316
 317 I check the "Statically assigned IP Address" checkbox, and enter the following info for "IP Address", "Subnet Mask" and "Hostname" (you should use the values defined by your network administrator):
 318
 319 IP Address: 192.168.0.2
 320 Subnet Mask: 255.255.255.0
 321 Hostname: myhost
 322
 323 Then I press ALT+N to click the "Next" button. After a few seconds, I will be taken again to the "Network Settings" screen.
 324
 325
 326 === "Network Settings" screen ===
 327
 328
 329 I press ALT+s to go to the "Hostname/DNS" screen.
 330
 331 I check the "Change /etc/resolv.conf manually" checkbox and enter the IP Address of my DNS Server in the "Name Server 1" text box:
 332
 333
 334 Name Server 1: 192.168.0.1
 335
 336 Then I press ALT+u to go to the "Routing" configuration.
 337
 338 === "Routing" screen ===
 339
 340
 341 In the "Default Gateway" text box, I enter the IP Address of my Default Gateway:
 342
 343 Default Gateway: 192.168.0.1
 344
 345 Then I press ALT+F to Finish
 346
 347
 348
 349 === "Saving Network Configuration" screen ===
 350
 351
 352 [just watch it...]
 353
 354
 355 After a few seconds, you should be taken back to the "YaST2 Control Center" screen.
 356
 357
 358
 359 ==== Enabling access to SSH (Secure Shell) and Apache2 (Web Server) ====
 360
 361 I want to administer remotely this server with a SSH (Secure Shell) client. So, while still in the "YaST2 Control Center, I will enable SSH in the Firewall (running by default). In the listbox of the left hand side, I select "Security and Users" and then, on the listbox of the right side, I select "Firewall" (first option) and press the ENTER key.
 362
 363 ----
 364
 365 "yast2 - firewall" screen
 366
 367
 368 In the list box of the left side, I select "Allowed Services" and press ENTER.
 369
 370 Then, on the "Service to Allow" dropdown list (on the right side), I leave the "Apache 2" option selected and press "ALt+A" to add it. After adding Apache, I'll press "Alt+S" to see the available services to add. Then, I use the down key in that list until I see "Secure Shell Server" and press ENTER to select it. This will close that list and put "Secure Shell Server" as the selected option. I'll press Alt+A again to add it.
 371
 372 Then I click on ALT+N click on the "Next" button.
 373
 374 ----
 375
 376 "Firewall Configuration: Summary" screen
 377
 378 Click on the "Finish" button.
 379
 380 When you get sent back to the "YaST2 Control Center" screen, press ALT+Q to Quit Yast.
 381
 382
 383 This time seems to be a good time to reboot your server:
 384 |--------------------
 385 linux-3r10:~ # reboot
 386 |--------------------
 387 After rebooting the machine, if you wish, you may go to another machine and connect to your newly created server using a SSH (Secure Shell) client. In Windows, I like to use putty to do ssh sessions to my Linux servers.
 388
 389 ==== Configure Software Repositories ===
 390
 391 Later on, you will need to add some software packages from the openSUSE 11 Distribution. Some of those packages are NOT available in the openSUSE 11.0 DVD (libyaz-devel is one of those packages). So, we'll now set up openSUSE to add the "Official openSUSE 11.0 OSS (Open Source Software) Repository" using yast.
 392
 393 First, run the yast command in the Linux command line (shell):
 394
 395 |--------------------
 396 # yast
 397 |--------------------
 398
 399 Inside yast, select Software -> Software Repositories
 400
 401 === "Configured Software Repositories" screen ===
 402
 403 Click on the "Add" button.
 404
 405
 406 === "Media type" screen ===
 407
 408
 409 Click on the Specify URL... radio button.
 410
 411 Click on the "Next" button.
 412
 413
 414 === "Repository URL" screen ===
 415
 416
 417 In the "Repository Name" textbox enter some descriptive text like:
 418 openSUSE 11.0 Official OSS Repository
 419
 420 In the "URL" textbox enter:
 421 http://download.opensuse.org/distribution/11.0/repo/oss/
 422
 423
 424 Click on the "Next" button.
 425
 426
 427 === "License Agreement" screen ===
 428
 429
 430 Check the "Yes, I Agree to the License Agreement" radio button.
 431
 432 Click on the "Next" button to return to the "Configured Software Repositories" screen.
 433
 434
 435 === "Configured Software Repositories" screen ===
 436
 437
 438 You should see now the "openSUSE 11 Official OSS Repository" listed as an entry.
 439
 440 Click on the "Finish" button.
 441
 442 When you get sent back to the "Yast Control Center" click on the "Quit" button (to return to the shell).
 443
 444
 445 ==== Install some useful / necessary programs ===
 446
 447 By this time, I'll install some of the programs I regularly use, by using yast:
 448
 449
 450   * To install locate:
 451 |--------------------
 452 # yast -i findutils-locate
 453 |--------------------
 454 A YaST screen may appear saying:
 455 |--------------------
 456 Starting the Package Manager.
 457 |--------------------
 458 If that screen appears, it will download some information from http://download.opensuse.org (and set several Software Repositories "behind the scenes)
 459
 460
 461   * To install ncftp (command-line ftp client):
 462 |--------------------
 463 # yast -i ncftp
 464 |--------------------
 465
 466
 467 Install some packages that are needed to install Koha:
 468
 469   * To install make :
 470 |--------------------
 471 # yast -i make
 472 |--------------------
 473
 474   * To install gcc :
 475 |--------------------
 476 # yast -i gcc
 477 |--------------------
 478 (this will also install some packages that gcc depend on, like glibc-devel).
 479
 480
 481 ==== Download Koha ====
 482
 483 |--------------------
 484 # wget http://download.koha.org/koha-3.00.00.tar.gz
 485 |--------------------
 486
 487 [FIXME: Check what will be the exact URL of the .tar.gz file for Koha 3]
 488
 489
 490 ==== Extract Koha ====
 491
 492 |--------------------
 493 # tar -xzvf koha-3.00.00.tar.gz
 494 |--------------------
 495
 496
 497 ==== Set up Locale for root user ====
 498
 499 If you run the locale command, you'll probably get this output:
 500 |--------------------
 501 # locale
 502 LANG=POSIX
 503 LC_CTYPE=en_US.UTF-8
 504 LC_NUMERIC="POSIX"
 505 LC_TIME="POSIX"
 506 LC_COLLATE="POSIX"
 507 LC_MONETARY="POSIX"
 508 LC_MESSAGES="POSIX"
 509 LC_PAPER="POSIX"
 510 LC_NAME="POSIX"
 511 LC_ADDRESS="POSIX"
 512 LC_TELEPHONE="POSIX"
 513 LC_MEASUREMENT="POSIX"
 514 LC_IDENTIFICATION="POSIX"
 515 LC_ALL=
 516 |--------------------
 517
 518 We want to have en_US.UTF-8 in all LC_* variables. So, we'll do the following:
 519 |--------------------
 520 # yast
 521 |--------------------
 522 System -> Language
 523
 524 The "Languages" screen should appear.
 525
 526 In the first section (Primary Language Settings):
 527
 528 Leave "English (US)" selected as the option for Primary Language
 529
 530
 531 Click on the "Details..." link
 532
 533 Change the Locale Settings for user root from the default option ("ctype Only") to "Yes"
 534
 535 Make sure the "Use UTF-8 Encoding" checkbox is checked (it should already be).
 536
 537 Leave the "Detailed Locale Setting" en_US selected
 538
 539 Click on the OK button to return to the "Languages" screen
 540
 541 Click on the "Accept" button.
 542
 543
 544
 545 When you get back to the "Yast2 Control Center" screen, click on the "Quit" button
 546
 547
 548
 549 ==== Putty configuration to use Unicode (UTF-8 encoding) ====
 550
 551 If you use Putty, set up Putty to use UTF-8 encoding. To do this, click on the upper left corner of the PuTTy window,
 552 to expand the menu. Scroll down until you find the "Change Settings..." command and click on it.
 553
 554 This should open the "PuTTy Reconfiguration" screen. Here expand the "Window" category and click on "Translation"
 555
 556 When you do this, you'll see that the "Received data assumed to be in which character set" dropdown list probably reads:
 557
 558 "ISO-8859-1:1998 (Latin-1, West Europe)
 559
 560 change it to: "UTF-8"
 561
 562 Click on the "Apply" button
 563
 564
 565 Now, it's a good time to SAVE this PuTTy session. To do this, click again on the upper left corner of the PuTTy window, to expand the menu, and click on the "Change Settings..." command like you did before.
 566
 567 This should open the "PuTTy Reconfiguration" screen. Go to the right hand side of that screen and type a name in the "Saved Sessions" textbox (e.g: koha). Then click on the "Save" button and, after doing that, click on the "Apply" button.
 568
 569
 570 IMPORTANT!!! Now it's the time to EXIT the login shell, by typing the exit command:
 571 |--------------------
 572 # exit
 573 |--------------------
 574
 575 Now you'll reopen PuTTy, but when you do that, open the Saved Session that you have created in order to use the "UTF-8" configuration you have done.
 576
 577
 578 After logging in again with the root user, type the locale command again. Now it should read like the following:
 579
 580 |--------------------
 581 # locale
 582 LANG=en_US.UTF-8
 583 LC_CTYPE="en_US.UTF-8"
 584 LC_NUMERIC="en_US.UTF-8"
 585 LC_TIME="en_US.UTF-8"
 586 LC_COLLATE="en_US.UTF-8"
 587 LC_MONETARY="en_US.UTF-8"
 588 LC_MESSAGES="en_US.UTF-8"
 589 LC_PAPER="en_US.UTF-8"
 590 LC_NAME="en_US.UTF-8"
 591 LC_ADDRESS="en_US.UTF-8"
 592 LC_TELEPHONE="en_US.UTF-8"
 593 LC_MEASUREMENT="en_US.UTF-8"
 594 LC_IDENTIFICATION="en_US.UTF-8"
 595 LC_ALL=
 596 |--------------------
 597
 598
 599 ==== Apache configuration (for UTF-8) ====
 600
 601 Create a file called /etc/apache2/httpd.conf.local with vim (or your preferred text editor):
 602 |--------------------
 603 myhost:~ # vim /etc/apache2/httpd.conf.local
 604 |--------------------
 605 Add this line:
 606 |--------------------
 607 AddDefaultCharset UTF-8
 608 |--------------------
 609
 610
 611 ==== Configure Apache to start at boot time and start the service ====
 612 |--------------------
 613 # chkconfig apache2 on
 614
 615 # service apache2 start
 616 Starting httpd2 (prefork)                                            done
 617 |--------------------
 618
 619 Go to a browser and type:
 620
 621 http://192.168.0.2
 622
 623 You should see a page that reads:
 624
 625 "It works!"
 626
 627
 628
 629 ==== MySQL configuration ====
 630
 631 1 - Configure MySQL to start at boot time and start the service:
 632 |--------------------
 633 # chkconfig mysql on
 634
 635 # service mysql start
 636 |--------------------
 637
 638 2 - Change the password for the "root" user of MySQL:
 639 |--------------------
 640 # /usr/bin/mysqladmin -u root password 'chosenpassword'
 641 |--------------------
 642
 643 3 - Check the encoding variables of MySQL
 644
 645 To check the encoding variables of MySQL, will type the
 646 show variables like 'char%'; command in a mysql prompt:
 647 |--------------------
 648 # mysql -p
 649 Enter password:
 650 Welcome to the MySQL monitor.  Commands end with ; or \g.
 651 Your MySQL connection id is 7
 652 Server version: 5.0.51a SUSE MySQL RPM
 653
 654
 655 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
 656
 657 mysql> show variables like 'char%';
 658 +--------------------------+----------------------------+
 659 | Variable_name            | Value                      |
 660 +--------------------------+----------------------------+
 661 | character_set_client     | latin1                     |
 662 | character_set_connection | latin1                     |
 663 | character_set_database   | latin1                     |
 664 | character_set_filesystem | binary                     |
 665 | character_set_results    | latin1                     |
 666 | character_set_server     | latin1                     |
 667 | character_set_system     | utf8                       |
 668 | character_sets_dir       | /usr/share/mysql/charsets/ |
 669 +--------------------------+----------------------------+
 670 8 rows in set (0.00 sec)
 671
 672 mysql> quit
 673 Bye
 674 |--------------------
 675
 676 We want to have utf8 in the above character_set_* variables above (and NOT latin1)!
 677
 678 In order to do this:
 679
 680 1 - Create a backup of the MySQL configuration file (my.cnf):
 681 |--------------------
 682 # cd /etc
 683 myhost:/etc # cp my.cnf my.cnf.ORIG
 684 |--------------------
 685
 686 2 - Use vim to add these 3 lines in the section [mysqld] of the my.cnf file:
 687 |--------------------
 688 default-character-set = utf8
 689 character-set-server = utf8
 690 skip-character-set-client-handshake
 691 |--------------------
 692
 693 3 - Restart MySQL:
 694 |--------------------
 695 myhost:/etc # service mysql restart
 696 Restarting service MySQL
 697 Shutting down service MySQL                                           done
 698 Starting service MySQL                                                done
 699 |--------------------
 700
 701 Now, let's type again the show variables like 'char%' mysql command to see if
 702 the character_set_variables have changed from latin1 to utf8 (character_set_filesystem
 703 will still read "binary" but I think that's OK:
 704 |--------------------
 705 myhost:/etc # mysql -p
 706 Enter password:
 707 Welcome to the MySQL monitor.  Commands end with ; or \g.
 708 Your MySQL connection id is 1
 709 Server version: 5.0.51a SUSE MySQL RPM
 710
 711
 712 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
 713
 714 mysql> show variables like 'char%';
 715 +--------------------------+----------------------------+
 716 | Variable_name            | Value                      |
 717 +--------------------------+----------------------------+
 718 | character_set_client     | utf8                       |
 719 | character_set_connection | utf8                       |
 720 | character_set_database   | utf8                       |
 721 | character_set_filesystem | binary                     |
 722 | character_set_results    | utf8                       |
 723 | character_set_server     | utf8                       |
 724 | character_set_system     | utf8                       |
 725 | character_sets_dir       | /usr/share/mysql/charsets/ |
 726 +--------------------------+----------------------------+
 727 8 rows in set (0.01 sec)
 728
 729 mysql> quit
 730 Bye
 731 |--------------------
 732
 733 ==== Create the Koha database ====
 734
 735 === Create the koha database and user with associated privileges ===
 736 |--------------------
 737 # mysqladmin -uroot create koha -p
 738 |--------------------
 739 (you may name the koha database something different from koha)
 740
 741
 742 === Grant privileges to a MySQL user to the koha database ===
 743
 744 Assuming that you want to have a MySQL user called "kohaadmin" to administer a database called "koha" with the password "kohapassword", you'd enter this:
 745 |--------------------
 746 myhost:~ # mysql -p
 747 Enter password:
 748 Welcome to the MySQL monitor.  Commands end with ; or \g.
 749 Your MySQL connection id is 3
 750 Server version: 5.0.51a SUSE MySQL RPM
 751
 752 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
 753
 754 mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by 'kohapassword';
 755 Query OK, 0 rows affected (0.00 sec)
 756
 757 mysql> flush privileges;
 758 Query OK, 0 rows affected (0.08 sec)
 759
 760 mysql> quit
 761 Bye
 762 |--------------------
 763
 764
 765 ==== Test your SAX Parser and correct where necessary ====
 766
 767
 768   * Install the XML::SAX and XML::LibXML perl Modules:
 769 |--------------------
 770 # yast -i perl-XML-SAX
 771
 772 # yast -i perl-XML-LibXML
 773 |--------------------
 774
 775 You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs with pre-composed characters. You can test your SAX parser by running:
 776 |--------------------
 777 # cd /root/koha-3.00.00/
 778
 779 myhost:~/koha-3.00.00 # misc/sax_parser_print.pl
 780 |--------------------
 781
 782 You will probably see this:
 783 |--------------------
 784 XML::SAX::PurePerl=HASH(0x8356a4c)
 785 |--------------------
 786
 787 If you're using PurePerl (you probably are) or Expat, you'll need to edit your ParserDetails.ini file to use the LibXML Parser.
 788 To find the ParserDetails.ini file, you may use locate. To do this, first update the locate database by running the updatedb command:
 789 |--------------------
 790 # updatedb
 791 |--------------------
 792
 793 Then find ParserDetails.ini using locate:
 794 |--------------------
 795 # locate ParserDetails.ini
 796 /usr/lib/perl5/vendor_perl/5.10.0/XML/SAX/ParserDetails.ini
 797 |--------------------
 798
 799 OK. So, let's first do a backup of this ini file:
 800 |--------------------
 801  # cd /usr/lib/perl5/vendor_perl/5.10.0/XML/SAX/
 802
 803 myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cp ParserDetails.ini ParserDetails.ini.ORIG
 804 |--------------------
 805
 806 Edit this ParserDetails.ini file (with vim or other editor)
 807
 808 See if the first line contains this:
 809 |--------------------
 810 [XML::SAX::PurePerl]
 811 |--------------------
 812 If it does, replace this first line by the following:
 813 |--------------------
 814 [XML::LibXML::SAX::Parser]
 815 |--------------------
 816
 817 Run the /root/koha-3.00.00/misc/sax_parser_print.pl command again. This time, you should get the following output:
 818 |--------------------
 819 XML::LibXML::SAX::Parser=HASH(0x8356e0c)
 820 |--------------------
 821
 822
 823 ==== Run Koha's perl installer ====
 824 |--------------------
 825 myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cd /root/koha-3.00.00
 826 |--------------------
 827 We will now run perl Makefile.PL to run the installer.
 828
 829 My installation is a UNIMARC installation, so I'm answering unimarc to the "MARC format for Zebra indexing (marc21, unimarc) [marc21]" question below. If your Library uses the MARC21 format instead of UNIMARC, you should press ENTER to accept the default (which is marc21).
 830
 831 |--------------------
 832 myhost:~/koha-3.00.00 # perl Makefile.PL
 833
 834 By default, Koha can be installed in one of three ways:
 835
 836 standard: Install files in conformance with the Filesystem
 837           Hierarchy Standard (FHS).  This is the default mode
 838           and should be used when installing a production
 839           Koha system.  On Unix systems, root access is
 840           needed to complete a standard installation.
 841
 842 single:   Install files under a single directory.  This option
 843           is useful for installing Koha without root access, e.g.,
 844           on a web host that allows CGI scripts and MySQL databases
 845           but requires the user to keep all files under the user's
 846           HOME directory.
 847
 848 dev:      Create a set of symbolic links and configuration files to
 849           allow Koha to run directly from the source distribution.
 850           This mode is useful for developers who want to run
 851           Koha from a git clone.
 852
 853 Installation mode (dev, single, standard) [standard]
 854
 855
 856 Please specify the directory under which most Koha files
 857 will be installed.
 858
 859 Note that if you are planning in installing more than
 860 one instance of Koha, you may want to modify the last
 861 component of the directory path, which will be used
 862 as the package name in the FHS layout.
 863
 864 Base installation directory [/usr/share/koha]
 865
 866
 867 Since you are using the 'standard' install
 868 mode, you should run 'make install' as root.
 869 However, it is recommended that a non-root
 870 user (on Unix and Linux platforms) have
 871 ownership of Koha's files, including the
 872 Zebra indexes if applicable.
 873
 874 Please specify a user account.  This
 875 user account does not need to exist
 876 right now, but it needs to exist
 877 before you run 'make install'.  Please
 878 note that for security reasons, this
 879 user should not be the same as the user
 880 account Apache runs under.
 881
 882 User account [koha]
 883
 884 Please specify the group that should own
 885 Koha's files.  As above, this group need
 886 not exist right now, but should be created
 887 before you run 'make install'.
 888
 889 Group [koha]
 890
 891 Please specify which database engine you will use
 892 to store data in Koha.  The choices are MySQL and
 893 PostgreSQL; please note that at the moment
 894 PostgreSQL support is highly experimental.
 895
 896 DBMS to use (Pg, mysql) [mysql]
 897
 898
 899 Please specify the name or address of your
 900 database server.  Note that the database
 901 does not have to exist at this point, it
 902 can be created after running 'make install'
 903 and before you try using Koha for the first time.
 904
 905 Database server [localhost]
 906
 907 Please specify the port used to connect to the
 908 DMBS [3306]
 909
 910 Please specify the name of the database to be
 911 used by Koha [koha]
 912
 913 Please specify the user that owns the database to be
 914 used by Koha [kohaadmin]
 915
 916 Please specify the password of the user that owns the
 917 database to be used by Koha [katikoan] kohapassword
 918
 919 Koha can use the Zebra search engine for high-performance
 920 searching of bibliographic and authority records.  If you
 921 have installed the Zebra software and would like to use it,
 922 please answer 'yes' to the following question.  Otherwise,
 923 Koha will default to using its internal search engine.
 924
 925 Please note that if you choose *NOT* to install Zebra,
 926 koha-conf.xml will still contain some references to Zebra
 927 settings.  Those references will be ignored by Koha.
 928
 929 Install the Zebra configuration files? (no, yes) [yes] yes
 930
 931
 932 Since you've chosen to use Zebra with Koha,
 933 you must specify the primary MARC format of the
 934 records to be indexed by Zebra.
 935
 936 Koha provides Zebra configuration files for MARC 21
 937 and UNIMARC.
 938
 939 MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
 940
 941
 942 Koha supplies Zebra configuration files tuned for
 943 searching either English (en) or French (fr) MARC
 944 records.
 945
 946 Primary language for Zebra indexing (en, fr) [en] fr
 947
 948 Koha can use one of  two different indexing modes
 949 for the MARC authorities records:
 950
 951 grs1 - uses the Zebra GRS-1 filter, available
 952        for legacy support
 953 dom  - uses the DOM XML filter; offers improved
 954        functionality.
 955
 956 Authorities indexing mode (dom, grs1) [grs1] dom
 957
 958
 959 Please specify Zebra database user [kohauser]
 960
 961
 962 Please specify the Zebra database password [zebrastripes] zebrapassword
 963
 964
 965 Since you've chosen to use Zebra, you can enable the SRU/
 966 Z39.50 Server if you so choose, but you must specify a
 967 few configuration options for it.
 968
 969 Please note that if you choose *NOT* to configure SRU,
 970 koha-conf.xml will still contain some references to SRU
 971 settings.  Those references will be ignored by Koha.
 972
 973 Install the SRU configuration files? (no, yes) [yes] no
 974
 975
 976 Since you've chosen to use Zebra, you can also choose to
 977 install PazPar2, which is a metasearch tool.  With PazPar2,
 978 Koha can perform on-the-fly merging of bibliographic
 979 records during searching, allowing for FRBRization of
 980 the results list.
 981
 982 Install the PazPar2 configuration files? [no]
 983
 984 Would you like to run the database-dependent test suite? (no, yes) [no]
 985
 986
 987
 988 Koha will be installed with the following configuration parameters:
 989
 990 AUTH_INDEX_MODE          dom
 991 DB_HOST                  localhost
 992 DB_NAME                  koha
 993 DB_PASS                  kohapassword
 994 DB_PORT                  3306
 995 DB_TYPE                  mysql
 996 DB_USER                  kohaadmin
 997 INSTALL_BASE             /usr/share/koha
 998 INSTALL_MODE             standard
 999 INSTALL_PAZPAR2          no
1000 INSTALL_SRU              no
1001 INSTALL_ZEBRA            yes
1002 KOHA_GROUP               koha
1003 KOHA_INSTALLED_VERSION   3.00.00.087
1004 KOHA_USER                koha
1005 RUN_DATABASE_TESTS       no
1006 ZEBRA_LANGUAGE           fr
1007 ZEBRA_MARC_FORMAT        unimarc
1008 ZEBRA_PASS               zebrapassword
1009 ZEBRA_USER               kohauser
1010
1011 and in the following directories:
1012
1013 DOC_DIR                  /usr/share/koha/doc
1014 INTRANET_CGI_DIR         /usr/share/koha/intranet/cgi-bin
1015 INTRANET_TMPL_DIR        /usr/share/koha/intranet/htdocs/intranet-tmpl
1016 INTRANET_WWW_DIR         /usr/share/koha/intranet/htdocs
1017 KOHA_CONF_DIR            /etc/koha
1018 LOG_DIR                  /var/log/koha
1019 MAN_DIR                  /usr/share/koha/man
1020 MISC_DIR                 /usr/share/koha/misc
1021 OPAC_CGI_DIR             /usr/share/koha/opac/cgi-bin
1022 OPAC_TMPL_DIR            /usr/share/koha/opac/htdocs/opac-tmpl
1023 OPAC_WWW_DIR             /usr/share/koha/opac/htdocs
1024 PAZPAR2_CONF_DIR         /etc/koha/pazpar2
1025 PERL_MODULE_DIR          /usr/share/koha/lib
1026 SCRIPT_DIR               /usr/share/koha/bin
1027 SCRIPT_NONDEV_DIR        /usr/share/koha/bin
1028 ZEBRA_CONF_DIR           /etc/koha/zebradb
1029 ZEBRA_DATA_DIR           /var/lib/koha/zebradb
1030 ZEBRA_LOCK_DIR           /var/lock/koha/zebradb
1031 ZEBRA_RUN_DIR            /var/run/koha/zebradb
1032
1033
1034 To change any configuration setting, please run
1035 perl Makefile.PL again.  To override one of the target
1036 directories, you can do so on the command line like this:
1037
1038 perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
1039
1040 You can also set different default values for parameters
1041 or override directory locations by using environment variables.
1042
1043 For example:
1044
1045 export DB_USER=my_koha
1046 perl Makefile.PL
1047
1048 or
1049
1050 DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
1051
1052 If installing on a Win32 platform, be sure to use:
1053 'dmake -x MAXLINELENGTH=300000'
1054
1055 Warning: prerequisite Biblio::EndnoteStyle 0.05 not found.
1056 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite CGI::Session 4.10 not found.
1057 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite Class::Accessor 0.3 not found.
1058 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite Class::Factory::Util 1.6 not found.
1059 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite DBD::mysql 4.004 not found.
1060 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite Data::ICal 0.13 not found.
1061 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite Date::Calc 5.4 not found.
1062 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite Date::ICal 1.72 not found.
1063 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite Date::Manip 5.44 not found.
1064 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite GD::Barcode::UPCE 1.1 not found.
1065 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite HTML::Scrubber 0.08 not found.
1066 [Sun Jun  1 18:45:44 2008] Makefile.PL: Warning: prerequisite HTML::Template::Pro 0.69 not found.
1067 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Image::Magick 6.2 not found.
1068 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Lingua::Stem 0.82 not found.
1069 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite List::MoreUtils 0.21 not found.
1070 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite MARC::Charset 0.98 not found.
1071 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite MARC::Crosswalk::DublinCore 0.02 not found.
1072 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite MARC::File::XML 0.88 not found.
1073 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite MARC::Record 2 not found.
1074 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Mail::Sendmail 0.79 not found.
1075 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Net::LDAP 0.33 not found.
1076 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Net::LDAP::Filter 0.14 not found.
1077 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Net::Z3950::ZOOM 1.16 not found.
1078 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite PDF::API2 2 not found.
1079 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite PDF::API2::Page 2 not found.
1080 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite PDF::API2::Util 2 not found.
1081 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite PDF::Reuse 0.33 not found.
1082 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite PDF::Reuse::Barcode 0.05 not found.
1083 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite POE 0.9999 not found.
1084 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Schedule::At 1.06 not found.
1085 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Text::CSV 0.01 not found.
1086 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Text::CSV_XS 0.32 not found.
1087 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite Text::Iconv 1.7 not found.
1088 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite XML::Dumper 0.81 not found.
1089 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite XML::LibXSLT 1.59 not found.
1090 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite XML::RSS 1.31 not found.
1091 [Sun Jun  1 18:45:45 2008] Makefile.PL: Warning: prerequisite YAML::Syck 0.71 not found.
1092 Writing Makefile for koha
1093
1094 myhost:~/koha-3.00.00 #
1095 |--------------------
1096
1097 OK... Lots of missing dependencies (Perl Modules). Let's build some of these modules in CPAN to fix this:
1098
1099
1100 ==== CPAN Configuration ====
1101 If you don't already know, "CPAN is the Comprehensive Perl Archive Network, a large collection of Perl software and documentation". For additional info, you may browse the official CPAN web site is at http://www.cpan.org/
1102
1103 Enter the "cpan" command to configure CPAN:
1104 |--------------------
1105 myhost:~/koha-3.00.00 # cpan
1106
1107
1108 CPAN is the world-wide archive of perl resources. It consists of about
1109 300 sites that all replicate the same contents around the globe. Many
1110 countries have at least one CPAN site already. The resources found on
1111 CPAN are easily accessible with the CPAN.pm module. If you want to use
1112 CPAN.pm, lots of things have to be configured. Fortunately, most of
1113 them can be determined automatically. If you prefer the automatic
1114 configuration, answer 'yes' below.
1115
1116 If you prefer to enter a dialog instead, you can answer 'no' to this
1117 question and I'll let you configure in small steps one thing after the
1118 other. (Note: you can revisit this dialog anytime later by typing 'o
1119 conf init' at the cpan prompt.)
1120 Would you like me to configure as much as possible automatically? [yes]
1121 |--------------------
1122
1123 [Just press ENTER here to set all CPAN settings to the default values.
1124 After doing this CPAN will scroll lots of messages with questions that
1125 it will automatically answer]
1126
1127 [Let's now set up CPAN for Internet access to enable it to download packages.
1128 Because I live in Portugal, I'm choosing Portuguese mirrors here. Choose the
1129 mirrors that are nearer to you:]
1130
1131 |--------------------
1132 cpan[2]> o conf init urllist
1133 You have no /root/.cpan/sources/MIRRORED.BY
1134   I'm trying to fetch one
1135 CPAN: LWP::UserAgent loaded ok (v5.810)
1136
1137 I would like to connect to one of the following sites to get 'MIRRORED.BY':
1138
1139  http://www.perl.org/CPAN/
1140  ftp://ftp.perl.org/pub/CPAN/
1141
1142 Is it OK to try to connect to the Internet? [yes]
1143 Fetching with LWP:
1144   http://www.perl.org/CPAN/MIRRORED.BY
1145
1146
1147 Now we need to know where your favorite CPAN sites are located. Push
1148 a few sites onto the array (just in case the first on the array won't
1149 work). If you are mirroring CPAN to your local workstation, specify a
1150 file: URL.
1151
1152 First, pick a nearby continent and country by typing in the number(s)
1153 in front of the item(s) you want to select. You can pick several of
1154 each, separated by spaces. Then, you will be presented with a list of
1155 URLs of CPAN mirrors in the countries you selected, along with
1156 previously selected URLs. Select some of those URLs, or just keep the
1157 old list. Finally, you will be prompted for any extra URLs -- file:,
1158 ftp:, or http: -- that host a CPAN mirror.
1159
1160 (1) Africa
1161 (2) Asia
1162 (3) Central America
1163 (4) Europe
1164 (5) North America
1165 (6) Oceania
1166 (7) South America
1167 Select your continent (or several nearby continents) [] 4
1168
1169 (1) Austria
1170 (2) Belgium
1171 (3) Bosnia and Herzegovina
1172 (4) Bulgaria
1173 (5) Croatia
1174 (6) Czech Republic
1175 (7) Denmark
1176 (8) Finland
1177 (9) France
1178 (10) Germany
1179 (11) Greece
1180 (12) Hungary
1181 (13) Iceland
1182 (14) Ireland
1183 (15) Italy
1184 (16) Latvia
1185 15 more items, hit RETURN to show them
1186 Select your country (or several nearby countries) []
1187 Sorry! since you don't have any existing picks, you must make a
1188 geographic selection.
1189
1190 (17) Lithuania
1191 (18) Malta
1192 (19) Netherlands
1193 (20) Norway
1194 (21) Poland
1195 (22) Portugal
1196 (23) Romania
1197 (24) Russia
1198 (25) Slovakia
1199 (26) Slovenia
1200 (27) Spain
1201 (28) Sweden
1202 (29) Switzerland
1203 (30) Ukraine
1204 (31) United Kingdom
1205 Select your country (or several nearby countries) [] 22
1206
1207 (1) ftp://cpan.ip.pt/pub/cpan/
1208 (2) ftp://ftp.dei.uc.pt/pub/CPAN
1209 (3) ftp://ftp.isr.ist.utl.pt/pub/CPAN/
1210 (4) ftp://ftp.nfsi.pt/pub/cpan/
1211 (5) ftp://neacm.fe.up.pt/pub/CPAN/
1212 (6) ftp://perl.di.uminho.pt/pub/CPAN/
1213 (7) http://cpan.dcc.fc.up.pt/
1214 Select as many URLs as you like (by number),
1215 put them on one line, separated by blanks, hyphenated ranges allowed
1216  e.g. '1 4 5' or '7 1-4 8' [] 3 2 6 4 5 7 1
1217
1218 Enter another URL or RETURN to quit: []
1219 New set of picks:
1220   ftp://ftp.isr.ist.utl.pt/pub/CPAN/
1221   ftp://ftp.dei.uc.pt/pub/CPAN
1222   ftp://perl.di.uminho.pt/pub/CPAN/
1223   ftp://ftp.nfsi.pt/pub/cpan/
1224   ftp://neacm.fe.up.pt/pub/CPAN/
1225   http://cpan.dcc.fc.up.pt/
1226   ftp://cpan.ip.pt/pub/cpan/
1227
1228
1229 Please remember to call 'o conf commit' to make the config permanent!
1230
1231
1232 cpan[3]> o conf commit
1233 commit: wrote '/usr/lib/perl5/5.10.0/CPAN/Config.pm'
1234
1235 cpan[4]> quit
1236 Lockfile removed.
1237 |--------------------
1238
1239 ==== Installing Prerequisite Modules ====
1240 |--------------------
1241 myhost:~/koha-3.00.00 # cpan
1242 CPAN: File::HomeDir loaded ok (v0.69)
1243
1244 cpan shell -- CPAN exploration and modules installation (v1.9205)
1245 ReadLine support enabled
1246 |--------------------
1247 === Install Biblio::EndnoteStyle ===
1248 [Let's install the first package called "Biblio::EndnoteStyle". Here I will leave the complete output. For the next installations, I will only show the prompts for dependencies and snip out the remaining output]:
1249 |--------------------
1250 cpan[1]> install Biblio::EndnoteStyle
1251 CPAN: Storable loaded ok (v2.18)
1252 CPAN: LWP::UserAgent loaded ok (v5.810)
1253 CPAN: Time::HiRes loaded ok (v1.9711)
1254 Fetching with LWP:
1255   ftp://ftp.isr.ist.utl.pt/pub/CPAN/authors/01mailrc.txt.gz
1256 Going to read /root/.cpan/sources/authors/01mailrc.txt.gz
1257 CPAN: Compress::Zlib loaded ok (v2.008)
1258 ............................................................................DONE
1259 Fetching with LWP:
1260   ftp://ftp.isr.ist.utl.pt/pub/CPAN/modules/02packages.details.txt.gz
1261 Going to read /root/.cpan/sources/modules/02packages.details.txt.gz
1262   Database was generated on Sun, 01 Jun 2008 02:07:07 GMT
1263 ............................................................................DONE
1264 Fetching with LWP:
1265   ftp://ftp.isr.ist.utl.pt/pub/CPAN/modules/03modlist.data.gz
1266 Going to read /root/.cpan/sources/modules/03modlist.data.gz
1267 ............................................................................DONE
1268 Going to write /root/.cpan/Metadata
1269 Running install for module 'Biblio::EndnoteStyle'
1270 CPAN: Data::Dumper loaded ok (v2.121_14)
1271 'YAML' not installed, falling back to Data::Dumper and Storable to read prefs '/root/.cpan/prefs'
1272 Running make for M/MI/MIRK/Biblio-EndnoteStyle-0.05.tar.gz
1273 Fetching with LWP:
1274   ftp://ftp.isr.ist.utl.pt/pub/CPAN/authors/id/M/MI/MIRK/Biblio-EndnoteStyle-0.05.tar.gz
1275 CPAN: Digest::SHA loaded ok (v5.45)
1276 Fetching with LWP:
1277   ftp://ftp.isr.ist.utl.pt/pub/CPAN/authors/id/M/MI/MIRK/CHECKSUMS
1278 Checksum for /root/.cpan/sources/authors/id/M/MI/MIRK/Biblio-EndnoteStyle-0.05.tar.gz ok
1279 Scanning cache /root/.cpan/build for sizes
1280 DONE
1281 Biblio-EndnoteStyle-0.05/
1282 Biblio-EndnoteStyle-0.05/README
1283 Biblio-EndnoteStyle-0.05/Changes
1284 Biblio-EndnoteStyle-0.05/META.yml
1285 Biblio-EndnoteStyle-0.05/MANIFEST
1286 Biblio-EndnoteStyle-0.05/MANIFEST.SKIP
1287 Biblio-EndnoteStyle-0.05/Makefile.PL
1288 Biblio-EndnoteStyle-0.05/t/
1289 Biblio-EndnoteStyle-0.05/t/Biblio-EndnoteStyle.t
1290 Biblio-EndnoteStyle-0.05/bin/
1291 Biblio-EndnoteStyle-0.05/bin/endnote-format
1292 Biblio-EndnoteStyle-0.05/lib/
1293 Biblio-EndnoteStyle-0.05/lib/Biblio/
1294 Biblio-EndnoteStyle-0.05/lib/Biblio/EndnoteStyle.pm
1295 CPAN: File::Temp loaded ok (v0.18)
1296 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1297
1298   CPAN.pm: Going to build M/MI/MIRK/Biblio-EndnoteStyle-0.05.tar.gz
1299
1300 Checking if your kit is complete...
1301 Looks good
1302 Writing Makefile for Biblio::EndnoteStyle
1303 Could not read '/root/.cpan/build/Biblio-EndnoteStyle-0.05-vQLGoS/META.yml'. Falling back to other methods to determine prerequisites
1304 cp lib/Biblio/EndnoteStyle.pm blib/lib/Biblio/EndnoteStyle.pm
1305 cp bin/endnote-format blib/script/endnote-format
1306 /usr/bin/perl "-MExtUtils::MY" -e "MY->fixin(shift)" blib/script/endnote-format
1307 Manifying blib/man3/Biblio::EndnoteStyle.3pm
1308   MIRK/Biblio-EndnoteStyle-0.05.tar.gz
1309   /usr/bin/make -- OK
1310 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1311 Running make test
1312 PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
1313 t/Biblio-EndnoteStyle....ok
1314 All tests successful.
1315 Files=1, Tests=11,  0 wallclock secs ( 0.09 cusr +  0.12 csys =  0.21 CPU)
1316   MIRK/Biblio-EndnoteStyle-0.05.tar.gz
1317   /usr/bin/make test -- OK
1318 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1319 Running make install
1320 Prepending /root/.cpan/build/Biblio-EndnoteStyle-0.05-vQLGoS/blib/arch
1321
1322 /root/.cpan/build/Biblio-EndnoteStyle-0.05-vQLGoS/blib/lib to PERL5LIB for 'install'
1323 Installing /usr/lib/perl5/site_perl/5.10.0/Biblio/EndnoteStyle.pm
1324 Installing /usr/share/man/man3/Biblio::EndnoteStyle.3pm
1325 Installing /usr/bin/endnote-format
1326 Writing /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi/auto/Biblio/EndnoteStyle/.packlist
1327 Appending installation info to /usr/lib/perl5/5.10.0/i586-linux-thread-multi/perllocal.pod
1328   MIRK/Biblio-EndnoteStyle-0.05.tar.gz
1329   /usr/bin/make install  -- OK
1330 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1331 |--------------------
1332
1333 === Install the "CGI::Session::Serialize::yaml" Perl Module ===
1334
1335 [Install CGI::Session::Serialize::yaml "instead" of CGI::Session to avoid problems later on. Don't worry: by installing CGI::Session::Serialize::yaml you are also installing CGI::Session]:
1336 |--------------------
1337 cpan[2]> install CGI::Session::Serialize::yaml
1338
1339
1340 cpan[3]> quit
1341 Lockfile removed.
1342 |--------------------
1343
1344 === Install some "Class" Perl Modules ===
1345 To install the Class::Accessor Perl Module we'll use the available software package in openSUSE 11.0 (using yast) instead of downloading it from CPAN:
1346 |--------------------
1347 myhost:~/Koha-3.00.00 # yast -i perl-Class-Accessor
1348 |--------------------
1349
1350 [this will also install a dependency: perl-Carp-Assert]
1351
1352 |--------------------
1353 myhost:~/Koha-3.00.00 # cpan
1354
1355 cpan shell -- CPAN exploration and modules installation (v1.9205)
1356 ReadLine support enabled
1357
1358 cpan[1]> install Class::Factory::Util
1359
1360 cpan[2]> quit
1361 Lockfile removed.
1362 |--------------------
1363 [this will also install a dependency: perl-Data-Showtable]
1364
1365 === Install DBD::MySQL ===
1366 |--------------------
1367 myhost:~/koha-3.00.00 # yast -i perl-DBD-mysql
1368 |--------------------
1369
1370 === Install some "Data" Perl Modules ===
1371 |--------------------
1372 myhost:~/koha-3.00.00 # cpan
1373 CPAN: File::HomeDir loaded ok (v0.69)
1374
1375 cpan shell -- CPAN exploration and modules installation (v1.9205)
1376 ReadLine support enabled
1377
1378 cpan[1]> install Data::ICal
1379
1380 CPAN: File::Temp loaded ok (v0.18)
1381 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1382
1383   CPAN.pm: Going to build J/JE/JESSE/Data-ICal-0.13.tar.gz
1384
1385 *** Module::AutoInstall version 1.03
1386 *** Checking for Perl dependencies...
1387 [Core Features]
1388 - Test::More          ...loaded. (0.72)
1389 - Test::Warn          ...missing.
1390 - Test::NoWarnings    ...missing.
1391 - Test::LongString    ...missing.
1392 - Class::Accessor     ...loaded. (0.31)
1393 - Text::vFile::asData ...missing.
1394 - MIME::QuotedPrint   ...loaded. (3.07)
1395 - Class::ReturnValue  ...missing.
1396 ==> Auto-install the 5 mandatory module(s) from CPAN? [y]
1397
1398 *** Since we're running under CPANPLUS, I'll just let it take care
1399     of the dependency's installation later.
1400 *** Module::AutoInstall configuration finished.
1401 Checking if your kit is complete...
1402 Looks good
1403 Warning: prerequisite Class::ReturnValue 0 not found.
1404 Warning: prerequisite Test::LongString 0 not found.
1405 Warning: prerequisite Test::NoWarnings 0 not found.
1406 Warning: prerequisite Test::Warn 0 not found.
1407 Warning: prerequisite Text::vFile::asData 0 not found.
1408 Writing Makefile for Data::ICal
1409 Could not read '/root/.cpan/build/Data-ICal-0.13-X1jsxc/META.yml'. Falling back to other methods to determine prerequisites
1410 ---- Unsatisfied dependencies detected during ----
1411 ----        JESSE/Data-ICal-0.13.tar.gz       ----
1412     Test::LongString [requires]
1413     Class::ReturnValue [requires]
1414     Test::NoWarnings [requires]
1415     Text::vFile::asData [requires]
1416     Test::Warn [requires]
1417 Shall I follow them and prepend them to the queue
1418 of modules we are processing right now? [yes]
1419
1420 ---- Unsatisfied dependencies detected during ----
1421 ----    JESSE/Class-ReturnValue-0.55.tar.gz   ----
1422     Devel::StackTrace [requires]
1423 Shall I follow them and prepend them to the queue
1424 of modules we are processing right now? [yes]
1425
1426 Warning: prerequisite Test::Tester 0.103 not found.
1427 Writing Makefile for Test::NoWarnings
1428 Could not read '/root/.cpan/build/Test-NoWarnings-0.084-DMJBk3/META.yml'. Falling back to other methods to determine
1429
1430 prerequisites
1431 ---- Unsatisfied dependencies detected during ----
1432 ----    FDALY/Test-NoWarnings-0.084.tar.gz    ----
1433     Test::Tester [requires]
1434 Shall I follow them and prepend them to the queue
1435 of modules we are processing right now? [yes]
1436 Running install for module 'Text::vFile::asData'
1437 'YAML' not installed, falling back to Data::Dumper and Storable to read prefs '/root/.cpan/prefs'
1438 ---- Unsatisfied dependencies detected during ----
1439 ----   RCLAMP/Text-vFile-asData-0.05.tar.gz   ----
1440     Class::Accessor::Chained [requires]
1441 Shall I follow them and prepend them to the queue
1442 of modules we are processing right now? [yes]
1443
1444
1445 Warning: prerequisite Array::Compare 0 not found.
1446 Warning: prerequisite Sub::Uplevel 0.12 not found.
1447 Warning: prerequisite Test::Exception 0 not found.
1448 Warning: prerequisite Tree::DAG_Node 0 not found.
1449 Writing Makefile for Test::Warn
1450 Could not read '/root/.cpan/build/Test-Warn-0.10-9ekdi2/META.yml'. Falling back to other methods to determine prerequisites
1451 ---- Unsatisfied dependencies detected during ----
1452 ----       CHORNY/Test-Warn-0.10.tar.gz       ----
1453     Test::Exception [requires]
1454     Sub::Uplevel [requires]
1455     Array::Compare [requires]
1456     Tree::DAG_Node [requires]
1457 Shall I follow them and prepend them to the queue
1458 of modules we are processing right now? [yes]
1459
1460
1461 ---- Unsatisfied dependencies detected during ----
1462 ----      ADIE/Test-Exception-0.27.tar.gz     ----
1463     Sub::Uplevel [requires]
1464 Shall I follow them and prepend them to the queue
1465 of modules we are processing right now? [yes]
1466
1467
1468 cpan[2]> quit
1469 Lockfile removed.
1470 |--------------------
1471
1472 === Install some "Date" Perl Modules ===
1473
1474 myhost:~/koha-3.00.00 # yast -i perl-Date-Calc
1475 |--------------------
1476 [This will also install 2 other dependencies: perl-Carp-Clan and perl-Bit-Vector]
1477
1478 |--------------------
1479 myhost:~/koha-3.00.00 # cpan
1480
1481 cpan shell -- CPAN exploration and modules installation (v1.9205)
1482 ReadLine support enabled
1483
1484 cpan[1]> install Date::ICal
1485
1486
1487 Warning: prerequisite Date::Leapyear 1.03 not found.
1488 Writing Makefile for Date::ICal
1489 ---- Unsatisfied dependencies detected during ----
1490 ----        RBOW/Date-ICal-1.72.tar.gz        ----
1491     Date::Leapyear [requires]
1492 Shall I follow them and prepend them to the queue
1493 of modules we are processing right now? [yes]
1494
1495
1496 cpan[2]> quit
1497 Lockfile removed.
1498
1499 myhost:~/koha-3.00.00 # yast -i perl-DateManip
1500 |--------------------
1501
1502 === Install the "GD::Barcode::UPCE" Perl Module ===
1503 |--------------------
1504 myhost:~/Koha # cpan
1505
1506 cpan shell -- CPAN exploration and modules installation (v1.9205)
1507 ReadLine support enabled
1508
1509 cpan[1]> install GD::Barcode::UPCE
1510 |--------------------
1511
1512 === Install the "HTML::Template::Pro" Perl Module ===
1513
1514 In the same CPAN prompt, type the following command:
1515 |--------------------
1516 cpan[2]> install HTML::Template::Pro
1517
1518 cpan[3]> quit
1519 Lockfile removed.
1520 |--------------------
1521
1522
1523 === Install ImageMagick ===
1524 |--------------------
1525 myhost:~/koha-3.00.00 # yast -i perl-PerlMagick
1526 |--------------------
1527
1528 [This will install 3 other dependencies: libMagickCore1, libMagickWand1 and ImageMagick]
1529
1530 === Install the "Lingua::Stem" Perl Module ===
1531 |--------------------
1532 myhost:~ # cpan
1533
1534 cpan shell -- CPAN exploration and modules installation (v1.9205)
1535 ReadLine support enabled
1536
1537 cpan[1]> install Lingua::Stem
1538
1539
1540 Checking prerequisites...
1541  - ERROR: Lingua::PT::Stemmer is not installed
1542  - ERROR: Lingua::Stem::It is not installed
1543  - ERROR: Lingua::Stem::Snowball::No is not installed
1544  - ERROR: Text::German is not installed
1545  - ERROR: Lingua::Stem::Snowball::Se is not installed
1546  - ERROR: Lingua::Stem::Fr is not installed
1547  - ERROR: Lingua::GL::Stemmer is not installed
1548  - ERROR: Lingua::Stem::Snowball::Da is not installed
1549  - ERROR: Lingua::Stem::Ru is not installed
1550
1551 ERRORS/WARNINGS FOUND IN PREREQUISITES.  You may wish to install the versions
1552 of the modules indicated above before proceeding with this installation
1553
1554 Creating new 'Build' script for 'Lingua-Stem' version '0.83'
1555 Could not read '/root/.cpan/build/Lingua-Stem-0.83-cmPLcK/META.yml'. Falling back to other methods to determine prerequisites
1556 ---- Unsatisfied dependencies detected during ----
1557 ----     SNOWHARE/Lingua-Stem-0.83.tar.gz     ----
1558     Lingua::PT::Stemmer [requires]
1559     Lingua::Stem::It [requires]
1560     Lingua::Stem::Snowball::No [requires]
1561     Text::German [requires]
1562     Lingua::Stem::Snowball::Se [requires]
1563     Lingua::Stem::Fr [requires]
1564     Lingua::GL::Stemmer [requires]
1565     Lingua::Stem::Snowball::Da [requires]
1566     Lingua::Stem::Ru [requires]
1567 Shall I follow them and prepend them to the queue
1568 of modules we are processing right now? [yes]
1569 |--------------------
1570
1571 === Install the "HTML::Scruber" Perl Module ===
1572 In the same CPAN prompt, type the following command:
1573 |--------------------
1574 cpan[2]> install HTML::Scrubber
1575
1576
1577 cpan[3]> quit
1578 Lockfile removed.
1579 |--------------------
1580
1581 === Install the "List::MoreUtils" Perl Module ===
1582 |--------------------
1583 myhost:~ # yast -i perl-List-MoreUtils
1584 |--------------------
1585 (If the above command does not work, you probably did not set up the "Official openSUSE 11.0 OSS Repository". See the "Configure Software Repositories" section earlier in this document that explains how you set up it inside yast).
1586
1587 === Install some "MARC" Perl Modules ===
1588 |--------------------
1589 myhost:~ # cpan
1590
1591 cpan shell -- CPAN exploration and modules installation (v1.9205)
1592 ReadLine support enabled
1593
1594 cpan[1]> install MARC::Charset
1595
1596 cpan[2]> install MARC::Crosswalk::DublinCore
1597
1598
1599 Checking prerequisites...
1600  - ERROR: DublinCore::Record is not installed
1601  - ERROR: MARC::Record is not installed
1602
1603 ERRORS/WARNINGS FOUND IN PREREQUISITES.  You may wish to install the versions
1604 of the modules indicated above before proceeding with this installation
1605
1606 Creating new 'Build' script for 'MARC-Crosswalk-DublinCore' version '0.02'
1607 Could not read '/root/.cpan/build/MARC-Crosswalk-DublinCore-0.02-xrMlqr/META.yml'. Falling back to other methods to determine
1608
1609 prerequisites
1610 ----   Unsatisfied dependencies detected during   ----
1611 ---- BRICAS/MARC-Crosswalk-DublinCore-0.02.tar.gz ----
1612     DublinCore::Record [requires]
1613     MARC::Record [requires]
1614 Shall I follow them and prepend them to the queue
1615 of modules we are processing right now? [yes]
1616
1617
1618 cpan[3]> install MARC::File::XML
1619
1620
1621 cpan[4]> install MARC::Record
1622 MARC::Record is up to date (2.0.0).
1623
1624
1625 cpan[3]> quit
1626 Lockfile removed.
1627 |--------------------
1628
1629 === Install the "Mail::Sendmail" Perl Module ===
1630 |--------------------
1631 myhost:~ # yast -i perl-Mail-Sendmail
1632 |--------------------
1633 (If the above command does not work, you probably did not set up the "Official openSUSE 11.0 OSS Repository". See the "Configure Software Repositories" section earlier in this document that explains how you set up it inside yast).
1634
1635 === Install some "Net" Perl Modules ===
1636 |--------------------
1637 myhost:~ # cpan
1638
1639 cpan shell -- CPAN exploration and modules installation (v1.9205)
1640 ReadLine support enabled
1641
1642 cpan[1]> install Net::LDAP
1643
1644
1645 *** Module::AutoInstall version 1.03
1646 *** Checking for Perl dependencies...
1647 [Core Features]
1648 - Convert::ASN1    ...missing. (would need 0.07)
1649 ==> Auto-install the 1 mandatory module(s) from CPAN? [y]
1650 [SASL authentication]
1651 - Authen::SASL     ...missing. (would need 2.00)
1652 ==> Auto-install the 1 optional module(s) from CPAN? [n]
1653 [LDAP URLs]
1654 - URI::ldap        ...loaded. (1.11 >= 1.1)
1655 [LDAPS]
1656 - IO::Socket::SSL  ...missing. (would need 0.81)
1657 ==> Auto-install the 1 optional module(s) from CPAN? [n]
1658 [Read/Write DSML files]
1659 - MIME::Base64     ...loaded. (3.07_01)
1660 - XML::SAX::Writer ...missing.
1661 ==> Auto-install the 1 optional module(s) from CPAN? [n]
1662 [Read/Write LDIF files]
1663 - MIME::Base64     ...loaded. (3.07_01)
1664
1665 *** Since we're running under CPANPLUS, I'll just let it take care
1666     of the dependency's installation later.
1667 *** Module::AutoInstall configuration finished.
1668
1669 *** Since we're running under CPANPLUS, I'll just let it take care
1670     of the dependency's installation later.
1671 Checking if your kit is complete...
1672 Looks good
1673 Warning: prerequisite Convert::ASN1 0.07 not found.
1674 Writing Makefile for Net::LDAP
1675 Could not read '/root/.cpan/build/perl-ldap-0.36-gUbl59/META.yml'. Falling back to other methods to determine prerequisites
1676 ---- Unsatisfied dependencies detected during ----
1677 ----        GBARR/perl-ldap-0.36.tar.gz       ----
1678     Convert::ASN1 [requires]
1679 Shall I follow them and prepend them to the queue
1680 of modules we are processing right now? [yes]
1681
1682
1683 cpan[16]> install Net::LDAP::Filter
1684 Net::LDAP::Filter is up to date (0.15).
1685
1686
1687 cpan[7]> install Net::Z3950::ZOOM
1688 Running install for module 'Net::Z3950::ZOOM'
1689 'YAML' not installed, falling back to Data::Dumper and Storable to read prefs '/root/.cpan/prefs'
1690 Running make for M/MI/MIRK/Net-Z3950-ZOOM-1.21.tar.gz
1691 Fetching with LWP:
1692   ftp://ftp.isr.ist.utl.pt/pub/CPAN/authors/id/M/MI/MIRK/Net-Z3950-ZOOM-1.21.tar.gz
1693 Checksum for /root/.cpan/sources/authors/id/M/MI/MIRK/Net-Z3950-ZOOM-1.21.tar.gz ok
1694 Net-Z3950-ZOOM-1.21/
1695 Net-Z3950-ZOOM-1.21/samples/
1696 Net-Z3950-ZOOM-1.21/samples/zoom/
1697 Net-Z3950-ZOOM-1.21/samples/zoom/trivial-async.pl
1698 Net-Z3950-ZOOM-1.21/samples/zoom/zdump.pl
1699 Net-Z3950-ZOOM-1.21/samples/zoom/async.pl
1700 Net-Z3950-ZOOM-1.21/samples/zoom/zoomscan.pl
1701 Net-Z3950-ZOOM-1.21/samples/zoom/zhello.pl
1702 Net-Z3950-ZOOM-1.21/samples/zoom/zoomtst1.pl
1703 Net-Z3950-ZOOM-1.21/samples/zoom/zselect
1704 Net-Z3950-ZOOM-1.21/samples/zoom/update.pl
1705 Net-Z3950-ZOOM-1.21/samples/zoom/zoomtst3.pl
1706 Net-Z3950-ZOOM-1.21/samples/README
1707 Net-Z3950-ZOOM-1.21/samples/net-z3950/
1708 Net-Z3950-ZOOM-1.21/samples/net-z3950/zoomtst1.pl
1709 Net-Z3950-ZOOM-1.21/samples/records/
1710 Net-Z3950-ZOOM-1.21/samples/records/esdd0006.grs
1711 Net-Z3950-ZOOM-1.21/samples/ccl/
1712 Net-Z3950-ZOOM-1.21/samples/ccl/default.bib
1713 Net-Z3950-ZOOM-1.21/samples/cql/
1714 Net-Z3950-ZOOM-1.21/samples/cql/pqf.properties
1715 Net-Z3950-ZOOM-1.21/samples/net-z3950-zoom/
1716 Net-Z3950-ZOOM-1.21/samples/net-z3950-zoom/async.pl
1717 Net-Z3950-ZOOM-1.21/samples/net-z3950-zoom/zoomtst1.pl
1718 Net-Z3950-ZOOM-1.21/samples/net-z3950-zoom/zoomtst3.pl
1719 Net-Z3950-ZOOM-1.21/README
1720 Net-Z3950-ZOOM-1.21/Changes
1721 Net-Z3950-ZOOM-1.21/META.yml
1722 Net-Z3950-ZOOM-1.21/MANIFEST
1723 Net-Z3950-ZOOM-1.21/ZOOM.xs
1724 Net-Z3950-ZOOM-1.21/MANIFEST.SKIP
1725 Net-Z3950-ZOOM-1.21/Makefile.PL
1726 Net-Z3950-ZOOM-1.21/t/
1727 Net-Z3950-ZOOM-1.21/t/29-events.t
1728 Net-Z3950-ZOOM-1.21/t/11-option-callback.t
1729 Net-Z3950-ZOOM-1.21/t/15-scan.t
1730 Net-Z3950-ZOOM-1.21/t/16-packages.t
1731 Net-Z3950-ZOOM-1.21/t/13-resultset.t
1732 Net-Z3950-ZOOM-1.21/t/24-sorting.t
1733 Net-Z3950-ZOOM-1.21/t/17-logging.t
1734 Net-Z3950-ZOOM-1.21/t/20-options.t
1735 Net-Z3950-ZOOM-1.21/t/12-query.t
1736 Net-Z3950-ZOOM-1.21/t/10-options.t
1737 Net-Z3950-ZOOM-1.21/t/1-Net-Z3950-ZOOM.t
1738 Net-Z3950-ZOOM-1.21/t/22-query.t
1739 Net-Z3950-ZOOM-1.21/t/27-logging.t
1740 Net-Z3950-ZOOM-1.21/t/25-scan.t
1741 Net-Z3950-ZOOM-1.21/t/19-events.t
1742 Net-Z3950-ZOOM-1.21/t/14-sorting.t
1743 Net-Z3950-ZOOM-1.21/t/28-charset.t
1744 Net-Z3950-ZOOM-1.21/t/23-resultset.t
1745 Net-Z3950-ZOOM-1.21/t/26-packages.t
1746 Net-Z3950-ZOOM-1.21/t/18-charset.t
1747 Net-Z3950-ZOOM-1.21/t/2-ZOOM.t
1748 Net-Z3950-ZOOM-1.21/t/21-option-callback.t
1749 Net-Z3950-ZOOM-1.21/typemap
1750 Net-Z3950-ZOOM-1.21/lib/
1751 Net-Z3950-ZOOM-1.21/lib/ZOOM.pm
1752 Net-Z3950-ZOOM-1.21/lib/ZOOM.pod
1753 Net-Z3950-ZOOM-1.21/lib/Net/
1754 Net-Z3950-ZOOM-1.21/lib/Net/Z3950/
1755 Net-Z3950-ZOOM-1.21/lib/Net/Z3950/ZOOM.pm
1756 Net-Z3950-ZOOM-1.21/lib/Net/Z3950.pm
1757 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1758
1759   CPAN.pm: Going to build M/MI/MIRK/Net-Z3950-ZOOM-1.21.tar.gz
1760
1761 ERROR: Unable to call script: yaz-config
1762 If you are using a YAZ installation from the Debian package "yaz", you
1763 will also need to install "libyaz-dev" in order to build this module.
1764 Warning: No success on command[/usr/bin/perl Makefile.PL]
1765 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1766   MIRK/Net-Z3950-ZOOM-1.21.tar.gz
1767   /usr/bin/perl Makefile.PL -- NOT OK
1768 Running make test
1769   Make had some problems, won't test
1770 Running make install
1771   Make had some problems, won't install
1772 Could not read '/root/.cpan/build/Net-Z3950-ZOOM-1.21-gHBrEl/META.yml'. Falling back to other methods to determine
1773
1774 prerequisites
1775 Failed during this command:
1776  MIRK/Net-Z3950-ZOOM-1.21.tar.gz              : writemakefile NO '/usr/bin/perl Makefile.PL' returned status 512
1777 |--------------------
1778
1779   * Installing libyaz and libyaz-devel for Net::Z3950::ZOOM
1780 OK... So we ran through a problem with a missing "yaz-config" while installing Net::Z3950::ZOOM. To solve this, let's first install the libyaz package:
1781 |--------------------
1782 # yast -i libyaz
1783 |--------------------
1784 [This will also install 1 dependency: libxslt]
1785
1786 We also have to install another package:libyaz-devel. libyaz-devel is NOT available in the openSUSE 11 DVD but it is available in the Official openSUSE 11 OSS Repository. If you have skipped that step, add that repository in yast first.
1787
1788   * Install the libyaz-devel package:
1789 |--------------------
1790 # yast -i libyaz-devel
1791 |--------------------
1792 (If the above command does not work, you probably did not set up the "Official openSUSE 11.0 OSS Repository". See the "Configure Software Repositories" section earlier in this document that explains how you set up it inside yast).
1793
1794 Installing libyaz-devel will also add some other packages that libyaz-devel depends on, namely:
1795 zlib-devel, tcpd-devel, tack, libgpg-error-devel, ncurses-devel, libopenssl-devel, libgcrypt-devel, readline-devel, libxml2-devel and libxslt-devel.
1796
1797
1798 Let's now install the Net::Z3950::ZOOM Module
1799
1800 |--------------------
1801 myhost:~ # cpan
1802
1803 cpan shell -- CPAN exploration and modules installation (v1.9205)
1804 ReadLine support enabled
1805
1806 cpan[1]> install Net::Z3950::ZOOM
1807 cpan[2]> quit
1808 Lockfile removed.
1809 |--------------------
1810
1811 === Install some "PDF" Perl Modules ===
1812
1813 |--------------------
1814 myhost:~ # yast -i perl-PDF-API2
1815
1816 myhost:~ # cpan
1817
1818 cpan shell -- CPAN exploration and modules installation (v1.9205)
1819 ReadLine support enabled
1820
1821 cpan[1]> install PDF::API2::Page
1822 PDF::API2::Page is up to date (2.001).
1823
1824 cpan[2]> install PDF::API2::Util
1825 PDF::API2::Util is up to date (2.000).
1826
1827
1828 cpan[3]> install PDF::Reuse
1829
1830
1831 cpan[4]> install PDF::Reuse::Barcode
1832
1833 Warning: prerequisite Barcode::Code128 0 not found.
1834 Writing Makefile for PDF::Reuse::Barcode
1835 ---- Unsatisfied dependencies detected during ----
1836 ----  LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz  ----
1837     Barcode::Code128 [requires]
1838 Shall I follow them and prepend them to the queue
1839 of modules we are processing right now? [yes]
1840
1841
1842 Checking if your kit is complete...
1843 Looks good
1844 Writing Makefile for Barcode::Code128
1845 cp lib/Barcode/Code128.pm blib/lib/Barcode/Code128.pm
1846 Manifying blib/man3/Barcode::Code128.3pm
1847   WRW/Barcode-Code128-2.01.tar.gz
1848   /usr/bin/make -- OK
1849 Running make test
1850 PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
1851 t/barcode......ok
1852 t/gif..........skipped: (no reason given)
1853 t/png..........skipped: (no reason given)
1854
1855 Test Summary Report
1856 -------------------
1857 t/gif.t    (Wstat: 0 Tests: 1 Failed: 1)
1858   Failed test:  1
1859   Parse errors: Bad plan.  You planned 0 tests but ran 1.
1860 t/png.t    (Wstat: 0 Tests: 1 Failed: 1)
1861   Failed test:  1
1862   Parse errors: Bad plan.  You planned 0 tests but ran 1.
1863 Files=3, Tests=4,  0 wallclock secs ( 0.04 usr  0.07 sys +  0.08 cusr  0.07 csys =  0.26 CPU)
1864 Result: FAIL
1865 Failed 2/3 test programs. 2/4 subtests failed.
1866 make: *** [test_dynamic] Error 255
1867   WRW/Barcode-Code128-2.01.tar.gz
1868   /usr/bin/make test -- NOT OK
1869 //hint// to see the cpan-testers results for installing this module, try:
1870   reports WRW/Barcode-Code128-2.01.tar.gz
1871 Running make install
1872   make test had returned bad status, won't install without force
1873 Running make for L/LA/LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1874   Has already been unwrapped into directory /root/.cpan/build/PDF-Reuse-Barcode-0.05-ahdM1s
1875
1876   CPAN.pm: Going to build L/LA/LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1877
1878 Warning: Prerequisite 'Barcode::Code128 => 0' for 'L/LA/LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz' failed when processing
1879
1880 'W/WR/WRW/Barcode-Code128-2.01.tar.gz' with 'make_test => NO'. Continuing, but chances to succeed are limited.
1881 cp Barcode.pm blib/lib/PDF/Reuse/Barcode.pm
1882 Manifying blib/man3/PDF::Reuse::Barcode.3pm
1883   LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1884   /usr/bin/make -- OK
1885 Running make test
1886 PERL_DL_NONLAZY=1 /usr/bin/perl "-Iblib/lib" "-Iblib/arch" test.pl
1887 1..15
1888 # Running under perl version 5.008008 for linux
1889 # Current time local: Thu May  8 00:11:00 2008
1890 # Current time GMT:   Wed May  7 23:11:00 2008
1891 # Using Test.pm version 1.25
1892 ok 1
1893 ok 2
1894 ok 3
1895 ok 4
1896 ok 5
1897 ok 6
1898 ok 7
1899 ok 8
1900 ok 9
1901 ok 10
1902 ok 11
1903 ok 12
1904 ok 13
1905 Can't find Barcode::Code128 - can't produce those barcodes
1906 not ok 14
1907 # Failed test 14 in test.pl at line 18
1908 #  test.pl line 18 is: ok(find('Barcode::Code128'));
1909 ok 15
1910   LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1911 Tests succeeded but one dependency not OK (Barcode::Code128)
1912   LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1913   [dependencies] -- NA
1914 Running make install
1915   make test had returned bad status, won't install without force
1916 Failed during this command:
1917  WRW/Barcode-Code128-2.01.tar.gz              : make_test NO
1918  LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz       : make_test NO one dependency not OK (Barcode::Code128)
1919 |--------------------
1920
1921
1922 [Strangely enough, simply repeating the installation of PDF::Reuse::Barcode will solve the problem:]
1923
1924 |--------------------
1925 cpan[5]> install PDF::Reuse::Barcode
1926
1927 Warning: prerequisite Barcode::Code128 0 not found.
1928 Writing Makefile for PDF::Reuse::Barcode
1929 ---- Unsatisfied dependencies detected during ----
1930 ----  LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz  ----
1931     Barcode::Code128 [requires]
1932 Shall I follow them and prepend them to the queue
1933 of modules we are processing right now? [yes]
1934
1935 Running make test
1936 PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
1937 t/barcode....ok
1938 t/gif........ok 1/0skipped
1939         all skipped: no reason given
1940 t/png........ok 1/0skipped
1941         all skipped: no reason given
1942 All tests successful, 2 tests skipped.
1943 Files=3, Tests=2,  0 wallclock secs ( 0.08 cusr +  0.12 csys =  0.20 CPU)
1944   WRW/Barcode-Code128-2.01.tar.gz
1945   /usr/bin/make test -- OK
1946 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1947 Running make install
1948 Prepending /root/.cpan/build/Barcode-Code128-2.01-e04Iz4/blib/arch /root/.cpan/build/Barcode-Code128-2.01-e04Iz4/blib/lib to
1949
1950 PERL5LIB for 'install'
1951 Installing /usr/lib/perl5/site_perl/5.10.0/Barcode/Code128.pm
1952 Installing /usr/share/man/man3/Barcode::Code128.3pm
1953 Writing /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi/auto/Barcode/Code128/.packlist
1954 Appending installation info to /usr/lib/perl5/5.10.0/i586-linux-thread-multi/perllocal.pod
1955   WRW/Barcode-Code128-2.01.tar.gz
1956   /usr/bin/make install  -- OK
1957 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1958 Running make for L/LA/LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1959   Has already been unwrapped into directory /root/.cpan/build/PDF-Reuse-Barcode-0.05-tGszYX
1960
1961   CPAN.pm: Going to build L/LA/LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1962
1963 cp Barcode.pm blib/lib/PDF/Reuse/Barcode.pm
1964 Manifying blib/man3/PDF::Reuse::Barcode.3pm
1965   LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1966   /usr/bin/make -- OK
1967 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1968 Running make test
1969 PERL_DL_NONLAZY=1 /usr/bin/perl "-Iblib/lib" "-Iblib/arch" test.pl
1970 1..15
1971 # Running under perl version 5.010000 for linux
1972 # Current time local: Sun Jun  1 20:25:57 2008
1973 # Current time GMT:   Sun Jun  1 19:25:57 2008
1974 # Using Test.pm version 1.25
1975 ok 1
1976 ok 2
1977 ok 3
1978 ok 4
1979 ok 5
1980 ok 6
1981 ok 7
1982 ok 8
1983 ok 9
1984 ok 10
1985 ok 11
1986 ok 12
1987 ok 13
1988 ok 14
1989 ok 15
1990   LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
1991   /usr/bin/make test -- OK
1992 Warning (usually harmless): 'YAML' not installed, will not store persistent state
1993 Running make install
1994 Prepending /root/.cpan/build/PDF-Reuse-Barcode-0.05-tGszYX/blib/arch /root/.cpan/build/PDF-Reuse-Barcode-0.05-tGszYX/blib/lib
1995
1996 to PERL5LIB for 'install'
1997 Installing /usr/lib/perl5/site_perl/5.10.0/PDF/Reuse/Barcode.pm
1998 Installing /usr/share/man/man3/PDF::Reuse::Barcode.3pm
1999 Writing /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi/auto/PDF/Reuse/Barcode/.packlist
2000 Appending installation info to /usr/lib/perl5/5.10.0/i586-linux-thread-multi/perllocal.pod
2001   LARSLUND/PDF-Reuse-Barcode-0.05.tar.gz
2002   /usr/bin/make install  -- OK
2003 Warning (usually harmless): 'YAML' not installed, will not store persistent state
2004 |--------------------
2005
2006
2007 === Install the "POE" Perl Module ===
2008 In the same CPAN prompt, type the following command:
2009 |--------------------
2010 cpan[7]> install POE
2011
2012
2013 Some of POE's tests require a functional network.
2014 You can skip these tests if you'd like.
2015
2016 Would you like to skip the network tests? [n]
2017
2018 *** Some optional features may not be available:
2019 ***   Curses 1.08 could not be loaded.
2020 ***   Event 1 could not be loaded.
2021 ***   Gtk 0.7009 could not be loaded.
2022 ***   IO::Pty 1.02 could not be loaded.
2023 ***   Socket6 0.14 could not be loaded.
2024 ***   Tk 800.027 could not be loaded.
2025 Checking if your kit is complete...
2026 Looks good
2027 Writing Makefile for POE
2028 |--------------------
2029
2030
2031 === Install the "Schedule::At" Perl Module ===
2032
2033   * Install "at":
2034 |--------------------
2035 # yast -i at
2036 |--------------------
2037   * Install the Schedule::At Perl module:
2038 |--------------------
2039 myhost:~ # cpan
2040
2041 cpan shell -- CPAN exploration and modules installation (v1.9205)
2042 ReadLine support enabled
2043
2044 cpan[1]> install Schedule::At
2045 |--------------------
2046
2047 === Install some "Text" Perl Modules ===
2048 In the same CPAN prompt, type the following command:
2049 |--------------------
2050 cpan[2]> install Text::CSV
2051
2052
2053 cpan[3]> install Text::CSV_XS
2054
2055
2056 cpan[4]> install Text::Iconv
2057
2058 cpan[5]> quit
2059 Lockfile removed.
2060 |--------------------
2061
2062 === Install some "XML" Perl Modules ===
2063 |--------------------
2064 myhost:~ # yast -i perl-XML-Dumper
2065
2066 myhost:~ # yast -i perl-XML-LibXSLT
2067
2068
2069 myhost:~ # cpan
2070
2071 cpan shell -- CPAN exploration and modules installation (v1.9205)
2072 ReadLine support enabled
2073
2074
2075 cpan[1]> install XML::RSS
2076
2077 Warning: prerequisite DateTime 0 not found.
2078 Warning: prerequisite DateTime::Format::Mail 0 not found.
2079 Warning: prerequisite DateTime::Format::W3CDTF 0 not found.
2080 Warning: prerequisite Test::Manifest 0.9 not found.
2081 Writing Makefile for XML::RSS
2082 Could not read '/root/.cpan/build/XML-RSS-1.32-7BXl7q/META.yml'. Falling back to other methods to determine prerequisites
2083 ---- Unsatisfied dependencies detected during ----
2084 ----        SHLOMIF/XML-RSS-1.32.tar.gz       ----
2085     DateTime [requires]
2086     DateTime::Format::W3CDTF [requires]
2087     Test::Manifest [requires]
2088     DateTime::Format::Mail [requires]
2089 Shall I follow them and prepend them to the queue
2090 of modules we are processing right now? [yes]
2091
2092 Warning: prerequisite DateTime::Locale 0.4 not found.
2093 Warning: prerequisite DateTime::TimeZone 0.59 not found.
2094 Warning: prerequisite Params::Validate 0.76 not found.
2095 Writing Makefile for DateTime
2096 Could not read '/root/.cpan/build/DateTime-0.4302-YXqzkk/META.yml'. Falling back to other methods to determine prerequisites
2097 ---- Unsatisfied dependencies detected during ----
2098 ----      DROLSKY/DateTime-0.4302.tar.gz      ----
2099     DateTime::Locale [requires]
2100     DateTime::TimeZone [requires]
2101     Params::Validate [requires]
2102 Shall I follow them and prepend them to the queue
2103 of modules we are processing right now? [yes]
2104
2105
2106 Checking prerequisites...
2107  - ERROR: Params::Validate is not installed
2108
2109 ERRORS/WARNINGS FOUND IN PREREQUISITES.  You may wish to install the versions
2110 of the modules indicated above before proceeding with this installation
2111
2112 Creating new 'Build' script for 'DateTime-Locale' version '0.4001'
2113 Could not read '/root/.cpan/build/DateTime-Locale-0.4001-ThLGMW/META.yml'. Falling back to other methods to determine
2114
2115 prerequisites
2116 ---- Unsatisfied dependencies detected during ----
2117 ----   DROLSKY/DateTime-Locale-0.4001.tar.gz  ----
2118     Params::Validate [requires]
2119 Shall I follow them and prepend them to the queue
2120 of modules we are processing right now? [yes]
2121
2122
2123 Checking prerequisites...
2124  - ERROR: Class::Singleton is not installed
2125
2126 ERRORS/WARNINGS FOUND IN PREREQUISITES.  You may wish to install the versions
2127 of the modules indicated above before proceeding with this installation
2128
2129 Creating new 'Build' script for 'DateTime-TimeZone' version '0.77'
2130 Could not read '/root/.cpan/build/DateTime-TimeZone-0.77-MPrKnn/META.yml'. Falling back to other methods to determine
2131
2132 prerequisites
2133 ---- Unsatisfied dependencies detected during ----
2134 ----   DROLSKY/DateTime-TimeZone-0.77.tar.gz  ----
2135     Class::Singleton [requires]
2136 Shall I follow them and prepend them to the queue
2137 of modules we are processing right now? [yes]
2138
2139
2140 cpan[2]> quit
2141 Lockfile removed.
2142 |--------------------
2143
2144 === Install the "YAML::Syck" Perl Module ===
2145 |--------------------
2146 myhost:~ # yast -i perl-YAML-Syck
2147 |--------------------
2148
2149
2150 ==== Create the Koha User and Group ====
2151
2152 |--------------------
2153 # useradd koha
2154
2155 # passwd koha
2156 Changing password for koha.
2157 New Password:
2158 Reenter New Password:
2159 Password changed.
2160
2161 # groupadd koha
2162 |--------------------
2163
2164 ==== Run make test ====
2165 |--------------------
2166 myhost:~/Koha # make test
2167 cp koha-tmpl/opac-tmpl/prog/famfamfam/silk/error_go.png blib/OPAC_TMPL_DIR/prog/famfamfam/silk/error_go.png
2168 cp opac/opac-changelanguage.pl blib/OPAC_CGI_DIR/opac/opac-changelanguage.pl
2169 cp koha-tmpl/intranet-tmpl/prog/img/itemtypeimg/liblime-kids/card.gif
2170
2171 blib/INTRANET_TMPL_DIR/prog/img/itemtypeimg/liblime-kids/card.gif
2172 cp koha-tmpl/opac-tmpl/prog/famfamfam/mini/note.gif blib/OPAC_TMPL_DIR/prog/famfamfam/mini/note.gif
2173 |--------------------
2174 [many more lines beginning with "cp" should appear...]
2175
2176 |--------------------
2177 cp koha-tmpl/opac-tmpl/prog/famfamfam/silk/shape_rotate_clockwise.png
2178
2179 blib/OPAC_TMPL_DIR/prog/famfamfam/silk/shape_rotate_clockwise.png
2180 cp koha-tmpl/opac-tmpl/prog/famfamfam/mini/page_text.gif blib/OPAC_TMPL_DIR/prog/famfamfam/mini/page_text.gif
2181 PERL_DL_NONLAZY=1 KOHA_CONF=blib/KOHA_CONF_DIR/koha-conf.xml /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0,
2182
2183 'blib/PERL_MODULE_DIR', 'blib/arch')" t/*.t
2184 t/Amazon....................ok
2185 t/Barcodes_PrinterConfig....ok
2186 t/Bookfund..................ok
2187 t/Bookseller................ok
2188 t/Boolean...................ok
2189 t/Branch....................ok
2190 t/Calendar..................ok
2191 t/Charset...................ok
2192 t/Date......................ok 1/4Use of uninitialized value $db_driver in concatenation (.) or string at
2193
2194 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2195 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to
2196
2197 use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2198
2199 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2200 # Looks like you planned 4 tests but only ran 1.
2201 # Looks like your test died just after 1.
2202 t/Date......................dubious
2203         Test returned status 255 (wstat 65280, 0xff00)
2204 DIED. FAILED tests 2-4
2205         Failed 3/4 tests, 25.00% okay
2206 t/Dates.....................ok 1/126#
2207 #  Testing Legacy Functions: format_date and format_date_in_iso
2208 Use of uninitialized value $db_driver in concatenation (.) or string at /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2209 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2210
2211 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2212 # Looks like you planned 126 tests but only ran 1.
2213 # Looks like your test died just after 1.
2214 t/Dates.....................dubious
2215         Test returned status 255 (wstat 65280, 0xff00)
2216 DIED. FAILED tests 2-126
2217         Failed 125/126 tests, 0.79% okay
2218 t/Debug.....................# BEFORE use:     $debug is not defined
2219 # BEFORE use: $cgi_debug is not defined
2220 t/Debug.....................ok 1/3#  AFTER use:     $debug is 0
2221 #  AFTER use: $cgi_debug is 0
2222 # Done.
2223 t/Debug.....................ok
2224 t/dummy.....................ok
2225 t/icondirectories...........Use of uninitialized value $src in string eq at /root/Koha/blib/PERL_MODULE_DIR/C4/Koha.pm line 465.
2226 Use of uninitialized value $db_driver in concatenation (.) or string at /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2227 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2228
2229 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2230 # Looks like your test died before it could output anything.
2231 t/icondirectories...........dubious
2232         Test returned status 255 (wstat 65280, 0xff00)
2233 DIED. FAILED test 1
2234         Failed 1/1 tests, 0.00% okay
2235 t/Input.....................ok
2236 t/Items.....................Use of uninitialized value $db_driver in concatenation (.) or string at
2237
2238 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2239 t/Items.....................NOK 1/28
2240 #   Failed test 'use C4::Items;'
2241 #   at t/Items.t line 11.
2242 #     Tried to use 'C4::Items'.
2243 #     Error:  Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2244
2245 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2246 # Compilation failed in require at /root/Koha/blib/PERL_MODULE_DIR/C4/Items.pm line 30.
2247 # Compilation failed in require at (eval 5) line 2.
2248 # BEGIN failed--compilation aborted at t/Items.t line 11.
2249 t/Items.....................ok 2/28Use of uninitialized value $db_driver in concatenation (.) or string at
2250
2251 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2252 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2253
2254 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2255 # Looks like you planned 28 tests but only ran 13.
2256 # Looks like you failed 1 test of 13 run.
2257 # Looks like your test died just after 13.
2258 t/Items.....................dubious
2259         Test returned status 255 (wstat 65280, 0xff00)
2260 DIED. FAILED tests 1, 14-28
2261         Failed 16/28 tests, 42.86% okay
2262 t/Koha......................ok
2263 t/Labels....................NOK 1/1
2264 #   Failed test 'use C4::Labels;'
2265 #   at t/Labels.t line 12.
2266 #     Tried to use 'C4::Labels'.
2267 #     Error:  Can't locate Algorithm/CheckDigits.pm in @INC (@INC contains: /root/Koha/blib/PERL_MODULE_DIR
2268
2269 /root/Koha/blib/arch /usr/lib/perl5/5.10.0/i586-linux-thread-multi /usr/lib/perl5/5.10.0/i586-linux-thread-multi
2270
2271 /usr/lib/perl5/5.10.0 /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi
2272
2273 /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/site_perl/5.10.0
2274
2275 /usr/lib/perl5/vendor_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/vendor_perl/5.10.0/i586-linux-thread-multi
2276
2277 /usr/lib/perl5/vendor_perl/5.10.0 /usr/lib/perl5/vendor_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/vendor_perl/5.10.0
2278
2279 /usr/lib/perl5/vendor_perl . /usr/lib/perl5/5.10.0/i586-linux-thread-multi /usr/lib/perl5/5.10.0
2280
2281 /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/site_perl/5.10.0
2282
2283 /usr/lib/perl5/vendor_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/vendor_perl/5.10.0 /usr/lib/perl5/vendor_perl .) at
2284
2285 /root/Koha/blib/PERL_MODULE_DIR/C4/Labels.pm line 25.
2286 # BEGIN failed--compilation aborted at t/Labels.t line 12.
2287 # Compilation failed in require at (eval 3) line 2.
2288 # BEGIN failed--compilation aborted at (eval 3) line 2.
2289 # Looks like you failed 1 test of 1.
2290 t/Labels....................dubious
2291         Test returned status 1 (wstat 256, 0x100)
2292 DIED. FAILED test 1
2293         Failed 1/1 tests, 0.00% okay
2294 t/Languages.................ok
2295 t/Maintainance..............ok
2296 t/Output....................ok
2297 t/Record....................ok
2298 t/Review....................ok
2299 t/Scrubber..................ok 1/10# Note: scrubber test output will have whitespace collapsed for readability
2300 # done.
2301 t/Scrubber..................ok
2302 t/Stats.....................ok
2303 Failed Test         Stat Wstat Total Fail  List of Failed
2304 -------------------------------------------------------------------------------
2305 t/Date.t             255 65280     4    6  2-4
2306 t/Dates.t            255 65280   126  250  2-126
2307 t/Items.t            255 65280    28   31  1 14-28
2308 t/Labels.t             1   256     1    1  1
2309 t/icondirectories.t  255 65280     1    2  1
2310 Failed 5/24 test scripts. 146/207 subtests failed.
2311 Files=24, Tests=207, 13 wallclock secs ( 5.96 cusr +  5.52 csys = 11.48 CPU)
2312 Failed 5/24 test programs. 146/207 subtests failed.
2313 make: *** [test_dynamic] Error 255
2314 |--------------------
2315
2316 === Install the "Algorithm::CheckDigits" Perl Module ===
2317
2318 Hmmm... Algorithm::CheckDigits seems to not have been installed. Let's install it:
2319
2320 |--------------------
2321 myhost:~ # cpan
2322 CPAN: File::HomeDir loaded ok (v0.69)
2323
2324 cpan shell -- CPAN exploration and modules installation (v1.9205)
2325 ReadLine support enabled
2326
2327
2328 cpan[1]> install Algorithm::CheckDigits
2329
2330 cpan[2]> quit
2331 Lockfile removed.
2332 |--------------------
2333
2334
2335 === Run "make test" again ===
2336
2337 Don't worry! It will run a LOT faster this time!  :)
2338 |--------------------
2339 myhost:~/Koha-3.00.00 # make test
2340 PERL_DL_NONLAZY=1 KOHA_CONF=blib/KOHA_CONF_DIR/koha-conf.xml /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0,
2341
2342 'blib/PERL_MODULE_DIR', 'blib/arch')" t/*.t
2343 t/Amazon....................ok
2344 t/Barcodes_PrinterConfig....ok
2345 t/Bookfund..................ok
2346 t/Bookseller................ok
2347 t/Boolean...................ok
2348 t/Branch....................ok
2349 t/Calendar..................ok
2350 t/Charset...................ok
2351 t/Date......................ok 1/4Use of uninitialized value $db_driver in concatenation (.) or string at
2352
2353 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2354 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2355
2356 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2357 # Looks like you planned 4 tests but only ran 1.
2358 # Looks like your test died just after 1.
2359 t/Date......................dubious
2360         Test returned status 255 (wstat 65280, 0xff00)
2361 DIED. FAILED tests 2-4
2362         Failed 3/4 tests, 25.00% okay
2363 t/Dates.....................ok 1/126#
2364 #  Testing Legacy Functions: format_date and format_date_in_iso
2365 Use of uninitialized value $db_driver in concatenation (.) or string at /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2366 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2367
2368 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2369 # Looks like you planned 126 tests but only ran 1.
2370 # Looks like your test died just after 1.
2371 t/Dates.....................dubious
2372         Test returned status 255 (wstat 65280, 0xff00)
2373 DIED. FAILED tests 2-126
2374         Failed 125/126 tests, 0.79% okay
2375 t/Debug.....................# BEFORE use:     $debug is not defined
2376 # BEFORE use: $cgi_debug is not defined
2377 t/Debug.....................ok 1/3#  AFTER use:     $debug is 0
2378 #  AFTER use: $cgi_debug is 0
2379 # Done.
2380 t/Debug.....................ok
2381 t/dummy.....................ok
2382 t/icondirectories...........Use of uninitialized value $src in string eq at /root/Koha/blib/PERL_MODULE_DIR/C4/Koha.pm line 465.
2383 Use of uninitialized value $db_driver in concatenation (.) or string at /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2384 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2385
2386 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2387 # Looks like your test died before it could output anything.
2388 t/icondirectories...........dubious
2389         Test returned status 255 (wstat 65280, 0xff00)
2390 DIED. FAILED test 1
2391         Failed 1/1 tests, 0.00% okay
2392 t/Input.....................ok
2393 t/Items.....................Use of uninitialized value $db_driver in concatenation (.) or string at
2394
2395 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2396 t/Items.....................NOK 1/28
2397 #   Failed test 'use C4::Items;'
2398 #   at t/Items.t line 11.
2399 #     Tried to use 'C4::Items'.
2400 #     Error:  Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2401
2402 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2403 # Compilation failed in require at /root/Koha/blib/PERL_MODULE_DIR/C4/Items.pm line 30.
2404 # Compilation failed in require at (eval 5) line 2.
2405 # BEGIN failed--compilation aborted at t/Items.t line 11.
2406 t/Items.....................ok 2/28Use of uninitialized value $db_driver in concatenation (.) or string at
2407
2408 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2409 Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2410
2411 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2412 # Looks like you planned 28 tests but only ran 13.
2413 # Looks like you failed 1 test of 13 run.
2414 # Looks like your test died just after 13.
2415 t/Items.....................dubious
2416         Test returned status 255 (wstat 65280, 0xff00)
2417 DIED. FAILED tests 1, 14-28
2418         Failed 16/28 tests, 42.86% okay
2419 t/Koha......................ok
2420 t/Labels....................Use of uninitialized value $db_driver in concatenation (.) or string at
2421
2422 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628.
2423 t/Labels....................NOK 1/1
2424 #   Failed test 'use C4::Labels;'
2425 #   at t/Labels.t line 12.
2426 #     Tried to use 'C4::Labels'.
2427 #     Error:  Can't connect to data source 'dbname=__DB_NAME__;host=__DB_HOST__;port=__DB_PORT__' because I can't work out what driver to use (it doesn't seem to contain a 'dbi:driver:' prefix and the DBI_DRIVER env var is not set) at
2428
2429 /root/Koha/blib/PERL_MODULE_DIR/C4/Context.pm line 628
2430 # Compilation failed in require at /root/Koha/blib/PERL_MODULE_DIR/C4/Circulation.pm line 25.
2431 # BEGIN failed--compilation aborted at t/Labels.t line 12.
2432 # Compilation failed in require at /root/Koha/blib/PERL_MODULE_DIR/C4/Overdues.pm line 24.
2433 # BEGIN failed--compilation aborted at /root/Koha/blib/PERL_MODULE_DIR/C4/Overdues.pm line 24.
2434 # Compilation failed in require at /root/Koha/blib/PERL_MODULE_DIR/C4/Members.pm line 27.
2435 # BEGIN failed--compilation aborted at /root/Koha/blib/PERL_MODULE_DIR/C4/Members.pm line 27.
2436 # Compilation failed in require at /root/Koha/blib/PERL_MODULE_DIR/C4/Labels.pm line 26.
2437 # BEGIN failed--compilation aborted at /root/Koha/blib/PERL_MODULE_DIR/C4/Labels.pm line 26.
2438 # Compilation failed in require at (eval 3) line 2.
2439 # BEGIN failed--compilation aborted at (eval 3) line 2.
2440 # Looks like you failed 1 test of 1.
2441 t/Labels....................dubious
2442         Test returned status 1 (wstat 256, 0x100)
2443 DIED. FAILED test 1
2444         Failed 1/1 tests, 0.00% okay
2445 t/Languages.................ok
2446 t/Maintainance..............ok
2447 t/Output....................ok
2448 t/Record....................ok
2449 t/Review....................ok
2450 t/Scrubber..................ok 1/10# Note: scrubber test output will have whitespace collapsed for readability
2451 # done.
2452 t/Scrubber..................ok
2453 t/Stats.....................ok
2454 Failed Test         Stat Wstat Total Fail  List of Failed
2455 -------------------------------------------------------------------------------
2456 t/Date.t             255 65280     4    6  2-4
2457 t/Dates.t            255 65280   126  250  2-126
2458 t/Items.t            255 65280    28   31  1 14-28
2459 t/Labels.t             1   256     1    1  1
2460 t/icondirectories.t  255 65280     1    2  1
2461 Failed 5/24 test scripts. 146/207 subtests failed.
2462 Files=24, Tests=207, 14 wallclock secs ( 6.93 cusr +  6.06 csys = 12.99 CPU)
2463 Failed 5/24 test programs. 146/207 subtests failed.
2464 make: *** [test_dynamic] Error 255
2465 |--------------------
2466
2467 == Run "make install" ==
2468
2469 Even with these errors in C4::Labels, we will run make install:
2470
2471 |--------------------
2472 myhost:~/Koha # make install
2473 |--------------------
2474 [Several lines starting with "Manifying" and many lines starting with "Installing" will scroll by...]
2475 |--------------------
2476 Installing /usr/share/koha/man/man3/cataloguing::value_builder::marc21_leader_computerfile.3pm
2477 Installing /usr/share/koha/man/man3/opac::opac-tags.3pm
2478 Installing /usr/share/koha/man/man3/cataloguing::value_builder::unimarc_field_123j.3pm
2479 Installing /usr/share/koha/man/man3/cataloguing::value_builder::marc21_field_003.3pm
2480 Installing /usr/share/koha/man/man3/authorities::detail.3pm
2481
2482 Koha's files have now been installed.
2483
2484 In order to use Koha's command-line batch jobs,
2485 you should set the following environment variables:
2486
2487 export KOHA_CONF=/etc/koha/koha-conf.xml
2488 export PERL5LIB=/usr/share/koha/lib
2489
2490 For other post-installation tasks, please consult the README.
2491
2492
2493 # cd /etc
2494 myhost:/etc #
2495 |--------------------
2496
2497 ==== Create /etc/bash.bashrc.local ====
2498 Create a file called bash.bashrc.local in the /etc directory:
2499 |--------------------
2500 myhost:/etc # vim /etc/bash.bashrc.local
2501 |--------------------
2502 add these 2 lines in the file:
2503 |--------------------
2504 export KOHA_CONF=/etc/koha/koha-conf.xml
2505 export PERL5LIB=/usr/share/koha/lib
2506 |--------------------
2507
2508 - EXIT THE SHELL AND LOG BACK IN.
2509 |--------------------
2510 myhost:/etc # exit
2511 |--------------------
2512 After logging back in, type the following commands to check if
2513 the KOHA_CONF and PERL5LIB environment variables have been correctly set:
2514 |--------------------
2515 myhost:~ # env | grep KOHA
2516 KOHA_CONF=/etc/koha/koha-conf.xml
2517
2518 myhost:~ # env | grep PERL5LIB
2519 PERL5LIB=/usr/share/koha/lib
2520 |--------------------
2521
2522 === Koha's Web Installer ===
2523
2524 Access Koha's web installer at:
2525
2526 http://192.168.0.2:8080/
2527
2528 Your browser will probably say that:
2529 |--------------------
2530 " The server at 192.168.0.2 is taking too long to respond."
2531 |--------------------
2532 OK... It seems that we have to do some things yet.
2533
2534
2535 == Create a symbolic link to /etc/koha/koha-httpd.conf ==
2536
2537 Let's create a symbolic link to the /etc/koha/koha-httpd.conf file in the /etc/apache2/vhosts.d directory:
2538 |--------------------
2539 myhost:~ # cd /etc/apache2/vhosts.d/
2540
2541 myhost:/etc/apache2/vhosts.d # ln -s /etc/koha/koha-httpd.conf koha-httpd.conf
2542 |--------------------
2543
2544   * Restart Apache
2545 |--------------------
2546 myhost:/etc/apache2/conf.d # service apache2 restart
2547 Syntax error on line 28 of /etc/apache2/conf.d/koha-httpd.conf:
2548 Invalid command 'RewriteEngine', perhaps misspelled or defined by a module not included in the server configuration
2549 |--------------------
2550
2551
2552 == Enable the mod_rewrite Apache module ==
2553
2554 OK... It seems that we need to enable the mod_rewrite Apache module:
2555 |--------------------
2556 myhost:/etc/sysconfig # a2enmod rewrite
2557 |--------------------
2558 [If the above command seems NOT to work, for some reason, do this - edit /etc/sysconfig/apache2 and add rewrite at the end of the APACHE_MODULES line, right before the right quote]
2559 |--------------------
2560 myhost:/etc/sysconfig # service apache2 restart
2561 Syntax OK
2562 Shutting down httpd2 (waiting for all children to terminate)         done
2563 Starting httpd2 (prefork)                                            done
2564 |--------------------
2565
2566 == Change koha-httpd.conf ==
2567
2568 If you browsed again to http://192.168.0.2:8080 you would still get no answer. This is because we still have to do some changes to the koha-httpd.conf file.
2569
2570 First, let's create a backup of this file:
2571 |--------------------
2572 myhost:/etc/apache2/vhosts.d # cp koha-httpd.conf koha-httpd.conf.ORIG
2573
2574
2575 myhost:/etc/koha # vim koha-httpd.conf
2576 |--------------------
2577
2578 At the beginning of the koha-httpd.conf file, under the commented NameVirtualHost line, add the following line:
2579 |--------------------
2580 Listen 8080
2581 |--------------------
2582 In that file, you should find two VirtualHost sections: one for the OPAC area of Koha and the other one for the Intranet.
2583 If the two virtualHost directives - the lines that start with <nowiki><VirtualHost</nowiki> - in that file are set for the IP Address 127.0.0.2, replace them by the correct IP address of your server.
2584
2585 That file will have 2 ServerName directives (one for each of the 2 VirtualHosts). In those directives, you should have the IP of your server -or- the FQDN of your server (example: ServerName www.koha.test).
2586
2587 |--------------------
2588 myhost:/etc/koha # service apache2 restart
2589 Syntax OK
2590 Shutting down httpd2 (waiting for all children to terminate)         done
2591 Starting httpd2 (prefork)                                            done
2592 |--------------------
2593
2594
2595 Try to access the web page:
2596
2597 http://192.168.0.2/
2598
2599 If you get again the "It Works!" web page, you'll probably have to Refresh/Reload the page in your browser (press the F5 key).
2600
2601 After reloading the page, you should get the following error:
2602 |--------------------
2603 Forbidden
2604
2605 You don't have permission to access / on this server.
2606
2607 Additionally, a 403 Forbidden error was encountered while trying to use an ErrorDocument to handle the request.
2608 Apache/2.2.4 (Linux/SUSE) Server at 192.168.0.2 Port 8080
2609 |--------------------
2610
2611 OK. Let's add then the following directive at the end of the koha-httpd.conf file:
2612 |--------------------
2613 <Directory /usr/share/koha>
2614         Order allow,deny
2615         Allow from all
2616 </Directory>
2617 |--------------------
2618
2619 Restart Apache:
2620 |--------------------
2621 myhost:/etc/apache2/vhosts.d # service apache2 restart
2622 Syntax OK
2623 Shutting down httpd2 (waiting for all children to terminate)         done
2624 Starting httpd2 (prefork)                                            done
2625 |--------------------
2626
2627 OK. Load again the following page in your web browser:
2628
2629 http://192.168.0.2
2630
2631 After some seconds you should be redirected to:
2632
2633 http://192.168.0.2/cgi-bin/koha/maintenance.pl
2634
2635
2636 and see a Koha page saying:
2637 |--------------------
2638 "System Maintenance ... we'll be back soon! If you have any questions, please contact the Site Administrator"
2639 |--------------------
2640
2641 This is actually GOOD NEWS!  :)  It's now time to set up Koha in the Intranet interface.
2642
2643
2644 To do that, browse to:
2645
2646
2647 http://192.168.0.2:8080
2648
2649 == Enable port 8080 in the firewall ==
2650
2651 After a while the page will probably time out. This is because we now have to allow the 8080 port in the firewall.
2652
2653 Let's run yast and do that:
2654 |--------------------
2655 myhost:/etc/apache2/vhosts.d # yast
2656 |--------------------
2657 Inside yast, go to "Security and Users" -> "Firewall"
2658
2659 Scroll down to "Allowed Services" on the right side and press ENTER
2660
2661 Press TAB several times until you reach the "Apache2" allowed service on the right side. When you do that,
2662 press Alt+d to click the "Advanced..." button.
2663
2664 A new window should open. Press Alt+T to go to the "TCP Ports" text box and enter the following values in that box:
2665 80 8080
2666
2667 Press Alt+O to click the OK button. That will send you back to the "Firewall Configuration:Allowed Services"
2668 screen. Press Alt+N to click the "Next" button.
2669
2670 You should now be in the "Firewall Configuration: Summary" screen. Press "Alt+F" to Finish.
2671
2672 You should now be again in the "YaST Control Center" screen. Press "Alt+Q" to quit yast.
2673
2674
2675 Go again to:
2676
2677 http://192.168.0.2:8080/
2678
2679 ... you should get redirected to:
2680
2681 http://192.168.0.2:8080/cgi-bin/koha/installer/install.pl
2682
2683 ... and see a page with the Koha Logo and the heading: "Welcome to the Koha Web Installer"!  :)
2684
2685
2686 You may now login with your koha administrator username and password and reply to the several questions you will be asked.