PulseUno licensing

If your PulseUno instance is configured for internal or LDAP authentication, use the AutoPass License Server (APLS) to manage PulseUno licenses. This topic explains what license options are available and how to set up and use APLS.

Note: If configured for external authentication through Dimensions CM, PulseUno doesn't require licenses for users.

License options

The following license options are available for PulseUno.

Option Description
Evaluation

Before licensing is required, PulseUno provides three free user logins (if configured for internal or LDAP authentication) and three free agents.

To have more users or agents, you need to purchase a full license and set up APLS.

Named user license A license for a specific user. Users cannot share named licenses. A user with the named license can access PulseUno from anywhere and only consume a single license. Named licenses are assigned to users in the AutoPass License Server web interface.
Agent license A license for a specific agent. To assign a license to an agent, you approve the agent in the PulseUno web interface.

Back to top

Step 1: Set up AutoPass

To manage PulseUno licenses, install and configure the AutoPass License Server (APLS).

To install and configure APLS:

  1. Download the AutoPass License Server from the Micro Focus ITOM Marketplace (requires login).

    For details about supported versions, see the Support Matrix.

  2. Run the installer for your platform.

  3. Open the APLS web interface and configure the server. For details, see the AutoPass License Server help.

Alternatively, you can set up APLS as a Docker image. For details, see the Docker help.

After the installation, the APLS service starts automatically. To start or stop the service manually, see the AutoPass License Server help.

After you install APLS, configure PulseUno to use it.

Back to top

Step 2: Configure for AutoPass

After installing the AutoPass License Server (APLS), configure the communication between PulseUno and AutoPass.

Configuration steps:

  • Add AutoPass details to the PulseUno startup.properties file.

  • Configure an HTTPS connection to establish the trusted relationship between APLS and PulseUno. By default, APLS uses a custom SSL certificate for HTTPS. You may replace this certificate with another certificate signed by your own certificate authority (CA), or with a self-signed certificate.

Note: To communicate with APLS, PulseUno uses a product definition .pd file. When you install PulseUno or upgrade it to the latest version, the .pd file (for example, 50065_2.0_PulseUno_20.pd) is automatically placed in the pulse_data\conf directory, and no further action is needed.

To modify startup properties with AutoPass details:

  1. On a licensed PulseUno server, edit the startup.properties file in the pulse_data\conf directory to define the following properties:

    Copy code
    license.autopass.server=<APLS-URL>


    where <APLS-URL> is the URL of your AutoPass License Server, for example:

    Copy code
    license.autopass.server=https://apls:5814  
  2. Restart PulseUno.

To add the SSL certificate to the Java keystore:

  1. Obtain the CA certificate or the self-signed certificate used by APLS, as a .pem, .der, or .cer file.

  2. Back up the cacerts file in the Common JRE's keystore directory. The default keystore locations are:

    Windows C:\Program Files\Micro Focus\common\jre\11.0\lib\security\cacerts
    Linux /opt/microfocus/common/jre/11.0/lib/security/cacerts
  3. Using the Common JRE’s keytool command-line tool, run this command:

    Windows:

    Copy code
    <JAVA_HOME>\bin\keytool -import -v -trustcacerts  -alias APLS -file <certificate-file> -keystore <JAVA_HOME>\lib\security\cacerts -keypass changeit -storepass changeit


    where:

    <JAVA_HOME>

    Specifies the root location of the JRE directory. The default locations are:

    • Windows: C:\Program Files\Micro Focus\common\jre\11.0
    • Linux: /opt/microfocus/common/jre/11.0
    <certificate-file> Specifies the path to your SSL certificate file.
  4. Restart Common Tomcat.

Note: To obtain the certificate for APLS and add it to the Java keystore, you can use other tools, for example, Portecle (UI) or InstallCert (command line).

After configuring the communication between PulseUno and AutoPass, proceed to obtain licenses.

Back to top

Step 3: Obtain license

To obtain a license, you need the AutoPass Lock Code.

To request a license:

  1. Get the AutoPass Lock Code.

    1. In the APLS web interface, navigate to License > Install.

    2. Copy the alpha-numeric value in the Lock Code field, for example, 1A2B3C-456DEF.

  2. Visit the Micro Focus Software Licensing and Downloads portal (requires login) and use the Lock Code to generate a license key. For details, see the Knowledgebase article KM000005202.

For assistance, contact Licensing Support (requires login) or your Micro Focus sales representative.

Back to top

Step 4: Install license

After configuring your AutoPass License Server (APLS) and obtaining a license key, install the license in APLS. You need APLS administrator privileges for this task.

To install a license:

  1. In the APLS web interface, navigate to License > Install.

  2. Add the license key file you obtained from the SLD portal. For details, see the AutoPass License Server help.

After installing licenses, assign them to specific users and agents:

Back to top

Step 5: Assign licenses

After you install named user licenses, assign them to specific user login names in the APLS web interface. You need APLS administrator privileges for this task.

For details, see the AutoPass License Server help.

Back to top

Step 6: Approve agents

When an agent is associated with an instance of PulseUno, it is automatically displayed in Administration > Agents. To confirm that an agent is known and trusted, approve the agent.

If you have already approved three agents, each additional agent that you approve will consume a license.

Considerations and behaviors:

  • When an agent is added to PulseUno, it is unapproved by default, and you cannot use it to run chains. If it's a trusted agent, you can approve it.

  • Unapproving or deleting an agent releases the license assigned to the agent.

  • Taking an approved agent offline or online does not affect licensing.

  • PulseUno provides up to three free agents. Further agents require agent licenses.

To approve an agent:

  1. Log in to PulseUno as an administrator.

  2. Navigate to Administration > Agents.

  3. Select one or more agents.

  4. From the Mark As list, select Approved.

To unapprove an agent and release its license, select Unapproved from the Mark As list.

Back to top

View license information

You can view the usage of named licenses, expiry dates, capacity, and sharing details in the APLS web interface.

To view named license information:

  1. Open the APLS web interface.

  2. Navigate to Usage and Report > License Usage. The page displays an overview of license types.

  3. To view usage details, click the license type.

You can check if an agent is licensed, or if there are licensing issues with agents, in the PulseUno web interface. To open the Agents page, navigate to Administration > Agents.

Back to top

See also: