Installation log files

To trace issues during an installation, log files are created. In these log files, the installation progress and issues are logged by the installable unit.

The Installation Wizard can detect errors through these log files. Do not change or delete these files.

Client

Depending on the type of IU, the user has two options:

  • Use the Staging Wizard that creates a Staging Area, and run the installation of the IU from Staging Area.
  • Skip the Staging Wizard and Staging Area and directly run the installation for one IU by its stand-alone setup.exe file.

Note that most of the IUs must be installed using the Staging Wizard.

Using a Staging Area, log files can be found in:

  • <Staging Area>\Logging files\<environment>

    Where <Staging Area> refers to the directory where the Staging Area is located.

  • %TEMP%\Baan Setup\<environment>

    Where %TEMP% refers to the directory name of the windows variable TEMP.

In the log directories, you can also find the file BaanERPClient.info. The BaanERPClient.info file contains the settings that the installation user has chosen. As soon as the user defines an environment and a destination for the installation, the Installation Wizard checks the system for an existing installation.

If the file $BSE/lib/install/BaanERPServer.info is found, the settings are copied from the server to the client to the file BaanERPClient.info. After the copy from the server, all configuration settings are stored in files BaanERPServer.info and BaanERPClient.info. The BaanERPServer.info file overrules BaanERPClient.info file. The same applies for the BaanERPServer.log, the BaanERPClient.log files, and the ExistingIUs.info files

BaanERPClient.log

The BaanERPClient.log file is usually the first file to check if an error occurs. The file contains information about what the Installation Wizard detects, and shows the more general error descriptions.

For example:

BaanERPClient.log

4/26/2006[13:30:34(UTC-02:00)]:I:bsp: INFO - Detected Platformtype: Windows_NT

4/26/2006[13:39:22(UTC-02:00)]:E:bsp: ERROR - ttbsi.000700: Error opening file C:\Staging Area\InstallableUnits\ InstallableUnit_ERP_Installer\Setup_debug\..\..\..\InstallableUnits\OW ERP 6_1\\applfiles\ bw_import!

This timestamp is related to the time on the Client machine. If the time on the Client differs from the time on the Servers, you must take that time difference into account when comparing time stamps. Before you start the Installation Wizard, synchronize the time setting for both machines.

See section Server.

BaanERPClient.info

The BaanERPClient.info file contains the information about which configuration is used and the current status of the installation. This table, shows the most important settings:
Parameter Description
Environment=erpenterprise Environment for installation.
Location=0 Local Windows machine.
ProductName=BaanERP Product name.
TmpDir=C:\Staging Area\Logging Files\erpenterprise Directory for this info file and log file.
SupportDir=C:\DOCUME~1\pleersni\LOCALS~1\Temp\{3C5A8C2F-AD79-4884-B78B-0488FBE8E1BC}\ Temporary installation directory of User.
Hostname=CNL09834 Hostname where to install.
User=bsp Installation User.
SuperUser= Super user, only UNIX.
BsePath=c:\Infor\erpenterprise\bse $BSE, the path where the software is installed.
PlatformType=Windows Platform type.
BseRel=6.2 Use value 6.1 for Infor Baan IV.

Use value 6.2 for Infor Baan 5, Infor Baan 5.2, or LN.
PreReger=0 Use value 0 for Infor Baan 5.2 or LN.

Use value 1 for Infor Baan IV, or Infor Baan 5.
DbType=msql7 Database type: SQL server.
BaanMAS=1 0 for AS; 1 for MAS installation.
InstallStatus=4000 0 for new; 4000 for finished; 0<InstallStatus<4000 for a failed installation.
IUStatus= IU key where the installation was crashed.
PortingSetInstalled=1 1: A porting set was installed before.
ApplSetInstalled=1 1: Tools were installed before.
BCLMLogin…. Settings for an SLM installation.
ASMLogin….. Settings for an ASM installation.
GenParams.szSelectedKeys=,ERP_Tools, ERP_Applications List with selected IUs to install.
szVRCs[0][0].szBaseVRC=7.6_a_tt List with base VRCs to install solutions for.
szVRCs[0][0].szUpdateVRCs= 7.6_a List with update VRCs to install solutions for.

