Knowledge library

ScienceLogic SL1 / Historical reference

Configuring Subscription Billing

An archived technical reference covering Configuring Subscription Billing. Retained from the Dynecon knowledge library for engineering context.

This reference preserves the original technical material. Its procedures and screenshots reflect the original product version, not necessarily your installed release. Consult the ScienceLogic documentation for current guidance. Some original vendor images and links are no longer available; missing figures are identified in the text.

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 ([Original reference image unavailable: menu icon]).
  • To view a page containing all the menu options, click the Advanced menu icon ([Original reference image unavailable: AdvancedMenu]).

This section includes the following topics:

Overview

Prerequisites

Creating a Credential for the ScienceLogic Billing Server

Editing Silo.conf for Subscription Billing

Enabling the Subscription Usage Process

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).

[Original reference image unavailable: credential management updated 480x232]

    • In the Credential Management page, click the Create menu. Select SOAP/XML Host Credential.

[Original reference image unavailable: soap cred white 480x287]

  • 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 vi /etc/siteconfig/siloconf.siteconfig

    1. 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.
    2. Add the following two lines to the end of the file, inserting the ID of the credential you created where indicated:

[SUBSCRIBER]

cred_id =

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

sudo /opt/em7/share/scripts/generate-silo-conf.py > 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.

Configuring Subscription Billing for Secure Networks

Download this manual as a PDF file

This section describes how to configure a ScienceLogic SL1 system for subscription billing when the system is "air gapped", that is, it is a system that does not have internet access.

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

  • To view a pop-out list of menu options, click the menu icon ([Original reference image unavailable: menu icon]).
  • To view a page containing all the menu options, click the Advanced menu icon ([Original reference image unavailable: AdvancedMenu]).

This section includes the following topics:

Options for Securing the Billing Process

Initial Configuration of a Secure Site

Generating a Subscription Usage Report

Options for Securing the Billing Process

The following options are available when configuring the communication process for subscription billing on secure networks:

  • The subscription billing process can use an authenticated HTTP proxy for the outbound connection to the ScienceLogic billing infrastructure. For more information, see Creating a Credential for the ScienceLogic Billing Server.
  • Use the option to remove device names from the payload sent to ScienceLogic. For more information, contact ScienceLogic support.

Initial Configuration of a Secure Site

This section describes the initial configuration that must be performed on all ScienceLogic SL1 systems that cannot connect to the ScienceLogic central billing server due to security concerns. You must repeat this process each time a change is made to your billing rules.

Initial ScienceLogic SL1 System Setup

To configure a ScienceLogic SL1 system that cannot connect to the ScienceLogic central billing server, perform the following steps:

  1. Go to the Admin Processes page (System > Settings > Admin Processes).
  2. Locate the Enterprise Database: Subscription Usage Crunch process, and select its wrench icon (). The Process Editor page opens.
  3. Set the Operating State field to Enabled.
  4. Click [Save].
  5. Wait for the Enterprise Database: Subscription Usage Crunch process to run, which can take up to 24 hours, or run the process manually. To run the process manually, follow these steps:
    • Select Manage > Subscription Usage.
    • Click License Data Delivery Status. The License Data Delivery Status modal appears.
    • Select the checkbox for the oldest file that appears in the page, and then click [Download]. The report is downloaded to your browser's download location.
  6. Provide ScienceLogic with the file.
  7. ScienceLogic will configure the central billing server and generate a status file.

Final ScienceLogic SL1 System Setup

After the status file has been generated from the ScienceLogic central billing server, perform the following steps on your ScienceLogic SL1 system:

  1. Save the status file to your local computer.
  2. Go to the Subscription Usage page (Manage > Subscription Usage).
  3. Click License Data Delivery Status. The License Data Delivery Status modal appears.
  4. In the Status Update File field, browse for the status update file on your local computer.
  5. Click [Upload].

Generating a Subscription Usage Report

For secure systems, you must provide your ScienceLogic Customer Success Manager with the Subscription License Usage report once a month. You can schedule the report to run on a regular basis or you can generate the report manually.

Scheduling a Subscription Usage Report

