This technical note describes several approaches for managing how the Attachmate Setup program generates and deletes log files, with an emphasis on how administrators can configure Setup.ini to specify logging options.
Users installing Attachmate products can configure logging options in the Advanced tab of the user interface using "Create a log file for this installation" and "Delete log file if install succeeds."
By default both options are selected (as specified in the Setup.ini file), which means that a log file is created, but is kept only if the install doesn't succeed.
Note: Setup.exe for Verastream Host Integrator does not display an Advanced tab.
Administrators who use the Attachmate Customization Tool to customize deployment can configure logging, however there is no user interface for setting logging options in the Attachmate Customization Tool. To configure these options, you can modify Setup.ini.
Three settings are supported for configuring logging in Setup.ini: Logging, DeleteLog, and Logfile. These options are specified in the [Setup] section.
Possible values: 0, 1
0= Logging is off
1= Logging is on
Possible values: 0, 1
0 = Do not delete the log file.
1 = If the install is successful, delete the log file after the install is complete. The log file is also deleted if it is empty.
The full path and name of the log file to write to.
If no value is specified, the log file defaults to a file in the user's temp directory with an extension of .log. For example, in Windows 7 a sample default log file would be:
Note: Setup.exe will not create a folder for the LogFile if it does not already exist. If you modify this setting, use a folder location known to exist on target systems. Setup will fail with the MSI error 1622 if the specified folder cannot be found, or the log file name is not provided.
The following is a sample [Setup] section from Attachmate Reflection Standard Suite 2011
Note: The [Setup] section of Setup.ini also includes settings that don't affect logging, as shown in this example. These options vary between products.
The following [Setup] section has been edited to create a log file called Reflection_Install.log in the user's temp folder, and to retain the log file regardless of whether or not the install is successful.
Setup.exe does not support command line switches to specify logging options. If you install using Setup.exe, use Setup.ini settings to configure logging. In cases where you prefer to bypass Setup.ini configuration completely, and you desire command line support for configuring logging, use msiexec.exe to install Attachmate products. To view logging options supported by msiexec, enter the following in a Command window:
For example, the following command line uses msiexec.exe to install INFOConnect 9.0 and create a log file called INFOConnectInstall.log.
MsiExec/i <path>\IC900.msi" /passive /l*v %tmp%\INFOConnect.Install.log