InfoGrab Docs

모바일 배포 문제 해결

요약

먼저 서버 URL에 오탈자가 없는지 확인하고 서버 배포 구성에 따라 http:// 또는 https://가 포함되어 있는지 확인하세요. 서버 URL이 올바른 경우 SSL 인증서 구성에 문제가 있을 수 있습니다. SSL 인증서 설정을 확인하려면 SSL Labs와 같은 사이트를 방문하여 테스트하세요.

"서버에 연결할 수 없습니다. 서버 URL과 인터넷 연결을 확인하세요." 메시지가 계속 나타납니다#

먼저 서버 URL에 오탈자가 없는지 확인하고 서버 배포 구성에 따라 http:// 또는 https://가 포함되어 있는지 확인하세요.

서버 URL이 올바른 경우 SSL 인증서 구성에 문제가 있을 수 있습니다.

SSL 인증서 설정을 확인하려면 SSL Labs와 같은 사이트를 방문하여 테스트하세요. 누락된 체인이나 인증서 경로에 대한 오류가 있으면 포함되어야 하는 중간 인증서가 누락된 것일 수 있습니다.

앱은 자체 서명된 인증서가 있는 서버에 연결할 수 없으므로 대신 Let's Encrypt를 사용하는 것을 고려하세요.

ADFS/Office365 로그인이 작동하지 않습니다#

Microsoft 지침에 따라 WIA를 지원하지 않는 장치에 대한 인트라넷 양식 기반 인증 구성을 권장합니다.

사라지지 않는 "연결 중..." 막대가 표시됩니다#

앱이 제대로 작동하면 앱이 다시 연결된 후 사라지거나 "연결됨"이라고 표시되는 회색 "연결 중..." 막대가 표시됩니다.

이 메시지가 항상 표시되고 인터넷 연결이 정상인 경우, 서버 관리자에게 서버가 NGINX 또는 다른 웹 서버를 역방향 프록시로 사용하는지 확인하세요. 그렇다면 APIv4 엔드포인트에 대한 WebSocket 연결 지원을 위해 올바르게 구성되어 있는지 확인해야 합니다.

모든 아웃바운드 연결이 프록시를 통해야 합니다. Mattermost 호스팅 푸시 알림 서비스에 어떻게 연결할 수 있나요?#

아래 단계에 따라 내부 서버를 설정하여 네트워크에서 Mattermost 호스팅 푸시 알림 서비스(HPNS)로의 연결을 프록시할 수 있습니다:

  1. 프록시 서버가 SSL을 지원하도록 올바르게 구성되어 있는지 확인합니다. https://www.digicert.com/help/에서 URL을 확인하여 작동 여부를 확인합니다.
  2. https://push.mattermost.com으로 요청을 전달하는 프록시를 설정합니다.
  3. Mattermost에서 5.12 이전 버전에서는 시스템 콘솔 > 알림 설정 > 모바일 푸시 > 푸시 알림 활성화를, 5.12 이후 버전에서는 시스템 콘솔 > 환경 > 푸시 알림 서버 > 푸시 알림 활성화를 "푸시 알림 서비스 위치 수동 입력"으로 설정합니다.
  4. 푸시 알림 서버 필드에 프록시의 URL을 입력합니다.
Note

프록시가 구성된 방식에 따라 포트 번호를 추가하고 https://push.mattermost.com에 매핑된 https://push.internalproxy.com:8000과 같은 URL을 만들어야 할 수도 있습니다.

빌드가 bundleReleaseJsAndAssets에서 멈춥니다#

해결 방법으로 먼저 js를 수동으로 번들링할 수 있습니다:

react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/

그런 다음 다음 명령으로 gradle 작업을 무시합니다:

./gradlew assembleRelease -x bundleReleaseJsAndAssets

모바일 앱에서 이미지 미리 보기를 사용할 수 없습니다#

이는 Mattermost를 실행하는 서버의 MIME 유형이 올바르게 설정되지 않은 경우 발생할 수 있습니다.

Linux를 실행하는 서버에는 /etc/mime.types에 이 파일이 있습니다. 이는 특정 OS 및 배포판에 따라 다를 수 있습니다.

일부 배포판은 mailcap 없이 제공되어 MIME 유형이 누락되거나 잘못 구성될 수 있습니다.

모바일 앱에서 이모지가 포함된 메시지가 전송되지 않습니다#