To schedule a subscription usage report to provide to your Customer Success Manager, perform the following steps:

  1. Associate the Email addresses you want to send the report to with a user account or external contact in your system.
  2. Open the Reports page.
  3. From the Reports page, open the Report Jobs page (Reports > Create Report > Report Jobs).
  4. Click [Create].
  5. Supply values in the following fields.
    • Job Title. Enter a name for the report job (for example, “Monthly Subscription License Usage Report”).
    • Run As User. Select an administrative user in your system.
    • Report Definition. In the EM7 Administration section, select Subscription License Usage Report by Type.
    • Job Recipients. Click in the field to open the Recipient Selector modal, and add the EM7 Users or External Contacts to whom you want to send the report.
    • Job Type. Select Email & Archive.
    • Delivery Method. In the Attachment section, select Microsoft Excel 2007+ Spreadsheet (.xlsx).
    • Number of Days. Select 90.
  6. Click [Save].
  7. On the Reports page, open the Scheduler (Reports > Create Report > Scheduler).
  8. Click [Create].
  9. Supply values in the following fields.
    • Schedule Name. Enter a name for the schedule (for example, “Monthly Subscription License Usage Report”).
    • Start Time. Select the first day of the next month.
    • Recurrence. Select By Interval.
    • Interval. Enter "1" in the first field and select Months in the second field.
    • Report Job. Select the report job that you created.

      In most cases, you can use the default values in the other fields in this page. See the Reports documentation for a description of the other fields in this page.

  10. Click [Save].

Running a Subscription Usage Report Manually

To run a subscription usage report manually:

  1. Open the Reports page.
  2. From the Reports page, select Run Report > EM7 Administration > Subscription License Usage Report by Type.
  3. Specify the following values:
    • Number of days. Select 90.
    • Output format. Select Microsoft Excel 2007+ Spreadsheet (.xlsx).
  4. Click [Generate]. A progress window appears. Do not close this window.
  5. When the report is ready, it is downloaded to your browser's download location and is sent to your Email address. Optionally, you can click one of the format icons to download as your format of choice: ODS, PDF, XLSX, or HTML.
  6. Provide the spreadsheet (XLSX file) to your Customer Success Manager.

 

Viewing & Managing Subscription Data

Download this manual as a PDF file

If you have a subscription license, you can use the Subscription Usage page (Manage > Subscription Usage) to:

  • View current or historical subscription license usage graphs
  • Download subscription license usage data for manual upload to the ScienceLogic billing server
  • Upload a receipt from the ScienceLogic billing server

If your SL1 system is configured to communicate with the ScienceLogic billing server, usage data will be sent automatically from your SL1 system to the ScienceLogic billing server once a day. After the ScienceLogic billing server receives the usage data, SL1 will automatically mark the license usage file as delivered.

If your SL1 system is not configured to communicate with the ScienceLogic billing server or if the connection to the ScienceLogic billing server fails, you can manually upload usage data to the ScienceLogic billing server.

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

  • To view a pop-out list of menu options, click the menu icon ([Original reference image unavailable: menu icon]).
  • To view a page containing all the menu options, click the Advanced menu icon ([Original reference image unavailable: AdvancedMenu]).

This section includes the following topics:

Overview

Viewing Reports on License Usage

Subscription License Summary Dashboard

Viewing Delivery Status

Manually Uploading License Usage to ScienceLogic

Data Retention Settings for Licensing

Viewing Reports on License Usage

If you have a subscription license, you can view a report on license usage for your SL1 system. To view a report on license usage for your SL1 system:

  1. Go to the System Usage page (System > Monitor > System Usage).
  2. Click the Subscription button.
  3. Select View Subscription License Data.
  1. The View Subscription License Data modal page appears and displays a report on license usage.

[Original reference image unavailable: subscription graph 576x317]

  1. The View Subscription License Data modal displays a graph. The graph displays:
  • Number of monitored devices on the y-axis.
  • Date and time on the x-axis.
  • Each colored line on the graph represents a device category.

Device categories depend upon your specific license agreement with ScienceLogic. The types of device categories that can appear in the View Subscription License Data modal page will reflect your license agreement with ScienceLogic.

Viewing Subscription License Reports

SL1 comes with two subscription license reports that you can use to view your license usage by device or by license type. To access these reports, go to Report > Run Report > EM7 Administration.

Subscription License Usage Report by Device

This report displays the number of active and inactive licenses, by device. The report displays the default columns of Billing Category, Organizations, Device Name, Device Category, Device Subclass, License Type, and License Count.

You can customize the output to include a baseline or to separate license totals by type.

[Original reference image unavailable: Click the image to resize.]

The following input options are available when generating the report:

  • Organizations. Specify one or more organizations or all organizations to include in the report.
  • Options. Separate the report into tables, with a table for each organization.

