First of all disable your firewall and security stuff unless you will be able to make apache work fine with it.
* Install your Redhat Enterprise 9.0 or fedora core 4 using the “every thing” option see this manual
* During installation you will configure network as the host name , ip , subnet ,gateway dns1 , dns2
* Now Download this file koha2.2.5
* uncompress the file using this command
*tar xfz ncftpd-2.8.3.tar.gz
* then go to the folder ncftpd-2.8.3 and execute this commands
*./conf*
*make
*makeinstall
* now we will configure Mcpan by this command
*perl -MCPAN -e 'install “MARC::Record”'
It will ask you about some paths answer by the default answer it gave you
but when It ask you about where is ncftp,
u should say /usr/bin/
* uncompress the file yaz*.tar.gz using this command
*tar xfz yaz*.tar.gz
Then excute these commands from inside the folder yaz*
*./conf
*make
*makeinstall
Now we will continue installing perl modules by these commands
*perl -MCPAN -e 'install Event'
*perl -MCPAN -e 'install Digest::MD5'
*perl -MCPAN -e 'install “HTML::Template”'
*perl -MCPAN -e 'install “Mail::Sendmail”'
*perl -MCPAN -e 'install “Compress::Zlib”'
*perl -MCPAN -e 'install “PDF::API2”'
*perl -MCPAN -e 'install “Class::Accessor”'
*perl -MCPAN -e 'install “MARC::Charset”'
*perl -MCPAN -e 'install “MARC::File::XML”'
*perl -MCPAN -e 'install “Tie::IxHash”'
*perl -MCPAN -e 'install “XML::Simple”'
*perl -MCPAN -e 'install “Net::Z3950”'
*perl -MCPAN -e 'install “Net::Z3950::ZOOM”'
* set your SQL admin pass word using this command
*mysqladmin -u root password “yourpassword”
* uncompress the file (koha-2.2.5.tar.gz) using this command
*tar xfz koha-2.2.5.tar.gz
* no go inside the folder (koha-2.2.5)where we will start
* then run this command
./installer.pl
* Now we will enjoy installing koha
Most of this process we will press <ENTER> for the default values:
* Are you ready to begin the installation? ([Y]/N): <ENTER>
* Checking perl modules …
Press the <ENTER> key to continue: <ENTER>
* All required perl modules are installed.
Press <ENTER> to continue: <ENTER>
* OPAC Directory [/usr/local/koha/opac]: <ENTER>
* Intranet Directory [/usr/local/koha/intranet]: <ENTER>
* Koha Log Directory [/usr/local/koha/log]: <ENTER>
* Database name [Koha]: <ENTER>
* Database host [localhost]: <ENTER>
* Database user [kohaadmin]: <ENTER> or change the user name if u want
* Password for database user kohaadmin: <ENTER> or write the password u would like to use
* E-mail contact [webmaster@com]: write your e-mail or your webmaster e-mail address, but i recommded to write ur own library e-mail, after all you are the one who will maintain koha
* Host name or IP Address [domain.com]: write the Ip of this machine (which u are installing koha on)
* Enter the OPAC Port [80]: <ENTER>
* Enter the Intranet Port [8080]: <ENTER>
* MYSQL ROOT USER PASSWORD
Password: (write the pasword u wrote when u used with mysqladmin password)
* CREATING DATABASE
Press <ENTER> to continue:
* MARC FIELD DEFINITIONS
You can import MARC settings for:
1 MARC21
2 UNIMARC
N none
Choose MARC definition [1]: <ENTER> for marc21 or press 2 for unimarc or press n if u are upgrading from a previous koha version
NOTE: If you choose N, nothing will be added, and you must create them all yourself
* Finished updating of database. Press <ENTER> to continue… <ENTER>
* ADD BRANCH AND PRINTER
Would you like to describe an initial branch and printer? [Y]/N: <ENTER>
* Branch Name [MAIN]: write ur main branch name or press enter for MAIN
* Branch Code (4 letters or numbers) []:
* Printer Name [lp]: <ENTER>
* Printer Queue [/dev/lp0]: <ENTER>
* CHOOSE LANGUAGE
This version of koha supports a few languages.
en : default language, all pages available
fr : complete translation
es : partial librarian site translation
zh_TW : partial translation
en is used when a screen is not available in your language
If you specify a language here, you can still change it from the system preferences screen in the librarian sit.
* Which language do you choose? press en then <ENTER>
* SELECT SQL DIRECTORY
Select a directory. You will see every file included in this directory and be able to choose file(s) to import into Koha This is a VERY important feature. By selecting the proper options, you can get a pre-setup Koha, almost ready to be put in production.
Choose wisely. 0 ⇒ FINISHED
1 ⇒ english
2 ⇒ french
press 1 then <ENTER>
* SELECT SQL FILE
Select a file to append to the Koha DB. enter a number. A detailled explanation of the file will be given if you confirm, the file will be added to the DB
0 ⇒ FINISHED
1 ⇒ authorities_normal_marc21.txt
2 ⇒ stopwords.txt
press 2 then <ENTER>
* INSERT ENGLISH/AUTHORITIES_NORMAL_MARC21.TXT ?
Authority structure for MARC21, in english
* Confirm loading of this file into Koha [Y]/N: <ENTER>
* SELECT SQL FILE
Select a file to append to the Koha DB. enter a number. A detailled explanation of the file will be given if you confirm, the file will be added to the DB
0 ⇒ FINISHED
1 ⇒ authorities_normal_marc21.txt
2 ⇒ stopwords.txt
press 2 then <ENTER>
* INSERT ENGLISH/STOPWORDS.TXT ?
English stop words
you can update this file if you want to add some othe stopword pefore this process but I think the stopwords in this file in good enough
put if wanted to add stopwards later at any time you can do that from the system prefrances but you will have to run this command as a root
perl -I /usr/local/koha/intranet/modules /usr/local/koha/intranet/scripts/misc/rebuildnonmarc.pl -c
* Confirm loading of this file into Koha [Y]/N: <ENTER>
* SELECT SQL DIRECTORY
Select a directory. You will see every file included in this directory and be able to choose file(s) to import into Koha This is a VERY important feature. By selecting the proper options, you can get a pre-setup Koha, almost ready to be put in production.
Choose wisely.
0 ⇒ FINISHED
1 ⇒ english
2 ⇒ french
press 0 then <ENTER>
* RESTART APACHE
The web server daemon needs to be restarted to load the new configuration for Koha. The installer can do this if you are using Apache and give the root password.
* Would you like to try to restart Apache now? [Y]/N: <ENTER>
* Press the <ENTER> key to continue:
* INSTALLATION COMPLETE
Congratulations … your Koha installation is complete!
You will be able to connect to your Librarian interface at:
use the koha admin mysql login and password to connect to this interface. and the OPAC interface at:
* NOTE: You need to add lines to your main httpd.conf to include /etc/koha-httpd.conf and to make sure it is listening on the right ports (using the Listen directive). Then, restart Apache.
<ENTER>
* now as a root go to
/etc/
and edit
koha-httpd.conf
to copy the Virtual Server lines
* then got to
/etc/httpd/conf/
and edit
httpd.conf
to repllace the Virtual Server lines with those you copied from koha-httpd.conf
just copiy these lines to the end of your “httpd.conf” file and you will just paste them into the file and edit your IP address and your admin e-mail address and your library's domain
# KOHA's OPAC Configuration
<VirtualHost 0.0.0.0:80>
ServerAdmin askress2009@yahoo.com
DocumentRoot /usr/local/koha/opac/htdocs
ServerName Catalog.nti.org.eg
ScriptAlias /cgi-bin/koha/ /usr/local/koha/opac/cgi-bin/
ErrorLog ”/var/log/httpd/opac-error_log
TransferLog ”/var/log/httpd/opac-access_log
SetEnv PERL5LIB ”/usr/local/koha/intranet/modules”
</VirtualHost>
# KOHA's INTRANET Configuration
<VirtualHost 0.0.0.0:8080>
ServerAdmin askress2009@yahoo.com
DocumentRoot /usr/local/koha/intranet/htdocs
ServerName Catalog.nti.org.eg
ScriptAlias /cgi-bin/koha/ ”/usr/local/koha/intranet/cgi-bin/”
ErrorLog ”/var/log/httpd/koha-error_log
TransferLog ”/var/log/httpd/koha-access_log
SetEnv PERL5LIB ”/usr/local/koha/intranet/modules”
</VirtualHost>
* then restart apache service (httpd) and make sure that mysql & httpd services are in the startup services