Artesyn ATCA-7370 User Manual

ViewCheck on ATCA-7370

Installation and Use

P/N: 6806800S48B
April 2014

©

Copyright 2014 Artesyn Embedded Technologies, Inc.

All rights reserved.

Trademarks

Artesyn Embedded Technologies, Artesyn and the Artesyn Embedded Technologies logo are trademarks and service marks of
Artesyn Embedded Technologies, Inc.© 2014 Artesyn Embedded Technologies, Inc. All other product or service names are the
property of their respective owners.

Intel® is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.

Java™ and all other Java-based marks are trademarks or registered trademarks of Oracle America, Inc. in the U.S. and other countries.

Microsoft®, Windows® and Windows Me® are registered trademarks of Microsoft Corporation; and Windows XP™ is a trademark of
Microsoft Corporation.

PICMG®, CompactPCI®, AdvancedTCA™ and the PICMG, CompactPCI and AdvancedTCA logos are registered trademarks of the PCI
Industrial Computer Manufacturers Group.

UNIX® is a registered trademark of The Open Group in the United States and other countries.

Notice

While reasonable efforts have been made to assure the accuracy of this document, Artesyn assumes no liability resulting from any
omissions in this document, or from the use of the information obtained therein. Artesyn reserves the right to revise this document
and to make changes from time to time in the content hereof without obligation of Artesyn to notify any person of such revision or
changes.

Electronic versions of this material may be read online, downloaded for personal use, or referenced in another document as a URL to
an Artesyn website. The text itself may not be published commercially in print or electronic form, edited, translated, or otherwise
altered without the permission of Artesyn.

It is possible that this publication may contain reference to or information about Artesyn products (machines and programs),
programming, or services that are not available in your country. Such references or information must not be construed to mean that
Artesyn intends to announce such Artesyn products, programming, or services in your country.

Limited and Restricted Rights Legend

If the documentation contained herein is supplied, directly or indirectly, to the U.S. Government, the following notice shall apply
unless otherwise agreed to in writing by Artesyn.

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3) of the Rights in
Technical Data clause at DFARS 252.227-7013 (Nov. 1995) and of the Rights in Noncommercial Computer Software and
Documentation clause at DFARS 252.227-7014 (Jun. 1995).

Contact Address

Artesyn Embedded Technologies

Marketing Communications

2900 S. Diablo Way, Suite 190

Tempe, Arizona 85282

Contents

About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.2 ViewCheck Access Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.2.1 CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.2.2 XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2 Concepts of ViewCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.2 Test Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.3 Device Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.4 Test ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.5 Device Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2.6 Monitor ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.7 Error ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3 License Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3.2 Orion License RPM Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.3 Obtaining the Activation Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.4 Verifying the Installation of a Value-added Software Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3.5 Returning the License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

4 Installation of ViewCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.2 ViewCheck RPM Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.3 BSF Service RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

4.4 ViewCheck Service OS Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

4.5 Access and Execution of a Test Using CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

4.6 Access and Execution of a Test Using XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

4.6.1 Authenticate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

4.6.2 Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

3

4.6.3 GetClassList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

4.6.4 DescribeClass. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

4.6.5 InvokeMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

4.7 ViewCheck Service LOG Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5 Commands Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.2 Generic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.2.1 device-category. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.2.2 list-device-instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.2.3 hw-inventory-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.2.4 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.2.5 show-log-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.2.6 purge-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.2.7 purge-all-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

5.2.8 show-systemerror-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

5.3 Test Management and Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.3.1 start-test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.3.2 show-test-help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

5.3.3 list-tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5.3.4 show-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5.3.5 show-test-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

5.3.6 stop-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

5.4 Monitoring Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.4.1 show-monitor-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.4.2 show-poll-interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

5.4.3 show-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

5.4.4 show-upper-threshold-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

5.4.5 start-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

5.4.6 set-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

5.4.7 set-upper-threshold-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

5.4.8 set-threshold-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.4.9 set-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

5.4.10 set-poll-interval-default. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5.4.11 stop-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

4

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5.4.12 set-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.4.13 show-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.4.14 show-networkcounter-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

5.4.15 show-networkerror-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.4.16 exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.5 InService Monitoring Specifics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.5.1 Monitoring HW Device Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.5.2 Monitoring Device Critical Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

5.6 OOSD Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

5.6.1 CPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

5.6.2 HDD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

5.6.3 Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.6.4 OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.6.5 PCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.6.6 IPMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.6.7 NETWORK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.6.8 FPGA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.6.9 I2C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.6.10 USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

A Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

A.1 Artesyn Embedded Technologies - Embedded Computing Documentation . . . . . . . . . . . . . . . . 83

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5

6

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

List of Tables

Table 4-1 RPM Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Table 4-2 ViewCheck Service OS Image Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Table 5-1 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Table 5-2 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Table 5-3 purge-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Table 5-4 start-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Table 5-5 show-test-help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Table 5-6 show-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Table 5-7 show-test-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Table 5-8 stop-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Table 5-9 show-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Table 5-10 show-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Table 5-11 show-upper-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Table 5-12 start-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Table 5-13 set-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Table 5-14 set-upper-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Table 5-15 set-threshold-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Table 5-16 set-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Table 5-17 set-poll-interval-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Table 5-18 stop-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Table 5-19 set-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Table 5-20 show-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Table 5-21 Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Table A-1 Artesyn Embedded Technologies - Embedded Computing Publications . . . . . . . . . . . . . . . 83

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

7

List of Tables

8

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

About this Manual

Overview of Contents

This guide provides detailed information about installation, configuration, and how to work
with ViewCheck. The following table gives the list of chapters described in this document.

Chapter Description

About this Manual Lists all conventions and abbreviations used in this manual and

Introduction Provides detailed overview and features of ViewCheck.

Concepts of ViewCheck Describes the concepts of ViewCheck.

License Management Provides information about ViewCheck license management.

Installation of ViewCheck Provides instructions to install ViewCheck.

Commands Execution Describes about the various tests that can be executed in

outlines the revision history.

ViewCheck.

Appendix A, Related

Documentation

Abbreviations

The following tables lists the abbreviations used throughout the document.

Abbreviation Definition

ATCA Advanced Telecom Computing Architecture

BSF Blade Services Framework. A derivative of System Services

CLI Command Line Interface

Client The applications used to Access ViewCheck via the various

HW Hardware

Lists the relevant manuals and provides additional information.

Framework.

Interfaces (CLI and XML)

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

9

Abbreviation Definition

INSM In Service Monitoring. Functional module in ViewCheck

OOSD Online Out of service Diagnostics. Functional module in

XML Extensible Markup Language

SOL Serial Over LAN

Conventions

The following table describes the conventions used throughout this manual.

Notation Description

About this Manual

About this Manual

framework handling the monitoring functionality of
various critical parameters in the blade.

ViewCheck framework that manages Test Management
requests related to Out of Service Diagnostics.

10

0x00000000 Typical notation for hexadecimal numbers (digits are

0 through F), for example used for addresses and
offsets

0b0000 Same for binary numbers (digits are 0 and 1)

bold Used to emphasize a word
Screen Used for on-screen output and code related elements

or commands in body text

Courier + Bold Used to characterize user input and to separate it

from system output

Reference Used for references and for table and figure

descriptions

File > Exit Notation for selecting a submenu

<text> Notation for variables and keys

[text] Notation for software buttons to click on the screen

and parameter description

... Repeated item for example node 1, node 2, ..., node

12

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Notation Description

About this Manual

.

.

.

.. Ranges, for example: 0..4 means one of the integers

| Logical OR

Omission of information from example/command
that is not necessary at the time being

0,1,2,3, and 4 (used in registers)

Indicates a hazardous situation which, if not avoided,
could result in death or serious injury

Indicates a hazardous situation which, if not avoided,
may result in minor or moderate injury

Indicates a property damage message

No danger encountered. Pay attention to important
information

Summary of Changes

Part Number Date Description

6806800S48A

6806800S48B April, 2014 Re-branded to Artesyn template.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

October, 2013 Initial version

11

About this Manual

About this Manual

12

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Introduction

1.1 Overview

ViewCheck is a comprehensive software service that can be used to diagnose, manage, and
monitor Artesyn ATCA blades. The diagnostic utilities of ViewCheck help in identifying,
detecting, and locating hardware issues on a blade. ViewCheck also provides mechanism to
monitor status of CPU temperature, Storage devices, Ethernet counters and errors.

ViewCheck can be accessed locally using CLI and XML interfaces provided via Blade Services
Framework (BSF) service.