This description covers the latest version of this report as shipped by ScienceLogic. This report might have been modified on your SL1 system.

Subscription License Usage Report by Type

This report displays the number of licenses, by type, in a line graph and also includes a table that displays the number of licenses by date and the number of average licenses over time.

[Original reference image unavailable: Click the image to resize.]

The following input options are available when generating the report:

  • Timespan. Select the number of days to include in the report. Choices are 30 days, 60 days, 90 days, 120 days, 180 days, and 365 days. The default value is 60 days.

This description covers the latest version of this report as shipped by ScienceLogic. This report might have been modified on your SL1 system.

Subscription License Summary Dashboard

The Subscription License Summary Dashboard displays subscription license data and includes the following widgets:

  • Subscription License Usage Totals. Displays subscription license usage over time.
  • Subscription License Usage by Device Category. Displays license count by device category.
  • Subscription License Usage by Device Class. Displays license count by device class.
  • Subscription Licensing Reports. Displays the report forms for Subscription License Usage Report by Device and Subscription License Usage Report by Type. From this widget you can generate reports directly from the widget. The report will open in a new browser window.
  • Subscription License Count. Displays the number of subscription licenses.

[Original reference image unavailable: subscription license summary dashboard 576x280]

For detailed descriptions of each widget in the Subscription License Billing Dashboard, Additional Dashboard Widgets section.

Viewing Subscription Licensing Data

The Subscription Data page allows you to:

  • View subscription licensing data that you have submitted to ScienceLogic
  • Manually submit subscription licensing data to ScienceLogic
  • Download the delivery status information for all data processed by the billing system within a specific date range

This page appears only in ScienceLogic's central licensing system.

Viewing Device Count by License Type

The View Device Count by License Type pane displays a graph. The graph displays:

  • Number of monitored devices on the y-axis.
  • Date and time on the x-axis.
  • Each colored line on the graph represents a device category.

Device categories are dependent upon your specific license agreement with ScienceLogic. The types of device categories that can appear in the View Subscription License Data modal will reflect your license agreement with ScienceLogic.

Viewing Delivery Status

The License Data Delivery Status page displays the status of one or more daily license usage files. To view the License Data Delivery Status page:

  1. Go to the Subscription Usage page (Manage > Subscription Usage).
  2. Click the License Data Delivery Status button.
  1. The License Data Delivery Status modal appears and displays a list of daily license usage files. For each daily license usage file, the License Data Delivery Status page displays the following:
  • Summary Date. Date associated with the daily license-usage file.
  • Delivery Status. Possible values are:
  • "0" (zero). File has not been uploaded to the ScienceLogic billing server.
  • "1" (one). File has been uploaded to the ScienceLogic billing server and may be deleted from the SL1 system by the automated maintenance process.
  • Summary Size. Size of the daily license usage file.

[Original reference image unavailable: lic data del status 576x422]

Manually Uploading License Usage to ScienceLogic

If your SL1 system is configured to communicate with ScienceLogic, usage data will automatically be sent to the ScienceLogic billing server once a day. After the ScienceLogic billing server receives the usage data, SL1 will automatically mark the license usage file as delivered.

If your SL1 system is not configured to communicate with ScienceLogic or if the connection to the ScienceLogic billing server fails:

  • You can use the License Data Delivery Status page to manually download the daily license-usage file.
  • You can then log in to the ScienceLogic billing server and manually upload the daily license-usage file.
  • You can then use the License Data Delivery Status page to upload the ScienceLogic "receipt" to your SL1 system, allowing SL1 to mark the license usage file as delivered.
  • License usage files will not be deleted from your system until they are delivered.

Downloading the Daily License Usage File

If your SL1 system is not configured to communicate with ScienceLogic or if the connection to the ScienceLogic billing server fails, you can use the License Data Delivery Status page to manually download the daily license usage file. You can then log in to the ScienceLogic Licensing and Billing server and manually upload the daily license usage file.

To download the daily license-usage file using the License Data Delivery Status page:

  1. Go to the Subscription Usage page (Manage > Subscription Usage).
  2. Click License Data Delivery Status.
  1. Select one or more daily license usage files to download to your local computer, and then click the Download button.

[Original reference image unavailable: lic data del status 576x422]

NOTE: If the download size exceeds 50MB, the Download button is disabled.

  1. The daily license usage file is saved to your local computer. The downloaded file is usually named "license_data.json.gz".

