Microwave Transport ASLM User Guide

Author James Ries & Mathieu Laville

Owner James Ries
Organization X-Haul Product Management
Approver Eleonore Soulier
Document ID 3DB19433AAAA
Document location OLCS

Change History
Version Status Date Author Owner Reviewed by Reviewed Approver Approval Description of changes
date date
1.0 Approved 01-10-2016 J. Ries/ M. Laville J. Ries E. Soulier 05-10-02016 E. Soulier 28-10-2016 Initial Document

2.0 Approved 07-02-2017 J. Ries/ M. Laville J. Ries E. Soulier 13-02-2017 E. Soulier 13-02-2017 Initial Document

3.0 Approved 19-01-2019 J. Ries/ M. Laville J. Ries E. Soulier 15-01-2019 E. Soulier 19-01-2019 Merged ETSI/ANSI, Updated Product, Added
WSAT

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

1 / 33
Table of Contents
1 Getting Started with ASLM ........................................................................................................... 3
1.1 How to Request Access to ASLM – Nokia Customers ................................................................... 3
1.2 How to Request Access to ASLM – Nokia Employees ................................................................... 3
1.3 Types of Upgrade Scenarios ............................................................................................................. 3
2 Creating a Wavence License Key.................................................................................................. 5
2.1 Customer’s Selection ......................................................................................................................... 5
2.2 First Upgrade Using Imported License Key ................................................................................... 6
2.3 Established License Key Upgrade .................................................................................................. 11
2.4 First Upgrade Using Basic Key ...................................................................................................... 14
3 Creating Wavence Spectrum Analyser License Keys................................................................. 19
3.1 WSAT License Key Requirements ................................................................................................. 19
3.2 How to Generate License Key for WSAT...................................................................................... 19
4 Extracting the License key from Wavence ................................................................................. 22
4.1 With JUSM ....................................................................................................................................... 22
4.2 With WebCT .................................................................................................................................... 24
5 Applying License Keys in Wavence ............................................................................................ 27
5.1 With JUSM ....................................................................................................................................... 27
5.2 With WebCT .................................................................................................................................... 28
6 Useful hints on using ASLM ...................................................................................................... 30
6.1 How to search for a serial number in ASLM ................................................................................ 30
6.2 How to check remaining license upgrades..................................................................................... 31
6.3 How to rename a system.................................................................................................................. 32

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

2 / 33
1 Getting Started with ASLM
Access Software License Management (ASLM) is the license key management tool used not only on
the Wavence but also many other products. ASLM offers features such as the following:

• Create a license key with multiple different entitlements at the same time.
o Example: Add 5Cap500, PTB, RING in one action
• Possibility to create a PDF of the license certificate
• For ANSI, new capability to generate a default key with just the RMU serial number.

1.1 How to Request Access to ASLM – Nokia Customers

Nokia Customers submit their ASLM log-in requests via an online form contained on the OLCS Web
Portal.

When coming to the Software License Keys landing page in OLCS and clicking on “Access Software
License Management (ASLM) tool” link for the first time, the user will fail to authenticate. There is
a link in the error message through which the user will be able to input the required information and
then be able to submit a request for a log in.

The user, once authenticated, will be notified. Upon the next attempted entry through “Access
Software License Management (ASLM) tool” link, the user will pass directly into ASLM.

1.2 How to Request Access to ASLM – Nokia Employees

Nokia employees submit their ASLM log-in requests by sending an e-mail directly to the SWLD
organization. Below is an example email template for Nokia employees requesting access to ASLM.
The “send-to” addresses are included at the top of the templates.
Please send your request to: nokia.cicfafreq@nokia.com

Employee request for

login access to ASLM.msg

1.3 Types of Upgrade Scenarios

With the ASLM tool, there are a couple different scenarios for upgrading license keys. The next
sections describe the process to create a license key for each of the different scenarios.

• Scenario 1: First Upgrade using imported key

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

3 / 33
 o This scenario should be followed for systems that have an existing license key and
have NOT upgraded this license key.
o This is the Typical method for upgrading keys for the North American Market for the
first time.
• Scenario 2: Established License key upgrade
o Follow this process if the license key has been updated in ASLM at one time already.
• Scenario 3: First Upgrade using basic key.
o Follow this process for new flash cards.
o This is the Typical method to generate keys for the ETSI market.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

4 / 33
2 Creating a Wavence License Key
2.1 Customer’s Selection

• After logging into the ASLM system you will see the “Dashboard”
• Search for you customer in the Search Field

• If this is not your first time to access ASLM, you will see a list of the last customers accessed.
• You can select one the customers listed in this list to start the license key process

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

5 / 33
 2.2 First Upgrade Using Imported License Key

• Create a New System:

o Under Actions on left hand side, click “Create a New System”

o In the next screen, in the “Name” field, use the RMU serial number of the flash card.
o Enter a serial number and description. It is suggested to use the site name in the
Description field, but any text will be accepted.
o Click on Create Customer System after fields have been entered.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