ViewCheck can provide both:

 InService diagnostics

 Out of Service diagnostics

InService Diagnostics
In this mode, the diagnostics service can run while the blades are instantiated with customer
applications and providing service.

Chapter 1

ViewCheck can monitor key hardware parameters like CPU temperature, Network Counters,
Network errors, and in addition to watching out for kernel critical errors logged by various
hardware devices and device drivers.

Out of Service Diagnostics
In this mode, a service OS is provided with various Out of Service Diagnostics tests and utilities.
This Service OS has to be loaded and diagnostics utilities can be executed. To execute these
tests, CLI /XML access is provided.

Both InService and Out of Service are provided as binary images. For more information on
Binary images and installation procedures, refer Installation of ViewCheck on page 29.

For more information on commands supported for InService and OOS, refer Commands

Execution on page 51.

1.2 ViewCheck Access Methods

This section explains the different methods to access ViewCheck services on the Artesyn ATCA
blades.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

13

You can access ViewCheck using the following interfaces.

 CLI

 XML

Using these interfaces, you can

 Initiate a diagnostic test

 Query available diagnostic tests

 Query status of a particular diagnostic test

 Start and stop monitoring

 Stop a diagnostic test

1.2.1 CLI

Introduction

CLI is one of the interfaces provided to access the ViewCheck capabilities on the blade. Using
CLI, you can start, stop, and query kind of primitives at this prompt. The ViewCheck CLI can be
accessed via a console using SSH (or) Serial over LAN (SOL).

Blade Services Framework, a proprietary service of Artesyn, is used to provide the CLI access to
ViewCheck service. BSF binaries are provided along with the ViewCheck binaries.

For more information on BSF RPMs and Installation procedures, refer Installation of ViewCheck

on page 29.

1.2.2 XML

XML is also one of the primary interfaces to access ViewCheck capabilities on the blade. XML
interface supports methods, classes, and event notification mechanism. Using XML, you can
start, stop, query, and configure the parameters related to tests and monitors. XML interface
can be accessed in the same manner as CLI and is provided by BSF.

14

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Introduction

In addition, XML notifications are generated with details:

 State changes about the diagnostic test under execution

 Pre-determined monitor crossing set Threshold value

 Occurrence of any pre-determined hardware device error/warning generated by the

device driver (or) the kernel on the blade.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

15

Introduction

16

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Concepts of ViewCheck

2.1 Overview

Terminology and keywords used extensively in ViewCheck services and available via the
commands are explained briefly here.

2.2 Test Identification

Unique Test identification is based on following triple key:

< Device Category, Test ID, Device Instance >

2.3 Device Category

The Device Category is an enumerated value, reused from similar enumeration already defined
in HPI-B Standard specification.

Chapter 2

Expresses commonly known device categories like Storage, Network, Serial, CPU, Memory,
and so on, which are available on all blades irrespective of function and architecture. This
category is used in commands as one of the key fields to identify uniquely a particular test.

Device Category allows for:

 Grouping of test cases per category for display and statistical purposes

 Allows reuse of Test IDs across device categories

2.4 Test ID

Test ID is an integer value that uniquely identifies the actual test that could be invoked or
executed on a Hardware Device Instance, which belongs to a specific Device Category already
defined above and available on the blade.

Following are the example of tests that can be executed on the devices:

 Ping Flood test

 Network connectivity test in case of Network Device Category

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

17

 Bad Blocks test in case of Storage Device category

 Temperature tests in case of CPU categories

Each of these tests would be associated with a unique Test Identifier (Test ID).

These Test IDs start with value of (0) and would increase linearly for various sub-tests in a device
category.

Some tests may be applicable to all device instances in a particular Device category. The
combination of <Device category, Test ID, Device Instance> would be unique and shall provide
capability to control, execute, and manage the test on a Device Instance in a Device category.
With this mechanism, same test can be simultaneously started or triggered on multiple Device
Instances under that device category, thus providing parallel execution of tests.

2.5 Device Instance

Concepts of ViewCheck

Hardware devices uniquely identified and recognized by the drivers and OS on the blade are
treated as device instances. A device instance can belong to a particular device category
described above. Tests can be invoked and executed on this device instance. OS and Driver
support to access the device is assumed to be readily available.

For example, device instances eth0, eth1, eth2 or Base 0, Base 1, Base 2 are used to identify
unique devices in networking devices category. Similarly, hda1, hda2, and so on can identify
unique instances of devices in the storage category. Device instances use the standard
nomenclature already defined by the OS (for instance Linux) on the blade.

A diagnostic test identified by triple < Device Category, Test ID, device Instance> would be
invoked (or) executed on the unique device instance.

The Enumerations mentioned below are used extensively in the context of InService
Monitoring.

18

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

2.6 Monitor ID

ViewCheck Service monitors pre-identified parameters for hardware devices. These
parameters are CPU Core temperature, CPU frequency, Network Device counters, Network
Device errors etc. To periodically poll and check these parameters the ViewCheck service uses
CLI and XML configuration. For each parameter of interest, a Monitor ID is an enumerated
constant that uniquely represents the Monitoring entity. This value shall be used by the
ViewCheck, to control monitoring and also while reporting events via XML on these monitors.

2.7 Error ID

This is an attempt to provide identification to list the pre-determined hardware device
errors/warnings generated by the device driver (or) the kernel on the blade. These critical and
error messages are an indication of abnormal behavior on part of the kernel or the hardware
device on the blade. ViewCheck functionality attempts to detect all such errors and would
provide suitable information to external high-level software intelligence to act upon.

Concepts of ViewCheck

The list of messages that constitute these errors is not standardized by the hardware device
Vendor (nor) the Linux Kernel Community. Error ID attempts to standardize all such messages
on Artesyn supported blades. These messages would be OS and driver specific. Mostly, the
same ERROR ID would be associated with the same category of error, across blades and OSs.
For more information on commands, refer to Commands Execution on page 51.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

19

Concepts of ViewCheck

20

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

License Management

3.1 Overview

The permissions to use any Artesyn value-added software module is granted based on the
licenses installed on ATCA-7370. To purchase license for a particular software module and to
get required instructions to use that module, contact Artesyn Sales team.

A license is node or blade locked, that is, it cannot be copied and used on another blade to
enable the value-added software module. You can obtain license for a module on a specific
blade and place the license on that blade. On reboot, the license is authorized and the module
is functionally enabled.

ViewCheck is available with two licenses:

1. Standard License: This is valid for 33 years.

2. Evaluation License: This is valid for 30 days.

Chapter 3

Figure 3-1 Product Activation Work Flow

1. Sales enters the order to buy "N" number of licenses.

2. This triggers configuration of licenses in License Server and generates the product key. You
will receive a product key via E-mail.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

21

3. Use the product key to create finger-print.

4. Upload the finger-print information to the server to get the activation record (license key).

5. Place the activation record at a predefined persistent location on the board.

6. Application checks the local activation record every time it runs to obtain the license limits
and the locking parameters.

3.2 Orion License RPM Installation

Using the following command, you can install the Orion License RPM on Board or Redhat x86
machine.

rpm -ivh orion-license.<BLADE>.<DISTRO>-<RELEASE>­<BUILD>.<ARCH>.rpm

License Management

3.3 Obtaining the Activation Record

After you purchase the licenses for a value-added software module, follow the steps
mentioned in this section to obtain the activation record.

Figure 3-2 Obtaining Activation Record

22

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

License Management

1. On purchasing a license, you will be sent an e-mail with the product key.

2. Using the product key, create a finger-print of the blade. Execute the platform specific
makeSystemPrint binary placed at /opt/bladeservices/bin/license/ with
the following commands.

 If you are generating the finger-print on a blade, then pick up the makeSystemPrint

binary from /opt/bladeservices/bin/license/x86_64/.

 If you are generating the finger-print on Redhat x86 machine, then pick up the

makeSystemPrint binary from /opt/bladeservices/bin/license/redhat­x86/ to the Redhat x86 machine.

 Run the following command before generating the finger-print on the blade using

makeSystemPrint binary:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/bladeservices/lib

Command Syntax

./makeSystemPrint -pProductName [-uUsername -aPassword] -kpubkey

-ddomkey [-bSerialNumber -mMACAddress]

Parameters Description

-pProductName Name of the product for which you want to obtain the license. For

ViewCheck on ATCA-7370, the product name is SL-DG7370-01-

001-STD. This is a mandatory parameter.

-uUsername * Username. Optional, if default user is chosen.

-aPassword * Password. Optional, if default user is chosen.

