tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages...

42
© 2015 Softing Inc. All Rights Reserved. tManager Troubleshooting

Transcript of tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages...

Page 1: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

tManager Troubleshooting

Page 2: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Softing

Softing is a leading global provider of products for Industrial Automation and for Automotive

Electronics.

For over 30 years, the core business of Softing Industrial Automation has been industrial data

communication with products ranging from chips & stacks up to dedicated gateways and data

transfer modules.

Softing acquired Psiber Data GmbH and OLDI in 2014. Psiber Data sells cable testing products.

OLDI is an Original Design Manufacturer (ODM) that designs and sells PAC/PLC modules under

other company brands and a few with the OLDI brand. OLDI as a company will continue as an

ODM.

OLDI and Psiber Data products will transition to the Softing brand in 2015.

Softing also acquired the industrial communications product line from Trebing and Himstedt (TH)

in 2014.

As of January 1, 2015, the official North America company name is Softing Inc.

Page 3: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Softing Inc.

• Sells Softing and OLDI branded products

• Global Encompass Product Partner

• Products for Rockwell Authorized Distributors:

• Data Exchange Modules

• Communication and Protocol Modules

• Network Monitoring and Cable Test Tools

• Headquartered in Knoxville, TN

Page 4: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

eATM…

Enterprise Appliance

Transaction Modules

cATM…

Controller Appliance

Transaction Modules

SAM…

Special

Application

Modules

PCI; PCI

Express

Network Cards

for High Temp

Environments

WireXpert

Advanced Cable

Certifier for

Ethernet copper

or fiber

Move

Data

Run

Custom

Code

Connect

Networks

Certify

Cable

Products sold through the Rockwell Automation Channel

ControlLogix®

TH Scope; TH Link

Monitor; Diagnose

EtherNet/IP and

other networks

Monitor

Networks

Page 5: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Topics

• CompactFlash Storage

• Logs– System and Audit Logs

– Transaction Logs

• tManager Statistics – StatusTags

• Supervisory Controller

• Project

• Endpoint

• Message Path / Trigger (Handshaking)

– Trigger and Endpoint Overrun Timers

– Trigger & Endpoint Status Screens

– Cautions when Configuring Status Options

• Trigger & Endpoint States

• Errors– Trigger, Endpoint & Map Errors

– Database Validation

• Viewing Map Values (Debug Map Option)

• Network Diagnostics

• Cross-Reference Export

• Spare Modules

• Where to get Additional Information / Help

Page 6: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

tManager On-Board Compact Flash Storage

• A minimum of 2 GB of non-volatile flash storage is available for Store & Forward queues, System & Audit logs, and Transaction Logs

– Total amount available is shown on the eATM Manager Status Screen

– Even if some tManager versions allow more than 2 GB total, only 2 GB is guaranteed in future versions

– The tManager won’t allow you to allocate more space than is available. You will see an error message when you try to save your configuration

• Breakdown

– System Log: 20 MB (cannot be changed)

– Audit Log: 20 MB (cannot be changed)

– Transaction Logs

• For each trigger or endpoint that has transaction logging enabled, you can have 2-20 transaction log files (user-defined), & each log file can be 1-10 MB (user-defined)

• Configurable for each trigger/endpoint

– Store & Forward Queues

• Up to 200 MB per endpoint (configured individually for each endpoint)

Page 7: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Audit & System Log Details

• Audit log -- contains user changes that have been made. 20 Mb is allocated

• System Log -- contains errors and events that have occurred. 20 Mb is allocated

• Log files are divided into multiple 1 MB log files

– The date by each individual log file shows the last day it was updated. Double-click on a date to open that particular log file

• If there’s … at the end of the message, double-click on the message to read more

• The messages are displayed in the order they are received into the log

– If the clock on the tManager changed at some point in the past, the messages may appear to be out of order

• You can filter the types of messages that are shown, and search within the current file

• If a Warning, Error, or Fatal event occurs, the STS LED on the tManager will blink red, & the icon will appear on the Project Editor & xATM Manager screens

– Note: After version 2.5.13 the STS LED will remain green, even during error conditions. However, the ERR: Check log message will continue to scroll between other information

– Solid Green means the tManager is running; Blinking Green means it is Halted

• The Requires Attention icon can be cleared via the xATM Manager Status screen

Page 8: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Audit Log

Page 9: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

System Log

Page 10: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

System and Audit Log Configuration Screen

Page 11: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

System and Audit Log Files - Configuration

