Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
이 페이지의 내용
 

Marvis Windows 클라이언트

사전 설치 작업을 완료한 다음 Windows 디바이스에 Marvis 클라이언트를 설치하는 데 사용할 방법을 선택합니다.

Windows용 Marvis 클라이언트는 Windows 디바이스가 무선 네트워크와 상호 작용하는 방식에 대한 자세한 가시성을 제공합니다. Marvis 클라이언트는 디바이스 연결 및 성능에 대한 인사이트를 제공하여 네트워크 성능을 최적화하고, 문제 해결을 간소화하며, 전반적인 사용자 경험을 향상시키는 데 도움이 됩니다.

Marvis Windows 클라이언트 설치 개요

주니퍼 Mist 포털에서 Windows용 Marvis 클라이언트(marvisclient-installer.msi 파일)를 다운로드할 수 있습니다.

주니퍼 Mist 포털에서 .msi 파일을 다운로드하려면

  1. 왼쪽 메뉴에서 조직 > 관리자 > 모바일 SDK 를 선택합니다.

  2. 모바일 SDK 페이지 상단의 Marvis Client 를 클릭합니다.

  3. Windows에서 앱 버전을 선택한 다음 설치 관리자 다운로드를 클릭합니다.

  4. marvisclient-installer.zip에서 marvisclient-installer.msi 파일을 추출합니다.

.msi 파일을 장치의 폴더에 저장합니다.

Marvis Windows 클라이언트의 설치 옵션

다음 설치 옵션 중 하나를 사용할 수 있습니다.

사전 요구 사항

시작하기 전에 다음이 필요합니다.

  • .Net Framework 런타임(4.6.2 이상) 이 장치에 설치되어 있습니다.

    참고:

    Marvis Windows 클라이언트를 설치한 후 나중에 이러한 애플리케이션을 설치하도록 선택할 수 있습니다. 그러나 나중에 응용 프로그램을 설치하려면 장치를 다시 시작해야 합니다.

  • Marvis 클라이언트를 온보딩하기 위한 비밀 토큰 또는 QR 코드입니다.

    1. 왼쪽 메뉴에서 조직 > 관리자 > 모바일 SDK 를 선택합니다.

    2. 모바일 SDK 페이지 상단의 토큰을 클릭합니다.

    3. 새 토큰을 만들거나 기존 토큰을 사용합니다.

      • 새 토큰의 경우— 초대 생성을 클릭합니다. 이 초대의 이름을 입력하고 만들기를 클릭합니다. 페이지에 토큰이 나타나면 보기 를 클릭하여 QR 코드를 확인합니다.

      • 기존 토큰의 경우—토큰 이름을 참조하여 사용할 토큰을 찾습니다. 페이지 오른쪽에 있는 보기 링크를 클릭하면 QR 코드를 볼 수 있습니다.

    참고: API를 사용하여 비밀 토큰을 얻으려면 https://api.mist.com/api/v1/docs/Org#sdk-invite 를 참조하십시오.

  • 디바이스에서 실행되는 Windows 10 이상 릴리스

  • Marvis 클라이언트가 클라이언트 디바이스에서 Wi-Fi 텔레메트리를 수집할 수 있도록 위치 서비스 활성화

    이 컨텍스트에서 위치 서비스는 Windows에서 사용할 수 있는 장치 수준 위치 설정을 나타냅니다. 클라이언트 실시간 위치 서비스는 Windows 디바이스에서 지원되지 않습니다.

    참고:

    Windows 11 버전 24H2 이상을 실행하는 디바이스에서 Marvis 클라이언트는 위치 서비스가 활성화된 경우에만 무선 네트워크의 BSSID를 가져올 수 있습니다. 위치 서비스를 비활성화하면 Marvis 클라이언트가 절전 모드로 전환됩니다.

    이 동작은 24H2 이전의 Windows 11 버전에서는 다릅니다. 이러한 버전에서는 위치 서비스의 상태가 Marvis 클라이언트의 상태에 영향을 주지 않습니다. Marvis 클라이언트는 활성화 또는 비활성화된 위치 서비스와 관계없이 무선 네트워크의 BSSID를 가져옵니다. 위치 서비스가 활성화되거나 비활성화되어도 Marvis 클라이언트는 연결됨 상태로 유지됩니다.

운영 모드

