Installing and Configuring an SL1 Collector

This section describes how to download and install an SL1 Collector, and how to establish a connection between the new SL1 Collector and the SL1 Database Server on the SL1 Nodes page. An SL1 Collector can be either a Data Collector or a Message Collector.

The Nodes page and the Node Configuration Utility replace functionality previously found in the Web Configuration utility in versions of SL1 prior to version 11.2.0.

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

Prerequisites

Before installing and configuring an SL1 Collector in your ScienceLogic environment, you must:

• Have SSH access or console access to each Database Server
• On each ScienceLogic appliance, know the username and password for access to the console.
• On each ScienceLogic appliance, know the username and password for access to the console. Please note that the mysql password gets set using the same password that was set during the ISO installation as the "system" password, so the mysql password matches the login password for SL1 (unless one or both of the passwords were manually changed after the installation). 
• Ensure that the Database Server opens a port for PhoneHome communication. The default port for this is 7705, but you can use other ports if you are not on a SaaS system.
  

Workflow for Installing and Configuring an SL1 Collector

The typical workflow for installing and configuring an SL1 Collector includes the following steps:

1. For existing PhoneHome configurations only: Configure the PhoneHome Database Server. Complete this step only if you are currently using PhoneHome communication with your SL1 Collectors, and you are upgrading to SL1 version 11.2.0 or later from an earlier version of SL1.

   • If you use a proxy in your PhoneHome configuration, perform the steps in the proxy section before configuring the other steps in the PhoneHome configuration.
   • For more information about PhoneHome communication, see Configuring SL1 for PhoneHome Communication.

2. Download the ISO image containing the SL1 Collector. The ISO includes the Database Server, Administration Portal, and Data Collectors.

3. Use the ISO to install the Database Server and Administration Portal, if they are not already installed.

4. Use the ISO to install an SL1 Collector.

5. Update the new SL1 Collector to the same version of SL1 that the Database Server is running, if applicable.

6. Configure a new SL1 system for communication, if applicable.

7. Configure the new SL1 Collector to communicate with the SL1 Database Server.

Configuring the PhoneHome Database Server (for Existing PhoneHome Configurations Only)

If you are using a new SL1 system or a system that has not previously used PhoneHome communication for collectors, you can skip this section.

When upgrading to SL1 version 11.2.0, a pre-upgrade test in the system update procedure checks for existing PhoneHome Database Servers. Specifically, this test looks for PhoneHome token IDs inside the /home/phonehome0/config.json file, and fails if the value of the id field is less than or equal to "0".

In versions of SL1 prior to version 11.2.0, the primary PhoneHome Database Server was not self-registered with a token, causing it to have an id value of "0".

Therefore, if you are currently using a version of SL1 prior to version 11.2.0 and you are using PhoneHome communication with your SL1 Collectors, you or your SL1 administrator must complete the following one-time manual configuration steps prior to upgrading to version 11.2.0 .

Do not attempt to upgrade to SL1 version 11.2.0 until all pre-upgrade tests are successful on all PhoneHome Database Servers.

For more information and configuration steps, see Configuring SL1 for PhoneHome Communication.

To register a token for your primary PhoneHome Database Server:

1. Log in to the console of the Database Server or use SSH to access the server.

2. To determine if your PhoneHome Database Server is registered, type the following command and locate its id value:

   cat /home/phonehome0/config.json

3. If a PhoneHome Database Server has an id value of "0", type the following command and locate the id of the current appliance:

   phonehome status

4. Type the following command and locate the PhoneHome token:

   phonehome token <id from step 3>

5. Type the following command to register the PhoneHome token:

   phonehome register <token from step 4>

6. Repeat steps 2-5 for all PhoneHome Database Servers that have an id value of "0".

7. Type the following command to ensure that all of your PhoneHome Database Servers are synced:

   phonehome sync

8. Repeat step 2 and confirm that all Database Servers have id values greater than "0".

After you have downloaded but not yet installed the ISO, you can also go to the System Updates page (System > Tools > Updates) and check the Preupgrade Status column to determine if the upgrade has successfully passed the pre-upgrade test. If the Preupgrade Status is Incomplete, click the magnifying glass icon () to determine which appliance is failing during the pre-upgrade test. Do not install the upgrade until the Preupgrade Status status displays as Complete.