-kpubkey Public Key. The public key for ViewCheck is acpjEMw6Q6lDWL81.

This is a mandatory parameter.

-ddomkey * Domain key. This is a mandatory parameter.

-bSerialNumber Board SerialNumber. Optional, if on-blade finger-print is being

generated.

-mMACAddress Base MAC Address. Optional, if on-blade finger-print is being

generated.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

23

License Management

The information about parameters marked with ’*’ is provided to you upon placing the
order for ViewCheck software. For more information, please contact Artesyn’s sales
representative.

As license manager keeps track of the system time, tampering with the system date and time
hampers the functionality of the licensed software module.

Examples

 Sample command when executed on blade:

./makeSystemPrint -pSL-DG7370-01-001-STD -kacpjEMw6Q6lDWL81

-ddomkey > fp.key

24

 Sample command when executed on remote machine:

./makeSystemPrint -pSL-DG7370-01-001-STD -kacpjEMw6Q6lDWL81

-ddomkey -b10a02398 -m008011223344 > fp.key

Redirect the output of these commands to fp.key file as shown above. This is the finger­print of the blade software module for which license should be granted.

3. Upload the finger-print to the license server to obtain the activation record. The web link
of the server to obtain license key is given below:

https://enpec2.emerson.com/SwordsPhase2/excludes/licenseActivation.jsp

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

When you access this link, the following screen is displayed:

License Management

4. In the Product Name box, type name of the product. For example, SL-DG7370-01-001­STD.

5. Select the Finger-print file using the Browse button.

6. In the Image Text box, type the text that is displayed in the box.

7. Click Generate Activation Record to obtain the activation record.

8. Copy the activation record on to the blade at /opt/bladeservices/etc/license/
in the following format actrec_<PRODUCT IN CAPS>.key

For example, if the product is SL-DG7370-01-001-STD, then rename the file as
actrec_SL-DG7370-01-001-STD.key and copy it to the above location.

Take a backup of the activation record.

3.4 Verifying the Installation of a Value-added Software Module

To confirm that the activation record is accepted and the functionality is enabled, check the log
file at /var/log/emerson_license.log.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

25

When the license is granted for a module, the log message is as follows:

<Date and time> <Log priority>: <PRODUCT> : <PID>: License is valid

There are sufficient logs in the log file to know the status of the licensed software module. If the
functionality of a software module is not enabled, then the log file is updated with the reason
for rejecting the license.

3.5 Returning the License

You can return the license when:

 A value-added software module is not required on a blade any longer.

 The blade is not usable and the license need to be migrated to newer blade.

The following procedure describes how to return license of a software module on a blade:

License Management

Figure 3-3 Returning the License

1. To generate the receipt, execute the platform specific makereceipt binary placed in

/opt/bladeservices/bin/license/.

 If you are generating receipt on blade, then pick up the makereceipt binary from

/opt/bladeservices/bin/license/x86_64.

 If you are generating a receipt from Redhat x86 machine, then pick up the

makereceipt binary from /opt/bladeservices/bin/license/redhat­x86/.

Command Syntax

26

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

License Management

./makereceipt -pProductName [-aActivationRecord -iIHFfile]

Parameters Description

-pProductName Name of the product for which license is returned. For

ViewCheck on ATCA-7370, the product name is SL-DG7370-

01-001-STD. This is a mandatory parameter.

-aActivationRecord Absolute path of the Activation record. Optional, if

executed on the board.

-iIHF file

Examples

 Sample command when executed on blade:

./makereceipt -pSL-DG7370-01-001-STD

Absolute path of ihf file. Optional, if executed on the
board.

 Sample command when executed on remote machine:

./makereceipt -pSL-DG7370-01-001-STD

-a/root/license/actrec_SL-DG7370-01-001-STD.key

-i/root/license/SL-DG7370-01-001-STD_hfile.ihf

This command generates the receipt file, receipt_SL-DG7370-01-001-STD.key in
the local directory, from where the binary is executed.

2. Check the log file in /var/log/emerson_license.log. Once the receipt is

generated, the log message is as follows:

<Date and time> <Log priority>: <PRODUCT> : <PID>: Receipt
generated

3. Upload the receipt to the server to return the license. The web link of the server to return

the license is given below:

https://enpec2.emerson.com/SwordsPhase2/excludes/licenseReturn.jsp

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

27

When you access this link, the following screen is displayed:

License Management

28

4. In the Product Name box, type name of the product. For example, SL-DG7370-01-001-

STD.

5. Select the return receipt file using the Browse button.

6. In the Image Text box, type the text that is displayed in the box.

7. Click Return License. If successful, a message "License Returned Successfully" is displayed.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

4.1 Overview

This section explains the ViewCheck release modules and installation procedures to install and
run ViewCheck service on the Artesyn ATCA blade.

ViewCheck service is released as a set of two distinct images.

 ViewCheck RPM Image

 ViewCheck Service OS image

You can download these image from SWORDS.

BSF service RPMs are also distributed along with the ViewCheck RPMs to provide access to CLI
and XML. BSF service RPM is for CLI and XML access. You need to install these RPMs before
getting access to the ViewCheck CLI and XML interfaces.

 BSF Services RPM

Chapter 4

Make sure that the License manager is installed before installing the ViewCheck.

4.2 ViewCheck RPM Image

The ViewCheck RPM Image functionally comprises Diagnostics Framework, specific test cases,
and test suites. The ViewCheck RPM always use same OS variant and compile time
environment based on the BBS release of the target blade. For ATCA- 7370 blade, the
ViewCheck RPM is created for PNE 4.x environment. The ViewCheck RPM can be installed and
qualified on the latest BBS release of the blade.

This ViewCheck Service RPM contains:

 Diagnostics Core - Daemon

 Static Test Suite Configuration files for the Specific Blade

 Start/Stop Scripts for Diagnostics Core

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

29

Installation of ViewCheck

You can install this RPM on top of the blade BBS service by using the same integration process
for integrating any customer-specific applications or services on the blade. The exact
integration process of ViewCheck RPM service varies according to the customer environment.

No need to re-build the ViewCheck RPM Image for your environment.

Using the following command, you can install the ViewCheck RPM Image:

rpm -iv --nodeps diagnostics­<RELEASE>_<BUILD>.<DIST>.<OS>.atca7370.rpm

Using the following command, you can upgrade the ViewCheck RPM Image:

rpm -U --nodeps diagnostics­<RELEASE>_<BUILD>.<DIST>.<OS>.atca7370.rpm

Using the following command, you can remove the ViewCheck RPM Image:

rpm -e diagnostics-<RELEASE>_<BUILD>.<DIST>.<OS>.atca7370.rpm

The following table provides details of the files that are created on the blade once the
ViewCheck RPM is installed.

Table 4-1 RPM Files

File Name Path Descriptions

diagcored /opt/diagnostics/bin/ ViewCheck Core - Daemon
diagconfig.xml

diaguserconf.xml
diagcore /opt/diagnostics/etc/ini

libdiagintf.so /lib64/ Interface library between ViewCheck

<TestScripts>.sh /opt/diagnostics/tools/d

EmrDiag_Debug.log /opt/diagnostics/var/log

/opt/diagnostics/etc/diag/ViewCheck configuration file and user

configuration file.

Script to Start/Stop ViewCheck Core

t.d/

core daemon and BSF application.

Tes t scripts

iagtestscripts/

ViewCheck daemon service log

/diag/service/

30

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Table 4-1 RPM Files (continued)

File Name Path Descriptions

diagLib_log,
diagCore_log,
diagResults_log,
diagTestRaw_log,

diagShowCmds_log

/etc/logrotate.d Configuration files required for log

rotation of service logs

Installation of ViewCheck

Testutilities /opt/diagnostics/tools/d

iagtestutils/

The ViewCheck RPM also modifies the system configuration files such as /etc/crontab for
rotating ViewCheck daemon service logs, and /etc/syslog-ng/syslog-ng.conf to
post critical syslog messages to ViewCheck Daemon.

The crontab is modified to schedule log rotation with an entry in configuration file as shown
in the following. The log rotation configurations files diagLib_log, diagResults_log,

diagTestRaw_log, diagShowCmds_log, and diagCore_log are located at
/etc/logrotate.d.

* */1 * * * root /usr/sbin/logrotate /etc/logrotate.conf

Even if user modifies the crontab, this entry should not be removed.

The syslog-ng.conf is modified to post all the critical messages to a pipe from which the
diagcore daemon receives them to send notifications to user. The objects that are modified are
as following

