Copyright © 2006 Skemotah Solutions
This document is related to Koha and is licensed to you under the GNU General Public License version 2 or later (http://www.gnu.org/licenses/gpl.html).
Koha-related documents may be reproduced and distributed in whole or in part, in any medium physical or electronic, as long as this copyright notice is retained on all copies.
You may create a derivative work and distribute it provided that you:
-
License the derivative work with this same license, or the Linux Documentation Project License (http://www.tldp.org/COPYRIGHT.html). Include a copyright notice and at least a pointer to the license used.
-
Give due credit to previous authors and major contributors.
Commercial redistribution is allowed and encouraged; however, the author would like to be notified of any such distributions.
No liability for the contents of this document can be accepted. Use the concepts, examples and information at your own risk. There may be errors and inaccuracies, that could be damaging to your system. Proceed with caution, and although this is highly unlikely, the author(s) do not take any responsibility.
All copyrights are held by their by their respective owners, unless specifically noted otherwise. Use of a term in this document should not be regarded as affecting the validity of any trademark or service mark. Naming of particular products or brands should not be seen as endorsements.
2006-01-25
| Revision History | ||
|---|---|---|
| Revision 2.2.5 | 2006-01-25 | sh |
|
Initial version |
||
Most of Koha will work on the Mac OS X operating system, so long as
you have version 10.2 or higher. Earlier versions of OS X do not
support some of the other programs that Koha uses, particularly MySQL.
The one part of Koha that you will not be able to install is the Z39.50
client. That is because the current version of Koha (2.2.5) uses the Net::Z3950 Perl module, which in turn depends
on the Event module, which has not been
ported to OS X. This should be remedied in the future, beginning with
Koha version 3.0.
Because of this and some other limitations, I would not advise using Koha on OS X in a production environment. Until the next version of Koha is released, it is best to consider your Koha installation as a test-bed for experimenting with Koha. Version 3.0 will have enough stability on OS X to be used in production.
If you have OS X Server, some of the support programs that you need to run Koha will already be on your computer; if you do not, these instructions will help you get what you need to have. These instructions were developed in the course of installing Koha 2.2.5 on standard Mac OS X v10.3.9.
Special thanks to Adam Steer for sharing his experiences with Koha on Mac OS X.
Koha is a L.A.M.P application -- meaning that it is developed for use on systems running Linux, Apache, MySQL, and Perl. While other configurations are possible if you make modifications to Koha, these instructions assume that Koha will be installed without major modifications. So the first step is to set up your Mac OS X computer with all the programs and utilities necessary to run a L.A.M.P application.
Mac OS X is essentially a Linux OS (based loosely on FreeBSD), so technically you already have Linux. However, you may not have X11 and the developer tools, both of which will give you more complete Linux capabilities and make some aspects of Koha easier to manage.
To check to see if you have X11 on your Mac, go to Applications>Utilities and look for X11. If it is not there, you can download it from www.apple.com/downloads/macosx/apple/x11formacosx.html.
To install developer tools, go to Applications>Installers>Xcode Tools and open the Developer.mpkg package. If the package is not there, you can download it from developer.apple.com/tools.
Note
The Apple website tends to change fairly often, so don't be surprised if the URLs above do not work and you have to search to find the current download sites.
This one is easy. If you haven't already done so, go to System Preferences>Sharing and turn on Personal Web Sharing.
If you prefer working from a terminal window, you can also do:
emac:~ admin$ sudo apachectl start
Be ready to supply your administrator password (the one you use to apply system updates from Apple).
The web server configuration file, by the way, can be found at /etc/httpd/httpd.conf. You will need to modify
it after you install Koha.
Releases of MySQL are available as .dmg
files from http://downloads.mysql,com,
meaning they are easy to install; however, the newer releases of MySQL
can cause problems with Koha. Starting with version 4.1.x, MySQL uses a
new password hash that is not compatible with the Koha code. There's an
explanation of this problem at http://dev.mysql.com/doc/refman/4.1/en/old-client.html.
Beginning with version 5.0, MySQL treats return
as a reserved word; unfortunately, Koha uses return
as a data column name, so MySQL 5.0.x is unusable with Koha (at this
writing, at least).
The password problems and some other MySQL limitations can be avoided by downloading the OS X installer version of MySQL 4.1.16 from http://dev.mysql.com/downloads/mysql/4.1.html. Install both the MySQL package and the StartupItem package, then restart your computer. MySQL is now started. Before we install Koha, we'll do some things to work around the Koha limitations.
(If you are running Mac OS X Server, you are in luck -- MySQL is already on your machine. Just go to Applications>Server>MySQL Manager to access it. But be aware of the problems with versions later than 4.1. Generally, if your OS X Server is earlier than version 10.4, you'll have no problems, otherwise you'll need to take the following steps to work around the Koha limitations.)
Make a note of the root password for your MySQL -- you will need it when you install Koha. (In fact, if you just installed MySQL, I recommend that you leave the root password blank until after you have installed Koha.)
To make it easier to access MySQL later, you might want to set an alias or modify your PATH environment. For `tcsh' use:
alias mysql /usr/local/mysql/bin/mysql
alias mysqladmin /usr/local/mysql/bin/mysqladmin
Even better, add /usr/local/mysql/bin
to your `PATH' environment variable by adding the following line to
your `$HOME/.tcshrc' file if your shell is `tcsh':
setenv PATH ${PATH}:/usr/local/mysql/bin
For `bash', use:
alias mysql=/usr/local/mysql/bin/mysql
alias mysqladmin=/usr/local/mysql/bin/mysqladmin
Now go to a terminal window and access mysql as root:
[emac:~] admin% mysql -uroot
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 22 to server version: 4.1.16-standard
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
mysql>
From this mysql> prompt, enter GRANT ALL PRIVILEGES ON *.* to
'kohaadmin'@'localhost' IDENTIFIED BY 'xxxxxxxx'; where
the x's are replaced by a password. This assumes that you are going to
use the default "kohaadmin" user name for your database and will refer
to your computer as "localhost" when running Koha. (Note that the Koha
installer will try to grab whatever your Mac calls itself -- "emac" in
our example -- so remember to use "localhost" when the installer
prompts you for this information.) Make a note of the password you
choose, the installer will ask for it.
Next we need to keep the installer from trying to set up this same
account. When you unzip your Koha tarball, you will create a folder
called Koha-2.2.5, and in this folder
you will find Installer.pm. You will be
commenting lines 1812 and 1813 to prevent the installer from trying to
create the account you just created manually.
# print system("$mysqldir/bin/mysql -u$mysqluser -e \"insert into user (Host,User,Password)
values ('$hostname','$user',password('$pass'))\" mysql\;");
# system("$mysqldir/bin/mysql -u$mysqluser -e \"insert into db (Host,Db,User,Select_priv,
Insert_priv,Update_priv,Delete_priv,Create_priv,Drop_priv, index_priv, alter_priv)
values ('%','$database','$user','Y','Y','Y','Y','Y','Y','Y','Y')\" mysql");
Now your MySQL should be ready to go.
Note
Once again, this method of installing MySQL and setting up the Koha administrator account is not recommended for a production environment.
If you are running OS X 10.3 or later, this is the easiest step of all -- you already have Perl 5.8 on your machine. If you are running 10.2, then the instructions at http://developer.apple.com/internet/opensource/perl.html will help you get Perl set up on your computer.
You are also going to need some Perl modules, but we will deal with those in the course of our installation. For now, you should have everything you need to start the Koha installation.
First of all, go to http://sourceforge.net/projects/koha and get the
most recent version of the Koha tarball (currently 2.2.5 as this is
written). When you download this to your computer, your Mac should
automatically unzip it for you and leave you with a Koha-2.2.5 folder, most likely located on your
desktop.
Open a terminal window and navigate to this folder (e.g. cd Desktop/Koha-2.2.5). Then
start the install script:
emac:~/Desktop/Koha-2.2.5 admin$ sudo perl installer.pl
Password:
WELCOME TO THE KOHA INSTALLER
This program will ask some questions and try to install koha for you. You
need to know: where most koha files should be stored (you can set the
prefix environment variable for this); the username and password of a mysql
superuser; and details of your library setup. You may also need to know
details of your Apache setup.
If you want to install the Koha configuration files somewhere other than
/etc (for installing not as root, or to have many Kohas on one system, for
example), you should set the etcdir environment variable. Please look at
your manuals for details of how to set that.
Recommended answers are given in brackets after each question. To accept
the default value for any question (indicated by []), simply hit Enter at
the prompt.
Note that you also can define an auto_install_file, that will answer every
question automatically. To use this feature, run ./installer.pl -i
/path/to/auto_install_file
Are you ready to begin the installation? ([Y]/N):
Answer "Y" to the prompt, and Koha will run a check of your system and let you know what is still missing. Your display will probably look like this:
Checking perl modules ...
The Net::Z3950 module is missing. This module is necessary if you want to
use Koha's Z39.50 client to download bibliographic records from other
libraries.
To install this module, you will need the yaz client installed from
http://www.indexdata.dk/yaz/ and then you can install the perl module with
the command:
perl -MCPAN -e 'install Net::Z3950'
...or by installing packages for your distribution, if available.
IMPORTANT NOTE : If you use Perl 5.8.0, you might need to edit NET::Z3950's
Makefile.PL and yazwrap/Makefile.PL to include:
'DEFINE' => '-D_GNU_SOURCE',
Also note that some installations of Perl on Red Hat will generate a lot of
"'my_perl' undeclared" errors when running make in Net-Z3950. This is fixed
by inserting in yazwrap/ywpriv.h a line saying #include "XSUB.h"
Press the <ENTER> key to continue:
And then when you press <ENTER> you will get a list of some more modules you are missing, and the installer will abort:
You are missing some Perl modules required by Koha. Please run this again
after installing them. They may be installed by finding packages from your
operating system supplier, or running (as root) the following commands:
perl -MCPAN -e 'install "DBI"'
perl -MCPAN -e 'install "Date::Manip"'
perl -MCPAN -e 'install "DBD::mysql"'
perl -MCPAN -e 'install "HTML::Template"'
perl -MCPAN -e 'install "MARC::Record"'
perl -MCPAN -e 'install "Mail::Sendmail"'
perl -MCPAN -e 'install "You will need PDF::API2 for barcode generator"'
perl -MCPAN -e 'install "Net::LDAP"'
perl -MCPAN -e 'install "Event"'
perl -MCPAN -e 'install "Net::Z3950"'
emac:~/Desktop/Koha-2.2.3 admin$
Let's deal with the modules listed up to Event,
then deal with Event and Net::Z3950 separately.
Follow these instructions to install the missing Perl modules on
your computer, but be aware that you need to do this as root -- sudo will not give you enough
permissions. This is true of all the Perl modules you need to install,
so be brave (but careful) and login as root on your computer:
emac:~/Desktop/Koha-2.2.5 admin$ su -l root
Password:
emac:~ root#
Note that the root password is different than your administrator password, and in fact may not be defined at all on your system. This is a security measure of OS X. If you have trouble logging in as root, you may have to set the root password first:
emac:~/Desktop/Koha-2.2.5 admin$ sudo passwd root
Password:
Changing password for root.
New password:
Retype new password:
The first password requested will be your administrator password. Choose a different password for your root password. Login as root and continue the process of installing modules.
This process is actually pretty easy: grab each module from CPAN and install it in one step, using the commands listed by the installer program:
emac:~ root# perl -MCPAN -e 'install "DBI"'
Note
If this is the first time you have used CPAN, you will have to go through the process of configuring it. See the Configuring Perl's CPAN utility section of Joshua Ferraro's Installing Koha on Debian document on www.kohadocs.org for guidance.
If all goes well, a lot of stuff will fly by on your screen, ending with something like this:
[...]
Installing /man/man3/DBI::DBD.3pm
Installing /man/man3/DBI::DBD::Metadata.3pm
Installing /man/man3/DBI::FAQ.3pm
Installing /man/man3/DBI::Profile.3pm
Installing /man/man3/DBI::ProfileData.3pm
Installing /man/man3/DBI::ProfileDumper.3pm
Installing /man/man3/DBI::ProfileDumper::Apache.3pm
Installing /man/man3/DBI::ProxyServer.3pm
Installing /man/man3/DBI::PurePerl.3pm
Installing /man/man3/DBI::SQL::Nano.3pm
Installing /man/man3/DBI::W32ODBC.3pm
Installing /man/man3/Roadmap.3pm
Installing /man/man3/Win32::DBIODBC.3pm
Installing /usr/bin/dbiprof
Installing /usr/bin/dbiproxy
Writing ///Library/Perl/5.8.1/darwin-thread-multi-2level/auto/DBI/.packlist
Appending installation info to ///System/Library/Perl/5.8.1/darwin-thread-multi-2level/perllocal.pod
/usr/bin/make install -- OK
emac:~ root#
Repeat this process for each of the Perl modules listed as missing by the installer, until you get to the line that says "You will need PDF::API2 for barcode generator."
Koha has a built-in barcode generator, but it depends on a older
version of the Perl PDF::API2 module
than the one available from CPAN. If you want to print your own
barcodes, you need to grab the version 0.3r77 tarball of PDF::API2 from http://cpan.mirror.fr/index2.php?pwd=modules%2Fby-module%2F%2FPDF
(or anywhere else you can find it), unzip it into a PDF-API2-0.3r77 folder, navigate to that
folder, and install it:
emac:~ root# cd /Users/admin/Desktop/PDF-API2-0.3r77
emac:/Users/admin/Desktop/PDF-API2-0.3r77 root# Perl Makefile.pl
____ ____ _____ _ ____ ___ ____
| _ \| _ \| ___| _ _ / \ | _ \_ _| |___ \
| |_) | | | | |_ (_) (_) / _ \ | |_) | | __) |
| __/| |_| | _| _ _ / ___ \| __/| | / __/
|_| |____/|_| (_) (_) /_/ \_\_| |___| |_____|
(0.3r77)
please look at http://www.penguin.at0.net/~fredo/files/
for examples and contrib.
Checking if your kit is complete...
Looks good
Warning: prerequisite Compress::Zlib 1.03 not found.
Writing Makefile for PDF::API2
anything else ? NO.
emac:/Users/admin/Desktop/PDF-API2-0.3r77 root#
At this point, you might as well go ahead and grab the Compress::Zlib module:
emac:/Users/admin/Desktop/PDF-API2-0.3r77 root# perl -MCPAN -e 'install "Compress::Zlib"'
Then continue with the installation of PDF-API2:
emac:/Users/admin/Desktop/PDF-API2-0.3r77 root# make
cp lib/PDF/API2/ExtGState.pm blib/lib/PDF/API2/ExtGState.pm
cp lib/PDF/API2/TTF/Fpgm.pm blib/lib/PDF/API2/TTF/Fpgm.pm
[...]
cp lib/PDF/API2/Page.pm blib/lib/PDF/API2/Page.pm
cp lib/PDF/API2/PDF/AFont.pm blib/lib/PDF/API2/PDF/AFont.pm
emac:/Users/admin/Desktop/PDF-API2-0.3r77 root# make install
Installing /Library/Perl/5.8.1/PDF/API2.pm
Installing /Library/Perl/5.8.1/PDF/API2/Annotation.pm
[...]
Installing /Library/Perl/5.8.1/PDF/API2/UniMap/microsoft-dingbats.map
Writing ///Library/Perl/5.8.1/darwin-thread-multi-2level/auto/PDF/API2/.packlist
Appending installation info to ///System/Library/Perl/5.8.1/darwin-thread-multi-2level/perllocal.pod
emac:/Users/admin/Desktop/PDF-API2-0.3r77 root#
Next on the list of modules is Net::LDAP,
which you will only need if you are going to retrieve lists of
authorized users from an LDAP server. If you use the nifty perl -MCPAN -e 'install'
command for this, you'll get a list of missing modules that are
dependencies or options for the Net::Z3950
module:
- Convert::ASN1 ...missing. (would need 0.07)
- Authen::SASL ...missing. (would need 2)
- URI::ldap ...missing. (would need 1.1)
- IO::Socket::SSL ...missing. (would need 0.81)
- XML::SAX::Base ...missing.
If you choose "yes" for installing all of these, you'll always get an error:
Writing Makefile for Net::LDAP
make: *** No targets specified and no makefile found. Stop.
/usr/bin/make -- NOT OK
Running make test
Can't test without successful make
Running make install
make had returned bad status, install seems impossible
You have two choices here. You can do the easy thing and choose not to install the IO::Socket::SSL module, which should allow Net::Z3950 to install. Or if you feel you must
have a complete installation, you can go to http://ldap.perl.org/
to download the perl-ldap-0.33 tarball
and install it manually. Unzip the tarball, navigate to that directory,
and run the Makefile.PL script:
emac:/Users/admin/Desktop/perl-ldap-0.33 root# perl Makefile.PL
*** ExtUtils::AutoInstall version 0.59
*** Checking for dependencies...
[Core Features]
- Convert::ASN1 ...loaded. (0.19 >= 0.07)
[SASL authentication]
- Authen::SASL ...loaded. (2.09 >= 2)
- Digest::MD5 ...loaded. (2.26)
[LDAP URLs]
- URI::ldap ...loaded. (1.11 >= 1.1)
[LDAPS]
- IO::Socket::SSL ...missing. (would need 0.81)
==> Auto-install the 1 optional module(s) from CPAN? [n] y
[Read/Write DSML files]
- XML::SAX::Base ...loaded. (1.02)
[Read/Write LDIF files]
- MIME::Base64 ...loaded. (2.20)
*** Dependencies will be installed the next time you type 'make'.
*** ExtUtils::AutoInstall configuration finished.
*** Installing dependencies...
*** Installing IO::Socket::SSL...
CPAN: Storable loaded ok
Going to read /var/root/.cpan/Metadata
[...]
Go ahead and choose to install the optional IO::Socket::SSL
module. The process will end the same way as the process started with
the perl -MCPAN -e 'install'
command, but now there's a way out, using the install-nomake
script that comes with the tarball:
Writing Makefile for Net::LDAP
emac:/Users/admin/Desktop/perl-ldap-0.33 root# make
make: *** No targets specified and no makefile found. Stop.
emac:/Users/admin/Desktop/perl-ldap-0.33 root# perl ./install-nomake
Installing /Library/Perl/5.8.1/Bundle/Net/LDAP.pm
Installing /Library/Perl/5.8.1/LWP/Protocol/ldap.pm
[...]
Installing /Library/Perl/5.8.1/Net/LDAP/Extension/SetPassword.pm
Installing /Library/Perl/5.8.1/Net/LDAP/Extension/WhoAmI.pm
emac:/Users/admin/Desktop/perl-ldap-0.33 root#
Done!
The final two missing modules listed by the Koha installer program
are Event and Net::Z3950.
These two modules allow the Koha Z39.50 client to install and function.
Unfortunately, they won't install on Mac OS X, because the Event module has not been ported to OS X, and Net::Z3950 is dependent on Event. This problem should be fixed in future
version of Koha, which will not use the Event
module, but for now you'll just have to forego doing Z39.50 searches
from Koha.
Now you should be able to try the installation process again. Let's look at this process:
emac:~/Desktop/Koha-2.2.5 admin$ sudo perl installer.pl
WELCOME TO THE KOHA INSTALLER
This program will ask some questions and try to install koha for you. You
need to know: where most koha files should be stored (you can set the
prefix environment variable for this); the username and password of a mysql
superuser; and details of your library setup. You may also need to know
details of your Apache setup.
If you want to install the Koha configuration files somewhere other than
/etc (for installing not as root, or to have many Kohas on one system, for
example), you should set the etcdir environment variable. Please look at
your manuals for details of how to set that.
Recommended answers are given in brackets after each question. To accept
the default value for any question (indicated by []), simply hit Enter at
the prompt.
Note that you also can define an auto_install_file, that will answer every
question automatically. To use this feature, run ./installer.pl -i
/path/to/auto_install_file
Are you ready to begin the installation? ([Y]/N): y
Great! Continuing...
PERL MODULES
Checking perl modules ...
The Net::Z3950 module is missing. This module is necessary if you want to
use Koha's Z39.50 client to download bibliographic records from other
libraries.
To install this module, you will need the yaz client installed from
http://www.indexdata.dk/yaz/ and then you can install the perl module with
the command:
perl -MCPAN -e 'install Net::Z3950'
...or by installing packages for your distribution, if available.
IMPORTANT NOTE : If you use Perl 5.8.0, you might need to edit NET::Z3950's
Makefile.PL and yazwrap/Makefile.PL to include:
'DEFINE' => '-D_GNU_SOURCE',
Also note that some installations of Perl on Red Hat will generate a lot of
"'my_perl' undeclared" errors when running make in Net-Z3950. This is fixed
by inserting in yazwrap/ywpriv.h a line saying #include "XSUB.h"
Press the <ENTER> key to continue:
PERL MODULES AVAILABLE
All required perl modules are installed.
Press <ENTER> to continue:
OPAC DIRECTORY
Please supply the directory you want Koha to store its OPAC files in. This
directory will be auto-created for you if it doesn't exist.
OPAC Directory [/usr/local/koha/opac]:
LIBRARIAN DIRECTORY
Please supply the directory you want Koha to store its Librarian interface
files in. This directory will be auto-created for you if it doesn't exist.
Intranet Directory [/usr/local/koha/intranet]:
LOG DIRECTORY
Specify a directory where log files will be written.
Koha Log Directory [/usr/local/koha/log]:
DATABASE NAME
Please provide the name that you wish to give your koha database. It must
not exist already on the database server.
Most users give a short single-word name for their library here.
Database name [Koha]:
DATABASE HOST
Please provide the mysql server name. Unless the database is stored on
another machine, this should be "localhost".
Database host [localhost]:
DATABASE USER
We are going to create a new mysql user for Koha. This user will have full
administrative rights to the database called Koha when they connect from
localhost. This is also the name of the Koha librarian superuser.
Most users give a single-word name here.
Database user [kohaadmin]:
DATABASE PASSWORD
Please provide a good password for the user kohaadmin.
IMPORTANT: You can log in using this user and password at any time.
Password for database user kohaadmin: xxxxxxxxx
APACHE CONFIGURATION
Koha needs to write an Apache configuration file for the OPAC and Librarian
sites. By default this installer will do this by using one name and two
different ports for the virtual hosts. There are other ways to set this up,
and the installer will leave comments in /etc/koha-httpd.conf about them.
NOTE: You will need to add lines to your main httpd.conf to include
/etc/koha-httpd.conf (using the Include directive) and to make sure it is
listening on the right ports and host names (using the Listen directive).
Press <ENTER> to continue:
WEB E-MAIL CONTACT
Enter the e-mail address to be used as a contact for Koha. This address is
displayed if fatal errors are encountered.
E-mail contact [webmaster@local]: auser@yourdomain
WEB HOST NAME OR IP ADDRESS
Please enter the host name or IP address that you wish to use for koha.
Normally, this should be a name or IP that belongs to this machine.
Host name or IP Address [emac.local]: localhost
OPAC PORT
Please enter the port for your OPAC interface. This defaults to port 80,
but if you are already serving web content with this hostname, you should
change it to a different port (8000 might be a good choice, but check any
firewalls).
Enter the OPAC Port [80]:
LIBRARIAN PORT
Please enter the port for your Librarian interface. This must be different
from the OPAC port (80).
Enter the Intranet Port [8080]:
UPDATING APACHE CONFIGURATION
Checking for modules that need to be loaded...
Use of uninitialized value in pattern match (m//) at Install.pm line 630, <HC> line 206.
APACHE CONFIGURATION NEEDS UPDATE
Koha uses the mod_env and mod_include apache features, but the installer
did not find them in your config. Please make sure that they are enabled
for your Koha site.
Use of uninitialized value in pattern match (m//) at Install.pm line 634, <HC> line 206.
Use of uninitialized value in pattern match (m//) at Install.pm line 634, <HC> line 206.
Use of uninitialized value in pattern match (m//) at Install.pm line 634, <HC> line 206.
Use of uninitialized value in pattern match (m//) at Install.pm line 634, <HC> line 206.
Use of uninitialized value in pattern match (m//) at Install.pm line 634, <HC> line 206.
Use of uninitialized value in pattern match (m//) at Install.pm line 634, <HC> line 206.
Press <ENTER> to continue:
INSTALLING FILES
Copying files to installation directories:Copying admin templates to /usr/local/koha/intranet/htdocs.
Copying admin interface to /usr/local/koha/intranet/cgi-bin.
Copying main scripts to /usr/local/koha/intranet/scripts.
Copying perl modules to /usr/local/koha/intranet/modules.
Copying OPAC templates to /usr/local/koha/opac/htdocs.
Copying OPAC interface to /usr/local/koha/opac/cgi-bin.
MYSQL ROOT USER PASSWORD
To create the koha database, please enter your mysql server's root user
password:
Password:
CREATING DATABASE
Creating the MySQL database for Koha...
...and so forth. The installer will ask a few more questions about your preferred language, your preferred flavor of MARC, etc., but at this point you are just about finished.
If you are using a standard version of the Apache configuration file, you saw a message about mod_env and mod_include not being found by the installer. Actually, mod_include is probably already enabled, but mod_env is not. We now need to fix this and do some modifications to the file to enable Koha to work.
The file you will be editing is /etc/httpd/httpd.conf,
and you will need to have root (administrator) privileges in order to
change it. Make a backup copy before you begin. In the file you will
see a section that looks like this:
# Note: The order in which modules are loaded is important. Don't change
# the order below without expert advice.
#
# Example:
# LoadModule foo_module libexec/mod_foo.so
#LoadModule vhost_alias_module libexec/httpd/mod_vhost_alias.so
#LoadModule env_module libexec/httpd/mod_env.so
LoadModule config_log_module libexec/httpd/mod_log_config.so
...
#LoadModule info_module libexec/httpd/mod_info.so
LoadModule includes_module libexec/httpd/mod_include.so
LoadModule autoindex_module libexec/httpd/mod_autoindex.so
Remove the "#" from the beginning of the line #LoadModule env_module libexec/httpd/mod_env.so
to uncomment it and make it active. Following this section of the file
you will see a section that begins like this:
# [WHENEVER YOU CHANGE THE LOADMODULE SECTION ABOVE UPDATE THIS, TOO]
ClearModuleList
#AddModule mod_vhost_alias.c
#AddModule mod_env.c
AddModule mod_log_config.c
Again, uncomment the line #AddModule
mod_env.c. Now go to the end of the file and add the following
line:
Include /etc/koha-httpd.conf
Save this file.
Note
Save a backup copy of this altered file, too. Updates you receive to your Mac software may overwrite your changes, so keep them safe somewhere else.
Now edit /etc/koha-httpd.conf. Here
you will be altering the "Listen" directives. You will see a line that
says #Listen 8080. Uncomment this
line, and add another line:
Listen 8080
Listen 80
Restart Apache and you should be finished. Open a browser, type in
the URL http://localhost and you should
see the Koha OPAC. Type in http://localhost:8080
and you should see the Koha librarian login screen. (Use kohaadmin and your password to access Koha.)
Enjoy!