Manually Uploading the Daily License Usage File to ScienceLogic

After downloading the daily license usage file to your local computer, you can manually upload the file to the ScienceLogic billing server. To do this:

  1. Log in to the ScienceLogic billing system.
  2. Go to the Subscription Data page (Preferences > Account > Subscription Billing).
  3. In the Subscription Data page, go to the Subscription Data Update pane. Use the Browse button to find the daily license-usage file that you downloaded to your local computer.
  1. Click the Get Update button to upload the daily license-usage file to the ScienceLogic server.

[Original reference image unavailable: subscription upload 576x160]

  1. The ScienceLogic server will provide a "receipt" file for you to download. This file is usually called "status_updated.json.gz". You must upload this receipt to your SL1 system.

Downloading a Delivery Status Receipt for a Specific Date Range

From the ScienceLogic billing server, you can also download a "receipt" file containing the delivery status for all of the data processed by the billing system within a specific date range. This file can be uploaded to your SL1 System to update your system's data delivery status information.

To download a delivery status receipt for a specific date range:

  1. Log in to the ScienceLogic billing server.
  2. Go to the Subscription Data page (Preferences > Account > Subscription Billing).
  1. In the Subscription Data Receipt Status pane, use the From and To fields to enter the date range for which you want to download data delivery status data, then click the Get Status button.

[Original reference image unavailable: subscription data receipt status 576x160]

  1. The ScienceLogic server will provide a "receipt" file for you to download. This file is usually called "status_updated.json.gz". You can upload this receipt to your SL1 system.

Uploading the ScienceLogic Receipt

After uploading the daily license usage file to the ScienceLogic Billing server, the ScienceLogic server will provide a "receipt" file for you to download. This file is usually called "status_updated.json.gz".

You must upload this "receipt" file to your SL1 system to inform your SL1 system that the upload was successful and that the SL1 system may delete the daily license usage file.

To upload the "receipt" file:

  1. Go to the Subscription Usage page (Manage > Subscription Usage).
  2. Click License Data Delivery Status.
  3. In the Status Update File field, click Choose File and browse to locate the "receipt" file.
  1. Click the Upload button to upload the "receipt" file to your SL1 system.

[Original reference image unavailable: lic data del status 576x422]

Data Retention Settings for Licensing

The Data Retention Settings page contains settings for subscribers.

To adjust these settings:

  1. Go to the Data Retention Settings page (System > Settings > Data Retention).
  1. The following sliders appear under the Subscription Data Retention heading:
  • Subscriber Device Configuration Data. For users with a subscriber license. Number of months to retain the files and database tables that contain configuration information for a device. Default value is twelve months.
  • Subscriber Device Usage Data. For users with a subscriber license. Number of months to retain information on total number of events and total number of tickets. Default value is six months.
  • Subscriber System Configuration Data. For users with a subscriber license. Number of months to retain the files and database tables that contain configuration information for the SL1 system. Default value is twelve months.
  • Subscriber System Usage Data. For users with a subscriber license. Number of months to retain information on total number of events and total number of tickets. Default value is six months.
  • Subscriber Device Type Data. For users with a subscriber license. Number of months to retain the files and database tables that map each device to a device category, as per your subscriber license. Default value is six months.
  • Subscriber Daily Delivery Data. For users with a subscriber license. Number of months to retain the "crunched" license usage data that is calculated each day using the Subscriber Device Configuration Data, Subscriber System Configuration Data, Subscriber System Usage Data, and Subscriber Device Type Data. SL1 will not prune data that has not yet been delivered to the ScienceLogic Licensing and Billing server.

Viewing License Data

Download this manual as a PDF file

This section describes license data for SL1.

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

  • To view a pop-out list of menu options, click the menu icon ([Original reference image unavailable: menu icon]).
  • To view a page containing all the menu options, click the Advanced menu icon ([Original reference image unavailable: AdvancedMenu]).

This section includes the following topics:

Overview

Viewing License Information

Viewing License Information

The License Information modal enables you to:

  • View a list of all third-party licenses that are aligned with SL1
  • Search for specific licenses
  • View the full text of each license

To view license information:

  1. Click the Toolbox button in the upper-right of the ScienceLogic browser session and then select License Information.

[Original reference image unavailable: toolbox license information 576x298]

The License Information modal appears. All of the licenses that are aligned with SL1 are listed.

  1. On the License Information modal, you can do the following:

