Difference between revisions of "Diagnostics"

From ISBoxer
Jump to: navigation, search
Line 1: Line 1:
−
{{ISBoxer 40}}
+
{{ISBoxer 42}}
 
[[Category:Troubleshooting]]
 
[[Category:Troubleshooting]]
 
[[File:ISBoxer_39_Diagnostics_Window.png|right|thumb|500px|The [[Diagnostics]] window was introduced in [[ISBoxer 39]]]]
 
[[File:ISBoxer_39_Diagnostics_Window.png|right|thumb|500px|The [[Diagnostics]] window was introduced in [[ISBoxer 39]]]]
 
{{Youtube|<videoflash>bkHTidgJ-_I</videoflash>|MiRai demonstrates how to grab ISBoxer's Diagnostics.}}
 
{{Youtube|<videoflash>bkHTidgJ-_I</videoflash>|MiRai demonstrates how to grab ISBoxer's Diagnostics.}}
−
ISBoxer provides a handy [[Diagnostics]] tool for providing useful information to us, in the event that your game, or its launcher, hangs or crashes when launched through Inner Space. Specifically, it provides a list of processes running on your system, and a list of modules loaded inside a specific process -- your game or its launcher.
+
= Overview =
 +
ISBoxer provides a handy [[Diagnostics]] tool for providing useful information to us, in the event that your game, or its launcher, hangs or crashes when launched through Inner Space. Specifically, it provides a list of processes running on your system, and a list of modules loaded inside a specific process—your game or its launcher. There are two types of diagnostics that are offered:
 +
# Compatibility — Used for troubleshooting crashes, something else, and/or most other basic issues
 +
# Trace — Used for troubleshooting game clients locking up (or something)
  
−
'''Diagnostics do not deliberately include any personally identifiable information*, nor anything that can be used to find or hack your computer.'''
+
=== What it includes ===
−
<br/>A diagnostic includes:
+
'''Diagnostics do not deliberately include any personally identifiable information''¹'', nor anything that can be used to find or hack your computer.'''
−
# which version of ISBoxer generated the diagnostics
+
−
# which version of windows you are using
+
−
#a list of running programs on your computer, their executable file path, the process id (this is a random number which changes every time you run the program)
+
−
# settings to indicate whether a process is running as admin and whether it is 32 bit or 64 bit
+
−
# the loaded libraries/assemblies used by the process you select from the list
+
  
−
- '''*''' it will most likely include your computer username in some of the executable file paths, which might include your real name.  You can use notepad or some other text editor to remove this if you are concerned.
+
A diagnostic includes the following details:
 +
# Both the build and version numbers of Inner Space, ISBoxer, and Microsoft Windows
 +
# A list of running programs on your computer, their executable file path(s), and the Process ID (this is a random number which changes every time you run the program)
 +
# Settings to indicate whether a process is running as admin and whether it is 32-bit or 64-bit
 +
# The loaded libraries/assemblies used by the process you select from the list
 +
# Common compatibility settings found within the registry
  
 +
'''¹ It will most likely include your computer username in some of the executable file paths, which might include your real name.  You can use notepad or some other text editor to remove this if you are concerned.'''
  
−
== How to provide us with your diagnostics (see how in a 60 second [https://gfycat.com/SimilarHappygoluckyCrocodile GIF]) ==
+
 
 +
=== Compatibility Diagnostic ===
 +
In order to provide a Compatibility Diagnostic, either follow the instructions below, or watch this 60-second [https://gfycat.com/SimilarHappygoluckyCrocodile GIF].
 
# '''Launch your game''' as it would normally run, without ISBoxer or Inner Space. If the launcher is what is crashing, open just the launcher. Otherwise, get past the launcher so that the game window is open.
 
# '''Launch your game''' as it would normally run, without ISBoxer or Inner Space. If the launcher is what is crashing, open just the launcher. Otherwise, get past the launcher so that the game window is open.
 +
#* You may be specifically asked to run the game through Inner Space when providing a Compatibility Diagnostic, otherwise run it outside as stated above
 
# In ISBoxer's Help menu, select '''Diagnostics''' -> '''Compatibility Diagnostics'''
 
# In ISBoxer's Help menu, select '''Diagnostics''' -> '''Compatibility Diagnostics'''
−
# In the '''Running processes''' drop-down box, select the game or its launcher (from step 1). If you hadn't launched the game or launcher yet, click the '''Refresh''' button once you have opened it.
+
# In the '''Running processes''' drop-down box, select the game or its launcher (from step 1). If you've opened the Trace Diagnostic window prior to your game client freezing, then click the '''Refresh''' button.
 
# Click '''Generate Diagnostic report, and Copy it to Clipboard'''
 
# Click '''Generate Diagnostic report, and Copy it to Clipboard'''
−
# Go to the [http://pastebin.com pastebin.com] or alternatively [https://www.zerobin.net/ zerobin.net] or [http://ybin.me ybin.me]
+
# Go to [http://pastebin.com pastebin.com], [https://www.zerobin.net/ zerobin.net], or [http://ybin.me ybin.me]
 
# '''Paste the Diagnostic report''' in the text entry area
 
# '''Paste the Diagnostic report''' in the text entry area
 
# Select any options on the bottom (such as '''when to expire'''), and click '''Save Paste'''
 
# Select any options on the bottom (such as '''when to expire'''), and click '''Save Paste'''
−
# Give us the '''Paste URL'''
+
# '''Copy the URL from the address bar''' and share it with us
 
#* or, right click the '''Download''' link, select Copy Link Location, and paste this '''URL''' to us
 
#* or, right click the '''Download''' link, select Copy Link Location, and paste this '''URL''' to us
  
−
;If you aren't sure where to give us the link, it might be time to go to the [http://isboxer.com/index.php/chat ISBoxer Chat Room], [https://discord.me/isboxer ISBoxer Discord] or the [http://isboxer.com/forum ISBoxer Forums]!
+
;If you aren't sure where to give us the link, it might be time to go to the [http://isboxer.com/index.php/chat ISBoxer Chat Room], [https://discord.me/isboxer ISBoxer Discord], or the [http://isboxer.com/forum ISBoxer Forums]!
 +
 
 +
 
 +
=== Trace Diagnostic ===
 +
'''Note: This diagnostic type is currently only available for use with 32-bit game clients.'''
 +
 
 +
In order to provide a Trace Diagnostic, please follow the instructions below.
 +
# In ISBoxer's Help menu, select '''Diagnostics''' -> '''Trace Diagnostics'''
 +
# In the '''Running processes''' drop-down box, select the game window that is unresponsive (frozen). If you hadn't launched the game or launcher yet, click the '''Refresh''' button once you have opened it.
 +
# Click '''Generate Diagnostic report, and Save it to File''', and select a folder to save the file to
 +
# A DMP file will be created in that location—'''share this file''' with whomever you've been asked to share it with, either through a DM on the [https://discord.me/isboxer ISBoxer Discord], through e-mail, or through a file-sharing website (preferably one that isn't riddled with ads and deceptive practices).
 +
<br>
 +
<br>
 +
<br>
 +
<br>

Revision as of 03:53, 11 October 2018

This content (or portions thereof) describes ISBoxer 42! ISBoxer 42 is newly released, and we are working on updating parts of the documentation for the new version.

The Diagnostics window was introduced in ISBoxer 39
MiRai demonstrates how to grab ISBoxer's Diagnostics.

Overview

ISBoxer provides a handy Diagnostics tool for providing useful information to us, in the event that your game, or its launcher, hangs or crashes when launched through Inner Space. Specifically, it provides a list of processes running on your system, and a list of modules loaded inside a specific process—your game or its launcher. There are two types of diagnostics that are offered:

  1. Compatibility — Used for troubleshooting crashes, something else, and/or most other basic issues
  2. Trace — Used for troubleshooting game clients locking up (or something)

What it includes

Diagnostics do not deliberately include any personally identifiable information¹, nor anything that can be used to find or hack your computer.

A diagnostic includes the following details:

  1. Both the build and version numbers of Inner Space, ISBoxer, and Microsoft Windows
  2. A list of running programs on your computer, their executable file path(s), and the Process ID (this is a random number which changes every time you run the program)
  3. Settings to indicate whether a process is running as admin and whether it is 32-bit or 64-bit
  4. The loaded libraries/assemblies used by the process you select from the list
  5. Common compatibility settings found within the registry

¹ It will most likely include your computer username in some of the executable file paths, which might include your real name. You can use notepad or some other text editor to remove this if you are concerned.


Compatibility Diagnostic

In order to provide a Compatibility Diagnostic, either follow the instructions below, or watch this 60-second GIF.

  1. Launch your game as it would normally run, without ISBoxer or Inner Space. If the launcher is what is crashing, open just the launcher. Otherwise, get past the launcher so that the game window is open.
    • You may be specifically asked to run the game through Inner Space when providing a Compatibility Diagnostic, otherwise run it outside as stated above
  2. In ISBoxer's Help menu, select Diagnostics -> Compatibility Diagnostics
  3. In the Running processes drop-down box, select the game or its launcher (from step 1). If you've opened the Trace Diagnostic window prior to your game client freezing, then click the Refresh button.
  4. Click Generate Diagnostic report, and Copy it to Clipboard
  5. Go to pastebin.com, zerobin.net, or ybin.me
  6. Paste the Diagnostic report in the text entry area
  7. Select any options on the bottom (such as when to expire), and click Save Paste
  8. Copy the URL from the address bar and share it with us
    • or, right click the Download link, select Copy Link Location, and paste this URL to us
If you aren't sure where to give us the link, it might be time to go to the ISBoxer Chat Room, ISBoxer Discord, or the ISBoxer Forums!


Trace Diagnostic

Note: This diagnostic type is currently only available for use with 32-bit game clients.

In order to provide a Trace Diagnostic, please follow the instructions below.

  1. In ISBoxer's Help menu, select Diagnostics -> Trace Diagnostics
  2. In the Running processes drop-down box, select the game window that is unresponsive (frozen). If you hadn't launched the game or launcher yet, click the Refresh button once you have opened it.
  3. Click Generate Diagnostic report, and Save it to File, and select a folder to save the file to
  4. A DMP file will be created in that location—share this file with whomever you've been asked to share it with, either through a DM on the ISBoxer Discord, through e-mail, or through a file-sharing website (preferably one that isn't riddled with ads and deceptive practices).





Retrieved from "https://isboxer.com/w/index.php?title=Diagnostics&oldid=3157"