Licensing and Configuring an Appliance

Download this manual as a PDF file

This section describes how to license an SL1 appliance and add an SL1 appliance to your SL1 system.

There are two utilities you can use to perform various functions for the setup and editing of your SL1 appliance.

These two utilities include:

  • The Classic Web Configuration Utility (default)
  • The Node Configuration Application

Upon installation, SL1 appliances are automatically licensed for 90 days, with a capacity of 1,000 devices. During these 90 days, you can perform the steps to obtain a permanent license from ScienceLogic.

SL1 appliances automatically generate a Registration Key file. This file is used by ScienceLogic to generate a unique License Key file. You must not edit or alter the Registration Key file. While performing the steps described in this section, you must obtain a License Key file by providing the Registration Key file to ScienceLogic.

For distributed SL1 systems, you must license the Database Server first. All other SL1 appliances in a distributed SL1 system depend on the Database Server for registration. Be sure to license your appliances before using the latest release of SL1.

In SL1 version 11.2.0, the Licensing pages were removed from the Web Configuration Utility. However, this inadvertently caused several issues, including an inability to license Database Server and All-In-One Appliances and, in some cases, an inability to log in to the SL1 user interface.

The Licensing page was restored in SL1 version 11.3.1. If you are using a version between 11.2.0 and 11.3.1, you might still experience the above issues. If you do, contact ScienceLogic Support.

For more information, including if you get an "Appliance is not licensed" error message, see Knowledge Base article: https://support.sciencelogic.com/s/article/9617.

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 of the menu options, click the Advanced menu icon ().

Navigating the Classic Web Configuration Utility

The default utility application for configuring your appliance is the Classic Web Configuration Utility. This utility allows you to perform many different functions surrounding the configuration of your appliance.

In the Classic Web Configuration Utility, you can:

  • Configure an Administration Portal
  • Configure a Data Collector or Message Collector
  • Register the Data Collector or Message Collector with the Database Server
  • Define a Syslog, NTP, and/or Proxy Server(s)
  • Create a Bonded Interface

Logging into the Classic Web Configuration Utility

Perform the following steps to log in to the Web Configuration Utility:

  1. You can log in to the Web Configuration Utility using any web browser supported by SL1. The address of the Web Configuration Utility is in the following format:

    https://<ip-address-of-appliance>:7700

    For AWS instances, ip-address-of-appliance is the public IP for the AWS instance. To locate the public IP address for an AWS instance, go to AWS, go to the Instances page, and highlight an instance. The Description tab in the lower pane will display the public IP.

  1. When prompted to enter your user name and password, log in as the "em7admin" user with either the default password of em7admin or the password you configured.
  2. After logging in, the main Configuration Utility page appears.

In SL1 version 11.2.0, the Licensing pages were removed from the Web Configuration Utility. However, this inadvertently caused several issues, including an inability to license Database Server and All-In-One Appliances and, in some cases, an inability to log in to the SL1 user interface.

The Licensing page was restored in SL1 version 11.3.1. If you are using a version between 11.2.0 and 11.3.1, you might still experience the above issues. If you do, contact ScienceLogic Support.

For more information, including if you get an "Appliance is not licensed" error message, see Knowledge Base article: https://support.sciencelogic.com/s/article/9617.

Changing the Password for the Classic Web Configuration Utility

If you want to change the password for the Web Configuration Utility on all SL1 appliances, you must log in to the Web Configuration Utility on each node or appliance and perform the steps in this section.

You cannot change the username for the Web Configuration Utility. The username remains em7admin.

To change the password for the Web Configuration Utility:

  1. Log in to the Web Configuration Utility. The Configuration Utilities page appears.
  2. Click the Device Settings button. The Settings page appears.
  3. In the Settings page, type the following:
  • Web Config Password (change only). Type the new password.
  • Confirm Web Config Password. Type the new password again.
  1. Click Save.
  2. Perform steps 1-4 for each node or appliance for which you want to change the password for the Web Configuration Utility.

Licensing and Configuring a Database Server or All-In-One Appliance

In SL1 version 11.2.0, the Licensing pages were removed from the Web Configuration Utility. However, this inadvertently caused several issues, including an inability to license Database Server and All-In-One Appliances and, in some cases, an inability to log in to the SL1 user interface.

The Licensing page was restored in SL1 version 11.3.1. If you are using a version between 11.2.0 and 11.3.1, you might still experience the above issues. If you do, contact ScienceLogic Support.

For more information, including if you get an "Appliance is not licensed" error message, see Knowledge Base article: https://support.sciencelogic.com/s/article/9617.

