Koha的介绍及安装
1.koha 简介
一个用perl语言写的开源的图书管理系统。
2.安装
2.1 对操作系统的要求。
- Debian 11
- Debian 10
- Debian 9
- Ubuntu 20.04
- Ubuntu 18.04
- Ubuntu 21.04 (experimental)
上述这些系统koha 21.05版本都支持
我这边搭建的是基于ubuntu21.04
System requirements and recommendations - Koha Wiki (koha-community.org)
2.2 开始安装
2.2.1 增加koha community Repository
echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.list
2.2.2 添加keys.
wget -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
2.2.3 升级软件源(最好是切换到国内源,下载量还是蛮大的)
sudo apt update
sudo apt upgrade
sudo apt clean
2.2.4 开始下载和安装最新的koha的发行版本到系统(这里是借助与这条命令将koha所需的依赖全部安装上去，也可以一步一步手动去配置,涉及步骤较多，不推荐)
sudo apt install koha-common
这条命令执行完基本上koha的依赖环境也安装的差不多了。
2.3 配置koha
2.3.1 这里配置koha的web接口为8080，opac的端口为8081
sudo vim /etc/koha/koha-sites.conf
这一处修改成8080
2.3.2 安装mysql(如果没有安装mysql 此处安装)
sudo apt install mysql-server
也可以安装Mariadb-server
sudo apt install mariadb-server
2.3.3 修改apache 配置
sudo a2enmod rewrite
sudo a2enmod cgi #使apache支持cgi koha是基于cgi编程的
sudo service apache2 restart
2.3.4 创建图书馆实例
sudo koha-create --create-db library
2.3.5 配置apache,将8080(web服务)和8081(opac)加入到监听端口中
sudo vim /etc/apache2/ports.conf
在如下地方添加：
Listen 8080
Listen 8081
2.3.6 支持模块和网站
sudo a2enmod deflate
sudo a2ensite library #图书馆实例名,前面创建的什么这个地方就写什么
sudo service apache2 restart
2.3.7 将实例切换到开发目录
这里使用了一个官方自带的切换脚本 koha-gitify ,具体目录:koha-community / koha-gitify · GitLab
git clone https://gitlab.com/koha-community/koha-gitify.git
sudo ./koha-gitify library ~/koha #mykoha：是前面新建的实例,~/koha 就是koha 代码的目录
sudo service apache2 restart
执行成功后，成功切换到开发目录。
也可以手动配置，可以看官方英文文档
Koha on ubuntu - packages - Koha Wiki (koha-community.org)
2.3.8 添加多语言补丁。
这里主要介绍两种添加方法，一种是包安装模式的下面添加，一种是源码路径下安装
2.3.8.1 通用的命令介绍
sudo koha-translate --list #列举koha本地的已经安装的语言列表
sudo koha-translate --list --available #列举koha网上支持的语言列表
sudo koha-translate --help #帮助命令
2.3.8.2 包安装模式，就是面向部署人员 #华为M30
sudo koha-translate --install zh-Hans-CN
2.3.8.3 源码安装模式 ,面向开发人员
按照官方文档的写法:
export KOHA_CONF=<path_to>/koha-conf.xml #定义环境变量KOHA_CONF主要用于执行命令时寻找koha-conf.xml
export PERL5LIB=<koha_install_dir>/lib/ #主要用于执行perl脚本的时候寻找perl模块
cd <koha_install_dir>/misc/translator
sudo perl translate install <language-code> #安装语言包
sudo updatedb
locate koha-confxml
前三条命令执行都没问题，但执行到第4条命令的时候，坑出现了
意思就是说执行translate perl脚本时找不到C4/Context.pm 模块。
我们学过perl语言就会知道，perl脚本被执行的时候，它的搜索路径主要依赖于一个内置变量@INC，然后再用perl -V 查看下搜索路径
有呢 ？为什么执行不成功呢？想了半天，应该是sudo的原因
然后加了sudo ，命令就是：sudo perl -V
果然是这个问题，知道了问题，就好解决了，这种问题就是因为执行sudo的时候，用户的系统变量就会重置，解决的办法有好多，修改.bashrc脚本啥的，我最讨厌修改系统的那些个玩意，修改了后面要记得修改回来，万一没修改回来，妈蛋！事情就难办了!
那就用sudo sh -c 指令把，将 sudo sh -c 'PERL5LIB=/usr/share/koha/lib/ KOHA_CONF=/etc/koha/sites/library/koha-conf.xml perl translate install zh-Hans-CN',输入shell中，奇迹出现了,安装成功!
经过几秒钟的等待，执行ok
然后执行sudo updatedb
这个简单 ，安装下locate，命令是：sudo apt install mlocate
然后执行sudo updatedb,执行成功。
然后执行 ：locate koha-conf.xml
ok!Success！Ouch！搞定!
为了避免出现问题，重启下apache
sudo service apache2 restart
可爱的koha中文出现了.Everybody！Good luck!
版权所有，转载请附上作者:~会飞的狼~ Contact：feilanglove6@outlook.com