Downloading the ISO Image Containing the SL1 Collector

The following ISO installation steps do not affect the performance of the SL1 system. ScienceLogic recommends that you perform these steps at least 3 days before upgrading.

To download the ISO image:

1. Log in to the ScienceLogic Support site at https://support.sciencelogic.com/s/ using your ScienceLogic customer account and password to access the site.
2. Select the Product Downloads menu and choose Platform. The Platform Downloads page appears.
3. Click the name of the SL1 version you want to download. The Release Version page appears.
4. Click the link for the "Product Image" you want to download and scroll to the bottom of the page. The Release File Details page appears.
5. Click the Download File button for the ISO file to download the file to your local computer.

Installing an SL1 Collector

In SL1 version 12.1.0, a new Oracle Linux 8 (OL8)-compatible installation wizard was added to the SL1 ISO file. All new SL1 12.1.0 installations from the ISO file will include OL8 by default.

After you deploy the ISO version of SL1 12.1.0, you might get an "Appliance is not licensed" message on the login page. This situation only occurs if you use another tab or browser to log in to the SL1 environment after deployment. If you use the same browser or tab that you used for the deployment, the user interface will be available.

Before you can install the SL1 Collector, you will need to use the ISO to install the SL1 Database Server if it is not already installed.

After installing the Database Server, you can then install:

1. The Administration Portal (if applicable)
2. The Data Collectors
3. The Message Collectors (if applicable)

You can use the following instructions to build the Administration Portal, and one or more Data Collectors and Message Collectors.

To install an SL1 Collector:

1. Boot the collector from the SL1 ISO.
2. Select Install EM7. The Model Type window appears.
3. Select Collector or Message Collector and then select Continue.
4. After the installer for the collector is loaded, the Network Configuration window appears.
5. Enter the following information:

• IP Address. Type the primary IP address of the collector.
• Netmask. Type the netmask for the primary IP address of the collector.
• Gateway. Type the IP address for the network gateway.
• DNS Server. Type the IP address for the primary Nameserver.
• Hostname. Type the hostname for the collector.

7. Select Continue. The System Password window appears.
8. Type the password for the em7admin user on the operating system and select Continue.
9. Type the password for the em7admin user again and select Continue.
10. If you are using a VMware instance, after the collector reboots, follow the instructions to install VMware tools.
11. After you install the SL1 Collector, upgrade the collector if needed to make sure the collector is running the same version of SL1 that the Database Server is running. Then you can connect the new collector with the SL1 Database Server.

Configuring a New SL1 System for Communication

If you are using a new SL1 system or a system that has not previously used PhoneHome communication for collectors, you or your SL1 administrator will need to configure each Database Server in the SL1 system to accept these connections.

For more information about PhoneHome communication in previous releases, see Configuring SL1 for PhoneHome Communication.

To enable communication between each Database Server and the new collector:

1. Log in to the console of the Database Server or use SSH to access the server:

   ssh em7admin@<IP_address_of_Database_Server>

2. Run the following command to ensure that the collector can reach the IP address of the Database Server, which typically involves the use of port 7705:

   sudo phonehome setup -a "<IP_address_of_Database_Server>:<port_number>" -n "<name_of_Database_Server>"

   If setup succeeds, a message like the following displays: New database with id 2 successfully added.

After configuring communication between a Database Server and a collector, you can go to the console of the SL1 Collector or Database Server and run the following commands to view more information about your servers and collectors:

• To view a list of all PhoneHome Database Servers and collectors, including the addresses for the Database Server and the remote IP address corresponding to the collectors, run the following command:

  phonehome list

• To view a list of only the Database Servers:

  phonehome destination list

• To view information about a specific PhoneHome Database Server:

  phonehome destination list --id <id>

  where <id> is the PhoneHome device ID for the Database Server.

• To view information about the PhoneHome configuration of a specific Database Server or SL1 Collector:

  phonehome view <id>

  where <id> is the PhoneHome device ID for the Database Server or SL1 Collector.

• To ensure that the PhoneHome service is active on the Database Server and view additional configuration information about the server:

  systemctl status phd.service

