Documentation survey

Register Clients to a Proxy with a Bootstrap Script

Clients can be registered through the SUSE Manager Proxy with a bootstrap script. This is done almost the same way as registering clients directly with the SUSE Manager Server.

Create the bootstrap script in the SUSE Manager Server container with the mgr-bootstrap command line tool. mgr-bootstrap requires parameters such as the fully qualified domain name (FQDN) of the proxy, activation keys, or GPG keys. FQDN of the proxy is mandatory. All other parameters depend on the specific setup.

The bootstrap script then deploys all necessary information to the clients.

Procedure: Registering Clients to a Proxy with a Bootstrap Script

  1. Create a client activation key on the SUSE Manager Server using the Web UI. For more information, see Activation Keys.

  2. On the container host of the server, start a terminial in the container:

    mgrctl term

    1. In the container, to create the bootstrap script, execute the mgr-bootstrap command, for example, with these options:

      mgr-bootstrap --hostname=SUMA_PROXY --activation-keys=ACTIVATION_KEY \
  --script bootstrap-SUMA_PROXY.sh

      Replace SUMA_PROXY with the host name of your proxy.

      With the --script option you save the bootstrap script with a descriptive name. If needed, use additional command line options to customize your bootstrap script. To view available options type mgr-bootstrap --help from the command line.

    2. OPTIONAL: Edit the resulting bootstrap script.

  3. Execute the bootstrap script. There are two options:

    • Transfer the script to the client and run it directly on the clients. Alternatively, because the proxy forwards requests to the server, the client can download it from http://SUMA_PROXY/pub/bootstrap-SUMA_PROXY.sh. Replace SUMA_PROXY with the host name of your proxy.

    • Execute the script from the proxy with ssh. Replace SUMA_PROXY with the host name of the proxy and <client.example.com> with the host name of the client:

    cat /srv/www/htdocs/pub/bootstrap/bootstrap-SUMA_PROXY.sh | ssh root@<client.example.com> /bin/bash