使用NSO配置智慧許可證

簡介

本檔案介紹各種Network Services Orchestrator(NSO)許可證，以及如何使用Cisco Smart License®啟用它們。

必要條件 

需求

思科建議您瞭解以下主題：

• 如何使用NSO CLI
• NSO故障排除
• Linux基礎知識  

採用元件

本文中的資訊係根據以下軟體和硬體版本：

• NSO 6.x
• NSO 5.x

• NSO 4.5及更高版本
• NSO 4.4
• NSO 4.1/4.2/4.3

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

NSO許可證

附註：使用者必須擁有有效的NSO許可證。

 NSO使用的許可證如下：

附註：這可以包含在包資料包識別符號(PID)（包含ESC的捆綁包，等等）中，因此這些PID可能不會按順序顯示。

智慧帳戶和虛擬帳戶

每個產品（包括NSO）都要求思科伺服器獲取許可證以啟用自身。實質上，它會檢查您購買的用於該產品的許可證數量是否足夠，以及它們是否可用。

一個智慧帳戶分配給一個組織。以公司A為例：

• 公司A可以有X、Y和Z部門，並且他們希望單獨管理其許可證。
• 虛擬帳戶可以分配給每個部門。

可為每個虛擬帳戶生成令牌。我們使用該令牌從產品訪問虛擬帳戶。

在智慧軟體管理器中，虛擬帳戶中的許可證狀態如下所示：

設定

有關NSO如何連線到智慧許可伺服器的方法多種多樣，這取決於NSO的安裝環境。本文檔還概述了NSO和思科許可伺服器之間的不同整合。

步驟1。產生權杖

1.要建立新令牌，請使用使用者ID/或CCO ID登入Cisco Smart Software Manager(CSSM)並選擇適當的虛擬帳戶。按一下Manage licenses以繼續。在思科軟體中心中尋找連結。

2.按一下清單頁籤，然後選擇要使用的虛擬帳戶。

 3.在CSSM中，按一下New Token。

填寫所需資訊。請注意，到期日期指示令牌的有效時間，因此使用者需要在天內使用建立的令牌。「短」和「長」需要在便利性和安全風險之間取得平衡。此外，這並不是說許可證的有效期有多長。

5.新建立的令牌在表中。

6.按一下標籤連結以顯示彈出視窗。將權杖從對話視窗複製到剪貼簿中。

步驟2.令牌註冊準備

以下是註冊方法（直接/代理/衛星）。  

如果NSO或任何思科產品需要智慧許可證，請諮詢思科智慧軟體管理器（或思科雲）以註冊自己。

設定智慧許可證支援的環境有四個主要選項：

選項1.直接雲訪問

使用此方法，NSO伺服器需要能夠使用https直接與思科雲通訊。支援使用HTTP，但是出於安全原因，不建議使用。

在這種方法中，無需特殊配置即可啟動註冊過程。

選項2：通過HTTPS代理直接訪問雲

如果需要使用HTTP(S)代理伺服器連線到Internet上的Web，則必須使用Proxy伺服器資訊配置NSO中的智慧代理。

使用選項2時，需要指示智慧代理將其註冊請求傳送到代理伺服器，而不是直接傳送到思科。

組態視版本而定。 

NSO 4.5或更高版本

從NSO 4.5開始，現在可以通過ncs.conf配置智慧許可證配置。如果ncs.conf和NSO CDB中都存在智慧許可證配置，則ncs.conf中的配置優先。

這表示如果ncs.conf中存在不同的配置，則smart-license smart-agent override-url url https://10.1.2.3/ 等命令不會生效。執行NSO系統安裝時，ncs.conf預設包括以下內容：

<smart-license>
  <smart-agent>
    <java-executable>DEFAULT</java-executable>
    <java-options>DEFAULT</java-options>
    <production-url>DEFAULT</production-url>
    <alpha-url>DEFAULT</alpha-url>
    <override-url>
      <url>DEFAULT</url>
    </override-url>
    <proxy>
      <url>DEFAULT</url>
    </proxy>
  </smart-agent>
</smart-license>

DEFAULT表示它使用$install_dir/src/ncs/yang/tailf-ncs-smart-license.yang中定義的預設值。

要改為在NSO CDB中配置ncs.conf中列出的枝葉，請確保從ncs.conf中刪除相應的條目並執行/etc/init.d/ncs reload。

NSO 4.4

在此路徑上配置代理URL。

smart-license smart-agent proxy url <proxy url>

admin@ncs(config)# smart-license smart-agent proxy url https://10.10.10.10:8080
admin@ncs(config)#

在預設配置中，NSO連線到 https://tools.cisco.com/its/service/oddce/services/DDCEService，因此需要使用HTTPS代理。

此代理配置自動設定HTTPS和HTTP，因此，如果您將目標URL更改為HTTP以使用衛星（如選項3或4所述），則一個配置仍可以處理兩種情況。

選項3：通過本地收集器連線的媒介訪問

在許多情況下，NSO網路未直接連線到Internet。除選項2.外，可以引入智慧軟體管理器衛星；因此NSO無需直接將消息交換到思科雲。