• To view the status of the PhoneHome service on the Database Server or SL1 Collector:

  phonehome status

• If the PhoneHome service is disconnected on a Database Server or SL1 Collector and you want to start it:

  systemctl start phc

For more information about other PhoneHome-related commands, see Using the Command-Line Interface for PhoneHome Collection in SL1 Version 11.2.0 and Later.

Configuring a New SL1 Collector

After you install an SL1 Collector, use the Add Node wizard on the Nodes page (Manage > Nodes) to register the collector so that it can communicate with the SL1 Database Server to share its collected data. Part of the setup takes place in the Node Configuration Utility, which has its own user interface separate from the SL1 user interface.

The Nodes page and the Node Configuration Utility replace some of the functionality previously found in the Web Configuration Utility in versions of SL1 prior to version 11.2.0.

Depending on the type of connection you select in the Add Node wizard, communication between the SL1 Collector and the SL1 Database Server works in one of the following ways:

• The SL1 Collector initiates an outbound connection to the Database Server over SSH. Requests originate from edge to core via TCP, using port 7705 by default.

  Please note that allow-listing port 7705 in the firewall is not enough. If the firewall does a layer 7 (application layer) filtering, you must create an exception rule to allow any outgoing traffic from the collector to all the Database Servers on the control port, which is port 7705 by default. Some firewalls enable this by default and, as a result, those firewalls will drop SSH traffic on a non-standard port like 7705 in this situation.

  Access must be permitted from the trusted to the untrusted network. Each Data Collector is aligned with an SSH account on the Database Server and uses SSH to communicate with the Database Server. The benefits of this method are that no ingress firewall rules need to be added as the collector initiates an outbound connection, and no new TCP ports are opened on the network that contains the Data Collectors. Please note that starting with SL1 version 12.1.0, custom firewall rules must use the rich rules syntax and added to /etc/siteconfig/firewalld-rich-rules.siteconfig.

  This method was called the "PhoneHome" method in versions of SL1 prior to version 11.2.0. In the Add Node wizard, the "Collector Initiates | System Accepts" and "Collector Initiates | User Accepts" options use this communication method.

• The SL1 Database Server initiates communication with each SL1 Collector over an open TCP port. The connection request traverses the network, including the Internet if necessary, eventually reaching the collector. For this approach to work, the collector administrator must allow ingress communication from the Database Server on port 7707 (the MariaDB port on the collector). The communication is encrypted using SSL whenever possible. The benefit of this method is that communication to the Database Server is extremely limited, so the Database Server remains as secure as possible.

  This method was called the "Traditional" method in previous versions of SL1. In the Add Node wizard, the "Database Initiates | System Accepts" option uses this communication method.

Connecting an SL1 Collector to the SL1 Database Server

The Add Node wizard on the Nodes page in SL1 lets you configure your new SL1 Collector so that SL1 can register the SL1 Collector, connect it to the SL1 Database Server, and align it to a new or existing Collector Group. 

All connection types require a token that SL1 generates as part of the wizard. A token is a JSON web token (JWT) that contains a set of secure data that SL1 uses to establish communication between the new SL1 Collector and the SL1 Database Server.

You access the Add Node wizard by clicking Add Nodes on the SL1 Nodes page (Manage > Nodes). The Choose Connection Type window of the Add Node wizard appears.

Depending on your user permissions, you might not see all three connection type options on this window.

The following topics cover how to set up the three different connection types:

• Collector Initiates | System Accepts (Token-based PhoneHome)
• Collector Initiates | User Accepts (Token-less PhoneHome)
• Database Initiates | System Accepts (Traditional)

If you have used PhoneHome Communication with SL1 in previous releases, the connection types map as follows:

SL1 version 11.2.0 and later	Previous releases of SL1
Collector Initiates | System Accepts	Token-based PhoneHome Communication
Collector Initiates | User Accepts	Token-less PhoneHome Communication (using the Web Configuration Utility)
Database Initiates | System Accepts	Traditional

Collector Initiates | System Accepts

To register and connect an SL1 Collector with the Collector Initiates | System Accepts option (a "token-based PhoneHome Communication" collector type):

