Proxmox 로 홈 서버 구축하기: (9) Major Version Upgrade

1. 현재 Version 확인

pveversion

기존에 8.1 을 쓰고 있었는데 어느덧 9.x 가 나왔고, 8.x Version은 2026년 8월까지만 서비스 된다는 사실을 알게 되었다.

우선 본인이 8.x Version 이라면 현재 Version 을 확인 해준다.

 

2. Minor Version upgrade

# 패키지 정보를 최신으로 업데이트
apt update
# 시스템의 모든 패키지를 최신 버전으로 업그레이드
apt dist-upgrade
# 재시작
reboot
# 다시 현재 proxmox version 확인
pveversion

8.4.1 Version 까지 마이너 버전 업데이트를 진행해준다. 8.4.1 에서만 9.x 버전으로 업데이트가 가능하다.

 

예전에 만나뵀던 분 중에 인프라 관리하시던 분이 OS 업그레이드 하실 때, 한 번에 점프가 안 되고 무조건 순차적으로 하나씩 올려야 된다고 얘기하셨던 적이 있는데, 바로 이 케이스인 모양이다.

 

 upgrade 와 달리  dist-upgrade 는 패키지 간의 의존성 변화를 감지하여, 필요 없는 패키지는 삭제하고, 새로운 커널 등의 중요한 패키지를 추가로 설치해준다. Proxmox에서는 일반 upgrade 대신 이 명령어를 권장한다.

 

만약 이 명령어를 수행 후, 재시작을 했는데도 현재 버전이 8.4.1 로 나오지 않는다면, 최초 설치 시에 8.2.2로 설치가 되었으나 enterpise 를 구독해제 하면서 리포지토리에 최신 목록 업데이트가 안 되는 상태가 되었고, 그렇기 때문에 8.2.2 버전은 최신 상태로 인식하고 있기 때문이다. 그러므로 리포지토리 설정을 추가해주어야 한다.

 

3. no-subscription repo 추가

no-subscription repo 추가 전

Datacenter > pve (node 이름) > Updates > Repositories

No Proxmox VE repository is enabled, you do not get any updates!

어떤 업데이트도 되지 않는다는 Error 메시지가 보인다.

 

no-subscription repo 추가 + enterprise 비활성

# 1) Proxmox VE 8 no-subscription repo 추가
cat > /etc/apt/sources.list.d/pve-no-subscription.list << 'EOF'
deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
EOF

# 2) enterprise repo 주석 처리 (GUI에서 Disable 한 것과 동일, 혹시 몰라 한 번 더)
if [ -f /etc/apt/sources.list.d/pve-enterprise.list ]; then
  sed -i 's/^deb /#deb /' /etc/apt/sources.list.d/pve-enterprise.list
fi

# 3) 패키지 인덱스 갱신
apt update

# 4) 업데이트
apt dist-upgrade

# 5) 재시작
reboot

 

no-subscription repo 추가 후

You get updates for Proxmox VE

// 전
pve-manager/8.2.2/9355359cd7afbae4 (running kernel: 6.8.4-2-pve)
// 후
pve-manager/8.4.16/368e3c45c15b895c (running kernel: 6.8.12-18-pve)

업데이트가 완료되었다.

 

4. Major Version Upgrade 를 위한 패키지 설치

# 설치 후, 실행
apt install pve8to9
pve8to9 --full

 

FAILURES 가 하나라도 발생할 시

SUMMARY 위를 다시 천천히 올라가서 로그를 보면 어떤 패키지가 FAIL 인지, 출력된다.

FAIL: systemd-boot meta-package installed. This will cause problems on upgrades of other boot-related packages. Remove 'systemd-boot' See https://pve.proxmox.com/wiki/Upgrade_from_8_to_9#sd-boot-warning for more information.

systemd-boot 는 이미 설치되어있으므로 제거하라는 안내 메시지가 나온다. 해당 안내메시지에 따라 제거해준다.

• WARNNINGS 해결

# 권고 설정 적용
echo 'grub-efi-amd64 grub2/force_efi_extra_removable boolean true' | debconf-set-selections -v -u
apt install --reinstall grub-efi-amd64

# sysctl.conf 마이그레이션
cp /etc/sysctl.conf /etc/sysctl.conf.backup
grep -v '^#' /etc/sysctl.conf | grep -v '^$' > /etc/sysctl.d/99-custom.conf
echo "" > /etc/sysctl.conf
sysctl --system

# AMD microcode 설치 (unstable repo 이용)
### == CPU Model 체크 후 ==
lscpu | grep "Model name"

### == 설치 ==
cat > /etc/apt/sources.list.d/unstable-microcode.list << 'EOF'
deb http://deb.debian.org/debian unstable main non-free-firmware
EOF
cat > /etc/apt/preferences.d/unstable-microcode << 'EOF'
Package: *
Pin: release a=unstable
Pin-Priority: 1
EOF

apt update
apt install amd64-microcode

rm /etc/apt/sources.list.d/unstable-microcode.list
rm /etc/apt/preferences.d/unstable-microcode

apt update

※ WARNINGS 는 크리티컬한 문제가 아니므로, FAILURES 만 제거해도 무방합니다.

• FAILURES 해결

# systemd-boot 메타 패키지 제거
apt remove systemd-boot

# 재시작
reboot

# 재실행
pve8to9 --full

 

FAILURES 가 0 이면 성공

 

5. Major Version Upgrade

Backup

tar czf /root/pve-backup-$(date +%Y%m%d).tar.gz /etc/pve /etc/network/interfaces /etc/hosts /etc/hostname

 

Repo를 bookworm → trixie로 변경

# Debian sources.list 전체 trixie로
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list

# Proxmox no-subscription repo도 trixie로 (deb822 형식으로 새로)
cat > /etc/apt/sources.list.d/pve-no-subscription.sources << 'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

# 기존 pve-no-subscription.list 백업 후 삭제
mv /etc/apt/sources.list.d/pve-no-subscription.list /root/pve-no-subscription.list.bak 2>/dev/null || true

 

확인

apt update
apt policy pve-manager

 

드디어 Upgrade

apt dist-upgrade
# apt-listchanges 화면에서 q 눌러서 빠져나온다.
# /etc/ssh/sshd_config: deprecated DSA 등 제거되니 Y.
# /etc/lvm/lvm.conf: Proxmox 최적화 변경 있으니 Y.
# GRUB 관련: 이전에 재설치했으니 Y.

설치 시간이 상당히 오래 걸리므로 다른 거하고 있으면 된다. 중간에 질문에 Y 를 해주어야  upgrade 가 마저 되는 부분만 

 

재시작 후, 확인

reboot
pveversion  # pve-manager/9.x/... 확인
pve8to9 --full  # 후속 체크 (클러스터 없으니 대부분 PASS)

 

6. 결과