2016/04/25Koha圖書館管理系統作業─Koha 3.22.05安裝手冊

KOHA 3.22.5安裝手冊

※、此為在UBUNTU4.04系統環境下安裝KOHA 3.22.5之安裝步驟

1.          先新增一個名為「koha」的使用者帳號

(1)       打開終端機

(2)       輸入指令「sudo adduser koha」

(3)       依照指示設定自己的密碼

(4)       在全名處輸入「koha」，其餘可用預設值(按Enter確定，進行下一個步驟直至其詢問「「以上輸入的資料正確嗎？」)

(5)       確認資料輸入無誤後，打上「y」確認

2.          新增root密碼

(1)       輸入指令「sudo passwd root」

(2)       輸入自己設定的密碼

3.          切換到root帳號(root帳號擁有最高權限，故在root帳號下指令就不須加sudo了)

(1)       指令「su root」

(2)       輸入自己的密碼後按Enter確定

l   在這之後的所有指令，如果因重開了終端機或離開了root權限而出現權限不足因此不能執行此指令的訊息，則在指令前加sudo便可，或者是輸入指令「su root」再次進入root帳號而擁有最高權限。)

4.          切換到root目錄

(1)      ←此為在原本的帳號目錄下的狀態

(2)       輸入指令「cd」

(3)      ←第二行為切換到root目錄的狀態

5.          使用gedit編輯器編輯來源檔(sources.list)

(1)       輸入指令「gedit /etc/apt/sources.list」

(2)       會跳出編輯器的視窗，將頁面拉到最後貼上這行「deb http://debian.koha-community.org/koha stable main」後儲存離開編輯器

6.          加入koha來源的key和更新

(1)       輸入指令「wget -O- http://debian.koha-community.org/koha/gpg.asc | apt-key add」，此為加入koha來源

(2)       輸入指令「apt-get update」

7.          下載koha3.22.5，並將下載好的檔解壓縮

(1)       輸入指令「sudo wget http://download.koha-community.org/koha-3.22.05」，開始下載koha3.22.5

(2)       輸入指令「tar zxvf koha-3.22.05.tar.gz」，將下載的檔解壓縮

8.          安裝koha套件

(1)       輸入指令「apt-get install mysql-server」

(2)       跳出設定的對話框，期間有請你確認的問題，直接按Enter確定

(3)       設定mail server，使用預設值，故直接按Enter確定

(4)       輸入mysql密碼

(5)       下載完後會出現要你設定mysql的root密碼的畫面，輸入自己的密碼後按Enter確定，再重複一次自己的密碼後按Enter確定

(6)       輸入指令「apt-get install g++」，中間有問是否要繼續的問題，直接打y，表示是、繼續，跑完後便到下一步驟

(7)       輸入指令「apt-get install make」，跑完後便到下一步驟

(8)       輸入指令「apt-get install koha-common」，中間有問是否要繼續的問題，直接打y，表示是、繼續，跑完後便到下一步驟

(9)       若執行完「apt-get install koha-common」這一指令後出現像

「Errors were encountered while processing:

        libapache2-mpm-itk

        apache2-mpm-itk

                        koha-common」這樣的錯誤訊息，或者是出現下圖的錯誤

(10)   依序貼上下列指令後便可排除

A.         「a2dismod mpm_event」

B.         「a2enmod mpm_prefork」

C.         「echo "ServerName localhost" | sudo tee /etc/apache2/conf-available/fqdn.conf」

D.         「ln -s /etc/apache2/conf-available/fqdn.conf /etc/apache2/conf-enabled/fqdn.conf」

E.          「service apache2 restart」，跑完確定顯示「OK」

F.          「apt-get install –f」

G.         跑完後可重新輸入指令「apt-get install koha-common」，確定無錯誤

9.          切換到koha資料夾，檢查 perl模組

(1)       輸入指令「cd koha-3.22.05」，切換到名為koha-3.22.05的資料夾

(2)       輸入指令「perl koha_perl_deps.pl -m -u | awk -F ' ' {'print $1'}」，檢查perl模組

10.      安裝perl模組中缺少的套件

(1)       輸入指令「cpan HTTPD::Bench::ApacheBench Test::DBIx::Class  Exception::Class Test::WWW::Mechanize」，此指令為cpan+缺少的套件名稱(每個套件名稱間要空格)，而在此指令是將所有缺少的套件都列在同一個指令下一起安裝，也可以一個套件一個套件安裝，此時指令便是會一行一行之「cpan HTTPD::Bench::ApacheBench」、「cpan Test::DBIx::Class」、「cpan Exception::Class」、「cpan Test::WWW::Mechanize」，再依序貼上

(2)       安裝期間會遇上詢問你是否要依此繼續的問題，用預設的設定便可，故直接按Enter確定就好

(3)       跑完後再執行一次指令「perl koha_perl_deps.pl -m -u | awk -F ' ' {'print $1'}」，確認其缺少的套件為空，也就是向下圖那樣為止才算裝完

(4)       故若其中還有缺少的套件便再以輸入指令「cpan+缺少的套件名稱」，將它安裝完成，直到輸入「perl koha_perl_deps.pl -m -u | awk -F ' ' {'print $1'}」後的畫面為上圖那樣是空的為止

