Configuring Subscription Billing

Download this manual as a PDF file

This section describes how to configure subscription billing and view subscription data.

Use the following menu options to navigate the SL1 user interface:

  • To view a pop-out list of menu options, click the menu icon ().
  • To view a page containing all the menu options, click the Advanced menu icon ().

This section includes the following topics:

Prerequisites

To configure a ScienceLogic SL1 system to automatically report subscription data to ScienceLogic, you must perform the following general steps:

  1. Create a credential that the system will use to connect to the ScienceLogic billing server.
  2. Edit the silo.conf configuration file to use the credential.
  3. Enable the Subscription Usage process.

To complete these steps, you must have the following information:

  • The username and password for the ScienceLogic billing server that your system will communicate with to report usage data.
  • The time offset assigned to this system by ScienceLogic.

Creating a Credential for the ScienceLogic Billing Server

To define a SOAP/XML credential that your SL1 system will use to communicate with the ScienceLogic billing server:

  • Go to the Credential Management page (System > Manage > Credentials).
  • In the Credential Management page, click the Create menu. Select SOAP/XML Host Credential.

  • The Credential Editor modal appears. In this page, you can define the new SOAP/XML credential. To define the new credential, supply values in the following fields:

Basic Settings

  • Profile Name. Name of the credential. Can be any combination of alphanumeric characters, for example "ScienceLogic Billing".
  • Content Encoding. Select text/xml.
  • Method. Select POST.

  • HTTP Version. Select HTTP/1.1.
  • URL. Enter "https://billing.sciencelogic.com"
  • HTTP Auth User. Enter the username for the account (associated with your SL1 System) on the ScienceLogic billing server.
  • HTTP Auth Password. Enter the password associated with the account on the ScienceLogic billing server.
  • Timeout (seconds). Enter "5".

Proxy Settings

If the SL1 System requires a proxy server to connect to the ScienceLogic billing server via secure HTTP (https), you can specify a proxy server in the Proxy Settings pane. The proxy must use HTTPS (secure HTTPS). To configure a proxy, enter values in the following fields:

  • IP. Enter the IP address of the proxy server.
  • Port. Enter the port on the proxy server to which you will connect.
  • User. Enter the username to use to access the proxy server.
  • Password. Enter the Password to use to access the proxy server.
  • Click the Save button to save the new SOAP/XML credential.
  • Note the ID number for the new credential.

Editing Silo.conf for Subscription Billing

Every SL1 appliance has a configuration file called silo.conf, which contains configuration information about the appliance itself, such as the IP address, licensing information, and directory locations. The default settings in silo.conf are configured automatically when the appliance is installed.

NOTE: All settings in the silo.conf file are case-sensitive.

To edit the silo.conf file:

  1. Either go to the console of the SL1 appliance or use SSH to access the server.
  2. Log in as user em7admin with the appropriate password.

  3. Type the following at the command line:

    sudo visilo

  4. This is the file where users can customize the silo.conf file. In step #7, you will execute a command that sends these changes to the system silo.conf file.
  5. Add the following two lines to the end of the file, inserting the ID of the credential you created where indicated:

    6. [SUBSCRIBER]

    cred_id = <ID of configured credential>

  6. Save your changes and exit the file (:wq).
  7. At the command line, type the following command to rebuild the configuration file:

sudo /opt/em7/share/scripts/generate-silo-conf.py > /etc/silo.conf

 

Enabling the Subscription Usage Process

To enable the subscription usage process, which will report billing data to the ScienceLogic billing system, perform the following steps:

  1. Go to the Process Manager page (System > Settings > Processes).
  2. Click the wrench icon () for the Enterprise Database: Subscription Usage Crunch process. The Process Editor page appears.
  3. In the Process Editor page, select Enabled in the Operating State field.
  4. In the Runtime Offset (Mins.) field, select the time offset assigned to this system by ScienceLogic.
  5. Click the Save button.