簡介


本文介紹瞭如何在服務器上安裝或更新一個全新的 UISP 控制器。文中介紹了 Linux 系統下的安裝教程,如有需要 Windows 或者 OS X 的用戶請閱讀下面的貼士:

需求與說明:

十分抱歉,對於 Windows 和 OS X 系統,我們並不能保證可以正常操作和運行,特別是在備份和升級 docker 容器方面。我們建議使用 [Ubuntu 16.04.1 LTS (Xenial Xerus)](http://releases.ubuntu.com/16.04/) 64 bit 的 Linux 系統安裝 VirtualBox 並按照下面的說明步驟來進行安裝。


目錄


  1. 先決條件
  2. 安裝說明
  3. 常見問題

先決條件


回到頂部

需求: 建議在一臺服務器上安裝 UISP,服務器上有一個公共 IP 地址和 FQDN, FQDN 直接連接在網絡的主網關上。在這個設置中,UISP 將自動擁有一個有效的證書,它將以最精確的方式報告停機情況,它的所有高級功能都將最佳地執行。 當然,您也可以將您的 UISP 服務器放在拓撲的任意位置,但是這樣的話可能會導致部分功能受到限制。

安裝說明


回到頂部

在主機上運行下面的命令來安裝和啟動 UISP (如果還沒有安裝 Docker,它將自動安裝 Docker)。如果一個 UISP 安裝已經存在,它將被覆蓋,但所有數據將被保存。如果希望確保新安裝的參數與舊安裝的參數相同,可以使用屬性——update。您可以通過以下文章將設備註冊到 UISP: UISP 密鑰和設備註冊過程。如果您需要自定義安裝過程,請閱讀可選安裝步驟

curl -fsSL https://unms.com/v1/install > /tmp/unms_inst.sh && sudo bash /tmp/unms_inst.sh

安裝腳本將檢查端口: 80 和: 443 是否打開,如果沒有,您需要指定希望 UISP 使用哪些端口。 這同樣適用於 overcommit memory settings。 如果 vm.overcommit_memory 未被設置為'1',安裝腳本會請求權限去將該參數置為‘1’。如果您不想在安裝過程中受到這些中斷的干擾,可以使用——unattended 屬性讓安裝腳本自己完成所有必要的安排。

流程完成後,可以通過 http://server_hostname_or_ip/ 訪問 UISP。請不要使用 localhost。使用服務器主機名或其 IP 地址。


常見問題


回到頂部

1.安裝過程中遇到 unms.com 無法解析的問題,是由於 DNS 錯誤,需要將本地的 DNS 改成公共 DNS 。

2.安裝過程中遇到 docker 未正常啟動的問題,可以通過 docker ps 來查看 docker 運行是否正常,如果不正常可將 docker 重新安裝。

3.安裝過程中遇到內存不足警告,參考先決條件進行配置升級。

4.安裝過程中遇到網絡波動 docker 或 docker compose 安裝不成功的問題,可以手動安裝 docker 和 docker-compose

再次執行腳本安裝 docker

curl -fsSL https://unms.com/v1/install > /tmp/unms_inst.sh && sudo bash /tmp/unms_inst.sh

安裝 docker-compose

wget https://github.com/docker/compose/releases/download/1.25.0/docker-compose-$(uname -s)-$(uname -m) -O /usr/local/bin/docker-compose

chmod 755 /usr/local/bin/docker-compose

docker-compose --version

5.安裝過程中如果遇到拉取鏡像失敗等問題,可以再次執行腳本,重新獲取鏡像。

mceclip0.png

6.出現圖示信息即為安裝完成

mceclip1.png

其他 Linux 系統問題,需要用戶遇到後自行查閱文獻解決,也可通過支持郵箱 support.cn@ubnt.com 來進行詢問。

瞭解 UISP 最新資訊請訪問我們全球論壇 UISP releases