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. 그룹 정책 설정 확인 (엔터프라이즈 배포): 시스템 관리자가 EnableAutoUpdates 그룹 정책을 통해 업데이트 알림을 비활성화했을 수 있습니다. 자세한 내용은 IT 부서에 문의하세요.
5. 이전에 버전을 건너뛴 경우: 현재 릴리스에 대해 이 버전 건너뛰기를 선택한 경우, 수동으로 업데이트를 확인하면 다시 표시됩니다.

Mattermost Desktop 수동 업데이트 방법#

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

macOS (App Store):

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

macOS (DMG 설치):

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

Windows (Microsoft Store):

8. Microsoft Store 애플리케이션을 엽니다.
9. 라이브러리 > 업데이트 받기로 이동합니다.
10. Mattermost를 찾아 업데이트를 선택합니다.

Windows (MSI 설치):

11. GitHub 릴리스 페이지 에서 최신 MSI 설치 관리자를 다운로드합니다.
12. MSI 설치 관리자를 실행합니다.
13. 설치 안내를 따릅니다(기존 설치를 업그레이드합니다).

Linux:

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

로그에 어떻게 접근하나요?#

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

앱 진단 정보는 어떻게 다운로드하나요?#

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

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

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

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

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

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

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

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

1. 로컬 Mattermost 데스크톱 앱 구성 파일을 삭제합니다. 파일 위치에 대한 자세한 내용은 위의 구성은 로컬 어디에 저장되나요? 섹션을 참조하세요.
2. 애플리케이션을 다시 설치합니다.

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

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

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

• Mattermost가 C:\Program Files\Mattermost 또는 C:\Program Files (x86)\Mattermost에 있는 경우: 머신별 설치(업그레이드가 정상적으로 작동함)
• Mattermost가 C:\Users\<YourName>\AppData\Local\...에 있는 경우: 사용자별 설치(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 'unresponsive' 이벤트가 발생했습니다"#

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

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 데스크톱 앱에서 발견된 문제를 보고할 때는 Developer Tools 콘솔의 내용과 함께 이 페이지의 정보 를 포함하면 도움이 됩니다.

Developer Tools 콘솔에 접근하려면:

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

데스크톱 앱에 추가된 각 서버에 대해 추가적인 개발자 도구 세트를 열 수 있습니다. 위의 단계에서 연 Developer Tools 콘솔에 다음 명령을 붙여넣어 도구를 열 수 있습니다:

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