Network License and Reporting Manager (NLRM)

Re-configure NLRM settings

If you have previously configured NLRM and wish to perform specific operations only, follow these procedures:


Install/Update NLRM authorization certificate

To use NLRM, customers are issued a {HOSTNAME}.auth file per license server. This file contains an X509 certificate and an RSA key. It uniquely identifies a license server authorized by Autodesk back office.

Note: This certificate is bound to the customer contract, license server name and MAC address. This means that each certificate file can only be used for the license server for which it was issued and will need to be updated at the time of contract renewals or extensions.

You can skip this step if you are upgrading NLRM from an older to a newer build version, provided your certificate file is still valid.

Windows

  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Copy the certificate file to this location
  • Open a command prompt as administrator
  • Go to the location where NLRM is installed in command prompt
  • Run this command to install the {HOSTNAME}.auth file
      nlrm_config.exe update-auth -c {HOSTNAME}.auth
  • If the command ran successfully, you'll see this message: Installation successful. Please store the certificate (.auth) file at a secure location.

Linux

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Copy the certificate file to this location
  • Open a terminal at this location
  • Run this command to install the {HOSTNAME}.auth file: 
      sudo ./nlrm_config update-auth -c {HOSTNAME}.auth
  • If the command ran successfully, you'll see this message: Installation successful. Please store the certificate (.auth) file at a secure location.

Note: The {HOSTNAME}.auth file is used to authenticate the server. As a security best practice, Autodesk recommends storing this file in a secure location and deleting the copy on the license server after installation.


Configure PII masking

To ensure information privacy, you can enable masking of Personally Identifiable Information (PII) in your NLRM configuration while reporting license usage data to Autodesk. Potential PII data included in license usage data are end user's OS username and OS hostname. Enabling PII masking will send masked values of these data fields to Autodesk but also allow the license administrator to export the mapping of clear usernames/hostnames and masked usernames/hostnames on the license server for troubleshooting. For more information, see Export PII Mapping in NLRM features

Disabling will not mask PII data, but will report it clearly and allow admins to identify users, machines, and products used.

Enabling and disabling of PII Masking should be done in consultation with your Autodesk support contact, and in ideal scenarios should be the same across all the license servers in your company.

Windows

To enable PII masking

  • Open a command prompt as administrator
  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Run this command
      nlrm_config.exe set pii-masking true
  • If the command ran successfully, you'll see this message: pii-masking has been configured successfully.

To disable PII masking

  • Open a command prompt as administrator
  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Run this command
      nlrm_config.exe set pii-masking false
  • If the command ran successfully, you'll see this message: pii-masking has been configured successfully.

Linux

To enable PII masking:

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Open a terminal at this location
  • Run this command
      sudo ./nlrm_config set pii-masking true
  • If the command ran successfully, you'll see this message: pii-masking has been configured successfully.

To disable PII masking

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Open a terminal at this location
  • Run this command
      sudo ./nlrm_config set pii-masking false
  • If the command ran successfully, you'll see this message: pii-masking has been configured successfully.

Configure contact email

NLRM can be configured to use contact email address of the license server administrator. Autodesk shall use the given email address to provide support communication for the license server.

To configure the contact email:

Windows

  • Open a command prompt as administrator
  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Run this command:
      nlrm_config.exe set contact-email {contact email}
  • If the command ran successfully, you'll see this message: contact-email has been configured successfully.

Linux

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Open a terminal at this location
  • Run this command:
      sudo ./nlrm_config set contact-email {contact email}
  • If the command ran successfully, you'll see this message: contact-email has been configured successfully.

Configure transmit mode

NLRM supports usage data transmission in two modes: online mode and manual mode. The default transmit mode is online, in which NLRM will send usage data to the Autodesk server directly. Manual mode will store the data locally on the license server machine. The license/server administrator will need to manually transfer this data to another(secondary) machine connected to the internet and send the data to Autodesk server from the secondary machine.

To avoid additional overhead, Autodesk recommends using the online mode. If required, the server connectivity can be restricted to the Autodesk Token Flex usage receiving server URL(s).

For more information, see Submit usage data manually in NLRM features.

Windows

To configure the manual transmit mode

  • Open a command prompt as administrator
  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Run this command:
      nlrm_config.exe set transmit-mode manual
  • If the command ran successfully, you'll see this message: transmit-mode has been configured successfully.

Note: If the transmit-mode is set to manual, you may configure offline duration allowance (1 to 30 days) which is otherwise defaulted to 30 days. The usage data must be exported and transmitted to Autodesk servers, before the configured offline duration allowance is elapsed since the last time usage was collected from the license server. To configure offline duration allowance please refer Configure offline duration allowance days

To configure the online transmit mode

  • Open a command prompt as administrator
  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Run this command:
      nlrm_config.exe set transmit-mode online
  • If the command ran successfully, you'll see this message: transmit-mode has been configured successfully.

Linux

To configure the manual transmit mode

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Open a terminal at this location
  • Run this command:
      sudo ./nlrm_config set transmit-mode manual
  • If the command ran successfully, you'll see this message: transmit-mode has been configured successfully.

Note: If the transmit-mode is set to manual, you may configure offline duration allowance (1 to 30 days) which is otherwise defaulted to 30 days. The usage data must be exported and transmitted to Autodesk servers, before the configured offline duration allowance is elapsed since the last time usage was collected from the license server. To configure offline duration allowance please refer Configure offline duration allowance days

To configure the online transmit mode

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Open a terminal at this location
  • Run this command:
      sudo ./nlrm_config set transmit-mode online
  • If the command ran successfully, you'll see this message: transmit-mode has been configured successfully.

Configure offline duration allowance days

NLRM supports configuring offline duration allowance in days for license servers running in manual mode. Currently, we support offline duration allowance from 1 day to a maximum of 30 days. The license server administrator will need to export the usage data and transmit to Autodesk servers, before the configured offline duration allowance is elapsed since the last time usage was collected from the license server.

Note: If you update offline duration allowance days, then it is recommended to export and transmit all the usages collected till the date as soon as possible.

To configure the offline duration allowance

Windows

  • Open a command prompt as administrator
  • Go to the location where NLRM is installed. The default location is C:\Autodesk\NLRM
  • Run this command:
      nlrm_config.exe set offline-duration-allowance-days <number within range 1 to 30>
  • If the command ran successfully, you'll see this message: offline-duration-allowance-days has been configured successfully.

Linux

  • Go to the location where NLRM is installed. The default location is /opt/Autodesk/NLRM/
  • Open a terminal at this location
  • Run this command:
      sudo ./nlrm_config set offline-duration-allowance-days <number within range 1 to 30>
  • If the command ran successfully, you'll see this message: offline-duration-allowance-days has been configured successfully.

Parent Page: NLRM Administration Guide