Utilities and Tools used by ViewCheck
application

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

31

#destination
destination diag_pipe { pipe(/opt/diagnostics/var/log/diagpipe);
};#filter
filter f_crit { level(err..crit); };#Log path
log { source(s_sys); filter(f_crit); destination(diag_pipe); };

So even if user modifies the syslog.conf, these entries should not be removed, else it would
impact the inService functionality of diagcore daemon.

4.3 BSF Service RPM

BSF service is distributed as 3 RPM packages namely eMIND, BSFCore and Diagnostics
Transport layer service. Following are the list of RPM:

Installation of ViewCheck

32

ssf_main_rel-<BLADE>-<DIST>-<RELEASEBUILD>.<ARCH>.rpm

ssf_csim_rel-<BLADE>-<DIST>-<RELEASEBUILD>.<ARCH>.rpm

ssf_diagnosticsTLS_rel-<BLADE>-<DIST>-<RELEASEBUILD>.<ARCH>.rpm

You should install BSF RPMs in the following sequence:

1. ssf_main

2. ssf_csim

3. ssf_diagnosticsTLS

You can install the BSF using the following RPM commands:

 rpm -iv --nodeps --force ssf_main_rel-<BLADE>-<DIST>-

<RELEASEBUILD>.<ARCH>.rpm

 rpm -iv --nodeps --force ssf_csim_rel-<BLADE>-<DIST>-

<RELEASEBUILD>.<ARCH>.rpm

 rpm -iv --nodeps --force ssf_diagnosticsTLS_rel-<BLADE>-<DIST>-

<RELEASEBUILD>.<ARCH>.rpm

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

After the installation, the BSF binary files are installed at the /opt/ssf location.

The BSF applications can be started/stopped by passing 'start' or 'stop' to the script.

/opt/ssf/etc/config/S99SsfBsfRun.sh restart

/opt/ssf/etc/config/S99SsfBsfRun.sh <start/stop>

4.4 ViewCheck Service OS Image

The ViewCheck Service OS Image enables you to boot into ViewCheck specific OS and execute
the OOSD tests. The ViewCheck service is not completely dependent on the blade BBS
environment. For compatibility purpose, it may use the same OS or Kernel variant that are used
by the blade BBS service. For ATCA-7370, the ViewCheck service OS is created with PNE 4.x as
the OS.

The ViewCheck service OS along with the ViewCheck RPM, test suites, and test procedures are
distributed as an ISO file that contains:

Installation of ViewCheck

 ViewCheck OS as Ram Disk image that can be Net bootable

 ViewCheck OS image can be Net bootable and installable on selected Flash Partition,

provided User Flash is available on the blade

In ATCA 7370, there is no provision for User Flash. Hence ViewCheck service OS is created as
Net bootable Ram Disk Image.

The following table provides details of the files that are distributed as part of this image once
the ViewCheck service OS is installed.

Table 4-2 ViewCheck Service OS Image Files

File Name path Remarks

diagnostics-RELEASE­BUILD.windriver.linux.atc
a7370.gz

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Net bootable Ram Disk image with

ViewCheck RPM, Orion License RPM, and
BSF services package.

33

Installation of ViewCheck

Installing the ViewCheck Service OS image

Before installing the ViewCheck service OS Image, you should have the knowledge of
configuring TFTP, DHCP, and PXE to perform a diskless booting on ATCA-7370. For more
information, refer to the sections 2.2 and 2.3.1 in Basic Blade Services Software on ATCA-7370
Programmer's Reference.

1. Copy the diagnostics-RELEASE-

BUILD.windriver.linux.atca7370.gz image to the /tftpboot/
directory.

2. Change the PXE default configuration file ramdisk_size=819200, and reboot

the blade.
Once the blade is configured with the new ramdisk image, it will have ViewCheck,
Orion License utils, and Blade Services Framework installed.

3. Generate the Activation record to start using the ViewCheck application. For more

information, see Obtaining the Activation Record on page 22.

4. After the activation record is placed, restart the ViewCheck application using the

following script:

/opt/diagnostics/etc/init.d/diagcore restart

4.5 Access and Execution of a Test Using CLI

You can access ViewCheck CLI using the following procedure:

1. Establish the secure shell using SSH or Putty.

2. Start the Telnet connection from an already established secure shell.

telnet localhost 11001

Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.localdomain (127.0.0.1).
Escape character is '^]'.
Welcome to Emerson's SSF CLI

34

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

3. Type your username and password.

Username: Admin
Password:
Access granted
>enable
#configure terminal
BSF(config)#
BSF(config)#virExecEnv vee0
BSF(VEE-vee0)#diagnostic
BSF(diag-vee0)#

By default, the administrator user name and password are "Admin".

After logging into the ViewCheck CLI, you can list all the commands supported by typing '?'
on the CLI console. For information on commands to be used to install and LOG to ViewCheck,
refer Commands Execution on page 51.

BSF(diag-vee0)#?

device-category Configure device Category
exit Exit from diagnostic
hw-inventory-list Provides the Inventory of Hardware (Type,
Vendor ID, Major Number, Minor Number and any
associated Details) as detected by the
Diagnostics Application.
purge-all-log All log files are Zipped and stored away.
purge-log Purge specific log file.
set-log-level Sets the Log Level of Diagnostic
Application.
show-log-info List all Log files of Diagnostics
Application.
show-systemerror-log show system error log.

You can enter into device category mode by giving the command device-category on CLI
and view the list of commands only supported at device category level.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

35

Installation of ViewCheck

BSF(diag-vee0)#device-category ?
deviceCategory> other, processor, hardDisk, memory, os,
pciBus, pciExpressBus, scsiBus, sataBus,
clock, firmware, cpld, fpga,
networkinterface, digitalsignalprocessor,
networkprocessingunit, interface, systemBus,
flash, serial, i2cBus, spiBus, usbBus, ipmc

BSF(diag-vee0)# device-category networkinterface
BSF(diag-vee0-networkinterface)#?
exit Exit from deviceCategory
list-device-instances List all the possible device
instances in present
deviceCategory.
list-tests User can use this command to get
information on the available
Diagnostic tests with details like
tests and sub tests associated,
along with Test
IDs.
set-lower-threshold-info Set the Lower Threshold value for
the Monitor
set-rate set the rate of change value for
network monitors
set-poll-interval-default Set Poll Interval to default value
set-poll-interval Set the Poll Interval
set-threshold-default Set Threshold to default value
set-upper-threshold-info Set the Upper Threshold value for
the Monitor
show-lower-threshold-info Show Lower Threshold info.
show-monitor-id List all monitors for the
deviceCategory.
show-networkcounter-log show network counters log
show-networkerror-log show network errors log
show-poll-interval Show Poll Interval
show-rate show the rate of change value for
network monitors
show-test-help Brief help on the usage of the
Specific Test referred by Test ID.

36

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

show-test-result Show test result
show-test-status Show test status
show-upper-threshold-info Show upper threshold info.
start-monitor Start a monitor
start-test Start a test
stop-monitor Stop a monitor
stop-test Stop a test

After logging into the CLI, user can start, stop and query a test from the CLI.

Below is an example of FloodPingTest in the network interface device category. In network
interface category mode test ID 1. For more information, refer to NETWORK on page 82.

You can view the details of the test by giving show-test-help command.

BSF(diag-vee0-networkinterface)#show-test-help testId 1

1.FloodPingTest
Runs flood ping. Syntax: "FloodPingTest base1-2 aa.bb.cc.dd"
TestCapbaility:Cancellable
Service OS:Not Required(Non-Service Impacting)

A list of device Instances supported under a device category can be viewed by giving list­device-instances. To start the test, user can run start-test command with testId,
deviceInstance and arguments as input to the command. The arguments can be

neglected for tests that does not take any arguments as input.

After the test is executed, the results can be viewed by show-test-result command,
which outputs the test result and the raw log generated by that test.

BSF(diag-vee0-networkinterface)#list-device-instances

base1(70), base2(71), fabric1(73), fabric2(74), pan0(77),
pan1(78),rtm0(146) .. rtm3(149) nwcontlr(131)

BSF(diag-vee0-networkinterface)#$start-test testId 1
deviceInstance 70 arguments "192.168.21.1"
TEST PASSED Ivokcation Id:1

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

37

Installation of ViewCheck

BSF(diag-vee0-networkinterface)#show-test-result testId 1
deviceInstance 70
TEST PASSED FileName: NETWORK_base1.log

