RPM을 사용하여 AlloyDB Omni의 마이너 버전 업그레이드 수행

문서 버전을 선택합니다.

이 페이지에서는 Red Hat Package Manager (RPM)를 사용하여 AlloyDB Omni의 마이너 데이터베이스 버전 업그레이드를 수행하고, 업그레이드된 설치를 확인하고, 필요한 경우 이전 마이너 버전으로 롤백하는 방법을 설명합니다. 마이너 버전 업그레이드는 데이터베이스 바이너리를 인플레이스 방식으로 업데이트하고 데이터 마이그레이션 없이 기존 구성 및 데이터 파일을 보존합니다.

이 페이지의 안내는 독립형 단일 노드 배포와 멀티 노드 토폴로지의 개별 데이터베이스 노드(예: 읽기 복제본 또는 고가용성 대기 노드가 있는 배포)에 적용됩니다. 설정에 따라 다음 사항을 고려하세요.

  • 멀티 노드 토폴로지: 기본 노드를 업그레이드하기 전에 항상 모든 복제본 및 대기 노드를 업그레이드합니다. 고가용성 설정에서 이전 기본 노드를 업그레이드하기 전에 업그레이드된 대기 노드로 전환을 수행합니다.
  • Monitoring 에이전트 (alloydbomni_monitor): 선택사항인 alloydbomni_monitor 패키지를 설치한 경우 각 호스트에서 alloydbomni18와 함께 alloydbomni_monitor를 업그레이드합니다.

시작하기 전에

  1. 패키지를 업그레이드하려면 데이터베이스 서비스를 일시적으로 중지해야 하므로 유지보수 기간 또는 짧은 서비스 다운타임을 계획합니다.
  2. 업그레이드를 시작하기 전에 데이터베이스를 전체 백업하는 것이 좋습니다. 자세한 내용은 백업 및 복원 개요를 참조하세요.
  3. 멀티 노드 토폴로지를 업그레이드하는 경우 대기 및 복제본 노드를 먼저 업그레이드할 수 있도록 현재 기본 노드와 모든 대기 또는 복제본 노드를 식별합니다.
  4. 업그레이드하기 전에 현재 AlloyDB Omni 데이터베이스 버전을 확인합니다.

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

사용 가능한 업데이트 확인하기

로컬 패키지 캐시를 업데이트하고 이후 버전의 alloydbomni18 패키지를 확인합니다.

sudo dnf makecache
sudo dnf check-update alloydbomni18

alloydbomni_monitor 패키지를 설치한 경우 모니터링 에이전트에 사용 가능한 업데이트가 있는지 확인합니다.

sudo dnf check-update alloydbomni_monitor

비공개 저장소 확인

선택사항: 비공개 YUM 저장소를 통해 또는 인터넷 액세스가 없는 환경에서 패키지를 관리하는 경우 다음 명령어를 실행하여 저장소 구성을 검사하고 사용 가능한 패키지 버전을 확인할 수 있습니다.

  1. REPOID 환경 변수를 비공개 저장소의 ID로 설정합니다.

    export REPOID=REPO_ID

    REPO_ID를 비공개 YUM 저장소의 저장소 ID(예: alloydbomni)로 바꿉니다.

  2. 현재 AlloyDB Omni 설치를 제공한 저장소를 확인합니다.

    sudo dnf list installed alloydbomni18
  3. 사용 설정된 모든 저장소와 저장소 ID를 나열합니다.

    sudo dnf repolist
  4. 비공개 저장소의 메타데이터를 확인합니다.

    sudo dnf repoinfo $REPOID
  5. 저장소에서 사용할 수 있는 모든 alloydbomni18 패키지 버전을 나열합니다.

    sudo dnf --showduplicates list available alloydbomni18

AlloyDB Omni 업그레이드

AlloyDB Omni 설치를 이후 마이너 버전으로 업그레이드하려면 각 노드에서 다음 단계를 수행합니다. 멀티 노드 토폴로지에서 기본 노드를 업그레이드하기 전에 각 대기 또는 복제본 노드에서 다음 단계를 완료합니다.

  1. AlloyDB Omni 데이터베이스 서비스를 중지합니다.

    sudo systemctl stop alloydbomni18

    alloydbomni_monitor 서비스를 설치한 경우 이 서비스도 중지합니다.

    sudo systemctl stop alloydbomni_monitor
  2. 업데이트된 AlloyDB Omni RPM 패키지를 설치합니다.

    sudo dnf upgrade -y alloydbomni18

    이 명령어는 데이터베이스 데이터 디렉터리를 그대로 유지하면서 AlloyDB Omni 패키지와 바이너리를 업데이트합니다.

    alloydbomni_monitor 패키지를 설치한 경우 데이터베이스 패키지와 함께 업그레이드합니다.

    sudo dnf upgrade -y alloydbomni_monitor
  3. AlloyDB Omni systemd 서비스를 시작합니다.

    sudo systemctl start alloydbomni18

    alloydbomni_monitor 서비스를 중지한 경우 다시 시작합니다.

    sudo systemctl start alloydbomni_monitor

업그레이드 확인

RPM 패키지를 업그레이드하고 서비스를 시작한 후 데이터베이스 서비스가 업데이트된 버전을 실행 중인지 확인합니다.

  1. AlloyDB Omni 서비스의 상태를 확인하고 active (running)인지 확인합니다.

    sudo systemctl status alloydbomni18

    alloydbomni_monitor를 업그레이드한 경우 모니터 서비스도 active (running)인지 확인합니다.

    sudo systemctl status alloydbomni_monitor
  2. 데이터베이스에 연결하고 업그레이드된 버전이 활성 상태인지 확인합니다.

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

업그레이드 롤백

AlloyDB Omni 설치를 이전 마이너 버전으로 되돌려야 하는 경우 다음 단계를 따르세요.

  1. AlloyDB Omni 데이터베이스 서비스를 중지합니다.

    sudo systemctl stop alloydbomni18

    alloydbomni_monitor 서비스를 설치한 경우 이 서비스도 중지합니다.

    sudo systemctl stop alloydbomni_monitor
  2. alloydbomni18 패키지의 사용 가능한 모든 버전을 나열하고 이전 설치의 정확한 버전 문자열을 식별합니다.

    sudo dnf --showduplicates list alloydbomni18
  3. alloydbomni18 패키지를 이전 버전으로 다운그레이드합니다.

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    ROLLBACK_VERSION을 이전 설치의 정확한 버전 문자열(예: 18.1.0-3.rhel9)로 바꿉니다.

    alloydbomni_monitor도 다운그레이드해야 하는 경우 사용 가능한 버전을 나열하고 이전 모니터 패키지 버전으로 다운그레이드합니다.

    sudo dnf --showduplicates list alloydbomni_monitor
    sudo dnf downgrade -y alloydbomni_monitor-MONITOR_ROLLBACK_VERSION

    MONITOR_ROLLBACK_VERSION를 이전 alloydbomni_monitor 패키지 버전 문자열로 바꿉니다.

  4. AlloyDB Omni systemd 서비스를 시작합니다.

    sudo systemctl start alloydbomni18

    alloydbomni_monitor 서비스를 중지한 경우 다시 시작합니다.

    sudo systemctl start alloydbomni_monitor
  5. AlloyDB Omni 서비스가 활성 상태이고 이전 버전을 실행 중인지 확인합니다.

    sudo systemctl status alloydbomni18
    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

다음 단계