1
0
mirror of https://github.com/EDCD/EDMarketConnector.git synced 2025-07-09 21:21:25 +03:00

Troubleshooting: Move relevant entries into a new 'Installation Issues' section

Athanasius 2021-05-13 11:32:58 +01:00
parent a570c20aa8
commit 405e91c0c0

@ -37,6 +37,11 @@ Then to add it back :GenTocRedCarpet
* [Plain Log File](#plain-log-file) * [Plain Log File](#plain-log-file)
* [Location of configuration files](#location-of-configuration-files) * [Location of configuration files](#location-of-configuration-files)
* [I ran the program with "run as Administrator" and ...](#i-ran-the-program-with-quot-run-as-administrator-quot-and) * [I ran the program with "run as Administrator" and ...](#i-ran-the-program-with-quot-run-as-administrator-quot-and)
* [Installation Issues](#installation-issues)
* [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)
* [EDMarketConnector needs permission to use shortcuts](#edmarketconnector-needs-permission-to-use-shortcuts)
* [Program won't start](#program-won-39-t-start) * [Program won't start](#program-won-39-t-start)
* [Re-running application does nothing](#re-running-application-does-nothing) * [Re-running application does nothing](#re-running-application-does-nothing)
* [Last logged "Locale LC_ALL: ..."](#last-logged-quot-locale-lc_all-quot) * [Last logged "Locale LC_ALL: ..."](#last-logged-quot-locale-lc_all-quot)
@ -69,10 +74,6 @@ Then to add it back :GenTocRedCarpet
* [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) * [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) * [Import failed: No ship loadout found](#import-failed-no-ship-loadout-found)
* [Very long "cooldown" period](#very-long-quot-cooldown-quot-period) * [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)
* [EDMarketConnector needs permission to use shortcuts](#edmarketconnector-needs-permission-to-use-shortcuts)
* [Multi-Accounting](#multi-accounting) * [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) * [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)
* [Linux](#linux) * [Linux](#linux)
@ -194,6 +195,95 @@ or other location chosen by you).
<!-- vim-markdown-toc Redcarpet --> <!-- vim-markdown-toc Redcarpet -->
<a name='installation-issues'></a>
<!-- vim-markdown-toc -->
# Installation Issues
<!-- 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)
that hosts this app's updates only supports TLS 1.2 and higher.
Follow [these](https://help.passageways.com/hc/en-us/articles/115005183226-How-to-enable-TLS-1-2-in-Internet-Explorer-11-and-MS-Edge)
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
file shipped in that version has issues with Windows versions released since
3.4.3.0 was built.
The easiest thing to do in this situation is to update manually this time:
1. Uninstall 'Elite Dangerous Market Connector' from Windows.
1. `Windows Key` + i -> opens settings.
1. Open 'Apps'.
1. Wait for this to load the list, then type 'Market' into the search box.
1. Click on the entry for 'Elite Dangerous Market Connector' and then on
the 'Uninstall' button. Follow any further prompts.
1. Download the `.msi` installer file for the [latest released version](https://github.com/EDCD/EDMarketConnector/releases/latest).
1. Run that `.msi` file to install the latest version
NB: Uninstalling does *not* affect any of:
1. Your application settings.
1. Any exported files.
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
Windows Update for "Universal CRT" or "VCRedist". If that fails then
install the **x86** version of the
"[Microsoft Visual C++ 2015 Redistributable Update 3 RC](https://www.microsoft.com/en-us/download/details.aspx?id=52685)".
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='edmarketconnector-needs-permission-to-use-shortcuts'></a>
<!-- vim-markdown-toc -->
## EDMarketConnector needs permission to use shortcuts
This appears on the `Configuration` tab of the application Preferences on
macOS because the application doesn't have the necessary OS permissions to
listen to all keyboard input.
The intention of this is to support the 'hotkey' feature of this application,
so that you can trigger an update (as happens when you dock if you have the
'Automatically update on docking' option active) with a key press.
Unfortunately this code has atrophied on macOS and developer documentation
isn't very helpful. In any case you can no longer run the Game natively on
macOS so it's unlikely you wouldn't simply have the application window visible
on macOS, and thus you can just press the 'Update' button.
If anyone can confirm how a tkinter application is meant to signal to macOS, on
Catalina or later, that it would like to listen to all keyboard input we can
investigate getting this working again.
It would seem to be the 'Input Monitoring' part of 'Privacy & Security', but
with no applications listed there's seemingly no way to add another. It's also
possible the hotkey detection code will need a wholesale rewrite on macOS.
<!-- vim-markdown-toc Redcarpet -->
<a name='program-won-39-t-start'></a> <a name='program-won-39-t-start'></a>
<!-- vim-markdown-toc --> <!-- vim-markdown-toc -->
@ -646,89 +736,6 @@ 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. - 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. - 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)
that hosts this app's updates only supports TLS 1.2 and higher.
Follow [these](https://help.passageways.com/hc/en-us/articles/115005183226-How-to-enable-TLS-1-2-in-Internet-Explorer-11-and-MS-Edge)
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
file shipped in that version has issues with Windows versions released since
3.4.3.0 was built.
The easiest thing to do in this situation is to update manually this time:
1. Uninstall 'Elite Dangerous Market Connector' from Windows.
1. `Windows Key` + i -> opens settings.
1. Open 'Apps'.
1. Wait for this to load the list, then type 'Market' into the search box.
1. Click on the entry for 'Elite Dangerous Market Connector' and then on
the 'Uninstall' button. Follow any further prompts.
1. Download the `.msi` installer file for the [latest released version](https://github.com/EDCD/EDMarketConnector/releases/latest).
1. Run that `.msi` file to install the latest version
NB: Uninstalling does *not* affect any of:
1. Your application settings.
1. Any exported files.
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
Windows Update for "Universal CRT" or "VCRedist". If that fails then
install the **x86** version of the
"[Microsoft Visual C++ 2015 Redistributable Update 3 RC](https://www.microsoft.com/en-us/download/details.aspx?id=52685)".
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='edmarketconnector-needs-permission-to-use-shortcuts'></a>
<!-- vim-markdown-toc -->
## EDMarketConnector needs permission to use shortcuts
This appears on the `Configuration` tab of the application Preferences on
macOS because the application doesn't have the necessary OS permissions to
listen to all keyboard input.
The intention of this is to support the 'hotkey' feature of this application,
so that you can trigger an update (as happens when you dock if you have the
'Automatically update on docking' option active) with a key press.
Unfortunately this code has atrophied on macOS and developer documentation
isn't very helpful. In any case you can no longer run the Game natively on
macOS so it's unlikely you wouldn't simply have the application window visible
on macOS, and thus you can just press the 'Update' button.
If anyone can confirm how a tkinter application is meant to signal to macOS, on
Catalina or later, that it would like to listen to all keyboard input we can
investigate getting this working again.
It would seem to be the 'Input Monitoring' part of 'Privacy & Security', but
with no applications listed there's seemingly no way to add another. It's also
possible the hotkey detection code will need a wholesale rewrite on macOS.
--- ---
<!-- vim-markdown-toc Redcarpet --> <!-- vim-markdown-toc Redcarpet -->