Starting and registering a delegate using a file

Use this procedure to start a delegate host after upgrading Control Center to version 1.3.3. This procedure also includes steps to create a credentials file and to use the file to register the delegate.
  1. Log in to the master host as root, or as a user with superuser privileges.
  2. Obtain the host ID of the delegate host to start and register.
    1. Display the host IDs of all cluster hosts.
      serviced host list | cut -c-85
    2. Record the host ID of the delegate host.
  3. Create authentication credentials for the delegate host.
    Replace Host-ID with the host ID of the delegate host identified in the preceding step:
    serviced key reset Host-ID
    The command creates a unique credentials file in the local directory.
  4. Use a file transfer utility such as scp to copy the credentials file to the delegate host.
    Once copied to the delegate host, the credentials file is not needed on the master host and can be deleted.
  5. Log in to the Control Center delegate host as root, or as a user with superuser privileges.
  6. 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
  7. Verify the settings in the serviced configuration file.
    grep -E '^\b*SERVICED' /etc/default/serviced
  8. 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
  9. Install the credentials.
    Replace Credentials-File with the pathname of the credentials file:
    serviced host register Credentials-File
  10. Delete the credentials file.
    The file is no longer needed on the delegate host.
    Replace Credentials-File with the pathname of the credentials file:
    rm Credentials-File