From b1d4e65ebbaff69e0a35f584a68a3116e3dbe92f Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 08:48:28 -0700 Subject: Update Troubleshooting.md --- doc/install/Troubleshooting.md | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index 8ccc1f941..eef9fc16e 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -15,6 +15,11 @@ - If the System Administrator account becomes unavailable, a person leaving the organization for example, you can set a new system admin from the commandline using `./platform -assign_role -team_name="yourteam" -email="you@example.com" -role="system_admin"`. - After assigning the role the user needs to log out and log back in before the System Administrator role is applied. +##### Deactivate a user + + - Team Admin or System Admin can go to **Main Menu** > **Manage Members** > **Make Inactive** to deactivate a user, which removes them from the team. + - To preserve audit history, users are never deleted from the system. It is highly recommended that System Administrators do not attempt to delete users manually from the database, as this may compromise system integrity and ability to upgrade in future. + #### Error Messages The following is a list of common error messages and solutions: -- cgit v1.2.3-1-g7c22 From bfb53fc3e0c365d0d25e085c0506844de1db7574 Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 08:50:04 -0700 Subject: Update Troubleshooting.md --- doc/install/Troubleshooting.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index eef9fc16e..03760b0df 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -8,9 +8,6 @@ #### Common Issues -##### Error message in logs when attempting to sign-up: `x509: certificate signed by unknown authority` - - This error may appear when attempt to use a self-signed certificate to setup SSL, which is not yet supported by Mattermost. You can resolve this issue by setting up a load balancer like Ngnix. A ticket exists to [add support for self-signed certificates in future](x509: certificate signed by unknown authority). - ##### Lost System Administrator account - If the System Administrator account becomes unavailable, a person leaving the organization for example, you can set a new system admin from the commandline using `./platform -assign_role -team_name="yourteam" -email="you@example.com" -role="system_admin"`. - After assigning the role the user needs to log out and log back in before the System Administrator role is applied. @@ -24,7 +21,9 @@ The following is a list of common error messages and solutions: -##### "We cannot reach the Mattermost service. The service may be down or misconfigured. Please contact an administrator to make sure the WebSocket port is configured properly" +###### `We cannot reach the Mattermost service. The service may be down or misconfigured. Please contact an administrator to make sure the WebSocket port is configured properly` - Message appears in blue bar on team site. Check that [your websocket port is properly configured](https://github.com/mattermost/platform/blob/master/doc/install/Production-Ubuntu.md#set-up-nginx-server). +###### `x509: certificate signed by unknown authority` in server logs when attempting to sign-up + - This error may appear when attempt to use a self-signed certificate to setup SSL, which is not yet supported by Mattermost. You can resolve this issue by setting up a load balancer like Ngnix. A ticket exists to [add support for self-signed certificates in future](x509: certificate signed by unknown authority). -- cgit v1.2.3-1-g7c22 From 4dbde3e1d8f6c6a7087c6af1407140a7b250c8d0 Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 11:02:52 -0700 Subject: Update Troubleshooting.md --- doc/install/Troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index 03760b0df..1c00de39a 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -21,7 +21,7 @@ The following is a list of common error messages and solutions: -###### `We cannot reach the Mattermost service. The service may be down or misconfigured. Please contact an administrator to make sure the WebSocket port is configured properly` +###### `Please check connection, Mattermost unreachable. If issue persists, ask administrator to check WebSocket port.` - Message appears in blue bar on team site. Check that [your websocket port is properly configured](https://github.com/mattermost/platform/blob/master/doc/install/Production-Ubuntu.md#set-up-nginx-server). -- cgit v1.2.3-1-g7c22 From a899b7ef6538ed9091d3603e99baff6bd61ad37a Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 16:59:24 -0700 Subject: Update Troubleshooting.md --- doc/install/Troubleshooting.md | 5 ----- 1 file changed, 5 deletions(-) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index 1c00de39a..284303949 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -12,11 +12,6 @@ - If the System Administrator account becomes unavailable, a person leaving the organization for example, you can set a new system admin from the commandline using `./platform -assign_role -team_name="yourteam" -email="you@example.com" -role="system_admin"`. - After assigning the role the user needs to log out and log back in before the System Administrator role is applied. -##### Deactivate a user - - - Team Admin or System Admin can go to **Main Menu** > **Manage Members** > **Make Inactive** to deactivate a user, which removes them from the team. - - To preserve audit history, users are never deleted from the system. It is highly recommended that System Administrators do not attempt to delete users manually from the database, as this may compromise system integrity and ability to upgrade in future. - #### Error Messages The following is a list of common error messages and solutions: -- cgit v1.2.3-1-g7c22 From 87514f34bb8a8957f257b237c367f19ad766e641 Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 17:24:34 -0700 Subject: Update Troubleshooting.md --- doc/install/Troubleshooting.md | 3 +++ 1 file changed, 3 insertions(+) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index 284303949..0414c88c2 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -22,3 +22,6 @@ The following is a list of common error messages and solutions: ###### `x509: certificate signed by unknown authority` in server logs when attempting to sign-up - This error may appear when attempt to use a self-signed certificate to setup SSL, which is not yet supported by Mattermost. You can resolve this issue by setting up a load balancer like Ngnix. A ticket exists to [add support for self-signed certificates in future](x509: certificate signed by unknown authority). + +###### `panic: runtime error: invalid memory address or nil pointer dereference` + - This error can occur if you have manually manipulated the Mattermost database, typically with deletions. Mattermost is designed to serve as a searchable archive, and manual manipulation of the database elements compromises integrity and may prevent upgrade. -- cgit v1.2.3-1-g7c22 From 5871452ccb72239e46bbeb52caa13a67cdf76b3f Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 17:29:35 -0700 Subject: Adding "Solution" sections to guide --- doc/install/Troubleshooting.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index 0414c88c2..0df34e4f5 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -17,11 +17,14 @@ The following is a list of common error messages and solutions: ###### `Please check connection, Mattermost unreachable. If issue persists, ask administrator to check WebSocket port.` -- Message appears in blue bar on team site. Check that [your websocket port is properly configured](https://github.com/mattermost/platform/blob/master/doc/install/Production-Ubuntu.md#set-up-nginx-server). +- Message appears in blue bar on team site. +- **Solution:** Check that [your websocket port is properly configured](https://github.com/mattermost/platform/blob/master/doc/install/Production-Ubuntu.md#set-up-nginx-server). ###### `x509: certificate signed by unknown authority` in server logs when attempting to sign-up - - This error may appear when attempt to use a self-signed certificate to setup SSL, which is not yet supported by Mattermost. You can resolve this issue by setting up a load balancer like Ngnix. A ticket exists to [add support for self-signed certificates in future](x509: certificate signed by unknown authority). + - This error may appear when attempt to use a self-signed certificate to setup SSL, which is not yet supported by Mattermost. You + - **Solution:** Set up a load balancer like Ngnix [per production install guide](https://github.com/mattermost/platform/blob/master/doc/install/Production-Ubuntu.md#set-up-nginx-with-ssl-recommended). A ticket exists to [add support for self-signed certificates in future](x509: certificate signed by unknown authority). ###### `panic: runtime error: invalid memory address or nil pointer dereference` - This error can occur if you have manually manipulated the Mattermost database, typically with deletions. Mattermost is designed to serve as a searchable archive, and manual manipulation of the database elements compromises integrity and may prevent upgrade. + - **Solution:** Restore from databse backup created prior to manual database updates, or reinstall the system. -- cgit v1.2.3-1-g7c22 From 570b54bbfc0151724aa10f61ca0beb4d38351cb9 Mon Sep 17 00:00:00 2001 From: it33 Date: Tue, 27 Oct 2015 17:29:54 -0700 Subject: Typo fix --- doc/install/Troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/install/Troubleshooting.md') diff --git a/doc/install/Troubleshooting.md b/doc/install/Troubleshooting.md index 0df34e4f5..7166f9978 100644 --- a/doc/install/Troubleshooting.md +++ b/doc/install/Troubleshooting.md @@ -27,4 +27,4 @@ The following is a list of common error messages and solutions: ###### `panic: runtime error: invalid memory address or nil pointer dereference` - This error can occur if you have manually manipulated the Mattermost database, typically with deletions. Mattermost is designed to serve as a searchable archive, and manual manipulation of the database elements compromises integrity and may prevent upgrade. - - **Solution:** Restore from databse backup created prior to manual database updates, or reinstall the system. + - **Solution:** Restore from database backup created prior to manual database updates, or reinstall the system. -- cgit v1.2.3-1-g7c22