Although licenses are allocated on a per-agent basis, you install licenses on Safeguard policy servers.
No special commands are required to register or license the clients with policy servers. Hosts using the Safeguard agents are automatically granted a license once a request is received on the Safeguard policy server by means of the sudo client program.
To install a license file
- Copy the .dlv license file to the policy server.
- To install the license, run:
# /opt/quest/sbin/pmlicense -l <license_file>
This command displays your currently installed license and the details of the new license to be installed.
- When it asks, "Would you like to install the new license (Y/N) [Y]?", press Enter, or type: Y
- If there are other policy servers configured in your policy server group, it forwards the license configuration to the other servers.
See the One Identity Safeguard for Sudo Administration Guide for more information about the syntax and usage of the pmlicense command.
NOTE: Due to a change in the communication protocol, using 7.1 or later clients and servers with 7.0 clients and servers is not supported. One Identity recommends you upgrade all of your 7.0 installations to 7.1 or later versions. Installations of release 6.x are not affected and can still be used with 7.1.
For information on upgrading Safeguard for Sudo, see Upgrade Safeguard for Sudo in Safeguard for Sudo Administration Guide.
Upgrading your license
Depending on whether you are upgrading Safeguard for Sudo from a version earlier than 7.0 or from version 7.x, handling your license is different.
Upgrading from a version 7.x: If you have purchased Safeguard for Sudo version 7.x without owning an earlier version, you will receive a new license. In this case, you do not have to perform any extra steps and can proceed with the upgrade process.
Upgrading from a version earlier than 7.0: The product licensing changed with Safeguard for Sudo version 7.0. If you are upgrading Safeguard for Sudo from a version earlier than 7.0 to version 7.x, you must upgrade your license first.
In this case, make sure that you have received you upgraded license before starting the upgrade process.
When client machines attempt to join to the policy server using the pmjoin or pmjoin_plugin command, if you do not have the proper license, the following error message is displayed:
*** Checking connection to policy server host <policy-server> [FAIL]
- ERROR: policy server <policy-server> has no valid license (for QPM4U)
- ERROR: Unable to connect to any policy servers
To display a summary of the combined licenses configured on this host, enter the following command without any options
To install a license, enter the following command. For more information on license installation, see Installing licenses in Safeguard for Sudo Administration Guide.
pmlicense -l <path-to-dlv-file>
If the license file is valid, the installer displays the following:
The selected license file (<path-to-dlv-file>) contains a valid license
If the license file is not valid, the installer displays the following error:
Error: This license file is not valid. Please contact Quest Licensing for a new license file.
You will receive the following message after the license is installed, depending the success of the installation:
If the license is successfully installed:
** Successfully installed new license
If the license install is failed:
** Error: Cannot configure new license from file <path-to-dlv-file>
Additional information is available from the following: