v6.1.0으로 업그레이드 후 바로가기 손상 (Windows MSI 전용)#

이전 릴리즈에서 Windows MSI 설치 관리자를 사용하여 Mattermost Desktop v6.1.0으로 업그레이드한 후, 데스크톱 또는 작업 표시줄 바로가기에 잘못된 아이콘이 표시되거나 실행에 실패할 수 있습니다. 이는 향후 업그레이드의 바로가기 안정성을 개선하기 위한 Windows MSI 설치 관리자의 일회성 아이콘 처리 변경으로 인한 것입니다.

이 문제는 앱 사용을 차단하지 않으며 v6.1.0 이전 버전에서 Windows MSI 설치 관리자 업그레이드에만 영향을 줍니다. 사용자는 시작 메뉴 또는 작동 중인 데스크톱 바로가기에서 Mattermost를 실행할 수 있습니다.v6.1.1 이상으로의 향후 업그레이드에서는 바로가기 재생성이 필요하지 않습니다.

이 문제를 해결하려면 바로가기를 다시 만드세요:

1. 작업 표시줄의 손상된 바로가기를 마우스 오른쪽 버튼으로 클릭하고 작업 표시줄에서 제거를 선택합니다.
2. 시작 메뉴 또는 작동 중인 데스크톱 바로가기에서 Mattermost Desktop을 실행합니다.
3. 애플리케이션이 실행 중인 동안 작업 표시줄의 Mattermost 아이콘을 마우스 오른쪽 버튼으로 클릭합니다.
4. 작업 표시줄에 고정을 선택합니다.

새 바로가기는 이후 모든 업그레이드에서 올바르게 작동합니다.

Windows 설치를 표준화하는 조직은 Windows Store(자동 업데이트 권장) 또는 MSI 패키지(기존 배포) 중에서 선택할 수 있습니다. MSI 방법에는 이 일회성 바로가기 조정이 포함되며, Windows Store 방법에는 포함되지 않습니다.

구성이 로컬에 저장되는 위치는 어디입니까?#

Mattermost 데스크톱 앱 구성 파일의 위치는 Mattermost를 실행하는 플랫폼(macOS의 경우 앱 설치 방법)에 따라 다릅니다:

• Windows: Users\<username>\AppData\Roaming\Mattermost
• macOS 설치 관리자: /Users/<username>/Library/Application Support/Mattermost
• macOS App Store: /Users/<username>/Library/Containers/Mattermost.Desktop/Data/Library/Application Support/Mattermost (Finder 통해: ~/Library/Application Support/Mattermost, 확장자가 숨겨져 있음)
• Linux: ~/.config/Mattermost

업데이트 알림이 표시되지 않음#

새 버전이 제공될 때 인앱 업데이트 알림이 표시되지 않는 경우:

1. 인터넷 연결 확인: mattermost.com에 대한 아웃바운드 HTTPS 통신이 허용되는지 확인합니다.
2. 업데이트 수동 확인: 도움말 > 업데이트 확인 또는 설정 > 일반 > 지금 업데이트 확인으로 이동하여 즉시 확인을 트리거합니다.
3. 업데이트 알림 활성화 확인:
   • Windows에서: … > 파일 > 설정으로 이동하여 자동으로 업데이트 확인이 활성화되어 있는지 확인합니다.
   • macOS에서: Mattermost > 설정으로 이동하여 자동으로 업데이트 확인이 활성화되어 있는지 확인합니다.
4. 그룹 정책 설정 확인 (엔터프라이즈 배포): 시스템 관리자가 EnableAutoUpdater 그룹 정책을 통해 업데이트 알림을 비활성화했을 수 있습니다. 자세한 내용은 IT 부서에 문의하세요.
5. 이전에 건너뛴 버전: 현재 릴리즈에 대해 이 버전 건너뛰기를 선택했다면 수동으로 업데이트를 확인하여 다시 볼 수 있습니다.

업데이트 필요 화면#

Mattermost 서버 v11.6.0부터 시스템 관리자는 System Console > Site Configuration > Customization > Minimum desktop app version에서 최소 데스크톱 앱 버전을 설정할 수 있습니다. 데스크톱 앱 버전이 설정된 최소값보다 낮으면 업데이트 필요 화면이 표시되며 업데이트할 때까지 Mattermost에 접근할 수 없습니다.

화면에는 관리자가 구성한 앱 다운로드 페이지로 연결되는 다운로드 버튼이 포함되어 있습니다. 다운로드를 선택하여 해당 페이지로 이동한 후 플랫폼에 맞는 수동 업데이트 단계를 따르세요.

앱이 이미 최신 버전이라고 생각되면 시스템 관리자에게 구성된 최소 버전을 확인하세요.

Mattermost Desktop 수동 업데이트 방법#

v6.1.0부터 Mattermost Desktop 업데이트는 수동으로 이루어집니다. 플랫폼에 맞는 단계를 따르세요:

macOS (App Store):

1. App Store 애플리케이션을 엽니다.
2. 업데이트 섹션으로 이동합니다.
3. Mattermost Desktop을 찾아 업데이트를 선택합니다.

macOS (DMG 설치):

1. https://mattermost.com/download 또는 GitHub 릴리즈 페이지에서 최신 DMG를 다운로드합니다.
2. 다운로드한 DMG 파일을 엽니다.
3. Mattermost 애플리케이션을 응용 프로그램 폴더로 드래그하여 기존 버전을 교체합니다.
4. Mattermost Desktop을 재시작합니다.

Windows (Microsoft Store):

1. Microsoft Store 애플리케이션을 엽니다.
2. 라이브러리 > 업데이트 가져오기로 이동합니다.
3. Mattermost를 찾아 업데이트를 선택합니다.

Windows (MSI 설치):

1. GitHub 릴리즈 페이지에서 최신 MSI 설치 관리자를 다운로드합니다.
2. MSI 설치 관리자를 실행합니다.
3. 설치 안내를 따릅니다(기존 설치가 업그레이드됩니다).

Linux:

1. GitHub 릴리즈 페이지를 방문합니다.
2. 배포판에 적합한 패키지(AppImage, .deb, .rpm, Flatpak 등)를 다운로드합니다.
3. 패키지 관리자 또는 표준 설치 방법을 사용하여 설치합니다.

로그에 접근하는 방법은 무엇입니까?#

Mattermost 데스크톱 v5.3부터 도움말 > 로그 보기를 통해 로그에 접근할 수 있으며, 로그 파일의 위치를 보여주는 파일 관리자 창이 열립니다.

앱 진단을 다운로드하는 방법은 무엇입니까?#

Mattermost 데스크톱 v5.3부터 도움말 > 진단 실행을 통해 진단 텍스트 파일을 다운로드할 수 있으며, 지원 티켓에 첨부할 수 있습니다.

멀티뷰에서 딥 링크가 잘못된 워크스페이스에서 열림#

딥 링크가 잘못된 워크스페이스에서 열리는 경우, 모든 관련 워크스페이스가 그룹 정책 DefaultServerList를 통해 사전 프로비저닝되어 있는지 확인하세요. 자세한 내용은 멀티뷰 및 그룹 정책 문서를 참조하세요.

• 링크가 의도한 워크스페이스로 라우팅되도록 워크스페이스 URL이 정확히 일치하는지 확인합니다(프로토콜 및 서브도메인 포함).
• 워크스페이스 목록을 편집하여 오래된 항목을 수정하거나 제거한 다음 링크를 다시 시도합니다.

여러 워크스페이스가 열려 있을 때 CPU 또는 메모리 과다 사용#

여러 워크스페이스를 동시에 실행하기에 충분한 성능의 디바이스인지 확인하세요. 사용하지 않는 탭과 팝아웃 창을 닫아 부하를 줄입니다.

데스크톱 앱 고급 설정을 확인합니다. 드라이버가 불안정한 시스템에서는 GPU 하드웨어 가속 사용을 끄세요.

데스크톱 앱이 시작 시 흰 화면을 표시하고 페이지를 로드하지 않음#

1. 로컬 Mattermost desktop app 구성 파일을 삭제합니다. 파일 위치는 위의 구성이 로컬에 저장되는 위치는 어디입니까? 섹션을 참조하세요.
2. 애플리케이션을 재설치합니다.

v6.1.0으로 업그레이드 실패 또는 중복 버전 설치 (Windows MSI)#

v6.1.0 MSI를 설치한 후 이전 버전이 계속 표시되거나, 두 버전이 모두 존재하거나, 업그레이드가 작동하지 않는 것처럼 보입니다. 이는 v5.9에서 v6.0.4까지의 per-user 설치가 있었기 때문입니다. v6.1.0부터 MSI 설치 관리자는 기본적으로 per-machine(시스템 전체) 설치를 사용합니다. MSI 설치 관리자는 서로 다른 설치 컨텍스트(per-user에서 per-machine으로) 간에 자동으로 업그레이드할 수 없습니다.