Marvis 클라이언트는 다음 모드에서 작동합니다.

  • 온보딩 모드 - GUI 방법을 사용하여 Marvis 클라이언트 앱을 설치할 때의 기본 모드입니다. 이 모드에서는 NAC 포털을 통해 디바이스를 온보딩할 수 있습니다.

  • 텔레메트리 모드 - CLI 메서드를 사용하여 Marvis 클라이언트 앱을 설치할 때의 모드입니다. 이 모드는 라이브 환경의 표준 운영 모드입니다.

온보딩을 위한 Marvis Client 구성

Marvis Client 앱을 사용하여 사용자 지정 NAC(Network 액세스 Control) 포털을 통해 디바이스를 주니퍼 Mist Access Assurance 네트워크에 온보딩할 수 있습니다. 자세한 내용은 Marvis Client 앱을 사용하여 NAC 포털을 통한 클라이언트 온보딩을 참조하십시오.

텔레메트리 모드에서 작동하도록 Marvis Windows 클라이언트 구성

Marvis 클라이언트가 텔레메트리 모드에서 작동하도록 하려면 CLI 메서드를 사용하여 Marvis Windows 클라이언트를 설치해야 합니다.

Marvis Windows 클라이언트 설치(GUI 방식)

GUI 방법을 사용하여 Marvis Windows 클라이언트를 설치하면 Marvis 클라이언트가 온보딩 모드로 설치됩니다. Marvis Windows 클라이언트를 설치하려면 다음을 수행합니다.
  1. 주니퍼 Mist 포털에서 다운로드한 marvisclient-installer.msi 파일을 두 번 클릭합니다.
  2. 예를 클릭하여 설치를 계속합니다.
  3. 설치가 성공했는지 확인합니다. 설치가 완료되면 시스템 트레이에 Marvis 아이콘이 표시됩니다.
  4. 시스템 트레이에서 Marvis 아이콘을 클릭하여 Marvis 클라이언트 앱을 엽니다. 메뉴를 보려면 아이콘을 마우스 오른쪽 버튼으로 클릭합니다.
이제 Marvis 클라이언트 앱을 사용하여 NAC 포털을 통해 디바이스를 온보딩할 수 있습니다. Marvis Client 앱을 사용하여 NAC 포털을 통한 클라이언트 온보딩을 참조하십시오.

Marvis Windows 클라이언트 설치(CLI 방식)

설치 중에 고급 사용자 지정을 수행하려는 경우 CLI 메서드를 사용하여 Marvis 클라이언트 앱을 설치할 수 있습니다.

  1. 관리자 또는 관리자 권한이 있는 사용자로 명령 프롬프트 창을 엽니다.
  2. marvisclient-installer.msi 파일을 저장한 폴더로 이동합니다.
  3. 다음 옵션 중 하나를 사용하여 비밀 SDK 토큰을 사용하여 클라이언트를 설치합니다.
    참고:

    관리자 권한을 사용하여 Marvis 클라이언트를 자동 모드로 설치해야 합니다. Windows 11의 경우 설치 명령 끝에 자동 모드 매개변수 /qn 를 입력해야 msiexec 합니다. Windows 10의 경우 매개 변수 배치 /qn 에 제한이 없습니다.

    • 기본 구성:

    • 사용자 지정 구성:

      표 1에 나열된 추가 매개 변수를 구성하여 설치를 사용자 지정할 수 있습니다. 예를 들면 다음과 같습니다.

      표 1: Marvis Client 설치를 위한 사용자 지정 구성 매개 변수

      매개변수

      설명

      MOBILE_SDK_시크릿

      조직의 SDK 초대 코드 또는 비밀

      MIST_BATTERY_SAVING

      클라이언트가 페이로드를 보내는 빈도를 결정합니다. 다음 배터리 절약 모드 중 하나를 사용할 수 있습니다.

      • 높음: 데이터 전송 주파수가 감소하면 이 모드는 배터리 전원을 절약하는 데 도움이 됩니다. 이 모드는 업데이트 빈도가 낮은 시나리오에 적합합니다.

      • 표준: 이 모드는 데이터와 배터리 소모 간의 균형을 제공하여 배터리 수명에 큰 영향을 주지 않으면서 더 자주 업데이트를 제공합니다.

      • 낮음:

        데이터 전송 빈도가 가장 높은 이 모드는 네트워크 성능에 대한 가장 자세한 통찰력을 제공합니다. 그러나 이 모드는 다른 모드에 비해 더 많은 배터리 전원이 필요합니다.
       

      MIST_LOG_LEVEL

      Marvis 클라이언트에 대한 로그 수준을 정의합니다.

      MIST_UI_ENABLED

      설치하는 동안 Marvis 클라이언트 UI를 숨기거나(value=True) 표시(value=False)합니다. 기본값은 true입니다.

      프록시 서버 설정

      MIST_PROXY_URL

      포트를 포함한 프록시 서버의 전체 URL입니다.

      MIST_PROXY_BYPASS_LIST

      프록시 설정을 적용하지 않으려는 호스트 목록입니다.

      MIST_PROXY_USERNAME

      사용자 이름(프록시 서버에 인증이 필요한 경우 필수).

      MIST_PROXY_PWD

      암호(프록시 서버에 인증이 필요한 경우 필요).
  4. 설치가 성공했는지 확인합니다. Windows용 Marvis Client 설치 확인을 참조하십시오.

