Home

SmartLogger 3.3 SmartLogger 3.3 User's Guide User's Guide

Contents

1. Figure 5 5 Character stripping Predefined Contains a list of predefined special characters characters that can be added to the ignore list User defined Special text combinations like printer escape string codes can be entered here and added to the ignore list Special characters must be enclosed in If a sample containing special characters is pasted into the edit box the special characters are converted automatically Strings to Lists all predefined characters and strings to be ignore ignored The character stripping feature is common for all active ports 5 3 Table Backup The SmartLogger is equipped with a backup tool that is adapted to the SmartLogger set up From the backup dialog you have access to 5 6 SR 2 SmartLogger User s Guide Maintenance all log tables generated by the SmartLogger and the possibility to copy all or some to a desired destination The backup dialog is opened from the menu item Tools Backup Table Backup EN Source database alias Source tables ESD2002WK30 ESD2002WK31 ESD2002WK32 ESD2002WK33 gt SCADA20020900 SCADA20021000 SCADA20021100 Backup destination C A WINDOWS TEMP El View changed tables only Move tables to archive delete source tables Figure 5 6 zl Backup X Cancel Table Backup Database Alias Source Tables Backup destination Tables to copy View Specifies
2. Oracle 8 Net8 Service name Table list cache time min Maggie D Default user name scott AutoCommit enabled Figure 6 6 Oracle 8 settings name Default name AutoCo Net8 Service user mmit enabled Table open list cache time Defines the Oracle Net8 service name Must be defined in advance by using the appropriate Oracle tool The default user name that is used if automatic database login is disabled If enabled the BDE automatically commit records to the table after each post If disabled the application decides when to commit the records Please note that this setting is only relevant for applications that actually write to an Oracle database like SmartLogger or SmartTranslator Defines how long the table list is cached in memory A new table list is not fetched from the database server before the cache time expires 1 This setting can have three values d The table list is cached as long as the program is running This should only be used for static databases where no tables are added after the program is started The table list is never cached This will increase network traffic as the table list is fetched directly from the database server every time it is requested SR 2 SmartLogger User s Guide Utilities gt 0 The table list is cached the number of minutes specified MS SQL Server 7 MSSQL driver locsrv01 nancy Figure
3. Modem connection Device COM Change Flow control NONE Connection pref IEN Communication options Number of attempts before warning 2 VA Character delay msec o A Ir Log modem communication to file JF SmartLog Logger TraceLogs AT Trace loc c X Cancel Figure 9 4 98 SR 2 SmartLogger User s Guide Notification Module Add on Modem connection Device Flow control Connection pret Change Shows the selected device Only devices actually available in the system can be specified NONE or XON XOFF Shows the currently selected connection preferences baud rate parity data bit stop bit Press this button to change the serial settings Communication options Number of Specifies the number of send attempts to be attempts executed before a SMS message is reported as failed Character Some mobile devices are sensitive to fast delay communication If a modem connection often report communication errors increasing this parameter might help Recommended settings for selected Nokia devices Nokia 22 0 msec Nokia 6210 80 msec Log modem If checked all modem communication is logged comm to the specified file Mail options SmartLogger User s Guide SR 2 9 9 Notification Module Add on SMS Mail SMTP server Address smtp comain com Part 25 Ka Mail options Reply address
4. Dongle protection If the dongle option has been ordered then a dongle is delivered together with the SmartLogger product To install the dongle please follow these instructions Install the appropriate driver as described in section 2 2 1 Power down the PC Attach the dongle to the parallel port Power on the PC Start the SmartLogger and the SmartClient gp c ms The registration will then be performed automatically 2 4 SR 2 SmartLogger User s Guide Quick Start This section describes step by step the basic operations required when configuring the SmartLogger for the first time If you intend to configure the SmartLogger for demo purposes in connection with the SmartSim event simulator you can skip step 1 and go directly to step 2 Step 1 Building a template The template is essential for the event logging and is therefore the first thing you must define If you can not use any of the templates included in the SmartLogger package you must build your own according to your requirements and your data source Please refer to the SmartBuilder User s Guide for more information Step 2 Configuring a port When the template is ready you must set up a port for your data source How to do this is described in section 4 2 Port Setup In this quick start example you should configure port 1 for event logging Step 3 Activating the port The activation of the port is done from the Port Status dialog which can be open
5. Maintenance 5 Maintenance 5 1 System Log The System log keeps track of all configuration changes and incidents which may be of interest to an operator or system responsible The messages are classified in the following severity levels Information Standard messages indicating that the application has been started port configuration has been changed etc Warning Appears when the SmartLogger has detected an error in a module in data validation or other incidents that later on may lead to serious data loss Alert A serious warning like disk is running full that requires action Error Serious error has occurred The particular module or port has been stopped The system log can be viewed from the menu item View System Log s System Log olx Severity filter Jon sl Task filter fal lai Ile EE Description 03 02 03 21 36 12 Information Utility Server Disconnect TepListener deactivated 03 02 03 21 36 12 Information Mam Destroy Application terminated 03 02 03 21 40 20 Information Main CheckEnv Application activated 03 02 03 21 40 20 Information Utility Server Listener TcpListener is listening on port 18000 03 02 03 21 40 20 Information Main LPD Listener TepListener activated on port 515 03 02 03 21 40 20 Information Notification Mod 127 0 0 10 Trying to connectto server on IP address 127 0 0 1 03 02 0321 40 20 Information Notification Mod 127 0 0 10 Connection established 03 02 03 21 40 20
6. mymail domain com X Cancel Figure 9 5 SMTP server Address The internet address for the SMTP server to be used for mail notifications Port Port to be used for connection Should normally be set to 25 Mail options Reply address Specifies the reply address that will be used if recipients of mail notifications uses the reply function in their mail program Not to be confused with the From parameter in the notification configuration which is the name that is displayed in the mail header 9 10 SR 2 SmartLogger User s Guide Notification Module Add on 9 5 Address Book The Notification Module uses the standard Windows Address Book WAB API which is included as standard on most Windows installations today The SmartLogger Address Book can be accessed from the Notification Module menu item Tools Address Book Address Book n x File Edi View Notification Smartlogger dk 4540404040 mw citizen com 4512121212 Ez Peter Johnson pj factory com 4520202020 4items WAR version 6 00 2600 0000 F ASMARTLOG LOGGER SmarLogger wab Figure 9 6 In order for the Notification Module to work properly the following must be specified for each entry in the address book Name First Middle Last name can be specified under the Name tab E Mail Can be specified under the Name tab sheet Required for Mail notifications Mobile Can be specified under the Home tab shee
7. 6 7 MS SQL Server SQL Server name Table list cache time min Default user name Database name SMARTLOG D Iv AutoCommit enabled MS SQL Server 7 settings SQL Server name Default user name Database name Table open list cache time AutoCommit enabled The registered name of the SQL Server where the database is running Using the MS SQL Server Enterprise Manager this registration can be performed The default user name that is used if automatic database login is disabled The name of the database containing the SmartLogger tables Defines how long the table list is cached in memory A new table list is not fetched from the database server before the cache time expires If enabled the BDE automatically commit records to the table after each post If disabled the application decides when to commit the records Please note that this setting is only relevant for applications that actually writes to the database like SmartLogger or SmartTranslator SmartLogger User s Guide SR 2 6 7 Utilities 1 This setting can have one of three values 1 The table list is cached as long as the program is running This should only be used for static databases where no tables are added after the program is started 0 The table list is never cached This will increase network traffic as the table list is fetched directly from the database server every time it is requested
8. Information Utility Server 127 0 0 10 New connection accepted 03 02 03 21 40 20 Information LOCAL Thread PortHandler for LPD interface activated 03 02 0321 40 20 Information PORT2_ Thread PortHandler for LPD interface activated 03 02 03 21 40 20 Information PORT4 Thread PortHandler for LPD interface activated 03 02 03 21 41 20 Alert LOCAL Data Supervision No data received within supervision period 03 02 03 21 41 23 Waring Notification Mod SMSThread Failed to connect to modem AT command failed C 03 02 03 21 42 20 Alert LOCAL Data Supervision No data received within supervision period 03 02 03 21 43 20 Alen LOCAL Data Supervision No data received within supervision period Warning Notification Mod SMSThread Failed to connect to modem AT command failed C LOCAL Entries 1974 Figure 5 1 SmartLogger User s Guide SR 2 5 1 Maintenance The two filter controls can be used to quickly locate the requested information Severity filter options All Information Warning Alert and Error Task filter options Different SmartLogger modules Popup menu When right clicking on the System Log grid the following pop menu items are shown Copy to Clipboard Copies the selected records to the clipboard Export all to Exports all records to Text Excel HTML or XML format Export selected to Exports selected records to Text Excel HTML or XML format 5 2 Options The Options dialog can be activat
9. Pseudo code This text box shows the filter criteria s in translated pseudo code Each text line is OR d together when the filter criteria s are applied To edit the criteria definitions press the Edit button The Criteria Editor is described in section 8 6 After creating a new filter it will automatically be attached to the selected port and activated 8 3 Add existing filter The same filter can be added to several ports To add a previously created filter to a port select the port and choose the menu item File Add Existing Filter Add Filter X Available filter definitions Advent Alemer My test filter Simulator33 Alarmer New Filter wv OK X Cancel 8 4 SR 2 SmartLogger User s Guide Utility Server Figure 8 3 The field names used in the selected filter definition must be available for the chosen port Otherwise a warning is raised when the OK button is pressed 8 4 Modify filter It is possible to modify a filter already attached to a port by choosing the menu item File Modify Filter or the corresponding pop up menu item The dialog shown is the same as when creating a New filter except that the filter name cannot be modified Please note that only the user defined filters can be modified 8 5 Filter maintenance The Filter Maintenance tool combines the filter functions described in the previous sections in a single tool From here it is possible to create modify and
10. by the SmartLogger SmartTranslator The procedure for creating a remote alias is the same as for creating a local one Just use the browse button to specify a network path instead of a local path When using remote aliases with Paradox databases the following must also be ensured e The client computer must have full access to the network destination l e the directory specified in the destination path must not be write protected e All BDE programs SmartLogger SmartClient must use the same NET DIR path This setting can be changed verified from Control Panel BDE Administrator Configuration tab sheet Drivers Native Paradox SmartLogger User s Guide SR 2 6 9 Utilities 6 10 SR 2 SmartLogger User s Guide Supervision It is possible to let the SmartLogger supervise vital parts of the program This section lists the different supervision options that are available 7 1 Watchdog The Watchdog is used to report vital errors to an external supervising system It requires a digital I O board which has to be purchased separately The watchdog supports the National Instruments NI DAQ driver interface which supports most of the available I O boards from National Instrument Although the NI DAQ driver supports many different I O boards it is recommended to use the I O board PCI 6503 Configuration To install and configure the I O board please refer to the documentation from the board vendor To configur
11. cance Figure 6 1 SmartLogger User s Guide SR 2 6 1 Utilities Text File Import Source Specifies the source directory for the text files directory Filter Source file filter When changed the Available files and Files to import list boxes are reset Available Files Files available for import Only files matching the filter are shown in the Available Files list box Files to import Files selected for import Import settings Template Specifies the template to be used for conversion Destination settings Database Specifies the destination database alias Append to Specifies whether to append records or to Overwrite overwrite existing tables If appending then the table structure of the destination table must be identical to the structure defined in the selected template One file gt If selected each text file is converted to one One table table with the same name as the text file without the file extension Many files gt If selected all text files are converted and One table merged to the same table Table name Specifies the destination table name Is only available when Many files gt One table is selected When a text file import is initiated the following status window is shown 6 2 SR 2 SmartLogger User s Guide Utilities Text file import Status view File list bebes iesen Enties Bed DemoEvensst DemcEvents 14 0 Com
12. delete filters with the difference that it is the physical filter definition file that is affected only In other words If a new filter is created with the Filter Maintenance tool then it must be attached manually to a port afterwards The Filter Maintenance tool can be opened by choosing the menu item Tools Filter Maintenance SmartLogger User s Guide SR 2 8 5 Utility Server Filter Maintenance x Available filter definitions Advant Alarms KI Delete My test filter a New Filter Simulator33 Alarms kd Save m Save As Filter definition name Use field names from template jimulator33 Alarms Simulator33 sl Description New subscription based on Simulator33 template r Filter criteria list OR Pseudo code EventType A Delete Delete all Figure 8 4 Filter maintenance Available filter Shows a list of available filters To choose a filter definitions for maintenance simply click on the filter in the listbox Filter parameters Filter definition Name of the filter definition name Use field The template reference is used to get a list of names from field names in order to be able to build the filter criteria s Description A descriptive text e6 sre SmartLogger User s Guide Utility Server Filter criteria list Pseudo code This text box shows the filter criteria s in translated pseudo code Each line equal
13. historical view of all generated output The following information is listed in the output log data grid Field name Description Id A unique number identifying the output This number is used as reference for all messages related to this output Timestamp Date and time showing when the output was stored in the output log Type Output type Mail SMS or SMS via mail To Name of the recipient Status Current status for the output Pending Sending Sent Error or Cancelled Message The composed message sent to the recipient Data source Name of the data source originally supplying the information for the output 1 An output can be set to Cancelled if the user has chosen Cancel all pending outputs from the menu or if the SmartLogger was shut down while there were pending outputs SmartLogger User s Guide SR 2 9 3 Notification Module Add on 9 2 Notification menu Item Add Notification Modify Notification Rename Notification Delete Notification Close Disable Notification Enable Notification Clear Events received grid Cancel all pending outputs Get modem information Communication Trace Address book Options 9 4 SR 2 Description Adds a new notification Refer to section 9 3 Add Notification for more information Shows the same dialog as for adding a new notification with the exception that the notification name cannot be ch
14. possible to dump the entire content of the Online View to a file This can be done from the menu item File Dump File Print It is possible to print the entire content of the Online View This can be done from either the print button on the toolbar or from the menu item File Print Edit Copy If you intend to use some or all of the events from the Online View in another program like Word or Excel you can do so by using the Windows clipboard Select the desired lines and copy them using the menu item Edit Copy SmartLogger User s Guide SR 2 4 13 Basic operations Edit Start Stop trace The trace update of the window can be started stopped from the menu or from the speed buttons on the toolbar The trace has to be stopped if you want to perform any kind of action like search or copy on the content of the Online View When the trace is stopped the incoming events are still buffered to prevent event holes in the Online View When the trace is started again you may not able to operate the Online View for a short period of time while the Online View is updating Edit Use Color Mapping This menu item toggles the use of color mapping For more information about the different color mapping modes see section 5 4 Color Mapping Edit Apply Mask If the events shown in the Online View contains a lot of irrelevant characters like spaces the Apply Mask switch can be used to filter out these characters If the
15. the system tray system tray instead of the application bar Timers Status refresh Time in seconds between each refresh of the interval statistics counters on the Port Status information view Log change Refer to description below period Password Enable Refer to description below password Change button Opens a dialog for changing the password Log change period The Log change period determines the period after a log change where events from the previous day are still accepted This feature ensures that events from a data source without time synchronisation are not lost during day shift period The change over period is only relevant if the used template decodes the date time from the event Please refer to Appendix 12 2 Log change philosophy for a detailed description of the log change philosophy Password protection When the password protection is enabled then all configuration dialogs and program exit are password protected Although the program exit is protected the SmartLogger will not prompt for a password in the case of a computer shutdown 5 2 4 Source The character stripping feature can be used to ignore special characters like occasional form feeds from a data source SmartLogger User s Guide SR 2 5 5 Maintenance Supervision TCP IP System Source Character stripping SS Predefined characters v Add Userdefined string Ese Add Strings to ignore 12 FF
16. 00007 3 Shutdown Fuel Gas Turbine Blowdown Prod Drain Valve West Water Pump Drain Tank Shutdown Fuel Gas Shutdown Fuel Gas Turbine Blowdown Drain Tank Surge Level Production Slop Tank Centrifuge Pump Mezz Oil Pump Bl Validated event Mi Validated alarm E Excludedtext W Validation error Open Closing Closed Failure Alarm Closing Closed Closed Normal Alarm Hz Alarm Li Stop Stop Samples 125 Figure 4 11 Trace stopped Apply mask Off Color mapping Std In order to perform an action like search or copy on the content of the Online View the trace must be stopped Stopping the trace does not affect the event logging for the port it only stops updating of the Online View SmartLogger User s Guide 4 12 SR 2 Basic operations Kee The Online View tool bar Online View LOCAL Sr eH m da Figure 4 12 Icon Description Click action Sr Show Hide menu Toggles the menu on off Dump Dumps the entire content of the Online View to disk amp Print Prints the entire content of the Online View Copy Copies the selected text to the clipboard Start Trace Starts the online trace of events EI Stop Trace Stops the online trace of events Search Opens the search dialog Color mapping Toggles the color mapping feature on off The Online View menu offers the following functionality File Dump It is
17. 053 OPS PUMP 236 F PLI LSL 34567 KRT ESDV 85943 C KRT ESDV 85943 KRT BDV 1124 PLI LSL 34567 KRT BDV 1124 C KWS XCV 53053 OPS PUMP 236 F PLI LSL 34567 KRT ESDV 85943 C KRT ESDV 85943 KRT BDV 1124 PLI LSL 34567 Turbine Blowd Prod Drain Va West Water Pur Drain Tank Shutdown Fuel Shutdown Fuel Turbine Blowd Drain Tank Turbine Blowd Prod Drain Va West Water Pur Drain Tank Shutdown Fuel Shutdown Fuel Turbine Blowd Drain Tank b Trace active Figure 10 3 Apply mask Off Color mapping Advanced 4 All toolbar and menu functions like print copy to clipboard etc works on the currently selected text area To select a text area simply click somewhere on the text area SmartLogger User s Guide SR 2 10 3 Redundancy Module Add on 10 2 3 Redundant information in tables Tables used for redundant event collection are created with an extra field RedundantInfo that shows the origin of the event LOGDATA PORT 420030200 NNNM NENNEN NN NN TUN 15 02 2003 22 22 21 040 mu XCV 53053 Drain Valve Open 15 02 2003 22 22 23 040 WUL P B002 Centrifuge Pump Running 15 02 2003 22 22 25 040 KRT BDV 1124 Turbine Blowdown Opening 15 02 2003 22 22 25 380 KRT ESDVv 85943 O Shutdown Fuel Gas Opening 15 02 2003 22 22 26 38 OAM PUMP 24576 R Mezz Oil Pump Run 0 53 Prod Drain Valve Open 5 02 2003 22 22 34 380 WUL P 6002 Centrifuge Pump Running 5 02 2003 22 22 37 380 KRT B
18. 22 W Data source DEMO Simuletor33 Alarmer is not available 27 01 02 12 52 22 Notification definitions loaded from file Ce Pending outputs 0 Figure 9 1 The main view is divided into three panes Notification definitions The Notification definitions tree view contains a list of all configured notifications The current status for each notification is shown by the colour of the icon White The notification is active Yellow The notification is disabled Red The notification has an error and is inactive Events received This pane shows all events received from the Utility Server Each event is identified by the data source name and will generate one or more notification outputs depending on how many notifications that are subscribing the data source The following information is listed in the data grid 9 2 SR 2 SmartLogger User s Guide Notification Module Add on Field name Description Timestamp Date and time showing when the event was received by Notification Module Not to be confused with the timestamp in the event Data Source Name of the data source supplying the event in the format lt Port label gt lt Filter name gt Event The actual event received in comma separated text format Output log and messages The pane in the lower right section contains two tabs one for showing all messages related to the Notification Module and one for a
19. DV 1124 Turbine Blowdown Opening 123 Records LZ Figure 10 4 Possible combinations A The event was only received from data source A or not yet received from data source B B The event was only received from data source B or not yet received from data source A AB The event was received first from data source A and then from data source B BA The event was received first from data source B and then from data source A The redundant information is only stored in the table if the feature is enabled when configuring the port For heavily loaded systems it is recommended notto store W redundant information in tables as it require extra resources to lookup previously stored events 10 4 SR 2 SmartLogger User s Guide Remote Transfer Add on 11 Remote Transfer Add on Add ons are not included in the SmartLogger product as standard The Add ons must be purchased and registered separately The following descriptions therefore only apply if you have installed the add ons on your system 11 1 Remote Transfer The Remote Transfer add on is used to transfer raw events to a remote host via a TCP IP network The function works independently of other port related configurations like log change template and database settings A port configured for remote transfer transfers all events to the host in the same sequence as the port receives them from the data source Please refer to the Release Description f
20. Program for translating plain text files into SmartLogger database tables SmartStatus Program for remote supervision and control of the SmartLogger SmartTranslator programs 1 2 SR 2 SmartLogger User s Guide Introduction SmartGuard NT Service program for supervising and automatically starting re starting SmartLogger SmartTranslator in Windows NT environments The listed programs are bundled in the following packages e SmartClient package Contains a stand alone SmartClient e SmartLogger package Contains SmartLogger SmartClient SmartBuilder and SmartSim e SmartTranslator package Contains SmartTranslator and SmartBuilder e SmartStatus package Contains a stand alone SmartStatus e SmartGuard package Contains a SmartGuard Service program and the SmartGuard Setup program for off line configuration 1 3 Templates A template in the SmartLogger philosophy defines e How incoming events are to be decoded and split up e The table structure of the destination table The SmartLogger is shipped with a number of standard templates One of the templates is designed for demo configurations where SmartSim is used as data source Please refer to the SmartLogger Release Description for a complete list of all standard templates included in this program release You may have to build your own templates in order to adapt the SmartLogger to your demands and requirements This topic is described in the SmartBuilder User s Gu
21. SmartLogger 3 3 User s Guide February 2003 ABB The information in this document is subject to change without notice and does not represent a commitment on the part of ABB A S ABB A S does not accept any responsibility for any errors that may appear in this document The software described in this document is furnished under a license and may be used only in accordance with the terms of such license Product rights 2003 ABB A S All rights reserved The copyright of this work is vested in ABB A S and the documentation is issued in confidence for the purposes only for which it is supplied It must not be reproduced in whole or in part or used for tendering or manufacturing purposes except under an agreement or with the consent in writing of ABB A S and then only on the condition that this notice is included in any such reproduction No information as to the contents or subject matter of this document or any part thereof arising directly or indirectly therefrom shall be given orally or in writing or communicated in any manner whatsoever to any third party being an individual firm or company or any employee thereof without the prior consent in writing of ABB A S SmartLogger SmartClient SmartBuilder SmartSim SmartTranslator SmartStatus and SmartGuard are trademarks ABB A S Use of this product is subject to acceptance of the SmartLogger license agreement included in this package ABB A S reserves the right without notic
22. The input buffer gets below 20 full after an XOFF has been transmitted due to a buffer full situation 12 4 Remote Transfer details The following sections describe the behaviour of the Remote Transfer add on in details 12 4 4 Remote Transfer queue The RT Queue is a directory where the SmartLogger stores all queue files and queue counters related to the Remote Transfer add on The queue ensures that no events are lost due to transmission errors or temporary network errors All events received by the SmartLogger are stored in the queue immediately and no events are removed from the queue unless the remote server has confirmed the transfer The RT queue has a capacity of 999 queue files which give a maximum storage capacity of approximately 400 000 events or 66 hours depending on the RT settings Max entries per queue file and Max time between queue files SmartLogger User s Guide SR 2 12 5 Appendix Each SmartLogger port has its own set of queue files RT1 ini Contains information about queue counters RT1 log Queue file under construction RT1NO001 log Queue file ready to be transmitted RT1NO002 log Queue file ready to be transmitted RT1Nxxx log Queue file ready to be transmitted The listed files apply to port 1 For files associated with other ports replace RT1 with the corresponding port number 12 4 2 Remote Transfer messages The Remote Transfer communication is based on the following message types Infor
23. _path gt Logdata RT queue files log lt Install_path gt RTQueue Notification ini Instal path SMSProviders db Instal path NM Data files bin Install path TraceLogs Trace logs log Install path2 ATraceLogs 1 Shared directory Location is stored in Windows registry and is shared by all Smart applications 2 The location of log tables is determined by the database alias As standard a database alias named LOGDATA pointing at the specified location is created 3 Only valid if the Remote Transfer option is enabled 4 Only valid if the Notification Module option is enabled SmartLogger User s Guide SR 2 12 7
24. ame Figure 4 1 General settings Enable port Enables disables the port for configuration and event logging 4 2 SR 2 SmartLogger User s Guide Stop button Basic operations If the port is activated it can be stopped by pressing this button General settings Port label Description Log change Log template Composed Log name 2 Label to identify the port Is also used to generate unique log names Descriptive text for the port Specifies how often a new log table is created The log change setting also affects the log name Specifies the template used for the port Must be configured in advance with SmartBuilder Shows the composed name based upon the port label and the log change settings The log name is composed by SmartLogger and can not be modified by the user Advanced settings Refer to separate descriptions below 1 The label is limited to 10 characters Valid characters are 0 9 A Z and _ It is not allowed to have two configured ports with the same label 2 For more information about log change and the composition of log names please refer to appendix 12 2 Log change philosophy 4 2 1 Advanced settings Communication Serial port type settings Communication Database Supervision Redundancy Serial Device Flow control C TCP IP Rew COMI NONE C Telnet Connection pref C LPR LPD 9500 N 8 1 Change sett
25. anged Makes it possible to rename the currently selected notification in the tree view Deletes the currently selected notification in the tree view Closes the Notification Module main view Disables an active notification Tries to activate a disabled or error marked notification Clears the Events received grid Cancels all pending outputs Outputs already in sending mode will ignore this cancellation When selected the configured modem will be queried for relevant information The response is shown in the Messages view If checked then SMTP and serial trace messages are shown in the Messages view Opens the Windows Address Book tool Opens the Notification Module options dialog SmartLogger User s Guide Notification Module Add on 9 3 Add Notification To add a new notification select the desired notification type in the tree view and choose the menu item File Add Notification Add Notification X Name SL Aen Data Source Locelhosb SmartLogger System alerts Select SMS To Roger Smith lt 40404040 gt Select From SmartLogger Subject Serious Error Message Check this error MODULE DESCRIPTION From TIMESTAMP Timestamp insert Field J OK X Cancel Figure 9 2 Add Notification Name Name of the notification Data Source Identifies the data source selected for this Notification Each event received from this data source will gene
26. ansmission status Socket state Last transmission Next file scan Shows the current state for the communication socket Possible states are Connecting Connected Closed or Error Timestamp for the last transmitted queue file Shows the time when the RT module will look for completed queue files to transfer Queue status Enabled File counter Transmit counter On Port is configured and enabled for RT Off Port is configured but not enabled for RT N A Port is not configured Shows the id 1 999 for the last completed queue file Shows the id 1 999 for the last transmitted queue file The message window shows the latest 200 messages Messages related to the communication flow starts with a direction marker gt Messages send to the remote server lt Messages received from the remote server For a detailed description of the communication flow please refer to section 12 4 2 Remote Transfer messages 11 4 SR 1 SmartLogger User s Guide Appendix 12 Appendix 12 1 Data handling One of the key issues for the SmartLogger is that data are validated and stored in a database table When performing any kind of data validation there is a chance that some of the data may fail in the validation procedure How the SmartLogger handles this topic is described in the following sections 12 1 1 Data validation Before an event is validated and stored in the database it has bee
27. as described in section 5 2 SmartLogger User s Guide SR 2 7 5 Supervision 7 6 SR 2 SmartLogger User s Guide Utility Server 8 Utility Server The Utility Server handles all data access both local and remote towards the SmartLogger data sources and will only be available if either the Notification Module add on or the Status Module add on is enabled 8 1 Main view The Utility Server main view can be shown by clicking on the U icon on the toolbar or by selecting the menu item Tools Utility Server EIE lolx File View Tools Configured data sources Eg SmartLogger ystem messages System alerts Jy Part1 LOCAL AJ Port2 PORT2_ Status information aw events Formatted events Y Port3 Y Port4 PORT4 Status information Raw events ormatted events ta Hopla Messages Listener Information TcpListeneris listening on port 18000 127 0 0 10 Information New connection accepted Clients connected IEEE E Notification Module 127 0 0 10 burns2 marLogger System alerts CH m m Listening Port 18000 Clients connected 1 10 Figure 8 1 The main view is divided into three panes Configured data sources SmartLogger User s Guide SR 2 8 1 Utility Server The Configured data sources tree view contains all available data sources related to the SmartLogger itself and all configured ports The SmartLogger will as default have the following f
28. ast message that has been reported by the port supervision All messages can be found in the System Log as described in section 5 1 SmartLogger User s Guide SR 2 4 9 Basic operations System Log Stop Start Used to manually start and stop the event button logging for a port Logs DB driver Shows the database driver used for data logging Current Name of the log table that is currently being used Change over Name of the change over log table if the change over period is active Please refer to section 12 2 Log change philosophy for a description of the change over feature Statistics Statistics Date and time for last reset of the statistic activated counters The statistics are automatically reset when the SmartLogger is restarted Events Number of events received since last reset received Events Number of events discarded since last reset discarded Reset button Resets the statistic counters View button Opens the log file containing the discarded events if any If you intend to disable a port completely it is not enough to stop the logging from the Port Status The port must also be disabled in the Config Ports dialog otherwise it will be activated next time the SmartLogger is restarted 4 4 1 Status icons on toolbar At the main form s toolbar a number of status icons buttons are shown The colour of the status icons indicates the overall status for the correspondin
29. configuration dialog Opens the Color Mapping dialog Opens the configuration dialog with the RT page selected Opens the configuration dialog with the WD page selected Opens the Alias Manager tool Opens the Backup utility dialog Opens the Notification module Opens the Utility Server Opens the Options dialog Shows this User s Guide in PDF format Opens the registration dialog Shows credits and release version Only visible if the Remote Transfer add on is registered 2 Only visible if the Notification Module add on is registered SmartLogger User s Guide SR 2 4 1 Basic operations 3 Only available if the Status Module or the Notification module add on is registered 4 Only visible if the SmartLogger is unregistered If the SmartLogger is registered this dialog can be viewed by pressing lt Ctrl gt R 4 2 Port Setup In order to log events a port must be configured for this purpose The port configuration dialog is opened from the menu item Config Ports Por Port 2 Ports Port 4 i mj General settings Port label Description LOCAL Log change Log template Composed logname Never D Simuletor33Color LOCAL Advanced settings Communication Database Supervision Redundancy Serial Printer queue name C TCP IP Raw SLPort C Telnet LPR LPD wv OK Defaults X Cancel Port label max 10 characters Used as the first part ofthe logn
30. d SmartLogger User s Guide SR 2 4 11 Basic operations 3 4 5 Online View has happened to the port or module Details can be found in the Port Status or in the System Log The Online View is the only place where it is possible to view the incoming events as plain text The Online View has a capacity of 2000 events and will always show the last 2000 events received To view more than the latest 2000 events the SmartClient has to be used Please refer to the SmartClient User s Guide for more information The Online View can be opened from the menu View Online port label Online View DEMO2 File Edit View Search EI amp b m a 12 EVT 2 12 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 2002 05 25 x EE mmu m Hp 9 M MD SO D M OM 23 23 23 23 3238 23 123 223 323 223 223 223 2235 223 140 190 230 THIS 370 420 460 500 1 550 530 580 620 670 710 750 800 780 OAM PUMP 24576 KRT BDV 1124 0 OPS PUMP 236 R IS REPORT HEADER KRT ESDV 85943 KRT BDV 1124 C KWS XCV 53053 OPS PUMP 236 F PLI LSL 34567 KRT ESDV 85943 C KRT ESDV 85943 KRT BDV 1124 PLI LSL 34567 HJO TAHH 1122 WSA TAL 32177 L1 WUL P 6002 5 OAM PUMP 24576 S Mezz Oil Pump Turbine Blowdown West Water Pump PAGE
31. e to make changes to its products as circumstances may warrant Other registered trademarks and trademarks used throughout this publication are the property of their respective owners Product rights 2003 ABB A S All rights reserved Printed and manufactured in Denmark m SR 2 SmartLogger User s Guide Contents 1 Introduction acce E 1 1 1 1 Conventions A detnttons eenen ereere ereere 1 1 1 2 Product overview eeeesiseeseseeeneee nennen 1 2 VC Wl ul el 1 3 2 Installation and Set up eese 2 1 2 1 System requirements seeeeseeeseeeeerieerieerenesiserissriesrnesrne 2 1 LEET e TEE 2 1 2 2 1 Dongle option 2 1 2 2 2 Online User s Guide sse 2 1 2 8 Windows setup iieiaeie iiaii 2 2 2 4 JRegistration uec cenae dv du rece due 2 2 3 Quick Start Aere Eelere 3 1 4 Basic operations eese 4 1 4 1 Menu OVErVIOW eeeesseeeeseseeenennnnn ennemis 4 1 4 2 Port Setup cans eat Sume etn 4 2 4 2 1 Advanced settings Communication 4 3 4 2 2 Advanced settings Database A 4 6 4 2 3 Advanced settings Supervision sssesseesseeeseresrsssr eese 4 6 4 2 4 Advanced settings Redundancy A 4 7 4 9 PortactiVatigh ze ne ee ie ee diu lade 4 8 4 47 POR Status nu cioe uenisset dient 4 8 4 4 1 Status icons on toolbar ssseeeseeseesresresresrssrrssrresens 4 10 4 5 Online View 4 12 5 Ma
32. e of numerical values When it is pushed it toggles between z lt gt and lt gt Case sensitive If checked only text that exactly matches the query criteria is accepted i e Pump Control does not match PUMP CONTROL 8 6 1 Criteria examples Exact match If you want to filter all records where the Tagname field contains the exact string HAS OV 12222 you simply enter Criteria Editor EN Criteria AND Tagname sl HAS OV 1 2222 Add to list Figure 8 6 Combined AND criteria If you in addition to the Tagname criteria only want to filter records from Section 12 then you additionally enter Criteria Editor x Criteria AND Tagname sl HAS OV 12222 Add to list Section fra Update Figure 8 7 Using multiple character wildcards If you in addition to the criteria s above only want to filter records where Description contains Flare then you must enter SmartLogger User s Guide SR 2 3 9 Utility Server Criteria Editor x Criteria AND Tagname v HAS OV 1 2222 Add to list Section z fi 2 Update Description Y Flare Reset All Figure 8 8 It is also possible to use multiple wildcards in a single criterion If you for example want to extract all records where Tagname starts with KKS and contains the characters ZSC the criteria should be KKS ZSC W Wildcards are valid for character fields only Adding multiple c
33. e the Watchdog module select the menu item Config Watchdog SmartLogger User s Guide SR 2 7 1 Supervision Add on Configuration EN Watchdog Remote Transfer M Enable 1 0 module 1 0 card Device id H A Port no fi sl Pulse channel Enable pulse on channel 7 Pulse interval sec Ei A Alarm options Treat supervision warnings as errors Treat all warnings as errors Treat 30 A warnings as one error X Cancel Figure 7 1 Watchdog Enable Enables or disables the Watchdog module UO card Device id Defines which UO board to use Please refer to board vendor documentation for more information Port no Some UO boards support multiple ports or bytes These are typical referred to as Port 0 Port 1 etc or PA PB etc Setting the Port number to 1 is equal to PB Pulse channel Enable pulse Enables or disables pulse on channel 7 Pulse interval Defines the pulse interval in seconds SmartLogger User s Guide Supervision Alarm options Treat sup If checked all warnings related to disk and data warnings source supervision are treated as errors Treat all If checked all warnings are treated as errors warnings Treat XX If checked then an error is generated after the warnings as specified number of warnings Note that the warning count is individual for each por
34. each event unique within the specified fields Otherwise events may be lost due to index violation Configuration of redundant event collection is done from the Redundancy tab sheet on the Port Configuration dialog For more information see section 4 2 4 Advanced settings Redundancy 10 2 Additional information Some of the SmartLogger modules contain additional information for ports configured for redundant event collection 10 2 1 Port status On the port status dialog it is possible to see the names of the configured print queues and event statistics per data source r General Status ACTIVE Stop Description Datasource LPD SLPORT4A SLPORT4B Last Msg PortHandler succesfully activated Figure 10 1 10 2 SR 2 SmartLogger User s Guide Redundancy Module Add on Statistics Statistics activated 15 02 03 21 27 03 Events received ahh Reset statistics Events discarded 0 0 View discarded Figure 10 2 10 2 2 Online View For redundant ports the Online View is divided into two text areas containing events from data source A and data source B Online View PORT4 amp tg Ae 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 A NNN A DO PA PA 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2003 02 15 2 2 2 a 2 2 2 7 KRT BDV 1124 C KWS XCV 53
35. ed by clicking on the status icon on the toolbar In this case it will be the icon with a 1 in a red box The Port Status dialog is described in section 4 4 Port Status Step 4 Verifying event logging You can verify that the event logging is active either by looking at the statistic counters in the Port Status or by opening an Online View The Online View function is described the section 4 5 Online View Step 5 Viewing stored events The validated events are stored in a database table which can be viewed with SmartClient as described in the SmartClient User s Guide SmartLogger User s Guide SR 2 3 1 Quick Start 3 2 SR 2 SmartLogger User s Guide Basic operations 4 Basic operations 4 1 Menu overview Item File Text File Import Exit Online gt Arrange Online views Port Status Remote Transfer Watchdog Outputs System Log Config Ports Color Mapping Remote Transfer 1 Watchdog Alias Manager Backup Notification Module Utility Server Options User s Guide Tools Registration About 1 Description Opens the Text File import dialog Program exit Used to access online views A pop up menu containing all active ports is shown If checked then Online views are arranged automatically Opens the Port Status Opens the Remote Transfer status view Opens the Watchdog status view Opens the System Log Opens the port
36. ed from the menu item Tools Options and contains four categories of optional settings Supervision TCP IP Listeners System and Source 5 2 4 Supervision TCP IP System Source Disk capacity Iv Enable supervision Disk check interval hours 24 VA Disk warning limit Mb fi 0 ZA r System log Maximum number of entries 2000 Z Figure 5 2 5 2 SR 2 SmartLogger User s Guide Maintenance Disk capacity Enable If checked disk space supervision is active The supervision disk capacity check raises an alert if the free space on the destination disk s is running low Check interval Time in hours between each disk space supervision check Warning limit Minimum MB free disk space that is accepted System log Maximum The system log database is limited to the number number of entries specified 1 The disk capacity supervision does not support database servers or disks located on remote computers 5 2 2 TCP IP Listeners TCP IP listeners are used for handling TCP IP connection requests from the data sources and to direct the connection to the correct SmartLogger port Normally only one listener is needed as it can handle connections from multiple data sources as long as they come from different IP addresses In the case that several data sources come from the same IP address additional listeners one for each data source must be enabled TCP l
37. for the remote server address Socket port Socket to be used for transmission Please note that the SmartLogger has to be restarted before any RT change takes effect For a detailed description of the RT queue behaviour please refer to appendix 12 4 1 Remote Transfer queue Status information To see the status for the remote transfer e Press the corresponding status button on the toolbar OR e Select the menu item View Remote Transfer Remote Transfer x Transmission status Queue status 1 2 3 4 Socket state Closed Enabled On Off Off Off Next file scan 13 09 00 19 56 11 File counter 184 Lasttransmission Transmit counter Messages 13 09 00 19 51 11 Trying to connectto server on IP address 123 123 123 4 socket 100 13 09 00 19 51 12 Ww Socket returned Connection refused 13 09 00 19 51 12 Will try to reconnectin 1 minute s 13 09 00 19 52 12 Trying to connect to server on IP address 123 123 123 4 socket 100 13 09 00 19 52 14 WW Socket returned Connection refused 13 09 00 19 52 14 Will try to reconnectin 1 minute s 13 09 00 19 53 14 Trying to connectto server on IP address 123 123 123 4 socket 100 13 09 00 19 53 15 WW Socket returned Connection refused 13 09 00 19 53 15 Will try to reconnect in 1 minute s Figure 11 2 SmartLogger User s Guide SR 2 11 3 Remote Transfer Add on Tr
38. g port or module 4 10 SR 2 SmartLogger User s Guide Basic operations s SmartLogger File View Config Tools Help HOOGS po onus SNO Figure 4 10 Icon Description Click action 1 4 Online View 1 to 4 Opens the Online View SS Arrange Arranges all visible Online Views ig Configure ports Opens the Configure ports dialog 1 4 Port 1 to 4 Opens the Port Status dialog W Watchdog Opens the Watchdog output view R Remote Transfer Opens the RT status view U Utility Server Opens the US window N Notification Module Opens the NM window T TCP listener Opens the System log view vw Acknowledge Acknowledges all warnings System log Opens the System log view E Color Setup Opens the Color setup dialog ZG Options Opens the Options dialog T User s Guide Launches the User s Guide 1 Add on module Status indications Green Port or module is configured and started Yellow Port or module is configured and started but a warning has occurred Red Port or module is configured but stopped Faded out Port or module is not configured If one or more ports modules have the warning flag set an acknowledge button will appear next to the status icons When pressed all warnings are reset and the button will disappear again The acknowledge button is shown as a green checkmark A yellow or red circle indicates that something unexpecte
39. ger User s Guide SR 2 SR 2 SmartLogger User s Guide Introduction 1 Introduction The SmartLogger product has been developed especially for replacement of event and alarm printers in the process industry but can be used for many other purposes as well It is designed to handle data from all kinds of text based data sources Compared to other event loggers the SmartLogger has the advantage that events are validated and stored in a database which makes it a perfect foundation for subsequent analysis In addition to this the SmartLogger delivers a comprehensive set of tools for configuration supervision and data analysis Tools that saves engineering hours in complex configurations 1 1 Conventions amp definitions 3 Important note Alias Database alias specifying database parameters like path and database driver BDE Borland Database Engine A set of DLLs and support files that allow programs to access databases Control The term control is used when describing the user interface A control is a common name for edit boxes push buttons and other items on a dialog Event A common name in the process industry for an occurrence which is reported to the operator and or a printer An event in the SmartLogger terminology means a sequence of characters normally sent to the printer followed by a carriage return Field A field corresponds to a column in a database table LPR Line Printing Remote LPD Line Printer Daemo
40. gt 0 The table list is cached the number of minutes specified 6 2 2 Standard alias operations Create an alias The following describes the procedure for creating a new standard alias Press the New button Type in the name for the new alias Set driver type to STANDARD Select the database path using the controls browse button Save the alias QE co o x Modify an alias To modify an alias select the desired alias and change the settings applicable to that driver type To store the changes press the save button If the settings are disabled it is because the alias is currently in use and can therefore not be modified This can also be verified by looking above the database alias where a red text with Active appears If the database driver has to be changed you will have to create a new alias and delete the old one Delete an alias To delete an alias select the alias and press the delete button If the delete button is disabled it is because the alias is in use and can therefore not be deleted 68 SR 2 SmartLogger User s Guide Utilities W Aliases that are currently in use can not be modified or deleted 6 2 3 Remote aliases It is possible to let aliases point to locations on other computers in a network and thereby accessing databases located on remote computers This feature is especially useful in configurations where multiple users SmartClients must access the same event tables generated
41. ide A template defines how incoming events are to be decoded and split up It also specifies the table structure of the destination table SmartLogger User s Guide SR 2 1 3 Introduction 1 4 SR 2 SmartLogger User s Guide Installation and Set up 2 Installation and Set up 2 1 System requirements Computer A 100 IBM PC compatible computer with a Pentium III 400 MHz processor and 128 MB RAM Operating system Windows 98 NT 2000 XP Although Windows 98 is supported it is highly recommended to use Windows NT 2000 XP as Windows 98 is not designed for programs that must be running continuously Disk space 20 MB free space for system files and additional space for log tables Video SVGA or higher resolution monitor 2 2 Installation 1 Place the SmartLogger CD in the CD ROM drive 2 lf autorun is activated on the PC the installation menu will automatically be shown If it does not start run Setup htm substitute with your CD drive letter 3 Select the appropriate installation kit from the menu and follow the instructions on the screen 2 2 1 Dongle option If the dongle option is used as copy protection the dongle driver for the appropriate operating system must be installed To install please select the appropriate driver from the installation menu 2 2 2 Online User s Guide The online User s Guide is available from the menu item Help User s Guide in all programs except SmartSim To vie
42. ilters available System Messages For subscription to system messages System Alerts System Alerts is a subset of System Messages covering messages with the severity Error and Alert This makes it possible for remote clients to subscribe to errors and serious warnings Each active port will as default have the following three standard filters available Status information Makes it possible for remote status clients like SmartStatus applications to subscribe to port status information system messages etc Raw events This data source will supply any remote subscriber with the raw events as those shown in the Online View Formatted events Subscribers to this data source will receive all events as a comma separated text The number of text fields in the comma separated text depends on the template used for the actual port W A port with a connected filter is called a data source In addition to this it is possible to create new data sources by attaching user defined filters to active ports filters are described in section 8 2 New filter A filter can be used to limit the number events in order to let subscribers supervise or store important or special events only like e All alarms from section 12 e All inhibited events from the ESD system e All tagnames containing the text XCV 8 2 SmartLogger User s Guide Utility Server e All operator actions that has ACK in the description Clients connected This pa
43. ings Figure 4 2 SmartLogger User s Guide SR 2 4 3 Basic operations Serial settings Device Shows the selected device Only devices actually available in the system can be specified Flow control NONE or XON XOFF Connection Shows the currently selected connection pref preferences baud rate parity data bit stop bit Change Press this button to change the serial settings settings TCP IP port type settings Communication Database Supervision Redundancy C Serial IP address TCP IP Listener 127 000 000 001 A sl C Telnet C LPR LPD Figure 4 3 TCP IP settings IP address Identifies the remote host sending the events TCP IP Specifies the listener associated with this port Listener Multiple ports can share the same listener as long as the remote data sources use different IP addresses 1 Please refer to section 5 2 2 TCP IP Listeners for a detailed description of available TCP IP listeners Telnet port type settings 4 4 SR 2 SmartLogger User s Guide Basic operations Communication Detabase Supervision Redundancy C Serial IP address Port C TCP IP Raw 27 000 000 001 23 z Telnet Figure 4 4 Telnet settings IP address Identifies the remote server hosting the telnet server Port Specifies the socket port to be used for communication Telnet servers usually use port 23 LPR LPD port type settings Communicati
44. intenance eeeeeeeeeeeeeee eene nnne nnne nennen 5 1 bi System Log i eie c i aee dtu e dudas 5 1 5 2 OPIN S Lt Avie fade en avian eel eas en ae aae da aes 5 2 5 2 1 SUD6IVISIOD iiic Eeer aly e ENEE ee 5 2 5 2 2 TCP IP Listeners essere 5 3 SUICIDE 5 4 52 4 SOGE ci eui sep e e e hae a el 5 5 5 3 Table Backup 52 entree i i 5 6 5 4 Color Mapping eret rg aeta donat dee 5 8 5 4 1 Standard Color Mapping sse 5 10 5 4 2 Advanced Color Mapping sse 5 10 SmartLogger User s Guide SR 2 d 6 udi c 6 1 6 1 Text File Import indien c tete reis 6 1 6 2 Database Alias Manager 6 3 6 2 1 Database driver settings ssssssssssss 6 5 6 2 2 Standard alias operaiions ereere 6 8 6 2 3 Remote aliases sesssssssssseeeeeeeeees 6 9 T GT E e EE 7 1 FA Watchdog eet tenter eee odessa 7 1 7 2 Data source supervision ssseeeen nn 7 5 7 3 Disk space supervision n 7 5 8 de EE 8 1 5 MEM Malin VIEW RET EE 8 1 D2 NEW IMEN E 8 3 8 3 Add existing Tier 8 4 9 4 Modify fiter 22 sates caret ot rte tne RF cer pterea 8 5 8 5 Filter maintenance enne 8 5 8 6 Criteria EGilor c sensere races oaa nnn ed na ue 8 7 8 6 1 Criteria examples sssesseseeesinssrrsrerssrnssrrnsrnssrrssrnssrrssrns 8 9 8 7 Utility Server options sse 8 11 8 8 Status Module add on ss
45. isteners Raw Listener A Raw Listener B Raw Listener C Raw Listener D LPD Listener Socket port Socket part Socket part Socket port Socket port Figure 5 3 SmartLogger User s Guide SR 2 5 3 Maintenance TCP listener Listener A D Enables or disables listener A D Multiple listeners are only needed if several data sources from the same IP have to be connected LPD Listener Listener used for SmartLogger Line Printer Daemon Default socket port number is 515 Socket port Identifies the TCP IP port for the corresponding listener where the SmartLogger will listen for connection requests from remote hosts 1 Ifthe SmartLogger is set up to simulate a HP JetDirect printer the port number normally has to be set to 9100 To emulate printers from other vendors please contact your vendor for the correct port number 5 2 3 System Supervision TCP IP Program behaviour Prompt before closing Iv Minimize to system tray r Timers Status refresh interval sec f Gil Log change period min 20 VA r Password Enable password protection Change Figure 5 4 5 4 SR 2 SmartLogger User s Guide Maintenance Program behaviour Prompt before _ If checked you will always be warned when closing trying to exit the SmartLogger The only exception is if Windows itself is shutting down Minimize to If checked the SmartLogger is minimized to
46. larm Events that are validated correctly and match the Alarm mask pattern specified in the template Excluded event Events that match the text pattern specified in the Exclude mask in the template will be treated as an excluded event Validation error Events that did not pass the event validation The colors used for color mapping is configured from the menu item Config Color Mapping 5 8 SR 2 SmartLogger User s Guide Maintenance Color Mapping x Common colors Background in Online Views X Excluded text umi Validation error EN Standard color mapping Validated event Validated alarm iM Advanced color mapping KI Screen Color a Screen Color 2 Screen Color 3 Screen Color 4 Screen Color 5 6 Screen Color Screen Color Requires that color mapping is enabled in template X Cancel Figure 5 7 Common colors Background Background color to be used in Online Views if Color in color mapping is used Excluded text Color for events that are excluded Validation Color for events that do not pass the validation error Standard color mapping Validated Color for validated events event Validated Color for validated alarms alarm SmartLogger User s Guide SR 2 5 9 Maintenance Advanced color mapping Color grid The color grid shows the current color mapping To modify a color select the wanted Co
47. le with the discarded events with an advanced word processor like MS Word Most word processors will place a write protection on the file which will cause the SmartLogger to fail when trying to write discarded events to the file 12 2 Log change philosophy The log change feature ensures that log tables do not grow inexpedient large A port can be set up to perform a log change every DAY every WEEK every MONTH or every YEAR SmartLogger User s Guide SR 2 12 3 Appendix The composed log name depends on the specified change type as shown in the following example where the today s date is 1999 08 27 Change type Composed log name DAILY TEST19990827 WEEKLY TEST1999W34 MONTHLY TEST19990800 YEARLY TEST19990000 As incoming events may not arrive in consecutive order the SmartLogger operates with a term called Log change period The following describes how the Log change period is handled for a port configured to DAILY log change e The log change period starts when an event with a newer date than the current destination log is received Example The current log is named TEST19981117 If an event with timestamp 1998 11 18 is received at 00 02 31 then the log change period is started at 00 02 31 e During the log change period two destination logs are active at the same time Events are stored in the log that corresponds to event s time stamp e The log change period ends when the log change ti
48. lor Id and change the color with the color picker to the right of the grid 5 4 1 Standard Color Mapping When using standard color mapping it is possible to associate individual colors for the background and the event categories listed in the previous section 5 4 2 Advanced Color Mapping When using advanced color mapping it is possible to associate field values in the range from 1 to 16 to a user defined color These values are called Color ds Values not within the 1 16 range are just ignored The field to be used for the color mapping must be specified in the Template used for the port For more information on how to set the color field please see the SmartBuilder User s Guide 5 10 SR 2 SmartLogger User s Guide Utilities 6 1 Text File Import The text file import can be used to convert text files to tables using the same principles that the SmartLogger uses for event logging This utility is especially useful for converting old text logs to SmartLogger database tables The utility is opened from the menu item File Text File Import Source directory Filter F SmartLog Data Text S am z Available files Files to import 051_COM2Dump log OS18 3Sample log gt gt lt ENEN Import settings Template impor Destination settings C Append to table s C One file One table ZS Overwrite table s Many files gt One table Database alias Table name USERDATA z X
49. mask is applied only characters that have a corresponding Mask Id or in the used template will be shown An example Event as it arrives on the port 99 02 12 12 00 01 KFB MOTOR 123 OPEN Event mask in used template n YY MM DD hh mm ss AAAAAAAAAAAAAA BBBB Event shown after applying the mask 99 02 12 12 00 01 KFB MOTOR 123 OPEN For more information about the event mask refer to SmartBuilder User s Guide View Colour legend Hides or shows the colour legend panel located at the bottom of the window 4 14 SR 2 SmartLogger User s Guide Basic operations View Show Excluded events If this menu item is checked then excluded events are shown in the Online View The exclude definition is specified in the SmartLogger template used for the current port and can be modified with the SmartBuilder program The exclude function is usually used to exclude garbage lines like print headers and footers Search Find For a quick search through the entire content of the Online View use the Search utility The Search dialog can be activated from the menu item Search Find or by pressing CTRL F Search options like Whole word and Match case are supported Before you can perform a search you have to stop the trace Search Search Again Performs another search based on the same search criteria SmartLogger User s Guide SR 2 4 15 Basic operations 4 16 SR 2 SmartLogger User s Guide
50. mation message SmartLogger gt Host Contains miscellaneous information about the SmartLogger set up and each configured port Is transmitted every time a connection is established i e at start up and after a connection has been lost Must be confirmed by host Status message SmartLogger gt Host Contains current status for all configured ports Is transmitted every time status has changed May be transmitted with up to one minute delay as the Remote Transfer module only scans for status changes every minute or when another message is transmitted Data message SmartLogger gt Host Contains all events stored in one queue file Is transmitted when required When confirmed by host the corresponding queue file is deleted Heartbeat message Host gt SmartLogger Heartbeat message used to verify connection at idle periods Confirmation message Host gt SmartLogger Confirmation for successful received information or data message 12 6 SR 1 SmartLogger User s Guide 12 5 File locations Appendix The following table shows a list of files and file types maintained by the SmartLogger application File type Default location SmartLogger ini Install path Systemlog db Install path Templates tpl Install path Templates Discarded events txt lt Install_path gt Discarded Filter definitions flt lt Install_path gt Filters Log tables db lt Install
51. mer expires The timer can be changed from the Settings dialog as described in section 5 2 Options Events with time stamps older than the current destination log will be discarded If for example the current log is TEST19981117 then events with time stamps 1998 11 16 and older be discarded 12 2 1 Forced log change In two cases the SmartLogger will execute a log change instantly disregarding that the change period timer has not expired These are 1 If events from a new day are received during a log change then the current log change is completed instantly and a new log change period is started 12 4 SR 1 SmartLogger User s Guide Appendix 2 When the SmartLogger is started the current date is used as default for composing table names If events from the previous day are received before any events from the current day then a log change to previous day is performed instantly This ensures that events from previous day are not discarded if the SmartLogger for some reason has been stopped during midnight and an event queue has been built up at the data source 12 3 Handshake handling For serial ports it is possible to enable software handshaking XON XOFF The handshake is programmed as described in the following XOFF ASCII 19 is transmitted when e A serial port is stopped e The input buffer is 80 full XON ASCII 17 is transmitted when e A serial port is started e Data source supervision timer expires e
52. n The LPD is a printer server that can receive print requests for several printers via TCP IP network MDI Multiple Documents Interface NM Notification Module PDF Adobe Portable Document Format This is the format SmartLogger User s Guide SR 2 1 1 Introduction used for the online User s Guide Record A record is one row of data one event in a database table RD Redundancy Module RT Remote Transfer SM Status Module SMS Short Message Service SQL Structured Query Language Standard language for accessing databases US Utility Server Server module for remote access of SmartLogger status and remote event subscription Template Describes the structure of the destination table and how data are to be decoded Templates are designed with the SmartBuilder program WD Watchdog 1 2 Product overview The SmartLogger product suite consists of the following programs SmartLogger Main program that handles the basic event logging and data handling for up to 4 serial or TCP IP ports concurrently SmartClient Client application used for viewing and analysing log tables generated by the SmartLogger SmartTranslator SmartBuilder Program used for building and maintaining the templates used by SmartLogger SmartTranslator SmartSim Event simulator that can be used for test and demonstration purposes by sending events via a serial or TCP IP connection The simulator is freeware SmartTranslator
53. n put through a number of filter and validation steps The following describes the validation sequence Step 1 Binary filter The first step is a binary filter that ensures that corrupted data are not accepted A typical situation where this filter is useful is when the serial settings for the data source and the SmartLogger are not identical Step 2 Line filter Some data sources sometimes produce empty lines To avoid warning messages the SmartLogger ignore empty lines Step 3 Exclude mask It is possible to define an exclude mask in the SmartLogger template All events with a text pattern like the Exclude mask will be ignored by the SmartLogger SmartLogger User s Guide SR 2 12 1 Appendix Step 4 Event validation The final step is the actual event validation where date time and integer components are validated The validation is performed according to the event mask defined in the template Validated events are stored in the database table while events that do not observe the template specification are stored in a discarded log text file 12 1 2 Timestamp handling Depending on the timestamp settings in the template the SmartLogger handles event timestamps differently Local timestamp All events are stamped with the current local PC time as they are processed External timestamp Timestamps are decoded from the event according to the specified event mask in the template Local intelligent date If the local in
54. nd start stop stop ports Allow remote If enabled remote status clients can acknowledge acknowledge warnings Allow event If enabled local remote clients can subscribe on subscriptions event data sources Must be enabled if Notification Module is enabled SmartLogger User s Guide SR 2 8 11 Utility Server 8 8 Status Module add on The Status Module add on allows remote SmartStatus clients to connect to the Utility Server for remote access and supervision of the SmartLogger For more information about the features available with the Status Module add on please refer to the SmartStatus User s Guide 8 12 SR 2 SmartLogger User s Guide Notification Module Add on 9 Notification Module Add on Add ons are not included in the SmartLogger product as standard The Add ons must be purchased and registered separately The following descriptions therefore only apply if you have installed this add on on your system The Notification Module can be used to subscribe to SmartLogger data sources and then report or forward any received events as an Email SMS or a SMS via mail notification Email and SMS via mail notifications require access to a mail SMTP server while the SMS notification requires a GSM modem to be attached to the computer The Notification Module will receive events via the SmartLogger Utility Server and is treated as an independent Utility Server client In order to perform notification on
55. ne shows a list of all remote and local clients currently connected to the Utility Server For each client a list of subscribed data sources is provided Please note that the Notification Module add on is considered as a local client to the Utility Server and will therefore also be listed in the Clients connected view Messages The message pane contains all messages related to the Utility Server module The information here will be more detailed compared to the information stored in SmartLogger s common system log as only important messages and errors are stored in the system log 8 2 New filter To create and add a new filter to a port simply select the wanted port and choose the menu item File New Filter New Filter EN Filter definition name Use field names from template New_Filter Simulator33 Description Filter description Filter criteria list OR Pseudo code ProcSec 12 AND Tagnam 76 ProcSec 5 AND Tagname KYC Delete Delete all Utility Server Figure 8 2 New Filter Filter definition Name of the filter definition which is identical to name the name of the physical file where the filter is stored Use field This entry is fixed to the template that is names from configured for the selected port The template is only used to gain access to a list of field names when building the filter criteria s Description A descriptive text Filter criteria list
56. on Database Supervision Redundancy C Serial Printer queue name C TCP IP Raw SLPort C Telnet Figure 4 5 LPR LPD settings Printer queue The printer name identifies the printer queue name that is associated with the current port l e in this case the SmartLogger Line Printer Daemon will make sure that all print requests for SLPORT1 will be redirected to this port SmartLogger User s Guide SR 2 4 5 Basic operations Although the SmartLogger only has one Line Printer Daemon activated it can handle requests to several ports Just make sure that each port has its own Printer name configured 4 2 2 Advanced settings Database Communication Database Supervision Redundancy Database alias User name Password LOGDATA sel SLUser areas Figure 4 6 Advanced settings Database Database alias Destination for log tables Default alias LOGDATA should be used for standard configurations Refer to section 6 2 Database Alias Manager for a description of aliases User name Specifies the database user to be used in case of database access limitations Password Specifies the database password to be used in case of database access limitations 4 2 3 Advanced settings Supervision 4 6 SR 2 SmartLogger User s Guide Basic operations Communication Database Supervision Redundancy War if no events are received within min fi A Fig
57. ools Alias Manager and it is divided into two sections The upper part as shown in Figure 6 3 is common for all database types The lower part contains individual settings for a specific database driver and is described later in this section Database Alias Manager x Database alias ucoemo sl D New REN Driver type STANDARD NM Save Figure 6 3 Alias Manager controls Database alias Lists all aliases supported by the Alias Manager Driver type Lists all database drivers available It is recommended always to use the STANDARD W Paradox driver unless it is explicitly required to use another database driver 6 4 SR 2 SmartLogger User s Guide 6 2 1 Database driver settings Paradox 7 STANDARD driver Paradox Utilities Database path F SmarnLog Tables i Figure 6 4 Paradox 7 settings Database path Defines the location directory where the tables are stored MS Access 97 MSACCESS driver MS Access 97 Database name H Logdata MS Access SmartLog mdb Default user name admin Figure 6 5 MS Access 97 settings Database name Default user name file The default user name that is used if automatic database login is disabled Defines the location of the database file mdb SmartLogger User s Guide SR 2 6 5 Utilities Oracle 8 ORACLE driver
58. or a list of supported transmission protocols Configuration The Remote Transfer add on is configured from the menu item Config Remote Transfer SmartLogger User s Guide SR 2 11 1 Remote Transfer Add on Add on Configuration x Watchdog Remote Transfer M Enable Remote Transfer Iv Poti WM Pot2 P Pot3 T Pond Identification Own name SLNode Id A Queue settings Max entries per queue file 200 Max time between queue files min E Ei File scan interval min n E Remote server TCP IP address 23123123004 Socket port ham E X Cancel Figure 11 1 Remote Transfer Enable Enables disables the Remote Transfer add on Hemote Trans Port 1 4 Used to enabled or disable individual ports for checkboxes Remote Transfer Identification Own name Used by transmission protocol to identify the SmartLogger node Id Used by transmission protocol to identify SmartLogger node in redundant systems Queue settings Max entries Defines the number of events allowed in each per queue file queue file If exceeded a new queue file is SmartLogger User s Guide Remote Transfer Add on created Max time Maximum delay between each queue file in between minutes If exceeded a new queue file is created File scan Defines the time in minutes between each scan interval for files to transmit Remote server TCP IP Defines the IP address
59. pleted 2 Strip Test tt StripTest 10 0 Completed DemoEvents bt I Import completed Lines converted 4 StripTestt t I Import completed Lines converted 10 Figure 6 2 File list File name Name of the source file Table name Name of the destination table Entries Number of lines read from the source file Bad Number of lines that could not be converted Status Status for the import for the corresponding source file Can be Pending Executing Completed Stopped or Skipped Message view Messages Show miscellaneous messages related to the import for each source file 6 2 Database Alias Manager A database alias is needed in order to access a database It defines the database driver connection parameters and the destination path database type The Alias Manager can be used to add modify and delete aliases with the restriction that only the basic settings like database driver destination path database default user etc can be changed SmartLogger User s Guide SR 2 6 3 Utilities Normally the user only needs to access the basic settings as the Alias Manager automatically configures all advanced settings If it is required to access the more advanced alias settings the BDE Administrator tool has to be used The BDE Administrator can be started by selecting Settings Control Panel BDE Administrator from the Windows start menu The Alias Manager dialog is opened from the menu item T
60. pted to activate the port If you choose not to start the port now the corresponding status icon on the toolbar will remain red until the event logging has been activated manually from the Port Status or until the SmartLogger program has been restarted W At program start up the SmartLogger automatically activates event logging for all configured ports 4 4 Port Status For each configured port miscellaneous status information is available The overall status for all ports is shown on the toolbar on the main form while a detailed status can be obtained from the Port Status To enter the detailed Port Status e Press the corresponding status button on the toolbar OR e Select the menu item View Port Status 4 8 SR 2 SmartLogger User s Guide Basic operations DEMO DEMO DEMo3 DEMO4 General Status ACTIVE Description Data source TCPYIP A 123 123 123 003 Last Mag PortHandler for TCP IP interface activated rLogs DB Driver STANDARD Current DEMO220000828 Change over lt Not Active gt Statistics Statistics activated 28 08 00 22 41 19 Events received 0 Reset statistics Events discarded 0 View discarded Figure 4 9 General Status General port status ACTIVE WARNING STOPPED or ERROR Description Port description Data Source Last Msg Source type and either serial port telnet or IP address listener used The l
61. r this purpose 2 Mail or fax the System Code listed above to your local supplier A few days later you will receive the License keys Productkey FC1LDAZ83 SmartLogger Full version Options key 1 FEA013E4 Notification Module and RemoteTransfer Lh Options key 2 DBAACA 6 Status Module and Redundancy Module Trial period will expire in 0 days wv OK X Cancel Figure 2 1 The SmartLogger supports two types of copy protection Softkey protection To register the SmartLogger with a softkey protection please follow these instructions 1 Install the product on the PC dedicated to the event logging 2 Mail or fax the System Code shown in the registration dialog to your local supplier A few days later you will receive a License key which has to be entered in the Product Key field in the Registration dialog If you have purchased any add on s like Remote Transfer Status Module or Notification Module their registration keys will have to be entered in the Options key 1 or Options key 2 field SmartLogger User s Guide SR 2 2 3 Installation and Set up The System Code is hardware dependent It is therefore very important to register the product for the PC intended for the event logging When a program is registered the Registration dialog can no longer be called up from the menu If you have to register Add on s later on you can use lt Ctrl gt R to call up the Registration dialog again
62. rate one notification per recipient specified To change the data source press the associated Select button and the SmartLogger User s Guide SR 2 9 5 Notification Module Add on Data Source browser dialog will be shown Mail properties To Contains the list of recipients for this notification To select new recipients press the associated Select button From Identities the sender of the Notification Subject A descriptive subject for this notification Can be used to categorise the notifications for the recipients like for example Section 5 alarm Produced water alarm etc Message The message body To insert fields from the event into the message select the wanted field and press the Insert button Inserted fields will be displayed as lt FIELDNAME gt 1 Depending on the Notification type selected this may change to SMS or SMS via mail 2 In SMS notifications the From and Subject entries will be part of the SMS message like From Subject Message text For SMS messages the total length of the message W including From and Subject text can not exceed 160 characters Any additional characters will be cut off 9 3 1 Data Source browser When selecting a data source for a notification the following dialog will be shown 96 SR 2 SmartLogger User s Guide Notification Module Add on Data Source Browser EN Server Localhost v Available da
63. riteria s OR To add another criteria to this criteria list click on the Add to list button In the following example we have specified that we want to filter all Tagnames starting with KVC from section 5 8 and 12 r Criteria list OR Pseudo code Tagname KVC AND Section 5 Tagname KvC s AND Section 8 Tagname Kv AND Section 12 Delete t Delete all I Case sensitive Figure 8 9 In a logical structure the above example will look like this 8 10 SR 2 SmartLogger User s Guide Utility Server IF Tagname KVC AND Section 5 OR Tagname KVC AND Section 8 OR Tagname KVC AND Section 12 8 7 Utility Server options The options dialog can be accessed from the Utility Server menu item Tools Options Utility Server Options EN 18000 VA r Remote access options M Allow remote reset of statistics Iv Allow remote start stop of ports Iv Allow remote acknowledge of warnings M Allow event subscriptions wv OK X Cancel Figure 8 10 Utility Server Options Enable Utility If checked remote applications and local Server modules like the Notification Module are allowed to connect to the SmartLogger Socket port Socket port used for TCP IP listener Remote access options Allow remote If enabled remote status clients can reset reset statistical counters Allow remote If enabled remote status clients can start a
64. s that a program shutdown where the outputs will be frozen is also detected Status information It is possible to see the current status of the watchdog outputs by selecting the menu item View Watchdog or by pressing the watchdog status icon 0 Q Port 1 Q Port 2 Q Port3 3 Pond 4 TCP Listener 5 es Remote Transfer 6 Q Common G o Pulse of On ONotused Figure 7 2 The channels 0 to 5 indicate the current status for the corresponding port or module while channel 6 is the output of al used channels AND ed together The watchdog status information can be viewed disregarding an I O board is available or not 7 4 SR 2 SmartLogger User s Guide Supervision 7 2 Data source supervision Data source supervision can be enabled and configured individually for each port from the Port Setup dialog as described in section 4 2 When enabled a warning is raised if a port has not received any data within the specified time period If the port in question is a serial port and the port is configured for XON XOFF handshake then the SmartLogger will send an XON character to ensure that a lost XON character does not cause the silence This can happen if the serial cable is not connected between the data source and the SmartLogger when a port is started 7 3 Disk space supervision The disk space supervision is common for all configured ports and can be enabled and configured from the Options dialog
65. s 8 12 9 Notification Module Add on ee 9 1 9 1 Mal RE 9 1 9 2 Notification Menu enne 9 4 9 3 Add Notification sssssssseseeeeneeennnn nnns 9 5 9 3 1 Data Source browser 9 6 9 3 2 Notification Ivpes 9 7 9 4 Notification Options eesseesseesseesseesseessesnrsennnnnneennrnnnsenneennens 9 8 9 5 Address Book 9 11 10 Redundancy Module Add on 10 1 10 1 Redundancy Concept 10 1 10 2 Additional miormatton nenene 10 2 10 2 Mel GEET 10 2 UR eil NEE 10 3 10 2 3 Redundant information in tables 10 4 11 Remote Transfer Add on eee 11 1 11 1 Remote TADSIGr ete ia oret e rrna dat retra ee ha arenae 11 1 SR 2 SmartLogger User s Guide 12 Appehdix EE EES EENS Ee 12 1 EAR Ba le Tale WEE 12 1 12 1 1 Data validation 3 x iie iren 12 1 12 1 2Timestamp handling eee 12 2 12 1 3 Data storage iiid erp tte ipee 12 3 12 2 Log change philosophy sees 12 3 12 2 1 Forced log change 12 4 12 3 Handshake handling sess 12 5 12 4 Remote Transfer details 12 5 12 4 1 Remote Transfer queue seeeeeesreereerserresrresresn 12 5 12 4 2 Remote Transfer messages eeeeeeeeeeeeenn 12 6 12 5 File locations iure ripe rere Rede eme 12 7 SmartLog
66. s one criteria and all criteria s are OR ed together in the final filter handling To modify the criteria s press the Edit button The Criteria Editor is described in section 8 6 W The template reference is only used to get a list of field names in order to be able to build the filter criteria s 8 6 Criteria Editor The Criteria Editor is a powerful tool for building any kind of simple or complex criteria for use in filters SmartLogger User s Guide SR 2 8 7 Utility Server Criteria Editor x Criteria AND zl JAM Add to list Seton e Wees FNotUsed TI n Not Used X Text wildcards Single char Multiple chars Reset All Hu Criteria list OR Pseudo code Alarm ALM AND Section 12 Delete Delete all di I Case sensitive Figure 8 5 Criteria Editor Criteria AND One AND criteria is composed by up to 4 field criteria s AND ed together An AND criteria can be added to the criteria list by pressing the Add to list button Criteria list The criteria list OR show the filter criteria s in OR translated pseudo code Each line equals one criteria and each criteria are OR ed together in the final filter handling Criteria If a field is a numeric field a small criteria buttons button will be visible between the field name and 8 8 SR 2 SmartLogger User s Guide Utility Server the edit box This button can be used to specify a rang
67. special event patterns like all Pressure high events from process section 12 a SmartLogger data source must be created in advance How to create and set up SmartLogger data sources is described in section 8 Utility Server 9 1 Main view The Notification Module main view can be shown by clicking on the N icon on the toolbar or by selecting the menu item Tools Notification Module SmartLogger User s Guide SR 2 9 1 Notification Module Add on Notification Module Eile Edit View Tools Notification definitions Events received 23 Mail Timestamp amp Mail Demo 1 27 01 0 12 DEMO Formatted events 2002 01 27 00 47 12 EVT V _ 8 Mel Demo 2 274122004713 DEMO_ Formattedevents 2002 01 27 00 47 13 EVT KRT ESDV EK SMS 27 01 02 00 47 45 DEMO Formatted events 2002 01 27 00 47 45 EVT WUL P 600 s SMS Demo 1 5 5 SMS vie mail pera ae 00 47 46 DEMO Formatted events 2002 01 27 00 47 46 EVTKRT ESD i SMS Demo 27 0102 01 19 53 DEMO New Filter 2002 01 27 01 19 53 EVT KRT ESDV 127 01 02 01 20 27 DEMO New Filter 2002 01 2 01 20 27 EVT KRT ESDV po 012035 DEMO New Filter 2002 01 27 01 20 35 EVT KRT ESDV w 4 Outputiog Messages 27 01 02 12 52 18 lt W gt Failed to open logfile I VATTrace log for write access 27 01 02 12 52 18 Trying to connectto server on IP address 127 0 0 10 socket 18002 27 01 02 12 52 19 Connection established 27 01 02 12 52
68. t A watchdog output will normally be ON high if the corresponding port or module is enabled and active If one of the Treat warnings as errors options is enabled then a corresponding warning will set the watchdog output OFF low until the warning has been acknowledged For most installations it is recommended to enable the alarm option Treat supervision warnings as errors and to disable Treat all warnings as errors This combination will make sure that the most serious errors and warnings are reported without generation a lot of unnecessary alarms Channel layout Depending on the board a number of I O bytes may be available The SmartLogger only uses one byte for watchdog outputs which for National Instruments boards normally is named PB Port no 1 The eight channels bits in the PB byte is used as described in the following table Description Port 1 status Port 2 status Port 3 status Port 4 status TCP IP Listener status Remote Transfer status Common flag ON if channel 0 to 5 are ON no errors not used Pulse channel Will pulse if enabled and common flag is ON SmartLogger User s Guide SR 2 7 3 olala lwm log N Supervision Depending on the requirements one or more channels can be connected to an external supervision unit If only one channel is to be used for external supervision it W is recommended to use the pulse channel This ensure
69. t Required for SMS and SMS via mail notifications SmartLogger User s Guide SR 2 9 11 Notification Module Add on 9 12 SR 2 SmartLogger User s Guide Redundancy Module Add on 10 Redundancy Module Add on Add ons are not included in the SmartLogger product as standard The Add ons must be purchased and registered separately The following descriptions therefore only apply if you have registered the Redundancy Module add on on your system 10 1 Redundancy concept The redundancy module is intended for configurations were safe data collection is vital for subsequent event analysis The concept is based on event collection from two identical data sources and storage in a single log where doublets are removed The filtering is based on unique database indexes which makes sure that identical events cannot be stored in the database This also has the benefit that delayed events from either of the data sources have no impact on the data storage Data Source Data Source A B Port Port Port Port 1 2 3 4 TCP IP SmartLogger SmartLogger User s Guide SR 2 10 1 Redundancy Module Add on The unique table index is defined in the SmartLogger template and must be a primary index This means that fields used for the index must be located at the beginning of the table structure The template and the index can be modified with SmartBuilder application It is very important that index contain enough fields to W makes
70. ta sources e DEMO Formatted events DEMO My data source DEMO New Filter DEMO Raw events Data source info Standard data source Jf OK X Cancel Figure 9 3 Data Source browser Server Only Localhost is supported in this version Available data Shows a list of data sources available on the sources selected server To refresh the list press the small circular arrow above the list box Data source Shows a descriptive text for the selected data info source if specified when building the data source 9 3 2 Notification types The Notification Module supports the following notification types E mail Notifies the recipient via e mail and requires access to a mail SMTP server This type is only preferable when a notification do not require immediate action SmartLogger User s Guide SR 2 9 7 Notification Module Add on SMS via GSM Notifies the recipient via a GSM cell phone and requires a GSM modem to be attached to the computer This type is recommended when a notification requires immediate action SMS via mail Notifies the recipient via a GSM cell phone and requires access to a mail SMTP server The delivery time for the SMS may vary a lot could be hours as free SMS services have very low priority by many phone operators 9 4 Notification options The options dialog can be accessed from the Notification Module menu item Tools Options SMS options
71. telligent date feature is selected then the date value is calculated according to the following formulas pseudo code Date LocalDate if HourLocal 8 lt HourEvent Date Date 1 if HourEvent 8 lt HourLocal Date Date 1 where HourLocal Current hour value from local PC HourEvent Hour value decoded from event Adapted values There is one case where the SmartLogger will store an event even though it could not decode all values correctly If the date is decoded correctly but the time conversion fail then the SmartLogger will store the event with the local PC time as time parameter For each adaptation made a warning is raised 42 2 SR 1 SmartLogger User s Guide Appendix 12 1 3 Data storage Figure 12 1 shows the two possible destinations for incoming data Data are either stored in a table log or if discarded in a text log Incoming data Noise Garbage Event validation Online View Table Log Text Log Binary Filter Excluded Online Buffer Figure 12 1 The text log contains the raw data and a time stamp for each discarded text line Date Time Discarded event text The discarded files are named lt LABEL gt txt and are located in a directory named Discarded If for example a port were configured with the label TEST then the corresponding text log file would be lt InstallPath gt Discarded TEST txt Do not try to open the fi
72. the source alias Only aliases currently used by the SmartLogger is shown Shows all available tables for selected alias Specifies the destination path To change the path use the small browse button to the right of the control Shows the selected tables that are to be backed up If set only tables that have been changed since SmartLogger User s Guide SR 2 5 7 Maintenance changed last backup are listed in the Source tables window Move tables If set tables are deleted after successful backup 1 Ifthe alias points to a database type where the tables are located in the same file only this database file is shown It is then only possible to backup the entire database not individual tables It is also not allowed to move such a database since some of its tables may be in use by the SmartLogger The backup utility is file based which means that it can not be used for database servers To backup tables stored in a database server please refer to the manuals from the database vendor 5 4 Color Mapping The SmartLogger supports two types of color mapping Standard and advanced color mapping In both modes the color mapping is performed according to the template settings and the event validation status The SmartLogger uses the following event categories Validated event Events that are validated correctly but do not match the Alarm mask pattern specified in the template Validated a
73. ure 4 7 Advanced settings Supervision Enable If checked data source supervision is active supervision Refer to section 7 2 Data source supervision Warning if If no data is received within the specified time period a warning is raised 4 2 4 Advanced settings Redundancy Note that this feature is only available if the Redundancy Module Add on has been purchased For more information about the Redundancy Module please see section 10 Redundancy Module Add on Communication Database Supervision Redundancy M Enable redundant data collection must be LPR LPD datasources Printer queue name A SL Port A Printer queue name B SLPort B Figure 4 8 Advanced settings Redundancy Enable If checked redundant event collection for this redundant port is enabled Printer queue Specifies the printer queue name for data SmartLogger User s Guide SR 2 4 7 Basic operations name A source A All print requests sent to this queue are treated as events from source A Printer queue Specifies the printer queue name for data name B source B All print requests sent to this queue are treated as events from source B Store data If enabled then extra information is stored in a source info separate field in the database For more information see section 10 2 3 Redundant information in tables 4 3 Port activation When a new port is configured and enabled you will be prom
74. w this User s Guide you must have Adobe Acrobat reader 4 0 or higher installed on your system If it is not installed you can install it by selecting it from the installation menu SmartLogger User s Guide SR 2 2 1 Installation and Set up Adobe Acrobat reader is copyright of Adobe Systems Incorporated 2 3 Windows set up The following Windows settings should be observed in order to make the SmartLogger perform properly Screen resolution The SmartLogger supports all resolutions from 800x600 and higher but has been optimised for 1024x768 with large fonts Windows Common Controls The applications use some of the newer MS Windows Common Controls If you experience any problems with the graphics on the menu or toolbuttons the Common Controls might need to be updated The official Microsoft update program for the Common Controls version 5 00 xxxx can be installed from the installation menu 2 4 Registration It is very important to register the SmartLogger product as an unregistered SmartLogger only works within a limited period As long as the product is unregistered the following dialog will appear at start up 2 2 SR 2 SmartLogger User s Guide Installation and Set up Registration x System Code 11F21C1B 32600BEC This productis copyright protected but may be used freely during the trial period To geta license you must register the product 1 Install the product on the PC dedicated fo

Download Pdf Manuals

Related Search

Related Contents

  DELT∆ - Lehner Lifttechnik  Digital Video Recorder User Manual  ダウンロード    

Copyright © All rights reserved. Failed to retrieve file