This article explains license activation and administration for the Subscription Entitlement Service (formerly known as CONNECT licensing) method used in more recent CONNECT Edition versions of the above OpenFlows products: version 10.02.00.XX and greater.
If you are looking for licensing information for versions older than 10.02.XX.XX, see this article: Licensing OpenFlows products - SELECTserver
Note: the Subscription Entitlement Service was previously known as "CONNECT Licensing". This name change occurred in May of 2019.
The Subscription Entitlement Service (CONNECT Licensing) gives you more control over license usage and administration, compared to previous, SELECTserver licensing. Here are some key benefits:
License Administrators should become familiar with the Subscription Entitlement Service Model and ensure all users are registered. See: Getting Started | Bentley user registration
Note: to use Single-sign in (SSO) such as Microsoft Azure Active Directory (AD), this can be achieved through federation per this article.
It is recommended that Administrators first configure Entitlement Management, to establish group-based access to licenses, and set concurrent use thresholds if desired. This is accessed from the Subscription Services Portal > Entitlement Management. Note that changes can take up to an hour to reflect on the client computers. See more details here: Entitlement Management Configuration
The product licensing process is as follows. For problems, see: Troubleshooting.
This section does not apply to FlowMaster or CulvertMaster (which do not have feature levels).
If you own more than one distinct feature level of the product, or if you have a subscription that enables you to access other, non-owned feature levels (for example from a SELECT OpenAccess subscription), you can return to the Feature Level Selector tool to change the feature level that the product will use (and record license usage against).
You may have a need to change the feature level if you are encountering a message on opening the product that states that your access is denied, or that a concurrent use threshold was reached. Or, you may need to work on a model that has more elements (pipes, inlets, ponds, etc) than your current feature level allows.
The feature level can be changed from the Feature Level Selector, which you can access from the Start menu - type "Feature Level Selector" and click the shortcut that appears. You can also access the Feature Level Selector from within the product under File > Help > License Management > Tools > Select Feature Level (be sure to restart the application after making any changes to the feature level)
Note: there is a known issue in version 11.00.03.14 of the CONNECTION Client that prevents selection of a feature level. Please upgrade to version 11.00.03.25 or greater.
All products that integrate with MicroStation have the ability included in all feature levels. Meaning, you do not need to switch feature levels or purchase additional functionality in order to use the "for MicroStation" integrated version of the OpenFlows product. AutoCAD integration capability is an extra cost for some products and you will need to check your feature level (in the Feature Level Selector) to make sure that it includes AutoCAD. Switching feature levels may be required - caution must be exercised when doing so as different feature levels count as different licenses.
When using the MicroStation or ArcMap integrated mode, if you encounter a message stating that Access is Denied, or if you click "cancel and quit" on a message about the concurrent use threshold being exceeded, and the product does not shut down on its own, be sure to exit manually to help prevent unintended usage. AutoCAD should always shut down on its own in this case.
At what point does OpenFlows product license usage start when integrated with MicroStation?
License usage with AutoCAD integration
This section does not apply to FlowMaster or CulvertMaster as they do not have feature levels.
An Administrator may want to set the feature level for all installed products at once, for an end user. The setting of the feature level is stored on a per-user account basis, and for the user's Bentley account (CONNECTION Client sign-in). To do this, the administrator will need to sign in to the user's Windows and CONNECTION Client accounts, then open the Bentley Licensing Tool (from the Start menu, or in the product under File > Help > License Management) and choose File > Select Feature Level. The Feature Level Selector will open, and will list all products and feature levels available to you. One feature level per product can be selected.
In earlier versions that used SELECTserver licensing, the license needed to be checked out if the user's organization did not have a SELECT subscription (i.e. "Non-SELECT"). Currently, (as of December, 2018) this is not necessary with the Subscription Entitlement Service and no special workflow or considerations are needed.
If you need to use the product on a computer that does not have internet access, you can "reserve" a license (formerly referred to as "checking out").
If you currently have access to the internet but expect to be disconnected and need to use the product, you can reserve the license from the Bentley Licensing Tool, per the information in the "The Reserve License Tab" section of the following article: Overview of Bentley Licensing Tool
If you do not currently have internet access, your license administrator can reserve the license on your behalf from the server administration page. This produces a file that can be imported from the Licensing Tool. For example the file can be placed on a USB drive, inserted into the computer in question, then imported into the Bentley Licensing Tool. See more in the section "5. License Checkout" in this article: Entitlement Management Configuration
Reserving a license can also be used in other cases, not just when there is a lack of internet access. Note that reserving a license will cause the license to be in use the entire time that the license is checked out. For example if you own one perpetual license of a particular feature level and have a concurrent use threshold alert set to one, then if you have that feature level checked out, other users who try to open the product will encounter a threshold alert message. (see further above for more on concurrent use thresholds)
If a user disconnects from a Windows user session instead of signing off, any open Bentley products will continue to run and log usage. This can also happen when another user signs in with a different Windows user account and disconnects the first user. Windows will disconnect the first user's session but will not sign out immediately since any unsaved work could be lost. This explains how multiple remote machines can log usage simultaneously on a Windows client operating system.
Here is a Wiki article to explain -
During a remote session, product usage is recorded against the computer on which the software is running, or against the remote client name depending on the version of the CONNECTION Client being used and the type of Operating System. See more details here: How remote usage is recorded
If you do not have an entitlement for a product (you do not own or have available ANY feature levels for it), you can try the product for up to seven days. For example a prospective user with an account not tied to an organization. In this case, you will see a message stating "This trial entitlement will expire in...". The product will open but will be limited to the lowest possible feature level. For example 10 pipes without AutoCAD integration, for WaterCAD, 250 pipes for WaterGEMS, one pond for PondPack, etc. You can check this size under File > Help > About.
Note that the trial usage is recorded on the server side, so once the trial period for a product has ended, you will not be able to use that product on any computer when signed into that account. Contact the Bentley Sales team for more information on product pricing. Also note that, although the "size" in the "About" window will show the minimum feature level such as 10 pipes, the software will record usage against a blank/empty feature level when using a trial license. This means that if you later become a SELECT OpenAccess subscriber, you will not incur a license usage charge for that minimum feature level due to the trial - it will know that the feature level was blank in that case and not include it.
Trial usage for users with existing entitlements - if your organization already owns or has access to the product/feature level and you still want to try it out (trial it) without recording usage (which may incur a term license charge), please contact your Bentley sales representative for a separate Trial Entitlement. These are special separate licenses that you can use to try the software with your existing account (CONNECTION Client sign-in) without recording usage against the "real" license. The trial entitlement will be preferred over the commercial license, and will revert back to a commercial license if available, once the trial has expired. This can be done with version 10.0.14.17 and greater of the CONNECTION Client, which is included with the installation of versions 10.02.01.XX and greater of the OpenFlows products.
License usage can be reported and monitored from the Bentley Licensing Tool and from the Product Usage report.
Bentley Licensing Tool - Reports current usage of Subscription Entitlement Service-Enabled Bentley products on the current computer.
Product Usage Report - Real time and historical usage reports can be accessed from the Subscription Services Portal
See details here: Monitoring License Usage - Subscription Entitlement Service
To see the feature level currently set without having to look at usage reports or open the feature level selector or the product, this can be read from the LicenseService.db file. For details, see "Determining Currently Set Feature Levels" in this article: Setting the License Feature Level in the Feature Level Selector
If you encounter a problem with your license, the first basic troubleshooting to perform is as follows:
If the CONNECTION Client is not working properly or fails to sign in, see: Sign in problems or "stopped working" error with CONNECTION Client
If you are having difficulty signing in or if you do not have an account that is linked to your organization, contact your Administrator. See: Bentley user registration - Connected User setup
Note: to use Single-sign in (SSO) such as Microsoft Azure Active Directory (AD), this can be achieved through federation per this article.
This "trial entitlement" situation will happen if there are no licenses associated with the organization that your sign-in is associated with. There are several situations where this can occur:
1) This can happen for prospective users (with no licenses) who may want to try the product, in which case this message is expected.2) It can happen if you sign in with an account that is not properly associated with your organization (in which case it is seen as the same situation as #1 since it will not "see" your organization's licenses). See: Bentley user registration - Connected User setup3) It can happen if your organization does not have any licenses of the product you are trying to open. See "Checking what products and feature levels are available to your organization" further below. Contact your License Administrator for further help. 4) It can happen if your account is not properly configured. If you have confirmed that your sign-in is associated with an account that has licenses available (check the "site ID" under File > Help > About), yet none appear and the product stays in Trial mode, contact Bentley's Licensing Technical Support for help.5) This message, or a "No Entitlement" message can also occur if you close out of the Feature Level Selector without selecting anything. In this case, you will need to reopen the product and ensure that you select a feature level.6) This situation has also been known to occur if you initially used the product as a trial, then selected an owned feature level from the Feature Level Selector. A known issue in CONNECTION Client version 10.00.13.17 can cause the product to continue to operate in trial mode even though the feature level was set. In this case, please follow these steps:
This indicates that you had been using a trial version of the product and the trial period has ended. This can happen if your organization does not have a license of the product that you are trying to open, or if you are not properly signed in to the CONNECTION Client. (see "Checking what products and feature levels are available to your organization" further below) First, ensure that the CONNECTION Client is installed (check in your Windows Start menu), then open and sign in. Also, this issue can be caused if the CONNECTION Client was not fully installed because of a pending reboot (try restarting your computer). Contact your administrator if you believe that your account is not properly registered with your organization, or if you have questions about what licenses your organization has access to.
Also, ensure that the right product is being used. For example if using WaterCAD, check if your organization actually has WaterGEMS.
Note that this message may also appear, if you dismissed the "you must sign in" prompt, then signed in. Click "Cancel and Quit", then re-open the product.
This could indicate that you have set the Feature Level to one that you do not have access to (access set to Denied on the server side). Please try re-opening the Feature Level Selector (from the Start menu), and if you see feature levels available, select the appropriate one, close the Feature Level Selector, then re-open the product. Be sure to first test the Standalone version of the product, as the AutoCAD integrated version may not be available in your feature level. Consult with your company's Site Administrator(s) for assistance with identifying the correct feature levels that you have access to. Future versions of the CONNECTION Client may filter out feature levels from the Feature Level Selector that you do not have access to (access set to denied).
If you have set the feature level to one that you have access to and are still getting this message, try the steps for item #6 for the above "Trial mode" issue.
The "Description" may also show "Product is disabled due to usage logs not being sent" or "disabled by logs send". This can occur if there is a problem with the account you are signed into the CONNECTION Client as. For example if it is not properly associated with your organization. Confirm that you are signed in, then if you are able to open the product, go to File > Help > About and check the "site ID". If this is blank, contact your Site Administrator (typically in your IT/Helpdesk) to assist with properly associating your account to your organization.
If this does not help, try the "licensing cleanup" steps at the bottom of this article.
To check the feature level that the product is using, go to File > Help > About and note the number next to "Size". To change the feature level, see Changing the Feature Level
A quick way to check what licenses are available to the organization that your sign-in is associated with is to open the Bentley Licensing Tool (from the Start menu) and click the "Reserve License" tab. This will show a list of the products and feature levels available to you. If the list is empty, then your sign-in account may not be properly associated with your organization (contact your administrator).
This indicates that your administrator has restricted your access to this particular feature level (but not necessarily other feature levels for the product you are trying to use).
If this appears after choosing "yes" to the "check availability?" prompt in the Feature Level Selector tool, dismiss this message box to return to the Feature Level Selector, to select another feature level for that product, if available.
If this appears when attempting to open the product (not in the Feature Level Selector), you may need to contact your license Administrator to gain access, or you can choose a different feature level if available (see "Changing the Feature Level" further above)
This indicates that your license administrator has set a threshold on the number of concurrent usages of that particular feature level, and all licenses are currently in use by other users. This often means that if you continue and open the product, your organization will incur usage charges (if the threshold was set equal to the number of owned licenses). This may be acceptable during times when multiple users need to be working in the software, in which case you can click the "acknowledge" button. This records the event and may alert the license administrator to your choice.
If this appears during the availability check in the Feature Level Selector, "acknowledge" results in the feature level being selected, after which you can click "Done" and open the product. You may encounter a second instance of this dialog box when doing so.
If this appears when attempting to open the product (not in the Feature Level Selector), you may need to wait for the licenses to be available, contact your license Administrator to check who has it open, or you can choose a different feature level if available (see "Changing the Feature Level" further above)
If you have multiple feature levels and one is in use but you want to choose another one, the feature level selector will not automatically appear. Click "cancel and quit" on the prompt, then open the Feature Level Selector from the Start menu, change the feature level and reopen the product.
This may indicate that you had initially activated the product but had since gone offline (or was not able to sign in to the CONNECTION Client) and your offline use grace period has ended. When your administrator has permitted offline use, you can use the product offline for a limited number of days. Once this has expired, you must activate the product to continue using it. This is done using the steps further above. In short, you must sign in to the CONNECTION Client when connected to the internet and ensure your sign-in is associated with your organization.
Alternatively if you need to use the product offline for an extended period of time, consider Reserving (checking out) the license. See "Reserving a license..." further above.
If you are signed into the CONNECTION Client and this still happens, you may need to Send Logs per this article: Application Use Limited
If the message also indicates "The license Client was unable to contact the Usage Logging Service" and you are signed into the CONNECTION Client, try clearing out the license database and other files per the steps at the bottom of this article.
If the above information does not help, you may be using an old version of the CONNECTION Client that may conflict with your version of Windows or Microsoft Edge. Try downloading the latest version, then restart the OpenFlows product.
If the software was open while the computer was put to sleep (for example laptop lid closed), you may see the above message when resuming from sleep. This can happen if all licenses became in use while your computer was sleeping (based on an admin-set threshold). In this case, save any unsaved work, close the software, then reopen, so that the license availability is re-checked.
Note: starting with version 22.214.171.124 of the CONNECTION Client, an improvement has been introduced to prevent usage from being logged while the computer is sleeping.
"Usage Alerting Service Unavailable" when starting the product, and product is very slow to open (or hang when choosing feature level)
This can happen if there is a problem with Bentley's usage alerting service, and can result in a long delay in opening the product (or a hang when trying to select the feature level in the Feature Level Selector dialog). Once Bentley has resolved the outage, you may need to restart your computer to resolve the issue. Please see more here and contact Bentley Licensing Support for help.
"This application requires the CONNECTION Client...""Failed to initialize the Bentley Licensing Client...""#ActiveLicenseFeatureModel_FailedToInitializeLicense"
If you encounter one or more of the above errors, it is an indication that the CONNECTION Client is not installed, or you have an older version of the CONNECTION Client. Please reinstall the product, or download and install the latest CONNECTION Client version from the Software Downloads site. Version 10.00.11.17 or greater is required, as of December, 2018. If you use a 64-bit computer (this is most common), be sure to install the 64-bit version of the CONNECTION Client.
If you've confirmed that the correct, latest version of the CONNECTION Client is installed and that you are signed in, please try these steps:
1. Sign-out for the CONNECTION client.2. In the Windows Task Manager (details/processes tab), end task for both Bentley.Connect.client.exe and Bentley.Licensing.Service.exe.3. Navigate to %localappdata%\ (enter this with the % signs in the address bar of File Explorer and press enter), open the Bentley subfolder, then locate and rename the file MySELECT.DB (for example add .old. to the end) and do the same for the file LicenseService.DB in the "Licensing" subfolder within the Bentley folder.4. Open the CONNECTION client and sign-in. See if you see notifications.5. Open the Bentley Licensing Tool and confirm if it shows that you have signed in.
This can occur if you open a model in WaterCAD that has SCADA Signals configured, such as the Example5 model found in the "Samples" folder, or a model sent to you by a WaterGEMS user. SCADAConnect is only available in WaterGEMS, so you will need to upgrade to WaterGEMS in order to use the SCADAConnect feature/tool itself. See more in this article: Using SCADAConnect Simulator
Note: starting with CONNECT Edition Update 3 (and a patch for 10.02.01.06 - contact Technical Support), a 25-signal license will be included with WaterCAD, thereby avoiding this issue. In the rare event that you had previously purchased a separate SCADAConnect license with more than 25 signals and would like to use it with WaterCAD in order to work with SCADA Signals in existing models, you can configure WaterCAD to use the legacy license by adding the following highlighted option to your watergems.exe.config file via text editor. This file is located in the "x64" subfolder of your WaterGEMS installation folder, if you are using the 64-bit version of WaterGEMS.
<?xml version="1.0" encoding="utf-8"?><configuration><startup useLegacyV2RuntimeActivationPolicy="true"> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1"/></startup><runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <probing privatePath="SharedAssemblies" /> <dependentAssembly> <assemblyIdentity name="Bentley.License.Library.NET" publicKeyToken="4bf6c96a266e58d4" /> <bindingRedirect oldVersion="126.96.36.199" newVersion="188.8.131.52" /> </dependentAssembly> </assemblyBinding></runtime><appSettings> <add key="SCADA_EnableLegacyLicensing" value="true"/></appSettings></configuration>
This can happen if you left the product open while putting your computer into Sleep mode, or if you lose your internet connection while the product is open, and the connection is re-established. Your administrator may have disabled offline use (potentially along with setting concurrent use alerting), so the product will need to be closed to prevent usage from recording, which may result in over-usage if all licenses are already in use. Please save your work, close the software, then re-open it. Note that this behavior is changed starting with an update to the CONNECTION Client in November, 2020. See more here: Offline use license shutdown
As of CONNECTION Client version 10.00.13.17, the Feature Level Selector will display all license feature levels that your organization has, regardless of whether the particular user (viewing the Feature Level Selector) has access (entitlements) to them. For example if the administrator has set the General Access settings to deny access to a particular feature level, currently it will still show up in the Feature Level Selector. In a future version of the CONNECTION Client, this will be addressed so that such feature levels are filtered out. In the meantime, when clicking the "Select" button next to a feature level, you will first be prompted if you would like to check that the license is available. When choosing "Yes", if you do not have access to that feature level, you will get an "access denied" message, then have the opportunity to select a different feature level. See more above under "Product Activation" (item #4).
If you own a perpetual license of only one distinct feature level of the product, it will be selected for you automatically and the Feature Level Selector will not appear. If you believe that you have more feature levels owned, try opening the Feature Level Selector from the Start menu shortcut. Owned feature levels will appear in bold in the Feature Level Selector.
If you have a need to use a different feature level (for example one that is available to you as part of a SELECT OpenAccess subscription), you can select it.
This is a known issue in version 11.00.03.14 of the CONNECTION Client. Please upgrade to version 11.00.03.25 or greater.
Activation status and feature level selection is tracked based on who you are signed in as, not your computer/machine name. So for example your administrator cannot sign in to their account to activate the license on your computer.
The "Expires" column in the Bentley Licensing Tool (or "days before disabled" for some versions) shows the date that the product will no longer be licensed, IF it is not able to activate earlier. This applies to cases where the administrator has enabled Offline Use, in which case you have a seven-day grace period where the product can be used offline (no internet or CONNECTION Client). This is what the "expires" date reflects in the Licensing Tool. It does not necessarily mean that your product is about to expire, but rather that it will expire if you are offline until that date. If you are able to sign in to the CONNECTION Client and open the product the next day for example, the "expires" date will increment by one day.
Note that if you have changed feature levels using the Feature Level Selector, you may see multiple lines show up in the Entitlements tab of the Bentley Licensing Tool, and the one(s) that you currently do not have selected may show as expired.
See also: License will expire in 7 days
As of January 2019, Reserving a license is not required for Non-SELECT users. The software is licensed as described in this article.
If the license administrator has made a change on the server side, it can take some amount of time for the entitlements to update on the client computers. For example if a concurrent use threshold is set, it will not apply immediately. Wait an hour and try again.
Concurrent use threshold alerts do not guarantee that you will not incur usage. Also, concurrent use alerts are not enabled by default and must be turned on by the administrator on a per-feature level basis. Subscribers continue to hold the responsibility to manage their licenses within the terms of the SELECT Agreement. The license alert notifications assist with license management, but is not meant to supplement the responsibility of the account to monitor their usage. There are various reasons why alerts may not appear, such as the use of older, SELECTserver-based products. See more caused at the bottom of this article: Subscription Entitlement Service (CONNECT Licensing) FAQ
Also, even if a concurrent use alert appears, the end still has the option to "Acknowledge". Acknowledgement will be recorded, and the administrator can optionally be immediately notified in such cases.
In difficult cases, a health check can be performed, and log files can be provided to Bentley for troubleshooting licensing problems.
The Health check can be performed from the CONNECTION Client found in the Windows System Tray (lower right corner). Click the gear icon in the upper-right corner of the CONNECTION Client, choose "health check" and click Run. After some time, results will be available and can be provided to Bentley Support if needed.
License logs can be generated from the Bentley Licensing Tool:
In some cases, users of the OpenFlows products may not be able to upgrade to Subscription Entitlement Service-enabled versions. For example if you need to submit a project to another organization who is still using an older version (our products are currently generally not Forward Compatible).
In this case, the older products will still work and continue to report usage based on the Site Activation Key entered in the license management tool, but this means that concurrent use threshold alerts will not work properly. For example if you set the threshold to 1 and a user has an older (SELECTserver-licensed) version of that product/feature level in use, the Subscription Entitlement Service-based versions on other computers will not "see" that the other user has the product open, and the license alerting service will not know to display alerts in that case. Similarly, feature levels set to "denied" in the General Access settings on the server, will not be respected for older, SELECTserver-based versions.
So, a mix of SELECTserver and Subscription Entitlement Servicecan be used, but you will not be able to use concurrent use threshold alerting or General Access settings.
Also note that the older, SELECTserver (hosted and "deployed"/on-premises) license administration functionality will be discontinued per the Bentley Support Policy on Jan 1, 2021. Older SELECTserver-licensed versions (below 10.02.XX.XX) will still continue to be able to license properly, but the supporting license management tools will no longer be supported.
See also: SELECTserver/Subscription Entitlement Service hybrid environment FAQ
The "hosted" and "deployed" status of a user only impacts SELECTserver licensing. Subscription Entitlement Service-enabled products will always talk to Bentley's online license server via the CONNECTION Client. Consequently, users with a deployed SELECTserver can still use it for their older SELECTserver-based products while their newer Subscription Entitlement Service-based products communicate with our online license server.
Version 10.03.00.03 was released on March 18, 2020 to support Subscription Entitlement Service licensing. Subscribers will need to install this version by the end of 2020. Will Support be Discontinued for CulvertMaster 3.3?
SELECTserver-licensed products can still coexist with Subscription Entitlement Service licensed products. See more here: SELECTserver/Subscription Entitlement Service hybrid environment FAQ
Originally we had planned to have a Subscription Entitlement Service (CONNECT Licensing) "adapter" available, which would enable older product versions to utilize the Subscription Entitlement Service. As of December, 2018, we no longer plan to have the adapter available. To use the Subscription Entitlement Service and its related Entitlement Management features, you will need to upgrade to Subscription Entitlement Service-capable product versions. (10.02.00.01+ for OpenFlows products)
The Subscription Entitlement Service communicates with Bentley's licensing service over the internet. As long as your computer can access the internet over Port 443, it should work properly. Proxy server settings can be managed in the Bentley Licensing Tool.
You can reset your licensing conditions to default using the steps in the "licensing cleanup" section of the following article: How do I perform a clean uninstall and reinstall of the Hydraulic and Hydrology products?
This can often resolve issues with activation when you have confirmed that other settings and conditions are good.
If multiple users in an organization are attending a live training session involving hands-on workshops, you may want to avoid incurring overages or term licenses from too many concurrent usages during the training. For Bentley-provided training, please contact your trainer or your Bentley account manager for access to a temporary training license. These consist of a temporary sign-in email address and password, which expire each month.
KNOWN ISSUE: before 2020-Sep-23, there was a known issue with the temporary training licenses with the latest version of the CONNECTION Client. This issue should now be resolved, but if you are not able to select your feature level in the Feature Level Selector after switching to the temporary training sign-in account, you will need to revert back to an older version of the CONNECTION Client. This can be accomplished by uninstalling the current CONNECTION Client version and then either reinstalling the OpenFlows product (which will reinstall an earlier version of the CONNECTION Client), or manually downloading and installing version 10.00.18.25 of the CONNECTION Client, from the Software Downloads site.
For Channel-Partner (reseller)-provided training, the Bentley Channel Partner will need to provide their own temporary training licenses.