• The xATM Manager’s Configure Logs screen lets you view and modify the following System and Audit log settings

– Log detail level: Specifies the level of detail to log in the System log

• INFO -- will see Informational, Warning, Error and Fatal messages (default)

• WARN -- will see Warning, Error, and Fatal messages

• ERROR -- will only see Error and Fatal messages

• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as it may have an impact on the tManager performance

– Enable notification: If notification is enabled, you can specify the settings for sending an e-mail notification when Warning, Error, or Fatal entries are logged to the System log

• Note that after version 2.5.13 the STS LED will no longer turn Red when a new Warning or Error occurs. Thus, enabling notifications is recommended.

– FTP export: If the enabled, when a log file is full it will be automatically exported and sent to the configured FTP site

– SMTP export: If the enabled, when a log file is full it will be automatically exported and sent to the configured e-mail address

Page 12: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Transaction Logging

• A Transaction Log keeps a log of transactions that have occurred on a trigger or endpoint. Transaction Logging can be individually selected and configured for each trigger and each endpoint

• Uses:

– For startup and troubleshooting

• Database Endpoint Transaction Log -- includes the SQL messages sent to the database, data being transferred, and any database error messages

– Both successful and unsuccessful transactions are logged. Data is displayed in decimal

– Separate entry for each message path

• Automation Endpoint Transaction Log -- includes the hex data sent to the controller

– Separate entry for each message path

• Trigger Transaction Log -- includes the values of the trigger Variable and Reference fields (if used), along with the values of all Input tags used in the map and all tags used in a message path Where field

– Values of tags used in the map and message path are displayed in both decimal and hex

– New entry each time the trigger is fired. If the trigger is associated with multiple message paths, data from all the associated messages paths is in the same entry.

– To maintain a historical record of what was sent for regulatory requirements or ongoing machine analysis

• You can have the Transaction Log automatically exported via FTP or SMTP when a file becomes full

• Recommended if you wish to maintain the information for longer periods of time

• For tManager higher speed applications, enable Transaction Logging only during trouble-shooting

Page 13: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Trigger Transaction Log Examples

• Trigger used in a Select or Update Message Path- Values of tags used in the message path Where field

- If used, trigger Variable and Reference values

• Trigger used in an Insert or Procedure/Function Message Path- Values of map Input tags

- If used, trigger Variable and Reference values

Page 14: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Endpoint Transaction Log Examples

Example Trigger transaction log:

• Automation Endpoint

• Database Endpoint

Page 15: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Transaction Logging Configuration

• The following settings are available on the Transaction Log tab on the Trigger & Endpoint configuration screens:

– Transaction Log Settings: Enables the transaction log

– Number of log files (min 2): The no. of transaction log files to store on the compact flash

• The minimum allowed with the transaction log enabled is 2; the maximum is 20

– Log file size (MB): The size, in megabytes, the transaction log is allowed to grow to before creating a new log file

• The minimum size is 1 MB; the maximum is 10 MB

– Message bytes to log: The amount of the message (in bytes) to log. A message larger than this size will be truncated

– Log entire message: If this option is selected, the whole message is logged, regardless of size

– FTP export enabled: If enabled, the tManager exports the log via FTP when the log file reaches its maximum size and a new log file is created

– SMTP export enabled: If enabled, the tManager exports the log as an attachment to an e-mail when the log file reaches its maximum size and a new log file is created

Page 16: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

tManager Status Information

• tManager Statistics

– viewed on the xATM Manager Status Screen

• Supervisory Controller Status Tags

– defined on the Project Editor Supervisory Controller Settings screen

• Project Status Tags

– defined in the Project Editor under Edit --> Project Settings

• Endpoint Status Tags

– defined in the Project Editor on the Endpoint Configuration screen

• Message Path Status Tags

– Defined in the Project Editor on the Trigger Configuration screen

• Trigger & Endpoint Status Screens

– Show success and error counts, min/max/average times, dropped messages, etc

• Trigger and Endpoint Overrun Timers

– Defined under the Advanced tabs on the Trigger and Endpoint Configuration screens

• Requires Attention status

