私有部署對服務(wù)器的配置要求

獲取私有部署

1. 進(jìn)入DataV產(chǎn)品購買頁面，選擇購買DataV尊享版本。
2. 登錄DataV控制臺。
3. 在我的可視化頁面中，選擇一個(gè)可視化應(yīng)用，單擊編輯。
4. 在PC端畫布編輯器中，單擊頁面右上角的本地部署圖標(biāo)。
   
5. 在本地部署對話框中根據(jù)提示下載運(yùn)行環(huán)境包和可視化應(yīng)用包。
   

   注意 運(yùn)行包和賬號綁定，只能部署運(yùn)行已開通尊享版賬號內(nèi)所下載的可視化應(yīng)用。
   1. 單擊下載運(yùn)行環(huán)境，自動跳轉(zhuǎn)至用戶中心 > 私有部署面板，在使用詳情下方單擊新版本更新，請重新生成處，即可下載運(yùn)行環(huán)境壓縮包。
      

      說明 運(yùn)行環(huán)境新版本更新時(shí)，需等待十分鐘左右，待更新完成后，刷新即可啟動運(yùn)行環(huán)境。

      
   2. 單擊下載大屏，自動跳轉(zhuǎn)到可視化應(yīng)用打包頁面。等待打包完成后，單擊打包頁面內(nèi)的下載，即可下載可視化應(yīng)用文件的壓縮包。
