Troubleshooting Tool: How to Create an Installation Verbose Log for Troubleshooting


A verbose log is a logging method which records and tracks all changes and settings applied to a machine at the time of an installation.  Verbose logging, which comes from the term verbose meaning, “expressed in more words than necessary,” logs a lot of useful information that can be used for troubleshooting purposes.  If you are running into issues installing DraftSight, use the methods described below to create a verbose log of the installation while tracking visible or latent issues.  Furthermore, use the methods described below to submit a verbose log of the installation to a technical support engineer whenever requested.

Prerequisites:

 

  1. Open your data compression utility software.  Drag-and-drop the DraftSight.exe file into your data compression utility software.  This will allow you to extract the contents of the .exe packaged file.
  2. Create a new folder on your machine and extract the contents of DraftSight.exe into this folder
  3. While holding the Shift key, right-mouse click on DraftSight.msi and select, Copy as path as shown below:
  4. Create a new text document on your desktop by right-mouse clicking on your desktop and selecting New > Text Document as shown below:
  5. Now click on the Windows Start menu icon and search for cmd.exe
     
  6. Right-mouse click on cmd.exe and select Run as administrator
  7. The command line will be written in the following form:
    msiexec /i /L*V

    therefore, first add the following line:
    msiexec /i

    then go to the Edit menu and paste the path to the installation directory as shown below: 
    Now add the following to the command line:
    /L*V

    Finally, add the path to the text file created on your desktop.  Use the "Copy as path" shortcut explained in step 3 to copy and paste the path into the command prompt.

    The completed command line should look similar to this with maybe the exception of the path names:
     
  8. When done hit the Enter key to initiate the installation.
  9. Continue installing DraftSight...
     
  10. If prompted with an error message, proceed with the unsuccessful installation until the installation dialog box is completely closed.

    Note:  logging will not be finalized until all installation dialog boxes are closed
  11. Verify whether logging has been completed by opening the text document created.
  12. The log should contain a lot of information.  Using Ctrl+F to initiate the find tool will allow you to search for the term Return value 3 which will point to the section where the installation failed.
  13. Reviewing the contents of the log immediately before the Return value 3 string will help determine which action failed.
  14. If a verbose log file is requested by a technical support engineer, send the text file created.