6 / 33
 • Step 2: Create a New License
o Click on Create a New License

o In the “New License Request” Screen select the Product “Microwave – Wavence
License Upgrade-ANSI” or “Microwave – Wavence License Upgrade-ETSI” and then
click on continue

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

7 / 33
 • Upload Key File
o In the Serial Number field, enter the serial number of the flash card
o Click on “Browse” and upload the key file that corresponds to the serial number of the
flash card to be upgraded.
▪ Note: File name cannot contain any spaces or local characters. If the file name
contains spaces or local characters, please remove them before uploading.

o Once uploaded user will get a pop up message saying upload was successful.
o Click OK to continue.
o Click on “Validate the license Configuration”
o If there are no errors, you will get the Current configuration of the license key.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

8 / 33
 o Select the entitlement to add to this key or upgrade this key.

o Click on “Automatically consume orders”, Click OK on the pop-up window, and then
click continue.

• Finalize the License request

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

9 / 33
 o Click on “Submit the request”

o At this point the user can download a PDF of the license agreement via the Certificate
(PDF) Button
o To get the key, click on Download.
▪ This will download a file called “Installation.zip”
▪ The Key File is located in the Zip file. The file name will be
MPR_LU_License{flash-serial-number}.txt

• At this point the key is created and it can be applied to the Wavence.
o The Serial number and the latest configuration will be stored in the ASLM database.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

10 / 33
 2.3 Established License Key Upgrade

• After logging in and selecting the customer system users can search for existing keys under
the “Licensed Systems” text box. To run exhaustive search, check the INCLUDE
ARCHIVED, INCLUDE CANCELLED AND REJECTED, INCLUDE EMPTY SYSTEMS
boxes.”
• Once the correct license is found click on the licensed system name (should be the serial
number) and click on the license.
o The current license will have a name of “commercial- YYYY-MM-DD”
• Click on Update this License

• Click on Continue in the next screen

• Select the entitlement to add to this key or upgrade this key.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

11 / 33
 o Click on “Automatically consume orders”, Click OK on the pop-up window, and then
click continue.

• Finalize the License request

• Click on “Submit the request”

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

12 / 33
 o At this point the user can download a PDF of the license agreement via the Certificate
(PDF) Button
o To get the key, click on Download.
▪ This will download a file called “Installation.zip”
▪ The Key File is located in the Zip file. The file name will be
MPR_LU_License{flash-serial-number}.txt

• At this point the key is created and it can be applied to the Wavence.
• The Serial number and the latest configuration will be stored in the ASLM database.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

13 / 33
 2.4 First Upgrade Using Basic Key

• Create a New System:

o After login and customer selection
o Under Actions on left hand side, click “Create a New System”

o In the next screen, in the “Name” field, use the RMU serial number of the flash card.
o Enter a serial number and description. It is suggested to use the site name in the
Description field, but any text will be accepted.
o Click on Create Customer System after fields have been entered.

• Create a New License

o Click on Create a New License

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

14 / 33
 o In the “New License Request” Screen select the Product “Microwave – Wavence
License Upgrade-ANSI or “Microwave – Wavence License Upgrade-ETSI ”

• Configure License
o In the Serial Number field, enter the serial number of the flash card
o The default capacity for the basic key is R12/12Cap040/4CapU0050 as shown below.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

15 / 33
Enter the number of entitlements to add to the default license key in the “resulting rights box”

o Click on “Automatically consume orders”, Click OK on the pop-up window, and then
click continue.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

16 / 33
 o If there are no errors, you will see the new updated Target string.

• Step Four: Finalize the License request

o Click on “Submit the request”

o At this point the user can download a PDF of the license agreement via the Certificate
(PDF) Button
o To get the key, click on Download.
▪ This will download a file called “Installation.zip”
▪ The Key File is located in the Zip file. The file name will be
MPR_LU_License{flash-serial-number}.txt

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

17 / 33
 • At this point the key is created and it can be applied to the Wavence.
• The Serial number and the latest configuration will be stored in the ASLM database.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

18 / 33
3 Creating Wavence Spectrum Analyser License
Keys
3.1 WSAT License Key Requirements

The WSAT requires the use of a license key generated via Nokia’s ASLM tool. Customers will need
to order the Nokia part number 3DB19531DBAA, quantity 1 per PC the WSAT is installed. The
customer will need to obtain any of the possible MAC addresses on the computer the WSAT will be
installed.

3.2 How to Generate License Key for WSAT

• Get MAC Address from client PC

• From a command window, type ipconfig /all as in Figure 1.

Figure 1: Command Window with ipconfig /all

• Note the “Physical Address” is the MAC address

• Go to ASLM at https://aslm.app.alcatel-lucent.com/Home
• After selecting the customer create new system. It is suggested to use the use a meaningful
name as the system name; as example, it could be the computer’s name or the owner’s name.
Click Create customer system, as shown in Figure 2.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

19 / 33
 Figure 2: Create new System

