Skip to content

Commit

Permalink
update network name length
Browse files Browse the repository at this point in the history
  • Loading branch information
mark-prins committed Oct 16, 2024
1 parent 171032d commit fa0ead2
Showing 1 changed file with 13 additions and 11 deletions.
24 changes: 13 additions & 11 deletions content/docs/introduction/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,17 +14,18 @@ toc = true
top = false
+++


## If you are unable to connect to the server on your machine
If you have installed Open mSupply client or standalone on your machine, but are unable to connect to the server, try the following steps:

1. Check the name of the computer. If you are on a Windows machine, this can generally be found by going through the Control Panel > System and Security > System. Change the PC name to ensure it does not have any special characters and is not very long. Restart the computer and try connecting again.
2. If the step above doesn't work, you may need to install a network loopback adaptor on your computer using [these instructions](https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/install-microsoft-loopback-adapter#method-2).
If you have installed Open mSupply client or standalone on your machine, but are unable to connect to the server, try the following steps:

1. Check the name of the computer. If you are on a Windows machine, this can generally be found by going through the Control Panel > System and Security > System. Change the PC name to ensure it is 15 characters long or shorter. The name can contain letters, numbers or hyphens, but cannot be too long. Restart the computer and try connecting again.
2. If the step above doesn't work, you may need to install a network loopback adaptor on your computer using [these instructions](https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/install-microsoft-loopback-adapter#method-2).

## On windows, if the service doesn't start

If the service doesn't start on windows, this can be frustrating! It's hard to know what to change if the service quietly fails.
If the service doesn't start on windows, this can be frustrating! It's hard to know what to change if the service quietly fails.
Here are some things to try:

1. Check the windows event Application log
2. Ensure that logging is enabled and check the Open mSupply log file
3. Check that the postgreSQL binaries are available, if used
Expand All @@ -49,10 +50,11 @@ C:\Program Files\PostgreSQL\14\lib;
## Unable to login

If you have created a user, configured permissions, and are still getting an error when trying to login, here are some steps to try:
* Ensure that the user has a store checked as 'Default store' in the mSupply [user administration screen](https://docs.msupply.org.nz/admin:managing_users#login_rights_tab)
* Check that the user also has `Login as Desktop user` checked
* Check that the user [has permission](https://docs.msupply.org.nz/admin:managing_users#permissions_tabs) to login to a store which is part of the sync site
* Edit the user in mSupply and check that the user isn't blocked ( you'll see a specific error relating to this in Open mSupply )
* Try refreshing the page if you are using the web version

<div class="note">Usernames are not case-sensitive, but passwords are!</div>
- Ensure that the user has a store checked as 'Default store' in the mSupply [user administration screen](https://docs.msupply.org.nz/admin:managing_users#login_rights_tab)
- Check that the user also has `Login as Desktop user` checked
- Check that the user [has permission](https://docs.msupply.org.nz/admin:managing_users#permissions_tabs) to login to a store which is part of the sync site
- Edit the user in mSupply and check that the user isn't blocked ( you'll see a specific error relating to this in Open mSupply )
- Try refreshing the page if you are using the web version

<div class="note">Usernames are not case-sensitive, but passwords are!</div>

0 comments on commit fa0ead2

Please sign in to comment.