Using CLI, you can list all the Inservice diagnostics monitors in a device category. By default, all
the monitors are started when ViewCheck application is initialized. User can use start-monitor
and stop-monitor commands to start and stop any monitor.

BSF(diag-vee0-networkinterface)#show-monitor-id
Fri Dec 29 13:13:52 2000
DeviceCategory: networkinterface

Monitor Name: NETWORK ERRORS VALUES
MonitorId: 1020
DeviceInstance:
base1 base2 fabric1 fabric2 pan0 pan1

38

Monitor Name: NETWORK COUNTERS VALUES
MonitorId: 1021
DeviceInstance:
base1 base2 fabric1 fabric2 pan0 pan1

BSF(diag-vee0-networkinterface)#start-monitor deviceInstance 70
monitorId 1020
MONITOR IS ALREADY STARTED

BSF(diag-vee0-networkinterface)#stop-monitor deviceInstance 70
monitorId 1020
MONITOR IS STOPPED

BSF(diag-vee0-networkinterface)#start-monitor deviceInstance 70
monitorId 1020
MONITOR IS STARTED

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

To exit from the ViewCheck CLI:

BSF(diag-vee0)#exit
BSF(VEE-vee0)#exit

BSF(config)#exit
#exit

4.6 Access and Execution of a Test Using XML

You can access ViewCheck XML interface similar to ViewCheck CLI.

1. Establish the secure shell using SSH or Putty.

2. Start the Telnet connection from an already established secure shell.

telnet localhost 15550

Trying 127.0.0.1...
Connected to localhost.localdomain (127.0.0.1).
Escape character is '^]'.

4.6.1 Authenticate

After a connection with the XML Agent is established, the only command which should be
executed is Authenticate. This command is for evaluating user credentials.

The Authentication command contains user name and password for verification. Successful
authentication is indicated by the success response, otherwise an error message is returned.

You need to send the user credentials to XML Agent using the command “Authenticate”. The
XML Agent forwards the authentication request to the BSF system which validates the user
credentials and allows the XML client to access it if the validation is successful.

 Request:

In the below request the user credentials “Admin”/"Admin” are created by default in the
BSF. But user may supply user credentials by creating them using the "CreateObject"
command as shown in the section GetClassList.

<Script><Authenticate><User>Admin</User><Password>Admin</Passwo
rd></Authenticate></Script>]]>]]>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

39

 Response:

The below response is received if the authentication is successful.

<?xml version="1.0"?><Response><Success/></Response>]]>]]>

The following response is received if authentication fails.

<?xml
version="1.0"?><Response><Error><ErrorCode>1</ErrorCode><Type>O
peration not allowed</Type><Description>Authentication
error</Description><CustomError/></Error></Response>]]>]]>

4.6.2 Configure

Configure command configures the XML protocol for the indentation and the events
enable/disable state. There are two configuration options are available:

IndentOutput option controls the indentation of the XML response produced by the
MINDAgent. Its default value is ’0’, which means, by default, output indentation is off.

Installation of ViewCheck

 Request:

Below command request sets the indentation to 4.

<Script><Configure><IndentOutput>4</IndentOutput></Configure></
Script>]]>]]>

 Response:

<?xml version="1.0"?>
<Response>
<Success/>
</Response>]]>]]>

EnableEvents option enables or disables events which comes to the XML interface from the BSF
framework. Successful execution is indicated by the success response. Otherwise, an error
message is returned.

40

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

The values for the command is true/false. True option enables the events and false option
disables the events.

 Request:

<?xmlversion ="1.0"?>
<Script>
<Configure>
<EnableEvents>true</EnableEvents>
</Configure>
</Script>]]>]]>

 Response:

<?xml version="1.0"?><Response><Success/></Response>]]>]]>

4.6.3 GetClassList

This command is used to retrieve all BSF classes.

Installation of ViewCheck

 Request:

<Script ><GetClassList /></Script >]]>]]>

 Response:

The response message received from the XML Agent is shown below. The response
contains all the BSF classes including the BSF framework classes along with the application
defined classes.

<Response>
<Classes>
<Class>session</Class>
<Class>shell</Class>
<Class>mode</Class>
<Class>command</Class>
<Class>user</Class>
<Class>group</Class>
<Class>membership</Class>
<Class>ACManager</Class>
<Class>shutdown</Class>
<Class>usmuser</Class>
<Class>traphost</Class>
<Class>cppscript</Class>
<Class>classlock</Class>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

41

<Class>globallock</Class>
<Class>CommunityMO</Class>
<Class>SystemMO</Class>
<Class>SNMPAgentConfig</Class>
<Class>EventReceiver</Class>
<Class>EventFilter</Class>
<Class>agent</Class>
<Class>logsink</Class>
<Class>logfilter</Class>
<Class>acl</Class>
<Class>aclclass</Class>
<Class>aclmember</Class>
<Class>aclmoid</Class>
<Class>aclclassrange</Class>
<Class>aceclass</Class>
<Class>acemember</Class>
<Class>acemoid</Class>
<Class>aceclassrange</Class>
<Class>virExecEnv</Class>
<Class>interface</Class>
<Class>service</Class>
<Class>diagnostic</Class>
<Class>deviceCategory</Class>
</Classes>
</Response>]]>]]>

Installation of ViewCheck

42

ViewCheck software uses classes, diagnostics and device category to start, stop and query
the status of tests and monitors.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

4.6.4 DescribeClass

DescribeClass XML command retrieves the description and properties of a BSF class such as
class creatability, class deletability, class writability, attributes, attributes description, attribute
types etc. It returns ClassDescription on success or an error.

 Request:

The below XML request gets the description of class 'shelf' in the BSF system.

<?xmlversion ="1.0"?>
<Script version ="2">
<DescribeClass>
<Class>diagnostic</Class>
</DescribeClass>
</Script>]]>]]>
<?xml version="1.0"?>

 Response:

The below XML response shows the different details of the class 'shelf' in the BSF system.

<Response>
<ClassDesc>
<Class>diagnostic</Class>
<Id>1201</Id>
<Description>In Diagnostic mode, user can configure and perform
Diagnostic related tests, monitoring &
updating.</Description>
<IsSingleton>false</IsSingleton>
<IsCreatable>true</IsCreatable>
<IsDeletable>true</IsDeletable>
<IsWritable>false</IsWritable>
<MOIDDesc>
<Name>diagnosticMoid</Name>
<Id>1201</Id>
<Description/>
<MOIDItemDesc>
<Ref>
<ClassId>1102</ClassId>
<MOIDId>1102</MOIDId>
</Ref>
</MOIDItemDesc>
</MOIDDesc>

Installation of ViewCheck

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

43

Installation of ViewCheck

<MethodDesc>
<Name>hwInventoryList</Name>
<Id>10</Id>
<Description>Provides the Inventory of Hardware (Type, Vendor
ID, Major Number, Minor Number and any associated Details) as
detected by the Diagnostics Application. </Description>
<IsStatic>false</IsStatic>
<ArgDesc>
<Name>outputResult</Name>
<Id>0</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>
<IsOutput>true</IsOutput>
<IsOptional>false</IsOptional>
</ArgDesc>
</MethodDesc>
<MethodDesc>
<Name>reload</Name>
<Id>20</Id>
<Description>User can issue this command when there are
updates to the User XML .</Description>
<IsStatic>false</IsStatic>
<ArgDesc>
<Name>commandStatus</Name>
<Id>0</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>
<IsOutput>true</IsOutput>
<IsOptional>true</IsOptional>
</ArgDesc>
</MethodDesc>

44

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

<MethodDesc>
<Name>setLogLevel</Name>
<Id>30</Id>
<Description>Sets the Log Level of Diagnostic
Application.</Description>
<IsStatic>false</IsStatic>
<ArgDesc>
<Name>logLevelValue</Name>
<Id>0</Id>
<Description>Valid log levels (3-Critical, 2-Normal, 1­Info)</Description>
<TypeDesc>
<Name>Integer</Name>
<Description>Integer number in range (-2^32)/2 to (2^32)/2 ­1</Description>
</TypeDesc>
<IsInput>true</IsInput>
<IsOutput>false</IsOutput>
<IsOptional>false</IsOptional>
</ArgDesc>
<ArgDesc>
<Name>commandStatus</Name>
<Id>1</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>
<IsOutput>true</IsOutput>
<IsOptional>true</IsOptional>
</ArgDesc>
</MethodDesc>
<MethodDesc>
<Name>showLogInfo</Name>
<Id>40</Id>
<Description>List all Log files of Diagnostics
Application.</Description>
<IsStatic>false</IsStatic>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