1. On the Registered tab on the Nodes page (Manage > Nodes), click Add Nodes. The Choose Connection Type window of the Add Node wizard appears.

2. Select Collector Initiates | System Accepts and click Next. The Define Collector Properties window appears.

3. Complete the following fields as needed:

• Collector Name. Type the name the collector used when registering the collector. SL1 will update this value with the collector hostname.

• Collector IP Address or Hostname. Type the IP address or the hostname of the collector. This information is optional but recommended, as it is used in Step 3 of the wizard to create a link to the collector's Node Configuration Utility, where you will input the token you generate.

• Collector Description. Type a description of the collector. This field is optional.

• Collector Group. The new collector must be aligned to an SL1 Collector Group. You have the following options for this field: 

  • Select an existing Collector Group from the drop-down.
  • Create a new Collector Group for the collector by clicking the plus icon (+). On the Add Collector Group modal, you can name the new group and choose to make that Collector Group available to all current and future organizations. You can also limit the Collector Group to specific organizations.
    
    The All current and future organizations toggle is enabled by default. If you want to limit Organization access to the new Collector Group, disable this toggle and select the organization or organizations from the drop-down.

• Collector Type. Your options include: 

  • Data Collector. This is the most commonly used type. A Data Collector retrieves a specific set of information from monitored devices. A Data Collector can also work as a Message Collector.
  • Message Collector. A Message Collector receives and processes inbound, asynchronous syslog and trap messages from monitored devices.

4. Click Generate Token. The Configure Collector window appears.

   You can go back to a previous step at any point in the wizard, but when you click the Generate Token button, SL1 always generates a new token. You cannot retrieve this particular token if you close the Add Node wizard. The generated token expires after 30 minutes.

5. In the Token field, click the Copy icon () to copy the token .

6. Open the Node Configuration Utility by clicking the Open icon () in the Node Configuration Utility field. The login page for the Node Configuration Utility opens in a new browser window.

   If you did not specify an IP address or a hostname in step 2 of this wizard, you will need to open a new browser window and type the IP address or hostname for the collector, followed by ":7700/node-config", such as "https://10.1.1.100:7700/node-config".

   If the node type is not a collector, the Node Configuration Utility will display the following message: "This page will only be visible if you are on a collector."

7. Log in to the Node Configuration Utility using the same username and password that you used when you installed the collector. After you log in, the collector and the SL1 Database Server attempt to connect. The connection will fail, which is expected. The Connect Collector page appears with an empty Paste token text field.

8. Paste the token you copied in step 6 in the Paste token field.

   If you did not generate a token, you can click Manual Entry, select User Accepted Connection Request, and add the IP addresses for the Database Servers (CMDBs) in the text box.

9. After pasting the token, click Register or Register Database, based on your choices in the previous step. When the connection is made, a Success dialog states that the collector was registered and the connection to the database was initiated.

10. Click OK on the Success dialog. he Collector Connection Status page displays details about the collector and the Database Server, along with the connection state, which can be "Connected", "Not Connected", or "Unknown". "Unknown" indicates that SL1 has not yet completed its first check of the connection state; click Refresh Status after a few moments and the status should update to "Connected".

11. On the Collector Connection Status page, click the expand icon () to view the connection path. The health of each hop in the connection is reported separately, but hops after an unresponsive hop will not be checked. This "Connection Path" information can be useful in diagnosing collector-database connection issues.

12. To view any changes to the connection status, click Refresh Status.

    If you want to disconnect the collector and close the SSH tunnel between the collector and the Database Server, click Disconnect & Clear Configuration. This action will close the outgoing connection from the collector to all configured destinations, and it will also clear all local configuration. This action cannot be undone.

13. Close the Node Configuration Utility.

14. In SL1, go to the Registered tab on the Nodes page, where you can now see the new collector in the list, aligned with the Collector Group you specified in the Add Node wizard. The new collector also displays on the Appliance Manager page (System > Settings > Appliances).

15. On Step 3 of the Add Node wizard, click See Pending Requests. The Pending tab on the Nodes page appears with the pending request.

16. Select the Actions icon () next to the pending request for the new collector and select Accept. The Accept Request dialog appears.

