記and學: 4月 2016

Koha3.22.5安裝手冊

n 安裝前注意事項

l 電腦已先安裝好Ubuntu作業系統，且最好先更新過

l 紅字為可自行代換之文字，藍字為終端機顯現之文字

l 終端機一旦關閉，請重新登以root權限執行
l 以下安裝環境為桌面版本

n 安裝步驟(步驟1~15.17~在終端機中進行)

1. 新增koha使用者

n 方法一：直接在圖形介面中，新增一個名稱為Koha的使用者

n 方法二：

l 開啟終端機，輸入指令：sudo adduser koha(使用者名稱)

l [sudo] password for xxx :輸入目前的使用者的密碼

l 輸入新的UNIX密碼：設定新增使用者的密碼

l 再次輸入新的UNIX密碼：

l 基本資料設定

l 以上輸入的資料正確嗎？[Y/n]輸入y

2. 新增root密碼(若不執行此步驟，則有部分指令前須加入「sudo」，才能取得權限執行命令，若在root帳號下，則不須加入「sudo」，指令均以最高權限執行)

n 輸入指令：sudo passwd root

n [sudo] password for xxx :輸入目前的使用者的密碼

n Enter new UNIX password : 設定root密碼

n Retype new UNIX password : 再次輸入新密碼

n 輸入指令：su root(切換到root帳號)

n 輸入root密碼

n root@ubuntu : /home/xxx#(還在原本帳號的目錄下)

n 輸入指令：cd

n root@ubuntu :~#(切換到root目錄)

3. 編輯來源

n 輸入指令：gedit /etc/apt/sources.list(「gedit」為編輯器，也可換成其他編輯器編輯「sources.list」此檔案)

n 跳出編輯室窗，在檔案最下面加入「deb http://debian.koha-community.org/koha stable main」(告訴系統Koha的資料源在這裡以後從這裡抓)

n 存檔並關閉檔案

4. 加入Koha來源的key和更新

n 輸入指令：wget -O- http://debian.koha-community.org/koha/gpg.asc | apt-key add –(加入Koha來源的key)

n 輸入指令：apt-get update(更新)

5. 下載Koha3.22.5

n 輸入指令：wget http://download.koha-community.org/koha-3.22.05.tar.gz(若要安裝其他版本，可更換成該版本之網址)

n 輸入指令：tar zxvf koha-3.22.05.tar.gz(解壓縮檔)

6. 安裝Koha套件

n 輸入指令：apt-get install mysql-server

n Do you want to continue? [Y/n] 輸入y

n 跳出對話框，設定mysql密碼(資料庫)

n 再次輸入密碼

n 設定mail server(預設即可)

n 輸入指令：apt-get install g++(上面下載的Koha原始檔需要g++來編譯)

n 輸入指令：apt-get install make(開始編譯)

n 輸入指令：apt-get install koha-common(安裝koha)

n 若出現：
處理時發生錯誤：
libapache2-mpm-itk
apache2-mpm-itk
koha-common
E : Sub-process /usr/bin/dpkg returned an error code (1)

l 輸入指令：echo "ServerName localhost" | tee /etc/apache2/conf-available/fqdn.conf

l 輸入指令：ln -s /etc/apache2/conf-available/fqdn.conf /etc/apache2/conf-enabled/fqdn.conf

l 輸入指令：a2dismod mpm_event

l 輸入指令：a2enmod mpm_prefork

l 輸入指令：service apache2 restart

l 輸入指令：apt-get install –f

l 即可解決

7. 檢查perl模組

n 輸入指令：cd koha-3.22.04(視安裝版本更換名稱，切換到koha資料夾)

n 輸入指令：perl koha_perl_deps.pl -m -u | awk -F ' ' {'print $1'}(檢查perl)

n 安裝缺少的套件(兩格線『----』中即為缺少的套件，空白即為無缺少)
例：缺少四個套件
---------------------------------------------------------------
HTTPD::Bench::ApacheBench
Test::DBIx::Class
Exception::Class
Test::WWW::Mechanize
---------------------------------------------------------------

l 輸入指令：cpan HTTPD::Bench::ApacheBench Test::DBIx::Class Exception::Class Test::WWW::Mechanize(缺少套件的名稱)

l 再次輸入指令：perl koha_perl_deps.pl -m -u | awk -F ' ' {'print $1'}

