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.

1. Create bootstrap script

First you create a bootstrap script with the Web UI as a template.

Procedure: Creating a bootstrap script
  1. SUSE ManagerのWeb UIで、管理  マネージャ設定  ブートストラップスクリプトに移動します。

  2. In the SUSE Manager Configuration - Bootstrap dialog, verify that the Bootstrap using Salt checkbox is checked.

  3. The required fields are pre-populated with values derived from previous installation steps. For details on each setting, see ブートストラップスクリプト.

  4. 更新をクリックしてスクリプトを作成します。

  5. The bootstrap script is generated and stored on the server in the /srv/www/htdocs/pub/bootstrap directory. Alternatively, you can access the bootstrap script over HTTPS. Replace <example.com> with the host name of your SUSE Manager Server:

    https://<example.com>/pub/bootstrap/bootstrap.sh

2. Modify bootstrap script

In the next step, you modify the bootstrap script as needed. It is important that you set your activation key. Navigate to Home  Overview. In the 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 アクティベーションキー.

Procedure: Modifying a bootstrap script
  1. SUSE Managerサーバのコマンドラインでrootとして、ブートストラップディレクトリを次のように変更します。

    cd /srv/www/htdocs/pub/bootstrap/
  2. Create a copy of the template bootstrap script for use with each of your clients.

    cp bootstrap.sh bootstrap-migrate-to-salt.sh
  3. Open bootstrap-migrate-to-salt.sh for modification. Scroll down until you can see the text shown below. If exit 1 exists 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 ACTIVATION_KEYS= field:

    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=
  4. When you have finished, save the file.

By default, the bootstrap script will try to install venv-salt-minion for Salt clients if it is available in the bootstrap repository, or salt-minion if there is no Salt bundle in the bootstrap repository. It is posible to avoid installing Salt bundle and keep using salt-minion if you need it.

詳細については、Salt Bundleを参照してください。

3. Run bootstrap script

As the final step, run the bootstrap script to migrate and register clients.

Procedure: Running the bootstrap script
  1. On the SUSE Manager Server, log in as root. At the command prompt, change to the bootstrap directory:

    cd /srv/www/htdocs/pub/bootstrap/
  2. Run the following command to execute the bootstrap script on the client. Replace EXAMPLE.COM with the hostname of your client:

    cat bootstrap-migrate-to-salt.sh | ssh root@EXAMPLE.COM /bin/bash
  3. 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.

  4. スクリプトの実行が完了すると、クライアントが正しく登録されたかどうかを確認できます。そのためには、SUSE ManagerのWeb UIを開き、システム  概要に移動して、新しいクライアントがリストされていることを確認します。

  5. In case of trouble with registering the new Salt client, open the SUSE Manager Web UI and navigate to Salt  Keys to accept the client key.

SUSE Managerを使用してクライアントに新しいパッケージまたは更新がインストールされると、エンドユーザライセンスアグリーメント(EULA)が自動的に受け入れられます。 パッケージのEULAを確認するには、Web UIでパッケージ詳細ページを開きます。

For more information about using bootstrap scripts, see ブートストラップスクリプトを使用してクライアントを登録する.