17. Paste the six-digit confirmation code from the Connect Collector page of the Node Configuration Utility and click Validate. The Configure Collector dialog displays a summary of the collector information you entered in the Add Node wizard.

18. Edit the collector information and collector group as needed, and then click Save. The Configure Collector dialog displays a summary of your information.

19. Click OK. The Registered tab on the Nodes page displays the new collector, aligned with the collector group you specified. The new collector also displays on the Appliance Manager page (System > Settings > Appliances).

Collector Initiates | User Accepts

To register and connect an SL1 Collector with the Collector Initiates | User Accepts option (a "token-less PhoneHome Communication" collector type):

1. On the Registered tab on the Nodes page (Manage > Nodes), click Add Nodes. The Choose Connection Type window of the Add Node wizard appears.

2. Select Collector Initiates | User Accepts and click Next. The Define Collector Properties window appears.

3. Complete the following fields as needed:

• Collector Name. Type the name the collector used when registering the collector. SL1 will update this value with the collector hostname.

• Collector IP Address or Hostname. Type the IP address or the hostname of the collector.

  • For "Collector Initiates | System Accepts" and "Collector Initiates | User Accepts" connection types, this information is optional but recommended, as it is used in Step 3 of the wizard to create a link to the collector's Node Configuration Utility, where you will input the token you generate.

  • For a "Database Initiates | System Accepts" connection type, you must type the IP address in this field so the Database Server can connect to the collector.

• Collector Description. Type a description of the collector. This field is optional.

• Collector Group. The new collector must be aligned to an SL1 Collector Group. You have the following options for this field: 

  • Select an existing Collector Group from the drop-down.

  • Create a new Collector Group for the collector by clicking the plus icon (+). On the Add Collector Group modal, you can name the new group and choose to make that Collector Group available to all current and future organizations. You can also limit the Collector Group to specific organizations.

    The All current and future organizations toggle is enabled by default. If you want to limit Organization access to the new Collector Group, disable this toggle and select the organization or organizations from the drop-down.
    

• Collector Type. Your options include: 

  • Data Collector. This is the most commonly used type. A Data Collector retrieves a specific set of information from monitored devices. A Data Collector can also work as a Message Collector.

  • Message Collector. A Message Collector receives and processes inbound, asynchronous syslog and trap messages from monitored devices.

4. Click Generate Token. The Configure Collector window appears.

   You can go back to a previous step at any point in the wizard, but when you click the Generate Token button, SL1 always generates a new token. You cannot retrieve this particular token if you close the Add Node wizard. The generated token expires after 30 minutes.

5. Click the Copy icon () to copy the token in the Token field.

6. Open the Node Configuration Utility by clicking the Open icon () in the Node Configuration Utility field. The login page for the Node Configuration Utility opens in a new browser window.

   If you did not specify an IP address or a hostname in step 2 of this wizard, you will need to open a new browser window and type the IP address or hostname for the collector, followed by ":7700/node-config", such as "https://10.1.1.100:7700/node-config".

   If the node type is not a collector, the Node Configuration Utility will display the following message: "This page will only be visible if you are on a collector."

7. Log in to the Node Configuration Utility using the same username and password that you used when you installed the collector. After you log in, the collector and the SL1 Database Server attempt to connect. The connection will fail, which is expected. The Connect Collector page appears with an empty Paste token text field.

8. Paste the token you copied in step 6 in the Paste token field.

   If you did not generate a token, you can click Manual Entry, select User Accepted Connection Request, and add the IP addresses for the Database Servers (CMDBs) in the text box.

9. After pasting the token, click Register or Register Database, based on your choices in the previous step. When the connection is made, the Success dialog contains a six-digit confirmation code. Click the Copy icon () to copy the confirmation code.

10. Click OK on the Success dialog. The Collector Connection Status page displays details about the connection request and the same six-digit confirmation code.

11. In SL1, click See Pending Requests on Step 3 of the Add Node wizard. The Pending tab on the Nodes page appears with the pending request.

12. Select the Actions icon () next to the pending request for the new collector and select Accept. The Accept Request dialog appears.

13. Paste the six-digit confirmation code from the Connect Collector page of the Node Configuration Utility and click Validate. The Configure Collector dialog displays a summary of the collector information you entered in the Add Node wizard.

