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 and Smart Hub Gateway 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 and Smart Hub Gateway 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.
  • 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 and Smart Hub Gateway.
    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. 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 and port number.

      The Smart Hub authentication with an external Redis Server is not supported.

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

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

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

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

  6. 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
        • TrueSight Server Automation Smart Hub Redis (Displayed only when the Redis Server packaged with the Smart Hub is used)
    • (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.
  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

Migrating-the-Smart-Hub

Getting-started-with-Smart-Agents

 

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