在此處可以找到智慧軟體管理器衛星的產品詳細資訊。

要瞭解如何安裝，請在連結中找到安裝指南。

當您使用此方法時，NSOl會與衛星而不是思科雲進行通訊。 

要更改目標，可以修改override-url:

admin@ncs(config)# smart-license smart-agent override-url url https://10.1.2.3/
admin@ncs(config)#

此URL可在智慧軟體管理器衛星的管理網站上找到。

選項 4:通過本地收集器進行中介訪問 — 斷開連線

從NSO的角度來看，該方法與方法(3)完全相同。區別僅在於如何從Smart Software Manager Satellite與思科雲同步。

步驟3.令牌註冊

使用令牌後，使用生成的令牌啟用Cisco伺服器的NSO。令牌在NSO CLI上用於註冊到CSSM。輸入命令後，將非同步啟動註冊過程。

admin@ncs# smart-license register idtoken YWVlMmQ3ZjEtYT....
result Registration process in progress. Use the 'show license status' command to check the progress and result.
admin@ncs#

驗證

使用本節內容，確認您的組態是否正常運作。

註冊前

始終啟用智慧許可。輸出表示NSO未註冊，並且處於EVAL模式，該模式將在89天23小時內到期。

admin@ncs# show license status

Smart Licensing is ENABLED

Registration:
  Status: UNREGISTERED
  Export-Controlled Functionality: Allowed

License Authorization:
  Status: EVAL MODE
  Evaluation Period Remaining: 89 days, 23 hr, 17 min, 36 sec
  Last Communication Attempt: NONE
  Next Communication Attempt: NONE
Development mode: enabled
admin@ncs#

可以使用show license status命令檢查註冊狀態。如果註冊仍在進行中，該命令將顯示此輸出並顯示："註冊待定"。

<仍在註冊……>

admin@ncs# show license status

Smart Licensing is ENABLED

Registration:
  Status: UNREGISTERED - REGISTRATION PENDING
  Initial Registration: First Attempt Pending
  Export-Controlled Functionality: Allowed

License Authorization:
  Status: EVAL MODE
  Evaluation Period Remaining: 89 days, 23 hr, 16 min, 36 sec
  Last Communication Attempt: SUCCEEDED on Aug 3 09:41:56 2016 UTC
  Next Communication Attempt: NONE
Development mode: enabled
admin@ncs#

過了一會兒，註冊工作就完成了。當您看到狀態REGISTERED時，系統註冊到CSSM。

<已註冊!!>

admin@ncs# show license status

Smart Licensing is ENABLED

Registration:
  Status: REGISTERED
  Smart Account: BU Production Test
  Virtual Account: TAC-Japan-Cloudorch
  Export-Controlled Functionality: Allowed
  Initial Registration: SUCCEEDED on Aug 4 05:29:52 2016 UTC
  Last Renewal Attempt: SUCCEEDED on Aug 4 05:30:03 2016 UTC
  Next Renewal Attempt: Jan 31 05:30:03 2017 UTC
  Registration Expires: Aug 4 05:24:56 2017 UTC
  Export-Controlled Functionality: Allowed

License Authorization:

License Authorization:
  Status: AUTHORIZED on Aug 4 05:30:05 2016 UTC
  Last Communication Attempt: SUCCEEDED on Aug 4 05:25:02 2016 UTC
  Next Communication Attempt: Sep 3 05:30:07 2016 UTC
  Communication Deadline: Aug 4 05:24:56 2017 UTC
Development mode: enabled
admin@ncs#

使用（授權狀態）

使用show license summary命令可檢視使用的許可證。在本示例中，系統使用NSO-platform-production、NSO-network-element和cisco-ios-NED。請注意，許可證授權狀態為「AUTHORIZED」。 這意味著需要許可證的所有元件都在合法狀態下正常工作。

admin@ncs# show license summary
Smart Licensing is ENABLED

Registration:
  Status: REGISTERED
  Smart Account: COMPANY A
  Virtual Account: Network Department
  Last Renewal Attempt: None
  Next Renewal Attempt: Jan 31 05:33:02 2017 UTC

License Authorization:
  Status: AUTHORIZED
  Last Communication Attempt: SUCCEEDED
  Next Communication Attempt: Sep 3 05:33:06 2016 UTC

License Usage:
  License                     Entitlement Tag                                                                                Count        Status
  ----------------------------------------------------------------------------------------------------------------------------------------------
  348fbb21-7edf-42bb-baa7-198903058a54regid.2016-04.com.cisco.NSO-platform-production,4.2_348fbb21-7edf-42bb-baa7-198903058a54       1            InCompliance
  5d641fa0-757d-43b0-a926-166cb6e3cfddregid.2015-10.com.cisco.NSO-network-element,1.0_5d641fa0-757d-43b0-a926-166cb6e3cfdd           3            InCompliance
  d9eca34d-1f6a-4595-ad74-9c0c57e03c27regid.2015-10.com.cisco.cisco-ios-NED,1.0_d9eca34d-1f6a-4595-ad74-9c0c57e03c27                 1            InCompliance

