Frontier Developments have asked us to assist them in hunting down instancing problems, in hopes of improving their netcode to prevent these problems. As we are a fairly well-organized team with a very varying type of clientele, and the ones who most frequently put special effort into resolving such problems, we are a good source of information for them on this.

To assist in this, we have a dedicated JIRA project which FDev can access to review instancing logs.

Preparing your Elite: Dangerous client for IPR

To enable FDev to glean as much useful data as possible from your log files, you must alter your AppConfig.xml.

The section you are looking to replace is the Networking section. Replace it with the following:

<Network
Port="5100"
upnpenabled="0"
LogFile="netLog"
RouterPort="5100"
DatestampLog="1"
ReportSentLetters="1"
ReportReceivedLetters="1"
VerboseLogging="1">
</Network>

Then, consult your router's manual on how to set up a port forward to your computer. You want to forward UDP traffic on port 5100 to the computer which runs Elite: Dangerous. Alternatively, you may place your computer in the router's DMZ, although this is considered less secure than forwarding just the port itself. 

 

Verbose netlogs grow VERY quickly in size. You may want to regularly prune your netlog folder to remove old logs you do not need.

 

Please note that whenever you update your client, you must make this change to AppConfig.xml again, as the update process overwrites the file.

On a standalone installation outside of C:\Program Files\, the directory where AppConfig.xml is located is Frontier\EDLaunch\Products\Elite-Dangerous-64\

Standalone installation on Windows 10: C:\Users\%yourusername%\AppData\Local\Frontier_Developments\Products\Elite-Dangerous-64\

Steam installation: C:\Program Files (x86)\Steam\SteamApps\common\Elite Dangerous\Products\elite-dangerous-64 (default, if you have a steam library in a different path, it's <library>\SteamApps\common\Elite Dangerous\Products\elite-dangerous-64)


Standalone installation on macOS: /Users/username/Library/Application Support/Frontier_Developments/Products/FORG-FDEV-D-10XX/EliteDangerous

Steam installation on macOS: /Users/username/Library/Application Support/Steam/steamapps/common/Elite Dangerous/Products/FOR-FDEV-D-10XX/EliteDangerous

Right click the 'EliteDangerous' file and select 'Show package contents'

The AppData directory in Windows and the 'Library' directory in macOS is hidden by default.

To unhide the Windows AppData folder, select the 'View' tab in Explorer, click the 'Options' button in the toolbar, select the 'View' tab in the panel that appears, and check 'Show hidden files, folders, and drives'

To unhide the macOS 'Library' folder, right click in your home directory, select 'Show View Options' , and check 'Show Library Folder'

 

Procedure during rescue

If you are participating in the IPR program, and you fail to instance with a client, note the approximate time that you dropped to the client, but failed to instance with them. If you later succeed in instancing with the client, please note that time as well.

You should also note the client's CMDR name, the system the rescue happened in, and any other factors you notice (Failed to get text comms, wing iconography being wrong (Showing destroyed or similar), or instancing problems with other rats.

If possible, ask if the client has verbose logging turned on, and if they would be willing to submit their netlog file to help us help FDev research these problems. If the client is willing, ask them to mail you, or otherwise make available on the internet, the log file.

FDev's best hopes of getting to the bottom of instancing problems is having the netlog from both the rats and the clients' side, so do please try to get their netlog. Tell them that we are helping FDev with investigating instancing problems, and that their assistance would be appreciated.

 

Post-rescue paperwork

Once the rescue is complete, if you experienced instance problems, you need to open a JIRA issue in the IPR bucket by clicking here.

Please be prepared to provide the following information:

You will also need to attach your NetLog file for the relevant time period. The Netlog files are stored in the Products\Elite-Dangerous-64\Logs directory on Windows and in the Elite Dangerous/Logs directory on macOS, and are split into parts while your client is running. It is therefore important that you locate the correct file to submit. It should be:

If the client has also provided you with a logfile, download that, and attach it as well.

The description of the issue should include as much data as you can provide about the event surrounding the failed instance, such as:

Provide too much information rather than too little, but try to keep to relevant information to the instancing problem, not to the rescue itself.

Create an Instancing Problem Report

Even if you were not the rat who got first limpet on the client in the end, you should fill out this issue if you had instancing problems!