– Answer 113 in the OLDI Knowledgebase (http://kb.oldi.com ) describes the various ways to monitor if there are unacknowledged warnings or errors

Page 17: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

tManager Statistics

• Displayed on the xATM Manager Status screen, and updated every 60 seconds

• If Memory Used increases to 90% the tManager halts. It will restart once memory usage decreases to 85%

• The Requires Attention icon is displayed when one or more Warning, Error, or Fatal events have occurred

– To clear it, double-click on the icon and then select Clear Events

Page 18: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Supervisory Controller Status Tags

Update Rate: If a Supervisory Controller is defined, tManager status information is updated and sent to the Supervisory Controller every second. However, status information is only updated on the xATM Manager Status Screen every minute.

• Index 0 (Status Bits)

– Bit 0 (Needs Attention): When this bit is on, there are one or more errors that need attention that have occurred on the appliance. This means the Needs Attention indicator is active

– Bit 1 (PLC Command Error): The last controller command executed had an error

– Bit 2 (Supervisory Confirmation Flag): This bit is not displayed in the status data. Bit 2 is set only in the controller that owns the Control portion of the AOP connection. If a backplane AND an EtherNet/IP controller have a valid AOP connection, bit 2 will be set in one or the other (depending on the Supervisory Controller settings). The one with bit 2 set has Control (supervisory privileges) and may send commands to the appliance. If bit 2 is clear, the connection is read-only

– Note: Multiple backplane and/or multiple EtherNet/IP AOP connections is NOT supported. However, one backplane controller and one EtherNet/IP controller may simultaneously connect, with one having Control and the other just able to read Status Data.

– Bit 16 (Data in S & F): One or more Store & Forward queues are more than 1% full.

• Index 1 (Appliance Mode): The mode of the appliance.

– 1 = appliance is halted

– 2 = appliance is suspended (free memory on the appliance dipped to less than 10%, and hasn’t returned to 15%)

– 3 = appliance is running

• Index 2 (Command Trigger Echo): This index is set to the output index 0 command trigger value after the command has completed.

• Index 3 (Free Running Counter): A free running counter to indicate that the appliance is still alive.

Page 19: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Project Status Tags

• To configure, go to Edit Project Settings within the Project Editor

• If you are using a Supervisory controller to start/stop projects:

– Either the Supervisory Controller or Project Editor can stop a project

– Both have to be in agreement to start a project (needs to be started in the software and the Supervisory Controller state for the project must also be Run Mode)

• The value of the Project Status Tag bits are:

– Bit 0: User Interface flag for the project (0 = Stop, 1 = Run)

– Bit 1: Supervisory Controller flag for the project (0 = Stop, 1 = Run)

• The Project Status Tags are updated as the project status changes, or at a minimum of once every 20 seconds

• Probably don’t need if not using a Supervisory Controller to start/stop projects

Page 20: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Endpoint Status Tags

• Value reflects the status of the last transaction to the endpoint

– Database Endpoints: Status Tags reflect the status of the last transaction to that endpoint, both read and write

– Automation Endpoints: Status Tags reflect the status of only the latest write transaction to that endpoint. An error on reading information from an Automation device (i.e. a CompactLogix PAC) would not change the status

• The Endpoint Status Tags are updated only on change

– Status will not be updated if the communications continue to be successful

– If communications fail, the status will change

• Define Endpoint Status Tags only if the PLC/PAC will be monitoring the overall health of this connection

– Otherwise, unnecessary overhead

Page 21: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Endpoint Status Tag Values

• The status values reported in the Endpoint Status Tag are:

– Success = 0

• Last transmission was successful

– MsgFailed_WillRetry = 1

• Last transmission timed out – will retry message (for example, couldn’t communicate with the database)

• If S&F is enabled, means the last message through the endpoint was placed in the S&F queue

– MsgFailed_Discarded = 2

• Last transmission failed – will discard message

• Either the message was discarded because the S&F queue is full, or an error code was received from the database

– Stopped = 3

• The destination is stopped on the tManager (for example, the project or endpoint is stopped)

– Failover = 4

• The destination was unavailable, so the tManager has switched over to the defined Failover endpoint

Page 22: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Message Path Status Tags

• Message Path Status Tags report the handshaking status, and are updated on change

• Message Path Status Tags are define on the configuration screen for the associated trigger

• Only define if the PLC/PAC logic will be monitoring the completion status of the individual message path. Otherwise, unnecessary overhead

• If a trigger is used in multiple message paths, a separate status tag can be set for each message path

• Handshake Mode defines the Handshake position the message path must be in, in order for the trigger to fire again

Page 23: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Handshake Modes

• Handshake Modes (in order of execution)

– Received from Src: The trigger is rearmed when data is received from the source trigger (seldom used)

– In Queue: The trigger is rearmed when the message is sent to the destination endpoint or goes into the endpoint's queue. This is the option recommended for Store & Forward, and is the default for Insertand Update Message Paths

– Sent to Dest: The trigger is rearmed when the message is sent to the destination endpoint

• Store & Forward won’t work if this mode is selected for a message path

• Use if you want to stop the line if your Insert or Update is not completed for any reason

– Response in Queue: This is only an option for Select or Procedure/Function message paths. The trigger is rearmed when the message response is sent back to the source (inbound endpoint) or goes into the inbound endpoint’s queue. This mode is seldom used

• Store & Forward won’t work if this mode is selected for a message path

– Sent to Src: This is only an option for Select or Procedure/Function message paths, and is their default handshaking mode. The trigger is rearmed when the message response is sent back to the source (inbound endpoint)

• Store & Forward won’t work if this mode is selected for a message path. Change to In Queue if you want to use S & F in conjunction with a Select or Stored Procedure Message Path

Page 24: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Message Path Status Tag - Values

• Each Message Path goes through all 5 handshaking stages (10 thru 50), independent of the handshaking value defined for the message path, unless the trigger re-fires before the entire cycle is complete

• Message Path Tag Values:

– Received from Src: 10

– In Queue: 20 (stays here while data is in the Endpoint’s Queue)

– Sent to Dest: 30

– Response in Queue: 40

– Sent to Src: 50

– Message Dropped: 101 (S & F Queue is full or not enabled)

– Error: 102 (error code returned from adapter)

– Expired: 103 (message exceeded Time To Live in S & F Queue)

– Trigger Faulted: 104 (this may be caused by a tag missing in the map or trigger event)

– Message was Flushed: 105 (this is caused when the user flushes the S & F Queue)

Page 25: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Trigger and Endpoint Overrun Timers

• Endpoint

– Transaction Overrun Timer: If set to non zero, an error will be reported if the time for an endpoint to send data and receive a response exceeds the specified value.

• Trigger

– Scan Overrun Timer: For periodic triggers, if set to non zero, an error will be reported if the time from trigger evaluation to the next trigger evaluation exceeds this value.

– Execution Overrun Timer: If set to non zero, an error will be reported if the time from trigger evaluation to trigger completion exceeds this value. Trigger completion occurs when the handshake mode for all message paths linked to this trigger have been fulfilled.

|

• Total number of overruns is shown on the Trigger and Endpoint Status screens (next 2 slides).The amount of each overrun is recorded in the System Log error messages

Page 26: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Trigger and Endpoint Status Screens

• Used to monitor overall success and errors concerning triggers and endpoints, as well as execution times, and the status of the S&F Queues

• Can also view the Endpoint Transaction Overrun & Trigger Execution Overrun totals

• Can be accessed from the Status menu in either software package

Page 27: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Trigger and Endpoint Status Screens

• Individual status screens can be accessed by right-clicking on a trigger or endpoint and picking Status

• This is the only screen where you can see the Trigger Scan Time Overruns total

Page 28: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Cautions

• Status Tags

– Since they will add loading on the controller and could affect performance, only define Status Tags for the triggers and endpoints where they are needed and will be used by the controller’s application program

• Trigger and Endpoint Overrun Timers

– The overrun features should be enabled sparingly since they add overhead to the system which effects overall throughput of all the triggers on the module

– The values entered for the trigger overrun timers need to be greater than the Scan Period configured for the trigger

• Recommend a multiplier of 1.5 or greater

• If the values are too low, the system log will get filled with overrun errors, the module throughput will slow down, and other important events and/or errors may be missed

– The value entered for the endpoint Transaction Overrun Timer needs to be higher than the acceptable Maximum Execution Time for that endpoint (Max Xact on the Endpoint Status screen)

Page 29: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Trigger and Endpoint States

• If a trigger or endpoint is gray, and you are unsuccessful in starting the project with the tManager software

– Check to see if the Supervisory Controller is stopping the Project. Reference the Supervisory Controller Quick Start at http://kb.oldi.com

• If a trigger is running, but not firing when it should

– Verify that the endpoint it is associated with is running (is green). Depending on the Handshaking mode selected (discussed later), a stopped endpoint could prevent the trigger from re-arming

Page 30: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Trigger, Endpoint and Map Errors

• If a trigger, endpoint or map is yellow or has a red exclamation point (error indicator)

– Check the System Log for error messages related to which tag or map source wasn’t available. If the tManager cannot access a tag or database column, there is usually an error in the system log

– Hover over any faulted/error icons to see a descriptive message concerning the source of the problem

– If the trigger never fired (tag associated with the trigger is not available), there might not be a system log message

– If the trigger is faulted (is yellow) due to a missing tag on the input side of a map or the condition on the trigger, if the tag becomes available again the trigger will automatically restart

– If a trigger is faulted and you update the tag list, the trigger state will change to red (stopped).

• If the trigger is faulted due to items in a map being unavailable, after the tag list is updated ared exclamation point will appear before the affected map, and the map’s unavailable items will be highlighted in red

Page 31: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Error: Invalid request reading triggerError: Bad parameter reading trigger

• Possible Causes

– A tag associated with the trigger or the input side of a related map does not exist in the controller

– External Access for the tag is set to None in RSLogix 5000 (v19 or later)

• Example System Log Text

– yyy-mm-dd hh:mm:ss,zzz [YFTriggerServerReadThread-8] ERROR - Error on trigger \BasicDBDemo_eATM\Automation\Trigger_Production_Report: <6019h> CLXBP Invalid request reading trigger (BasicDBDemo_eATM\Trigger_Production_Report) group tag (CLX_Demo_eATM\CYCLE_TIME)

– yyy-mm-dd hh:mm:ss,zzz [YFTriggerServerReadThread-12] ERROR - Error on trigger proj1AutomationCabinetEnteringMES_Sta5705FromMezz: <6002h> CLXBP Bad parameter reading trigger (proj1CabinetEnteringMES_Sta5705FromMezz) variable Postfoam2CMES_Mezz_To_Sta5705.Flags.Enable)

