使用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