Contents x
    Silent Install for Synthetic Monitoring Custom Hives
      • Print
      • Dark
        Light
      • PDF
      Contents

      Silent Install for Synthetic Monitoring Custom Hives

        • Print
        • Dark
          Light
        • PDF
        Article summary

        Silent Install enables you to deploy, configure and update custom hives across multiple hosts (desktops or servers) using automation tools or proprietary scripts. These tools or scripts distribute a Custom Hive Installer (an executable file) to the hosts without requiring user interaction, saving you time and effort.
        To see an overview of custom hives, go to Custom Hive Overview.

        How to Deploy Custom Hives

        Step 1 - Create a temporary deployment token

        1. In the Synthetic Monitoring tab, click the configuration icon on the right top corner.

        click configuration icon

        1. In the configuration menu that opens, select Hive Tokens.
        2. Click Create new token.
          This token grants temporary authorization for both Hive creation and retrieval of the Hive key.

        create new token button on Hive Registration Tokens page

        1. A pop-up window opens.

        Create new token popup window

        Fill in token parameters:

        • Description
        • Maximum number of registrations, i.e., the number of hives it can install (up to 1000)
        • Duration - how long the token is active (up to 24 hours).
        1. Click Create new token.

        1. A Temporary Hive Registration Tokens screen opens. Locate your newly generated token and quickly copy and save it for later use.

        Note: the token is only available for copying for 5 minutes after its generation.

        copy token

        Here is an example of a token:

        us_c8c64d4b0c38f40671ac56c7517dd5a0dbca6933c4a5ee33d26c86adcd579349

        This is a one-time token, valid for up to 24 hours. The token can be used for deploying multiple custom hives, and serves to authenticate the custom hive owner against Synthetic Monitoring backend in the deployment process. It is also used for creating a permanent hive key.

        Step 2 - Install and Register Hive

        Integrate the Custom Hive Installer and the downloaded token into the automation tool configuration (for example, Puppet manifest).
        For instructions on installing and configuring custom hives, go to Install and Configure Custom Hives.

        1. To download the latest Custom Hive Installer, go to the Hives tab and click Download Custom Hive.

        Download custom hive

        1. Place the executable file in its target installation directory.
        2. To install the hive, run the installer from the command line using a script.
          Configure the hive by selecting the arguments that you want to include.
          Some arguments in the script are required, and some are optional.

        Important: the hive name cannot be changed once the hive is installed.

        ArgumentArgument DescriptionRequired or OptionalSyntax
        /VERYSILENTRequired to execute the deployment process in silent modeRequired/VERYSILENT
        /SUPPRESSMSGBOXESInstructs Setup to suppress message boxes. Only has an effect when combined with ‘/SILENT’ or ‘/VERYSILENT’Required/SUPPRESSMSGBOXES
        /LOGThe log file. Argument specifies the directory (log path) + name of the log file itself + log file extensionOptional/log=”path_to/log_file_name>.log”
        /DIRDestination folder for the custom hive. Default: C:\Program Files\Scoutbees Custom HiveOptional/DIR="<path_to\cust_hive_desired_destination_folder>"
        /tokenThe temporary Registration token generated in the first step. The user copies the generated token as is, without editing it.Required/token="<env_region>_<registration_token>"
        /nameCustom hive name. By default, it is the host machine’s nameOptional/name="Custom hive name"

        Here is an example command:

        hive110_1222x64.exe /VERYSILENT /SUPPRESSMSGBOXES /LOG="C:\projects\scoutbees-hive\dist\setup_log.log" /DIR="C:\Program Files\Scoutbees Custom Hive" /token="us_5a660843412899e0412bbd5e40c096df68ecfdc1ae5aac1fb3919edc45df6933" /name="ScoutbeesCustomHive"
        1. Once you have completed hive registration, refresh the Hives page. The new custom hive is displayed with a “connected” status.

        Copy hive key

        To upgrade a hive, see Upgrade Custom Hives.

        Was this article helpful?
        What's Next