1
0
mirror of https://github.com/EDCD/EDMarketConnector.git synced 2025-04-25 13:02:13 +03:00

Troubleshooting cleanup and additions

* Have sections, and re-order entries into them.
 * Add information about whitelisting with BitDefender.
Athanasius 2020-07-09 15:42:57 +01:00
parent 3fb1686f31
commit c1e8f95bd5

@ -1,28 +1,68 @@
### App repeatedly opens the Frontier authentication website
# Problems with Frontier Authentication
## App repeatedly opens the Frontier authentication website
The authentication didn't complete correctly for some reason. This can be caused by:
- Using Internet Explorer. IE is [known](https://blogs.msdn.microsoft.com/ieinternals/2011/07/13/understanding-protocols/) to be broken. Please (temporarily) set your default browser to Edge, Chrome or Firefox and retry.
- The Frontier authentication website is confused - see [Error: An error occured](#error-an-error-occured).
- Entering credentials for a different Cmdr - see [Error: Wrong Cmdr](#error-wrong-cmdr).
- Entering Steam credentials instead of Frontier credentials - see [Error: User not found](#error-user-not-found).
### Error: Invalid Credentials
## Error: Invalid Credentials
See [above](#app-repeatedly-opens-the-frontier-authentication-website).
### Error: An error occured
## Error: An error occured
The Frontier authentication website is confused. Visit the [Frontier authentication website](https://auth.frontierstore.net/), log in and deauthorize "Elite Dangerous Market Connector". Then restart the app.
### 500 internal server error
## 500 internal server error
Either:
- You pressed the "Approve" button on Frontier's authentication website twice. This is harmless; if the app isn't displaying any error messages and isn't redirecting again to Frontier's authentication website then all is fine.
- Frontier's authentication website sometimes gets overloaded and displays this error. Please try again later.
### Error: User not found
## Error: User not found
Your Steam account may not be linked to your Frontier account (you can check whether you have any external accounts linked on the [Frontier store](https://www.frontierstore.net/frontier_partnerkeys/)).
Please enter your Frontier credentials into the authentication website, not your Steam credentials.
### Doesn't auto-update and/or persistently gives “Server is lagging” error
---
# Third Party Site Plugins (EDSM, EDDB, Inara)
## Credentials settings are greyed out
You won't be redirected to Frontier's authentication website and can't edit your EDSM or Inara credentials if:
- Elite: Dangerous is at the Main Menu. You will be able to edit these values once you've entered the game.
- The last time you ran Elite: Dangerous you didn't enter the game. You will be able to edit these values once you've entered the game.
- Your “E:D journal file location” setting is incorrect. See [below](#doesnt-auto-update-andor-persistently-gives-server-is-lagging-error).
---
# Firewall and Network Issues
## Error: Can't connect to EDDN
EDMC needs to talk to eddn.edcd.io on port 4430. If you consistently receive this error check that your router or VPN configuration allows port 4430 / tcp outbound. If using a proxy add `eddn.edcd.io` to the exemption list, plus `www.edsm.net` and/or `inara.cz` if using EDSM and/or Inara integration.
## Error: Can't connect to EDSM
See [Error: Can't connect to EDDN](#error-cant-connect-to-eddn) above.
## Error: Can't connect to Inara
See [Error: Can't connect to EDDN](#error-cant-connect-to-eddn) above.
## I'm using BitDefender and things don't work
If you are trying to run EDMC with BitDefender on your computer you will not receive an error in BitDefender or any notification, however EDMC will be unable to authenticate with Frontier servers or check for updates.
To fix this you need to add it as an exception in BitDefender by going to :
1. The Protection Tab
1. Click 'Manage Exceptions' under Advanced Threat Defense
1. Click 'Add an exception'
1. Click the browse button and browse to the location of the EDMC .exe file. The default location is: C:\Program Files (x86)\EDMarketConnector\EDMarketConnector.exe
1. Click 'Ok'
1. Click 'Add Exception'
1. You may need to reauthenticate with Frontier servers now.
---
# Miscellaneous
## Doesn't auto-update and/or persistently gives “Server is lagging” error
This app uses Elite: Dangerous' log files to track the systems and stations that you visit. If you're running this app on a different machine from the Elite: Dangerous game, or if you find that this app isn't automatically tracking the systems that you visit and/or isn't automatically “updating” on docking (if you have that option selected), then adjust the “E:D journal file location” setting on the Configuration tab to point to the game's log files.
The default location is typically:
@ -31,37 +71,13 @@ The default location is typically:
- Linux Steam Play: `~/.steam/steam/steamapps/compatdata/359320/pfx/drive_c/users/steamuser/Saved Games/Frontier Developments/Elite Dangerous`
- Linux Wine: `~/.wine/drive_c/users/you/Saved Games/Frontier Developments/Elite Dangerous`
### Credentials settings are greyed out
You won't be redirected to Frontier's authentication website and can't edit your EDSM or Inara credentials if:
- Elite: Dangerous is at the Main Menu. You will be able to edit these values once you've entered the game.
- The last time you ran Elite: Dangerous you didn't enter the game. You will be able to edit these values once you've entered the game.
- Your “E:D journal file location” setting is incorrect. See [above](#doesnt-auto-update-andor-persistently-gives-server-is-lagging-error).
### I run two instances of E:D simultaneously, but I can't run two instances of EDMC
EDMC supports this scenario if you run the second instance of E:D in a *different* user account - e.g. using `runas` on Windows. Run the second instance of EDMC in the same user account as the second instance of E:D.
EDMC doesn't support running two instances of E:D in the *same* user account. EDMC will only respond to the instance of E:D that you ran last.
### Error: Wrong Cmdr
The Frontier server that supplies data to this app is supplying data for a different Cmdr than the one that you're currently playing. You are redirected to Frontier's authentication website and prompted again for your username and password. Either:
1. You have multiple accounts and the username/password setting is not for the account that you're currently playing; or
2. You have reset your Cmdr but Frontier's server is still supplying data for the old Cmdr.
If 1 check your username/password settings.
If 2 this problem may or may not resolve itself in time.
### I forgot to run the app - is there a way to process the missing data?
## I forgot to run the app - is there a way to process the missing data?
EDMC only processes live data from E:D. But you can upload your [journal](#doesnt-auto-update-andor-persistently-gives-server-is-lagging-error) file(s) for the missing period to [EDSM](https://www.edsm.net/en/settings/import/journal) and [Inara](https://inara.cz/settings/).
### Error: Can't connect to EDDN
EDMC needs to talk to eddn.edcd.io on port 4430. If you consistently receive this error check that your router or VPN configuration allows port 4430 / tcp outbound. If using a proxy add `eddn.edcd.io` to the exemption list, plus `www.edsm.net` and/or `inara.cz` if using EDSM and/or Inara integration.
## Import failed: No ship loadout found
Complex ship loadouts with Engineers' mods can cause you to hit an Internet Explorer / Edge limitation on the length of URLs. Switch to a browser that supports longer URLs, e.g. Firefox or Google Chrome.
### Import failed: No ship loadout found
Complex ship loadouts with Engineers' mods can cause you to hit an Internet Explorer / Edge limitation on the length of URLs. Switch to a browser that doesn't suck.
### Very long "cooldown" period
## Very long "cooldown" period
You'll see a very long cooldown period if your system's time of day changes while you're running the app. To fix this:
- Quit the app.
@ -70,7 +86,7 @@ You'll see a very long cooldown period if your system's time of day changes whil
- Mac: Copy and paste the following into a Terminal app window: `defaults write uk.org.marginal.edmarketconnector querytime -int 0` and press Enter.
- Re-start the app.
### Update Error!
## Update Error!
If you get an error trying to download an update to EDMC this could be
because the [GitHub server](https://github.com/EDCD/EDMarketConnector/releases/latest)
that hosts this app's updates only supports TLS 1.2 and higher.
@ -80,7 +96,32 @@ instructions to change your Windows settings to disable the
[deprecated](https://tools.ietf.org/html/rfc7568) SSL 2.0 and 3.0
protocols and enable TLS 1.2.
### Location of configuration files
---
# Multi-Accounting
## I run two instances of E:D simultaneously, but I can't run two instances of EDMC
EDMC supports this scenario if you run the second instance of E:D in a *different* user account - e.g. using `runas` on Windows. Run the second instance of EDMC in the same user account as the second instance of E:D.
EDMC doesn't support running two instances of E:D in the *same* user account. EDMC will only respond to the instance of E:D that you ran last.
## Error: Wrong Cmdr
The Frontier server that supplies data to this app is supplying data for a different Cmdr than the one that you're currently playing. You are redirected to Frontier's authentication website and prompted again for your username and password. Either:
1. You have multiple accounts and the username/password setting is not for the account that you're currently playing; or
2. You have reset your Cmdr but Frontier's server is still supplying data for the old Cmdr.
If 1 check your username/password settings.
If 2 this problem may or may not resolve itself in time.
---
# Linux
---
# Location of configuration files
If your configuration has been corrupted, or badly set, such that you can't run the program to fix it, or you otherwise need to directly access the configuration then these are the locations of the configuration:
* Mac: You can use the 'defaults' command to interact with the stored settings, i.e.
@ -91,7 +132,9 @@ If your configuration has been corrupted, or badly set, such that you can't run
* Windows: Configuration is stored in the registry under `HKEY_CURRENT_USER\Software\Marginal\EDMarketConnector` . There are also some non-configuration files at `%LOCALAPPDATA%\EDMarketConnector\` in your user profile.
* Linux: Configuration is stored in the file `${HOME}/.config/EDMarketConnector/EDMarketConnector.ini`
### Reporting a problem
--
# Reporting a problem
Please report a problem as a new GitHub [issue](https://github.com/EDCD/EDMarketConnector/issues/new). Please wait for the error to occur and zip up and attach this app's log file to the new issue:
Mac: