ED/EDMarketConnector
1
0
Fork 0
mirror of https://github.com/EDCD/EDMarketConnector.git synced 2025-04-22 20:00:29 +03:00
Code Issues Projects Releases Wiki Activity

Troubleshooting: Experimental TOC from a VIM plugin

Athanasius 2020-12-12 19:51:19 +00:00
parent 0101e92528
commit 8e40a05c06
1 changed files with 236 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

236
Troubleshooting.md

@ -1,3 +1,54 @@
Contents
===
<!-- vim-markdown-toc Redcarpet -->
* [I ran the program with "run as Administrator" and ...](#i-ran-the-program-with-quot-run-as-administrator-quot-and)
* [Program won't start](#program-won-39-t-start)
* [Re-running application does nothing](#re-running-application-does-nothing)
* [Last logged "Locale LC_ALL: ..."](#last-logged-quot-locale-lc_all-quot)
* [Problems with Frontier Authentication](#problems-with-frontier-authentication)
* [App repeatedly opens the Frontier authentication website](#app-repeatedly-opens-the-frontier-authentication-website)
* [App does not open Frontier authentication website](#app-does-not-open-frontier-authentication-website)
* [Error: Invalid Credentials](#error-invalid-credentials)
* [Error: An error occured](#error-an-error-occured)
* [500 internal server error](#500-internal-server-error)
* [Error: User not found](#error-user-not-found)
* [Error: Missing credentials](#error-missing-credentials)
* [unable to get endpoint /profile (or /market, or /shipyard)](#unable-to-get-endpoint-profile-or-market-or-shipyard)
* [Third Party Site Plugins (EDSM, EDDB, Inara)](#third-party-site-plugins-edsm-eddb-inara)
* [Credentials settings are greyed out](#credentials-settings-are-greyed-out)
* [Help - a plugin is spamming errors in the log](#help-a-plugin-is-spamming-errors-in-the-log)
* [Firewall and Network Issues](#firewall-and-network-issues)
* [Error: Can't connect to EDDN](#error-can-39-t-connect-to-eddn)
* [Error: Can't connect to EDSM](#error-can-39-t-connect-to-edsm)
* [Error: Can't connect to Inara](#error-can-39-t-connect-to-inara)
* [Error: Unable to get token](#error-unable-to-get-token)
* [I'm using BitDefender and things don't work](#i-39-m-using-bitdefender-and-things-don-39-t-work)
* [Miscellaneous](#miscellaneous)
* [Program doesn't send data to EDSM and others at startup](#program-doesn-39-t-send-data-to-edsm-and-others-at-startup)
* [Doesn't auto-update and/or persistently gives “Server is lagging” error](#doesn-39-t-auto-update-and-or-persistently-gives-“server-is-lagging”-error)
* [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)
* [Import failed: No ship loadout found](#import-failed-no-ship-loadout-found)
* [Very long "cooldown" period](#very-long-quot-cooldown-quot-period)
* [Update Error!](#update-error)
* [Update of application fails silently or with the installer crashing.](#update-of-application-fails-silently-or-with-the-installer-crashing)
* [Missing VCRUNTIME140.DLL](#missing-vcruntime140-dll)
* [Multi-Accounting](#multi-accounting)
* [I run two instances of E:D simultaneously, but I can't run two instances of EDMC](#i-run-two-instances-of-e-d-simultaneously-but-i-can-39-t-run-two-instances-of-edmc)
* [Error: Wrong Cmdr](#error-wrong-cmdr)
* [Location of configuration files](#location-of-configuration-files)
* [Reporting a problem](#reporting-a-problem)
* [Debug Log Files](#debug-log-files)
* [Plain Log File](#plain-log-file)
<!-- vim-markdown-toc -->
<!-- vim-markdown-toc Redcarpet -->
<a name='i-ran-the-program-with-quot-run-as-administrator-quot-and'></a>
<!-- vim-markdown-toc -->
# I ran the program with "run as Administrator" and ...
Don't do that. There's zero reason to run ED Market Connector as
@ -14,8 +65,18 @@ privileges for the install. After that all file access in the installation
folder is then read-only (any output is directed within your user's file area,
or other location chosen by you).
<!-- vim-markdown-toc Redcarpet -->
<a name='program-won-39-t-start'></a>
<!-- vim-markdown-toc -->
# Program won't start
<!-- vim-markdown-toc Redcarpet -->
<a name='re-running-application-does-nothing'></a>
<!-- vim-markdown-toc -->
## Re-running application does nothing
There's a [bug](https://github.com/EDCD/EDMarketConnector/issues/678)
@ -36,6 +97,11 @@ because a process (which can't be EDMarketconnector.exe because you already
checked that) has the file open then you'll need to resolve that in order for
EDMarketConnector.exe to run again.
<!-- vim-markdown-toc Redcarpet -->
<a name='last-logged-quot-locale-lc_all-quot'></a>
<!-- vim-markdown-toc -->
## Last logged "Locale LC_ALL: ..."
If you're using EDMC 4.1.0 or later (including betas) you might find the
@ -59,8 +125,18 @@ for 'Control Panel' in the Start Menu. Alternatively.
1. Tick the box "Beta: Use Unicode UTF-8 for worldwide language support".
1. Click "OK". You'll probably be prompted to reboot for this to take effect.
<!-- vim-markdown-toc Redcarpet -->
<a name='problems-with-frontier-authentication'></a>
<!-- vim-markdown-toc -->
# Problems with Frontier Authentication
<!-- vim-markdown-toc Redcarpet -->
<a name='app-repeatedly-opens-the-frontier-authentication-website'></a>
<!-- vim-markdown-toc -->
## 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.
@ -68,6 +144,11 @@ The authentication didn't complete correctly for some reason. This can be caused
- 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).
<!-- vim-markdown-toc Redcarpet -->
<a name='app-does-not-open-frontier-authentication-website'></a>
<!-- vim-markdown-toc -->
## App does not open Frontier authentication website
The app needs to see your Journal Files in order to detect your Commander and
initiate the Frontier authentication.
@ -77,27 +158,57 @@ cloud gaming service the Journal Files are also in the cloud, not on your
local machine, and thus EDMC can't see them. This will not work. It is
assumed that the same will be true of other cloud gaming services.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-invalid-credentials'></a>
<!-- vim-markdown-toc -->
## Error: Invalid Credentials
See [above](#app-repeatedly-opens-the-frontier-authentication-website).
<!-- vim-markdown-toc Redcarpet -->
<a name='error-an-error-occured'></a>
<!-- vim-markdown-toc -->
## 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='500-internal-server-error'></a>
<!-- vim-markdown-toc -->
## 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-user-not-found'></a>
<!-- vim-markdown-toc -->
## 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-missing-credentials'></a>
<!-- vim-markdown-toc -->
## Error: Missing credentials
This can be caused by the application not yet knowing your Commander
name. Ensure the [Journal files location is set correctly](Troubleshooting#doesnt-auto-update-andor-persistently-gives-server-is-lagging-error).
<!-- vim-markdown-toc Redcarpet -->
<a name='unable-to-get-endpoint-profile-or-market-or-shipyard'></a>
<!-- vim-markdown-toc -->
## unable to get endpoint /profile (or /market, or /shipyard)
This refers to an attempt to retrieve data from the Frontier CAPI
service that didn't receive a response within the timeout (currently
@ -108,14 +219,29 @@ need to adjust some firewall settings) it's likely a problem at
Frontier's end.
---
<!-- vim-markdown-toc Redcarpet -->
<a name='third-party-site-plugins-edsm-eddb-inara'></a>
<!-- vim-markdown-toc -->
# Third Party Site Plugins (EDSM, EDDB, Inara)
<!-- vim-markdown-toc Redcarpet -->
<a name='credentials-settings-are-greyed-out'></a>
<!-- vim-markdown-toc -->
## 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).
<!-- vim-markdown-toc Redcarpet -->
<a name='help-a-plugin-is-spamming-errors-in-the-log'></a>
<!-- vim-markdown-toc -->
## Help - a plugin is spamming errors in the log
The EDSM and Inara internal plugins communicate with their respective
@ -143,22 +269,52 @@ any other such messages you see in your logs so we can document them
here and/or fix the EDMC code.
---
<!-- vim-markdown-toc Redcarpet -->
<a name='firewall-and-network-issues'></a>
<!-- vim-markdown-toc -->
# Firewall and Network Issues
<!-- vim-markdown-toc Redcarpet -->
<a name='error-can-39-t-connect-to-eddn'></a>
<!-- vim-markdown-toc -->
## 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-can-39-t-connect-to-edsm'></a>
<!-- vim-markdown-toc -->
## Error: Can't connect to EDSM
See [Error: Can't connect to EDDN](#error-cant-connect-to-eddn) above.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-can-39-t-connect-to-inara'></a>
<!-- vim-markdown-toc -->
## Error: Can't connect to Inara
See [Error: Can't connect to EDDN](#error-cant-connect-to-eddn) above.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-unable-to-get-token'></a>
<!-- vim-markdown-toc -->
## Error: Unable to get token
You almost certainly have an Anti-Virus, Software Firewall, or VPN stopping
EDMC from communicating with the Frontier authorization server. Please
whitelist EDMarketConnector.exe for connections to auth.frontierstore.net.
<!-- vim-markdown-toc Redcarpet -->
<a name='i-39-m-using-bitdefender-and-things-don-39-t-work'></a>
<!-- vim-markdown-toc -->
## 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.
@ -173,8 +329,18 @@ To fix this you need to add it as an exception in BitDefender by going to :
1. You may need to reauthenticate with Frontier servers now.
---
<!-- vim-markdown-toc Redcarpet -->
<a name='miscellaneous'></a>
<!-- vim-markdown-toc -->
# Miscellaneous
<!-- vim-markdown-toc Redcarpet -->
<a name='program-doesn-39-t-send-data-to-edsm-and-others-at-startup'></a>
<!-- vim-markdown-toc -->
## Program doesn't send data to EDSM and others at startup
**You need to start EDMC *before* logging into the game.** When EDMC starts it
does look through the latest journal file, in part to set internal state, and
@ -190,6 +356,11 @@ We might look into making an exception for basic "current state" events like
If you encounter an issue with starting EDMC before the game then please
see [Reporting a problem](#reporting-a-problem).
<!-- vim-markdown-toc Redcarpet -->
<a name='doesn-39-t-auto-update-and-or-persistently-gives-“server-is-lagging”-error'></a>
<!-- vim-markdown-toc -->
## 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.
@ -199,9 +370,19 @@ 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`
<!-- vim-markdown-toc Redcarpet -->
<a name='i-forgot-to-run-the-app-is-there-a-way-to-process-the-missing-data'></a>
<!-- vim-markdown-toc -->
## 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/).
<!-- vim-markdown-toc Redcarpet -->
<a name='import-failed-no-ship-loadout-found'></a>
<!-- vim-markdown-toc -->
## Import failed: No ship loadout found
If your ship loadout fails to open up in your chosen Shipyard provider
@ -229,6 +410,11 @@ use this as "let's re-open that last build" facility even without EDMC
running.
<!-- vim-markdown-toc Redcarpet -->
<a name='very-long-quot-cooldown-quot-period'></a>
<!-- vim-markdown-toc -->
## 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:
@ -238,6 +424,11 @@ 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='update-error'></a>
<!-- vim-markdown-toc -->
## 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)
@ -248,6 +439,11 @@ 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='update-of-application-fails-silently-or-with-the-installer-crashing'></a>
<!-- vim-markdown-toc -->
## Update of application fails silently or with the installer crashing.
We've had several reports of updates from 3.4.3.0 to a later version failing.
The only thing we can think of is that the older version of the WinSparkle DLL
@ -271,6 +467,11 @@ NB: Uninstalling does *not* affect any of:
1. Any installed third-party plugins.
1. Any log files.
<!-- vim-markdown-toc Redcarpet -->
<a name='missing-vcruntime140-dll'></a>
<!-- vim-markdown-toc -->
## Missing VCRUNTIME140.DLL
If you're on any version of Windows 10 then you shouldn't see an error
like this. If you're on Windows 8.1 or earlier than you should check
@ -280,13 +481,28 @@ install the **x86** version of the
Alternate URL: "[The latest supported Visual C++ downloads](https://support.microsoft.com/en-in/help/2977003/the-latest-supported-visual-c-downloads)".
---
<!-- vim-markdown-toc Redcarpet -->
<a name='multi-accounting'></a>
<!-- vim-markdown-toc -->
# Multi-Accounting
<!-- vim-markdown-toc Redcarpet -->
<a name='i-run-two-instances-of-e-d-simultaneously-but-i-can-39-t-run-two-instances-of-edmc'></a>
<!-- vim-markdown-toc -->
## 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.
<!-- vim-markdown-toc Redcarpet -->
<a name='error-wrong-cmdr'></a>
<!-- vim-markdown-toc -->
## 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:
@ -300,6 +516,11 @@ If 2 this problem may or may not resolve itself in time.
---
<!-- vim-markdown-toc Redcarpet -->
<a name='location-of-configuration-files'></a>
<!-- vim-markdown-toc -->
# 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:
@ -313,6 +534,11 @@ If your configuration has been corrupted, or badly set, such that you can't run
--
<!-- vim-markdown-toc Redcarpet -->
<a name='reporting-a-problem'></a>
<!-- vim-markdown-toc -->
# Reporting a problem
Please report a problem as a new GitHub [issue](https://github.com/EDCD/EDMarketConnector/issues/new?assignees=&labels=bug%2C+unconfirmed&template=bug_report.md&title=).
**Do not decide you do not need to use the Bug Report template. All of the
@ -327,6 +553,11 @@ Be sure to attach both:
occurs*. In addition to actually logged output this contains any other
output which won't be in the debug log file.
<!-- vim-markdown-toc Redcarpet -->
<a name='debug-log-files'></a>
<!-- vim-markdown-toc -->
## Debug Log Files
If you are using 4.1.0, or later (including betas of 4.1.0) then there is a new
set of rotated logfiles in the location:
@ -348,6 +579,11 @@ They do **not contain** plain `print(..)` and other non-logged output, so we
still need you to also supply the [plain log file](#plain-log-file) in bug
reports as well.
<!-- vim-markdown-toc Redcarpet -->
<a name='plain-log-file'></a>
<!-- vim-markdown-toc -->
## Plain Log File
Prior to EDMC 4.1.0 the only logfile is re-created on each run of the program.
As such you will need to re-create the issue and then make a copy of the file: