시스템 관리_46 VMware Tools 미실행 및 구버전 경고와 자동 업그레이드 실패 원인 분석 및 완벽 해결 가이드

# 1. ESXi 호스트 관점: 대상 VM의 VMware Tools 상태 및 버전 정보 확인
$ vim-cmd vmsvc/get.guest 105 | grep -iE "toolsStatus|toolsVersion|toolsRunningStatus"
#    toolsStatus = "toolsOld",
#    toolsRunningStatus = "guestToolsNotRunning",
#    toolsVersion = "10346",
# -> 게스트 툴 데몬이 꺼져 있거나 구버전 상태로 확인

# 2. 리눅스 게스트 OS 관점: vmtoolsd 서비스 구동 여부 및 프로세스 확인
$ systemctl status vmtoolsd  # 또는 vmware-tools
# ● vmtoolsd.service - Service for virtual machines hosted on VMware
#      Loaded: loaded (/usr/lib/systemd/system/vmtoolsd.service; enabled; vendor preset: enabled)
#      Active: inactive (dead)
# -> 데몬이 중지되어 있어 vSphere vCenter와 통신이 두절된 상태 확인

# 3. 설치된 VMware Tools 유형 확인 (레거시 tar 배포본 vs OS 내장 open-vm-tools)
$ which vmware-toolbox-cmd
# /usr/bin/vmware-toolbox-cmd
$ vmware-toolbox-cmd -v
# 10.3.10.10540 (build-10540)
$ rpm -qa | grep -E "open-vm-tools|VMwareTools"  # 또는 dpkg -l | grep vm-tools
# (출력 없음 -> 과거 레거시 tar.gz 아카이브 방식으로 수동 컴파일 설치되어 패키지 매니저와 충돌 중)

# 4. vSphere의 가상 CD-ROM 마운트 상태 점검 (자동 업그레이드 실패 원인)
$ ls -l /dev/cdrom /dev/sr0
$ mount | grep -i iso9660
# /dev/sr0 on /mnt/cdrom type iso9660 (ro,relatime)
# -> 이전 업그레이드용 VMware Tools ISO가 마운트 해제되지 않아 신규 업그레이드 ISO 삽입 차단

# 5. 게스트 OS 시스템 로그에서 vmtoolsd 크래시 원인 확인
$ journalctl -u vmtoolsd -n 20 --no-pager

#!/bin/bash
# fix_vmware_tools.sh - Diagnose and fix VMware Tools not running and auto-upgrade failure

echo "=========================================="
echo " [VMware Tools 상태 진단 및 자동 복구기]"
echo "=========================================="

if [ "$EUID" -ne 0 ]; then
    echo "  [오류] 시스템 설정을 변경하려면 루트(root) 권한이 필요합니다."
    exit 1
fi

# 1. 가상화 환경 검증
VIRT_TYPE=$(systemd-detect-virt 2>/dev/null || dmidecode -s system-product-name 2>/dev/null)
echo -e "\n[1] 시스템 가상화 플랫폼 확인:"
echo "  - 감지된 플랫폼: ${VIRT_TYPE}"

if ! echo "$VIRT_TYPE" | grep -qi "vmware"; then
    echo "  [경고] VMware 가상 머신 환경이 아닙니다. 작업을 중단합니다."
    exit 1
fi

# 2. CD-ROM 마운트 잠금 점검 및 언마운트 (vSphere 자동 업그레이드 실패 주원인)
echo -e "\n[2] 가상 CD-ROM 잠금 상태 점검:"
LOCKED_CD=$(mount | grep -E "/dev/sr[0-9]|iso9660")
if [ -n "$LOCKED_CD" ]; then
    echo "  [감지] 마운트된 ISO 이미지가 있습니다:"
    echo "  $LOCKED_CD"
    echo "  -> 신규 VMware Tools ISO 마운트를 위해 강제 언마운트 시도..."
    umount -l /dev/sr0 2>/dev/null
    echo "  [완료] CD-ROM 언마운트 완료."
else
    echo "  [정상] 잠겨 있는 CD-ROM 마운트가 없습니다."
fi

# 3. 설치 형태 판별 (레거시 tar vs open-vm-tools)
echo -e "\n[3] 설치된 툴 버전 및 패키지 형태 점검:"
LEGACY_UNINSTALL="/usr/bin/vmware-uninstall-tools.pl"
PKG_INSTALLED=0

if rpm -qa 2>/dev/null | grep -q "open-vm-tools"; then
    PKG_INSTALLED=1
    echo "  - 패키지 타입: open-vm-tools (RPM 기반 배포판 공식 패키지)"
elif dpkg -l 2>/dev/null | grep -q "open-vm-tools"; then
    PKG_INSTALLED=1
    echo "  - 패키지 타입: open-vm-tools (DEB 기반 배포판 공식 패키지)"
fi

if [ -f "$LEGACY_UNINSTALL" ] && [ "$PKG_INSTALLED" -eq 0 ]; then
    echo "  [주의] 레거시 수동 컴파일(tar.gz) 방식의 VMware Tools가 설치되어 있습니다."
    echo "  -> 공식 권장 패키지(open-vm-tools)로의 전환이 필요합니다."
fi

# 4. vmtoolsd 서비스 활성화 및 재시작
echo -e "\n[4] vmtoolsd 서비스 상태 점검 및 복구:"
if ! command -v vmtoolsd &>/dev/null; then
    echo "  [경고] vmtoolsd 실행 파일이 없습니다. open-vm-tools 설치를 시도합니다."
    if command -v dnf &>/dev/null; then
        dnf install -y open-vm-tools
    elif command -v yum &>/dev/null; then
        yum install -y open-vm-tools
    elif command -v apt-get &>/dev/null; then
        apt-get update && apt-get install -y open-vm-tools
    fi
fi

systemctl daemon-reload
systemctl enable vmtoolsd >/dev/null 2>&1
systemctl restart vmtoolsd

sleep 2

# 5. 최종 결과 검증
if systemctl is-active --quiet vmtoolsd; then
    RUN_VER=$(vmware-toolbox-cmd -v 2>/dev/null || echo "설치됨")
    echo "  [성공] vmtoolsd 서비스가 정상 구동 중입니다. (버전: ${RUN_VER})"
    echo "  -> vSphere Client에서 약 1~2분 후 '실행 중(Running)' 상태로 갱신됩니다."
else
    echo "  [실패] vmtoolsd 서비스를 구동하지 못했습니다. journalctl -u vmtoolsd 로그를 확인하십시오."
fi

echo -e "\n=========================================="
echo " [점검 및 조치 완료]"
echo "=========================================="

# 구형 수동 설치본 언인스톨 스크립트 실행
if [ -f /usr/bin/vmware-uninstall-tools.pl ]; then
    /usr/bin/vmware-uninstall-tools.pl
fi

sudo systemctl daemon-reload
sudo systemctl enable --now vmtoolsd
sudo systemctl restart vmtoolsd