Licensing and Configuring an Appliance

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.

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.

2. When prompted to enter your user name and password, log in as the "em7admin" user with the appropriate password.
3. After logging in, the main Configuration Utility page appears.

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 by navigating to https://<ip-address-of-appliance>:7700 and entering your credentials. 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.

4. Click Save.
5. 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

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.
2. Click the Licensing button. The Licensing Step 1 page appears.
3. In the Licensing Step 1 page, click the Generate a Registration Key button.
4. When prompted, save the Registration Key file to your local disk.
5. 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.

6. When you have the license for the All-In-One Appliance or Database Server, return to the Web Configuration Utility.
7. In the Licensing Step 2 page, click the Upload button to upload the license file.
8. 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.

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.

4. Click the Save button. You may now log out of the Web Configuration Utility.
5. In SL1, go to the Appliance Manager page (System > Settings > Appliances).
6. 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.

7. Click the Save button. If the save is successful, the message "Appliance Registered" appears.
8. 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.
9. 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

You do not need to use the Web Configuration Utility to configure and register a Data Collector or Message Collector. Instead, configuration and registration for SL1 Collectors occurs during their initial setup. The exact process varies based on which of the following connection types you are using:

Connection Type	Used For
Collector Initiates | System Accepts	Token-based PhoneHome Communication
Collector Initiates | User Accepts	Password/secret-based PhoneHome Communication
Database Initiates | System Accepts	Traditional Communication

Click the links in the table above to see instructions for configuring each connection type.

Other Initial Configuration Tasks

This section describes other initial configuration tasks you might need to complete when setting up a new SL1 system.

Configuring Logging for an SL1 System

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.

For full instructions on configuring logging in your SL1 system, see the section on Logging in SL1 Version 11.3.0 and Later.

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 by navigating to https://<ip-address-of-appliance>:7700 and entering your credentials. 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.
4. 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.
5. Paste that line above the first line that begins with server.
6. Replace the hostname portion of the line with the IP address or fully qualified domain name of your preferred time server.
7. You can delete the additional lines or leave them as additional time servers.
8. To save your changes, click Save and then close the modal window.
9. 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 from the Web Configuration Utility

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.

This section describes how to create bonded interfaces from the Web Configuration Utility. You can also do so using the Node Configuration Utility.

To create one or more bonded interfaces:

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 Interfaces button. The Interfaces page appears.
3. In the Interfaces page, click the Create a bonded interface button. The Create a Bonded Interface page appears.
4. 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 from the Appliance Manager Page

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.

This section describes how to create define a proxy server from the Appliance Manager page. You can also do so using the Node Configuration Utility.

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 the appropriate password.
4. After logging in, the main Configuration Utility page appears.
5. Click the Device Settings button. The Settings page appears.
6. 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.

7. Click Save.

Navigating the Node Configuration Utility

The Node Configuration 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 a proxy server
• Add or edit a bonded 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 the appropriate password.

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 by navigating to https://<ip-address-of-appliance>:7700/node-config and entering your credentials. The Configuration Utilities 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.

4. 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. Log in to the Node Configuration Utility by navigating to https://<ip-address-of-appliance>:7700/node-config and entering your credentials. The Configuration Utilities page appears.

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

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

This section describes how to configure a proxy server from the Node Configuration Utility. You can also do so using the Appliance Manager Page.

To configure a proxy server:

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

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

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

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

This section describes how to create bonded interfaces from the Node Configuration Utility. You can also do so using the Web Configuration Utility.

To add one or more bonded interfaces:

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

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

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

4. Select the Activate button if you want this interface to be activated after you add it.

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

6. 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. Log in to the Node Configuration Utility by navigating to https://<ip-address-of-appliance>:7700/node-config and entering your credentials. The Configuration Utilities page appears.

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

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

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

5. Click Save.