Troubleshoot License Server VPX
Active Directory integration
These errors are the most commonly encountered errors during integration of the License Server VPX to Active Directory:
ERROR: Cannot find user
- The domain user account being used is not found in the target domain.
- Trust domains are not supported. You might see this error if a user belongs to any trusted/parent domain and is not a part of the target domain.
ERROR: User does not have access
- Ensure that the domain user has the right privileges to join the machine to Active Directory.
- For more information, see this Microsoft Support article.
ERROR: Cannot contact the domain
- Correct the domain name or check if the domain is reachable from the License Server VPX and fix any network related issues.
ERROR: User has insufficient permissions to join the domain
- The account does not have the privileges required to join a machine to Active Directory.
For more information, see this article.
For any other errors, see this article for details.
If you see any issues during the keytab creation, follow these instructions and retry:
- Ensure that you have elevated permissions when executing the ktpass.exe command. Run the cmd prompt as Administrator.
- Ensure that the User Account Control (UAC) restrictions are minimal.
- Ensure that all password requirements are met. For example, password filters aren’t blocking password characters on the target domain and you are specifying a supported number of characters.
- Retry the command by adding the domain to account used in the
-mapuserargument. Use a user principal name (firstname.lastname@example.org) or a down-level logon name (domain\username).
- Ensure that the account being used is a member of the target domain and not of a trusted or parent domain.
- Add the -target argument to the command and pass the domain.
- Ensure that the account used in the
-mapuserargument is a service account created solely for this purpose.
- Ensure that the first name, last name, and the service account name for the account are the same.
- We recommend that you name the account with the name of the License Server VPX name to ensure that uniqueness is maintained during mappings.
- Ensure that the account used in the
For more details, see the ktpass command article.
Manually install a certificate
Use this procedure if you are a Director or Studio administrator who doesn’t want to use the self-signed certificate that is generated during installation.
Install the .crt and .key files on the License Server:
VPX - License Administration Console:
- Copy the server.crt and server.key created earlier in this procedure to /opt/citrix/licensing/LS/conf/.
VPX - Web Services for Licensing:
- Copy the server.crt and server.key created earlier in this procedure to /opt/citrix/licensing/WebServicesForLicensing/Apache/conf/.
etc/init.d/ citrixwebservicesforlicensing stop
etc/init.d/ citrixwebservicesforlicensing start
Configure a proxy server for use with Citrix Licensing Manager, Customer Experience Improvement Program (CEIP), and Call Home
You can use a proxy with the Citrix Licensing Manager, CEIP, and Call Home. When you configure a proxy server, requests to download licenses and upload Call Home data are sent through a proxy server.
Citrix Licensing components requiring outward bound web communications can inherit network proxy settings using Windows automatic proxy detection. We do not support authenticated proxies. For more information about Windows automatic proxy detection, see WinHTTP AutoProxy Functions.
Configure a proxy server manually
Edit the SimpleLicenseServiceConfig.xml file, which is in
Add a line of xml to the file in the format
<Proxy>proxy server name:port number</Proxy>. The .xml tags are case-sensitive.