• Resolution

1. Add the referenced tag to the PLC/PAC.

• If the tag exists, and the External Access for the tag is set to None, use the RSLogix 5000 Tag Editor to change the External Access field to Read/Write or Read Only

2. Update the tManager Tag List via the tManager Project Editor

Page 32: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Error: Invalid request

• Possible Causes

– A tag that's on the output side of a map does not exist in the controller

– External Access for the tag is set to Read Only or None in RSLogix 5000 (v19 or later)

• Example System Log Text

– yyy-mm-dd hh:mm:ss,zzz [\BasicDBDemo_eATM\Automation\Trigger_Change] [\BasicDBDemo_eATM\Path_Select] \BasicDBDemo_eATM\Automation\Endpoint_1: Error writing tags to AutomationAdapter: Error "CLXBP Invalid request" writing tag CLX_Demo_eATM\ScouringPadProfile.Model - Retry in 30 seconds

• Resolution

1. Add the referenced tag to the PLC/PAC

• If the tag exists, and the External Access for the tag is set to None or Read Only, use the RSLogix 5000 Tag Editor to change the External Access field to Read/Write

2. Update the tManager Tag List via the tManager Project Editor

Page 33: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Error: Data type mismatch reading trigger

• Possible Cause

– The tag is marked with a different revision number by the controller

