Tech Note 643 Error Logging in IntelaTrac All Tech Notes, Tech Alerts and KBCD documents and software are provided "as is" without warranty of any kind. See the Terms of Use for more information. Topic#: 002407 OpsManage09 Session#: TS107 Created: November 2009 Introduction This Tech Note explains the location of the IntelaTrac log files for the Client, Server, Web Reports and Mobile. It also explains changing the log to different levels in order to capture the appropriate information required for troubleshooting. This is useful when troubleshooting potential issues with the Sync Service, Scheduler Service, IMC, Web Reports Scheduling Engine, and Mobile. Note: Not all messages in the log are indicative of a problem. Contact Technical Support if questions arise. Application Versions IntelaTrac version 3.2 This Tech Note applies to the following files, listed by their node location: Client Serv er SAT.Synchronization.Service.config SAT.Scheduling.Service.config SAT.DTS.Service.config W eb Reports Web.config WebReportsSchedulingEngine.exe.config Mobile Locating Log Files In all cases the log files are found in a \Log folder. Note: This documents references the C: drive, however, the application may be installed to a different drive. Intelatrac Management Center (IMC) C:\Program Files\Wonderware\IntelaTrac\Log FIGURE 1: CLIENT LOG LOCATION Server C:\Inetpub\wwwroot\IntelaTracWebReports\Log https://wdnresource.wonderware.com/support/kbcd/html/1/t002407.htm 1/5
FIGURE 2: SERVER LOG LOCATIONS Web Reports C:\Inetpub\wwwroot\IntelaTracWebReports\Logs FIGURE 3: WEB REPORTS LOG LOCATION Mobile My Device\Program Files\Wonderware\MobileIntelaTrac\Log FIGURE 4: MOBILE LOG LOCATION Available Logging Levels The following values represent available logging levels. 1. Debug 2. Info 3. Warn 4. Error (default) 5. Fatal 6. Off The amount of log messages collected decreases as you go down the list from 1 to 6. Debug collects the most messages and Fatal collects the least. No messages are collected when logging is set to Off. Debug collects Info, Warn, Error and Fatal. Info collects all but the Debug messages and so on down the list. Each IntelaTrac config is set to Error by default. We do not recommend running the system at any level but error for long periods of time in production as the more logs collected the slower the system will run. The Debug level should only be used for short periods of time as it has the potential to slow down the system greatly as well as rapidly use up disk space since the log will grow continually until the level is set back to Error. Modifying Logging Levels Each config file contains a <LoggingSection> element (Figure 5 below): https://wdnresource.wonderware.com/support/kbcd/html/1/t002407.htm 2/5
FIGURE 5: LOGGING LEVEL ELEMENT IN CONFIG FILE The section that determines the logging level is found here. Simply change the Error value to any of the other levels and save the config file. Warning: Open the configs ONLY in Notepad, and save your changes. Once the save is made depending on the config you modified the corresponding service must be restarted. For example, if you modify the SAT.Scheduling.Service.config file, you then restart the IntelaTrac Scheduler service. Modifying Logging Levels on the Handheld Note: Only users with appropriate permissions can change settings. If you have performed an initial transfer on the mobile, and you are required to select a base/role/and login id, then you must also enter your password before clicking Tools to edit the setting. This is necessary in order to authenticate your permission to modify the settings. On the IntelaTrac login screen you will see a Tools icon located on the bottom left corner: FIGURE 6: TAP TOOLS 1. Tap Tools then tap config from the list: https://wdnresource.wonderware.com/support/kbcd/html/1/t002407.htm 3/5
FIGURE 7: TAP CONFIG 2. Select the logging settings option: FIGURE 8: TAP LOGGING SETTINGS 3. From the logging settings screen you will see the drop-down box where you are able to select the different logging levels: https://wdnresource.wonderware.com/support/kbcd/html/1/t002407.htm 4/5
FIGURE 9: SELECT DESIRED LEVEL OF LOGGING 4. Select the desired logging level and tap the Save icon. Once the handheld runs through several transfers the log file must be pulled from the handheld via Active Sync and opened on a desktop for viewing. Click the following icon to view this file in.pdf format: J. Perillo Tech Notes are published occasionally by Wonderware Technical Support. Publisher: Invensys Systems, Inc., 26561 Rancho Parkway South, Lake Forest, CA 92630. There is also technical information on our software products at Wonderware Technical Support. For technical support questions, send an e-mail to support@wonderware.com. Back to top 2013 Invensys Systems, Inc. All rights reserved. No part of the material protected by this copyright may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying, recording, broadcasting, or by anyinformation storage and retrieval system, without permission in writing from Invensys Systems, Inc. Terms of Use. https://wdnresource.wonderware.com/support/kbcd/html/1/t002407.htm 5/5