Documentation/Nightly/Developers/Tutorials/Troubleshooting - Revision history

Lasso at 21:02, 12 February 2022

2022-02-12T21:02:45Z

Lasso: Replaced content with "{{documentation/versioncheck}} {{documentation/banner | text = [https://slicer.readthedocs.io/en/latest/developer_guide/debugging/overview.html Th..."

2021-08-19T05:40:42Z

Replaced content with "<noinclude>{{documentation/versioncheck}}</noinclude> {{documentation/banner | text = [https://slicer.readthedocs.io/en/latest/developer_guide/debugging/overview.html Th..."

Show changes

Lasso: /* Debugging Slicer application startup issues */

2020-12-22T04:18:27Z

Debugging Slicer application startup issues

Lasso: /* Instruction for Windows */

2020-12-22T03:19:46Z

Instruction for Windows

Lasso: /* Instruction for Windows */

2020-12-22T03:07:43Z

Instruction for Windows

Lasso: /* Instruction for Windows */

2020-01-13T19:19:00Z

Instruction for Windows

Lasso: /* Instruction for Windows */

2018-09-10T17:41:41Z

Instruction for Windows

Lasso: /* Instruction for Windows */

2017-06-10T04:09:52Z

Instruction for Windows

Lasso: /* Instruction for Windows */

2016-07-19T21:07:54Z

Instruction for Windows

Lasso: /* Debugging Slicer application startup isses */

2016-07-19T21:05:58Z

Debugging Slicer application startup isses

