使用MoinMoin搭建运维知识库[上文]

#####################################################

## 若有转载，请务必保留本文连接及版权信息

## 欢迎广大运维同仁一块儿交流linux/unix网站运维技术!

##QQ:335623998

##E-mail:335623998@qq.com

## 博客： http://dreamway.blog.51cto.com/

##weibo ： http://weibo.com/zhaixiangpan

#####################################################

1、知识管理系统

知识管理系统（Knowledge Management System,KMS），它是收集、处理、分享一个组织的所有知识的信息系统，一般有计算机系统支持。知识管理系统使组织能更好地捕捉和应用知识。这些系统收集全部公司内部相关的知识和经验，并使它在任何地方、任什么时候间须要时能方便使用，以改善企业过程和管理决策。他们同时也能链接外部知识源。同时KMS也支持知识的获取、存储、分发和应用过程，也支持创新知识和把知识集成到组织的过程，具体包括组织范围的管理和分发文件、图形及其余数字载体的系统。

面对复杂繁重的系统运维工做，为提升运维效率 ，技能知识、经验显得尤其重要。经过Wiki知识管理平台收集、整合、管理运维知识资源，使本来分散、独立的运维知识造成数据库，更有效的实现知识积累、共享、交流，使部门工做人员充分利用团队的知识力量高效完成运维工做，并对新员工起到培训做用。

运维知识库做用：

1 、实现知识共享

2 、实现知识转化

3 、避免知识流失

4 、规范、统一运维工做

5 、记录工做日志

6 、提升运维响应速度和质量

7 、提高运维服务管理能力

8 、分析运维工做

在这飞速变革的知识经济时代里，我的发展愈来愈依赖于我的竞争力。而我的竞争力的源泉则是我的知识力：我的知识的学习、保存、传递、使用和创新的能力。每一个人都离不开我的知识力的培养和塑造。对于各种机构而言，提高知识员工的我的知识力也是组织效率提高、竞争力升级的基础工做。摘自《你的知识须要管理》

2、MoinMoin

MoinMoin是一个基于Python环境的wiki引擎程序，支持包括中文在内的多语种特性。如今最新稳定版本为1.9.6，MoinMoin可运行在Windows、Linux/BSD/UNIX、OS X等环境下。目前可以处理英文、德文、繁简体中文、日文、俄文等约20种语言。

MoinMoin的特色:

彻底使用文件来存储内容，不使用数据库

实现了所有Wiki规范，Unicode编码支持多语种

完整实用的wiki文本约定，编辑规则比较轻巧易学

支持多种扩展方式: 宏，插件，预处理……

为数众多的插件中包括Tex科技文本输入、FreeMind思惟图谱、GraphViz示意图、gnuplot数据图表绘图等

支持几种很实用的不一样页面样式

真正跨平台

针对我的，也须要进行知识管理及工做日志记录、研究总结。我之前使用OneNote，如今使用为知笔记进行我的知识收集、管理、分类。

 

 3、搭建运维知识库

本文是因为wiki知识库所在的服务器不稳定，须要将其服务迁移至新机器，而原系统是rhel4.7_32bit, 系统和MoinMoin都是比较老的版本，如今的主流操做系统都是RHEL5.5 64bit，直接迁移程序及数据不兼容，考虑在RHEL5.5系统上部署MoinMoin较新的稳定版本moin-1.9.3，再将wiki备份数据目录与新版本数据目录进行合并，启动apache服务便可。

迁移 MoinMoin 记录

3.1系统环境

[root@syswiki ~]# lsb_release -a

LSB Version:    :core-3.1-amd64:core-3.1-ia32:core-3.1-noarch:graphics-3.1-amd64:graphics-3.1-ia32:graphics-3.1-noarch

Distributor ID: RedHatEnterpriseServer

Description:    Red Hat Enterprise Linux Server release 5.5 (Tikanga)

Release:        5.5

Codename:       Tikanga 

3.2 安装需求 

3.2.1 安装epel第三方软件仓库

[root@syswiki ~]# rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm

3.2.2 安装apache2与wsgi组件

[root@syswiki tools]# yum install  -y httpd mod_wsgi

 

httpd.x86_64                                 2.2.3-43.el5

mod_wsgi.x86_64 0:3.2-2.el5  

3.2.3 升级python（可选）

[root@syswiki ~]#  yum install python26 -y

对python作一些处理，使之生效并正常使用

[root@syswiki ~]#  rm -f /usr/bin/python

[root@syswiki ~]# ln -s /usr/bin/python26 /usr/bin/python

[root@syswiki ~]# python -V                             

Python 2.6.8

yum 是基于 python2.4 的，升级后会影响使用。

解决办法也很简单：

[root@syswiki ~]#  vim /usr/bin/yum

#!/usr/bin/python2.4 # 修改成此配置便可

3.3 安装MoinMoin

3.3.1 下载MoinMoin

[root@syswiki tools]# wget http://static.moinmo.in/files/moin-1.9.3.tar.gz

[root@syswiki tools]# ls

moin-1.9.3.tar.gz

3.3.2 解压

[root@syswiki tools]# tar zxf moin-1.9.3.tar.gz

[root@syswiki tools]# ls

moin-1.9.3  moin-1.9.3.tar.gz

