by Ian Thatcher

1. You should start by downloading all needed dependencies if you do not have Apache2 or MySQL 5 you will need to install them do a sudo aptitude search for them then sudo aptitude install

2. Now do a sudo aptitude update then you will also need to install Yaz and Zebra you can run the command sudo aptitude install yaz idzebra-2.0 idzebra-2.o-doc

3. next if you dont already have perl youll want to install perl and update it

4. The next step is to get Koha you can get koha via git

 
  
$ sudo apt-get install git-core git-email
    $ git clone git://git.koha.org/pub/scm/koha.git kohaclone
    $ cd kohaclone
    $ git checkout -b myinstall origin

5. Now to unpack some Koha files

Using the ubuntu.packages file included in the Koha source tree,
run the following:

    $ sudo dpkg --set-selections < install_misc/ubuntu.packages

Now start dselect (you may need to 'sudo apt-get install dselect'):

    $ sudo dselect

Choose [I]nstall and accept packages to be installed (hit return)

(may take a while)

Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.

6. Now we need to install some perl dependencies that dont come with ubuntu

$ sudo cpan MARC::Crosswalk::DublinCore GD GD::Barcode::UPCE Email::Date \
                HTML::Scrubber Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle

Note: you may need to run CPAN initialization if you've not run cpan
before:

    /etc/perl/CPAN/Config.pm initialized.

Now follow the prompts and manually configure cpan

7. Now you should update the MySQL password sudo mysqladmin password <your Password Here>

8. Now you need to create the database and user

 $ mysqladmin -uroot -p<password> create <kohadatabasename>
    $ mysql -uroot -p<password>

    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 22
    Server version: 5.0.32-Debian_7etch3-log Debian etch distribution

    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

    mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
    Query OK, 0 rows affected (0.00 sec)

    mysql> flush privileges;
    Query OK, 0 rows affected (0.00 sec)

    mysql> quit

9. Next install DBD::mysql:

    $ sudo cpan

    cpan> o conf makepl_arg
    (get current value of this CPAN parameter)

    cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test"

    cpan> install DBD::mysql

    cpan> o conf makepl_arg ''

    OR

    cpan> o conf makepl_arg '<old setting>'

    (restore this setting so as to not interfere with future CPAN installs).


Finally, remove the test database:

    $ mysql -uroot -p<password>

    mysql> drop database test;
    Query OK, 1 row affected (0.00 sec)

    mysql> exit
    Bye 

10. Now Run the Koha installer

    $ perl Makefile.PL
    ( answer questions )
    $ make
    $ make test
    $ sudo make install

11. Configure and start Apache

  $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
  (note that the path to koha-httpd.conf may be different depending on your
  installation choices)

Add the following lines to /etc/apache2/ports.conf:

  Listen 80
  Listen 8080

If not running named virtual hosts (The default koha installation does not use named virtual hosts.), comment out the following line:

  NameVirtualHost *:80

Run the following commands:

  $ sudo a2enmod rewrite
  $ sudo a2ensite koha
  $ sudo apache2ctl restart