You must perform the following steps in the Web Configuration Utility to license an All-In-One Appliance or Database Server:

  1. Log in to the Web Configuration Utility by navigating to https://<ip-address-of-appliance>:7700 and entering your credentials. The Configuration Utilities page appears.

  1. Click the Licensing button. The Licensing Step 1 page appears.

The Licensing page step 1

  1. In the Licensing Step 1 page, click the Generate a Registration Key button.
  2. When prompted, save the Registration Key file to your local disk.
  3. Log in to the ScienceLogic Support Site (https://support.sciencelogic.com).
  • Click your user name and from the menu select My  Support and Customer Success.
  • On the next page, click the Submit a License Request button.
  • Fill out the Appliance Information form and click the Submit License Request button.
  • In the Upload Appliance Registration Key field, click the Upload Files button and navigate to the file where you saved the Registration Key file.
  • ScienceLogic Customer Support will generate a license for the All-In-One Appliance or Database Server.

  1. When you have the license for the All-In-One Appliance or Database Server, return to the Web Configuration Utility.
  2. In the Licensing Step 2 page, click the Upload button to upload the license file.
  3. After navigating to and selecting the license file, click the Submit button to finalize the license. If the license key is correct and has been saved successfully, the message "Success: Thank you for licensing your ScienceLogic product!" appears.

Configuring an Administration Portal

You must perform the following steps in the Web Configuration Utility to configure an Administration Portal:

  1. Log in to the Web Configuration Utility by navigating to https://<ip-address-of-appliance>:7700 and entering your credentials. The Configuration Utilities page appears.

  2. Click the Device Settings button in the upper-right of the page. The Settings page appears.

    The Device Settings page

  3. On the Settings page, enter the following:

  • Database IP Address. The IP address(es) of the primary ScienceLogic Database Server(s). If this is a High Availability or Disaster Recovery (HA/DR) system, use the Virtual IP address in this field.
  • For an All-In-One Appliance with multiple Administration Portals, enter the IP address for the All-In-One Appliance.
  • If the Administration Portal and Database Server are AWS instances, supply the private IP address for the Database Server. To find the private IP of an AWS instance, go to AWS, go to the Instances page, and highlight an instance. The Description tab in the lower pane will display the private IP.
  • Database Username. Username for the database account that the Administration Portal will use to communicate with the Database Server.
  • Accept the default values in all other fields.

  1. Click the Save button. You may now log out of the Web Configuration Utility.
  2. In SL1, go to the Appliance Manager page (System > Settings > Appliances).
  3. Supply values in the following fields:

  • Host Name. Enter the hostname of the Administration Portal, where relevant.
  • IP Address. Enter the IP address of the Administration Portal. If this is a High Availability or Disaster Recovery (HA/DR) system, use the Virtual IP address in this field. If the Administration Portal is an AWS instance, supply the private IP address for the Administration Portal. To find the private IP of an AWS instance, go to AWS, go to the Instances page, and highlight an instance. The Description tab in the lower pane will display the private IP.
  • Model Type. Select Administration Portal [3] from the drop-down list.
  • Description. Enter a description of the Administration Portal. This field is optional.

  1. Click the Save button. If the save is successful, the message "Appliance Registered" appears.
  2. If you are using an AWS RDS system, select the wrench icon () for the newly created Administration Portal. Supply values in the DB User field and the DB Password field.
  3. If all information is valid and the Database Server can communicate with the Administration Portal , the appliance page will display "Yes" in the Validated column. If the Validated column displays "No" for longer than five minutes, double-check your settings and network connection.

Configuring a Data Collector or Message Collector

NOTE: The instructions for configuring a Data Collector or Message Collector for PhoneHome configuration differ from the instructions in this section. For details on configuring a Data Collector or Message Collector for PhoneHome configuration, see the section on PhoneHome.

If you are configuring a Data Collector or a Message Collector using SL1 version 11.2.0 or later, skip the procedures in this section and go to Installing and Configuring an SL1 Collector.

You must perform the following steps in the Web Configuration Utility to configure a Data Collector or a Message Collector:

  1. Log in to the Web Configuration Utility on the Data Collector or the Message Collector. The Configuration Utilities page appears.

  1. Click the Device Settings button. The Settings page appears.

The Device Settings page

  1. In the Settings page, update the following field:
  • Database IP Address. The IP address of the ScienceLogic Database Server(s). If more than one Database Server will manage this appliance, type the IP addresses of the Database Servers, separated by commas. If the Data Collector or the Message Collector and the Database Server are AWS instances, supply the private IP address for the Database Server. To find the private IP of an AWS instance, go to AWS, go to the Instances page, and highlight an instance. The Description tab in the lower pane will display the private IP.
  1. Click the Save button. You may now log out of the Web Configuration Utility.
  2. Perform these steps for each Data Collector and Message Collector in your PhoneHome configuration.

Registering the Data Collector or Message Collector with the Database Server

After configuring a Data Collector or Message Collector in the Web Configuration Utility, you must register the appliance with the main Database Server in your SL1 system.

To register a Data Collector or Message Collector with the main Database Server, perform the following steps:

  1. In the address bar of your browser, type the IP address of the SL1 appliance that provides the user interface for your SL1 system. The user interface is provided by either the Database Server or an Administration Portal. The login screen appears.

  1. Log in as the "em7admin" user with the password "em7admin".
  2. If this is your first successful login, you will be asked to agree to the End-user License Agreement. Read the End-user License Agreement then click the I Agree to The Terms Outlined Above button.

  1. Go to the Appliance Manager page (System > Settings > Appliances):

The Appliance Manager page

  1. Supply values in the following fields:
  • Host Name. Enter the hostname of the Data Collector or Message Collector.
  • IP Address. Enter the IP address of the Data Collector or Message Collector. If the Data Collector or the Message Collector are AWS instances, supply the private IP address for the Data Collector or the Message Collector. To find the private IP of an AWS instance, go to AWS, go to the Instances page, and highlight an instance. The Description tab in the lower pane will display the private IP.
  • Model Type. If you are configuring a Data Collector, select Data Collection Unit [5] from the drop-down list. If you are configuring a Message Collector, select Message Collection Unit [6] from the drop-down list.
  • Description. Enter a description for the Data Collector or Message Collector. This field is optional.

  1. Click the Save button. If the save is successful, the message "Appliance Registered" appears.
  2. If you are using an AWS RDS system, select the wrench icon () for the newly created Data Collector or Message Collector. Supply values in the DB User field and the DB Password field.

The Editing Appliance section of the Appliance Manager page

  1. If all information is valid and the Database Server can communicate with the Data Collector or Message Collector, the appliance page will display "Yes" in the Validated column. If the Validated column displays "No" for longer than five minutes, double-check your settings and network connection.

Defining the Syslog Server

This method of defining the syslog server was deprecated in SL1 version 11.3.0 and later. For more information on the new method of defining the syslog server, see Logging in SL1 Version 11.3.0 and Later.

For each device except for Message Collectors and All-In-One Appliances, you must specify the IP address of the server to which the SL1 appliance will send syslog messages. Enter the IP address of the syslog server that will monitor this SL1 appliance. Usually, this is the IP address of a Message Collector, Data Collector, or All-In-One Appliance.

NOTE: A device configured with Transport Layer Security (TLS) support for an rsyslog server can successfully exchange messages with a SL1 appliance configured with TLS support for an rsyslog client.

To specify the syslog server:

  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 password you configured during setup.
  3. Install the required Transport Layer Security (TLS) certificates by typing the following lines at the shell prompt:

mkdir -pv /etc/rsyslog.d/keys/ca.d

cd /etc/rsyslog.d/keys/ca.d/

NOTE: You might need to create a ca.d directory to contain the certificates needed for TLS encryption.

  1. To define the syslog server, type the following at the shell prompt:

sudo vi /etc/rsyslog.d/siteconfig.conf

  1. On a line of its own, add the following entry:

facility.priority@ip address of syslog server

where:

  • facility specifies a valid facility value. These categories provide a general description of the originator of the message.
  • priority specifies a valid priority value. These values specify severity.
  • ip address of syslog server specifies the IP address of the syslog server that will monitor this SL1 appliance, usually a Data Collector or Message Collector.

NOTE: For details on valid facility and priority values, see https://docs.oracle.com/cd/E37670_01/E36387/html/ol_log_sec.html.

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

sudo service rsyslog restart

  1. Repeat steps 1-7 on each SL1 appliance in your system.

Defining the NTP Server

By default, SL1 uses the time servers in the Red Hat Linux pool of time servers. If you want to use a different time server, you can edit the configuration files for the time server.

From the Device Settings page of the Web Configuration Utility, you can edit the following time server files:

  • chrony.d/servers.conf. This configuration file contains additional settings for the various chrony time servers.
  • chrony.conf. This configuration file contains settings related to the time server (chrony.d) used by SL1.

To configure a time server file:

  1. Log in to the Web Configuration Utility. The Configuration Utilities page appears.
  2. Click the Device Settings button. The Settings page appears.
  3. In the Edit Files section, click chrony.d/servers.conf. The Chrony.d/servers.conf Editor modal appears:

The Chrony.d/servers.conf Editor modal page

  1. In the Chrony.d/servers.conf modal page, copy the first line that begins with server, such as server 0.rhel.pool.ntp.org iburst maxpoll 10.
  2. Paste that line above the first line that begins with server.
  3. Replace the hostname portion of the line with the IP address or fully qualified domain name of your preferred time server.
  4. You can delete the additional lines or leave them as additional time servers.
  5. To save your changes, click Save and then close the modal window.
  6. If you need to configure the time server (chrony.d) used by SL1, click chrony.conf in the Edit Files section of the Settings page.

Creating a Bonded Interface

A bonded interface (also known as port trunking, channel bonding, link aggregation, and NIC teaming) allows you to combine multiple network interfaces (called "slave interfaces") into a single logical interface (called a "master interface"). A bonded interface can:

  • increase available bandwidth
  • provide redundancy

To the operating system, a bonded interface appears as a normal network interface. However, the bonded interface uses a round-robin protocol to assign network traffic to the slave interfaces that make up the bonded interface.

To create one or more bonded interfaces:

  1. Log in to the Web Configuration Utility. The Configuration Utilities page appears.

  1. Click the Interfaces button. The Interfaces page appears.

The Interfaces page

  1. In the Interfaces page, click the Create a bonded interface button. The Create a Bonded Interface page appears.

The Create a Bonded Interface page.

  1. In the Create a Bonded Interface page, enter the following:
  • Device ID. Required. ID for the bonded interface. Enter a string with the format:

bondN

 

where N is a number. For example, you could enter bond0, bond1, or bond64.

If the device ID already exists in the SL1 System, the SL1 system will display an error message.

  • Name. Required. Enter a user name for the bonded interface.
  • Interface IP Address. Required. Enter the IP address for the bonded interface in standard IPv4, dotted-octet format.
  • Netmask IP Address. Required. Enter the netmask for the bonded interface in standard IPv4, dotted-octet format.
  • Slave Interfaces. Required. Select one or more interfaces from the list of available interfaces. The selected interfaces will be used by the new bonded interface.
  • DNS1. Optional. Enter the IP address of the DNS server that the bonded interface will use. Enter the IP address in standard IPv4, dotted-octet format.
  • Gateway IP Address. Optional. Enter the IP address of the gateway device or router that the bonded interface will use. Enter the IP address in standard IPv4, dotted-octet format.
  • IPv6 Address. Optional. Enter the IP address for the bonded interface, in IPv6 format.
  • Bonding Options. Optional. You can enter one or more bonding options. For each option, enter the name of the option in the key field and the value in the value field.

For details on bonding options, see the Red Hat documentation on Bonding Interface Parameters: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/sec-Specific_Kernel_Module_Capabilities.html#s3-modules-bonding-directives

Defining a Proxy Server

A proxy server enables SL1 appliances to get system updates when the appliance does not have a direct connection to the internet. A proxy server also enables ScienceLogic Database Servers to send subscription licensing data to ScienceLogic.

Each SL1 appliance can define its own proxy server.

To define a proxy server:

  1. Go to the Appliance Manager page (System > Settings > Appliances).
  2. Find the appliance for which you want to define a proxy server. Click its toolbox icon ().
  3. When prompted to enter your username and password, log in as the "em7admin" user with either the default password of em7admin or the password you configured.
  1. After logging in, the main Configuration Utility page appears:

The Configuration Utilities page

  1. Click the Device Settings button. The Settings page appears.

The Settings page displaying the Configure Proxy Server section

  1. Enter values in the following fields:
  • Server URL. Type the URL of the proxy server. For example, "http://10.2.12.51".
  • Port. Type the port on the proxy server to which the SL1 appliance will talk.
  1. Click Save.

Navigating the Node Configuration Utility

The Node Configurition Utility is the other utility application you can use to configure and edit your SL1 appliance.

In the Node Configuration Utility, you can:

  • View the Collector Connection Status
  • Configure the Proxy Server
  • Add and edit a Bonding Interface

Logging into the Node Configuration Utility

Perform the following steps to access the Node Configuration Utility:

  1. You can log in to the Node Configuration Utility using any web browser supported by SL1. The address of the Node Configuration Utility is in the following format:

    https://<ip-address-of-appliance>:7700/node-config

    For AWS instances, ip-address-of-appliance is the public IP for the AWS instance. To locate the public IP address for an AWS instance, go to AWS, go to the Instances page, and highlight an instance. The Description tab in the lower pane will display the public IP.

  2. When prompted to enter your user name and password, log in as the "em7admin" user with either the default password of em7admin or the password you configured.

  3. After logging in, the main Node Configuration Utility home page appears:

Changing the Password for the Node Configuration Utility

If you want to change the password for the Node Configuration Utility on all SL1 appliances, you must log in to the Node Configuration Utility on each node or appliance and perform the steps in this section.

You cannot change the username for the Node Configuration Utility. The username remains em7admin.

To change the password for the Node Configuration Utility:

  1. Log in to the Node Configuration Utility. The Configuration Utilities home page appears.
  2. Click the drop-down arrow icon next to the username credential in the top-right corner and select Change Password.
  3. On the Change Password page, type the following:
  • Current Password. Type the current password.
  • New Password. Type the new password.
  • Confirm New Password. Type the new password again.
  1. Click Change Password.

Viewing the Collector Connection Status

You can view the connection status for a Data Collector from multiple places in the Node Configuration Utility. You can view connection details for both the Collector and the Database Server in the utility.

To view the collector connection status:

  1. Click the Connection icon located in the left-side navigation menu of the Node Configuration Utility. The Collector Connection Status page appears:.

  1. From this page, you can perform a few functions. You can:

  • Click Refresh Status to troubleshoot your collector's connection.

  • Click Disconnect & Clear Configuration to close the outgoing connection from this collector to all configured destinations. It will also clear all local configurations. A warning prompt will appear that asks you to confirm your action.

You can also access the Collector Connection Status page from the Node Configuration home page by clicking View Connection Details on the home page.

Configuring the Proxy Server from the Node Configuration Utility

A proxy server enables SL1 appliances to get system updates when the appliance does not have a direct connection to the internet. A proxy server also enables ScienceLogicDatabase Servers to send subscription licensing data to ScienceLogic.

Each SL1 appliance can configure its own proxy server.

To configure a proxy server:

  1. Click the Settings icon located in the left-side navigation menu of the Node Configuration Utility.

  1. Enter values in the following fields:
  • Server URL. Type the URL of the proxy server. For example, "http://10.2.12.51".
  • Port. Type the port on the proxy server to which the SL1 appliance will talk.
  1. Click Save.

Adding a Bonded Interface from the Node Configuration Utility

A bonded interface, which is also known as port trunking, channel bonding, link aggregation, and NIC teaming, allows you to combine multiple network interfaces (called "slave interfaces") into a single logical interface (called a "master interface").

To the operating system, a bonded interface appears as a normal network interface. However, the bonded interface uses a round-robin protocol to assign network traffic to the slave interfaces that make up the bonded interface.

To add one or more bonded interfaces:

  1. Click the Interfaces icon located in the left-side navigation menu of the Node Configuration Utility. The Interfaces page appears.

  1. Click Add Bonding Interface. The Add Bonding Interface page appears.

  1. Select the Activate button if you want this interface to be activated after you add it.
  2. Complete the following fields:
  • Name. Required. Enter a user name for the bonded interface.
  • Device ID. Required. ID for the bonded interface.
  • Interface IP Address. Required. Enter the IP address for the bonded interface in standard IPv4, dotted-octet format.
  • Netmask IP Address. Required. Enter the netmask for the bonded interface in standard IPv4, dotted-octet format.
  • DNS. Optional. Enter the IP address of the DNS server that the bonded interface will use. Enter the IP address in standard IPv4, dotted-octet format.
  • Gateway IP Address. Optional. Enter the IP address of the gateway device or router that the bonded interface will use. Enter the IP address in standard IPv4, dotted-octet format.
  • IPv6 Address. Optional. Enter the IP address for the bonded interface, in IPv6 format.
  • Choose Bonded Interface. Select your bonded interface from the drop-down list.
  • Bonding Options. Optional. You can enter one or more bonding options. For each option, enter the name of the option in the key field and the value in the value field.
    Click Add Another Option for the addition of multiple bonding options.
  1. Click Save.

For details on bonding options, see the Red Hat documentation on Bonding Interface Parameters: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/sec-Specific_Kernel_Module_Capabilities.html#s3-modules-bonding-directives

Editing an Interface from the Node Configuration Utility

You can also edit an already existing bonded interface from the Node Configuration Utility.

  1. From the Interfaces page, click the ellipses icon () located in the column to the right of your bonded interface.

  1. Click Edit. The Interface Configuration window appears for editing.

  1. Complete the Interface, IP Address, Configuration, and Network fields as needed for your interface.

  2. Click Save.