Development mode: disabled
admin@ncs#

以下是show license usage命令在另一示例中的輸出。在此示例中，還新增了cisco-iosxr-NED，狀態為OutOfCompliance。這表示註冊到CSSM沒問題，但虛擬帳戶中的cisco-iosxr-NED許可證不足。由於cisco-iosxr-NED的合規性狀態，因此整體狀態為OUT_OF_COMPLIANCE。

admin@ncs # show license usage  

License Authorization Status : OUT_OF_COMPLIANCE  as of Oc  24 06:14:11 2016 UTC 

NSO-platform-production (regid.2016-04.com.cisco.NSO-platform-production, 1.0_d1445dab-9d96-4593-99f2-6f633b8a759c) 
 Description : API unavailable 
 Count : 1 
 Version : 1.0 
 Status : InCompliance 

NSO-network-element (regid.2015-10.com.cisco.NSO-network-element, 1.0_5d641fa0-757d-43b0-a926-166cb6e3cfdd) 
 Description : API unavailable 
 Count : 3 
 Version : 1.0 
 Status : InCompliance 

cisco-ios-NED (regid.2015-10.com.cisco.cisco-ios-NED, 1.0_d9eca34d-1f6a-4595-ad74-9c0c57e03c27) 
 Description : API unavailable 
 Count : 1 
 Version : 1.0 
 Status : InCompliance 

cisco-iosxr-NED (regid.2015-10.com.cisco.cisco.cisco-iosxr-NED, 1.0_9956fc34-cbed-4d13-a1ea-6a36f4e40a99) 
 Description : API unavailable 
 Count : 1 
 Version : 1.0 
 Status : OutOfCompliance 

疑難排解

嘗試在智慧許可證功能上啟用調試。啟用調試後，調試日誌將生成到/smart-license/smart-agent/stdout-capture/file中指定的檔案中。智慧許可證調試會生成大量日誌，建議在收集資料後禁用調試。

Debug enable

admin@ncs# debug smart_lic all
ok
admin@ncs#

調試禁用

admin@ncs# no debug smart_lic all
ok
admin@ncs#

智慧許可證日誌配置

admin@ncs# show running-config smart-license
smart-license smart-agent stdout-capture disabled
smart-license smart-agent stdout-capture file ./logs/ncs-smart-licensing.log
admin@ncs#

啟用智慧許可證日誌

admin@ncs(config)# smart-license smart-agent stdout-capture enabled
admin@ncs(config)# commit
Commit complete.
admin@ncs(config)#

續訂CSSM本地SSL證書

對於具有內部CSSM的客戶，如果SSL證書已過期，NSO可能無法連線到伺服器。

以下步驟用於通過生成onprem.crt檔案來解決問題：

1.使用openssl從CSSM伺服器收集新憑證（正常使用的連線埠為443）：

openssl s_client -showcerts -connect <>:443 | openssl x509 -out onprem.crt

2.查詢用於匯入證書的目錄。預設目錄為/etc/pki/ca-trust/extracted/java/cacerts。為了找到該目錄，以下是在系統中搜尋cacerts目錄的命令，以及輸出示例：

[root@localhost /]# find / -name cacerts 2>/dev/null | xargs -I {} ls -l {}
-r--r--r--. 1 root root 156478 Jun 26 08:02 /etc/pki/ca-trust/extracted/java/cacerts
lrwxrwxrwx. 1 root root 40 Aug 25  2022 /etc/pki/java/cacerts -> /etc/pki/ca-trust/extracted/java/cacerts
lrwxrwxrwx. 1 root root 21 Jun 15 04:52 /etc/java/java-17-openjdk/java-17-openjdk-17.0.15.0.6-3.el9.x86_64/lib/security/cacerts -> /etc/pki/java/cacerts
[root@localhost /]# 

3.載入證書。金鑰庫的預設密碼是changeit:

sudo keytool -import -alias ssm_onprem -file onprem.crt -keystore /etc/pki/ca-trust/extracted/java/cacerts

3.1（可選）若要確認憑證已正確載入，請執行以下命令：

root@Ubuntu-24-9:/home/nso# keytool -list -keystore /etc/ssl/certs/java/cacerts -storepass changeit -alias ssm_onprem
Warning: use -cacerts option to access cacerts keystore
ssm_onprem, Aug 4, 2025, trustedCertEntry, 
Certificate fingerprint (SHA-256): F7:00:C9:74:34:57:5E:BE:70:A7:0E:D2:9B:A8:2D:44:F1:CE:14:55:C3:D9:06:3F:83:68:95:A1:C6:B5:7F:26
root@Ubuntu-24-9:/home/nso# 

4.重新啟動智慧代理（在配置模式下）：

admin@ncs(config)# smart-license smart-agent restart 
result Started

5.重新註冊證書：

admin@ncs# license smart deregister 
ok
admin@ncs# license smart register idtoken TOKEN
Registration process in progress. Use the 'show license status' command to check the progress and result.
admin@ncs# 

6.使用show license summary命令確認註冊成功，該命令的輸出如本文所示。