이는 Mattermost를 실행하는 서버가 잘못된 문자 집합으로 구성된 경우 발생할 수 있습니다. 이 문제를 해결하려면 config.json 파일의 SqlSettings 아래에서 DataSource 키가 올바르게 구성되어 있는지 확인한 다음 Mattermost 서버를 다시 시작하세요.

예시:

"SqlSettings": {
    "DataSource": "<user:pass>@<servername>/mattermost?charset=utf8mb4,utf8",
    [...]
  }

연결 문자열 구성에 대한 자세한 내용은 구성 설정 문서를 참조하세요.

모바일 푸시 알림 테스트#

사전 빌드된 모바일 앱 또는 커스텀 빌드 모바일 앱에 대한 푸시 알림을 구성했는지 확인하세요.

그런 다음 다음 지침을 사용하여 푸시 알림이 올바르게 작동하는지 확인하세요.

  1. Mattermost 서버의 계정(이를 "계정 A"라고 함)으로 모바일 앱에 로그인합니다.
  2. (iOS) 앱이 알림 수신 여부를 묻는 경우 알림 수신을 확인합니다.
  3. Mattermost prompts you to confirm whether you want to allow mobile push notifications. To test mobile push notifications, you must select Allow.

  4. "계정 A"에 대해 푸시 알림이 활성화되어 있는지 확인합니다.
  5. A. 모바일 앱의 알림 설정 메뉴로 이동합니다.

    Access notification settings by selecting your profile picture to access Settings > Notifications. B. 모바일 푸시 알림이 전송으로 설정되어 있는지 확인합니다. Select Push Notifications to confirm when mobile push notifications will be sent. Specify whether all new messages or only mentions and direct messages send push notifications.
  6. "계정 A"가 앱을 백그라운드로 전환하거나 앱을 닫도록 합니다.
  7. 브라우저를 사용하여 동일한 Mattermost 서버에서 "계정 B"로 로그인합니다.
  8. "계정 A"와의 다이렉트 메시지를 열고 메시지를 보냅니다.
  9. "계정 A"의 모바일 기기에 메시지와 함께 푸시 알림이 나타나야 합니다.

푸시 알림 문제 해결#

푸시 알림을 테스트할 때 푸시 알림을 받지 못한 경우 다음 절차를 사용하여 문제를 해결하세요:

  1. 시스템 콘솔 > 환경 > 로깅 > 파일 로그 레벨에서 서버 로그에서 푸시 알림을 확인하기 위해 DEBUG를 선택합니다.
  2. 모바일 애플리케이션을 삭제하고 다시 설치합니다.
  3. "계정 A"로 로그인하고 모바일 앱에서 메시지가 표시되면 푸시 알림 수신을 확인합니다.
  4. 프로필 > 보안 > 활성 세션 보기 및 로그아웃으로 이동하여 로그인 시간과 일치하는 기본 모바일 앱에 대한 세션이 있는지 확인합니다.
  5. 푸시 알림을 다시 테스트합니다.
  6. 푸시 알림이 표시되지 않으면 시스템 콘솔 > 서버 로그로 이동한 다음 새로 고침을 선택합니다. 다음과 유사한 메시지가 로그 아래에 있는지 확인합니다:

[2016/04/21 03:16:44 UTC] [DEBG] Sending push notification to 608xyz0... wi msg of '@accountb: Hello'

  • 로그 메시지가 표시되면 HPNS 서버로 메시지가 전송되었지만 모바일 앱에서 수신하지 못한 것입니다. Mattermost 지원 팀의 도움을 받으려면 "HPNS 문제"를 제목으로 하는 지원 티켓 생성을 하세요.
  • 로그 메시지가 표시되지 않으면 "계정 A"로 모바일 푸시 알림이 전송되지 않은 것입니다. 2단계부터 프로세스를 반복하고 각 단계를 다시 확인하세요.
Important

디스크 공간을 절약하기 위해 푸시 알림 문제가 해결되면 시스템 콘솔 > 환경 > 로깅 > 파일 로그 레벨로 이동한 다음 오류를 선택하여 로깅 세부 정보 수준을 DEBUG에서 오류만으로 전환하세요.

모바일 기기에서 푸시 알림이 전달되지 않는 경우 프로필 > 보안 > 활성 세션 보기 및 로그아웃을 통해 기본 모바일 앱 세션으로 로그인되어 있는지 확인하세요. 그렇지 않으면 DeviceIdSessions 테이블에 등록되지 않아 알림이 전달되지 않습니다.

