MID 서버 업그레이드 전 검사

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분

    • 업그레이드 전에 MID 서버는 테스트를 실행하여 업그레이드 프로세스 실패의 원인이 되거나 MID 서버가 중단될 수 있는 문제를 식별합니다.

    각 MID 서버에는 MID 서버 버전을 인스턴스의 버전과 비교하여 MID 서버를 업그레이드해야 하는지 여부를 결정하는 자동 업그레이드 모니터가 포함되어 있습니다. 자동 업그레이드 모니터에서 MID 서버 버전이 최신 버전이 아님을 발견하면 모니터는 해당 MID 서버에 대한 업그레이드 전 유효성 검사 테스트를 실행합니다. 문제가 탐지되면 MID 서버 문제 [ecc_agent_issue] 테이블에 메시지가 로깅되고 업그레이드가 차단됩니다. 자동 업그레이드 모니터는 모든 테스트를 통과할 때까지 매시간 계속 실행됩니다. 차단 문제가 없는 경우 MID 서버는 적절한 업그레이드 패키지를 다운로드하고 업그레이드 프로세스를 시작합니다. MID Server 업그레이드 전 검사는 수동 업그레이드뿐만 아니라 인스턴스가 업그레이드될 때 인스턴스에서 트리거된 업그레이드에 대해서도 실행됩니다.

    업그레이드 전 테스트

    업그레이드 전은 필수 테스트와 경고 테스트라는 두 가지 테스트 집합을 실행합니다. MID 서버 업그레이드를 시작하려면 모든 필수 테스트를 통과해야 합니다. 필수 테스트에 통과하지 못한 경우 테스트가 에이전트 로그에 기록되고 MID 서버 문제 [ecc_agent_issue] 테이블에 MID 서버 활성 문제가 생성됩니다. 이러한 오류는 실제 MID 서버 업그레이드가 발생하기 전에 게시되며 업그레이드를 계속하려면 먼저 해결해야 합니다. MID 서버는 업그레이드 프로세스를 중지하고 상태를 기반으로 MID 서버 상태변경합니다. 경보 테스트를 통과하지 못한 경우 에이전트 로그와 MID 서버 문제 테이블에 메시지가 추가되지만 업그레이드 전 검사가 계속되고 MID 업그레이드가 중지되지 않습니다.

    업그레이드 전 유효성 검사 테스트에서는 다음과 같은 필수 테스트를 확인합니다.
    • 최소 1GB의 디스크 여유 공간
    • install.service-now.com 에서 다운로드 사이트에 액세스
    • 다운로드한 샘플 파일의 디지털 서명 확인
    • 다음을 포함하는 실행 권한입니다.
      • 임시 폴더에 Zip 아카이버의 압축을 풉니다.
      • 임시 폴더에서 에이전트 폴더로 파일 복사
      • 텍스트 파일 읽기 및 내용 확인
      • 업그레이드 전 검사 내용 삭제
    • MID 서버 호스트 머신이 32비트 시스템이 아닙니다.
    • Linux MID Server에서 glibC 버전은 2.17 이상입니다.
    Windows MID Server에서 업그레이드 전 확인은 다음 경보 테스트를 실행합니다.
    • 모든 MID 서버 업그레이드 차단 서비스가 호스트 머신에서 실행되고 있습니다.
    • 호스트 컴퓨터의 애플리케이션 환경 상태Status of application experience on the host machine
    • MID 서버는 관리자가 아닌 사용자로 실행해야 합니다. MID 서버의 현재 로그온 사용자 계정이 LocalSystem 이거나 Administrators 그룹에 속한 사용자인 경우 업그레이드가 실패하고 오류 로그가 생성됩니다.

    업그레이드를 차단하는 오류

    이러한 메시지는 필수 테스트 실패를 설명하며 MID 서버 문제[ecc_agent_issue] 테이블에 게시됩니다. 이러한 테스트 중 하나라도 실패하면 업그레이드가 차단됩니다.
    사용 가능한 디스크 공간이 부족합니다. 시스템에서 <n>바이트의 여유 공간을 보고합니다.
    이 메시지는 MID 서버 호스트에서 1GB 미만의 사용 가능한 디스크 공간이 감지될 때 표시됩니다. 이 오류는 MID 서버 에이전트 로그에도 기록됩니다.
    설치 서버에서 업데이트를 다운로드할 수 없음
    이 메시지는 MID 서버 호스트에 install.service-now.com 에서 설치 패키지를 다운로드할 수 있는 권한이 없거나 네트워크 문제로 인해 연결할 수 없음을 나타냅니다. 이 오류는 MID 서버 에이전트 로그에도 기록됩니다.
    서명 확인 실패:<message>
    이 메시지는 업그레이드 전 검사에서 다운로드한 검사 파일의 디지털 서명을 확인하려고 할 때 확인 예외가 발생했음을 나타냅니다.
    디지털 서명을 확인할 수 없음:<message>
    이 메시지는 확인 서명 프로세스가 예외로 인해 중단되었음을 나타냅니다.
    업그레이드 전 검사 zip의 내용을 추출할 수 없음
    이 메시지는 MID 서버 호스트의 서비스 계정에 임시 폴더로 업그레이드 전 ZIP 보관을 추출할 수 있는 권한이 없음을 나타냅니다.
    폴더를 생성할 수 없습니다<업그레이드 확인 파일 경로>
    이 메시지는 MID 서버 서비스 계정에 에이전트/패키지 경로에서 업그레이드 전 검사 파일에 대한 upgradeCheck 폴더를 생성할 수 있는 권한이 없음을 나타냅니다.
    파일 권한을 확인할 수 없음: <message>
    이 메시지는 존재하지 않는 파일 또는 액세스 실패와 같은 파일 권한을 확인할 때 예외가 발생했음을 나타냅니다.
    MID 서버 Windows 서비스가 LocalSystem 또는 로컬 관리자로 실행되고 있지 않습니다.
    이 메시지는 Windows 서비스가 원하는 권한으로 실행되고 있지 않음을 경고합니다.
    업그레이드 실패: 호스트 시스템이 MID 서버를 업그레이드하기 위한 최소 시스템 요구 사항을 충족하지 않습니다.
    MID 업그레이드는 32비트 호스트에서 지원되지 않습니다. 자세한 내용은 KB0863694 참조하십시오.
    업그레이드 실패: 호스트가 MID Server를 업그레이드하기 위한 최소 시스템 요구 사항을 충족하지 않습니다. 자세한 내용은 GlibC 라이브러리에 대한 MID Server 제품 설명서를 참조하십시오.
    이 오류는 Linux MID Server에만 발생할 수 있습니다. 자세한 내용은 Java 버전 지원을 참조하십시오.

    비차단 경고

    이러한 경고는 MID 서버 문제 [ecc_agent_issue] 테이블에 표시되며 Windows MID 서버의 업그레이드를 방해하지 않습니다.
    $logOnAsUser 구문 분석할 수 없음
    이 메시지는 Windows 서비스의 사용자로 로그온 값이 다음과 같은 예상 형식 중 하나가 아님을 경고합니다.
    • user@domain.company.com
    • 도메인\사용자
    사용자 그룹으로 로그온을 조회할 수 없음

    인스턴스가 로그온한 사용자의 그룹 구성원 자격을 조회하려고 하면 net user <username> 명령을 실행합니다. 인스턴스는 이 명령에서 Windows 서비스의 특정 출력 구조를 예상하고 예상 출력이 실제 출력과 일치하지 않으면 이 경고를 발행합니다.

    이러한 PowerShell 경고는 MID 서버 에이전트 로그에만 기록됩니다. PowerShell은 MID 서버를 사용할 필요가 없으므로 이러한 구성 문제로 인해 Windows MID 서버를 업그레이드할 수 있습니다. 그러나 이러한 경고는 주의가 필요한 사용자 환경의 문제를 나타낼 수 있습니다.

    PowerShell을 사용할 수 없으므로 PowerShell 업그레이드 검사를 건너뛰는 중
    PowerShell 3.0 이상이 설치되어 있지 않거나 MID 서버 서비스 사용자가 powershell.exe 사용할 수 없습니다.
    Powershell 테스트 건너뛰는 중: 대상 폴더가 초기화되지 않았습니다.
    Powershell 테스트 건너뛰는 중: 서비스 이름을 검색할 수 없음
    MID Server 호스트 시스템에서 실행 중인 Service CiscoAMP는 MID Server 업그레이드 차단기로 식별됩니다.
    자세한 내용은 KB0870329 참조하십시오.
    MID 서버 호스트에서 애플리케이션 환경이 비활성화되어 자동 업그레이드 프로세스가 실패하고 MID 서버가 다운될 수 있습니다. 성공적인 자동 업그레이드를 위해 호스트에서 서비스 사용 설정
    자세한 내용은 KB0597552 참조하십시오.
    업그레이드를 계속하지만 upgradeCheck 중에 다음 문제가 발생했습니다: <예외 메시지>
    이 메시지는 업그레이드 전 테스트의 PowerShell 부분을 실행하는 동안 문제가 발생했음을 나타냅니다.

    업그레이드 전 검사 비활성화

    mid.upgrade.run_precheck이라는 MID 서버 구성 매개변수는 기본적으로 true로 설정되어 자동 사전 업그레이드 테스트를 실행할 수 있습니다. 단일 MID 서버에 대해 이러한 테스트를 비활성화하려면 이 매개변수를 해당 MID 서버의 config.xml 파일에 추가하고 False로 설정합니다. 모든 MID 서버에 대해 이러한 테스트를 비활성화하려면 mid.upgrade.run_precheck라는 MID 서버 속성 [ecc_agent_property] 테이블에 새 레코드를 추가합니다. 이 속성 값을 false 로 설정하고 MID 서버 필드를 비워 둡니다.