– This is typically only seen with components of a UDT that has been modified. If this occurs, data integrity requires an enumeration update before you are allowed to write to this tag

• Example System Log Text

– yyy-mm-dd hh:mm:ss,zzz <601Ah> CLXBP Data type mismatch reading trigger (WetMix_B01B01BatchDataTrigger) group tag (WetMixProgram:B01.BatchData_Buffer[0].ProdID)

• Resolution

– Update the Tag List for the referenced controller

Page 34: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Error: Connection Timeout

• Problem

– You can communicate with the database, but the System Log contains a Connection Timeout error for an endpoint

• Possible Cause

– The Transaction Timeout value for an adapter is set too low

• Resolution

– Increase the Transaction Timeout value on the Adapter configurationscreen to allow more time for the database transactions

Page 35: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Viewing Map Values (Debug Map icon)

• The Debug Map icon allows you to have a one-shot view of the values of the map elements

– One the icon is selected, the map is armed for debugging

– When the next trigger fires which executes the map, the values of the map elements (including functoids) are captured and displayed on the map

– You can press the Debug Map icon again to clear the debug values. You can press it again to re-arm the map for debugging and see another set of values

Page 36: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Validating Communications with a Database

• Within the Project Editor, open the database adapter and select Validate Connection

• If the Connection Status box doesn’t say The connection is valid then

– Check the System Log for clues to the source of the problem. For instance, if an invalid usename/password is being used

– If the error is similar to “Destination not available” or “Destination Time-Out”

• Try to ping the MSSQL computer’s IP address from the tManager. Go to the xATM Managersoftware and select Administration Network Network Diagnostics Ping

• If the Ping isn’t successful, possibly your Windows Firewall was not configured to allow communication with the MSSQL port