6. 部署DataV服務(wù)。
   1. 將下載的運(yùn)行環(huán)境壓縮包上傳到您的服務(wù)器上。
   2. 在服務(wù)器新建一個(gè)目錄。

      例如，執(zhí)行mkdir datav命令新建一個(gè)名稱為datav的目錄。

   3. 解壓運(yùn)行環(huán)境包到datav目錄。

      tar xzvf runtime-4.8.2.tgz ./datav/   // 默認(rèn)解壓當(dāng)前下載的運(yùn)行環(huán)境包，如運(yùn)行包環(huán)境名稱有更新，則需根據(jù)實(shí)際名稱寫入代碼內(nèi)，此處以runtime-4.5.3.tgz為例。

   4. 修改config.js配置項(xiàng)文件。

      'use strict';
      module.exports = {
        created: '2021-07-08T02: 44: 51.205Z',
        listen: {
          port: 7001, //默認(rèn)端口。
          // headersTimeout: 60 * 1000, // 請求頭超時(shí)設(shè)置, 默認(rèn)沒有超時(shí)時(shí)間。
        },
        ratelimit: { // 限流配置,
          enable: false, // 默認(rèn)關(guān)閉, true 為打開
          duration: 60000, // 毫秒
          max: 1000, // 次數(shù)
          // 即 60 秒內(nèi), 同 IP 限流 1000 個(gè)請求, 如果打開了這個(gè)配置項(xiàng), 建議 max 設(shè)大一點(diǎn)
        },
        disableDelete: { // 不接收 delete 請求, 默認(rèn)關(guān)閉
          enable: false,
        },
        crypt: {
          timeout: 30 * 1000, // 加密頭時(shí)間差配置, 默認(rèn)30秒
        },
        /*
        blackList: { // 內(nèi)置開啟
          enable: true,
          max: 5, // 最大失敗次數(shù), 默認(rèn) 5 次失敗后進(jìn)入黑名單
          maxAge: 5 * 60 * 1000, // 凍結(jié)時(shí)長 ms, 默認(rèn)五分鐘
        },*/
        // 大屏包中允許上傳的文件類型, 默認(rèn)不限制
        // uploadLimit: ['.png', '.gif', '.jpeg', '.jpg', '.ttf', '.woff', '.eot', '.json', '.swf', '.js', '.xml', '.hdr', '.vb', '.bin', '.datavmesh', '.glb', '.key'],
        /*
        host: [],   // 使用第三方域名時(shí)需要。
        */
        // 默認(rèn)賬戶: admin | 密碼: hello_****, // 默認(rèn)登錄密碼，如需新增，在此添加
      };

   5. 啟動和檢查服務(wù)。服務(wù)默認(rèn)為停止?fàn)顟B(tài)。
      進(jìn)入datav目錄，執(zhí)行以下命令：

      注意 如果執(zhí)行權(quán)限不夠，先執(zhí)行chmod 777 ./*修改權(quán)限。

      • 啟動服務(wù)

        ./bin/datav start

      • 停止服務(wù)

        ./bin/datav stop

      • 重啟服務(wù)

        ./bin/datav restart

      • 啟動服務(wù)檢查

        curl http://127.0.0.1:7001/app/check  //DataV默認(rèn)啟用本機(jī)IP地址加端口，如有需要可以通過修改配置文件中的IP地址及服務(wù)端口。

   6. 服務(wù)啟動后，在瀏覽器中訪問DataV服務(wù)所在服務(wù)器的IP地址加服務(wù)端口號（例如http://10.10.10.10:7001/）。
      注意 首次訪問服務(wù)時(shí)，由于還未注冊當(dāng)前已部署的服務(wù)器，導(dǎo)致瀏覽頁面無法正常顯示，頁面內(nèi)將顯示您的服務(wù)器機(jī)器碼，保存該機(jī)器碼，以備注冊當(dāng)前部署的服務(wù)器使用，如下圖所示。

      

7. 注冊服務(wù)器。
   1. 在DataV控制臺中，單擊個(gè)人賬號下拉列表中的用戶中心。
      
   2. 在用戶中心頁面，單擊私有部署模塊右下角的詳情。
      
   3. 在私有部署的使用詳情頁面，輸入服務(wù)器機(jī)器碼和服務(wù)器名稱，單擊注冊，注冊服務(wù)器。

      服務(wù)機(jī)器碼獲取請參見機(jī)器碼。

      

      注冊后，系統(tǒng)會生成一個(gè)測試Key。

      注意 正式啟用服務(wù)器機(jī)器碼之前，您可以提交工單進(jìn)行修改。
   4. 下載測試Key，驗(yàn)證服務(wù)器部署情況。
      

      注意 測試Key只有3天有效期，過期需重新下載或啟用為正式Key，并替換原先舊的部署。
   5. 驗(yàn)證無誤后，單擊測試Key右側(cè)操作欄中的啟用，根據(jù)系統(tǒng)彈出的對話框提示單擊確定啟用正式Key。
      

      測試Key啟用為正式Key之后，會自動扣除可用服務(wù)器的額度。

      說明 在DataV尊享版到期后，之前您配置的私有部署服務(wù)器內(nèi)容均可繼續(xù)使用。
8. 服務(wù)器注冊完成后，將獲取的測試Key或正式Key文件（runtime.key）下載后放在運(yùn)行環(huán)境包的一級目錄下。
   注意 如果您使用的是測試Key，測試無誤后，可啟用正式Key并下載runtime.key文件，替換測試Key的runtime.key文件，替換后重啟服務(wù)即可使用。

使用私有部署

私有部署的使用流程如下圖所示。

1. 服務(wù)重啟后，在瀏覽器中訪問DataV服務(wù)所在服務(wù)器的IP地址加服務(wù)端?號（例如http://10.10.10.10:7001/），并輸入用戶名、密碼和識別碼進(jìn)行登錄。
   

   用戶名和密碼為您在config.js文件中配置的用戶名和密碼，識別碼為登入界面內(nèi)右下角的驗(yàn)證圖片。

2. 添加可視化應(yīng)用。
   1. 在我的可視化頁面，單擊新建可視化。
   2. 在新建項(xiàng)目頁面，單擊上傳大屏包。
   3. 在上傳大屏包頁面，單擊Upload上傳可視化應(yīng)用包。
      

      注意 可視化應(yīng)用包名稱中不能包含中文字符。

      可視化應(yīng)用包上傳成功后，可刷新我的可視化頁面進(jìn)行查看。

      上傳之后的可視化應(yīng)用位于DataV所在目錄下的assets/screens/目錄內(nèi)，可視化應(yīng)用文件結(jié)構(gòu)如下：

      • 離線打包文件

        文件	說明
        config.json	可視化應(yīng)用基礎(chǔ)信息。
        data.json	數(shù)據(jù)配置內(nèi)容。
        filters.json	過濾器內(nèi)容。
        modules.js	組件資源文件。
        packages.json	組件信息。
        screen.json	可視化應(yīng)用配置項(xiàng)，已加密。
        screen.key	可視化應(yīng)用許可文件。

      • 本地修改后文件

        當(dāng)該離線可視化應(yīng)用對應(yīng)的線上內(nèi)容有變更時(shí)，可以保留下列文件，重新打包線上可視化應(yīng)用，覆蓋離線打包文件即可（可視化應(yīng)用發(fā)布后才會生成以下文件）。

        文件	說明
        config-new.json	修改后的可視化應(yīng)用基礎(chǔ)信息。
        data-new.json	修改后的數(shù)據(jù)配置內(nèi)容。
        filters-new.json	修改后的過濾器內(nèi)容。
        screen-new.json	修改后的可視化應(yīng)用配置項(xiàng)，已加密。
        interaction-new.json	修改后的藍(lán)圖編輯器配置文件。

3. 連接數(shù)據(jù)源。

   私有部署采用DatavProxy數(shù)據(jù)源方式（?持MySQL、SQLServer、Oracle和PostgreSQL），詳情請參見如何使用DataV Proxy和添加DataV數(shù)據(jù)代理服務(wù)。

4. 配置數(shù)據(jù)源。

   進(jìn)入畫布編輯頁，單擊組件，在數(shù)據(jù)配置面板，為組件配置內(nèi)網(wǎng)數(shù)據(jù)源。

   數(shù)據(jù)相關(guān)的配置會寫入名稱中包含-new的幾個(gè)文件中。如果需要調(diào)整樣式，只需要線上重新下載打包可視化應(yīng)用，直接覆蓋本地文件即可。

5. 啟動和查看日志。

   啟動日志：{DataV服務(wù)所在目錄}/logs。

   查看日志：{DataV服務(wù)所在目錄}/datav_stdout.log。