업그레이드하기 전에 설치 유형을 확인하려면 파일 탐색기를 엽니다.

• Mattermost가 C:\Program Files\Mattermost 또는 C:\Program Files (x86)\Mattermost에 있는 경우: Per-machine 설치(업그레이드가 정상적으로 작동함)
• Mattermost가 C:\Users\\AppData\Local\...에 있는 경우: Per-user 설치(v6.1.0 전에 수동으로 제거해야 함)

이 문제를 해결하려면 v6.1.0을 설치하기 전에 이전 버전을 수동으로 제거해야 합니다:

1. 두 버전을 모두 제거합니다:
   • 설정 > 앱 또는 제어판 > 프로그램 및 기능으로 이동합니다.
   • 모든 Mattermost Desktop 항목을 제거합니다.
2. 릴리즈 페이지에서 v6.1.0 MSI 설치 관리자를 다시 다운로드합니다.
3. 관리자 권한으로 v6.1.0을 설치합니다(C:\Program Files\Mattermost에 설치됨).
4. 이후 업그레이드는 정상적으로 작동합니다.

"설치에 실패했습니다" 대화상자#

앱 데이터가 손상되었을 수 있습니다. %LOCALAPPDATA%\mattermost의 모든 파일을 제거한 다음 앱을 다시 설치해 보세요.

"'Mattermost' 애플리케이션을 열 수 없습니다" 대화상자#

macOS Catalina에서 Mac Archive Utility가 파일 압축 해제의 기본 방법인 경우 이 대화상자가 표시될 수 있습니다. 이 경우 Keka 또는 Unarchiver와 같은 서드파티 도구를 사용하면 문제가 해결될 수 있습니다.

데스크톱 앱 창이 검게 표시되고 페이지를 로드하지 않음#

1. 사용 가능한 최신 데스크톱 앱 버전이 설치되어 있는지 확인합니다.
2. 보기 > 캐시 지우기 및 새로고침을 선택하거나 Windows 또는 Linux에서 Ctrl Shift R을, Mac에서 ⌘ ⇧ R을 눌러 캐시를 지우고 앱을 다시 로드합니다.
3. 앱을 종료하고 재시작하여 문제가 해결되는지 확인합니다.
4. GPU 하드웨어 가속을 비활성화합니다.

• Windows 또는 Linux에서는 파일 > 설정을 선택하고 GPU 하드웨어 가속 사용 옵션을 해제합니다.
• macOS에서는 Mattermost > 설정을 선택하고 GPU 하드웨어 가속 사용 옵션을 해제합니다.

5. Optimus와 같은 특수 비디오 드라이버를 사용하는 경우 비활성화하면 문제가 해결되는지 확인합니다.

데스크톱 앱 창이 흰색으로 표시되고 페이지를 로드하지 않음#

1. 사용 가능한 최신 데스크톱 앱 버전이 설치되어 있는지 확인합니다.
2. 로컬 컴퓨터에서 %userprofile%\AppData\Roaming\Mattermost 디렉터리를 삭제합니다.
3. 데스크톱 앱을 재설치합니다.

데스크톱 앱이 표시되지 않지만 작업 표시줄에 Mattermost 아이콘이 있음#

이 문제는 다중 모니터 설정을 사용하는 Windows에서 발생할 수 있습니다. Mattermost가 표시되던 모니터를 분리하면 Mattermost는 더 이상 존재하지 않는 화면 좌표에 계속 표시됩니다.

이 문제를 해결하려면 화면 위치 파일을 삭제하여 데스크톱 앱의 화면 위치를 초기화할 수 있습니다. 파일이 없으면 데스크톱 앱은 기본적으로 기본 모니터에 표시됩니다.

데스크톱 앱 화면 위치를 초기화하려면:

1. 데스크톱 앱이 실행 중인 경우 작업 표시줄의 Mattermost 아이콘을 마우스 오른쪽 버튼으로 클릭한 다음 창 닫기를 선택합니다.
2. Windows 파일 탐색기를 열고 %APPDATA%\Mattermost 폴더로 이동합니다.
3. bounds-info.json 파일을 삭제합니다.

