simatic technical support - siemens & support answers for industry ... simatic technical support...

Service & Support

Answers for industry.

Cover sheet

SIMATIC Technical SupportExtended Diagnostics in PCS 7 and WinCC Plants

Diagnostic tools June 2014

2Extended Diagnostics in PCS 7 and WinCC Plants

V 2.6 Entry ID: 48698507

This entry is from the Siemens Industry Online Support. The general terms of use(http://www.siemens.com/terms_of_use) apply.

Securityinforma-tion

Siemens provides products and solutions with industrial security functions thatsupport the secure operation of plants, solutions, machines, equipment and/ornetworks. They are important components in a holistic industrial securityconcept. With this in mind, Siemens’ products and solutions undergo continuousdevelopment. Siemens recommends strongly that you regularly check forproduct updates.

For the secure operation of Siemens products and solutions, it is necessary totake suitable preventive action (e.g. cell protection concept) and integrate eachcomponent into a holistic, state-of-the-art industrial security concept. Third-partyproducts that may be in use should also be considered. For more informationabout industrial security, visit http://www.siemens.com/industrialsecurity.

To stay informed about product updates as they occur, sign up for a product-specific newsletter. For more information, visithttp://support.automation.siemens.com.

http://www.siemens.com/terms_of_use

http://www.siemens.com/industrialsecurity

http://support.automation.siemens.com/

Contents

Extended Diagnostics in PCS 7 and WinCC PlantsV 2.6, Entry ID:48698507 3

Contents1 Overview............................................................................................... 41.1 Motivation ............................................................................................. 41.2 Overview of Diagnostics Options ......................................................... 41.3 Requirements for Extended Diagnostics of PCS 7 and WinCC

Plants.................................................................................................... 61.3.1 Software Components .......................................................................... 6

2 Configuration of Diagnostics ................................................................ 82.1 Dr. Watson ........................................................................................... 82.2 User Mode Process .............................................................................. 92.2.1 Processes to be monitored................................................................. 142.3 Script Diagnostics (APDIAG) ............................................................. 162.4 Windows Performance Monitor .......................................................... 182.5 SIMATIC Batch Trace ........................................................................ 26

3 Tools ................................................................................................... 303.1 SIMATIC Diagnostics Tool ................................................................. 303.2 Windows Problem Steps Recorder (PSR) ......................................... 313.2.1 Start the Windows Problem Steps Recorder...................................... 313.2.2 Make recordings ................................................................................. 32

4 Archiving the Diagnostics ................................................................... 334.1 Acquisition of Local Diagnostics Data ................................................ 33

5 Literature ............................................................................................ 355.1 Bibliography ........................................................................................ 355.2 Internet Links ...................................................................................... 35

6 History ................................................................................................ 366.1 Version Overview ............................................................................... 36

1 Overview


V 2.6 Entry ID: 48698507

1 Overview1.1 Motivation

Proper evaluation of qualified status data is necessary for successful diagnosticsand resulting actions.The aim is to improve the quality diagnostics results and therefore theircomparability by applying automatic, uniform diagnostics.

The advantages of this diagnostics concept are the following: Standardized and automatic acquisition of diagnostics data Permanent and comprehensive diagnostics Integration of the diagnostics tool without causing interference of production

operations The diagnostics data is available as soon as an event occurs Diagnostics of the Windows process level

1.2 Overview of Diagnostics Options

The following figure shows an overview of the tools to be configured.

Figure 1-1

1 Overview


Dr. WatsonDr. Watson logs data after a program error. Creating a log file Creating a crash memory dump

User Mode ProcessThe "User Mode Process Dumper" monitors the processes set and creates amemory dump in the event of an error.

Script Diagnostics (APDIAG)Diagnostics tool for in-depth and effective analysis of script errors. Runtime monitoring for determining script errors. Support in analyzing errors and performance problems.

Windows Performance MonitorThe system monitor (performance monitor) integrated in the Windows operatingsystem is designed to detect resource bottlenecks in the system. Detailed monitoring of the operating system resources used. Cyclic recording of system resources.

SIMATIC Batch TraceAfter activation, a log of the batch processes is stored continuously.

SIMATIC Diagnostics ToolThe "SIMATIC Diagnostics Tool" acquires diagnostics and system data for service,support and maintenance. The tool can be run locally on a computer, but can alsoacquire diagnostics data from other computers via remote access in distributedsystems. Acquisition of diagnostics data. Acquisition of system data. Archiving of acquired data sorted according to computer in the ZIP format. Transfer of central data via the integrated ftp service.

Windows Problem Steps Recorder (PSR)With "Windows Problem Steps Recorder" you can record your procedure which ledto a fault. A recording includes the following components: Text describing the elements that you click with the mouse Screenshots at the time of each click

1 Overview


V 2.6 Entry ID: 48698507

1.3 Requirements for Extended Diagnostics ofPCS 7 and WinCC Plants

1.3.1 Software Components

Standard software components

Table 1-1

Components Version Note

Windows 2000Windows XPWindows Server 2003PCS 7 V6 V 6.x Includes WinCC V 6.0PCS 7 V7.0 V 7.0 Includes WinCC V 6.2PCS 7 V7.1 V 7.1 Includes WinCC V 7.0WinCC V6 V 6.xWinCC V7 V 7.x

Tools and diagnostics software

Table 1-2

Components Version Note

User Mode Process Dumper 8.1 Link: User Mode Process DumperAPDIAG ..\Siemens\WinCC\utools\apdiag.exePerformance Monitor ..\Windows\system32\perfmon.exeTemplates (Performance Monitor) "DiagAllCountersClient.htm"

"DiagAllCountersServer.htm""CPUPeakCheck.htm"

Trace Configuration Editor ..\Program Files\SIEMENS\Common\bin\pcs7commontracecontrolx.exe

SIMATIC Diagnostics Tool DVD SIMATIC PCS 7..\Additional_Products\SDT_”Version”\

orLink: SIMATIC Diagnostics Tool

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=E089CA41-6A87-40C8-BF69-28AC08570B7E&displaylang=en

http://support.automation.siemens.com/WW/view/en/65976201

1 Overview


User rights and releasesThe user requires administrator rights on the target system for installation andsetting up.

Hard disk spaceAt least 3 GB of memory are required on your hard disk for the diagnostics data.The storage path is defined as "D:\Siemens\Diagnostics".

This storage path is used by the "User Mode Process" and "Windows Performance Monitor"tools and the "SIMATIC Diagnostics Tool".

LimitationThis diagnostics concept does not include a description of the Engineering tools PCS 7 and WinCC

Basic knowledge of these topics is prerequisite.

2 Configuration of Diagnostics


V 2.6 Entry ID: 48698507

2 Configuration of DiagnosticsTo fulfill the requirements for comprehensive diagnostics it is recommended tomake all the settings described in this chapter.

2.1 Dr. Watson

Below we describe how to set "Dr. Watson" as the default debugger.

Table 2-1

No. Procedure

1. Execute Start > Run.... Enter DRwtsn32 -i and start the procedure with OK.

2. Again select Start > Run... and again enter DRwtsn32 and again start the procedure withOK.

3. Set the crash dump to Full.



2.2 User Mode Process

The instructions below are for installing and using the User Mode Process Dumperin WinCC and PCS 7.After activation, a memory dump of a process is made in the event of an error.

Table 2-2

No. Procedure

1. Download the User Mode Process Dumper version V8.1 from the Microsoft internet site andinstall the user dump tool in "C:\kktools\userdump8.1".

2. Switch to the "C:\kktools\userdump8.1" directory.Start the "setup.exe" of the User Mode Process Dumper from the folder corresponding to youroperating system (ia64, x64 or x86). In the next window you click the"Next" button.



V 2.6 Entry ID: 48698507

3. In the "Terminate Mode" window you select the option "Disable "Dump on ProcessTermination" feature" and confirm with the "Next" button.

4. Now, in the "Confirmation" window you click the "Finish" button to complete the installation.

5. Acknowledge the next message with "Yes" to open the configuration of the "User Mode ProcessDumper".



6. In the "User Mode Process Dumper Properties" window you open the default rules andrequirements window with the"Default Settings…" button.



V 2.6 Entry ID: 48698507

7. In the "Default Exception Rules" window you set the rules as shown in the screenshot belowand define the storage path of the dump as"D:\Siemens\Diagnose\Dumps".It might be necessary to create a new directory.

Close the window with "OK".

Note:These settings are used for all processes in which no "Custom Rules" are activated.The "dump files" are acquired by the "SIMATIC Diagnose Tool" from this predefined storagepath.



8. In the "User Mode Process Dumper Properties" window you use the"New" button to add a new item.

9. In the "Add Application to Monitor for Excepti…" window you enter the process name of theapplication in Table 2-3 respectively 2-4 that you wish to monitor in the “Application name:”field.

Close the window with“OK”.

10. Continue likewise with all the processes listed in Table 2-3 respectively 2-4. Here, a difference ismade as to whether the configuration is made on the OS server or OS client.

11. Once you have defined all the processes, you quite the “User Mode ProcessDumper” with “OK”.

12. You must restart the process concerned in each case for the settings to becomeeffective. For this you restart the PC.



V 2.6 Entry ID: 48698507

2.2.1 Processes to be monitored

When selecting the processes, a difference is made between OS server and OSclient.

OS server

With the OS server you add the following processes to the User Dump Tool.

Table 2-3

Process Description

CCAgent.exe Monitors the network in which the WinCC station is located. Used byNetCC.

CCAlgRtServer.exe WinCC Alarm Logging Runtime ServerCCArchiveManager.exe WinCC Archive ManagerCCDeltaLoader.exe Logs the changes made in a project.CCEClient.exe Central communication.CCEServer.exe Central communication.CCLicenseService.exe License monitoringCCProjectMgr.exe Project ManagerCCPtmRTServer.exe Picture Tree ManagerCCRtsLoader.exe Loader for WinCC Data ManagerCCSsmRTServer.exe Base data management for RuntimeCCTextServer.exe Text ServerCCTlgServer.exe WinCC Tag Logging Runtime ServerCCWriteArchiveServer.exe Archive Server called at least three times for ALG, TLG fast and TLG2

slow archiving.

Gscrt.exe Global Script - RuntimePdlRt.exe Graphics - RuntimeRebootx.exe PCS7 Reboot BoxRedundancyControl.exe WinCC Redundancy ControlRedundancyState.exe WinCC Redundancy Statescript.exe Background processing of actions / functions

WARNING In the case of blocking, manual dumps of the processes “PdlRt.exe” and“script.exe” must be made before restarting the computer. More information ongenerating manual dumps is available in our Entry ID:http://support.automation.siemens.com/WW/view/en/45020870




OS clientWith the OS server you add the following processes to the User Dump Tool.

Table 2-4

Process Description

CCDmIVarProxyServer.exe Ivar2 Proxy – data manager accessCCEClient.exe Central communication.CCEServer.exe Central communication.CCNSInfo2Provider.exeCCPtmRTServer.exe Picture Tree ManagerCCSsmRTServer.exe Base data management for Runtimegscrt.exe Global Script - RuntimePassDBRT.exe User Administrator - RuntimePdlRt.exe Graphics - RuntimeRedundancyState.exe WinCC Redundancy Statescript.exe Background processing of actions / functionsSFCRT.exe Visualization of SFCsSopcsrvrwincc.exe SIMATIC OPC Server

WARNING In the case of blocking, manual dumps of the processes “PdlRt.exe” and“script.exe” must be made before restarting the computer. More information ongenerating manual dumps is available in our Entry ID:http://support.automation.siemens.com/WW/view/en/45020870

NoteUsing the User Mode Process described does not affect the normal operation ofthe software and hardware.However, when using a dump event, might lead to temporary loss ofperformance and changes to the system timing.




V 2.6 Entry ID: 48698507

2.3 Script Diagnostics (APDIAG)

The instructions below are for installing and using “ApDiag.exe” in WinCC and PCS7.After activation, in the event of an error the diagnostics data is stored in a file via adefault function of WinCC.

Table 2-5

No. Procedure

1. Open “Apdiag.exe” in the “..\Siemens\WinCC\Utools” folder.

2. In the menu bar click “Diagnostics”, and then in the drop-down menu click “Start”.Enable the option “Start automatically with start of WinCC” and then select“LEVEL_3”. In this way diagnostics is started each time you open a project.

Close the window with“OK”.



3. In the menu bar you click “Diagnostics”, and then in the drop-down menu click “OnFile”.Make the settings as below.

With the “OnErrorExecute -> Error in File” parameter you set that the output of anOnErrorExecute is made in the “OnErrorN.txt “ file in the“..\Siemens\WinCC\Diagnose” directory.Close the window with “OK”.



V 2.6 Entry ID: 48698507

2.4 Windows Performance MonitorThe instructions below are for installing and using the Performance Monitor inWinCC and PCS 7.After activation, a performance log is stored continuously.Here, the storage, handle and CPU time of the performance indicators defined inthe templates “DiagAllCountersClient.htm” and “DiagAllCountersServer.htm” areused.The incorporation of the “CPUPeakCheck.htm” template generates an event entrywhen the CPU load of 95% is exceeded.

Table 2-6

No. Action Remark

1. Start the Performance Monitor with Start > Run… . Enter “perfmon” and start theprocedure with OK.

2. Open the menu item“New Log Settings From…”in the “CounterLogs” submenu.

Use the appropriate templates (*.htmfiles) for the log settings in Table 1-2 .

3.



No. Action Remark

4. Select the profile concerned from the prepared templates in accordance with the type ofcomputer.“DiagAllCountersClient.htm” for a WinCC client.“DiagAllCountersServer.htm” for a WinCC server.

Close the dialog box with “Open”.

5. Accept the specified name for the setting.

Confirm the entry with “OK”.

DiagAllCountersServerDiagAllCountersClient



V 2.6 Entry ID: 48698507

No. Action Remark

6. The import makes the basic settings below.Storage path for the log file:“D:\Siemens\Diagnostics\DiagAllCountersServermmddmmhh.blg

The log files are acquired by theSIMATIC Diagnose Tool from thispredefined storage path.

Tab: “General”



No. Action Remark

Tab: “Log Files”

7. In the “Configure Log Files” dialog the limit of the log files is set to “1024 MB”.

Click “OK” to close the settings.



V 2.6 Entry ID: 48698507

No. Action Remark

8. In the “Schedule” tab the “Start log” time is to be set in the past and the “Stop log” time is tobe set in the future.

Click “OK” to close the settings.

9. The performance log is started automatically. The icon changes to green.



Event log entriesHow to parameterize the settings of an event log entry is described below.

Table 2-7

No. Action Remark

1. Open the menu item“New Alert Settings From…” in the “Alerts” submenu.

2. Open the menu item“New Alert Settings From…”.

Use the template“CPUPeakCheck.htm” for the logsettings in Table 1-2.

3. Accept the specified name for the setting.

Confirm the entry with “OK”.

CPUPeakCheck



V 2.6 Entry ID: 48698507

No. Action Remark

4. Accept the settings with “OK”.

5. The alarm configuration starts automatically, the icon changes to green.

The icon changes to green.6. Close the Performance Monitor.



WARNING The performance log and the alarm configuration are restarted automaticallywhen the PC is restarted.A new log file is created. Note that this occupies additional hard disk space. Youcan delete log files that are no longer needed in “D:\Siemens\Diagnostics”.If you terminate the performance log or alarm configuration manually with the“STOP” button, the preset times for logging are set to “Manual”. Then you mustthe times again as in Table 2-6 No. 8, otherwise the logging is not restartedautomatically.



V 2.6 Entry ID: 48698507

2.5 SIMATIC Batch Trace

The instructions below are for installing and using SIMATIC Batch Trace in WinCCand PCS 7 with the SIMATIC Batch option.Depending on the installation, the “Trace Configuration Editor” is in one of theprogram paths below...\Program Files\CommonFiles\SIEMENS\bin..\Program Files\SIEMENS\Common\bin

Table 2-8

No. Action Remark

1. In the Windows Explorer double-click“pcs7commontracecontrolx.exe” to start the TraceConfiguration Editor.

The Trace Control Panel opens.



No. Action Remark

2. Activate “Enable Log” and click “Switches…”. The Trace Configuration Editor opens.

3. Select the “API – Batch Api” item >> right-click >>“Modify Selection (recursive)”.

Now the Trace Source Settings boxopens.



V 2.6 Entry ID: 48698507

No. Action Remark

4. Activate the option “Enable, E, W, I, C, D”.Close the dialog with “OK”.

5. Save the settings in the Trace Configurator with“Store”.Acknowledge the message with “OK”.



No. Action Remark

6. Close the Trace Control Panel with “OK”.

7.

3 Tools


V 2.6 Entry ID: 48698507

3 Tools

3.1 SIMATIC Diagnostics Tool

The SIMATIC Diagnostics Tool presented here is to be stored on the PC and sothat it can be activated as required.The latest versions and configuration instructions are available here:http://support.automation.siemens.com/WW/view/en/65976201


3 Tools


3.2 Windows Problem Steps Recorder (PSR)

WARNING Only the clicks you have made are recorded. If you make essential inputsduring the recording, you must add these via the Comments function.

This Windows function is supported by Windows 7 onwards.

3.2.1 Start the Windows Problem Steps Recorder

Table 3-1

No. Procedure

1. Click the "Start" button and enter "psr" in the Search Bar.2. Click "psr.exe" in the list of results.

The "Windows Problem Steps Recorder" opens.

3 Tools


V 2.6 Entry ID: 48698507

3.2.2 Make recordings

Table 3-2

No. Procedure

1. Click "Start Record".

2. Perform the steps which you want to record.You can use "Pause Record" at any time to stop the recording and "Resume Record" tocomplete the recording later.

3. Additional information about recording inputs: Click "Add Comment". Mark the area in which you are making the input. Describe your procedure in the Comment field. Click "OK“ and continue your recording.

4. Click "Stop Record" when your recording is complete.The "Save as" dialog opens.

5. Select the directory and a name.6. Click "Save" to save the recording.

4 Archiving the Diagnostics


4 Archiving the Diagnostics4.1 Acquisition of Local Diagnostics Data

Below we describe how to use the SIMATIC Diagnostics Tool to acquire data.Data acquisition can be done locally on a single system.

Table 4-1

No. Procedure

1. Start the “SIMATIC Diagnostics Tool” by double-clicking “SimaticDiagnosticsTool.exe” in“..\Program Files\Siemens\WinCC\uTools\SDT_2010_1”

2. Use the “Open File” button to download the configuration created in Chapter 3.

3. Click the “Get Information” button to start acquiring all the configured data.

The acquisition procedure starts and the status is displayed.

4 Archiving the Diagnostics


V 2.6 Entry ID: 48698507

No. Procedure

4. The message below indicates that the acquisition procedure has been completedsuccessfully.

5. The data packets are located in the storage path “D:\Siemens\”.

5 Literature


5 Literature5.1 Bibliography

This list is by no means complete and is only a selection of relevant literature.Table Error! Use the Home tab to apply Überschrift 1 to the text that you want to

appear here.-1

Subject area Title

/1/ PCS 7Diagnostics

SIMATIC Process Control System PCS 7 V7.0 PCS 7 –Service Support and Diagnostics

/2/

5.2 Internet Links

This list is by no means complete and is only a selection of relevant information.Table Error! Use the Home tab to apply Überschrift 1 to the text that you want to

appear here.-2

Subject area Title

\1\ Reference toentry

http://support.automation.siemens.com/WW/view/en/22089969http://support.automation.siemens.com/WW/view/en/23486418

\2\ SiemensCustomer Support

http://support.automation.siemens.com

\3\ SIMATICDiagnostics Tool




http://support.automation.siemens.com/


6 History


V 2.6 Entry ID: 48698507

6 History6.1 Version Overview

Table Error! Use the Home tab to apply Überschrift 1 to the text that you want toappear here.-1

Version Date Change

V2.0 07.12.2010 Second editionV2.1 19.01.2011 Maintenance in compliance with system testV2.2 28.01.2011 Inclusion of review commentsV2.3 01.02.2011 Section 2.2.1 changedV2.4 01.04.2011 Redundancy Control removedV2.5 15.04.2011 Chapter 2.2.1 added with link on entry 45020870V2.5.1 25.05.2011 English screenshots added

.NET component deselected for the SIMATIC Diagnose Toolxml profiles changed

V2.6 12.06.2014 Security Note addedNew chapter about Windows Problem Step RecorderContent on SIMATIC Diagnostics Tool updated

simatic technical support - siemens & support answers for industry ... simatic technical support...

Documents