l 直到確認沒有缺少的套件

8. 編輯ParserDetails.ini

n 輸入指令：gedit /etc/ perl/XML/SAX/ParserDetails.ini (可換成其他編輯器)

n 跳出編輯室窗，將
[XML∷LibXML∷SAX∷Parser]
http://xml.org/sax/features/namespaces = 1
這段文字移到檔案內容的最下面

n 存檔並關閉

9. 新增Koha資料庫及使用者

n 輸入指令：mysql -u root –p(登入資料庫)

n 輸入指令：create database koha;(建立Koha資料庫)

n 輸入指令：grant all on *.* to 'koha'@'localhost' identified by '密碼';(Koha user 和密碼)

n 輸入指令：exit;(離開)

10. 安裝Koha

n 輸入指令：perl Makefile

l Installation mode (dev, single, standard)選擇[standard]

l Base installation directory [/usr/share/koha]使用預設/usr/share/koha (設定安裝的目錄路徑)

l User account [koha]使用預設[koha]

l Group [koha] 使用預設[koha] ( koha安裝之後，檔案的使用者群組，會要一個系統user)

l DBMS to use (Pg, mysql)選擇[mysql](koha安裝的資料庫)

l Database server [localhost]使用預設[localhost](設定mysql DB連線，採用 [localhost] 也就是本機)

l DMBS [3306]使用預設[3306](設定mysql DB連線TCP Port)

l Please specify the name of the database to be used by Koha [koha]使用預設[koha](設定koha mysql使用資料庫名稱)

l Please specify the user that owns the database to be used by Koha [kohaadmin] 改為[koha] (設定koha資料庫的使用者名稱，也就是剛剛新增資料使用者[koha])

l Please specify the password of the user that owns the database to be used by Koha [katikoan]輸入[koha的密碼](設定koha使用者的密碼，這是剛剛設定資料庫koha密碼，不是系統koha使用者密碼)

l MARC format for Zebra indexing (marc21, normarc, unimarc)選擇[marc21](設定Zerbra，使用marc21，Zebra本身不支援multi-marc)

l Primary language for Zebra indexing (en, es, fr, gr, nb, ru, uk)選擇[en](設定koha Zerba marc支援語言)

l Bibliographic indexing mode (dom, grs1)選擇[dom](設定koha Zerba bibliographic index model)

l Authorities indexing mode (dom, grs1)選擇[dom](設定koha Zerba authorities index model)

l characters. (chr, icu) [chr] icu(需選擇icu) 選擇[icu](設定Zerba斷詞採用方式，因為我們是非拉丁語系，使用icu方式)

l Please specify Zebra database user [kohauser]使用預設[kohauser](設定Zerba資料庫使用者)

l Please specify the Zebra database password [zebrastripes]使用預設[zebrastripes](設定Zerba資料庫使用者)

l Install the SRU configuration files? (no, yes)選擇 [yes]

l SRU Database host? [localhost]

l SRU port for bibliographic data? [9998]

l SRU port for authority data? [9999]

