Configuring the Smart Hub and Smart Hub Gateway

The Smart Hub provides the Agent status updates to the Application Server. To enable the Application Server communication with the Smart Hub, you must configure the Smart Hub, which includes registering it in the Application Server.

If no direct connectivity exists between the Application Server and targets, you also need to configure the Smart Hub Gateway. For example, configure the Smart Hub Gateway when the targets to be managed are hosted in a virtual private cloud (VPC) network or a private on-premises network.

Configuration involves the following tasks:

To register the Smart Hub and Smart Hub Gateway in the Application Server

You can register multiple Smart Hubs in the Application Server. You can also register the Smart Hub Gateway as required.

  • By default, only members of the BLAdmins role can register the Smart Hub and Smart Hub Gateway. If you want to register the Smart Hub and Smart Hub Gateway as a role other than BLAdmins, ensure that the role has these permissions:
    sh_nonadmin_rights.png

    For information about granting permissions, see Assigning-object-based-permissions.

  • If a role other than BLAdmin registered the Smart Hub and Smart Hub Gateway and you want to browse the enrolled targets using this role, you must grant at least PropertyInstance.Read authorization to this role for the corresponding PropertyInstance of the Smart Hub. In the following example, within the built-in property class Proxy Server, there is PropertyInstance for Smart Hub TEST_SMARTHUB. Therefore, the role NON_BLADMIN_ROLE must be granted PropertyInstance.Read authorization to access the instances of the Proxy Server:
    image-2024-4-25_15-59-45.png

Do the following:

  1. Log in to the TrueSight Server Automation console as a member of the BLAdmins role or the role with the required permissions.
  2. Click Configuration > Infrastructure Management.
  3. On the Infrastructure Management page, do the following:
    1. In the left pane, right-click Smart Hubs and click New Smart Hub.
    2. On the General tab, specify the following details:

      smarthub_gateway_preconfig.png
      • A unique name and an optional description for the Smart Hub.
      • The host name or IP address and the port number where the Smart Hub runs.
      • The polling interval in minutes, which indicates the duration between the consecutive polls by the Application Server to the Smart Hub. The default interval is five minutes. You can specify the interval in the range 1 - 60.
      • The batch size, which indicates the maximum number of records in a batch that are requested by the Application Server from the Smart Hub. The default batch size is 1000. You can specify the batch size in the range 100 - 10000.
      • The connection timeout, which indicates the period up to which the Application Server waits to connect to the Smart Hub before timeout. The default timeout is 90 seconds. You can specify the timeout in the range 3 - 300.
      • The shared secret key that is used for authenticating with the Smart Hub. Ensure that you specify the same key that you added while installing the Smart Hub.
      • The user and the role such as BLAdmin that is used to perform the actions, such as enrollment and heartbeat processing. Ensure that the user exists and it belongs to the specified role.
      • Select or create a static server group to which the auto-enrolled servers will be added.
      • (Optional) Select a Socks proxy server to be used for communication with the Smart Hub. It is required only when a Socks Proxy Server exists between the Application Server and the Smart Hub.
    3.  Click Next.

    4.  NEW IN 20.02.01 (optional) Specify whether you want to configure the Smart Hub Gateway and provide the description and listening port number.

      smart_hub_gateway_configured.png

    5.  Click Finish.
      The Smart Hub is registered and its name is added to the list of Smart Hubs under the Smart Hubs node. If the Smart Hub Gateway is configured, the Smart Hub is also listed under the Proxy Servers node with type as Smart Hub Gateway. 

      configured_sh_shgateway.png

To edit the registration parameters

You can update all the registration parameters of a Smart Hub except host name and port.

Do the following:

  1. Log in to the TrueSight Server Automation console as a member of the BLAdmins role or the role with the required permissions..
  2. Click Configuration > Infrastructure Management.
  3. On the Infrastructure Management page, expand Smart Hubs in the left pane.
  4. Right-click the required Smart Hub and click Properties.
  5. Update values of the required parameters, and save the changes.

NEW IN 20.02.01 You can view and refresh the properties of a Smart Hub Gateway that is listed under the Proxy Servers node. However, select the required Smart Hub under the Smart Hubs node to edit its properties.

smart_hub_gateway_properties.png

To update the Smart Hub and Smart Hub Gateway status

You can update the status of a Smart Hub and Smart Hub Gateway to confirm whether they are up and running. The status update action also validates connectivity with the Application Server.

Do the following:

  1. Log in to the TrueSight Server Automation console as a member of the BLAdmins role or the role with the required permissions..
  2. Click Configuration > Infrastructure Management.
  3. On the Infrastructure Management page, expand Smart Hubs in the left pane.
  4. Right-click the required Smart Hub and click Update Smart Hub Status.
    The details of the Smart Hub including the status are displayed in the right pane.

To view the access key

You can view the access key of a Smart Hub that is used for authentication between the Smart Hub and Smart Agents.

Do the following:

  1. Log in to the TrueSight Server Automation console as a member of the BLAdmins role or the role with the required permissions..
  2. Click Configuration > Infrastructure Management.
  3. On the Infrastructure Management page, expand Smart Hubs in the left pane.
  4. Right-click the required Smart Hub and click Show Access key.

To delete a Smart Hub

When you log in as a member of a role, you can delete only those Smart Hubs that are registered using that role. For example, if you register a Smart Hub as smarthub.bmc.com with a logged-in user as a member of role system, you can delete only smarthub.bmc.com when logged in with the system role. When you log in as a member of the BLAdmin role, you can view and delete all the Smart Hubs.

When you delete a Smart Hub, the Smart Hub Gateway that is listed under the Proxy Servers node is also removed.

Do the following:

  1. Log in to the TrueSight Server Automation console as a member of the BLAdmins role or the role with the required permissions..
  2. Click Configuration > Infrastructure Management.
  3. On the Infrastructure Management page, expand Smart Hubs in the left pane.
  4. Right-click the Smart Hub that you want to delete and click Delete Smart Hub.
  5. Click Yes to confirm deletion.

 

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