Auto-enrollment process

Target servers in an on-premises or cloud environments can be enrolled automatically in TrueSight Server Automation.

Auto-enrollment process

A newly provisioned host is automatically enrolled in the Application Server when the following tasks are completed:

  • The RSCD Agent containing the Smart Agent is installed and configured on the new host.
  • The new host is started.

The following tasks are performed for auto-enrollment. By default, the auto-enrollment task is triggered by the Smart Agent every 15 minutes. 

  1. The Smart Agent generates an enrollment request.
  2. The Smart Hub receives this request and generates an ID for the enrollment request. It also stores the Smart Agent details in the database.
  3. The Smart Agent saves this request ID. 
  4. The Application Server pulls this enrollment request from the Smart Hub and enrolls the server using the enrollment details available in the enrollment request. 
    NEW IN 21.02The server is added as a "RAW device" and its properties are updated with the details from the enrollment request. The state is changed to "Server" after the server properties are updated.

  5. The Application Server generates a work response with the same request ID that was generated for the Smart Agent.
    For example, a sample enrollment response looks like this:

    "command": "enroll",
    "msg": "Server enrolled successfully",
    "server_name": "test.bmc.com",
    "server_guid": "b76d430f-3d6a-4962-9825-ab406a8dc7ee"

    Field

    Data type

    Purpose

    command

    String

    The actual task to be performed.

    msg

    String

    Message describing the response details.

    server_name

    String

    The name with which this server is enrolled in the Application Server.

    server_guid

    String

    The unique identifier that is used by the Application server to identify the server.

  6. The Application Server sends the enrollment response to the Smart Hub. 
    One of the following response codes are generated depending on the enrollment status:

    Response code

    Message

    SA-1000

    Enrolled

    SA-1001

    Enrolled as raw device

    SA-1002

    Not enrolled

    SA-1003

    Already enrolled

    SA-1004

    Server decommissioned

Server properties

You can specify the cloud-related properties to be configured for the enrolled targets. The properties are sent to the Application Server along with an auto-enrollment request. The Application Server configures these properties for the enrolled targets. Some of these properties are available out-of-the-box, such as cloud account, region, resource, and VPC. You can also configure additional properties of your choice. For example, you can configure the Is_Cloud_Prod property to define whether the server belongs to the production environment.

Important

  • Make sure that user-defined properties are first created in the Application Server. If the Application Server receives a property that does not already exist, the property is not set for the target and the appropriate error message is logged. The user-defined properties values are set only during the process of enrolling new servers.
  • When you install RSCD Agents using an Agent Installer Job (AIJ), custom properties that are received during the auto-enrollment request (configured in the NSH-install-defaults file) are ignored because the target servers are already enrolled.

If any of these properties are used by the Update Server Properties job, the property values are overridden after the Update Server Properties job is run. 

For information about configuring the server properties during installation, see the following topics:

For information about configuring the server properties manually, see Managing-the-Smart-Agent.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*