[Original reference image unavailable: license information 576x379]

  • To view any license in its entirety, click its right-arrow icon. When you do, the icon becomes a down-arrow, and the full license information appears.
  • To view all of the licenses in their entirety, click the Expand All link.
  • To view only the condensed information for each license, click the Collapse All link.
  • To search for a specific license, type part or all of its name in the search box in the upper-right of the page and then press the Enter key.

Subscription Data Collection

Download this manual as a PDF file

This section describes the subscription data collected by SL1.

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

  • To view a pop-out list of menu options, click the menu icon ([Original reference image unavailable: menu icon]).
  • To view a page containing all the menu options, click the Advanced menu icon ([Original reference image unavailable: AdvancedMenu]).

This section includes the following topics:

Subscription Data Collected

Non-billable Component Devices

Subscription Data Collected by SL1

With a subscription license, SL1 collects and sends billing data to ScienceLogic via secure Hypertext Transfer Protocol (HTTPS). During this collection, SL1 collects device configuration data and statistical metadata only; no specific performance collection data is included.

SL1 collects the following billing data from customer systems:

  • Device configuration data that is recorded per-device

NOTE:  ScienceLogic uses the data collected for each device to assign a license to the device. The rules that govern how licenses are assigned are based on your contract with ScienceLogic. Certain component devices do not count against your license usage in SL1. For more information, see the Non-billable Component Devices section.

  • System configuration data
  • Device statistics data that is recorded per-device and per-collection type and aggregated daily

Each device is categorized based on whether it is managed as infrastructure, is part of a managed application, or is part of a managed service.

The following table lists the specific data that is collected:

CollectionData Collected
Per SL1 System
  • ScienceLogic System Identifier
  • ScienceLogic Version
  • ScienceLogic Revision
  • DRBD Version
  • MySQL Version
  • Number of Organizations
  • Number of Users
  • Number of Applications
  • Number of Application Components
  • List of Dynamic Applications installed on each monitored device, with the following information included:
    • ID
    • GUID
    • Name
    • Version
    • PowerPack GUID
    • PowerPack Name
    • PowerPack Version
    • Number of Subscribers
  • Number of Configured Dashboards
  • Number of Scheduled Reports
  • Number of Asset Records
  • Number of each type of the following appliances:
    • Admin Portals
    • Database Servers
    • Data Collectors
    • Message Collectors
    • Compute Nodes
    • Storage Nodes
  • Number of Device Groups
  • Number of IT Services
  • Number of Business Services
  • Number of Device Services
  • Number of Automations triggered for the past 24 hours
  • Number of Automation Actions executed for the past 24 hours
  • Number of New Tickets Created
  • Number of New Event Instances
  • Number of Knowledge Base Articles
  • List of all installed PowerPacks with the following information per PowerPack:
    • GUID
    • Name
    • Version
    • Revision
    • Publisher
Per Device
  • Device ID
  • Organization ID
  • Device Name
  • Device Class with the following information per device class:
    • GUID
    • Name
    • Description
    • Device Category GUID
    • Device Category Name
  • Device Subscription Tier
  • Device Category
  • Interface Count
  • Merge/Component ID
  • Aligned Dynamic Applications
  • Number of Associated Applications
  • Number of Associated Business Services
  • Number of Associated IT Services
  • Number of Associated Device Services
  • Relationships with other devices
    • Relationship Type
    • Device Class for the device on the other end of the relationship

Certain component devices do not count against your license usage in SL1. For more information, see the Non-billable Component Devices section.

Non-billable Devices

Typically, any device that SL1 is monitoring will consume a ScienceLogic device license, regardless of whether it is a "Physical" device monitored via direct network polling, a 'Virtual" device with no network address of its own, or a "Component" device that was created in SL1 with a Dynamic Application or relationships between Dynamic Applications.

There are, however, some devices that do not consume device licenses. If you have a subscription license, the following devices do not count against your license usage in SL1:

  • Devices in a virtual collector group. Virtual collector groups do not perform collection on any devices aligned with them; they serve only as a means of storing historical data from those devices.
  • Devices assigned specific device classes. This includes SL1 appliances and logical component devices such as AWS Regions, VMware Folders, and so on. The latest list of non-billable devices is available on the ScienceLogic support portal.

Troubleshooting Subscription Billing

Download this manual as a PDF file

This section describes how to check the configuration of subscription billing data collected by SL1.

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

  • To view a pop-out list of menu options, click the menu icon ([Original reference image unavailable: menu icon]).
  • To view a page containing all the menu options, click the Advanced menu icon ([Original reference image unavailable: AdvancedMenu]).