모바일 배포 문제 해결

원문 보기
요약

먼저 서버 URL에 오탈자가 없는지 확인하고 서버 배포 구성에 따라 http:// 또는 https://가 포함되어 있는지 확인하세요. 서버 URL이 올바른 경우 SSL 인증서 구성에 문제가 있을 수 있습니다. SSL 인증서 설정을 확인하려면 SSL Labs와 같은 사이트를 방문하여 테스트하세요.

"서버에 연결할 수 없습니다. 서버 URL과 인터넷 연결을 확인하세요." 메시지가 계속 나타납니다#

먼저 서버 URL에 오탈자가 없는지 확인하고 서버 배포 구성에 따라 http:// 또는 https://가 포함되어 있는지 확인하세요.

서버 URL이 올바른 경우 SSL 인증서 구성에 문제가 있을 수 있습니다.

SSL 인증서 설정을 확인하려면 SSL Labs와 같은 사이트를 방문하여 테스트하세요. 누락된 체인이나 인증서 경로에 대한 오류가 있으면 포함되어야 하는 중간 인증서가 누락된 것일 수 있습니다.

앱은 자체 서명된 인증서가 있는 서버에 연결할 수 없으므로 대신 Let's Encrypt를 사용하는 것을 고려하세요.

ADFS/Office365 로그인이 작동하지 않습니다#

Microsoft 지침에 따라 WIA를 지원하지 않는 장치에 대한 인트라넷 양식 기반 인증 구성을 권장합니다.

사라지지 않는 "연결 중..." 막대가 표시됩니다#

앱이 제대로 작동하면 앱이 다시 연결된 후 사라지거나 "연결됨"이라고 표시되는 회색 "연결 중..." 막대가 표시됩니다.

이 메시지가 항상 표시되고 인터넷 연결이 정상인 경우, 서버 관리자에게 서버가 NGINX 또는 다른 웹 서버를 역방향 프록시로 사용하는지 확인하세요. 그렇다면 APIv4 엔드포인트에 대한 WebSocket 연결 지원을 위해 올바르게 구성되어 있는지 확인해야 합니다.

모든 아웃바운드 연결이 프록시를 통해야 합니다. Mattermost 호스팅 푸시 알림 서비스에 어떻게 연결할 수 있나요?#

아래 단계에 따라 내부 서버를 설정하여 네트워크에서 Mattermost 호스팅 푸시 알림 서비스(HPNS)로의 연결을 프록시할 수 있습니다:

  1. 프록시 서버가 SSL을 지원하도록 올바르게 구성되어 있는지 확인합니다. https://www.digicert.com/help/에서 URL을 확인하여 작동 여부를 확인합니다.
  2. https://push.mattermost.com으로 요청을 전달하는 프록시를 설정합니다.
  3. Mattermost에서 5.12 이전 버전에서는 시스템 콘솔 > 알림 설정 > 모바일 푸시 > 푸시 알림 활성화를, 5.12 이후 버전에서는 시스템 콘솔 > 환경 > 푸시 알림 서버 > 푸시 알림 활성화를 "푸시 알림 서비스 위치 수동 입력"으로 설정합니다.
  4. 푸시 알림 서버 필드에 프록시의 URL을 입력합니다.
Note

프록시가 구성된 방식에 따라 포트 번호를 추가하고 https://push.mattermost.com에 매핑된 https://push.internalproxy.com:8000과 같은 URL을 만들어야 할 수도 있습니다.

빌드가 bundleReleaseJsAndAssets에서 멈춥니다#

해결 방법으로 먼저 js를 수동으로 번들링할 수 있습니다:

react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/

그런 다음 다음 명령으로 gradle 작업을 무시합니다:

./gradlew assembleRelease -x bundleReleaseJsAndAssets

모바일 앱에서 이미지 미리 보기를 사용할 수 없습니다#

이는 Mattermost를 실행하는 서버의 MIME 유형이 올바르게 설정되지 않은 경우 발생할 수 있습니다.

Linux를 실행하는 서버에는 /etc/mime.types에 이 파일이 있습니다. 이는 특정 OS 및 배포판에 따라 다를 수 있습니다.

일부 배포판은 mailcap 없이 제공되어 MIME 유형이 누락되거나 잘못 구성될 수 있습니다.

모바일 앱에서 이모지가 포함된 메시지가 전송되지 않습니다#

