Skip to content

Bootstrapping Management console automatically

Resilio Administrator might need to automate installing and configuring the Management Console. This guide shows how to fully automate Management Console bootstrapping (supported for version 2.12.5 and newer).

  1. On Windows, download the Management Console MSI installer. Do not launch it.
    On Linux download the tar archive and unpack it, then run the update-or-install.py script from there. Do not start the Management Console itself.
  2. Create a folder named bootstrap in the Management Console's storage folder:
  • Windows: C:\ProgramData\Resilio\Connect Server\bootstrap
  • Linux: {unpack path}/var/bootstrap

  1. Create config.json with the following information:

    • license. Open the Resilio license file in a text editor, and copy its content (it starts with btos1_ey)
    • agree to EULA - yes
    • user e-mail
    • username
    • password. Be sure to comply with the password complexity policy.
    • API token description
      {
  "license": "btos1_eyJzIjog...J9",
  "eula": "yes",
  "user": {
    "email": "admin@example.com",
    "username": "admin@example.com",
    "password": "MyStrongPassword"
  },
  "token": {  
    "description": "Admin's API token"
  }  
}

  2. Start the Resilio Connect Management Console installer. When started for the first time (fresh install with empty storage folder) it checks for the_bootstrap folder and its content.

    If the folder doesn’t exist, regular installation continues and the Management Console records ‘auto installation path not found’ into the data/common.log file.

    If the folder does exist, but the data there is incorrect, the Management Console will report an error in the data/common.log.

    If the bootstrap folder does exist, and the information in the config.json file is correct, the Management Console will pull information from it and perform installation:

    • The bootstrap folder will be renamed to bootstrap performed.
    • API token will be generated and recorded it into token.txt file in this folder. Be sure to save it in a safe place.
    • The MC will automatically apply the license from the config.json file.
    • SuperAdmin user will be created on the Management Console using the credentials from the config.json file.

    mceclip1.png

    Once the installation is complete, the Management Console is going to ignore the bootstrap performed directory.

  3. Generate Agent Config file using Management Console API Using call GetAgentConfig fetch the configuration file. Some parameters, but not all, can be defined right in the call. Adjust the fetched configuration file if necessary.