Network

VMware vCenter Server Appliance CLI Subnet 수정 가이드

vCenter Server Appliance에서 CLI로 IP와 서브넷을 수정하는 절차입니다. 변경 전 백업, systemd-networkd 적용, DNS/FQDN 검증, 롤백까지 정리했습니다.

devmes

• 조회 82

vCenter Server Appliance(VCSA)의 IP 주소나 서브넷을 CLI에서 수정할 때는 단순히 파일 하나만 바꾸고 끝내면 안 됩니다. vCenter는 관리 평면의 중심이기 때문에 잘못된 IP, prefix, gateway, DNS를 넣으면 vSphere Client와 ESXi 연결이 모두 끊길 수 있습니다. 절차의 vami_get_network 확인 흐름에 맞춰 변경 전 백업, 콘솔 접속, 적용, 검증, 롤백 순서로 정리합니다.

변경 전 확인할 것

  • VCSA 콘솔 또는 VMRC로 접속 가능한지 확인합니다. SSH만 믿고 작업하면 네트워크 변경 실패 시 복구가 어렵습니다.
  • 새 IP, prefix 길이, gateway, DNS, FQDN 정방향/역방향 DNS를 미리 확정합니다.
  • ESXi 호스트와 백업/모니터링 시스템이 vCenter를 IP로 참조하는지 FQDN으로 참조하는지 확인합니다.
  • vCenter 인증서에 IP/FQDN이 포함되어 있는 환경이면 인증서 영향도 확인합니다.

현재 네트워크 확인

/opt/vmware/share/vami/vami_get_network
ip -br addr
ip route
resolvectl status 2>/dev/null || cat /etc/resolv.conf
hostname -f

vami_get_network는 VCSA의 네트워크 설정을 빠르게 보는 데 유용합니다. 실제 인터페이스 이름은 환경에 따라 eth0가 아닐 수 있으므로 ip -br addr로 먼저 확인합니다.

설정 백업

sudo cp -a /etc/systemd/network/10-eth0.network \
 /etc/systemd/network/10-eth0.network.bak.$(date +%Y%m%d-%H%M%S)

sudo cp -a /etc/resolv.conf \
 /etc/resolv.conf.bak.$(date +%Y%m%d-%H%M%S)

파일 이름은 VCSA 버전과 구성에 따라 다를 수 있습니다. /etc/systemd/network/ 아래 파일을 먼저 확인합니다.

ls -al /etc/systemd/network/
cat /etc/systemd/network/*.network

네트워크 파일 수정

sudo vi /etc/systemd/network/10-eth0.network

예시는 192.168.1.10/24로 바꾸는 경우입니다. 실제 운영 값으로 수정해야 합니다.

[Match]
Name=eth0

[Network]
Address=192.168.1.10/24
Gateway=192.168.1.1
DNS=8.8.8.8
DNS=8.8.4.4

Address의 /24는 서브넷 마스크 255.255.255.0을 의미합니다. /25, /26처럼 prefix가 달라지면 사용 가능한 IP 범위와 gateway가 달라질 수 있으므로 네트워크 설계와 맞는지 확인합니다.

적용

콘솔 접속 상태에서 적용합니다. 원격 SSH 세션은 끊길 수 있습니다.

sudo systemctl restart systemd-networkd

네트워크 변경 후 SSH가 끊기면 새 IP로 접속합니다. 콘솔에서는 아래 명령으로 바로 확인합니다.

/opt/vmware/share/vami/vami_get_network
ip -br addr
ip route
ping -c 3 192.168.1.1
nslookup $(hostname -f) 8.8.8.8

vCenter 서비스 상태 확인

service-control --status --all
curl -kI https://127.0.0.1/ui/
curl -kI https://192.168.1.10/ui/

vCenter UI 접근이 안 되면 네트워크 문제인지, vCenter 서비스 문제인지 분리해야 합니다. IP 변경 직후에는 DNS 캐시나 브라우저 캐시 때문에 구 IP로 접근하는 경우도 있습니다.

DNS와 FQDN 확인

nslookup vcsa.example.com
nslookup 192.168.1.10
hostname -f

vCenter는 FQDN 의존성이 강합니다. IP만 바꾸고 DNS A/PTR 레코드를 갱신하지 않으면 SSO, 인증서, ESXi reconnect, 백업 솔루션 연동에서 문제가 생길 수 있습니다.

롤백

새 IP로 통신이 되지 않으면 콘솔에서 백업 파일을 되돌립니다.

sudo cp -a /etc/systemd/network/10-eth0.network.bak.YYYYMMDD-HHMMSS \
 /etc/systemd/network/10-eth0.network

sudo systemctl restart systemd-networkd
/opt/vmware/share/vami/vami_get_network
ip route

변경 후 확인 항목

  1. 새 IP로 vSphere Client 접속이 되는지 확인합니다.
  2. ESXi 호스트가 vCenter에서 connected 상태인지 확인합니다.
  3. DNS 정방향/역방향 조회가 새 IP와 일치하는지 확인합니다.
  4. 백업, 모니터링, 스크립트, 방화벽 정책에서 구 IP를 참조하는 항목이 없는지 확인합니다.
  5. 인증서 경고가 새로 생겼는지 확인합니다.
BGM EVER