이는 Mattermost를 실행하는 서버가 잘못된 문자 집합으로 구성된 경우 발생할 수 있습니다. 이 문제를 해결하려면 config.json 파일의 SqlSettings 아래에서 DataSource 키가 올바르게 구성되어 있는지 확인한 다음 Mattermost 서버를 다시 시작하세요.

예시:

"SqlSettings": {
    "DataSource": "<user:pass>@<servername>/mattermost?charset=utf8mb4,utf8",
    [...]
  }

연결 문자열 구성에 대한 자세한 내용은 구성 설정 문서를 참조하세요.

모바일 푸시 알림 테스트#

사전 빌드된 모바일 앱 또는 커스텀 빌드 모바일 앱에 대한 푸시 알림을 구성했는지 확인하세요.

그런 다음 다음 지침을 사용하여 푸시 알림이 올바르게 작동하는지 확인하세요.

  1. Mattermost 서버의 계정(이를 "계정 A"라고 함)으로 모바일 앱에 로그인합니다.
  2. (iOS) 앱이 알림 수신 여부를 묻는 경우 알림 수신을 확인합니다.
  3. Mattermost prompts you to confirm whether you want to allow mobile push notifications. To test mobile push notifications, you must select Allow.

  4. "계정 A"에 대해 푸시 알림이 활성화되어 있는지 확인합니다.
  5. A. 모바일 앱의 알림 설정 메뉴로 이동합니다.

    Access notification settings by selecting your profile picture to access Settings > Notifications. B. 모바일 푸시 알림이 전송으로 설정되어 있는지 확인합니다. Select Push Notifications to confirm when mobile push notifications will be sent. Specify whether all new messages or only mentions and direct messages send push notifications.
  6. "계정 A"가 앱을 백그라운드로 전환하거나 앱을 닫도록 합니다.
  7. 브라우저를 사용하여 동일한 Mattermost 서버에서 "계정 B"로 로그인합니다.
  8. "계정 A"와의 다이렉트 메시지를 열고 메시지를 보냅니다.
  9. "계정 A"의 모바일 기기에 메시지와 함께 푸시 알림이 나타나야 합니다.

푸시 알림 문제 해결#

푸시 알림을 테스트할 때 푸시 알림을 받지 못한 경우 다음 절차를 사용하여 문제를 해결하세요:

  1. 시스템 콘솔 > 환경 > 로깅 > 파일 로그 레벨에서 서버 로그에서 푸시 알림을 확인하기 위해 DEBUG를 선택합니다.
  2. 모바일 애플리케이션을 삭제하고 다시 설치합니다.
  3. "계정 A"로 로그인하고 모바일 앱에서 메시지가 표시되면 푸시 알림 수신을 확인합니다.
  4. 프로필 > 보안 > 활성 세션 보기 및 로그아웃으로 이동하여 로그인 시간과 일치하는 기본 모바일 앱에 대한 세션이 있는지 확인합니다.
  5. 푸시 알림을 다시 테스트합니다.
  6. 푸시 알림이 표시되지 않으면 시스템 콘솔 > 서버 로그로 이동한 다음 새로 고침을 선택합니다. 다음과 유사한 메시지가 로그 아래에 있는지 확인합니다:

[2016/04/21 03:16:44 UTC] [DEBG] Sending push notification to 608xyz0... wi msg of '@accountb: Hello'

  • 로그 메시지가 표시되면 HPNS 서버로 메시지가 전송되었지만 모바일 앱에서 수신하지 못한 것입니다. Mattermost 지원 팀의 도움을 받으려면 "HPNS 문제"를 제목으로 하는 지원 티켓 생성을 하세요.
  • 로그 메시지가 표시되지 않으면 "계정 A"로 모바일 푸시 알림이 전송되지 않은 것입니다. 2단계부터 프로세스를 반복하고 각 단계를 다시 확인하세요.
Important

디스크 공간을 절약하기 위해 푸시 알림 문제가 해결되면 시스템 콘솔 > 환경 > 로깅 > 파일 로그 레벨로 이동한 다음 오류를 선택하여 로깅 세부 정보 수준을 DEBUG에서 오류만으로 전환하세요.

모바일 기기에서 푸시 알림이 전달되지 않는 경우 프로필 > 보안 > 활성 세션 보기 및 로그아웃을 통해 기본 모바일 앱 세션으로 로그인되어 있는지 확인하세요. 그렇지 않으면 DeviceIdSessions 테이블에 등록되지 않아 알림이 전달되지 않습니다.