• To adjust your firewall, and double-check other MSSQL setting that need to be set correctly, reference the Configuring MSSQL for Communication with a tManager or xCoupler document which is found in the OLDI Knowledgebase (http://kb.oldi.com). You may have to involve your IT department

• If the validation is successful, but you can’t enumerate, verify that the user has sufficient rights (must be a Project Editor or Administrator)

Page 37: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Network Diagnostics

• The Network Diagnostics pane in the xATM Manager software allows you to run network diagnostics on the tManager appliance

• The diagnostics are from the point of view of the tManager

– For example, a Ping of a host computer indicates if the tManager module is communicating with the computer

• Available Diagnostics:

– Ping

– Trace route

– Path ping

– IPConfig

• Also available on the Network screen:

– Network Snooper

– Network Routes (mainly for IT use)

Page 38: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Cross-Reference Export

• To create a Cross-Reference Export, launch the Project Editor software, go to the Application drop down list and select Export Cross-Reference

• This report is often used as part of the system documentation

• The cross references are stored in a comma separated (CSV) file that can be easily viewed using programs such as Microsoft Excel

• For each object in the appliance, the CSV file will show where the object is used in all of the tManager projects. Information for the following objects is included:– Tag – Database Column – XML Schema Element – ASCII Schema Entry – Binary Schema Entry – Prototype – Trigger – Map – Message Path – Endpoint

Page 39: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Spare Options

• Spare Compact Flash/ CF (56eATM-tManager-SPARE_CF)

– Only OLDI compact flashes may be used in a tManager appliance, and they cannot be opened or copied by other devices

– When the tManager backup file is Restored to the Spare CF, a Temporary Key is automatically generated. This Temporary Key will be valid for 10 days. After that, the tManager's triggers will stop firing.

– A Permanent Key needs to requested from OLDI. The preferred method is via an OLDI Service Request.

• Spare module (56eATM-tManager-SPARE)

– If the original module's CF is used in the Spare Module, when the backup file is Restored the Original License Key will be automatically loaded from the backup file. No further actions related to the License Key are required.

– If the Spare Module's CF is used, when the backup file is Restored a Temporary Key will be automatically generated. This Temporary Key will be valid for 10 days. After that, the tManager's triggers will stop firing.

• A Permanent Key needs to requested from OLDI. The preferred method is via an OLDI Service Request.

• Fully licensed tManager appliance

– When the tManager backup file is Restored to the Fully Licensed Spare Module, select Yes when asked "Do you want to preserve the current valid license on the module?" If you don't, the Spare Module's license will be over-written.

• If you accidentally answer No, contact OLDI to get the Permanent Key restored

Page 40: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Where to Get Additional Information / Help

• Access context-sensitive Help by pressing [F1] from within the Project Editor or xATM Manager software programs

• Go to the Knowledgebase at http://kb.oldi.com

• If you cannot find what you are looking for in the Knowledgebase or Online Help, or need assistance with any of our products, connect Support:

– Service Request: Go to www.softing.us. Select the Support tab and click on the Submit a Service Request

– Phone: 1-855-406-0106

– Email: [email protected]

Page 41: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Softing Sales Contacts

Scott Sibenac Jim Ralston Pete Desmarais Christophe Renard

Regional Sales –

Western & Mexico

Regional Sales –

Eastern US &

Canada

WireXpert Business

Manager

Regional Sales –EMEA

& Asia Pacific

+1 214-755-1905 +1 724-554-8498 +1 603-289-3691 +34 93 241 47 05

[email protected] [email protected] [email protected] [email protected]

Page 42: tManager Troubleshooting - ODM...• DEBUG -- will see all the messages, plus additional messages that may be helpful with troubleshooting. Don’t keep DEBUG selected long-term as

© 2015 Softing Inc. All Rights Reserved.

Resources

• Softing US Web– Softing US main website: http://www.softing.us/ra

– To place an order http://www.softing.us/contact/

– Product information http://www.softing.us/products/

– Knowledge Base http://kb.oldi.com

– Service Request https://ssl.oldi.com/ecustomer_enu

• Phone & FAX– In the US: 800-625-8678

– International: +1-865-251-5252

– FAX: +1-865-579-4740

• Address– Softing Inc.

– 7209 Chapman Hwy

– Knoxville, TN 37920

• Rockwell Web– Softing’s Encompass Listing http://www.ab.com/db/encompass/bps_ext.SEARCH

– Knowledge Base https://rockwellautomation.custhelp.com

(Softing reposts many Knowledge Base articles in Rockwell’s Knowledge Base)