Hướng dẫn cài đặt Koha cho hệ điều hành Ubuntu - Phần 1

Discussion in 'Hướng dẫn cài đặt Koha' started by nguyenquocuy, Jun 29, 2013.

  1. nguyenquocuy

    nguyenquocuy Administrator Staff Member

    Hướng dẫn chi tiết bằng tiếng anh bạn có thể xem thêm tại đây:
    http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages
    Bản tiếng anh liên tục được cập nhật, ( bài hướng dẫn này ít cập nhật hơn) nên có lỗi gì các bạn cứ đối chiếu 2 bài hướng dẫn tiếng anh và tiếng việt. Riêng một số lỗi, các bạn xem thêm phần Troubleshooting dưới cùng bài tiếng anh nhé!​
    1. Phần một: Cài đặt bước đầu
    Đầu tiên bạn mở terminal lên (vào biểu tượng Ubuntu trên cùng bên trái, đánh dòng chữ terminal vào)
    [​IMG]
    Sau đó bạn cần add nguồn Koha vào trong source.list của Ubuntu. Việc này giúp cho quá trình update Koha về sau thuận lợi, cũng như việc cài đặt các gói phần mềm con cần thiết trong quá trình cài đặt Koha:
    sudo nano /etc/apt/sources.list
    Bạn có thể thay nano bằng gedit hoặc vi tùy thuộc phiên bản Ubuntu bạn dùng là desktop hay server. Chú ý rằng nhập password trong Ubuntu không hiện lên trên màn hình.
    [​IMG]

    Trước khi bắt đầu bước tiếp, nói qua một chút về Koha. Koha có 3 phiên bản được hỗ trợ cài đặt qua cách cài đặt packages này:
    Current Stable Version
    Hiện tại, 3.12.x là phiên bản mới nhất, bạn muốn cài phiên bản này thì add dòng sau vào file sources.list:
    deb http://debian.koha-community.org/koha squeeze main
    Old Stable Version
    Đây là phiên bản Koha 3.10.x được hỗ trợ tốt nhất hiện tại, ít lỗi hơn phiên bản 3.8.x, mà lại có nhiều tính năng mới hơn, bạn muốn cài phiên bản này thì add dòng sau vào file sources.list:
    deb http://debian.koha-community.org/koha oldstable main
    Development Version
    Nếu bạn muốn phát triển một số tính năng Koha, hoặc tìm hiểu quá trình xây dựng các gói phần mềm trong Koha cho phiên bản mới, bạn có thể cài phiên bản Koha development này (hiện tại 3.14), add dòng sau vào file sources.list :
    deb http://debian.koha-community.org/koha squeeze-dev main
    Như trong hướng dẫn, cũng là trong quá trình update cho hệ thống Koha của Dreamlib, chúng tôi dùng phiên bản mới nhất Koha 3.12.x:
    [​IMG]
    Với câu lệnh
    nano, bạn có thể dùng chuột copy, paste từ màn hình vào trong văn bản, sau đó dùng Ctrl+X, chọn Y, sau đó bấm Enter để Save. Chi tiết bạn xem thêm hình dưới. Sau này tôi sẽ không đề cập lại những thao tác cơ bản này.
    [​IMG]

    Bấm Y lựa chọn Yes, sau Enter để save.
    [​IMG]
    Tiếp theo đó bạn add key dành cho Koha vào trong HĐH Ubuntu (đảm bảo Koha có thể update được):
    wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
    [​IMG]
    2.Bước 2- Tiến hành update hệ thống và cài đặt Koha

    Bây giờ bạn đã có thể update và upgrade hệ thống Ubuntu với 2 câu lệnh sau:
    sudo apt-get update
    sudo apt-get upgrade

    [​IMG]
    [​IMG]
    Vì Ubuntu của mình mới update nên không nhiều phần mềm cần update lắm, những nếu bạn mới cài Ubuntu và Koha lần đầu, có thể sẽ đợi khá lâu để Ubuntu update các gói phần mềm cần thiết. Bấm Y và ngồi đợi thôi!
    Sau khi kết thúc upgrade, bạn cần tiến hành cài mysql-server:
    sudo apt-get install mysql-server
    [​IMG]
    Và chọn Yes.
    [​IMG]
    Và nhập password cho mysql, chú ý đây là password rất quan trọng dành cho root user, bạn phải nhớ kĩ nó:
    [​IMG]
    [​IMG]
    Sau đó nhập lại và đợi sau khi cài xong mysql-server thì chúng ta tiến hành cài đặt koha với câu lệnh:
    sudo apt-get install koha-common
    [​IMG]Sau đó bấm Y để hệ thống download gói Koha-common về và tiến hành cài đặt
    [​IMG]
    Kết thúc quá trình cài đặt Koha.
    Nếu như trong quá trình cài đặt, bạn gặp lỗi sau:
    Errors were encountered while processing:
    libapache2-mpm-itk
    apache2-mpm-itk
    koha-common


    Thì chạy 2 câu lệnh sau:
    sudo a2dismod mpm_event
    sudo apt-get install -f

    Sau đó thực hiện lại lệnh cài Koha:
    sudo apt-get install koha-common
    • If you try to access Koha, but you get a file save dialogue box from your browser, then run:
    sudo a2enmod cgi
    sudo service apache2 restart
    (Lỗi này đã được fix)

    3.Bước 3- Setup hệ thống Koha vừa cài đặt
    Trước tiên chúng ta sẽ edit file /etc/koha/koha-sites.conf
    với câu lệnh:
    sudo nano /etc/koha/koha-sites.conf
    Sau đó thêm những dòng dưới vào trong file trên. Chú ý phần domain, nếu như bạn muốn trang web thư viện là http://library.dreamlib.vn thì phần domain bạn sẽ để là “.dreamlib.vn”. Khi ấy thì trang quản lí admin Koha sẽ là http://library-admin.dreamlib.vn. Ngoài ra nếu bạn muốn trang admin sẽ là http://library.dreamlib.vn:8080 thì thay intraport thành 8080. bỏ "-admin" đi là xong. Chú ý phần này quan trọng vì nó có tác dụng giúp truy cập Koha intranet qua mạng LAN. Nếu bạn định biên mục trên máy cài Koha luôn thì không quan trọng chỗ này.

    DOMAIN=".yourdomain.com" # Change this to be your domain. Any instance will be a subdomain of this string.
    INTRAPORT="80" # TCP listening port for the administration interface
    INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
    INTRASUFFIX="-admin" # For administration interface URL: Suffix to be added to the instance name.
    DEFAULTSQL="" # a value is generally not needed.
    OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
    OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
    OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
    ZEBRA_MARC_FORMAT="marc21" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'
    ZEBRA_LANGUAGE="en" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'




    Giao diện admin của thư viện có thể truy cập theo địa chỉ sau:
    http://{INTRAPREFIX}{InstanceName}{INTRASUFFIX}{DOMAIN}:{INTRAPORT}
    Và đây là giao diện OPAC cho bạn đọc:
    http://{OPACPREFIX}{InstanceName}{OPACSUFFIX}{DOMAIN}:{OPACPORT}


    [​IMG]
    Sau đó Ctrl+X, chọn Y và Enter để Save!
    Sau đó bạn enable “rewrite” mode trong Ubuntu với câu lệnh sau:
    sudo a2enmod rewrite
    Tiếp theo bạn tiến hành cài đặt cơ sở dữ liệu cho hệ thống thư viện của bạn. Đầu tiên là cài đặt “Koha Creation”. Bạn có thể thay “thuvien” bên dưới bằng tên thư viện của bạn.
    sudo koha-create --create-db thuvien
    [​IMG]
    Sau đó bạn tiến hành setup Ubuntu Mysql Security
    mysql -u root -p
    > USE mysql;
    > SELECT host,user FROM user;
    > DELETE FROM user WHERE user='';
    > SELECT host,user FROM user;
    > FLUSH PRIVILEGES;
    > QUIT

    [​IMG]
    [​IMG]
    [​IMG]
    [​IMG]
    4.Bước 4 - Config Apache
    Bạn mở file /etc/apache2/ports.conf bằng câu lệnh sau:
    sudo nano /etc/apache2/ports.conf

    và chắc chắn rằng dòng sau không phải là dòng comment, tức là không có # ở đầu:
    Listen 80
    Chú ý 80 chính là số port mà chúng ta đã đặt cho cổng truy cập 2 trang thuvien.yourdomain.com và thuvien-admin.yourdomain.com trong phần “Set up cho hệ thống Koha bên trên”
    [​IMG]
    Chú ý thêm cần phải uncomment dòng NameVirtualHost *:80 và *:8080
    [​IMG]
    Sau khi cài đặt Koha xong, trong apache server tồn tại một file default, nếu như bạn không cần file này, hãy disable nó đi với câu lệnh:
    sudo a2dissite 000-default
    Tiếp theo là Enable các Module và Koha site:
    sudo a2enmod rewrite
    sudo a2enmod deflate
    sudo a2ensite library
    sudo /etc/init.d/apache2 restart

    [​IMG]
    Chú ý bên trên bạn uncomment cả *:8080, mà chưa cài đặt cổng 8080 nên có thể sẽ có thông báo như trên, nhưng không có vấn đề gì cả.
    Từ năm 2014 về sau, mục này có lẽ không cần nữa. Apache mới không yêu cầu nữa vì nó sẽ mặc định luôn.
    5.Bước 5 – Tweak Host file
    Phần này chính là phần tạo host cho hệ thống Koha. Nếu bạn có tên miền trước, máy chủ có thể connect từ internet (có ip tĩnh cùng với tên miền), phần này giúp hệ thống Koha của bạn có thể truy cầp qua internet. Ngoài ra cũng giúp máy tính khác trên mạng LAN truy cập đến máy chủ cài Koha của bạn. Đầu tiên bạn edit file /etc/hosts với lệnh sau:
    sudo nano /etc/hosts
    và thêm 2 dòng sau vào bên dưới, chú ý thay bằng domain cho thư viện của bạn
    127.0.0.1 thuvien.yourdomain.com
    127.0.0.1 thuvien-admin.yourdomain.com

    [​IMG]
    Nếu như bạn muốn truy cập vào trang web server này (offline) từ máy khác trên mạng LAN thì bạn thêm 2 dòng khác, thay 127.0.0.1 bằng địa chỉ IP máy cài Koha trên mạng LAN. Địa chỉ IP có thể có bằng câu lệnh:
    sudo ifconfig
    Kết quả nhận được tương tự như sau, và IP là phần được in đậm:

    eth0 Link encap:Ethernet HWaddr 08:00:27:14:22:6c
    inet addr:192.168.69.38 Bcast:192.168.69.255 Mask:255.255.255.0
    inet6 addr: fe80::a00:27ff:fe14:226c/64 Scope:Link
    UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
    RX packets:24087 errors:0 dropped:0 overruns:0 frame:0
    TX packets:29550 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:1000
    RX bytes:2968198 (2.9 MB) TX bytes:4828089 (4.8 MB)


    lo Link encap:Local Loopback
    inet addr:127.0.0.1 Mask:255.0.0.0
    inet6 addr: ::1/128 Scope:Host
    UP LOOPBACK RUNNING MTU:16436 Metric:1
    RX packets:11 errors:0 dropped:0 overruns:0 frame:0
    TX packets:11 errors:0 dropped:0 overruns:0 carrier:0
    collisions:0 txqueuelen:0
    RX bytes:3794 (3.7 KB) TX bytes:3794 (3.7 KB)



    Khi đó bạn thêm vào cuối file /etc/hosts 2 dòng sau:
    192.168.69.38 thuvien.yourdomain.com
    192.168.69.38 thuvien-admin.yourdomain.com ( nếu dùng port 8080 cho trang Intranet thì có thể bỏ dòng thứ 2 này đi)

    Và từ máy khác, bạn chỉ việc đánh địa chỉ IP của máy cài Koha trên trình duyệt Web và nó sẽ truy cập đến 2 trang web trên.
    Phần này cần đảm bảo ip của máy trên mạng LAN là cố định ( sau khi khời động lại sẽ không chuyển sang ip khác). Xem thêm bài viết về Koha trên mạng LAN nhé!
    6. Bước 6: Bước cài đặt Web Installation
    Đầu tiên bạn cần nhận được password để login vào trang admin của thư viện koha mà bạn tạo ra. Username sẽ là koha_thuvien
    Password bạn nhận được bằng cách đánh dòng sau vào terminal (copy paste cũng được). Chú ý thay “thuvien” bằng tên thư viện của bạn:
    sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/thuvien/koha-conf.xml
    [​IMG]

    Tiếp theo bật Firefox lên, tiến hành đăng nhập vào trang http://thuvien-admin.yourdomain.com với user và password như trên:
    [​IMG]

    Sau khi Login vào, chọn En (tiếng anh) và Next, rồi lại next:
    [​IMG]

    [​IMG]
    Tiếp theo bạn sẽ kiểm tra lại lần nữa:
    Tên cơ sở dữ liệu: koha_thuvien
    Tên user: koha_thuvien
    Password là password bạn vừa nhận được bên trên. Next!
    [​IMG]
    Tiếp theo bạn cứ bấm next đến khi cần phải install basic configuration:
    [​IMG]
    Sau đó click vào install basic configuration setting để cài đặt một chút mặc định cho hệ thống Koha. Phần này khá quan trọng, bạn nên đọc kĩ.
    Đầu tiên lựa chọn Marc 21, Koha hỗ trợ định dạng này tốt hơn.
    [​IMG]
    Tiếp theo là quá trình import những dữ liệu mặc định trong Koha vào trong cơ sở dữ liệu koha_thuvien của bạn. Bạn hãy lựa chọn tất cả, ngoại trừ 2 dòng: Sample librariesSample Patrons, khi đó trước khi sử dụng Koha, bạn cần tạo mới thư viện của bạn, và danh sách bạn đọc của thư viện của bạn sẽ bắt đầu từ 1. Nếu bạn chỉ muốn test, có thể chọn tất, tuy nhiên sẽ khá rắc rối khi sửa về sau, nên tốt nhất không lựa chọn 2 lựa chọn trên.
    [​IMG]


    [​IMG]
    Và cuối cùng Finish sau khi import:
    [​IMG]

    [​IMG]
    Và bắt đầu login lại, chào mừng bạn đến với Koha-library!
    [​IMG]
    [​IMG]

    Bạn đang Login với một user/pass dành cho cơ sở dữ liệu. Đây là một ý kiến tồi, bởi nếu như ai đó biết user/pass này, bạn sẽ có thể mất toàn bộ dữ liệu. Sẽ tốt hơn nếu bạn tạo một user mới, cho user đó toàn quyền sử dụng Koha nhưng không thể can thiệp vào cơ sở dữ liệu của bạn.
    Đầu tiên bạn Create a Patron (dòng chữ màu xanh hoặc ô Patrons hình trên). Do trước đây bạn không import sample libraries nên bạn chưa có thư viện nào, bạn cần tạo một thư viện mới:
    [​IMG]

    Sau đó click Add a Library:
    [​IMG]

    Và chọn “+ New library”:
    [​IMG]
    Sau đó Submit và quay lại Home để tạo Patron. Để tạo patrons (người sử dụng), bạn vào ô Patrons trên giao diện chính, lựa chọn “+ New patrons” và chọn Staff (nhân viên).
    [​IMG]
    [​IMG]
    Và tiến hành Save:
    [​IMG]
    Sau đó ra giao diện chính, lựa chọn setup permission:
    [​IMG]
    Và lựa chọn superlibrarian như hình dưới đây!
    [​IMG]
    Và bạn thoát ra ngoài, có thể login bằng tài khoản bạn vừa lập. Chúc mừng bạn đã hoàn thành xong quá trình cài đặt Koha. Giờ việc bạn cần làm là tìm hiểu thêm về cách sử dụng Koha nữa là xong. Mọi thông tin bạn có thể xem thêm trên http://dreamlib.vn và liên lạc với mình qua email:
    nguyenquocuy_1102@yahoo.com.
    Phần 2 tôi sẽ hướng dẫn các bạn tìm hiểu sâu hơn về hệ thống Koha với cách cài đặt Phpmyadmin để quản lí CSDL mysql, cách tạo giao diện đẹp mắt cho Koha.
    Nguyễn Quốc Uy​
    Last edited: Dec 23, 2014
    .::Jin_IT::. and PhanNgocDong like this.
     
  2. thangtq

    thangtq New Member

    Minh cai xong bi loi the nay (xin loi minh ko danh duoc tieng viet) xu ly the nao ban nhi?
  3. nguyenquocuy

    nguyenquocuy Administrator Staff Member

    Koha có 2 trang nhé bạn, trang mà bạn vừa vào và xuất hiện lỗi này là trang OPAC (giao diện cho bạn đọc). Lỗi này hay phát sinh khi bạn chưa login vào trang admin (giao diện nhân viên) để tiền hành bước 6: Bước cài đặt Web Installation?
    Bạn cài xong đến bước nào rồi?
    Ngoài ra bạn thử check ở /etc/apache2/sites-enabled/ xem còn file 000-default không? Nếu còn thì bạn thử chạy lệnh sau:
    sudo a2dissite 000-default (disable cái default site đó đi).
    Nếu không được, bạn nhớ kiểm tra lại file /etc/koha/koha-sites.conf. Đảm bảo rằng các port là 80 nhé, nếu không nó sẽ mặc định port là 8080 cho trang admin.
  4. nguyenquocuy

    nguyenquocuy Administrator Staff Member

    Nếu vẫn có lỗi, bạn email cho mình toàn bộ các file trong thư mục này nhé:
    /etc/apache2/sites-enabled
    và file này nữa: /etc/koha/koha-sites.conf
  5. thangtq

    thangtq New Member

    Mình đã làm hết các bước từ 1-5. Mình vào cả hai trang OPAC và admin đều xuất hiện lỗi như thế!
    mình cũng sử dụng lệnh: sudo a2dissite 000-default
    file trong sites-enabled mình không copy được (ko biết làm thế nào nhỉ?)
    còn đây là file koha-sites.conf

    Attached Files:

  6. thangtq

    thangtq New Member

    ok! minh da sua duoc roi! Tks ban nhe!
    (lai phai xin loi vi minh ko danh duoc tieng viet)
  7. nguyenquocuy

    nguyenquocuy Administrator Staff Member

    Làm sao mà bạn sửa lỗi được? Lỗi chỗ nào thế bạn? Bạn chia sẻ cho người sau biết mà tránh nhé, vì lỗi này khá hay gặp đấy!
  8. thangtq

    thangtq New Member

    Sau một lúc mày mò mình đã sửa được cái lỗi đấy bằng cách thay lại servername trong file nằm ở /etc/apache2/sites-enabled

    Chắc là trong lúc cài đặt mình có vấn đề j đó mà nó lại ko tự động nhận mà phải sửa ở đấy.

    nguyenquocuy likes this.
  9. nguyenquocuy

    nguyenquocuy Administrator Staff Member

    Hay quá. Tình hình thư viện bạn setup thế nào rồi? Go online chưa? Có gì chia sẻ cho mọi người demo luôn nhé.
  10. thangtq

    thangtq New Member

    Thư viện của mình vẫn đang chạy thử nghiệm. Vẫn còn trong quá trình mày mò và tìm hiểu thôi.
    Hình như giao diện tiếng việt trong phần dành cho nhân viên lỗi thì phải (lỗi có cả trên http://test-admin.dreamlib.vn). Khi chuyển sang tiếng việt thì không nhập liệu được, đánh chữ toàn bị nhảy lên phần search. (trong trang demo của koha.vn thì ko xảy ra lỗi này - có thể các bác koha.vn ko share bản chuẩn thì phải :D )
    Còn đây là giao diện OPAC (có copy ý tưởng dreamlib.vn :p do có ít time quá)

    Attached Files:

Share This Page