Server

All log files and info files on the server can be found in the directory tree where LN is installed. The name of the top level of this directory tree is referred to as $BSE. For installations on a Windows machine, all directory forward (/) slashes must be read as backward (\) slashes.

The Installation Wizard supports fresh installations and updates for LN

The file ExistingIUs.info contains information about what Installable Units are installed earlier, and all subdirectories of $BSE\lib\install.

Do not remove the directory $BSE\lib\install or one of the other files. In case files are missing, next updates fail.

BaanERPServer datetime logfile

The BaanERPServer<datetime>.log can be found in the directory: $BSE/lib/install

The BaanERPServer<datetime>.log file contains all logging as described in "Client". In contrary with BaanERPClient.log, the BaanERPServer<datetime>.log is split into log files indicating the dates and times when the setup was started. After every update or restart, a new BaanERPServer.log file is added; this file is displayed when the Installation Wizard has finished. The BaanERPClient.log file on the client is a merge of all these files. All info found on the Client machine can also be found on the server. This directory serves as a backup if the files on the Client machine are deleted or the installation is restarted from another Client machine. For the info files, the files in this directory are leading.

ExistingIUs.info

The ExistingIUs.info file contains information about what Installable units have been installed earlier. The file is located in the directory: $BSE\lib\install

An example of the ExistingIUs.info file:

  • ExistingIus.info
  • ERP_RuntimeTools_WINDOWS
  • OW_ERP_Adapter
  • ERP_Applications
  • ERP_Tools

This file is also written to the client in the directory: <Staging Area>\Logging files\<environment>

The ExistingIUs.info file on the server is always leading.

Installing porting sets

During the installation of a porting set, the folder $BSE/lib/install/vm is created/updated. This virtual machine (VM) folder contains a part of the virtual machine, necessary for the installation of the porting set. During the installation of the porting set, logging is done in the subdirectory log.

Installing DEM models

During installation for example DEM models, calls are made to 3GL functions. These functions usually log their information in the directory: $BSE/log

Depending on the date and time these log files were created/updated, you can find out where an error has occurred. If the installation fails during the import, the main log file created by the import is named log.ottiex1287.

cURL/remote commands

During the installation, remote commands or cURL calls are often run. If an error occurs during such a command the Windows Event Viewer (application) shows the reason for this error

TMP files

During an installation temporary files are created. If the installation fails, these temporary files are not always removed. These files can contain more information about the failure. You can remove the files from one of these directories:

  • $BSE/lib/install/vm/tmp
  • $BSE/tmp

Failed installations

If an installation fails, you must check the log files and try to solve the issue, then restart the installation. The dialog boxes to select the Installable Units are displayed with the previously selected installable units, except for the ones already successfully installed. You can add or remove Installable Units.

When clicking Next in the Destination Directory dialog box, the installation program discovers that a failure happened during the previous installation. This is indicated by the InstallStatus in the BaanERPClient.info file. The Restart Installation dialog box is displayed.

Explanation of the options:

  • Restart Current: Removes old installation settings and restarts the installation of the currently selected installable units.

    Note that during a Restart Current, the files in BaanERPServer.info are reset.

    • InstallStatus
    • IUstatus
    • SelectedKeys
    • PaccCheckSum
    • PaccSel

    For example, if InstallStatus is set to 4000, the $BSE/tmp directory is emptied; 4000 means finished.

  • Restart Previous: Removes old installation settings and restarts the installation of the previously selected installable units.
  • Retry: Continues with the installation at the point where it stopped; this is faster, but less secure than the other options. This option always continues with the previous selection.
  • Abort: Cancel the installation.