• Under “Choose product”, select “Microwave – Spectrum Analyzer Tool” and click
“Continue” as in Figure 3

Figure 3 Selecting Product

• Fill in the MAC Address as shown in Figure 4. Make sure that there are no spaces, dashes or
colons between the numbers.
• For example, a MAC address displayed as 54-56-00-09-A5-AC should be entered as
54560009A5AC.
• Check the box for RTU Wavence Spectrum Analyzer Tool as shown in Figure 4, click on
“Automatically Consumer Order” and then click on “Continue”

Figure 4: Configure License Request

• Click on Submit the Request as shown on Figure 5:

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

20 / 33
 Figure 5: Submit Request

• At this point the license key can be downloaded from ASLM by clicking on “Download” as
shown in Figure 6.
• The downloaded file will be a ZIP file containing the license key.
• See the WSAT Documentation for installation of the license key on the target computer.

Figure 6: Download License Key File

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

21 / 33
4 Extracting the License key from Wavence
4.1 With JUSM

In order to extract the license key from the Wavence, the user will need the JUSM that supports the
release of the Wavence the user is connecting to. The connection from the JUSM can be locally via
a direct connection to the Wavence or remotely via an IP network.
In the JUSM, click on Supervision, then SW License to view the license information. See Figure 7
below.

Figure 7

Flash-card Serial Number (RMU Serial Number), license string and License key are displayed. It is
important to provide both the License key AND the RMU Serial number in text form for the ASML
tool to work properly. See Figure 8

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

22 / 33
 Figure 8

Save the license key (and only the license key) in a text file by copying the License Key (Control-C)
and pasting into a text tool (Control-V), such as Notepad in Microsoft Windows. See Figure 9 below.
Use the “RMU (flash card) serial number as the file name when saving the file.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

23 / 33
 Figure 9

4.2 With WebCT

Wavence R7.1 and greater with the CorEvo cards support the license key application via the WebCT.

• Log in the WebCT via one the supported browsers.

• From the Administration & Networking Domain, click on License Information on the left
menu

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

24 / 33
 Figure 10

• To retrieve the license key, click on the “Export” button. This will download the key file to
the local machine as a text file.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

25 / 33
 Figure 11

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

26 / 33
5 Applying License Keys in Wavence
5.1 With JUSM

In the JUSM, click on Supervision, then SW License to view the license information.

• Flash-card Serial Number (RMU Serial Number), license string and License key are
displayed.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

27 / 33
 • Highlight the current license key in the window and delete. Paste in the new key from the
downloaded file from ASLM.
• Click Apply and the new license key will be activated

5.2 With WebCT

Wavence R7.1 and greater with the CorEvo cards support the license key application via the WebCT.

• Log in the WebCT via one the supported browsers.

• From the Administration & Networking Domain, click on License Information on the left
menu

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

28 / 33
 • In the license key box, highlight the current key and delete the current key
• Copy the license key from the downloaded file in ASLM and paste in the License Key box in
the Web CT

• Click apply and the new license key will be activated.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

29 / 33
6 Useful hints on using ASLM
6.1 How to search for a serial number in ASLM

It is strongly recommended to use the flash card’s serial number as the name the system, however if
the system name is different from the serial number, you can run advanced search from the ASLM
home page.

• On the Dashboard, click on “Advanced License search”

• Enter the flash card serial number for in the field “System Unique ID”
• Under “Request Status” select all statues
• In “Product Family” select Microwave
• In Product select the relevant product, either Wavence License Upgrade-ANSI or Wavence
License Upgrade-ETSI
• Click on “Apply Filter”

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

30 / 33
 6.2 How to check remaining license upgrades

• In the Dashboard Select Reporting ->Orders and Grants Overview

• In the filter page:

o enter the ASLM customer
o Product family as Microwave
o Product as Wavence License Upgrade-ETSI or Wavence License Upgrade-ANSI
o select Grants and Orders in Entitlement Types
• click on Apply filter

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

31 / 33
 The result in displayed in a list at the bottom of the page. You can download it in an Excel
file.

• Some notes about the report's contents:

o DELIVERED status means the order line has been delivered in Blue Planet, Outbound
Delivery has been processed for this order line at a date that is past.
o READY status means the order line in the Blue Planet order is created but Outbound
Delivery has not been processed or has been processed on a future date.
o Quantity column is the quantity from the order line in Blue Planet order.
o Open Quantity column is the quantity available to be consumed in ASLM.
o Notice that all order lines with READY status have no Open Quantity, while the order
lines in DELIVERED status have Open Quantity lower than Quantity. That means that
some upgrades have been consumed.

6.3 How to rename a system

In some cases, users may need to rename a system. To do this, use the “Update System: feature in
ASLM.

• Select the system, LAA-0012 in this example.

• Click on the “Update system” button

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

32 / 33
 • This will allow the use to edit the name and the Description.
• Click on “Update customer system” to save the changes.

Jan 2019 – 3DB19433AAAA <Public> © Nokia 2019

33 / 33