45

Installation of ViewCheck

<ArgDesc>
<Name>outputResult</Name>
<Id>0</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>
<IsOutput>true</IsOutput>
<IsOptional>false</IsOptional>
</ArgDesc>
</MethodDesc>
<MethodDesc>
<Name>purgeLog</Name>
<Id>50</Id>
<Description>Purge specific log file.</Description>
<IsStatic>false</IsStatic>
<ArgDesc>
<Name>logFileName</Name>
<Id>0</Id>
<Description>log file name</Description>
<TypeDesc>
<Name/>
<Description>file name</Description>
</TypeDesc>
<IsInput>true</IsInput>
<IsOutput>false</IsOutput>
<IsOptional>false</IsOptional>
</ArgDesc>
<ArgDesc>
<Name>commandStatus</Name>
<Id>1</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>

46

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

<IsOutput>true</IsOutput>
<IsOptional>true</IsOptional>
</ArgDesc>
</MethodDesc>
<MethodDesc>
<Name>purgeAllLog</Name>
<Id>60</Id>
<Description>All log files are Zipped and stored
away.</Description>
<IsStatic>false</IsStatic>
<ArgDesc>
<Name>commandStatus</Name>
<Id>0</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>
<IsOutput>true</IsOutput>
<IsOptional>true</IsOptional>
</ArgDesc>
</MethodDesc>
<MethodDesc>
<Name>showSystemErrorLog</Name>
<Id>70</Id>
<Description>show system error log</Description>
<IsStatic>false</IsStatic>
<ArgDesc>
<Name>outputResult</Name>
<Id>0</Id>
<Description/>
<TypeDesc>
<Name/>
<Description/>
</TypeDesc>
<IsInput>false</IsInput>
<IsOutput>true</IsOutput>
<IsOptional>false</IsOptional>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

47

</ArgDesc>
</MethodDesc>
</ClassDesc>
</Response>]]>]]>

4.6.5 InvokeMethod

InvokeMethod XML command calls the method of an BSF Object. BSF methods are defined
with method parameters such as input, output and input-output.

BSF Object method can be invoked with a list of input or input-output arguments. This
command returns a list of output or input-output arguments. The input arguments means it is
only an input and will not be displayed in the output. But in the case of input-output
arguments, both input and output will be displayed in the output.

 Request:

The below example invokes the method class 'diagnostics' with instance "vee0". Upon
execution of this method by the class instance, response will be sent in the output/input­output arguments.

Request
=======
<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>setLogLevel</Method>
<Argument>
<Name>logLevelValue</Name>
<Value>1</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Installation of ViewCheck

48

 Response:

InvokeMethod command returns the below response on executing the above example
command.

<?xml version="1.0"?>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Installation of ViewCheck

<Response>
<Arguments>
<Argument>
<Name>commandStatus</Name>
<Value>Set Log Level Success</Value>
</Argument>
</Arguments>
</Response>]]>]]>

To exit from the ViewCheck XML:

<Script>
<Command name="Exit"/>
<Script>]]>]]>

4.7 ViewCheck Service LOG Information

To Summarize, ViewCheck service Logs are available and stored at the following path:

/opt/diagnostics/var/log/diag/service/EmrDiag_Debug.log

The Test result LOGS (EMR_Results.txt) and the Raw logs (Ex:-CPU_cpu0.log)

Generated by the various utilities are available at

/opt/diagnostics/var/log/diag/testlog/

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

49

Installation of ViewCheck

50

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

5.1 Overview

CLI and XML are the primary ways to access ViewCheck capabilities on the blade. These
mechanisms allows you to perform activities such as start, stop and query on the ViewCheck
software. Using CLI and XML you can also set the parameters for monitoring.

Commands are classified into:

 Generic commands

 Commands for test management and control

 Commands for monitoring

5.2 Generic Commands

Chapter 5

Following are the general functional commands provided by the ViewCheck service.

The command syntaxes for XML interface is given for the diagnostic class with instance as
vee0. This instance varies depending on the blade.

5.2.1 device-category

device-category command allows to configure the available device categories.

Syntax

device-category <Dev category>

Expected Output
The CLI prompt will show the device category that you have selected.

This command is valid only in CLI.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

51

5.2.2 list-device-instances

list-device-instances command lists all possible device instances in present device
category.

Syntax for CLI

list-device-instances

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>listInstances</Method>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

5.2.3 hw-inventory-list

hw-inventory-list command provides the detailed information of hardware
components available on the blade. The command displays the Hardware Type, Vendor ID,
Major Number, Minor Number and any associated details that are identified by the ViewCheck.

Syntax for CLI

hw-inventory-list

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>hwInventoryList</Method>
</InvokeMethod>
</Script>]]>]]>

52

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5.2.4 set-log-level

set-log-level command sets the current log level of ViewCheck to value X. This is an
internal Debug command to be used mainly for generating detailed debug log information.
The valid log level values are listed in the following table:

Table 5-1 set-log-level

Values Description

1-Info All logs are logged. Even functions like entry and exit are also logged.

2- Normal Details of function flows are logged.

3- Critical High level errors are logged.

Syntax for CLI

set-log-level logLevelValue <x>

Commands Execution

The following table lists the set-log-level command arguments.

Table 5-2 set-log-level

Argument Data Type Description

X Integer Possible values are 3, 2, 1 (3-Critical, 2-Normal, 1-Info)

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>setLogLevel</Method>
<Argument>
<Name>logLevelValue</Name>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

53

<Value>1</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Example

BSF(diag-vee0)#set-log-level logLevelValue 2
Set Log Level Success

5.2.5 show-log-info

show-log-info command provides the details of the various LOG files along with the
diagnostics data.

Syntax for CLI

show-log-info

Commands Execution

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>showLogInfo</Method>
</InvokeMethod>
</Script>]]>]]>

5.2.6 purge-log

purge-log command deletes the LOG files generated by ViewCheck software.

Syntax for CLI

purge-log logFileName <logfile Name>

54

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

The following table provides the purge-log command arguments.

Table 5-3 purge-log

Argument Data Type Description

logfile Name String Type the name of the Log file that you want to delete or

clear

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>purgeLog</Method>
<Argument>
<Name>logFileName</Name>
<Value>{Name of the log file}</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Example

BSF(diag-vee0)#purge-log logFileName NETWORK_base1.log
Purge Log Success

You can purge only raw log files. The raw log file naming convention is in the form of *.log.

5.2.7 purge-all-log

purge-all-log command allows to zip all LOG files and store away.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

55

Syntax for CLI

purge-all-log

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>purgeAllLog</Method>
</InvokeMethod>
</Script>]]>]]>

5.2.8 show-systemerror-log

show-systemerror-log command displays the kernel critical and error messages
captured by ViewCheck application.

Commands Execution

56

Syntax for CLI

show-systemerror-log

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>diagnostic</Class>
<Name>vee0</Name>
</Object>
<Method>showSystemErrorLog</Method>
</InvokeMethod>
</Script>]]>]]>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

5.3 Test Management and Control Commands

The following list of CLI commands are used for test management and control of diagnostic
tests.

Execute all test management and control commands only after entering a specific device
category.

5.3.1 start-test

start-test command allows you to start and run a particular diagnostic test.

Syntax for CLI

start-test testId <Test ID> deviceInstance <Dev Instance>,
arguments [< Param1>, <Param2>]

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>startTest</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>testId</Name>
<Value>Test ID</Value>
</Argument>
<Argument>
<Name>arguments</Name>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

57

Commands Execution

<Value>Param1</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table lists the start-test command arguments.

Table 5-4 start-test

Argument Data Type Description

Test ID Integer Type the unique ID of a particular test that you want to

start

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent Enumerated value of supported Device
Instance

Param1, Param2 String Type the required parameters. The parameters should

be separated with single space.

5.3.2 show-test-help

show-test-help command provides the brief information on how to use a particular test.
This command provides information such as how to start, stop, and query the specified test ID.

Syntax for CLI

show-test-help testId <Test ID>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{dev Cat}</Name>
</Object>
<Method>showTestHelp</Method>
<Argument>
<Name>testId</Name>

58

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

<Value>Test ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table lists the show-test-help command arguments.

Table 5-5 show-test-help

Argument Data Type Description

Test ID Integer Type the unique ID of a particular test to get the details

5.3.3 list-tests

list-tests command provides a supported list of diagnostics tests on the blade with
associated test IDs.

Commands Execution

of it

Syntax for CLI

