Installing the Smart Hub and Smart Hub Gateway using the installation script

You can install the Smart Hub and Smart Hub Gateway using the installation script. BMC recommends installing the Smart Hub on a dedicated server that is located close to the target servers (preferably, in the same data center). The Application Server supports communication with the Smart Hub through a SOCKS proxy.

NEW IN 20.02.01 The Smart Hub installer includes an additional optional component called the Smart Hub Gateway. If you want to manage the servers in private networks (in on-premises or cloud environments such as AWS) where inbound connectivity with the RSCD Agents is not available, you must install the Smart Hub Gateway.

Prerequisites

Before installing the Smart Hub and Smart Hub Gateway, ensure the following:

  • The systems requirements as specified in the Supported-platforms are met.
  • The following software applications are installed:
    • (Windows) Microsoft .NET Framework 4.0 or later
    • (Linux) OpenSSL 1.01e or later
  • The Smart Hub and Smart Hub Gateway installer files (SMARTHUB<version>-<os>.zip) are downloaded. These files are located in the Optional components. For more information, see Downloading-the-installation-files.

  • (Windows) A Redis server is installed in your environment. For information about the supported Redis server versions, see Supported-platforms.

    Important

    A Redis server being used for an already running Smart Hub instance cannot be used for other Smart Hub instances. You need to have a separate Redis server instance.

  • To install the Smart Hub and Smart Hub Gateway on a Windows system in a directory containing spaces in its name with the 8dot3 name disabled, do the following:

    1. Log in to the Windows system where you want to install the Smart Hub.
    2. At the command prompt, create short names for the directory with spaces in its name. For example:
      fsutil file setshortname "Smart Hub" Smart~1
      Note: If you encounter a permission-related error, open the command prompt with elevated privileges (For example, "Run as administrator"), and run the specified command again.

To install the Smart Hub and Smart Hub Gateway using the installation script

Do the following:

  1. Log in to the system where you want to install the Smart Hub.
    • (Windows) Log in as an administrator.
    • (Linux) Log in as a root user.

  2. Extract the downloaded zip files (the installer) to the directory where you want to install the Smart Hub. The installation script configures the Smart Hub to run from this directory.

    • (Windows) Extract SMARTHUB<version>-WIN64.zip
    • (Linux) Extract SMARTHUB<version>-LIN64.zip
  3. Run the installer using this command:
    • (Windows) setup.bat
    • (Linux) ./setup.sh
  2. Read the license agreement and type y to agree to the terms.
  3. Enter a directory to install the Smart Hub. The default installation directory is:
    • (Windows) C:\Program Files\BMC Software\SmartHub
    • (Linux) /opt/bmc/bladelogic/SmartHub
  2. Enter a port to be used for the Smart Hub, and press Enter. The default port is 443.
  3. Enter a shared secret key according to the specified criteria, and press Enter. 
  4. Enter the specified shared secret key again for confirmation.
  1. (Windows) Specify the following details of the remote (external) Redis server that is installed in your environment:
    • Host name
    • Port
    • Password
  2. (Linux) Specify whether you want to use the packaged Redis Server or an existing Redis Server (external) that is installed in your environment.
    • If you select the packaged Redis Server, specify its port number. The default port is 6379.

    • If you select the existing Redis Server, specify its host name, port number, and password.

      Important

      A Redis server being used for an already running Smart Hub instance cannot be used for other Smart Hub instances. You need to have a separate Redis server instance.

  3. Provide the details for generating a CA signer certificate:

    • Country Name
    • State or Province Name
    • Locality Name
    • Organization Name
    • Organizational Unit Name
    • Common Name
    • Email Address
    Info

    If you do not specify any values, default values are used for the certificate. We recommend providing some meaningful values that help identify the certificate.

  4. Provide the following details for generating a Smart Hub server certificate:

    • Country Name
    • State or Province Name
    • Locality Name
    • Organization Name
    • Organizational Unit Name
    • Common Name
    • Email Address

    Important

    If the values provided to generate the CA-signer certificate and the Smart Hub server certificate match, an error occurs. To resolve it, regenerate the Smart Hub server certificate with different values. 

    Info

    If you do not specify any values, default values are used for the certificate. We recommend providing some meaningful values that help identify the certificate.

  5. (optional step for Linux) Specify the following additional parameters to be sent along with the certificate request: A challenge password and company name
    A confirmation message about Smart Hub installation is displayed.

  6. To install the Smart Hub Gateway, do the following:

    1. Type Y and press Enter.
    2. Enter the listening port for the Smart Hub Gateway. The default is 1080.
      A confirmation message about the Smart Hub Gateway installation is displayed, and the Smart Hub Gateway service is started.

  7. (Optional) Copy the Smart Hub CA root certificate (smartHubCA.crt) to the Application Server with which you will be registering this Smart Hub. This certificate (also called as CA bundle) is needed by an Application Server or Smart Agent to verify the legitimacy of a Smart Hub and Smart Hub Gateway. You need to provide the location of the CA bundle on the Application Server as an input while registering the Smart Hub with the Application Server. The CA bundle is typically located in the following directory:

    • (Windows) C:\Program Files\BMC Software\SmartHub\certs
    • (Linux) /opt/bmc/smarthub/certs

    Important

    • BMC recommends copying the CA bundle to the Application Server. If you do not copy the CA bundle and provide its path as the input while registering the Smart Hub, the Application Server or the Smart Agent won’t verify the server certificate of Smart Hub and Smart Hub Gateway.
    • Once the Smart Hub is registered with the Application Server, you can delete the copied CA bundle from the Application Server.

  8. Verify that the Smart Hub and Smart Hub Gateway is up and running:

    • (Windows)
      1. On the search bar, enter services.msc.
      2. Verify that the following services are running:
        • TrueSight Server Automation Smart Hub
        • TrueSight Server Automation Smart Hub Gateway
    • (Linux) Run the following commands to view the status of Smart Hub and Smart Hub Gateway:
      • systemctl status smarthub.service
      • systemctl status smarthub.gateway.service

