使用指令行介面在軟體驅動裝置上執行作業

您可以執行指令,來重新啟動軟體驅動裝置硬體,將軟體驅動裝置重設為其原廠設定或關閉軟體驅動裝置。

關於這項作業

您可以使用指令行介面,來重設軟體驅動裝置配置資料、重新啟動軟體驅動裝置,或關閉軟體驅動裝置。

程序

  1. 利用 xcadmin 使用者來建立與軟體驅動裝置的連線。 您可以使用序列連線,也可以利用 Secure Shell (SSH) 透過指令行介面進行連線。
    • 序列連線:必須在 ASCII 終端機或執行終端機模擬軟體的個人電腦,與軟體驅動裝置上的序列埠之間建立序列連線。如果是將個人電腦用於序列主控台,則必須使用適用於 Windows 或 Linux 的個人電腦型序列通訊程式。使用所提供的序列纜線或 PL-2303 USB 轉序列纜線,來連接軟體驅動裝置。
      重要: 如果是使用 PL-2303 USB 轉序列纜線,請先下載並安裝適用於該纜線的驅動程式,再繼續執行。
    • 遠端登入:若要使用 SSH 連接軟體驅動裝置,請向 SSH 用戶端提供軟體驅動裝置的 URL。
  2. 建立與軟體驅動裝置的連線之後,您可以發出下列其中一個指令。
    clear-all
    重設軟體驅動裝置的配置資料,包括移除所有資料網格和新使用者。所有在軟體驅動裝置上執行的內部程序都會重新啟動。此指令無需重新啟動軟體驅動裝置硬體就能執行。
    clear-logs
    刪除全部的 WebSphere® DataPower® XC10 Appliance 日誌檔。
    clear-tls-config
    重設傳輸層安全 (TLS) 配置。如果因為不想遺失所有配置資料而不使用 clear-all 選項,但 TLS 配置已毀損,或您要還原預設 TLS 值,請執行此指令。在大部分情況下,請利用使用者介面進行 TLS 變更,或使用 clear-all 指令回復至軟體驅動裝置的原始配置。

    在群體中的每一個軟體驅動裝置上執行 clear-tls-config 指令。在每一個軟體驅動裝置上執行該指令之後,請重新啟動群體內每一個軟體驅動裝置中的程序。

    如果群體順利地進行通訊,請使用 device restart 指令。當群體中的所有軟體驅動裝置都可以透過使用者介面進行存取,並在群體畫面中顯示為已啟動時,即表示該群體正在正確地通訊。 然而,如果 TLS 配置阻止群體進行通訊,且 device restart 指令不能重新啟動軟體驅動裝置,則可以使用 force-recycle 指令,強制停止並啟動軟體驅動裝置中的所有程序,而不儲存任何資料。

    device RESET
    將軟體驅動裝置的網路、授權和預設使用者 ID 重設回原廠設定。這將刪除資料網格中的所有資料。執行此指令之後,必須重新起始設定軟體驅動裝置。
    device restart
    重新啟動軟體驅動裝置硬體。資料網格、配置及使用者資料,會在裝置關機之前進行儲存,並在軟體驅動裝置重新啟動之後可用。
    device shutdown
    關閉軟體驅動裝置硬體。資料網格、配置及使用者資料,會在裝置關閉之前進行儲存。
    file get <file_location> <file_name_on_appliance>
    擷取檔案,並將檔案儲存到軟體驅動裝置。
    firmware upgrade <firmware_file>
    安裝指定的韌體升級檔案。
    force-recycle
    重新啟動 WebSphere DataPower XC10 Appliance 程序,而不儲存任何資料。因為可能會遺失資料,所以只有在您不擔心資料遺失,或已嘗試 device restart 指令但軟體驅動裝置仍無法使用時,才執行此指令。
    get-dns-servers
    顯示已配置之網域名稱伺服器的 IP 位址。
    list ethernet-interface
    列出軟體驅動裝置上的可用乙太網路介面。
    net-test available
    測試網路介面是否存在作用中的載波。
    net-test dns <host_name>
    對指定的主機名稱,執行網域名稱伺服器查閱。
    net-test ping <host_name>
    測試與指定之主機名稱或 IP 位址的連線功能。
    net-test tcp<host_name> <port>
    測試在指定的主機名稱或 IP 位址處,開啟與埠之 TCP 連線的能力。
    netif show <interface>
    顯示乙太網路介面配置資訊。
    netif status <interface>
    顯示乙太網路介面狀態。
    show version
    顯示已安裝的軟體驅動裝置韌體現行版本。
    set-dns-servers <有效的 DNS 伺服器>
    設定軟體驅動裝置的「網域名稱系統 (DNS)」伺服器。
    start-progress
    當啟動作業處於進行中時,可以發出此指令。此指令會顯示啟動程序的已完成百分比。
    status cpu-usage
    顯示過去 1 分鐘、5 分鐘及 15 分鐘的處理器載入百分比。

下一步

如果重設軟體驅動裝置,則您可以重新起始設定軟體驅動裝置。 如需配置軟體驅動裝置的相關資訊,請參閱起始設定及配置 IBM WebSphere DataPower XC10 Appliance