How to Configure and Enable APLS Integration

To configure and enable the APLS Integration, do the following:

1. Configure infrastructure settings on UCMDB server

   1. On the UCMDB server, go to Administration > Infrastructure Settings Manager.

   2. In the Categories navigation pane, click AutoPass Settings, and configure the AutoPass settings as described below:

      Infrastructure Setting	Description
      AutoPass License Server User Name	User name of the AutoPass license server account
      AutoPass License Server Password	Password of the AutoPass license server account
      AutoPass License Server URL	URL of the AutoPass license server. Format of the URL: https://<server_name_or_IP_address>:<port>

   3. Click Save .

      The changes take effect immeditely.

2. Enable one way HTTPS communication between UCMDB server and APLS server

   1. Preparation: Keystore Explorer tool.

      If you do not have the tool, make sure you download and install a Keystore Explorer tool.

   2. Go to the APLS server installation path (for example, C:\program\autopass\apls\apls\keystore.jks) to get APLS server certificate file keystore.jks.

   3. Open the keystore.jks file using the Keystore Explorer tool (you may need to provide password).

   4. Export CA certificate.

   5. On the UCMDB server, locate the server.truststore file in the server installation path (for example, C:\UCMDB\UCMDBServer\conf\security\server.trustore).

   6. Open the server.truststore file using the Keystore Explorer tool (you may need to provide password)

   7. Import the APLS server CA certificate (you just exported from step d) into server.trustore.

3. Trigger license usage data push from UCMDB server to APLS server.

   On UCMDB server, go to the JMX Console > Licensing Services. You can trigger license usage data push by invoking one of the following JMX methods:

   • invokeLicenseCalculation
   • addLicense
   • addLicenseFromFile

   Note  

   • When you trigger license usage data push for the first time, the license definition file (PD) file is sent to APLS as well. This is a one-time operation.

     Location of the PD file on the APLS server:

     C:\ProgramData\autopass\apls\licenseserver\data\conf\pdfiles

     C:\autopass\apls\licenseserver\data\conf\pdfiles

   • After invoking a JMX method, make sure you wait for at least 20 minutes before you proceed to invoking another JMX method.
   • If all infrastructure settings are properly set, license usage data will be pushed to APLS server automatically on a daily basis.

4. View license usage on APLS server.

   If the license usage data are successfully pushed to APLS, you should be able to see a LICENSE USAGE tab page under the USAGE REPORTS module.

   The table below describes the License Usage table:

   Column	Description
   FEATURE ID: VERSION	Tracking ID for Universal Discovery license usage data
   FEATURE DESCRIPTION	Universal Discovery licensing type description. For example, Universal Discovery per Unit
   COMPUTER/USAGE	Number of Universal Discovery licensing units consumed
   TOTAL	Total number of units consumed