开源知识库管理系统选型 centos6.4 搭建knowlededgeroot-1.0.4知识库平台

开源知识库管理系统选型，除了使用wiki外，还有下面可选：

1. http://www.knowledgebase-script.com/
2. https://github.com/lordlamer/knowledgeroot
3. http://www.phpmyfaq.de/ 
4. http://sourceforge.net/projects/kbpublisher/
5. http://sourceforge.net/projects/openkbs/

 

centos6.4 搭建knowlededgeroot-1.0.4知识库平台

 

 

   最近接到一个任务，要求搭建一个用于部门内部业务知识规范管理和共享的平台，目的是把部门内的FAQ知识规范化，保持版本统一。

需求以下：

• 可以在线编辑资料并设置格式，页面上可以插入和显示截图。

• 可以插入表格，而且最好能显示颜色和边框。

• 能上传和下载附件。

• 并可以给每一个人设置只读或修改等不一样的权限。

• 在知足以上要求的前提下，尽可能让界面操做简单，结构清晰明了。

鄙人前后在本身的虚拟机上搭建并测试了HDwiki、JSPwiki 都不是太理想。后来发现knowledgeroot能够实现我上面的需求，并且界面比较简单。因而就用它搭建了个人知识库平台。下面把我利用knowledgeroot搭建内部知识库的步骤分享给你们。因为这个知识库只是供部门内部使用，服务器不能连外网，因此搭建在内网环境里。

 

实施：

 

1、搭建内网本地的yum源，为安装lnmp环境作准备。见此文。centos6.4利用iso文件搭建本地yum源

二、部署lnmp环境：linux+nginx+mysql+php环境，这一步本文先不阐述。你们能够参考网上的一些方法。

3、部署knowledgeroot站点程序。

1、下载knowledgeroot-1.0.4程序。

去该网址http://www.knowledgeroot.org/下载最新的安装包：knowledgeroot-1.0.4.tar.gz

 

同时在下面的页面中下载ckeditor这个编辑器插件ckeditor_3.6.2.krx，用来替换knowledgeroot自带的编辑器，该编辑器比自带的编辑器要强大一些，功能更多一下，关于ckeditor的详细介绍，请看Web 编辑器CKEditor 介绍。

 

2、将下载来的knowledgeroot-1.0.4.tar.gz上传并解压到服务器的web站点根目录下。

往linux上传文件你们都会的，我这里使用rz工具上传，可我服务器上没法使用rz命令，是由于没有安装rz命令相关的软件包。那就加一个小插曲，把rz工具安装上。（会上传文件以及使用其余工具上传的朋友略过。）

   a、查看rz命令属于哪一个软件包。

[root@centos6~]# yum provides */rz

Loadedplugins: fastestmirror, security

Loadingmirror speeds from cached hostfile

lrzsz-0.12.20-27.1.el6.x86_64: The lrz and lsz modem communications programs

Repo        : c6-media

Matchedfrom:

Filename    : /usr/bin/rz

        b、安装lrzsz-0.12.20-27.1.el6.x86_64工具包。

[root@centos6~]# yum install lrzsz -y

安装完成。

此时就能够在远程的终端里输入rz命令，系统会自动弹出选择上传文件的选择框，找到本地电脑上的文件，肯定后就能够传到当前目录。

解压文件：

[root@centos6~]# tar zxvf knowledgeroot-1.0.4.tar.gz

tar:它彷佛不像是一个 tar 归档文件

tar:跳转到下一个头

tar:因为前次错误，将以上次的错误状态退出

 

这里出错了，系统认为该文件不是tar压缩包，有点奇怪，那咱们看看他究竟是什么文件。

[root@centos6~]# file knowledgeroot-1.0.4.tar.gz

knowledgeroot-1.0.4.tar.gz:gzip compressed data, from Unix

 

原来他是gzip的压缩文件，ok，那咱们用gzip来解压缩。

[root@centos6~]# gzip -d knowledgeroot-1.0.4.tar.gz

[root@centos6~]# ll

总用量13900

-rw-r--r--  1 root root 1986919 11月  2 01:06ckfinder_php_2.4.zip

-rw-r--r--  1 root root 11080018 11月  2 02:33 knowledgeroot-1.0.4.tar

此时发现原来的knowledgeroot-1.0.4.tar.gz 已经变成knowledgeroot-1.0.4.tar文件了，接着再用tar来解压，就顺利成章的获得压缩包里的文件了。

[root@centos6~]# tar xvf knowledgeroot-1.0.4.tar

[root@centos6 ~]# mv knowledgeroot-1.0.4/data/htdocs/www/      ###将解压后的目录移动到服务器的web站点的根目录下，个人web站点根目录是/data/htdocs/www/

3、配置虚拟主机站点。

