Lucent Sky AVM CLI 管理者指南

2024/8/5 |

這個文章說明如何安裝、設定、管理、移除 Lucent Sky AVM CLI。

這個文章是關於建構於 .NET Framework 的 CLI。要參考關於建構於 .NET 的跨平台 CLI 的相對文章，請參考 Lucent Sky 知識庫：
Lucent Sky AVM CLI 管理者指南

在這個文章中，你將會學習如何：

  • 安裝 Lucent Sky AVM CLI
  • 設定 Lucent Sky AVM CLI
  • 更新 Lucent Sky AVM CLI
  • 移除 Lucent Sky AVM CLI

本文結束時，你將能夠安裝、設定及移除 CLI。

系統需求

處理器、記憶體和硬碟空間的需求：

  • 處理器: 1.6 GHz 處理器
  • 記憶體: 1 GB
  • 硬碟空間: 200 MB

Lucent Sky AVM CLI 可被安裝在以下的作業系統中：

  • Windows Server 2008 R2 with SP1 和更新
  • Windows 7 with SP1 和更新

在 Windows 上，Lucent Sky AVM CLI 需要 .NET Framework 4.8。

Lucent Sky AVM CLI 亦可被安裝在以下的作業系統中：

  • Debian 10 和更新[^](## "The Mono Project 僅在 Debian 10 上測試 Mono 套件，但它們應可在更新版本的 Debian 上運作。") (x64)
  • macOS 10.9 和更新（Apple silicon 和 Intel）
  • Ubuntu 16.04 和更新«sup>[^](## "The Mono Project 僅在 Ubuntu 16.04、18.04、20.04 上測試 Mono 套件，但它們應可在更新版本的 Debian 上運作。")</sup> (x64)

在 Debian、macOS、Ubuntu 上，Lucent Sky AVM CLI 需要 Mono 6.8 或更新。Lucent Sky AVM CLI 也可能可以透過 Mono 在其他的架構（例如 x86）、其他的作業系統（例如 CentOS/REHL、Fedora、OpenSUSE）、支援的作業系統的其他版本上執行，但是這樣的使用情境是不被支援的。

安裝 Lucent Sky AVM CLI

Lucent Sky AVM CLI 提供使用者和系統層級的安裝。使用者層級的安裝不需要管理者權限，CLI 會被安裝至使用者的本地 AppData 目錄。系統層級的安裝需要管理者權限，CLI 會被安裝至 Program Files 中，系統上的所有使用者皆可使用。

使用者層級的安裝

  1. 建立 %USERPROFILE%\AppData\Local\Programs\CLEAR CLI 目錄，如果此目錄不存在的話。
  2. 將 Lucent Sky AVM CLI 安裝檔案的內容解壓縮到 %USERPROFILE%\AppData\Local\Programs\CLEAR CLI 目錄下。

系統層級的安裝

  1. 建立 C:\Program Files\Lucent Sky\CLEAR CLI 目錄，如果此目錄不存在的話。
  2. 將 Lucent Sky AVM CLI 安裝檔案的內容解壓縮到 C:\Program Files\Lucent Sky\CLEAR CLI 目錄下。

設定 Lucent Sky AVM CLI

CLI 需要被設定以使用一個遠端的 CLEAR Engine 實體。這可以透過 config 介面或是編輯設定檔案。

可編寫腳本的設定

  1. 開啟 PowerShell 並輸入以下命令：

     # Replace <InstanceFqdn> with the FQDN or IP address of the CLEAR Engine instance
 $InstanceFqdn = "<InstanceFqdn>"
 .\SkyAnalyzer.Interface.Console.exe --Interface config --Method set --Value "endpoint = ${InstanceFqdn}:5759"

設定檔案

  1. 瀏覽至 Lucent Sky AVM CLI 的安裝目錄。
  2. 使用文字編輯器開啟 SkyAnalyzer.Interface.Console.exe.config。
  3. 在 <client> 區塊中，找出一組皆具有 binding="netNamedPipeBinding" 屬性的 <endpoint> 標籤。將這組標籤改為註解來停用這些端點。
  4. 在 <client> 區塊中，找出一組皆具有 binding="netTcpBinding" 屬性的 <endpoint> 標籤。將前後的註解標籤移除來啟用這組端點。再來，將所有的 clear.contoso.com 以 CLEAR Engine 的 FQDN 或 IP 位置。

在預設的 TCP 端點組態中，CLEAR Engine 和 CLI 之間的通訊是不安全的。要深入了解關於如何為 CLEAR Engine 和 CLI 開啟 Transport Layer Security，請參考 Lucent Sky 知識庫：
Configure Transport Layer Security

更新 Lucent Sky AVM CLI

  1. 要更新 Lucent Sky AVM CLI，首先將目前的版本從系統中移除，再安裝新的版本。

移除 Lucent Sky AVM CLI

  1. 刪除 Lucent Sky AVM CLI 安裝的目錄。