11.      新增koha資料庫及使用者

(1)       登入資料庫，輸入指令「sudo mysql -u root –p」

(2)       建立koha資料庫，直接輸入指令「create database koha;」

(3)       設定koha資料庫的 user密碼，輸入指令「grant all on *.* to 'koha'@'localhost' identified by '在此輸入你設定的密碼';」

(4)       離開資料庫，輸入指令「exit;」

12.      使用gedit編輯器編輯ParserDetails.ini 檔

(1)       輸入指令「gedit /etc/perl/XML/SAX/ParserDetails.ini」

(2)       會跳出編輯器的視窗，檔案內原本有四段，將第三段剪下貼到最後一段後儲存離開編輯器

13.      執行misc/sax_parser_print.pl

(1)       輸入指令「misc/sax_parser_print.pl」，跑出的結果須為以下：

「Koha wants something like:

  XML::LibXML::SAX::Parser=HASH(0x81fe220)

  You have:

  XML::LibXML::SAX::Parser=HASH(0x801740)

  Looks good.」

14.      安裝koha

(1)       輸入指令「perl Makefile.PL」，執行安裝

(2)       設定基本都為預設，也就是基本上都按Enter確定就好，只是有幾處需要手動輸入因此須注意，詳細輸入項目為下：

A.         Installation mode (dev, single, standard) [standard](預設值，直接按Enter)

B.         Base installation directory [/usr/share/koha] (預設值，直接按Enter)

C.         User account [koha] (預設值，直接按Enter)

D.         Group [koha] (預設值，直接按Enter)

E.          DBMS to use (Pg, mysql) [mysql] (預設值，直接按Enter)

F.          Database server [localhost] (預設值，直接按Enter)

G.         DMBS [3306] (預設值，直接按Enter)

H.         Please specify the name of the database to be used by Koha [koha] (預設值，直接按Enter)

I.            Please specify the user that owns the database to be used by Koha [kohaadmin] koha (在此須手動輸入koha後按Enter)

J.           Please specify the password of the user that owns the database to be used by Koha [katikoan]  設定自己koha使用者帳戶的密碼(在此請自己手動輸入自己設定的密碼後按Enter)

K.         MARC format for Zebra indexing (marc21, normarc, unimarc) [marc21] (預設值，直接按Enter)

L.          Primary language for Zebra indexing (en, es, fr, gr, nb, ru, uk) [en] (預設值，直接按Enter)

M.        Bibliographic indexing mode (dom, grs1) [dom] (預設值，直接按Enter)

N.         Authorities indexing mode (dom, grs1) [dom] (預設值，直接按Enter)

O.         characters. (chr, icu) [chr] icu(需選擇icu) (在此須手動輸入icu)

P.          Please specify Zebra database user [kohauser] (預設值，直接按Enter)

Q.         Please specify the Zebra database password [zebrastripes] (預設值，直接按Enter)

R.         Install the SRU configuration files? (no, yes) [yes] (預設值，直接按Enter)

S.          SRU Database host? [localhost] (預設值，直接按Enter)

T.          SRU port for bibliographic data? [9998] (預設值，直接按Enter)

U.         SRU port for authority data? [9999] (預設值，直接按Enter)

V.         Install the PazPar2 configuration files? [no] (預設值，直接按Enter)

W.       You will need a Memcached server running. (no, yes) [no] (預設值，直接按Enter)

X.         Path to DejaVu fonts? [/usr/share/fonts/truetype/ttf-dejavu] (預設值，直接按Enter)

Y.         Would you like to run the database-dependent test suite? (no, yes) [no] (預設值，直接按Enter)

(3)       輸入指令「make」

(4)       輸入指令「make install」

15.      新增koha設定檔

(1)       輸入指令「koha-create --use-db koha」

(2)       指令執行後的畫面會出現需要你執行指令「a2enmod rewrite」的訊息，請依照指示輸入指令「a2enmod rewrite」

(3)       跑完後畫面會出現需要你執行指令「service apache2 restart」的訊息，此時請再輸入一次指令「koha-create --use-db koha」

(4)       指令執行後的畫面會再出現需要你執行指令「a2enmod cgi」的訊息，請依照指示輸入指令「a2enmod cgi」

(5)       跑完後畫面會再出現需要你執行指令「service apache2 restart」的訊息，此時也請再輸入一次指令「koha-create --use-db koha」，它會直接出現重啟web service apache2﹝ok﹞的訊息

l   若一開始在執行第一步驟，也就是(1)輸入指令「koha-create --use-db koha」時，執行的畫面出現如下圖的情況，請依照下圖中的步驟依序進行，進行完後再重新回到第一步驟，直到上述的五個步驟都有順利執行完

16.      使用gedit編輯器修改koha.conf檔

(1)       輸入指令「gedit /etc/apache2/sites-available/koha.conf」

(2)       會跳出編輯器的視窗，在「# Intranet」的底下，將其內容改成以下

「<VirtualHost *:8080」

