Installing the Smart Hub and Smart Hub Gateway silently

The silent installation involves running the Smart Hub and Smart Hub Gateway installer from the command line. 

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

Do the following:

1. Log in to the system where you want to install the Smart Hub and Smart Hub Gateway (optional).
   
   • (Windows) Log in as an administrator.
   • (UNIX and Linux) Log in as a root user.
2. Extract the Smart Hub and Smart Hub Gateway installer files to a directory of your choice.
   
   • (Windows) Extract SMARTHUB<version>-WIN64.zip
   • (Linux) Extract SMARTHUB<version>-LIN64.zip
3. Navigate to the directory that contains the Smart Hub and Smart Hub Gateway installation files.

4. Run the following command:

   • (Windows) 

     .\setup.bat --silent --port <value> --redis --redis-host <value> --redis-port <value>
     --ssk <value> --install-dir <value> --upgrade --install-upgrade-smarthub-gateway
     --smarthub-gateway-port <value>
     

     Example:

     .\setup.bat --silent --port 443 --redis --ssk ABCD1234abcd1234 --install-dir /opt/bmc/smarthub  
     --install-upgrade-smarthub-gateway --smarthub-gateway-port 1080
     

   • (UNIX and Linux)

     ./setup.sh --silent --port <value> --redis --redis-host <value> --redis-port <value> --ssk <value>
     --install-dir <value> --upgrade ---install-upgrade-smarthub-gateway --smarthub-gateway-port <value>
     

     Example:

     ./setup.sh --silent --port 443 --redis --ssk ABCD1234abcd1234 --install-dir /opt/bmc/smarthub  
     --install-upgrade-smarthub-gateway --smarthub-gateway-port 1080
     

   where, 
   --port indicates the listener port of the Smart Hub. The default is 443.
   -- redis indicates the use of the packaged Redis Server.
   -- redis-port indicates the port where the Redis Server runs. The default is 6379.
   -- ssk indicates the shared secret key that is used for authentication. Ensure that the specified ssk is at least 15 characters long with mixed case alphanumeric characters.
   -- install-dir indicates the directory where the Smart Hub binary and configuration files are saved.
   -- NEW IN 20.02.01 install-upgrade-smarthub-gateway indicates installing or upgrading the Smart Hub Gateway. The Smart Hub Gateway is upgraded when the previously installed Smart Hub Gateway version is lower than the current Smart Hub Gateway version. 

   The following parameters are mandatory. Other parameters are configured with the default values.

   • ssk (When the Redis Server that is packaged with the installer is used.)
   • ssk, Redis Server host, and Redis Server port (When an external Redis Server is used. We recommend using only the supported versions of Redis Server. For more information, see Supported-platforms.)
     Specify the host name and port of the Redis Server in this format: --redis-host --redis-portExample: setup.sh --silent --redis --redis-host redis.bmc.com --redis-port 6379 --ssk Testkeysminstall12

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

5. 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 silently 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 following command:

   • (Windows) 

     setup.bat --silent --port < Smart Hub Gateway port> --smarthub-host <Smart Hub host name> --smarthub-port <Smart Hub port> --ssk <Shared secret key> --install-dir <Installation directory> --upgrade
     

     Example:

     setup.bat --silent --port 1080 --smarthub-host localhost --smarthub-port 443 --ssk ABCD1234abcd1234 --install-dir "c:\Program Files\BMC Software" --upgrade
     

   • (UNIX and Linux)

     ./setup.sh --silent --port <Smart Hub Gateway port> --smarthub-host <Smart Hub host name> --smarthub-port <Smart Hub port> --ssk <Shared secret key> --install-dir <Installation directory> --upgrade
     

     Example:

     ./setup.sh --silent --port 1080 --smarthub-host localhost --smarthub-port 443 --ssk ABCD1234abcd1234 --install-dir "/opt/bmc" --upgrade
     

   where, 
   port (optional) – Indicates the listener port of the Smart Hub Gateway. The default is 1080.
   smarthub-host (optional) – Indicates the name of the Smart Hub host. The default is localhost.
   smarthub-port (optional) – Indicates the port where the Smart Hub runs. The default is 443.
   ssk (required) – Indicates the shared secret key that was used for authentication during Smart Hub installation.
   install-dir (optional) – Indicates the directory where the Smart Hub Gateway binary and configuration files are saved. The default is C:\Program Files\BMC Software (Windows) and /opt/bmc (UNIX).
   upgrade (optional) – Indicates that you want to upgrade the Smart Hub Gateway. The Smart Hub Gateway is upgraded when the previously installed Smart Hub Gateway version is lower than the current Smart Hub Gateway version.
   
   

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