list-tests

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{dev Cat}</Name>
</Object>
<Method>showTestList</Method>
</InvokeMethod>
</Script>]]>]]>

5.3.4 show-test-status

show-test-status command allows you to view the status of a particular test. The status
of a test can be In Progress, Test Execution Completed, Test Stopped, and Test Timed Out.

Syntax for CLI

show-test-status testId <Test ID> deviceInstance <Dev Instance>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

59

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showTestStatus</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>testId</Name>
<Value>Test ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

The following table lists the show-test-status command arguments.

Table 5-6 show-test-status

Argument Data Type Description

Test ID Integer Type the unique ID of a particular test that you want to

Dev Instance Enum Use list-device-instances CLI command to get the

5.3.5 show-test-result

show-test-result command allows you to view the latest result of a particular test. This
command displays the start and end time of the test, the test status such as Passed, Failed,
Aborted, and Timed Out, and additional test arguments.

Syntax for CLI

show-test-result testId <Test ID> deviceInstance <Dev Instance>

60

view the status

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showTestResult</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>testId</Name>
<Value>Test ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

Table 5-7 show-test-result

Argument Data Type Description

Test ID Integer Type the unique ID of a particular test that you want to

view the latest result

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

5.3.6 stop-test

stop-test command allows you to stop or cancel any running diagnostic test.

Syntax for CLI

stop-test testId <Test ID> deviceInstance <Dev Instance>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

61

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>stopTest</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>testId</Name>
<Value>Test ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

62

The following table provides the Stop-test command arguments.

Table 5-8 stop-test

Argument Data Type Description

Test ID Integer Type the unique ID of the Test that you want to stop

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5.4 Monitoring Commands

The following list of commands are used for management of the InService Monitoring
functionality of ViewCheck.

Execute all commands related to monitors only after entering the specific device category
mode.

5.4.1 show-monitor-id

show-monitor-id command displays the list of parameters that are monitored using the
InService Diagnostic. This command displays default monitor ID values of the parameters also.

Commands Execution

Syntax for CLI

show-monitor-id

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showMonitorId</Method>
</InvokeMethod>
</Script>]]>]]>

This command displays a list of monitors, if supported, only in that particular device
category.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

63

5.4.2 show-poll-interval

show-poll-interval command displays list of default Poll intervals that are associated
with the monitors. The Poll interval values are in seconds.

Syntax for CLI

show-poll-interval monitorId <Monitor ID> deviceInstance <Dev
Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showPollInterval</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

64

The following table provides the show-poll-interval command arguments.

Table 5-9 show-poll-interval

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor of which you want to

view its default Poll interval values, if any

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5.4.3 show-lower-threshold-info

show-lower-threshold-info command displays lower threshold information that are
applicable to a monitor.

Syntax for CLI

show-lower-threshold-info monitorId <Monitor ID> deviceInstance
<Dev Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showLowerThresholdInfo</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

The following table provides the show-lower-threshold-info command arguments.

Table 5-10 show-lower-threshold-info

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor of which you want to

view its lower threshold value

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

65

5.4.4 show-upper-threshold-info

show-upper-threshold-info command displays upper threshold information that are
applicable to a monitor.

Syntax for CLI

show-upper-threshold-info monitorId <Monitor ID> deviceInstance
<Dev Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showUpperThresholdInfo</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

66

The following table provides the show-upper-threshold-info command arguments.

Table 5-11 show-upper-threshold-info

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor of which you want to

view its upper threshold value

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5.4.5 start-monitor

start-monitor command allows you to trigger a specific monitor to start monitoring if it
is not already initiated by default.

Syntax for CLI

start-monitor monitorId <Monitor ID> deviceInstance <Dev Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>startMonitor</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

The following table provides the Start-monitor command arguments.

Table 5-12 start-monitor

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor that you want to start

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

67

5.4.6 set-lower-threshold-info

set-lower-threshold-info command is used to set the lower threshold value for a
particular monitor based on which the monitor performs.

Syntax for CLI

set-lower-threshold-info monitorId < Monitor ID> deviceInstance
<Dev Instance> lowerThreshold <Threshold Value>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>setLowerThresholdInfo</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
<Argument>
<Name>lowerThreshold</Name>
<Value>Threshold Value</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

68

The following table provides the set-lower-threshold-info command arguments.

Table 5-13 set-lower-threshold-info

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor for which you want to

set the lower threshold value

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

Table 5-13 set-lower-threshold-info

Argument Data Type Description

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

Threshold
Value

Integer Type a threshold value for the specified monitor ID

5.4.7 set-upper-threshold-info

set-upper-threshold-info command is used to set the upper threshold value for a
particular monitor based on which the monitor performs.

Syntax for CLI

set-upper-threshold-info monitorId < Monitor ID> deviceInstance
<Dev Instance> upperThreshold <Threshold Value>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>setUpperThresholdInfo</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
<Argument>
<Name>upperThreshold</Name>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

69

Commands Execution

<Value>Threshold Value</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the set-upper-threshold-info command arguments.

Table 5-14 set-upper-threshold-info

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor for which you want to

set the upper threshold value

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

Threshold Value Integer Type a threshold value for the specified monitor ID

5.4.8 set-threshold-default

set-threshold-default command is used to reset the threshold value to default value of
a particular monitor.

Syntax for CLI

set-threshold-default monitorId <Monitor ID> deviceInstance <Dev
Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>setThresholdDefault</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>

70

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the set-threshold-default command arguments.

Table 5-15 set-threshold-default

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor for which you want to

reset its threshold value to default value

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

5.4.9 set-poll-interval

set-poll-interval command is used to set the Poll interval value for monitors.

Syntax for CLI

set-poll-interval monitorId <Monitor ID> deviceInstance <Dev
Instance> pollInterval <PollIntervaLvalue>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>setPollInterval</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

71

Commands Execution

<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
<Argument>
<Name>pollInterval</Name>
<Value>PollInterval Value</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the set-poll-interval command arguments.

Table 5-16 set-poll-interval

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor for which you want to

set the Poll interval value

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

PollInterval Value Integer Type the Poll interval value for the specified monitor ID

5.4.10 set-poll-interval-default

set-poll-interval-default command is used to reset the Poll interval value to default
value of a particular monitor.

Syntax for CLI

set-poll-interval-default monitorId <Monitor ID> deviceInstance
<Dev Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>

72

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

<Method>setPollIntervalDefault</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the set-poll-interval-default command arguments.

Table 5-17 set-poll-interval-default

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor for which you want to

Dev Instance Enum Use list-device-instances CLI command to get the

5.4.11 stop-monitor

stop-monitor command allows you to trigger a specific monitor to stop monitoring, which
is already in service.

Syntax for CLI

stop-monitor monitorId <Monitor ID> deviceInstance <Dev Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>stopMonitor</Method>

reset the Poll interval value to default value

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

73

Commands Execution

<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the stop-monitor command arguments.

Table 5-18 stop-monitor

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor that you want to stop

monitoring

Dev Instance Enum Use list-device-instances CLI command to get the

5.4.12 set-rate

set-rate command sets the rate of change value for network monitors.

Syntax for CLI

set-rate monitorId <Monitor Id> deviceInstance <Dev Instance> rate
<Rate>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>setRate</Method>
<Argument>

74

equivalent enumerated value of supported Device
Instance

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
<Argument>
<Name>rate</Name>
<Value>Rate</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the set-rate command arguments.

Table 5-19 set-rate

Commands Execution

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor for which rate of

change value is to be set

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

Rate Integer Rate of change value

5.4.13 show-rate

show-rate command shows the rate of change value of network monitors.

Syntax for CLI

show-rate monitorId <Monitor Id> deviceInstance <Dev Instance>

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

75

Commands Execution

<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showRate</Method>
<Argument>
<Name>deviceInstance</Name>
<Value>Dev Instance</Value>
</Argument>
<Argument>
<Name>monitorId</Name>
<Value>Monitor ID</Value>
</Argument>
</InvokeMethod>
</Script>]]>]]>

The following table provides the show-rate command arguments.

Table 5-20 show-rate

Argument Data Type Description

Monitor ID Integer Type the unique ID of the Monitor of which rate of

change value is to be shown

Dev Instance Enum Use list-device-instances CLI command to get the

equivalent enumerated value of supported Device
Instance

5.4.14 show-networkcounter-log

show-networkcounter-log command displays the list of network counters on devices
that have crossed the maximum rate value. For more information on command, rate, refer

show-rate on page 75.

Syntax for CLI

show-networkcounter-log

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>

