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 서버에서 명령줄의 루트 권한으로 다음과 같이 부트스트랩 디렉토리로 변경합니다.

    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 부트스트랩 스크립트로 클라이언트 등록.