데스크톱 앱이 페이지를 지속적으로 새로고침함#

이 문제는 localStorage에 예상치 못한 상태가 있을 때 발생할 수 있습니다. 문제를 해결하려면:

• Windows: Windows 파일 탐색기를 열고 %APPDATA%\Mattermost 폴더로 이동한 다음 Local Storage 폴더를 삭제합니다.
• Mac: Finder를 열고 ~/Library/Application Support/Mattermost 폴더로 이동한 다음 Local Storage 폴더를 삭제합니다.
• Linux: 파일 관리자를 열고 ~/.config/Mattermost 폴더로 이동한 다음 Local Storage 폴더를 삭제합니다. Linux 파일 관리자는 기본적으로 마침표로 시작하는 폴더를 숨길 수 있습니다. 터미널에서 rm -rf ~/.config/Mattermost를 사용하여 삭제할 수 있습니다.

데스크톱 앱이 지속적으로 Mattermost 서버 로그인을 요청함#

이 문제는 앱 데이터가 손상되는 데스크톱 앱의 충돌 또는 예기치 않은 종료 후에 발생할 수 있습니다. 문제를 해결하려면:

• Windows: Windows 파일 탐색기를 열고 %APPDATA%\Mattermost 폴더로 이동한 다음 IndexedDB 폴더와 Cookies 및 Cookies-journal 파일을 삭제합니다.
• Mac: Finder를 열고 ~/Library/Application Support/Mattermost 폴더로 이동한 다음 IndexedDB 폴더와 Cookies 및 Cookies-journal 파일을 삭제합니다.
• Linux: 파일 관리자를 열고 ~/.config/Mattermost 폴더로 이동한 다음 IndexedDB 폴더와 Cookies 및 Cookies-journal 파일을 삭제합니다. Linux 파일 관리자는 기본적으로 마침표로 시작하는 폴더를 숨길 수 있습니다. 터미널에서 rm -rf ~/.config/Mattermost를 사용하여 삭제할 수 있습니다.

"내부 오류: BrowserWindow '응답 없음' 이벤트가 발생되었습니다"#

대화상자에서 세부 정보 표시를 선택하면 로그가 제공됩니다. 문제 해결 방법:

1. 보기 > 캐시 지우기 및 새로고침으로 캐시를 지우거나 Windows 또는 Linux에서 Ctrl Shift R을, Mac에서 ⌘ ⇧ R을 누릅니다.
2. 파일 > 설정으로 앱 설정으로 이동하거나(Windows 또는 Linux에서 Ctrl ,을, Mac에서 ⌘ ,을 눌러) 하드웨어 가속을 선택 해제합니다.

Citrix Virtual Apps 또는 데스크톱 환경에서 데스크톱 앱이 응답하지 않음#

레지스트리 키 HKLM\SYSTEM\CurrentControlSet\Services\CtxUvi\UviProcessExcludes에 Mattermost.exe;를 추가하고 시스템을 재부팅합니다.

추가 지원이 필요하면 이전에 보고된 오류에 대해 문제 해결 포럼을 검토하거나, 문제 해결 도움을 위해 Mattermost 사용자 커뮤니티에 참여하세요.

Linux에서 snap을 사용하여 설치한 데스크톱 앱을 제거할 수 있습니까?#

예. 터미널 창에서 다음 명령을 실행하세요: sudo snap remove mattermost-desktop.

데스크톱 앱 문제 보고#

Mattermost 데스크톱 앱에서 발견된 문제를 보고할 때, 개발자 도구 콘솔 내용과 이 페이지의 정보를 함께 포함하는 것이 도움이 됩니다.

개발자 도구 콘솔에 접근하려면:

1. 메뉴 바에서 보기 > 개발자 도구 > 현재 탭의 개발자 도구로 이동합니다.
2. 콘솔 탭을 선택합니다.
3. 로그 항목을 마우스 오른쪽 버튼으로 클릭한 다음 다른 이름으로 저장을 선택합니다.
4. 파일을 저장한 다음 문제 설명과 함께 보냅니다.
5. 콘솔을 닫아 개발자 도구를 비활성화합니다.

데스크톱 앱에 추가한 각 서버에 대한 추가 개발자 도구 세트를 열 수 있습니다. 위에 설명된 단계로 연 개발자 도구 콘솔에 이 명령을 붙여넣어 도구를 열 수 있습니다:

document.getElementsByTagName("webview")[0].openDevTools();