(3)       然後分別在「# Intranet」、「#OPAC」底下，將SetEnv KOHA_CONF後的路徑改成「/etc/koha/koha-conf.xml」後儲存離開編輯器

17.      使用gedit編輯器開啟8080 port

(1)       輸入指令「gedit /etc/apache2/ports.conf」

(2)       會跳出編輯器的視窗，在Listen 80的底下新增「Listen 8080」後儲存離開編輯器

18.      apache使用koha設定

(1)       輸入指令「a2ensite koha.conf」

(2)       輸入指令「a2dissite 000-default」

(3)       輸入指令「apache2ctl restart」

19.      環境變數

(1)       使用gedit編輯器編輯「~/.profile」，輸入指令「gedit ~/.profile」

(2)       跳出編輯器，在頁面的最後加上以下兩行後便可儲存離開編輯器

                「export KOHA_CONF="/etc/koha/koha-conf.xml"」

「export PERL5LIB="/usr/share/koha/lib"」

               

(3)       使用gedit編輯器編輯「/home/koha/.profile」，輸入指令「gedit /home/koha/.profile」

(4)       跳出編輯器，在頁面的最後加上以下兩行後便可儲存離開編輯器

                「export KOHA_CONF="/etc/koha/koha-conf.xml"」

「export PERL5LIB="/usr/share/koha/lib"」

20.      完成安裝

(1)       開啟瀏覽器，輸入網址「http://自己電腦的ip位置:8080/」

(2)       打上koha資料庫的帳號密碼

(3)       接下來請根據下圖進行選擇與繼續下一步驟

(4)       接下來可以依據自身需求進行設定，簡單畫面說明如下

(5)       再次登入

(6)       登入後可以看到全初始值的KOHA，而現在所登錄的這組帳號是資料庫管理員，但以後不建議用這組帳號登入。

故需依自己的需求依序新增圖書館→讀者類型→館藏類型→館藏類型等設定

21.      安裝中文語系

(1)       回到終端機，進入到translator 的目錄，輸入指令「cd /usr/share/koha/misc/translator」

(2)       輸入指令「./translate install zh-Hans-TW」(注意別漏掉前面的點)

(3)       切回瀏覽器，進入館員介面(也就是http://自己電腦的ip位置:8080/)，進入到I18N/L10N preferences中修改設定

「koha administration→Global system preferences→I18N/L10N preferences」

(4)       在I18N/L10N preferences的設定頁面中，

A.         於「language」項中將剛剛安裝的中文打勾

B.         於「opaclanguages」項中將剛剛安裝的中文打勾

C.         於「opaclanguagesdisplay」項中，改為「allow」

D.         儲存後重新整理

l   若一開始在第二步驟，也就是於終端機輸入指令「./translate install zh-Hans-TW」後，出現以下的錯誤訊息，則改依此下步驟安裝中文語系

l   輸入指令「cd ~」，此指令為離開translator 的目錄而回到家目錄(因在第一步驟時已輸入指令「cd /usr/share/koha/misc/translator」進到了translator 的目錄)

l   輸入指令「koha-translate --install zh-Hans-TW」(若因重開了終端機或離開了root權限而出現權限不足因此不能執行此指令的訊息，則在指令前加sudo便可，或者是輸入指令「su root」進入root帳號而擁有最高權限)，此指令亦可安裝中文語系，故此執行完沒有出現錯誤訊息便是順利安裝好中文語系了，此時便可再回到上頭的第三步驟，進入館員介面的I18N/L10N preferences設定(koha administration→Global system preferences→I18N/L10N preferences)中勾選中文，進行第四步驟

22.      開機啟動zebra

(1)       進入init.d 目錄，輸入指令「cd /etc/init.d」

(2)       輸入指令「ln -s /usr/share/koha/bin/koha-zebra-ctl.sh koha-zebra」

(3)       輸入指令「update-rc.d koha-zebra defaults」

(4)       輸入指令「/etc/init.d/koha-zebra start」

23.      排程設定

(1)       將檔案權限修改為koha，切換到koha 目錄，輸入指令「cd /var/lock/koha/」

(2)       輸入指令「chown -R koha:koha zebradb」

24.      執行索引

(1)       切換至koha帳號，輸入指令「su koha」

(2)       輸入指令「/usr/share/koha/bin/migration_tools/rebuild_zebra.pl -a -b -v -r --run-as-root」，此指令為重建索引

(3)       輸入指令「/usr/share/koha/bin/migration_tools/rebuild_zebra.pl -a -b -v -z --run-as-root」，此指令為更新變動部分

25.      加入排程(注意此時還在koha帳號下)

(1)       輸入指令「crontab -e」

(2)       進入到編輯頁面

(3)       將游標移動到最後一行，並加入這行「*/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」後，按「Ctrl」加「X」鍵離開

(4)       畫面會詢問你是否要儲存更動的部分，輸入「y」表示儲存後離開

26.      完成整個Koha3.22.5的安裝~~接下來就請依自已的需要至館員介面做設定

○、以下提供WORD檔方便檢視

                Koha 3.22.05安裝手冊→

                 https://drive.google.com/file/d/0B2KVEll9uXz-S2FPYnVheEEwclU/view?usp=sharing