Marvis Windows 클라이언트 설치(구성 파일 방법)

변환 파일을 사용하여 Marvis 클라이언트를 설치할 수 있으며, 이를 통해 사용자 지정 또는 대량 설치가 가능합니다.
  1. 변환 파일을 설정합니다. 변환 파일(*.mst)은 기본 설치를 사용자 지정하기 위한 구성 매개 변수를 .msi 파일에 제공합니다. 표 1에 나열된 구성 매개 변수를 사용할 수 있습니다.

    변환 파일 설정에 대한 자세한 내용은 [ORCA 편집기(대체 도구)]를 사용하여 MSI 파일을 편집하는 방법을 참조하십시오.

  2. 명령 프롬프트 창을 열고 다음 명령을 입력합니다.

MDM을 사용하여 Windows 디바이스에 Marvis Client 구축

SOTI 또는 Intune MDM(모바일 디바이스 관리) 솔루션을 사용하여 Windows 디바이스에 Marvis 클라이언트를 배포할 수 있습니다. 시작하기 전에 모든 디바이스에 적절한 MDM 프로필 및 권한이 할당되어 있는지 확인하십시오.

MDM을 사용하여 디바이스를 등록하고 관리하는 방법에 대한 내용은 다음 항목을 참조할 수 있습니다.

Intune MDM을 사용하여 Marvis Windows 클라이언트 배포

Intune MDM을 사용하여 Marvis 클라이언트를 배포하려면 다음을 수행합니다.

  1. Intune에 대상 디바이스를 등록합니다.

  2. Intune 포털에서 .msi 설치 관리자를 Windows LOB(기간 업무) 앱으로 추가합니다.

  3. 필요한 정책을 구성하고 다음 설치 후 스크립트를 포함합니다.

    매개 변수에 대한 자세한 내용은 표 1 을 참조하십시오.

    정책 유형(필수 또는 제안)에 따라 Marvis 클라이언트 앱은 직접 설치되거나 회사 포털에 설치할 수 있는 선택적 앱으로 표시됩니다.

  4. MDM 포털에서 설치 상태를 확인하여 배포가 성공했는지 확인합니다.

Intune에서 Marvis Windows 클라이언트 업그레이드

최신 버전의 Marvis 클라이언트로 업그레이드하려면 Intune 포털에서 기존 .msi 파일을 최신 버전으로 바꿉니다. 설치 후 스크립트는 변경할 필요가 없습니다. 업데이트가 Intune 포털에 반영되는 데 다소 시간이 걸릴 수 있습니다.

Intune에서 Marvis Windows 클라이언트 구성 업데이트

Marvis 클라이언트 구성 매개 변수를 업데이트하려면 대상 디바이스의 레지스트리 값을 변경하고 시스템을 다시 시작할 수 있습니다. 이 방법을 사용하면 재설치하지 않고 구성을 업데이트할 수 있습니다. 구성 스크립트를 업데이트하고 레지스트리를 신중하게 조정하여 앱 기능과 사용자 환경을 사용자 정의하세요.

  1. 다음 레지스트리 경로에서 Marvis 클라이언트 구성 값을 업데이트합니다.

    경로: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\주니퍼\Marvis\Config

    값: MOBILE_SDK_SECRET, MIST_BATTERY_SAVING

    매개 변수에 대한 자세한 내용은 표 1을 참조하십시오.

    참고:

    Marvis 클라이언트가 설치된 후에는 레지스트리를 통해 MIST_UI_ENABLED 매개 변수를 업데이트할 수 없습니다.

  2. 레지스트리 업데이트 스크립트를 만듭니다. PowerShell을 사용하여 다음과 같이 레지스트리 값을 업데이트합니다.

    일부 구성 변경은 디바이스를 다시 시작해야 할 수 있습니다. 필요한 경우 스크립트 끝에 restart 명령을 포함합니다.

  3. 레지스트리 업데이트 스크립트를 배포합니다.

    디바이스 구성 > 스크립트로 이동하여 스크립트를 디바이스 그룹에 할당합니다.

