From 405e91c0c05a6ee7feba5bde32166bd0b6797705 Mon Sep 17 00:00:00 2001 From: Athanasius Date: Thu, 13 May 2021 11:32:58 +0100 Subject: [PATCH] Troubleshooting: Move relevant entries into a new 'Installation Issues' section --- Troubleshooting.md | 181 +++++++++++++++++++++++---------------------- 1 file changed, 94 insertions(+), 87 deletions(-) diff --git a/Troubleshooting.md b/Troubleshooting.md index b3938d9..c643aac 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -37,6 +37,11 @@ Then to add it back :GenTocRedCarpet * [Plain Log File](#plain-log-file) * [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) +* [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) * [Re-running application does nothing](#re-running-application-does-nothing) * [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) * [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) - * [EDMarketConnector needs permission to use shortcuts](#edmarketconnector-needs-permission-to-use-shortcuts) * [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) * [Linux](#linux) @@ -194,6 +195,95 @@ or other location chosen by you). + + + +# Installation Issues + + + + + +## 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. + + + + + + +## 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. + + + + + + +## 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)". + + + + + + +## 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. + + + @@ -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. - Re-start the app. - - - - - -## 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. - - - - - - -## 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. - - - - - - -## 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)". - - - - - - -## 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. - ---