14. Edit the collector information and collector group as needed, and then click Save. The Configure Collector dialog displays a summary of your information.

15. Click OK. The Registered tab on the Nodes page displays the new collector, aligned with the collector group you specified. The new collector also displays on the Appliance Manager page (System > Settings > Appliances).

Database Initiates | System Accepts

To register and connect an SL1 Collector with the Database Initiates | System Accepts option (a "traditional" or non-PhoneHome collector type):

1. On the Registered tab on the Nodes page (Manage > Nodes), click Add Nodes. The Choose Connection Type window of the Add Node wizard appears.

2. Select Database Initiates | System Accepts and click Next. The Define Collector Properties window appears.

3. Complete the following fields as needed:

• Collector Name. Type the name the collector used when registering the collector. SL1 will update this value with the collector hostname.

• Collector IP Address or Hostname. Type the IP address in this field so the Database Server can connect to the collector. Required.

• Collector Description. Type a description of the collector. This field is optional.

• Collector Group. The new collector must be aligned to an SL1 Collector Group. You have the following options for this field: 

  • Select an existing Collector Group from the drop-down.

  • Create a new Collector Group for the collector by clicking the plus icon (+). On the Add Collector Group modal, you can name the new group and choose to make that Collector Group available to all current and future organizations. You can also limit the Collector Group to specific organizations.

    The All current and future organizations toggle is enabled by default. If you want to limit Organization access to the new Collector Group, disable this toggle and select the organization or organizations from the drop-down.
    

• Collector Type. Your options include: 

  • Data Collector. This is the most commonly used type. A Data Collector retrieves a specific set of information from monitored devices. A Data Collector can also work as a Message Collector.

  • Message Collector. A Message Collector receives and processes inbound, asynchronous syslog and trap messages from monitored devices.

4. Click Generate Token. The Configure Collector window appears.

   You can go back to a previous step at any point in the wizard, but when you click the Generate Token button, SL1 always generates a new token. You cannot retrieve this particular token if you close the Add Node wizard. The generated token expires after 30 minutes.

5. Click the Copy icon () to copy the token in the Token field.

6. Open the Node Configuration Utility by clicking the Open icon () in the Node Configuration Utility field. The login page for the Node Configuration Utility opens in a new browser window.

   If you did not specify an IP address or a hostname in step 2 of this wizard, you will need to open a new browser window and type the IP address or hostname for the collector, followed by ":7700/node-config", such as "https://10.1.1.100:7700/node-config".

   If the node type is not a collector, the Node Configuration Utility will display the following message: "This page will only be visible if you are on a collector."

7. Log in to the Node Configuration Utility using the same username and password that you used when you installed the collector. After you log in, the collector and the SL1 Database Server attempt to connect. The connection will fail, which is expected. The Connect Collector page appears with an empty Paste token text field.

8. Paste the token you copied in step 6 in the Paste token field.

   If the collector and Database Server are not able to connect, make sure that port 7707 is open between the Database Server and the collector.

9. Alternately, instead of pasting the token here, you can save time with additional configuration that you will need to do later by clicking Manual Entry, selecting Database Initiated Connection, and adding the IP addresses for the Database Servers (CMDBs) in the text box.

   Using this option lets you add all IP addresses for your Database Servers (CMDBs), including primary, High Availability (HA) and Disaster Recovery (DR) servers.

10. After pasting the token or manually adding the IP adresses, click Register or Register Database, based on your choices in the two previous steps. When the connection is made, a Success dialog states that the collector was configured to accept a connection from the Database Server, and that you need to register the collector in SL1 if you have not already done so. Click the link in the Status dialog to get more information about registering a collector.

11. Click OK on the Success dialog. The Connect Collector page appears, with a message stating that the collector can receive inbound connection requests.

12. After you connect the new collector, you will need to manually register the collector in SL1 by navigating to the Appliance Manager page (System > Settings > Appliances).