Intune MDM을 사용하여 Marvis Windows 클라이언트 제거

Marvis 클라이언트를 제거하려면 다음을 수행합니다.

  1. Intune에서 애플리케이션 할당을 취소합니다. 대상 디바이스에 대해 Marvis 클라이언트 설치를 강제하는 정책을 제거합니다.

  2. CLEAN=true 매개 변수를 사용하여 스크립트를 생성하여 Marvis 클라이언트를 완전히 제거합니다.

  3. 제거 스크립트를 배포합니다. 디바이스 구성 > 스크립트 를 사용하고 PowerShell 스크립트를 디바이스 그룹에 할당합니다.

    참고:

    제거가 완료된 후 향후 설치 시 충돌을 방지하기 위해 제거 규칙에서 디바이스를 제거해야 합니다.

SOTI MDM을 사용하여 Marvis Windows 클라이언트 구축

SOTI MDM을 사용하여 Marvis 클라이언트를 구축하려면 다음을 수행합니다.

  1. 대상 Windows 디바이스가 SOTI MobiControl에 등록되어 있고 관리 콘솔에 연결되어 있는지 확인하십시오.

  2. Marvis 클라이언트에 대한 .msi 설치 프로그램을 업로드합니다.

    1. SOTI MobiControl에서 응용 프로그램 추가로 이동하고 Windows > Enterprise Apps를 선택합니다.

    2. Marvis 클라이언트에 대한 .msi 설치 프로그램을 선택하고 SOTI 서버에 업로드합니다.

  3. Marvis 클라이언트 앱을 SOTI 내의 적절한 디바이스 또는 디바이스 그룹에 할당합니다. 배포 설정에 따라 애플리케이션이 자동으로 설치되거나 요청 시 사용할 수 있습니다.

  4. 구성에 필요한 환경 변수를 사용하여 SOTI에서 별도의 스크립트 작업을 생성합니다.

SOTI에서 Marvis Windows 클라이언트 업그레이드

SOTI에서 Marvis 클라이언트를 업그레이드하려면 다음을 수행합니다.

  1. Marvis 클라이언트의 현재 .msi 설치 프로그램을 SOTI의 업데이트된 설치 프로그램으로 교체합니다.

  2. 애플리케이션을 다시 할당합니다.

    정책은 할당에 따라 업데이트된 설치 관리자를 디바이스에 푸시합니다.

SOTI에서 Marvis Windows 클라이언트 구성 업데이트

레지스트리 편집을 통해 구성 업데이트를 직접 적용할 수 있습니다.

  1. 다음 레지스트리 경로에서 Marvis 클라이언트 구성 값을 업데이트합니다.

    경로: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\주니퍼\Marvis\Config

    값: MOBILE_SDK_SECRET, MIST_BATTERY_SAVING, MIST_UI_ENABLED

  2. 레지스트리 업데이트 스크립트를 만듭니다. PowerShell을 사용하여 다음과 같이 레지스트리 값을 업데이트합니다.

    일부 구성 변경에는 시스템 재시작이 필요할 수 있습니다. 필요한 경우 스크립트 끝에 restart 명령을 포함합니다.

  3. 레지스트리 업데이트 스크립트를 배포합니다. 작업 기능을 사용하여 이 PowerShell 스크립트를 대상 디바이스에 배포합니다.

SOTI MDM을 사용하여 Marvis Windows 클라이언트 제거

Marvis 클라이언트를 제거하려면 다음을 수행합니다.

  1. SOTI에서 애플리케이션 할당을 취소합니다. 대상 디바이스에 대해 Marvis 클라이언트 설치를 강제하는 정책을 제거합니다.

  2. 매개 변수를 사용하여 Marvis 클라이언트를 완전히 제거하는 스크립트를 CLEAN=true 만듭니다.

  3. 제거 스크립트를 배포합니다. 작업 기능을 사용하여 이 PowerShell 스크립트를 대상 디바이스에 배포합니다.

    참고:

    클라이언트를 제거한 후 향후 설치 시 충돌을 방지하기 위해 제거 규칙에서 디바이스를 제거해야 합니다.

Windows용 Marvis Client 설치 확인