咱们确认下站点的目录。须要把这个路径配置到nginx的配置文件中。

[root@centos6www]# ls /data/htdocs/www/knowledgeroot-1.0.4/

admin         cache  content.php  doc    extension   icon.php  images   index.php   lib       print.php  update.php

ajax-xml.php  config debug.php    dumps  favicon.ico icons     include  install.php move.php  system     uploads

 

[root@centos6www]# vi /usr/local/webserver/nginx/conf/nginx.conf

添加下面一部分信息：

server

{

listen80;

server_namewww.ycitzsk.com 192.168.0.109;

indexindex.html index.htm index.php;

root/data/htdocs/www;

 

location~ .*\.(php|php5)?$

{

#fastcgi_passunix:/tmp/php-cgi.sock;

fastcgi_pass127.0.0.1:9000;

fastcgi_indexindex.php;

includefcgi.conf;

}

location~ .*\.(gif|jpg|jpeg|png|bmp|swf)$

{

expires30d;

}

 

location~ .*\.(js|css)?$

{

expires1h;

}

 

log_formatwwwlogs '$remote_addr - $remote_user [$time_local] "$request" ''$status $body_bytes_sent "$http_referer" ''"$http_user_agent" $http_x_forwarded_for';

access_log/data/logs/wwwlogs.log wwwlogs;

 

}

 

修改完成测试一下nginx配置文件是否有语法错误：

[root@centos6www]# /usr/local/webserver/nginx/sbin/nginx -t

theconfiguration file /usr/local/webserver/nginx/conf/nginx.conf syntax is ok

configurationfile /usr/local/webserver/nginx/conf/nginx.conf test is successful

测试ok，从新加载配置：

[root@centos6www]# /usr/local/webserver/nginx/sbin/nginx -s reload

[root@centos6 www]# cd/data/htdocs/www/knowledgeroot-1.0.4

[root@centos6knowledgeroot-1.0.4]# chmod -R 777 admin/

[root@centos6knowledgeroot-1.0.4]# chmod -R 777 config

[root@centos6knowledgeroot-1.0.4]# chmod -R 777 cache

 

4、开始安装knowledgeroot：

在浏览器中输入服务器的ip或域名及路径，好比http://192.168.0.109/knowledgeroot-1.0.4/install.php回车就会出现安装界面，以下，填写相关信息。

 

 

输入完信息后点击最下面的“start intallation”完成安装。

这里若是报错诸如“Could not connect to database! " 请检测数据库用户名和密码是否正确，能够先在服务器上用你的mysql账号和密码测试一下是否可以连接。检测账号的受权信息等。

若是报错跟config目录权限有关，请检查admin和config目录的权限是否已经设置为了777.

 

若是权限什么的都正常，就会返回下面的安装成功的信息。并提示删除install.php和update.php，

 

点击最下面的“Link Backend: Backend”就能够跳转到后台管理页面。以下：

（注意这里若是报错cache没有写入权限的话，请给cache目录设置权限为777），刷新就能够出现登陆界面了。

 

输入用户名和密码admin 登陆到后台界面：在这个页面能够查看和修改配置信息，也能够导入插件，添加账号。

 

从新打开浏览器输入ip或域名加路径，登陆到前台页面：以下：

可使用admin登陆进去，点击roots 就能够建立一级页面，并能够设置权限，设置是否继承权限到子页面。

 

选中某个一级页面，路径那里会显示当前选中的页面，点击“增长新页面”就能够在该一级页面下建立二级页面。

 

 

一样的，选中某一级页面，点击“增长新的内容”就能够打开内容编辑页面，这里能够编辑页面内容了。

 

 

 

 

 

5、个性化配置knowledgeroot。

 

原来安装包建立的数据库默认使用瑞典语，这个很很差看，能够打开dumps/mysql.sql 文件进行修改，将

ENGINE=MyISAM AUTO_INCREMENT=1

所有替换为

ENGINE=MyISAM AUTO_INCREMENT=1CHARACTERSET utf8 COLLATE utf8_unicode_ci

 

用下面的一行命令一次性修改完成：

sed  -i  's/ENGINE=MyISAM AUTO_INCREMENT=1/ENGINE=MyISAMAUTO_INCREMENT=1\ CHARACTER SET utf8 COLLATE utf8_unicode_ci/g'  dumps/mysql.sql

便可保证全部的表建立为UTF-8 格式的。

 

登陆管理后台：浏览器中输入http://服务器站点ip或域名/admin例如：个人站点是http://192.168.0.109/admin/回车后就会出现登陆界面，输入初始账号和密码都是admin，点击登陆就会出现下面的界面。

 

如上图所示，点击左侧的configure按钮，右侧就会出现当前的配置详情，能够根据本身的需求更改相应的配置，双击等号下面的参数值就能够更改。修改后回车即时生效。也能够在服务器上站点目录下的config目录中修改app.ini文件，这个页面就是调用的该文件。