13. At the top of the Appliance Manager page, complete the following fields:

    10. Host Name. Type the host name of the collector.

    11. IP Address. Type the loopback IP address of the collector. The loopback IP address is a special, virtual network interface that your computer uses to communicate with itself. This address also allows you to view content on a server in the same way a client would. In most cases, the loopback address is 127.0.0.1, although the loopback address can be any IP address in the 127.0.0.0/8 block.

    12. Model Type. Select the type of appliance (Data Collector or Message Collector) you are registering. 

        When you select either type of collector, the DB User and DB Password fields appear. If the Database Server has different credentials from the collector, type the credentials for MariaDB on the Collector. This credential was entered when the ISO was deployed.

    13. Description. Type a description for the Data Collector or Message Collector. This field is optional.

    14. DB User. Type a user name that can access the MariaDB database on the Data Collector or Message Collector.

        For SL1 version 11.3.0 and later, this user is the default database user for MariaDB. This user has the same password as the admin and root user, and the password is set during the initial installation. If you upgraded to SL1 version 11.3.0 or later from an earlier version, the DB user name is "root". If you installed SL1 version 11.3.0 from the ISO, the DB user name will be "clientdbuser".

    15. DB Password. Type a password that allows access to the MariaDB database on the Data Collector or Message Collector.

        In SL1 version 11.2.0, SL1 automatically set the default database credentials when adding an SL1 collector to the stack. Starting with SL1 version 11.3.0, SL1 no longer specifies the credentials. As a result, you will need to specify the credentials for the collector on the Appliances page (System > Settings > Appliances), in the DB User and DB Password fields.

14. Click Save. If the save is successful, the message "Appliance Registered" displays.

15. If all information is valid and the Database Server can communicate with the Data Collector or Message Collector, the Appliance Manager page displays the SL1 version installed on the collector in the Build column. If the Build column remains blank for longer than five minutes, double-check your settings and network connection.

16. Perform steps 13-15 for each Data Collector and Message Collector in yourconfiguration.

17. Finally, align the new collector with the relevant Collector Group by going to the Collector Groups page (Manage > Collector Groups or System > Settings > Collector Groups in the classic user interface).

18. Select the Collector Group you want to use, select the new collector from the Message Collector Selection field or the Message Collector Selection field, and click Save. In the classic user interface, click the edit icon () next to the Collector Group you want to use, select the new collector from the Collector Selection field, and click Save.

19. Go to the Registered tab on the Nodes page (Manage > Nodes), where you can now see the new collector in the list, aligned with the Collector Group you specified.

Connecting an SL1 Collector to the SL1 Database Server using the Command-line Interface

System Accepted

In this connection method, the database administrator creates a new token on the database appliance.

To connect a collector using the System Accepted method with the command-line interface:

1. Go to the console of the Database Server or use SSH to access the server and log in as user em7admin with the password you configured during setup.

2. Run the following command:

   phonehome token new <model_type> <name> <CUG_ID ><description>

   where:

   • <model_type> is either a cu for a Data Collector or mc for a Message Collector.
   • <name> is the name of the PhoneHome collector. You can use any name you want.
   • <CUG_ID> is the numeric ID of a collector group from SL1.
   • <description> is the descriptive text about the collector.

3. Make a note of the resulting token and share it with the collector administrator.

4. The collector administrator registers the collector using the token value by running the following command on the SL1 collector:

   sudo phonehome register <token>

User Accepted

In this connection method, the collector administrator sends a registration request from the collector.

To connect a collector using the User Accepted method with the command-line interface:

1. Go to the console of the SL1 collector or use SSH to access the collector and log in as user em7admin with the password you configured during setup.

2. Run the following command on the collector:

   sudo phonehome request send <address_1> [<address_2> <address_3> ... <address_n>] [-l <label>]

   where:

   • <address> is the destination address of the database server, in "host:port" format. You can include multiple addresses to one or multiple databases. Separate multiple addresses with a space.

   • <label> is an optional field you can use to associate a human-friendly identifier with the request. Every request is identified by a random string on the server side, and it might be confusing for the database administrator to find a specific request if numerous requests are coming from other collectors.

3. Make a note of the one-time secret and share it with the database administrator.

