====== MACsec Lizenz in AOS 8.6.R1 ======

Ab AOS Release 8.6R1 ist es notwendig eine "MACsec Site License" einzuspielen, damit die MACsec Funktion verwendet werden kann. Dabei handelt es sich um eine Lizenz die für alle Switches identisch ist, also nicht pro Gerät generiert wird.

===== MACsec Lizenz generieren/einspielen =====

  * Die MACsec Lizenz wird über [[https://lds.al-enterprise.com|ALE Product License Generation Center]] **Omni 6560/MACSEC** generiert. Dafür ist die "Customer Number" und "Order Number" notwendig, optional noch eine eMail-Adresse an die die Lizenz per Mail geschickt wird
  * ALE Business Partner und Distributoren haben die notwendigen Daten um die Lizenz zu generieren

===== Einspielen der Lizenz =====

Die Lizenz wird per FTP/SCP/SFTP auf den OmniSwitch hochgeladen (z.B. nach /flash/MACSEC.txt)
Angenommen die "Order Number" ist 1234567, muss diese mit vorstellter "0" angegeben werden.

<WRAP center round important 60%>
In AOS 8.6.289.R01 GA ist es notwendig eine 0 vor die Order Number voranzustellen!
</WRAP>

<code>
-> license apply file /flash/MACSEC.txt order-id "01234567"

Tue Aug 13 11:43:37 : vc_licManager licMgr INFO message:
+++  <<Virtual-Chassis license installation>>
+++ Open license file:/flash/MACSEC.txt
+++  program local chassis license, vc_id 1

-> 
-> 
-> show license-info 
                                             Time (Days)       Upgrade      Expiration  
VC   device   License            Type        Remaining         Status       Date        
----+------+---------------+---------------+---------------+--------------+----------------
1       0    Advanced           PERM           NA             NA             NA              
1       0    MACSEC             PERM           NA             NA             NA              
</code>

====== Typische Fehlermeldungen ======
Sollte der Hinweis oben mit der führenden "0" in der "Order Number" (order-id) nicht beachtet werden, kann es zu folgenden Fehlermeldungen kommen.

===== Fehlende Anführungszeichen (Invalid entry) =====
Die Order-ID muss in Anführungszeichen angegeben werden.
<code>
-> license apply file /flash/MACSEC.txt ORDER-ID 01234567
                                                ^
ERROR: Invalid entry: "01234567"
</code>

===== Fehlende Order-ID (No license to install) =====

Es fehlt die Order-ID, diese muss angegeben werden.

<code>
-> license apply file /flash/MACSEC.txt                    

Tue Aug 13 11:13:11 : vc_licManager licMgr INFO message:
+++  <<Virtual-Chassis license installation>>
+++ Open license file:/flash/MACSEC.txt
+++  No license to install.
+++  getInfoFromInstallMap(833): No licenses in install map.
</code>

===== Inkorrekt aufgefüllte Order-ID (Invalid parameter) =====
Die Order-ID darf/muss nur auf acht Zeichen aufgefüllt werden, nicht auf zehn.
<code>
-> license apply file /flash/MACSEC.txt order-id "0001234567"
ERROR: Invalid parameter
</code>

===== Nicht korrekt aufgefüllte Order-ID (Invalid parameter) =====
Es fehlt die führende "0".
<code>
-> license apply file /flash/MACSEC.txt order-id "1234567"
ERROR: Invalid parameter

</code>

===== Inkorrekt angegebene Order-ID (Invalid format) =====
Die Order-ID muss als Zahl im String mit führenender Null angegeben werden.
<code>
-> license apply file /flash/MACSEC.txt order-id "0x12D687"
ERROR: Invalid format X##X###X, where X is A-Z, a-z, or 0-9; and # is 0-9..
</code>