This section includes the following topics:

Installing the Test Script

Running the Test Script

Error Message Remediation

Installing the Test Script

You can use the test_subscription.sh script to check the configuration of subscription billing on your system and test the connection to the Billing Server. This script is included in SL1 version 8.14.0 and later releases and requires no additional installation.

For 8.12 and earlier versions, you can obtain the test_subscription.sh file from Support. You must transfer the file manually to the current primary Database Server or All-In-One Appliance using an SCP tool, and move the file to the /opt/em7/bin directory.

Running the Test Script

To run the test_subscription.sh script:

  1. Connect to the console of the current primary Database Server or All-In-One Appliance as the admin user.
  2. Execute the following command. Enter the admin user password when prompted:

    sudo sh

  3. Execute the following command:

    /opt/em7/bin/test_subscription.sh

Error Message Remediation

The following table lists all possible error messages generated by the test_subscription.sh script, along with a description of possible causes and next steps:

Error MessageDescription
ERROR: Cannot connect to https://billing.sciencelogic.com

An HTTP request to the login page of https://billing.sciencelogic.com without user credentials failed.

Cause: The most likely cause is that the Database Server does not have internet access. If you have internet access from the Database Server, go to Next Steps.

Next Steps:

  • Test connections to other internet pages
  • Troubleshoot the network settings for the Database Server
  • Whitelist https://billing.sciencelogic.com in the your firewall configuration

Using an HTTP proxy is an option for the connection, if required.

ERROR: cred_id section missing from [SUBSCRIBER] in /etc/silo.conf

The cred_id option is not included in /etc/silo.conf.

Cause: The subscription billing process is not configured correctly.

Next Steps: For information about the required silo.conf configuration, see Editing Silo.conf for Subscription Billing.

ERROR: [SUBSCRIBER] section from /etc/silo.conf missing

The SUBSCRIBER section is not included in /etc/silo.conf.

Cause: The subscription billing process is not configured correctly.

Next Steps:  For information about the required silo.conf configuration, see Editing Silo.conf for Subscription Billing.

ERROR: Cannot login to https://billing.sciencelogic.com with the cred id username and password

An HTTP request to the login page of https://billing.sciencelogic.com with user credentials failed.

Cause: The username and password in the credential specified in the silo.conf file did not successfully authenticate on https://billing.sciencelogic.com.

Next Steps:

  • Verify the username and password listed for your services account on https:// iportal.sciencelogic.com.
  • If the credential is correct, attempt to log in to https://billing.sciencelogic.com manually with the credential.
  • If the manual login fails, open a Billing case for IT to check the issue.
  • If the manual login is successful, a networking issue might be the cause. Try the steps listed for the "ERROR: Cannot connect to https://billing.sciencelogic.com" entry.
ERROR: Cred type wrong for credential

The credential specified in the silo.conf configuration is not a SOAP/XML credential.

Cause: The subscription billing process is not configured correctly.

Next Steps: Create a SOAP/XML credential. For the required credential configuration, see Creating a Credential for the ScienceLogic Billing Server.

ERROR: Port not 443 for cred

The credential specified in the silo.conf configuration does not use port 443.

Cause: The port specified for the credential ID shown is incorrect.

Next Steps: Edit the credential to use port 443. For the required credential configuration, see Creating a Credential for the Sciencelogic Billing Server.

ERROR: https://billing.sciencelogic.com not found in cred

The credential specified in the silo.conf configuration file does not have the URL for the billing server.

Cause: The URL for the billing server ("https://billing.sciencelogic.com" ) is missing or incorrect.

Next Steps: For the credential ID shown, edit the credential and change the URL to "https://billing.sciencelogic.com". See Editing Silo.conf for Subscription Billing.

ERROR: Credential $cred not found

The credential specified in the silo.conf configuration does not exist.

Cause: The subscription billing process is not configured correctly.

Next Steps: For the required credential configuration, see Creating a Credential for the Sciencelogic Billing Server.

UHEs detected, please investigate

The system log contains unhandled exceptions for the subscription usage process.

Next Steps: Execute the following query for more details, and then follow the standard troubleshooting process for unhandled exceptions, escalating to Support as necessary:

select * from master_logs.system_messages where date_edit > date_sub(now(), interval 7 day) and message like '^153: Unhandled exception on appliance%';