Configuring Logging Options for Attachmate Product Installation
Technical Note 2618
Last Reviewed 03-Jul-2014
Applies To
INFOConnect Enterprise Edition for Airlines, IBM and Open Systems version 9.0 or higher
Reflection 2014
Reflection Pro 2014
Reflection for IBM 2014
Reflection for UNIX and OpenVMS 2014
Reflection X 2014
Reflection for IBM 2011
Reflection for UNIX and OpenVMS 2011
Reflection Standard Suite 2011
Reflection X 2011
Reflection Suite for X 2011
Reflection for Secure IT Windows Client version 7.0 or higher
Reflection for Secure IT Windows Server version 7.0 or higher
Verastream Host Integrator Server Kit (Windows) version 7.0 or higher
Verastream Host Integrator Development Kit version 7.0 or higher
Verastream Process Designer
Summary

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.

Setup User Interface

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."

2618_0.gif

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 the following:

  • Setup.exe for Verastream Host Integrator does not display an Advanced tab.
  • Some operating systems will delete the temporary folder and its contents after a reboot to reclaim disk space. If an install requires a system reboot, copy or move the install log to a different location before restarting.

Configuring Logging in Customized Deployments

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.

Logging Options in Setup.ini

Three settings are supported for configuring logging in Setup.ini: Logging, DeleteLog, and Logfile. These options are specified in the [Setup] section.

Logging=

Possible values: 0, 1

0= Logging is off

1= Logging is on

Default: 1

DeleteLog=

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.

Default: 1

Logfile=

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:

C:\Users\john\AppData\Local\Temp\atm4037680.log

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.

Sample Edited Setup.ini File

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.

[Setup]
ProductPath=se11r1c.msi
SLAPath=license_???.rtf
DestDirKey=INSTALLDIR
AdminFolder=Reflection
SelectAdmin=1
SelectDestination=1
SelectFeatures=1
AskVPA=1
AskMetering=1
Logging=1
LanguageFeatures=LANG_Eng,LANG_Deu,LANG_Fra,LANG_Jpn,LANG_Ita,LANG_Esp,LANG_Ptb
SystemReqURL=Help\Reflection2011\<lang>\user-html\install_requirements_ov.htm
ShowUserDataDirOption=true

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]
ProductPath=se11r1c.msi
SLAPath=license_???.rtf
DestDirKey=INSTALLDIR
AdminFolder=Reflection
SelectAdmin=1
SelectDestination=1
SelectFeatures=1
AskVPA=1
AskMetering=1
Logging=1
LogFile=%TMP%\Reflection_Install.log
DeleteLog=0
LanguageFeatures=LANG_Eng,LANG_Deu,LANG_Fra,LANG_Jpn,LANG_Ita,LANG_Esp,LANG_Ptb
SystemReqURL=Help\Reflection2011\<lang>\user-html\install_requirements_ov.htm
ShowUserDataDirOption=true

Command Line Options

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:

msiexec ?

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
Related Technical Notes
1999 Reflection for Secure IT Technical Notes
2234 Reflection X Advantage Technical Notes
2251 Verastream Transaction Integrator Technical Notes
9913 Technical Notes for INFOConnect
9967 Technical Notes for Reflection 2014 and 2011
40999 Verastream Host Integrator Technical Notes

Did this technical note answer your question?

           



Need further help? For technical support, please contact Support.