分佈式日誌框架之ExceptionLess【二】：自行搭建幫助文檔【譯文】

原文地址：https://github.com/exceptionless/Exceptionless/wiki/Self-Hosting

ExceptionLess自行託管環境搭建

1、測試環境

---

 若是你想在本地測試ExceptionLess，請遵循本節以下步驟。可是，請注意！如下事項僅用於測試環境，而不是用於生產環境。

一、基本配置

1）.Net 4.6.1

2）Java JDK 1.8+

3）操做系統是Windows環境時，須要配置JAVA_HOME環境變量，參考資料 

4）IIS Express 8+

5）PowerShell 3+ 版本建議在3.0及以上

6）經過管理員身份打開命令提示符，確保PowerShell執行Set-ExecutionPolicy Unrestricted

二、搭建說明

執行如下步驟：

1）確保知足以上全部要求；

2）將最新ExceptionLess發佈壓縮包下載到本機；

3）解壓縮文件； 

4）解壓完後，執行當前目錄下的Start.bat文件，而後會自動下載ElasticSearch、Kibana資源。下載完畢後，會自動啓動ElasticSearch、IIS Express以及默認瀏覽器登陸到ExceptionLess系統登陸頁面；

執行完後，如今能夠建立一個本地賬戶、所屬組織和項目。而後建立項目，模擬發送錯誤信息給它，以便進行本地測試。

 

2、生產環境

---

 在生產環境中，請遵循如下步驟配置ExceptionLess。

一、基本配置

強烈建議在Linux上運行ElasticSearch，至少配置三個節點，其中兩個點是主節點。由於Linux版本比Windows版本的性能要好。

1）.NET 4.7

2）IIS 7.5+

3）ElasticSearch 5.6，ExceptionLess的GitHub站點也有相應的安裝說明

二、搭建說明

1）確保知足以上全部要求；

2）將最新ExceptionLess發佈壓縮包下載到本機；

3）解壓縮文件；

4）在至關的目錄中，若是日誌子目錄不存在，則建立日誌子目錄。確保App_Data和Logs目錄是IIS用戶可寫的。可右鍵->屬性->「安全」頁籤->編輯->選擇IIS_IUSRS，而後選擇「所有控制」複選框；

5）安裝ElasticSearch，ExceptionLess的GitHub站點也有相應的安裝說明；

6）設置IIS，啓用ASP>NET 4.6和靜態內容特性，創建一個新的站點指向wwwroot文件夾，該文件夾能夠在解壓縮的目錄中找到；

7）更新Web.Config文件：

　　a）ElasticSearchConnectionString應該指向ElasticSearch服務器；

　　b）將<appSettings>節點添加到Web.Config配置文件中，它控制每一個索引應該使用多少分片和副本。對於單個節點設置，這些值應該分別設置爲1和0.對於推薦的ElasticSearch集羣（3個節點，2個master），建議值爲3和1；

<add key="ElasticSearchNumberOfShards" value="..." />
<add key="ElasticSearchNumberOfReplicas" value="..." />

　　c）BaseURL應該設置爲網站的外部Url，若沒有采用下面可選部分的CleanUrls內容，請確保將hashbang(/#!)添加到BaseURL；

　　d）若是安裝了SSL證書（推薦），EnableSSL應該設置爲true。若是你的域沒有自簽名證書，能夠在IIS管理器中建立自簽名證書，方法是選擇當前服務器，而後在右側雙擊服務器證書，而後單擊出如今右側空格上的「建立自簽名證書」；

　　e）若是想發送不受限制的電子郵件，應該將WebsiteMode設置爲Production；

　　f）配置你想配置的其餘屬性（如：郵件設置），出如今Settings.cs中的任何屬性都可以在這裏配置；

8）更新App.config.*.js文件：

　　a）BaseURL應該設置爲網站的外部Url，此值不該該附加hashbang(/#!)，即便它是在服務器配置中附加的；

　　b）USE_SSL應該與app.config中的EnableSSL設置相同的值；

　　c）注意：若是在ExceptionLess加載頁面後更改配置文件，則須要進行從新加載；

9）配置系統，而後發送錯誤到站點；

　　如今，你能夠建立一個本地賬戶、所屬組織和項目，並向其發送錯誤信息了。