다음 옵션 중 하나를 사용하여 Marvis 클라이언트가 성공적으로 설치되었는지 확인합니다.

  • 서비스 확인:

    1. 작업 관리자를 열고 서비스 탭으로 이동합니다. 또는 Windows Service Manager(compmgmt.msc)를 사용할 수 있습니다.

    2. MarvisClient 서비스가 실행 중인지 확인합니다.

  • 파일 및 시스템 레지스트리 확인:

    1. 파일이 C:/Program Files(x86)/주니퍼 네트웍스/Mist/Marvis 폴더에 있는지 확인합니다.

    2. 시스템 레지스트리로 이동하여 구성 변수가 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\주니퍼\Marvis\Config 아래에 나열되어 있는지 확인합니다.

  • Marvis 클라이언트 아이콘이 시작 폴더 C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp에 표시되는지 확인합니다.

연결 상태

Marvis 클라이언트 상태는 다음과 같은 시각적 표시기와 연결 상태로 표시됩니다. Marvis 클라이언트가 텔레메트리 모드에 있는 경우에만 이러한 상태를 볼 수 있습니다.

  • 연결 끊김 - 클라이언트가 주니퍼 Mist 클라우드에 연결되어 있지 않습니다.

  • 연결됨 - 클라이언트가 주니퍼 Mist 클라우드에 연결되어 있습니다.

  • 절전 모드 —클라이언트가 비 주니퍼 AP를 통해 주니퍼 Mist 클라우드에 연결됩니다.

참고: Windows 11 버전 24H2 이상을 실행하는 디바이스에서 Marvis 클라이언트는 위치 서비스가 활성화된 경우에만 무선 네트워크의 BSSID를 가져올 수 있습니다. 위치 서비스를 비활성화하면 Marvis Client가 절전 모드로 전환됩니다.

Marvis Windows 클라이언트에서 로그 보기

Marvis Windows 클라이언트는 로그를 다음과 같이 분류합니다.

  • 정보 - 일반 정보

  • 오류—중요한 문제

  • 디버그 - 문제를 디버깅하는 데 사용할 수 있는 상세 데이터

Marvis Windows 클라이언트 앱에서 로그를 보려면 앱에서 디버그 모드를 활성화해야 합니다.
  1. 햄버거 아이콘을 클릭하고 정보를 선택한 다음 버전 번호를 7번 누릅니다.

    메뉴에 로그 옵션이 나열되어 있습니다.

  2. 로그를 선택합니다. 로그 수준 드롭다운 목록에서 옵션을 선택하여 보려는 정보 유형을 선택할 수 있습니다.

    선택한 로그 수준에 따라 최근 로그가 표시됩니다.

    복사 버튼을 클릭하여 로그 세부 정보를 복사하고 문제 해결을 위해 지원 팀에 데이터를 보낼 수 있습니다.

  3. 보기를 클릭하여 OS별 로그 뷰어에서 Marvis 클라이언트가 캡처한 로그를 확인합니다.
    참고:

    문제를 해결하기 위해 주니퍼 Mist 지원팀에 문의하는 경우 조직 ID, UUID, 조직 이름과 같은 세부 정보를 제공하라는 요청을 받을 수 있습니다. 이러한 세부 정보는 햄버거 메뉴에서 액세스할 수 있는 정보 페이지에서 확인할 수 있습니다.

    정보 페이지의 정보는 Marvis 클라이언트의 운영 모드에 따라 다릅니다.

    • 온보딩 모드 - 애플리케이션 버전 및 UUID, 사용자 정보, 조직 이름
    • 텔레메트리 모드 - 애플리케이션 버전 및 UUID, 사용자 정보, 조직 이름
    • 디버그 모드 - 애플리케이션 버전 및 UUID, 사용자 정보, 조직 이름, 조직 ID

Marvis Windows 클라이언트 제거

이름 변경 또는 파일 경로 위치 변경과 같은 주요 변경을 수행한 경우에만 Marvis 클라이언트를 제거합니다. 사소한 업데이트 또는 조직 변경으로 인해 Marvis 클라이언트를 제거할 필요가 없습니다.

Marvis 클라이언트를 제거하려면 다음을 수행합니다.

  1. 기기에서 설정 > 앱으로 이동합니다.
  2. 애플리케이션 목록에서 MarvisClient 를 검색합니다.
  3. ...를 클릭하고 제거를 선택합니다.

Marvis 클라이언트가 디바이스에서 제거됩니다.

참고:

클라이언트를 제거해도 모든 로그 파일 및 폴더가 제거되지 않을 수 있습니다. 필요한 경우 파일을 수동으로 삭제하도록 선택할 수 있습니다. 모든 로그 및 구성 파일과 함께 Marvis 클라이언트를 완전히 제거하려면 다음 명령을 사용합니다.