天天看點

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全過程

經過網上搜尋咨詢,知道伺服器的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全過程

5.這一次的錯誤代碼不一樣,說明win伺服器環境還是缺乏必要的底層支撐環境,就像開發JAVA項目,運作JAVA程式必須得有JDK環境一樣。

百度了一下,發現沒有安裝Visual Studio,在官網選擇了2013版本,把32位和64位的都下載下傳了,因為有位同學說最好都安,不然啟動還是報錯。

6.安裝完畢後,重新啟動wampserver,發現沒有彈出錯誤提示了,舒了一口氣。

将語言設定為中文簡體,如下圖

window2008Server安裝showdoc全過程

接下來應該部署showdoc了,但以系統的尿性,我部署程式重來都是坑不斷,哪有那麼順利。。。

我先下載下傳showdoc的壓縮包,解壓後放到wampServer預設的www檔案夾下,

window2008Server安裝showdoc全過程

然後通路http://localhost/showdoc-master 發現提示404,項目檔案不存在

7.這是怎麼回事!我點選wampServer,通路診斷頁面,也是如此

原來,我的服務壓根就沒有啟動好,圖示是黃色的。

window2008Server安裝showdoc全過程

點選圖示,選擇面闆上的apache-->service-->測試80端口,發現如下圖:

window2008Server安裝showdoc全過程

說明IIS服務占用了80端口,沒辦法隻能修改apache的httpd.conf了,通路檔案路徑:

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

搜尋80字元串,可以找到原本配置80端口的地方,将80改為811(這個自己定義)

window2008Server安裝showdoc全過程
window2008Server安裝showdoc全過程

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

還有一個地方需要修改,為了能讓外部通路伺服器的apache服務位址,必須修改部署showdoc的檔案位址的通路權限,找到<Directory "d:/wamp/www/"> 将AllowOverride none和 Deny from all 修改為

AllowOverride all , Allow from all ,如果沒有這2個請自行添加。

完畢後重新開機apache服務,可以發現wampServer的圖示綠了。服務都正常啟動了!

通路localhost:811

window2008Server安裝showdoc全過程

通路localhost:811/showdoc-master/

第一次,會進入初始化showdoc的安裝頁面,instanll.php,界面略。請選擇中文,點下一步

用IE浏覽器會發現js報錯無法進行下去,請用chrome或者360極速(鄙視IE核心,鄙視鍊第二輪)

換了chrome就OK了,提示安裝成功:

安裝成功!預設管理者賬戶密碼是showdoc/123456。登入後,在右上角可以看到管理背景入口。

此外,強烈建議修改管理者初始密碼。若再遇到問題,可參考ShowDoc幫助文檔:https://www.showdoc.cc/help

輸入賬戶密碼,就可以進去部署自己的應用了。

window2008Server安裝showdoc全過程

我們試試用外網通路伺服器的位址也是OK的。

又學到了一個新的API文檔管理系統的部署和使用,成長就是要不斷的學習,但是我還是喜歡在linux上部署項目和環境,覺得RAP和swagger都比這個順手, 現在做spring boot的開發,更喜歡用swagger了(鄙視鍊第三波)