Starting and registering a delegate using SSH

To succeed, the following statements about the login account used to perform this procedure must be true:
  • The account exists on both the master host and on the delegate host.
  • The account has serviced CLI privileges.
  • The account has either public key authentication or password authentication enabled on the master host and on the delegate host.
Use this procedure to start a delegate host after upgrading Control Center to version 1.3.3. This procedure also includes steps to create and register the authentication credentials the delegate needs, through an SSH connection.
  1. Log in to the delegate host as root, or as a user with superuser privileges.
  2. Determine whether serviced is configured to start when the system starts.
    systemctl is-enabled serviced
    • If the result is enabled, proceed to the next step.
    • If the result is disabled, enter the following command:
      systemctl enable serviced
  3. Verify the settings in the serviced configuration file.
    grep -E '^\b*SERVICED' /etc/default/serviced
  4. Start serviced, and then monitor the startup.
    During this startup, serviced invokes docker pull to retrieve its updated images.
    systemctl daemon-reload && systemctl start serviced \
      && journalctl -u serviced -f -o cat
    Do not proceed to the next step until the following message is displayed:
    Host Agent successfully started
  5. Log out of the delegate host.
  6. Log in to the master host as root, or as a user with superuser privileges.
  7. Obtain the host ID of the delegate host started previously.
    1. Display the host IDs of all cluster hosts.
      serviced host list | cut -c-85
    2. Record the host ID of the delegate host.
  8. Create authentication credentials for the delegate host, and register the credentials.
    If the master and delegate host are configured for key-based access, the following command does not prompt you to add the delegate to the list of known hosts or to provide the password of the remote user account.
    Replace Host-ID with the host ID of the delegate host started previously:
    serviced key reset --register Host-ID