76

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

<Name>vee0-{Dev Cat}</Name>
</Object>
<Method>showNetworkCounterLog</Method>
</InvokeMethod>
</Script>]]>]]>

5.4.15 show-networkerror-log

show-networkerror-log command displays the list of network counters on devices that
have crossed the maximum rate value. For more information on command, rate, refer show-

rate on page 75.

Syntax for CLI

show-networkerror-log

Syntax for XML

<Script>
<InvokeMethod>
<Object>
<Class>deviceCategory</Class>
<Name>vee0-{Dev cat}</Name>
</Object>
<Method>showNetworkErrorLog</Method>
</InvokeMethod>
</Script>]]>]]>

Commands Execution

5.4.16 exit

exit command allows you to exit from the ViewCheck CLI.

Syntax for CLI

exit

Syntax for XML

<Script>
<Command name="Exit"/>
<Script>]]>]]>

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

77

5.5 InService Monitoring Specifics

The In Service Monitoring of ViewCheck provides functionality to:

 Monitor HW Device Status

 Monitor Device Critical Errors

The functionality and access methods provided are briefly described in this section.

5.5.1 Monitoring HW Device Status

In Service Monitoring also periodically polls for various devices status on the blade. These are

 CPU Core temperature status

 Storage Device HDD Health Status

 Network Devices Counters Statistics

Commands Execution

 Network Devices Error Statistics

Each of the above is identified by a unique Monitor ID. For more information on Monitor ID,
refer Monitor ID on page 19.

The Default Poll Interval for monitoring each of the Monitor ID is set to 10 Seconds.

Commands are provided to alter the default settings.

For more information on the commands provided for InService Monitoring, refer Monitoring

Commands on page 63.

78

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Commands Execution

The following table provides list of Monitor IDs and Device Instances for each of the Monitors
being monitored on ATCA-7370.

Table 5-21 Monitors

Monitor

Monitor Description

ID Valid Device Instances Remarks

CPU Core
Temperatures

1000

Core 0 to Core 19 (0 to

15)

Temperature of the 16 cores
available on ATCA- 7370 CPU
are monitored individually
and reported if crosses a Set
Threshold.

HDD Health Status 1010 Sda1 to Sda4 (83 to 86) Monitors the Health Status of the

sda1 to sda4 partitions on the
HDD and reports.

Network Errors 1020 base1(70), base2(71),

fabric 1(73), fabric
2(74),pan0(77),
pan1(78), rtm0(146),
rtm1(147), rtm2(148),
rtm3(149), rtm4(156),
rtm5(157) to
rtm6(157)rtm8(160)

Network Statistics 1021 base1(70), base2(71),

fabric 1(73), fabric
2(74),pan0(77),
pan1(78), rtm0(146),
rtm1(147), rtm2(148),
rtm3 (149), rtm4(156),
rtm5(157) to
rtm6(157)rtm8(160)

Monitors the various Error
counters for each of the Network
Device Instances and provides an
error counter exceeds the rate of
change.

Monitors the various counters for
each of the Network Device
Instances.

5.5.2 Monitoring Device Critical Errors

Under Linux OS, the Device Drivers LOG abnormal behavior and potential errors occurring in
the Hardware device with KERN_ERR or KERN_CRIT category. These notifications are
considered as potential errors as they could manifest into latent faults in the live system.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

79

As part of monitoring the Device Critical errors, all such Kernel CRITICAL and Kernel ERROR
notifications have been extracted from the PNE Kernel (4.x) driver sources and represented in
the form of a database.

The In Service Monitoring Module of ViewCheck would watch out for the occurrence of these
notifications and on detection would send a notification to XML.

The Device Errors are captured and are identified uniquely by ERROR ID. For definition of
ERROR ID, refer Error ID on page 19.

5.6 OOSD Tests

OOSD Tests are used to monitor and manage the performance of the hardware components of
blades. You can execute these tests only when blades are offline, that is blades are not
providing any service.

Commands Execution

5.6.1 CPU

 CpuSpeedTest: Checks whether the Processor(s) frequency is in between operating limits

(upper and lower limits).

 CpuTempTest: Reads the Processor core(s) temperature levels and ensures that all cores

are operating in normal levels.

 CacheSizeTest: Verifies L1, L2, and L3 Cache sizes of CPU(s) on the board.

5.6.2 HDD

 DiskBadBlksTest: Searches for bad blocks on a device (usually a disk partition). Device is

the special file corresponding to the device (e.g /dev/hsda1). The starting, ending block
numbers are selected in default.

 DiskCntlrTest: Verifies the random data written to disks remains unchanged. It verifies only

IDE and SCSI controllers that are associated with mounted file systems. Disk controllers
associated with read-only mounted file systems are not verified.

 DiskSelfTest: DiskSelfTest checks the electrical and mechanical performance as well as

read performance of the disk.

80

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

5.6.3 Memory

 MemCntlrTest: Randomly writes to areas of memory, then reads the memory back to

ensure the values written remain unchanged.

 RandomMemoryTest: Performs stress-testing on the memory subsystem. This test is

effective in finding intermittent and non-deterministic faults. The problems in other
hardware areas such as overheating CPU, out-of-specification power supply, and so on can
cause memory faults.

5.6.4 OS

 MemSepTest: Ensures that user space programs cannot read and write to areas of memory

utilized by items such as Video RAM and kernel code.

 SupervisorInstrTest: Ensures that the enforcement of the property that privileged

instructions should only be in supervisor mode is still in effect. The set of privileged
instructions tested to confirm this is architecture dependent.

Commands Execution

5.6.5 PCI

 PCIScanTest: Enumerates all active PCI devices in the blade and ensures board default

configuration is active. This test need to be executed under supervisory mode.

Executing this test in user mode may result in failure of test.

Executing this test with the supported RTMs except ARTM-736X may result in failure of test.

5.6.6 IPMC

IPMITest: Executes basic IPMI commands and ensures the basic IPMI controller, IPMI bus
functionalities are working properly by reading the response back.

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

81

5.6.7 NETWORK

 EthLinkTest: Verifies Ethernet device (ex: base0,base1,fabric0,fabric1,etc...) link status

(active/inactive) and also captures various statistics of Ethernet device.

 FloodPingTest: FloodPingTest uses the ICMP protocol’s mandatory ECHO_REQUEST

datagram to elicit an ICMP_ECHO_RESPONSE from a host or gateway. ECHO_REQUEST
datagram’s have an IP and ICMP header, followed by a structure timeval and then an
arbitrary number of ’Pad’ bytes used to fill out the packet.

 EthStatsTest: Tests basic network packet consistency that is checks network Rx, Tx errors,

generates a warning if errors are less than or equal to 100 and marks the test as fail if
number of errors are more than 100.

 NetworkCntlrTest: Verifies random data transmitted and also the data received for each

configured network device. It verifies only Ethernet and token ring devices that are
configured and active. The asynchronous devices are not verified.

 NetworkAdapterTest: Test executes adapter selftest (BIST) on the specified ethernet

device.

Commands Execution

5.6.8 FPGA

 FpgaRegRdTest: This test Read/write FPGA resisters and also checks for the default register

values.

5.6.9 I2C

 I2cDetectionTest (SP): This test modprobes an i2c module and checks for default i2c

devices on board.

5.6.10 USB

 UsbReadTest: This test does repeated accesses to usb partition, reads and verifies the data.

82

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Appendix A

A Related Documentation

A.1 Artesyn Embedded Technologies - Embedded

Computing Documentation

The publications listed below are referenced in this manual. You can obtain electronic copies of
Artesyn Embedded Technologies - Embedded Computing publications by contacting your
local Artesyn sales office. For released products, you can also visit our Web site for the latest
copies of our product documentation.

1. Go to www.artesyn.com/computing.

2. Under SUPPORT, click TECHNICAL DOCUMENTATION.

3. Under FILTER OPTIONS, click the Document types drop-down list box to select the type of

document you are looking for.

4. In the Search text box, type the product name and click GO.

Table A-1 Artesyn Embedded Technologies - Embedded Computing Publications

Document Title Publication Number

ATCA-7370 Installation and Use 6806800P54B

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

83

Related Documentation

84

ViewCheck on ATCA-7370 Installation and Use (6806800S48B)

Artesyn Embedded Technologies, Artesyn and the Artesyn Embedded Technologies logo are trademarks and service marks of Artesyn Embedded Technologies, Inc.
All other product or service names are the property of their respective owners.

©

2014 Artesyn Embedded Technologies, Inc.