接口文档管理系统mindoc安装手册

硬件:

centos6.9-64

mysql5.6

首先确保系统安装gcc套件

yum -y gcc

第一步,安装mysql(如果不会在Linux安装mysql，请看下面文章)

http://www.cnblogs.com/gyjx2016/p/5990664.html

第二步,安装go环境，因为mindoc是基于go语言开发

本文安装采用是二进制安装方式，

wget https://storage.googleapis.com/golang/go1.7.3.linux-amd64.tar.gz

将文件解压到/use/local/路径下(路径可以自己定义)

tar -zxf go1.7.3.linux-amd64.tar.gz -C /usr/local/

mkdir /usr/local/golang

开始配置环境变量

vim /etc/profile

export GOROOT=/usr/local/go 
export GOBIN=$GOROOT/bin
export GOPKG=$GOROOT/pkg/tool/linux_amd64 
export GOARCH=amd64
export GOOS=linux
export GOPATH=/usr/local/golang
export PATH=$PATH:$GOBIN:$GOPKG:$GOPATH/bin

完整之后刷新环境变量

source /etc/profile

我们看到go环境已经安装完毕

第三步,查看当前系统的glibc版本 ,可能需要升级

strings /lib64/libc.so.6 |grep GLIBC_

因为centos比较保守所引用的glibc版本较低，而mindoc至少需要2.14版本以上glibc，所以我们需要自己升级，

升级方式有两种，rpm升级和源码升级，这里采用是源码升级，如果您对linux不熟悉建议采用rpm安装升级，rpm升级方式请参考！http://www.cnblogs.com/gyjx2016/p/7201128.html

我们发现centos6.9只支持glibc2.12

开始升级glibc

下载glibc-2.14.tar.gz（百度即可）,然后开始编译，安装

tar -xzvf glibc-2.14.tar.gz
cd glibc-2.14
mkdir build
cd build
../configure --prefix=/opt/glibc-2.14
make && make install

 这个编译安装时间大概需要将近5分钟(根据机器性能)，所以请耐心等待,安装完成之后

1、删除原来的连接，这一步删除之后千万不要乱动，否则linux的基本命令都无法使用了，最好先做备份

rm -rf /lib64/libc.so.6 //谨慎操作后不要乱动

 2、补救(因为上面删除之后，linux基本不能敲，所以下面这条命令，直接复制即可)

LD_PRELOAD=/opt/glibc-2.14/lib/libc-2.14.so ln -s /opt/glibc-2.14/lib/libc-2.14.so /lib64/libc.so.6

 3、创建新的软连接

ln -s /opt/glibc-2.14/lib/libc-2.14.so /lib64/libc.so.6

 然后在查看centos6.9版本库

我们发现已经更新到2.14

ok，到这里完成了mindoc安装的环境配置

到github下载mindoc安装包(本文使用的v0.6版本)

下载地址:

https://github.com/lifei6671/mindoc/releases

文档地址:

https://github.com/lifei6671/mindoc/wiki/Linux-%E4%B8%8B%E5%AE%89%E8%A3%85%E5%92%8C%E9%85%8D%E7%BD%AE-MinDoc

下载之后解压

将/usr/local/mindoc/lib/time/zoneinfo.zip配置到环境变量中

接着，更改mindoc/conf/app.conf

完成之后，执行初始化数据库脚本

 

启动

这个启动是前台启动，所以我们需要改为后台启动，

nohup ./mindoc_linux_amd64 >nohup.out 2>&1 &

 注意linux防火墙需要打开8181端口，打开浏览器直接访问，默认用户名是admin，密码:123456

可能会出现的问题:

checking build system type... x86_64-unknown-linux-gnu

解决方案:

yum -y install make gcc gcc-c++ kernel-devel m4 ncurses-devel openssl-devel