Distribution Upgrade and Server Migration

  • SUSE Multi-Linux Manager 5.0은 업그레이드 전에 중지해야 합니다.

  • SUSE Multi-Linux Manager 5.0 is not supported on top of SL Micro 6.1 & SUSE Linux Enterprise Server 15 SP7 as host OS.

보안을 위해 강화된 SUSE Multi-Linux Manager 서버 호스트는 /tmp 폴더의 파일 실행을 제한할 수 있습니다. 이러한 경우 해결 방법으로 TMPDIR 환경 변수를 다른 기존 경로로 내보낸 다음, mgradm을 실행합니다.

예:

export TMPDIR=/path/to/other/tmp

In SUSE Multi-Linux Manager updates, tools will be changed to make this workaround unnecessary.

SSL 인증서는 후속 단계에서 필요합니다. 자체 서명 생성 CA 및 인증서를 사용하지 않는 경우 시작 전에 다음을 준비하십시오.

  • 인증 기관(CA) SSL 공개 인증서. CA 체인을 사용하는 경우 모든 중간 CA도 반드시 사용 가능해야 합니다.

  • SSL 데이터베이스 개인 키.

  • SSL 인증서

All files must be in PEM format.

SSL 서버 인증서의 호스트명은 해당 인증서를 배포하는 머신의 전체 호스트 이름과 일치해야 합니다. 인증서의 X509v3 Subject Alternative Name 섹션에서 호스트 이름을 설정할 수 있습니다. 환경에 따라 필요한 경우 여러 호스트 이름을 나열할 수도 있습니다. 지원되는 키 유형은 RSAEC(Elliptic Curve)입니다.

데이터베이스 SSL 인증서에는 reportdbdb가 필요하며, 보고서 데이터베이스에 액세스하는 데 사용되는 FQDN이 Subject Alternative Name으로 지정되어야 합니다.

During a migration the server SSL certificate and CA chain are copied from the source server, meaning that only the database certificates are required.

SUSE Multi-Linux Manager 5.0 peripheral servers are always using third-party SSL certificates. If the hub server has generated the certificates for the peripheral server, it needs to generate the certificate for the peripheral database too. On the hub server, run the following command for each of the peripheral server to migrate.

mgrctl exec -ti -- rhn-ssl-tool --gen-server --dir="/root/ssl-build" --set-country="COUNTRY" \
  --set-state="STATE" --set-city="CITY" --set-org="ORGANIZATION" \
  --set-org-unit="ORGANIZATION UNIT" --set-email="name@example.com" \
  --set-hostname=<hostname>-reportdb --set-cname="example.com" --set-cname=db --set-cname=reportdb

The files to use will be inside the server container and need to be copied to the new peripheral server host:

  • /root/ssl-build/RHN-ORG-TRUSTED-SSL-CERT as the root CA,

  • /root/ssl-build/<hostname>-reportdb/server.crt as the db certificate and

  • /root/ssl-build/<hostname>-reportdb/server.key as the db certificate’s key.

1. 클라이언트 도구 리브랜딩

SUSE Multi-Linux Manager 5.1 introduces a rebranded set of client tools for all supported operating systems. This transition is seamless, and users performing a new product synchronization should only notice the updated channel names.

버전 5.1에서는 SUSE Multi-Linux Manager 4.3 또는 5.0에 이전에 등록된 클라이언트가 사용하던 SUSE Manager Client Tools for XYZ 채널을 더 이상 사용할 수 없으며, 버전 5.1에서는 더 이상 업데이트를 수신하지 않습니다.

Although the legacy channels remain assigned to existing clients after migration, the corresponding repositories have been removed.

To ensure continued updates, users must:

  • 관련 제품의 새 SUSE Multi-Linux Manager Client Tools for XYZ 채널을 미러링하고 적절한 클라이언트에 할당합니다.

  • 사용 중지된 SUSE Manager Client Tools for XYZ 채널의 할당을 해제합니다.

This also means that any CLM projects based on the old client tools must be adjusted accordingly.

예시 워크플로는 Switch to new client tools channels에서 확인할 수 있습니다.

2. SLE Micro 5.5 to SL Micro 6.1

This document provides the tested procedure to upgrade a SLE Micro 5.5 host deployed with SUSE Multi-Linux Manager 5.0 Server to SL Micro 6.1 and migrate to SUSE Multi-Linux Manager 5.1.

2.1. Prerequisites

  • SUSE Multi-Linux Manager 5.0 is installed and running on SLE Micro 5.5.

  • System is registered and has active subscriptions with SCC.

2.2. Distribution upgrade and server migration