4. The Database administrator accepts the incoming request using the one-time secret by running the following command on the Database Server:

   phonehome request accept <uuid> <model_type> <name> <CUG_ID> <description> <one_time_secret>

   where:

   • <uuid> is the unique ID of the request.
   • <model_type> is either a cu for a Data Collector or mc for a Message Collector.
   • <name> is the name of the PhoneHome collector. You can use any name you want.
   • <CUG_ID> is the numeric ID of a collector group from SL1 to which you want to assign this collector.
   • <description> is the descriptive text about the collector.
   • <one_time_secret> is the secret generated when sending a request from the collector.

Managing the Nodes Page

The following topics describe how to use and add information on the Nodes page.

Viewing the List of Registered Nodes

The Registered tab of the Nodes page lets you manage the nodes used for installing SL1 collectors, SL1 instances, and other related appliances. You can also click the Add Node button to connect an SL1 collector to an SL1 Database Server.

The Pending tab displays a list of pending requests for establishing a connection between a collector and an SL1 Database Server. The Tokens tab displays a list of existing and expired tokens used for connecting collectors.

The Pending tab and the Tokens tab do not display on an All-In-One SL1 system.

The Nodes page replaces some of the functionality previously found in the Web Configuration utility and the Appliance Manager page.

You can filter the items on this inventory page by typing filter text or selecting filter options in one or more of the filters found above the columns on the page. For more information, see Filtering Inventory Pages.

By default, the Nodes page displays the following about each node:

• Name. Name of the node.
• IP . Primary IP address for the node.
• Status. The node status types include:

• Available
• Unavailable
• Failed Over
• Available Failed Over
• Unconfigured
• Unlicensed

• Node Type. The node types include: 

• All-In-One Appliance
• Application Server (Administration Portal)
• Compute Node
• Collector Unit (Data Collector)
• Database Server
• Message Collector
• Storage Node

• Database Version. Version number of the Database Server for an All-In-One Appliance or a Database Server node.
• Collector Group . For Data Collectors and All-In-One Appliances, specifies the Collector Group name associated with the node.

In addition, you can click the Grid Settings button and select Column Preferences to add the following columns to the Nodes page:

• Node ID. Unique numeric ID, automatically assigned by SL1 to each node on the Nodes page.
• Capacity. For Database Servers, specifies the licensed capacity of the node.
• Description. Description of the node.
• Patch Level. Most recent patch version number for the node, where applicable.
• Release Version. SL1 version running on the node.
• Version ID. Unique numeric ID, automatically assigned by the platform to each SL1 version.
• Created. Date and time the node was registered and licensed.
• Edit User. User who last edited the node's information.
• Last Edited. Date the node's information was discovered or last edited.
• Task Manager Paused. Specifies whether the task manager service is paused. This value is updated every two minutes.
• Needs Reboot. Specifies whether the node requires reboot to add latest kernel or security updates.
• Allocation. For Data Collectors, specifies the number of devices aligned with the node.
• Endpoint. SL1 Agent endpoint for the Gen 1 Agent.
• Collector Group ID. For Data Collectors and All-In-One Appliances, specifies the Collector Group ID associated with the node.

Viewing the Tokens on the Nodes Page

The Tokens tab on the Nodes page lists the existing and expired tokens that get used when connecting a collector. A token is a JSON web token (JWT) that contains a set of secure data that SL1 uses to establish communication between the new SL1 Collector and the SL1 Database Server.

By default, tokens for a "Collector Initiates | System Accepts" connection type have a 30-minute expiration period.

The Tokens tab lists the following:

• Collector registration details entered by the user at the time of token creation (collector hostname, description)
• Collector type (Data Collector or Message Collector) and aligned Collector Group
• Details about the token (including its type, date of creation, and expiration date)

A token inherits organization membership from the Collector Group to which it is aligned to allow multi-tenancy.

Recreating a Token

Expired tokens cannot be recovered on the Tokens tab, but you can recreate an expired token, which lets you generate a new token with the same collector details. Recreating the token actually deletes the existing token, but retains the user-supplied collector registration details to use in the new token.

To recreate an expired token:

1. Go to the Tokens tab on the Nodes page (Manage > Nodes).
2. Click the Actions menu () and select Recreate for the expired token. The Recreated Token window appears.

3. Click the Copy button to copy the token, and then paste the copied token into the Node Configuration Utility.