Applicable to

BarTender 2016

Information

Auto-Generated Logs

Here are the steps to obtain the auto-generated install log (in case this Windows feature is enabled):

1. Open Windows Explorer.
2. In the location, type in %temp% and hit Enter. It should take you to your user-specific Windows temp directory, and if you scroll down you will find MSIxxxx.txt files.

3. There are several ways to figure out if this is the MSI you are looking for:
   • Sort the folder by Date modified. This should bring the most recently modified MSI files to the very top or bottom of the folder.
   • If you open the MSI file, there should be a mention of a file path containing the BarTender.msi file within the first 10 or so lines. This indicates that this text file is the log file that you need.
4. Once you have the Log File, open it with an advanced text editor to review it.
5. In the event that there is a logged error, it will have a return value of 3. Search for the string Value 3 to find the error.
   
   This search string is valid for operating systems set to English. If you are using a different OS language, you will need to use the appropriate translation.

Generate Installation Logs Through a Command Line Installation

An alternative method to produce a log of a failing installation would be to run it silently through a command line. Here's the most common example of logging a BarTender install or uninstall. Your customer will need to execute it from the command prompt:

1. Open the Command Prompt utility.
2. Type the following command into the command line:

   setup.exe /v"/l*v "InstallLog.log"

   • setup.exe is the bootstrapper.
   • /v passes a command to the msiexec.exe. (followed by a quote, the command, and a close quote at the end).
   • /l instructs msiexec.exe to create a log.
   • *v specifies a verbose log (an extended list of available options is listed).
   • InstallLog.log is the name of the file that will be created on disk in the same folder you are executing the command line from.
     
     

Applicable to

BarTender 2019 and later

Information

Here are the steps to obtain the auto-generated install log (in case this Windows feature is enabled):

1. Open Windows Explorer.
2. In the location, type in %temp% and hit Enter. It should take you to your user-specific Windows temp directory, and if you scroll down you will find MSIxxxx.txt files.
   
   
3. There are several ways to figure out if this is the MSI you are looking for:
   • Sort the folder by Date modified. This should bring the most recently modified MSI files to the very top or bottom of the folder.
   • If you open the MSI file, there should be a mention of a file path containing the BarTender.msi file within the first 10 or so lines. This indicates that this text file is the log file that you need.
4. Once you have the Log File, open it with an advanced text editor. As far as finding an error message in the Installer log file. In the event that there is a logged error, it will have a return value of 3. Search for the string "Value 3" to find the error (on English operating systems. If the operating system uses a different language, "Value 3" will be translated to whatever language the operating system is using).

Generate Installation Logs Through a Command Line Installation

An alternative method to produce a log of a failing installation would be to run it silently through a command line. Here's the most common example of logging a BarTender install or uninstall. Your customer will need to execute it from the command prompt:

1. Open the Command Prompt utility.
2. Type the following command into the command line:

   setup.exe /L*vx "InstallLog.log"

   /v is superseded by /L in BarTender 2019 and later installers.