如下是个人配置文件，应该调试的时候更改了一些参数，我把站点根目录也改为了/data/htdocs/wiki/，结果以下：

[root@centos6wiki]# more /data/htdocs/wiki/config/app.ini

[base]

version= "1.0.4"

title = "IT运维知识库"                                         ##这里是浏览器标签栏上显示的标题，根据本身想显示的标题写

cryptkey= "yourcryptkeyhere"

base_path= "/data/htdocs/wiki/"                    ##这里是网站在服务器上存放的绝对路径，根据本身实际状况填写

base_url= "http://192.168.0.109/"                  ##这里是访问网站的url路径，根据本身的实际状况填写。

charset= "UTF-8"                                                 ##这里是编码

locale= "zh_CN"                                                   ##默认语言

showlogo= "1"

theme= "wordpress"

 

[admin]

loginhash= "f6fdffe48c908deb0f4c3bd36c032e72"

base_path= "/data/htdocs/wiki/admin/"

 

[upload]

url_suffix= "upload/"

path= "uploads/"

maxfilesize= "30720000"

 

[output]

compression= "1"

level= "6"

 

[db]

adapter= "mysql"

params.host= "127.0.0.1"

params.username= "admin"

params.password = "mysql_password"

params.dbname= "wiki"

encoding= ""

schema= ""

profiler= "1"

pconnect= ""

 

[session]

handle= "1"

lifetime= "60"

check_browser= "1"

check_ip= "1"

only_cookies= "1"

 

[login]

delay= "30"

max= "50"

 

[email]

notification= ""

html= "1"

 

[cache]

options.caching= ""

options.lifetime= "7200"

options.automatic_serialization= "1"

path= "cache/"

 

[log]

adapter= "file"

level= "info"

file= "log/knowledgeroot.log"

 

[translation]

adapter= "gettext"

folder= "system/language/"

 

[development]

runtime= ""

toolbar= ""

sqldebug= ""

 

[tree]

expandall= "1"

type= "static"

ajax= "1"

edittooltiptext= "1"

order= ""

showcounter= "1"

defaultlayout= ""

defaultlayoutarray= ""

symlink= "1"

 

[content]

showtitle= "1"

showtitledetails= "1"

collapsecontent= "1"

statusbar= "1"

autosave= "1"

autosaveevery= "30"

 

[menu]

context= "1"

dragdrop= "1"

type= "static"

showsourceforgelogo= ""

 

[misc]

defaultpage= "1"

recursivdelete= "2"

pagealias.use= "1"

pagealias.static= "1"

pagealias.rights= "2"

langdropdown= "0"

download.static= ""

subinheritrightsonmove= ""

showpagebottomnavi= "1"

 

[javascript]

cdn= ""

cdn_url= "http://ajax.googleapis.com/ajax/libs/dojo/1.6.2/dojo/dojo.xd.js"

cdn_css_base_url= "http://ajax.googleapis.com/ajax/libs/dojo/1.6.2/"

 

 

6、安装历史版本插件，使其支持历史版本。

从http://www.knowledgeroot.org/extensions.html网站下载history.krx插件，并在后台界面import页面中导入history.krx插件，install的时候会向数据库中增长一个表，可能会由于mysql版本的问题，致使表格添加失败，这样在打开页面中的历史版本的时候就会有报错。若是这样，就手动在mysql中执行下面的sql语句，（相对与history插件原始的sql建表语句主要就是更换了最后面一行的sql语句）手动建立数据库表kx_ext_history。这样历史版本就没问题了。

CREATETABLE `kx_ext_history` (

`id` int(11) NOT NULL auto_increment,

`contentid` int(11) NOT NULL,

`version` int(11) NOT NULL,

`title` varchar(255) default NULL,

`content` mediumtext NOT NULL,

`type` varchar(255) NOT NULL default 'text',

`lastupdatedby` int(11) NOT NULL default '0',

`lastupdated` timestamp NOT NULL,

PRIMARY KEY (`id`)

) ENGINE=MyISAM DEFAULT CHARSET=utf8COLLATE=utf8_unicode_ci;

 

7、将ckeditor整合到knowledgeroot中，替换默认编辑器，并将ckfinder和ckeditor组合起来，实现文件上传、图片上传功能。

参考第三部分的第1步，下载并安装ckeditor插件，导入ckeditor插件并启用，替换默认的编辑器。以下图：

 

 

导入成功后点击“extensions”在右侧能够看到已经导入的插件，点击install 并enable，就能够启用相应的插件。

 

此时从新登陆前台页面，打开增长新内容页面，就能够看到编辑器已经替换为ckeditor了，功能比原来强大了好多。