window2008Server安装showdoc全过程

showdoc是国内的一款api文档管理系统,可以安装在linux和windows服务器上,有自动安装脚本,也可以手动安装。

showdoc有在线系统,但是为了安全性,一般都是在内部独立部署,公司需要在window服务器上部署,遇到了好几个坑,这里写下。

 

1.win-R 打开命令行程序,输入mstsc 远程连接window 2008 server (个人非常不喜欢用window服务器,一直都是用SSH连LINUX系统的,这会不会是鄙视链?)

2.因为showdoc需要在apache、php环境下运行,所以先要部署容器环境,查看官网说明https://www.showdoc.cc/help?page_id=13732

得知,有集成好了的服务容器,wamp-server,在网上搜索后,下载传到服务器的文件夹里,解压安装。

3. 安装到最后发生异常错误,大概的意思是apache的httpd文件报错,说找不到MSVCR110.DLL文件,无法启动程序。

window2008Server安装showdoc全过程_第1张图片

经过网上搜索咨询,知道服务器的window系统里缺少这个文件,服务器是64位操作系统,

在C:/syswow64里没有这个文件,如果是32位系统,在C:/system32里找

 

我在微软下载了补丁 http://www.microsoft.com/zh-CN/download/details.aspx?id=30679

下载Visual C++ Redistributable for Visual Studio 2012 Update 4更新安装

 

4. 本以为打了补丁就好了,再次安装wampServer,还是启动报错,我发现syswow64里仍然没有MSVCR110.DLL, 我干脆把system32里的拷贝过来,启动服务又报错了,如下图:

window2008Server安装showdoc全过程_第2张图片

5.这一次的错误代码不一样,说明win服务器环境还是缺乏必要的底层支撑环境,就像开发JAVA项目,运行JAVA程序必须得有JDK环境一样。

百度了一下,发现没有安装Visual Studio,在官网选择了2013版本,把32位和64位的都下载了,因为有位同学说最好都安,不然启动还是报错。

6.安装完毕后,重新启动wampserver,发现没有弹出错误提示了,舒了一口气。

将语言设置为中文简体,如下图

window2008Server安装showdoc全过程_第3张图片

接下来应该部署showdoc了,但以系统的尿性,我部署程序重来都是坑不断,哪有那么顺利。。。

我先下载showdoc的压缩包,解压后放到wampServer默认的www文件夹下,

然后访问http://localhost/showdoc-master 发现提示404,项目文件不存在

 

7.这是怎么回事!我点击wampServer,访问诊断页面,也是如此

原来,我的服务压根就没有启动好,图标是黄色的。

window2008Server安装showdoc全过程_第4张图片

点击图标,选择面板上的apache-->service-->测试80端口,发现如下图:

window2008Server安装showdoc全过程_第5张图片

说明IIS服务占用了80端口,没办法只能修改apache的httpd.conf了,访问文件路径:

D:\wamp\bin\apache\apache2.4.9\conf

搜索80字符串,可以找到原本配置80端口的地方,将80改为811(这个自己定义)

一共有2处,分别是Listen和ServerName

还有一个地方需要修改,为了能让外部访问服务器的apache服务地址,必须修改部署showdoc的文件地址的访问权限,找到 将AllowOverride none和 Deny from all 修改为

AllowOverride all , Allow from all ,如果没有这2个请自行添加。

完毕后重启apache服务,可以发现wampServer的图标绿了。服务都正常启动了!

访问localhost:811

window2008Server安装showdoc全过程_第6张图片访问localhost:811/showdoc-master/

第一次,会进入初始化showdoc的安装页面,instanll.php,界面略。请选择中文,点下一步

用IE浏览器会发现js报错无法进行下去,请用chrome或者360极速(鄙视IE内核,鄙视链第二轮)

换了chrome就OK了,提示安装成功:

 

安装成功!默认管理员账户密码是showdoc/123456。登录后,在右上角可以看到管理后台入口。

此外,强烈建议修改管理员初始密码。若再遇到问题,可参考ShowDoc帮助文档:https://www.showdoc.cc/help

 

输入账户密码,就可以进去部署自己的应用了。

window2008Server安装showdoc全过程_第7张图片

我们试试用外网访问服务器的地址也是OK的。

 

又学到了一个新的API文档管理系统的部署和使用,成长就是要不断的学习,但是我还是喜欢在linux上部署项目和环境,觉得RAP和swagger都比这个顺手, 现在做spring boot的开发,更喜欢用swagger了(鄙视链第三波)

你可能感兴趣的:(window2008Server安装showdoc全过程)