To install the Smart Hub Gateway using the installation script if Smart Hub is already installed

Do the following:

  1. Log in to the system where you want to install the Smart Hub Gateway.
    • (Windows) Log in as an administrator.
    • (UNIX and Linux) Log in as a root user.
  2. Extract the Smart Hub Gateway installer files to a directory of your choice. The installer files for Smart Hub Gateway are part of the Smart Hub installer files.
    • (Windows) Extract SMARTHUB<version>-WIN64.zip
    • (Linux) Extract SMARTHUB<version>-LIN64.zip
  3. Navigate to the directory that contains the Smart Hub Gateway installation files.
  4. Run the installer using this command:
    • (Windows) setup.bat
    • (Linux) ./setup.sh
  5. Read the license agreement and type y to agree to the terms.
  6. Enter a directory to install the Smart Hub Gateway. The default installation directory is:
    • (Windows) C:\Program Files\BMC Software\SmartHub_Gateway
    • (Linux) /opt/bmc/bladelogic/SmartHub_Gateway
  7. Enter a port to be used for the Smart Hub Gateway, and press Enter. The default port is 1080.
  8. Enter the Smart Hub hostname. The default Smart Hub hostname is localhost.
  9. Enter the Smart Hub port. The default Smart Hub port is 443.
  10. Enter the specified shared secret key which is already configured with the Smart Hub.

  11. Verify that the Smart Hub Gateway is up and running:

    • (Windows)
      1. On the search bar, enter services.msc.
      2. Verify that the following service is running: TrueSight Server Automation Smart Hub Gateway
    • (Linux) Run the following command to view the status of Smart Hub Gateway:
      systemctl status smarthub.gateway.service

What's next

  1. Register the Smart Hub with the Application Server. For more information, see Configuring-the-Smart-Hub-and-Smart-Hub-Gateway.
  2. (For targets in the public cloud) Define the network routing rules. For more information, see Creating-rules-for-routing-to-remote-servers.
  3. Configure the Smart Agent to specify the host name of this Smart Hub. For more information, see Configuring-the-installation-parameters-for-the-NSH-or-the-RSCD-agent.
  4. (Mandatory step for Smart Hub Gateway) Configure the NSH proxy server. For details, see Setting-up-a-Network-Shell-proxy-server.
  5. (Optional) Customize values of the Smart Hub parameters. For more information, see Managing-the-Smart-Hub.

Related topics

Getting-started-with-Smart-Agents

Smart-Hub-to-Application-Server-and-Smart-Agent

Migrating-the-Smart-Hub-and-Redis-Server-data

 

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