Upgrading NLM and/or NLRS

If you want to Upgrade to the latest version of NLRM, you need to uninstall existing utilities according to Linux NLM + NLRS Uninstallation Guide

After you’ve uninstalled existing utilities, follow the steps in Linux NLRM Installation Guide to install NLRM

Upgrade to latest NLRM 4.15

Prerequisites

Before starting the upgrade process, please ensure that you have

• the latest version of the NLRM installer (.rpm file).
• license and authorization certificate if you do not already have valid ones. Copy all the files to the server in which NLRM will be hosted.

If you want to Upgrade to the latest version of NLRM, you need to uninstall existing utilities following Linux NLM/NLRM Uninstallation Guide

Install NLRM

• Install NLRM using this command:

    sudo rpm -ivh nlrm.x.y-z.x86_64.rpm

  The installer .rpm file has this format: nlrm-4.15-129-x86_64.rpm.

Offline Servers

For Token Flex license servers which cannot connect to Autodesk directly, following additional setup is required.

• Go to the location where NLRM is installed. The default location is: /opt/Autodesk/NLRM/.
• Open a terminal at this location
• Run this command to set transmit-mode:

    sudo ./nlrm_config set transmit-mode manual

  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 within the allowance period.

To configure offline duration allowance

• Go to the location where NLRM is installed. The default location is: /opt/Autodesk/NLRM/.
• Open a terminal at this location
• Run this command to set transmit-mode:

    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.

Please refer to the instructions here Submit usage data manually for collecting the data from the primary server and sending it manually from a secondary machine.

Configure license server

In some cases, you may need to reconfigure LMTOOLS.

NOTE: You can skip this step if you upgraded from a previous version of NLM/NLRM and have installed it in the same directory

If you are installing NLRM for the first time, modify the start/stop scripts and change the lmgrd path. The new path of NLRM binaries will be:

• lmgrd: /opt/Autodesk/NLRM/lmgrd
• lmutil: /opt/Autodesk/NLRM/lmutil

Note: You no longer need to add the append mode (+) to the start of the selected debug log file.

Additional version-wise steps for upgrade

Upgrading from NLRM v4.0 / v4.4

After uninstalling existing utilities and Installing NLRM, no additional setup is required. Proceed to Start NLRM.

Upgrading from NLRM v3.19

After uninstalling existing utilities and Installing NLRM, follow the below steps:

Configure authorization certificate

Configure the authorization certificate as below.

• 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.

Proceed to Start NLRM.

Upgrading from NLRM v3.14 or older

After uninstalling existing utilities and Installing NLRM, follow the below steps:

NLRM setup

The setup workflow will help you perform following tasks as required:

• Installing the NLRM authorization certificate
• Configuring Personally Identifiable Information (PII) masking
• Configuring customer email address = Testing your connection

To start this workflow:

• 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 initiate NLRM:

    sudo ./nlrm_config setup

• Complete setup by following the on-screen instructions

Note:

• PII masking flag must be set and should be the same value as used in previous NLRS/NLRM installation.
• If the connection fails please check the proxy and firewall settings

Proceed to Start NLRM.

Updating License

Follow the below steps to update license file:

• Stop NLRM service.

    sudo ./lmutil lmdown -c "linux.lic" -q -force

• Remove the existing file from the NLRM installation directory.
• Copy the new license file to the NLRM installation directory. The default location is: /opt/Autodesk/NLRM/.

Proceed to Start NLRM.

Updating authorization certificate

Follow the below steps to update authorization certificate:

• 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.

Start NLRM

• Run this command to start your license server:

    sudo /opt/Autodesk/NLRM/./lmgrd -c "${LICENSE_FILE}" -l "${DEBUG_LOG_FILE}"

Note:

• If you have custom stop/start scripts which are using NLRM flexnet binaries, then you can use them to start the license server.
• When trying to start the lmgrd on the license server, if the program aborts and print the following error:

    lmgrd: No such file or directory

  A possible reason is the missing Linux Standard Base (LSB) components which are required by the lmgrd. Run the following command to solve the issue:

    yum -y install redhat-lsb

Verify that your license server is running successfully

When the license server starts, it automatically generates a license server start event. You can verify that your server is running by inspecting the application logs.

Online Server

An online license server sends a license server start event message back to Autodesk, which can be seen in the logs as below:

• In a text editor, open: /var/opt/Autodesk/NLRM/4.15/logs/collection_dispatcher_car-park.log

Note: This file is created almost immediately after the license server is started.

• A complete segment of the log file should look similar to the following example. If it does, your license server has started and is running correctly.

    Starting Autodesk Collection Dispatcher v4.15 ...
    Autodesk Server Url => https://car2.autodesk.com
    Source => /var/opt/Autodesk/NLRM/car.park
    Re-dispatch Target => /var/opt/Autodesk/NLRM/re
    Log File => /var/opt/Autodesk/NLRM/4.15/logs/collection_dispatcher_car-park.log
    Initializing transmitter ...
    Check for messages older than 2022-03-10 04:29:35.842564994 UTC , completed in 33.563µs
    Starting to transmit data ...
    Sending data: 1
    [POST] https://car2.autodesk.com/api/v1/event 
    request => {"event_origin":{"application_info":{"name":"NLRM","version":"4.15"},...
    response_code => 200
    response => {"message":"Request has been successfully processed","time_to_next_request_ms":100}
    collection_dispatcher::event_processor::web_transmit    Message processed successfully.
    collection_dispatcher::event_processor::web_transmit    Message queue completed processing.

Offline Server

An offline license server creates a license server start event, which can be seen in the logs as below:

• In a text editor, open: /var/opt/Autodesk/NLRM/4.15/logs/collection_dispatcher_car-park.log
  Note: This file is created almost immediately after the license server has started.

• A complete segment of the log file should look similar to the following example. If it does, your offline license server has started, and is collecting usage data locally.

    Starting Autodesk Collection Dispatcher v4.15 ...
    Autodesk Server Url => https://car2.autodesk.com
    Source => /var/opt/Autodesk/NLRM/car.park
    Re-dispatch Target => /var/opt/Autodesk/NLRM/re
    Transmit Mode => manual
    Log File => /var/opt/Autodesk/NLRM/4.15/logs/collection_dispatcher_car-park.log
    Check for messages older than 2022-03-10 05:46:40.811245673 UTC , completed in 21.52µs
    collection_dispatcher::event_processor::manual_transmit Message queue completed processing.

Parent page: About Network License and Reporting Manager (NLRM)