3.3.3安装

[root@syswiki tools]# cd moin-1.9.3

[root@syswiki moin-1.9.3]# python setup.py install --force --prefix /opt/syswiki  --record=install.log

 

Configuration files copy

 

安装后的目录/opt/syswiki/share/moin/

[root@syswiki moin-1.9.3]# cd /opt/syswiki/share/moin/

3.4 配置MoinMoin

3.4.1 创建于MoinMoin相关的配置文件

[root@syswiki moin]# cp server/moin.wsgi .

[root@syswiki moin]# cp config/wikiconfig.py  .

3.4.2 配置 Web server

3.4.2.1 配置apache主配置文件

[root@syswiki moin]# vim /etc/httpd/conf/httpd.conf

# 检查打开Include指令

………略…………#

Load config files from the config directory "/etc/httpd/conf.d".

#

Include conf.d/*.conf

…………略…………

# 添加wsgi_module模块配置

# Example:

# LoadModule foo_module modules/mod_foo.so

#

LoadModule wsgi_module modules/mod_wsgi.so

…………略…………

3.4.2.2 配置syswiki虚机主机

[root@syswiki moin]# vim /etc/httpd/conf.d/syswiki.conf

 

NameVirtualHost 192.168.4.176:80

<Virtualhost 192.168.4.176:80>

ServerName syswiki.hexun

ServerAlias syswiki

</Virtualhost>

# MoinMoin WSGI configuration

#

# you will invoke your moin wiki at the root url, like http://servername/FrontPage:

#WSGIScriptAlias /   /usr/local/share/moin/moin.wsgi

WSGIScriptAlias /syswiki /opt/syswiki/share/moin/moin.wsgi

 

# create some wsgi daemons - use user/group same as your data_dir:

WSGIDaemonProcess moin user=apache group=apache processes=5 threads=10 maximum-requests=1000 umask=0007

 

# use the daemons we defined above to process requests!

WSGIProcessGroup moin

 

# WSGISocketPrefix

WSGISocketPrefix /var/run/moin-wsgi

3.4.3配置moin.wsgi

检查mod_wsgi是否安装

[root@syswiki moin]# rpm -qa mod_wsgi 

mod_wsgi-3.2-2.el5                                installed

配置moin.wsgi

[root@syswiki moin]# vim /opt/syswiki/share/moin/moin.wsgi

# a1) Path of the directory where the MoinMoin code package is located.

#     Needed if you installed with --prefix=PREFIX or you didn't use setup.py.

#sys.path.insert(0, 'PREFIX/lib/python2.3/site-packages')

/opt/syswiki/lib/python2.6/site-packages/ # MoinMoin 安装位置根据安装目录而定义

 

# a2) Path of the directory where wikiconfig.py / farmconfig.py is located.

#     See wiki/config/... for some sample config files.

#sys.path.insert(0, '/path/to/wikiconfigdir')

#sys.path.insert(0, '/path/to/farmconfigdir')

sys.path.insert(0, '/opt/syswiki/share/moin') # MoinMoin 主配置文件wikiconfig.py所在目录

 

3.4.4 安全设置 

[root@syswiki moin]# cd /opt/syswiki/share/

[root@syswiki share]# chown -R apache:apache moin

[root@syswiki share]# chmod -R ug+rwX moin

[root@syswiki share]# chmod -R o-rwx moin 

3.4.5 Wiki基本配置

[root@syswiki share]# vim /opt/syswiki/share/moin/wikiconfig.py

 

 

   # b) if wiki content is maintained in many languages

    #page_front_page = u"FrontPage"

    page_front_page = u"StartPage" # wiki 默认首页

 

 

# Security ----------------------------------------------------------

 

    # This is checked by some rather critical and potentially harmful actions,

    # like despam or PackageInstaller action:

    #superuser = [u"YourName", ]

    superuser = [u"WikiAdmin", ]   # 设定超级用户

 

 

重启httpd服务，使配置生效 

[root@syswiki share]# service httpd restart

3.4.6 访问wiki页面是否正常，若访问正常，继续下面配置，若是有问题请检查httpd配置及MoinMoin安装目录与web配置是否一致。

3.5 恢复原wiki数据

3.5.1 为保持数据一致性，先关闭httpd服务

[root@syswiki moin]# service httpd stop

3.5.2 将以前备份最近的wiki数据cp至新的wiki数据目录，data目录包含了全部的用户数据与wiki内容

[root@syswiki data]# pwd  

/opt/home/moinmoin/data

[root@syswiki data]# \cp -a * /opt/syswiki/share/moin/data/

3.5.3 再启动httpd服务

[root@syswiki data]# service httpd start

检查wiki服务、数据、用户与原来是否一致、完整，升级迁移后的MoinMoin版本为moin-1.9.3，数据内容完整，但有一个问题是新老版本wiki语法格式有些差别，少部份内容显示有些差别，但不影响使用及数据内容。

4、运维知识库效果图

至此已经完成MoinMoin Wiki知识库从老版本迁移升级至新版本，为完善Wiki功能还需一些配置，详见下文《使用MoinMoin搭建运维知识库[下文]-完善配置篇》。http://dreamway.blog.51cto.com/1281816/1148252

    关于MoinMoin更多内容详见http://moinmo.in