Moving to the Helix Service Management Suite license model by using the Suite Licensing Opt-in Utility
The information in this topic is applicable only for on-premises deployments.
Use the Suite Licensing Opt-in Utility to convert your existing classic licenses to the Helix Service Management Suite licensing model and share an .xls report with the administrator. As an administrator, you can review this report to determine which users' license needs to be converted to the new Helix Service Management Suite licensing model.
The Suite Licensing Opt-in Utility should be used in the following deployment scenarios:
| Scenarios | Details |
|---|---|
| Installing BMC Helix IT Service Management version 25.2.00 | Run the Suite Licensing Opt-in Utility based on the following scenarios:
|
| Upgrading from BMC Helix Service Management version 21.02.xx to version 25.2.00 | During upgrade, run the Suite Licensing Opt-in Utility after upgrade piepline. |
| Upgrading from BMC Helix Service Management version earlier than 21.02.xx to version 25.2.00 | Run the Suite Licensing Opt-in Utility after completing the migration. |
Before you begin
On the BMC Electronic Product Distribution (EPD) site, from Products, select BMC Helix Innovation Suite OnPrem.
- Select the latest version.
The following screenshot shows the version.
- From the Product tab, select Suite Licensing Opt-in Utility SHA Checksum Version <version> and Suite Licensing Opt-in Utility Version <version>.
The following screenshot shows the Opt-in utility:
- Click Download.
- Save the utility in a folder on your computer.
Modes for running the Suite Licensing Opt-in Utility
The Suite Licensing Opt-in Utility runs the following three modes:
| Modes | Description |
|---|---|
| Report | Generates a report that provides details about users who are impacted by the conversion, such as the login ID, full name, email ID, current user license, new license types, and new licenses. The report also includes the functional roles for BMC Helix Business Workflows, BMC Helix Digital Workplace Catalog, and BMC Helix Multi-Cloud Broker. As an administrator, you can use this report to analyze and determine which users' license needs to be converted. |
| Apply | Modifies the user licenses and performs the updates on the server. It will replace only the BMC Helix licenses, and all custom licenses assigned to the users will be retained. |
| Activate | Activates the new licensing model for all new and updated users. |
To run the Suite Licensing Opt-in Utility
- Access the Suite Licensing Opt-in Utility Version <version> that you downloaded from the Electronic Product Distribution site.
- Run the following command on the command line:
java -jar enablesmartapplicense-<version>-SNAPSHOT.jar
The following table shows the details about the parameters used in the command:Parameter Description -h <arg> Specifies server host name. -t <arg> Specifies server port number. -u <arg> Specifies the user name. -p <arg> Specifies the user password. -m <arg> (Optional) Specifies the execution mode. You can select from the following modes:
- (Default) report—Generates a report of current user licenses and saves them in the AR System Upgrade Tracker form.
- apply—Applies the licenses to the users identified in the report.
- activate—Applies the new licensing model and performs all the updates to initiate the licensing model.
Tip: We recommend to run the utility in the following order of execution modes:
report > apply > activate
After you run the utility, the report is available on the AR System Upgrade Tracker form.
To download the Suite Licensing Opt-in Utility report
- Log in to Mid Tier, open the AR System Upgrade Tracker form.
- Search for the report.
- If the utility runs successfully, the componentStatus field is updated with the Completed status.
- Select your report, and click Save.
The downloaded .xls report provides a detailed report of users with their existing licenses and the new licenses after running the Suite Licensing Opt-in Utility.
Suite Licensing Opt-in Utility report License Mappings
All users with Fixed licenses will be given the Named User licenses, and users with Floating licenses will be given the Concurrent User licenses.
The following table lists the base rules for conversion :
Current Platform and Apps License Type | BMC Helix ITSM License | BMC Helix Business Workflows or BMC Helix Digital Workplace Catalog Functional roles | BMC Helix Multi-Cloud Broker Functional roles | No Application License |
|---|---|---|---|---|
| Platform Fixed | BMC Helix Service Management Standard - Named User | BMC Helix Service Management Standard - Named User | BMC Helix Service Management Advanced - Named User | No change |
| Platform Floating | BMC Helix Service Management Standard - Concurrent User | BMC Helix Service Management Standard - Concurrent User | BMC Helix Service Management Advanced - Concurrent User | No change |