l Install the PazPar2 configuration files? 選擇[no](安裝PazPar2 http://www.indexdata.com/pazpar2這是整合資源查詢功能)

l You will need a Memcached server running. (no, yes)選擇[no] (memcached是加速http://zh.wikipedia.org/wiki/Memcached)

l Path to DejaVu fonts? [/usr/share/fonts/truetype/ttf-dejavu]預設

l Would you like to run the database-dependent test suite? (no, yes)選擇[no](建議如果不是開發環境, 請不要使用, 會導致資料庫數據異常, 因為這是一種軟體測試)

n 輸入指令：make(編譯)

n 輸入指令：make install(安裝)

11. 新增Koha設定檔

n 輸入指令：koha-create --use-db koha

n 記得除錯，例看到：

l Koha requires mod_rewrite to be enabled within Apache in order to run.
Typically this can be enabled with:
sudo a2enmod rewrite

要輸入指令：sudo a2enmod rewrite

l Koha requires mod_cgi to be enabled within Apache in order to run.
Typically this can be enabled with:
sudo a2enmod cgi
要輸入指令：sudo a2enmod cgi

l 再次輸入指令：koha-create --use-db koha

n 最後要看到
* Restarting web server apache2 [ OK ]
Starting Zebra server for koha
才算完成

12. 修改Koha.conf

n 輸入指令：gedit /etc/apache2/sites-available/koha.conf

n #Intranet
<VirtualHost *:8080>(改為8080，原為80)

n SetEnv KOHA_CONF /etc/koha/koha-conf.xml (Intranet和OPAC都要改路徑)

n 存檔並關閉

13. 開啟8080 port

n 輸入指令：gedit /etc/apache2/ports.conf

n 在Listen 80下新增「Listen 8080」這行字

n 存檔並關閉

14. apache使用koha設定

n 輸入指令：a2ensite koha.conf

n 輸入指令：a2dissite 000-default

n 輸入指令：apache2ctl restart

15. 環境變數

n 輸入指令：gedit ~/.profile

n 在最下面加上
export KOHA_CONF="/etc/koha/koha-conf.xml"
export PERL5LIB="/usr/share/koha/lib"

n 存檔並關閉

n 輸入指令：source ~/.profile

n 輸入指令：gedit /home/koha/.profile

n 在最下面加上
export KOHA_CONF="/etc/koha/koha-conf.xml"
export PERL5LIB="/usr/share/koha/lib"

n 存檔並關閉

n 輸入指令：source /home/koha/.profile

16. 開啟館員介面完成Koha安裝設定(到瀏覽器操作)

n 瀏覽器輸入「http://自己電腦的ip位置:8080/」(或是「localhost」)

n 輸入koha資料庫的那組帳號密碼

n 基本設定，點選「next」，直到出現「Select your MARC flavor」

n 開始依據個人需求設定，可參考http://openlib.org/home/krichel/courses/lis508/koha/installer_screens/s08.html

n 繼續並登入，可以看到全新的KOHA管理員介面，這帳號是資料庫管理員(會跳出訊息不建議以此登入)，要創立自己的帳號，未來就用自己的帳號作業

17. 安裝中文語系

n 回到終端機繼續操作，輸入指令：cd /usr/share/koha/misc/translator(切換到此目錄)

n 輸入指令：./translate install zh-Hans-TW(可換不同語言，此為繁體中文)

n 到館員介面→Administration→Global system preferences→I18N/L10N preferences，「language」、「opac languages」要勾語言，「opac languagesdisplay」選擇「allow」

n 儲存並重新整理

n 畫面左下角即可切換新增的語言

18. 開機啟動zebra(回到終端機)

n 輸入指令：cd /etc/init.d

n 輸入指令：ln -s /usr/share/koha/bin/koha-zebra-ctl.sh koha-zebra

n 輸入指令：update-rc.d koha-zebra defaults

n 輸入指令：/etc/init.d/koha-zebra start

19. 排程設定

n 輸入指令：cd /var/lock/koha/

n 輸入指令：chown -R koha:koha zebradb(將檔案權限修改為koha)

20. 執行索引

n 輸入指令：su koha(以koha權限執行，切換到koha帳號)

n 輸入指令：/usr/share/koha/bin/migration_tools/rebuild_zebra.pl -a -b -v -r --run-as-root (重建索引)

n 輸入指令：/usr/share/koha/bin/migration_tools/rebuild_zebra.pl -a -b -v -z --run-as-root (更新變動部分)

21. 加入排程(還在koha帳號下)

n 輸入指令：crontab –e

n 按enter進入，在內容最下方加入：
*/1 * * * * export KOHA_CONF=/etc/koha/koha-conf.xml;export PERL5LIB=/usr/share/koha/lib;/usr/share/koha/bin/migration_tools/rebuild_zebra.pl -a -b -v -z --run-as-root

◎恭喜安裝完成，記得回到館員介面依序新增圖書館→讀者類型→館藏類型→借閱與罰鍰等規則，還有基本設定(Z39.50、編目框架)。

記and學

2016年4月24日星期日

2016.04.11 Koha作業─6間圖書館書目紀錄比較

6間圖書館書目紀錄比較

2016.04.11 Koha作業─Koha3.22.5安裝手冊

Koha3.22.5安裝手冊

2016年4月24日 星期日

2016.04.11 Koha作業─6間圖書館書目紀錄比較

6間圖書館書目紀錄比較

2016.04.11 Koha作業─Koha3.22.5安裝手冊

Koha3.22.5安裝手冊

2016年4月24日星期日