Koha 3.0.0 stable 安裝於 Ubuntu 8.04 LTS

這篇文件是基於 Koha 3.0.0 beta 安裝手冊！對象是需要 Koha 中文環境的使用者。

為了簡化整個安裝程序，在官方還沒有釋出 deb 版本之前，希望以 script 解決 library, perl module 等相依問題。在使用這篇文件之前，請確認您已經安裝好乾淨的 Ubuntu Hady 系統。

在此將安裝 Apache2、MySQL、不安裝Zebra。

安裝 WebService? and Database

安裝 Koha 需要俱備 MySQL 5 與網站伺服器 Apache2。 

$ apt-get install apache2 mysql-server-5.0

請記得輸入MySQL資料庫的密碼，如果安裝時忘記設定密碼，可以這樣設定 

$ mysqladmin -u root password <password>

資料庫使用 MySQL5:

  • 進入資料庫 
    $ mysql -u root -p
  • 建立 database 'koha' 
    mysql> CREATE DATABASE `koha` ;
  • 新增使用者 'kohaadmin' 與設定其密碼之後必需調整權限，至少要有 SELECT, INSERT, UPDATE, DELETE, CREATE, DROP 等權限。把 'yourpassword' 換成 koha 要用的密碼。 
    mysql> INSERT INTO `mysql`.`user` (`Host`, `User`, `Password`, `Select_priv`, `Insert_priv`, `Update_priv`, `Delete_priv`, `Create_priv`, `Drop_priv`, `Alter_priv`, `Lock_tables_priv`) VALUES ('localhost', 'kohaadmin', PASSWORD('your password'), 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y');
mysql> flush privileges;
  • 修改 my.cnf 
    $ vi /etc/mysql/my.cnf
  • 在 client 描述加入預設支援 utf8 
    [client]
port            = 3306
socket          = /var/run/mysqld/mysqld.sock
default-character-set=utf8

# Here is entries for some specific programs
# The following values assume you have at least 32M ram

# This was formally known as [safe_mysqld]. Both versions are currently parsed.
  • 在 mysqld 描述加入預設支援 utf8 
    [mysqld]
...
default-character-set=utf8
default-collation=utf8_general_ci
  • 重新起動 mysql 
    /etc/init.d/mysql restart

下載 Koha

前往官方網站下載

http://www.koha.org/ 下載並且解壓縮 

wget http://download.koha.org/koha-3.00.01-stable.tar.gz
tar -zxvf koha-3.00.01-stable.tar.gz

先不要急著安裝，要安裝 Koha 之前比需要準備許多 library 與 Perl Module，因此這編寫了簡單的 scripts 來執行！ 大部分library都是透過 apt-get install 來安裝，使用者只要在螢幕前等著按下"Y"就會執行！ 少部份 perl modules 使用 cpan 來安裝，第一次使用CPAN會需要config，有問題的話可以參考我的cpan_log。 還有安裝會詢問使用者，建議新增一個使用者koha。

在進行動作之前，我們需要兩隻scripts，preinstall_koha.sh 與 cpan_for_kohahardy.sh，如果沒有問題，就可以開始下載並執行！ 

wget http://trac.koha-tw.org/koha/browser/trunk/preinstall_koha.sh?format=raw -O preinstall_koha.sh
wget http://trac.koha-tw.org/koha/browser/trunk/cpan_for_kohahardy.sh?format=raw -O cpan_for_kohahardy.sh
chmod u+x preinstall_koha.sh cpan_for_kohahardy.sh
./preinstall_koha.sh
./cpan_for_kohahardy.sh
add user koha

預設的安裝程序

  1. perl Makefile.PL
    (這邊需要回答一些簡單的問題，如果有相依 Modules 沒有安裝到，請參考cpan_instal)
  2. make
  3. make test
    (建議跑一下，失敗也沒關係)
  4. make install
  5. ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
    5.1 修改 /etc/koha/koha-httpd.conf 中的IP為對外的IP
  6. echo "Listen 8080" >> /etc/apache2/ports.conf
    (適當修改 apache 的設定檔，在 ports.conf 增加 8080 port)
  7. a2enmod rewrite
  8. a2ensite koha
  9. /etc/init.d/apache2 reload
  10. 匯入KOHA SQL，依照情形可以選擇： 10.1 由網頁匯入 http://servername:8080/ 並回答問題以進行後續安裝 網頁安裝說明
    10.2 繁體中文 SQL, 依序匯入

koha_initial.sql koha_tw-systempreferences.sql koha_tw-account.sql koha_tw-itemtypes.sql koha_tw-marc_tag_subfield.sql koha_tw-authorised_values.sql ...

10.3 簡體中文 SQL, 依序匯入

koha_initial.sql koha_cn-systempreferences.sql koha_cn-account.sql koha_cn-itemtypes.sql koha_cn-marc_match.sql koha_cn-marc_tag_subfield.sql ...

10.4 之前備份 SQL, 如果之前有備份SQL檔案，直接匯入即可。


手動中文化