@@ Line 2: / Line 2: @@
 {{documentation/banner
-| text  = [https://slicer.readthedocs.io/en/latest/developer_guide/debugging/overview.html This page has been moved to read-the-docs.]
+| text  = [https://slicer.readthedocs.io/en/latest/user_guide/get_help.html#slicer-application-does-not-start This page has been moved to read-the-docs.]
 | background-color = 8FBC8F }}

← Older revision		Revision as of 04:18, 22 December 2020
Line 260:		Line 260:

	=Debugging Slicer application startup issues=		=Debugging Slicer application startup issues=
−	* Your computer CPU or graphics capabilities may not meet minimum requirements. 3D Slicer should work on any computer that is manufactured less than 5 years ago, on operating systems that are still supported by their vendor. Updating your graphics card driver may fix some problems, but if that does not help and you have an old computer then you may need to upgrade to a newer one.	+	This documentation section has been moved '''[https://slicer.readthedocs.io/en/latest/user_guide/get_help.html#slicer-application-does-not-start here]'''.
−	* Slicer may not work if it is installed in a folder that has ~~special characters in their name. Try installing Slicer in a path that only contains latin letters and numbers (a-z, 0-9).~~
−	* Your Slicer settings might have become corrupted
−	** Try launching slicer using <pre>Slicer.exe --disable-settings</pre> (if it fixes the problem, delete Slicer.ini and Slicer-<yourslicerversion>.ini files from your Slicer settings directory.
−	** On Windows: Go to your Slicer settings directory (for example, c:\Users\<yourusername>\AppData\Roaming\ directory - see https://slicer.readthedocs.io/en/latest/user_guide/~~settings~~.html#~~settings~~-~~file~~-~~location for instructions for getting the settings directory). Rename it (for example, rename NA~~-~~MIC to NA~~-~~MIC-backup). Try to launch Slicer.~~
−	* There may be conflicting DLLs in your system path (caused by installing applications that place libraries in incorrect location on your system)
−	** On Windows:
−	*** Start Event Viewer (eventvwr.exe), select Windows Logs / Application, and find the application error. If there is a DLL loading problem a line similar to this will appear: Faulting module path: <something>.dll
−	*** If you found a line similar to this, then try the following workaround: Start a command window. Enter “set path=” to clear the path variable. Enter Slicer.exe to start ~~Slicer.~~
−	*** If Slicer starts successfully then you need to remove remove unnecessary items from the system path (or delete the libraries installed at incorrect locations).
−	*** If Slicer does not work then collect some more information and [[Documentation/{{documentation/version}}/Report_a_problem\|report the problem]]:
−	**** Enable process loading logging using the sxstrace tool and see if it shows any errors (see instructions here: https://technet.microsoft.com/en-ca/library/hh875651.aspx).
−	**** Get DLL dependency information:
−	***** Download depends.exe (http://www.dependencywalker.com/)
−	***** Run depends.exe using the Slicer launcher: Slicer.exe --launch .............\depends.exe "bin\SlicerApp-real.exe"
−	***** In dependency walker:
−	****** Make sure the full path of DLLs are shown (click View / Full paths if you only see the DLL names)
−	~~****** File / Save as... => Comma Separated Values (*~~.~~csv)~~

@@ Line 260: / Line 260: @@
 =Debugging Slicer application startup issues=
-== Instruction for Windows ==
+* Your computer CPU or graphics capabilities may not meet minimum requirements. 3D Slicer should work on any computer that is manufactured less than 5 years ago, on operating systems that are still supported by their vendor. Updating your graphics card driver may fix some problems, but if that does not help and you have an old computer then you may need to upgrade to a newer one.
 * Your Slicer settings might have become corrupted
 ** Try launching slicer using <pre>Slicer.exe --disable-settings</pre> (if it fixes the problem, delete Slicer.ini and Slicer-<yourslicerversion>.ini files from your Slicer settings directory.
-** Go to c:\Users\<yourusername>\AppData\Roaming\ directory. Rename NA-MIC to NA-MIC-backup. If you cannot find a NA-MIC directory there then check the [[Documentation/{{documentation/version}}/SlicerApplication/Settings]] page for instructions for getting the settings directory. Try to launch Slicer.
+** On Windows: Go to your Slicer settings directory (for example, c:\Users\<yourusername>\AppData\Roaming\ directory - see https://slicer.readthedocs.io/en/latest/user_guide/settings.html#settings-file-location for instructions for getting the settings directory). Rename it (for example, rename NA-MIC to NA-MIC-backup). Try to launch Slicer.
 * There may be conflicting DLLs in your system path (caused by installing applications that place libraries in incorrect location on your system)
-** Start Event Viewer (eventvwr.exe), select Windows Logs / Application, and find the application error. If there is a DLL loading problem a line similar to this will appear: Faulting module path: <something>.dll
+** On Windows:
-** If you found a line similar to this, then try the following workaround: Start a command window. Enter “set path=” to clear the path variable. Enter Slicer.exe to start Slicer.
+*** Start Event Viewer (eventvwr.exe), select Windows Logs / Application, and find the application error. If there is a DLL loading problem a line similar to this will appear: Faulting module path: <something>.dll
-** If Slicer starts successfully then you need to remove remove unnecessary items from the system path (or delete the libraries installed at incorrect locations).
+*** If you found a line similar to this, then try the following workaround: Start a command window. Enter “set path=” to clear the path variable. Enter Slicer.exe to start Slicer.
-** If Slicer does not work then collect some more information and [[Documentation/{{documentation/version}}/Report_a_problem|report the problem]]:
+*** If Slicer starts successfully then you need to remove remove unnecessary items from the system path (or delete the libraries installed at incorrect locations).
-*** Enable process loading logging using the sxstrace tool and see if it shows any errors (see instructions here: https://technet.microsoft.com/en-ca/library/hh875651.aspx).
+*** If Slicer does not work then collect some more information and [[Documentation/{{documentation/version}}/Report_a_problem|report the problem]]:
-*** Get DLL dependency information:
+**** Enable process loading logging using the sxstrace tool and see if it shows any errors (see instructions here: https://technet.microsoft.com/en-ca/library/hh875651.aspx).
-**** Download depends.exe (http://www.dependencywalker.com/)
+**** Get DLL dependency information:
-**** Run depends.exe using the Slicer launcher: Slicer.exe --launch .............\depends.exe "bin\SlicerApp-real.exe"
+***** Download depends.exe (http://www.dependencywalker.com/)
-**** In dependency walker:
+***** Run depends.exe using the Slicer launcher: Slicer.exe --launch .............\depends.exe "bin\SlicerApp-real.exe"
-***** Make sure the full path of DLLs are shown (click View / Full paths if you only see the DLL names)
+***** In dependency walker:
-***** File / Save as... => Comma Separated Values (*.csv)
+****** Make sure the full path of DLLs are shown (click View / Full paths if you only see the DLL names)
-* Your computer CPU or graphics capabilities may not meet minimum requirements. 3D Slicer should work on any computer that is manufactured less than 5 years ago, on operating systems that are still supported by their vendor. Updating your graphics card driver may fix some problems, but if that does not help and you have an old computer then you may need to upgrade to a newer one.
+****** File / Save as... => Comma Separated Values (*.csv)

@@ Line 276: / Line 276: @@
 ***** Make sure the full path of DLLs are shown (click View / Full paths if you only see the DLL names)
 ***** File / Save as... => Comma Separated Values (*.csv)
-* Graphics card minimum requirements have been increased in Slicer-4.9 compared to Slicer-4.8. Updating your graphics card driver may fix the issue.
+* Your computer CPU or graphics capabilities may not meet minimum requirements. 3D Slicer should work on any computer that is manufactured less than 5 years ago, on operating systems that are still supported by their vendor. Updating your graphics card driver may fix some problems, but if that does not help and you have an old computer then you may need to upgrade to a newer one.
 * Slicer may not work if it is installed in a folder that has special characters in their name. Try installing Slicer in a path that only contains latin letters and numbers (a-z, 0-9).

← Older revision		Revision as of 19:19, 13 January 2020
Line 277:		Line 277:
	***** File / Save as... => Comma Separated Values (*.csv)		***** File / Save as... => Comma Separated Values (*.csv)
	* Graphics card minimum requirements have been increased in Slicer-4.9 compared to Slicer-4.8. Updating your graphics card driver may fix the issue.		* Graphics card minimum requirements have been increased in Slicer-4.9 compared to Slicer-4.8. Updating your graphics card driver may fix the issue.
		+	* Slicer may not work if it is installed in a folder that has special characters in their name. Try installing Slicer in a path that only contains latin letters and numbers (a-z, 0-9).

← Older revision		Revision as of 17:41, 10 September 2018
Line 276:		Line 276:
	***** Make sure the full path of DLLs are shown (click View / Full paths if you only see the DLL names)		***** Make sure the full path of DLLs are shown (click View / Full paths if you only see the DLL names)
	***** File / Save as... => Comma Separated Values (*.csv)		***** File / Save as... => Comma Separated Values (*.csv)
		+	* Graphics card minimum requirements have been increased in Slicer-4.9 compared to Slicer-4.8. Updating your graphics card driver may fix the issue.