Migrate traditional clients to Salt clients
To migrate a system from a traditional client to a Salt, user can create the Salt bootstrap script and re-register the client system with it.
This could be done with three procedures: * create a bootstrap script, * modify the bootstrap script, and * run the bootstrap script to register the client.
First you create a bootstrap script with the Web UI as a template.
In the SUSE Manager Web UI, navigate to.
SUSE Manager Configuration - Bootstrapdialog, verify that the
Bootstrap using Saltcheckbox is checked.
The required fields are pre-populated with values derived from previous installation steps. For details on each setting, see Bootstrap Script.
Click Update to create the script.
The bootstrap script is generated and stored on the server in the
/srv/www/htdocs/pub/bootstrapdirectory. Alternatively, you can access the bootstrap script over HTTPS. Replace
<example.com>with the host name of your SUSE Manager Server:
In the next step, you modify the bootstrap script as needed.
It is important that you set your activation key.
Tasks box, click
Manage Activation Keys.
All keys created for channels are listed on this page.
Enter the full name of the key you wish to use in the bootstrap script exactly as presented in the key field.
For more information about activation keys, see Activation Keys.
On your SUSE Manager Server, as root at the command line change to the bootstrap directory with:
Create a copy of the template bootstrap script for use with each of your clients.
cp bootstrap.sh bootstrap-migrate-to-salt.sh
bootstrap-migrate-to-salt.shfor modification. Scroll down until you can see the text shown below. If
exit 1exists in the file, comment it out by typing a hash or pound sign (#) at the beginning of the line. This activates the script. Enter the name of the key for this script in the
echo "Enable this script: comment (with #'s) this block (or, at least just" echo "the exit below)" echo #exit 1 # can be edited, but probably correct (unless created during initial install): # NOTE: ACTIVATION_KEYS *must* be used to bootstrap a client machine. ACTIVATION_KEYS=1-migrate-salt ORG_GPG_KEY=
When you have finished, save the file.
By default, the bootstrap script will try to install
For more information, see Salt Bundle.
As the final step, run the bootstrap script to migrate and register clients.
On the SUSE Manager Server, log in as root. At the command prompt, change to the bootstrap directory:
Run the following command to execute the bootstrap script on the client. Replace
EXAMPLE.COMwith the hostname of your client:
cat bootstrap-migrate-to-salt.sh | ssh root@EXAMPLE.COM /bin/bash
Alternatively, on the client, run the command:
curl -Sks https://server_hostname/pub/bootstrap/bootstrap-migrate-to-salt.sh | /bin/bash
The script downloads the required dependencies.
When the script has finished running, you can check that your client is registered correctly by opening the SUSE Manager Web UI and navigating toto ensure the new client is listed.
In case of trouble with registering the new Salt client, open the SUSE Manager Web UI and navigate toto accept the client key.
When new packages or updates are installed on the client using SUSE Manager, any end user license agreements (EULAs) are automatically accepted. To review a package EULA, open the package detail page in the Web UI.
For more information about using bootstrap scripts, see Register Clients with a Bootstrap Script.