What is the purpose of this information?
The Bentley Licensing Tool provides activation functions and information for products utilizing Subscription Entitlement Service. It is installed with the CONNECTION Client.
Click on these topics to navigate through this article: The Entitlements Tab, Checkout License Tab, Product Status Tab, Importing a License, Configuring Proxy Settings, Configuring Error Logging Settings
Opening the Bentley Licensing Tool
1. Open the Windows Start menu.
2. Type "Bentley Licensing".
3. Select Bentley Licensing Tool from the search results that appear.
The Entitlements Tab
When the Bentley Licensing Tool opens it displays the Entitlements tab. If the CONNECTION Client is signed in, a Bentley login will appear in the upper left corner. Products appear in the Entitlements list if they have communicated with Bentley before. They will communicate the following information:
Checkout License Tab
Product licenses can be locked to the computer for extended use apart from an Internet connection.
The top pane provides a list of licenses. Although it shows two rows by default, the window can be made taller by dragging the window handle in the lower right corner. Additionally, columns can be filtered by clicking the filter icon as shown below.
To check out a license:
1. Select it in the top pane.
2. Specify an expiration date using the calendar icon located along the right edge.
3. Select a valid version from the list or manually enter the four part version number corresponding to the version of your product.
4. Click the Checkout button.
The bottom pane displays a list of licenses locked to the computer. To return a license prior to the expiration date, select it in the bottom pane, and click the Check-in button.
Product Status Tab
More detailed information is displayed on the Product Status tab. The following information is displayed:
Importing a License
Licenses can be checked out from the Entitlement Management site on behalf of a user and saved as a file. The Licensing Tool provides two options to import checked out license files: Import Policy File or Import Policy from Folder
Option 1: To import a file, select "Import Policy File..." from the File menu, and select either a .belic file or a zip archive containing .belic files (generated from a bulk checkout). If there are multiple .belic files in the zip file, the import will search for the current machine name in the .belic file names to decide which license file to import.
Option 2: To import from a folder, select "Import Policy Folder...: from the File menu. Use the browse dialog to choose the folder where the checked-out license files are stored. Again, if there are multiple .belic files in the fold, the import will search for the current machine name in the .belic file names to decide which license file to import. This folder does not need to be a local file system folder; it can be on a shared network drive.
After the import, a dialog will confirm whether the license file imported successfully. Click the Sync button on the Entitlements tab as shown below to refresh the list.
If successful, the product with the imported license will display "Yes" in the Reserved column.
*Please note: Versions of CONNECTION Client prior to 10.00.15.11 will not update the Entitlements list after clicking the Sync button if a user is not signed in. Imported licenses will still function. To resolve the display issue, upgrade CONNECTION Client.
Configuring Proxy Settings
Starting with CONNECTION Client 10.00.18.13, Subscription Entitlement Service products can now utilize system proxy settings as configured in the Internet Options control panel. However, proxy settings can be manually configured if necessary:
1. Select Options from the Tools menu.
2. For most users, ensure the "Use System Proxy Settings" radio button is selected on the Proxy Configuration tab that appears. For server or test environments where proxy settings must be manually configured, choose the "Use Custom Proxy Settings" radio button instead.
3. If specifying custom proxy settings, enter the computer name of the proxy server. If a port must be specified, append the server name with a colon (:) and the port number (i.e. ProxyServer:8080). To determine what proxy settings (if any) are in use, please refer to the following wiki, specifically the section titled "Determine whether a proxy server is in use."
4. If user authentication is required as well, select the second checkbox, and enter user credentials.
5. Click the Test Proxy Configuration link in the lower right to confirm proper configuration.
6. If the configuration test is successful, click the OK button to save changes.
Configuring Error Logging Settings
Subscription Entitlement Service provides diagnostic logging to assist with troubleshooting efforts. By default, the Bentley Licensing Tool maintains a detailed rolling log that is sufficient for most troubleshooting, but configuration options can optionally be configured using the following steps within the Bentley Licensing Tool:
2. Click the Error Logging tab.
3. The Minimum Log Level shows the level of detail to capture. Trace is the default selection which captures all diagnostic information. Each selection below Trace captures less diagnostic information. Lower levels allow diagnostic information to be captured over a greater time span before the oldest diagnostic data is deleted.
4. Client Logging is disabled by default. Enable it to capture additional diagnostic information for each Subscription Entitlement Service application.
To retrieve diagnostic data, please open the Windows Start menu, type Log Collector, and choose Bentley Log Collector from the search results.
Click the Collect button in the window that appears, and save the resulting zip archive. Send the zip archive to Bentley for further analysis.
*Please note: The LogCollector utility is included with CONNECTION Client 10.00.13.17 and later. To manually gather diagnostic logs for earlier versions, please perform the following steps instead:
1. Open the Windows Start menu, type the following, and press Enter:%LocalAppData%\Bentley
2. Zip the Logs folder in the window that appears. This includes logs for CONNECTION Client itself.
3. Open the Licensing folder.
4. Zip the Logs folder in the window that appears. This includes logs for the Bentley Licensing Service.
5. Send both zip archives for further analysis.
Other Language Sources