Difference between revisions of "Koha/Installation"
Jump to navigation
Jump to search
| (38 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | ===Step 1 - Install Ubuntu 12.04 LTS server software on a bare metal or virtual machine. | + | ==Introduction== |
| + | ;<font color="red">It is strongly recommended that you use the "packages" installation method which is designed to simplify and streamline the installation, configuration and upgrades of Koha.</font> | ||
| + | |||
| + | ==Step 1 - Install Ubuntu 12.04 LTS server software on a bare metal or virtual machine.== | ||
*During installation create a "koha" admin user. | *During installation create a "koha" admin user. | ||
| − | + | ==Step 2 - Install the LAMP stack== | |
*During installation install the "LAMP" stack. | *During installation install the "LAMP" stack. | ||
*See: http://www.ubuntugeek.com/step-by-step-ubuntu-12-04-precise-lamp-server-setup.html | *See: http://www.ubuntugeek.com/step-by-step-ubuntu-12-04-precise-lamp-server-setup.html | ||
| − | + | ==Step 3 - Enable the Koha software repository== | |
*After installation add the following to '''/etc/apt/sources.list.d/koha.list'''. | *After installation add the following to '''/etc/apt/sources.list.d/koha.list'''. | ||
echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list | echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list | ||
| Line 15: | Line 18: | ||
sudo apt-get dist-upgrade | sudo apt-get dist-upgrade | ||
| − | + | ==Step 4 - Install Koha packages== | |
*Install the koha packages | *Install the koha packages | ||
| − | sudo apt-get install koha koha-common | + | sudo apt-get install koha koha-common bibutils etckeeper |
| − | + | ||
| − | + | ==Step 5 - Initial configuration== | |
| − | + | Read the after installation README file for details. | |
| − | + | cat /usr/share/doc/koha/README.Debian | less | |
| − | + | ||
| − | + | ==Step 6 - Prepare the Apache2 web server== | |
| − | |||
| − | |||
| − | |||
*Setup apache2 modules | *Setup apache2 modules | ||
| − | sudo a2enmod rewrite | + | sudo a2enmod rewrite suexec deflate |
| − | + | *Disable the default websites. | |
| − | *Disable the default | + | sudo a2dissite 000-default default default-ssl |
| − | sudo a2dissite 000-default | ||
| − | |||
| − | |||
| − | + | ''The only web site enabled should be <b>koha</b> in the <tt>/etc/apache2/sites-enabled</tt> folder.'' | |
| − | |||
*Restart the apache2 web server | *Restart the apache2 web server | ||
sudo service apache2 restart | sudo service apache2 restart | ||
| − | + | ==Step 7 - Do the Koha web installation== | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
*'''Reboot the server''' and then connect to the following URL to configure the KOHA webapp. | *'''Reboot the server''' and then connect to the following URL to configure the KOHA webapp. | ||
http://name-of-koha-server:8080 | http://name-of-koha-server:8080 | ||
| − | The user name to log in with will be ''' | + | The user name to log in with will be '''koha''' and the password will be near the end of '''/etc/koha/koha-conf.xm'''l |
To view the password, use this command: | To view the password, use this command: | ||
| − | sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha | + | sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/koha-conf.xml |
Click on one of the screenshots below to view webapp config. | Click on one of the screenshots below to view webapp config. | ||
Latest revision as of 09:48, 10 September 2014
Contents
- 1 Introduction
- 2 Step 1 - Install Ubuntu 12.04 LTS server software on a bare metal or virtual machine.
- 3 Step 2 - Install the LAMP stack
- 4 Step 3 - Enable the Koha software repository
- 5 Step 4 - Install Koha packages
- 6 Step 5 - Initial configuration
- 7 Step 6 - Prepare the Apache2 web server
- 8 Step 7 - Do the Koha web installation
Introduction
- It is strongly recommended that you use the "packages" installation method which is designed to simplify and streamline the installation, configuration and upgrades of Koha.
Step 1 - Install Ubuntu 12.04 LTS server software on a bare metal or virtual machine.
- During installation create a "koha" admin user.
Step 2 - Install the LAMP stack
- During installation install the "LAMP" stack.
- See: http://www.ubuntugeek.com/step-by-step-ubuntu-12-04-precise-lamp-server-setup.html
Step 3 - Enable the Koha software repository
- After installation add the following to /etc/apt/sources.list.d/koha.list.
echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
- Do a software upgrade.
sudo apt-get update
sudo apt-get dist-upgrade
Step 4 - Install Koha packages
- Install the koha packages
sudo apt-get install koha koha-common bibutils etckeeper
Step 5 - Initial configuration
Read the after installation README file for details.
cat /usr/share/doc/koha/README.Debian | less
Step 6 - Prepare the Apache2 web server
- Setup apache2 modules
sudo a2enmod rewrite suexec deflate
- Disable the default websites.
sudo a2dissite 000-default default default-ssl
The only web site enabled should be koha in the /etc/apache2/sites-enabled folder.
- Restart the apache2 web server
sudo service apache2 restart
Step 7 - Do the Koha web installation
- Reboot the server and then connect to the following URL to configure the KOHA webapp.
http://name-of-koha-server:8080
The user name to log in with will be koha and the password will be near the end of /etc/koha/koha-conf.xml
To view the password, use this command:
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/koha-conf.xml
Click on one of the screenshots below to view webapp config.
Return to Koha wiki page
