Replacing a License File on Linux

You may need to replace a license file if you receive a renewed license.

Note:

If you are managing a license file with term-based licenses, we recommend that you do not completely replace your license file. Instead, refer to “Adding a New License on Linux”.

Prerequisites

You performed “Installing and Configuring a License Server on Linux”.

Procedure

Set the license environment variables.
You must set MGLS_LICENSE_FILE or LM_LICENSE_FILE to the path of the license file. This enables the licensing software to find the location of the license file.
Shut down the license manager.
The license daemons write their last messages to the log file, close the file, and exit. All licenses that were checked out are rescinded. When the license manager restarts, the applications attempt to reacquire their licenses.

Follow these steps:
1. Use lmdown -c to shut down the license daemons and confirm the shutdown.
```
$ lmutil lmdown -c {license_file | port@host}
```
  Note:
  If you do not set LM_LICENSE_FILE, you must use the -c switch with all lm* commands.
2. If you started the daemon with a server debug log file, check the log to ensure the daemons have exited.
```
$ tail -f  logfile
```
```
6/24 12:00(lmgrd)SHUTDOWN request from davem at node davem
6/24 12:00(lmgrd)Shutting down mgcld
6/24 12:00(mgcld)daemon shutdown requested-shutting down
```
Replace the license file.
Rename the old license file and save the new license file in its place.
Copy the SERVER and DAEMON lines from the old license file and paste them in place of the SERVER and DAEMON lines in the new license file.
Start the license manager daemon on the license server.
```
$ lmgrd -c license_file
```
Where license_file is the file that you configured in “Installing and Configuring a License Server on Linux”.

You also can create a server debug log file.
```
$ lmgrd -c license_file -l logfile
```
Then you can use the Linux tail -f logfile command to monitor the status of the license server.
Verify that the server is valid and has started.
```
$ lmutil lmstat -a [-c {license_file | port@host}]
```
The lmstat command reports the server and daemon status and the product usage.
Verify that a client can check out a license.
Use mgls_ok to ensure that a client can check out a specific license feature.
```
$ mgls_ok license_name
```