Procedure: Migration from SUSE Multi-Linux Manager 5.0 to SUSE Multi-Linux Manager 5.1
  1. 현재 제품 상태를 확인합니다.

    SUSEConnect --status-text

    확인:

    • Base OS: SUSE Linux Enterprise Micro 5.5

    • Extension: SUSE Manager Server 5.0 Extension

  2. 시스템이 업데이트되었는지 확인합니다.

    transactional-update patch
    • 패치가 적용된 경우 마이그레이션을 진행하기 전에 서버를 중지한 다음 시스템을 재부팅합니다.

      mgradm stop
      reboot
    • If no updates were found, you can proceed directly to the migration step.

  3. Start the migration.

    transactional-update migration --auto-agree-with-licenses --gpg-auto-import-keys

    Follow the prompts and select the available migration to SUSE Linux Micro 6.1 and SUSE Multi-Linux Manager Server Extension 5.1.

  4. 서버를 중지한 다음 재부팅하여 변경 사항을 적용합니다.

    mgradm stop
    reboot
  5. 재부팅 후 점검을 수행합니다.

    Verify upgraded OS and SUSE Multi-Linux Manager extension:

    cat /etc/os-release
    SUSEConnect --status-text

    You should see:

    • PRETTY_NAME="SUSE Linux Micro 6.1"

    • SUSE Multi-Linux Manager Server 5.1 Extension

      루트 SSH 액세스를 활성화합니다(필요한 경우). SL Micro 6.1은 기본적으로 SSH를 통한 루트 로그인을 비활성화합니다. etc/ssh/sshd_config.d/sshd.conf를 편집합니다.

      PermitRootLogin yes

      And restart the service:

      systemctl restart sshd

      For more information, see Remote root login on SL Micro.

  6. Verify SUSE Multi-Linux Manager tools

    mgradm --version

    Expected output:

    • 버전 5.1.11 이상

    • 5.1.0 이상 참조

  7. Upgrade server containers.

    mgradm upgrade podman

    Follow the prompts to pull and configure the new 5.1.0 containers.

  8. 실행 중인 컨테이너 확인:

    podman ps

    You should see:

    • server:5.1.0 이상

    • server-postgresql:5.1.0 이상

이전에 설치하지 않은 경우 업그레이드 중 uyuni-db 또는 saline 같은 서비스 누락 오류를 무시할 수 있습니다.

2.3. Migration complete

시스템은 현재 SL Micro 6.1에서 SUSE Multi-Linux Manager 5.1을 실행 중입니다. 프로덕션 운영을 재개하기 전에 설정을 확인하십시오. 이 서버에 SUSE Multi-Linux Manager 5.0 프록시가 연결된 경우, 프록시 호스트를 업그레이드하려면 Proxy Migration from 5.0 to 5.1 안내서를 참조하십시오.

2.4. Database Backup Volume

Server migration or upgrade with mgradm migration or mgradm upgrade can create a volume with the database backup.

When the PostgreSQL database version is increased, the old database must be stored in a separate location before running the upgrade. For this purpose mgradm dynamically creates the volume var-pgsql-backup. When the migration or upgrade is done and the user has validated that the new system is working as expected, this volume can be removed safely.

3. SUSE Linux Enterprise Server 15 SP6 to 15 SP7

This document provides the tested procedure to upgrade a SUSE Linux Enterprise Server 15 SP6 host deployed with SUSE Multi-Linux Manager 5.0 Server to SUSE Linux Enterprise Server 15 SP7 with SUSE Multi-Linux Manager 5.1.

3.1. Prerequisites

  • SUSE Multi-Linux Manager 5.0 is installed and running on SUSE Linux Enterprise Server 15 SP6.

  • The system is registered and has valid subscriptions in SUSE Customer Center (SCC).

  • Ensure backups are created before proceeding.

3.2. Distribution upgrade and server migration

Procedure: Migration from SUSE Multi-Linux Manager 5.0 to SUSE Multi-Linux Manager 5.1
  1. 현재 제품 상태를 확인합니다.

    SUSEConnect --status-text

    확인:

    • 기본 OS: SUSE Linux Enterprise Server 15 SP6

    • 확장: SUSE Manager Server 5.0 Extension

  2. Apply all system patches.

    zypper patch
  3. 서버를 중지한 후, 업데이트 스택이 업데이트된 경우 재부팅합니다.

    mgradm stop
    reboot
  4. Launch the Zypper migration tool.

    zypper migration

    Zypper에 가능한 마이그레이션 대상과 함께 자세한 요약 정보가 표시됩니다.

  5. 적절한 대상을 선택하고 프롬프트를 따라 마이그레이션을 완료합니다.

  6. After the migration completes, stop the server and then reboot the system.

    mgradm stop
    reboot
  7. 재부팅 후 점검 수행:

    Verify upgraded OS and SUSE Multi-Linux Manager extension.

    cat /etc/os-release
    SUSEConnect --status-text

    You should see:

    • VERSION="15-SP7"

    • SUSE Multi-Linux Manager Server 5.1 Extension for SLE

  8. Verify SUSE Multi-Linux Manager tools version.

    mgradm --version

    Expected output:

    • 버전 5.1.11 이상

    • 이미지 태그 5.1.0 이상

  9. Upgrade the server containers.

    mgradm upgrade podman

    Follow prompts to pull the new container images and reconfigure the environment.

  10. Check the running containers.

    podman ps

    Expected containers:

    • server:5.1.0 이상

    • server-postgresql:5.1.0 이상

3.3. Migration complete

시스템은 현재 SUSE Linux Enterprise Server 15 SP7에서 SUSE Multi-Linux Manager 5.1을 실행 중입니다. 프로덕션 운영을 재개하기 전에 설정을 검증하십시오. 이 서버에 SUSE Multi-Linux Manager 5.0 프록시가 연결된 경우, Proxy Migration from 5.0 to 5.1를 진행하십시오.

3.4. Database Backup Volume

Server migration or upgrade with mgradm migration or mgradm upgrade can create a volume with the database backup.

When the PostgreSQL database version is increased, the old database must be stored in a separate location before running the upgrade. For this purpose mgradm dynamically creates the volume var-pgsql-backup. When the migration or upgrade is done and the user has validated that the new system is working as expected, this volume can be removed safely.