Artesyn ATCA-7470, ATCA-7475 User Manual

ViewCheck on ATCA-7470/7475

Installation and Use

P/N: 6806800S49C May 2014

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 Artesyn Embedded Technologies

Marketing Communications

2900 S. Diablo Way, Suite 190

Tempe, Arizona 85282

Lilienthalstr. 17-19

85579 Neubiberg/Munich

Germany

Contents

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

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

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

1.2 ViewCheck Access Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

4.4 ViewCheck Service OS Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

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

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

4.6.1 Authenticate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

4.6.2 Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

4.6.3 GetClassList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

4.6.4 DescribeClass. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

4.6.5 InvokeMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

4.7 ViewCheck Service LOG Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

5 Commands Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.2 Generic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.2.1 configure-error-strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.2.2 configure-log-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5.2.3 device-category. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.2.4 diag-service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.2.5 hw-inventory-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5.2.6 list-all-tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.2.7 list-device-instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5.2.8 purge-all-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.2.9 purge-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.2.10 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

5.2.11 show-all-monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.2.12 show-diag-scan-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

5.2.13 show-log-content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

5.2.14 show-log-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5.2.15 show-running-mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5.2.16 show-systemerror-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

5.2.17 start-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

5.2.18 start-diag-scan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

5.2.19 stop-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

5.2.20 stop-diag-scan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.2.21 version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5.3 Test Management and Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

5.3.1 start-test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

5.3.2 show-test-help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

5.3.3 list-tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

5.3.4 show-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

5.3.5 show-test-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

5.3.6 stop-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

5.4 Monitoring Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.4.1 show-monitor-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

5.4.2 show-poll-interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

5.4.3 show-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5.4.4 show-upper-threshold-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

5.4.5 start-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

5.4.6 set-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5.4.7 set-upper-threshold-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

5.4.8 set-threshold-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.4.9 set-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.4.10 set-poll-interval-default. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

5.4.11 stop-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

5.4.12 set-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

5.4.13 show-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

5.4.14 show-networkcounter-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

5.4.15 show-networkerror-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

5.4.16 exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

5.5 InService Monitoring Specifics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

5.5.1 Monitoring HW Device Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

5.5.2 Monitoring Device Critical Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

5.6 OOSD Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

5.6.1 CPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

5.6.2 HDD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

5.6.3 Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

5.6.4 OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

5.6.5 PCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

5.6.6 IPMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

5.6.7 NETWORK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

5.6.8 FPGA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

5.6.9 I2C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

5.6.10 USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

A Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

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

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

List of Tables

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

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

Table 5-1 configure-error-strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Table 5-2 configure-log-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Table 5-3 diag-service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Table 5-4 purge-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Table 5-5 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Table 5-6 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Table 5-7 show-log-content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Table 5-8 start-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Table 5-9 start-diag-scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Table 5-10 start-diag-scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Table 5-11 start-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Table 5-12 show-test-help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Table 5-13 show-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Table 5-14 show-test-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Table 5-15 stop-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Table 5-16 show-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Table 5-17 show-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Table 5-18 show-upper-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Table 5-19 start-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Table 5-20 set-lower-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Table 5-21 set-upper-threshold-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Table 5-22 set-threshold-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Table 5-23 set-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Table 5-24 set-poll-interval-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Table 5-25 stop-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Table 5-26 set-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Table 5-27 show-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Table 5-28 Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

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

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

List of Tables

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

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

Lists the relevant manuals and provides additional information.

Framework.

Interfaces (CLI and XML)

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

Abbreviation Definition

HW Hardware

INSM In Service Monitoring. Functional module in ViewCheck

OOSD Online Out of service Diagnostics. Functional module in

XML Extensible Markup Language

Conventions

The following table describes the conventions used throughout this manual.

Notation Description

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.

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

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

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

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

Summary of Changes

Part Number Date Description

About this Manual

6806800S49A

6806800S49B December, 2013 Changed the title of the manual.

6806800S49C May 2014 R2.6 Release.

October, 2013 Initial version

Added new commands in Generic

Commands on page 49. Added new tests in CPU on page 87, Memory on page 88, and NETWORK on page 89.

Updated ViewCheck Service OS Image on

page 31.

Re-branded to Artesyn template.

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

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 49.

In case blades are upgraded from ATCA-7470 to ATCA-7475, FRU info needs to be updated.

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

1.2 ViewCheck Access Methods

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

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

Introduction

 Stop a diagnostic test

1.2.1 CLI

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.

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.

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

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-7470/7475 Installation and Use (6806800S49C)

Introduction

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

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-7470/7475 Installation and Use (6806800S49C)

 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.

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

2.6 Monitor ID

ViewCheck Service monitors pre-identified parameters for hardware devices. These parameters are CPU Core temperature, 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 49.

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

Concepts of ViewCheck

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

License Management

3.1 Overview

The permissions to use any Artesyn value-added software module is granted based on the licenses installed on ATCA-7470/7475. 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-7470/7475 Installation and Use (6806800S49C)

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

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

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/.

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

makeSystemPrint binary from /opt/bladeservices/bin/license/redhatx86/ 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-7470/7475, the product name is SL-DG7470-

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-7470/7475 Installation and Use (6806800S49C)

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-DG7470-01-001-STD -kacpjEMw6Q6lDWL81

-ddomkey > fp.key

 Sample command when executed on remote machine:

./makeSystemPrint -pSL-DG7470-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 fingerprint 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-7470/7475 Installation and Use (6806800S49C)

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-DG7470-01-001STD.

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-DG7470-01-001-STD, then rename the file as actrec_SL-DG7470-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-7470/7475 Installation and Use (6806800S49C)

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/.

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

makereceipt binary from /opt/bladeservices/bin/license/redhatx86/.

Command Syntax

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

License Management

./makereceipt -pProductName [-aActivationRecord -iIHFfile]

Parameters Description

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

ViewCheck on ATCA-7470/7475, the product name is SL-

DG7470-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-DG7470-01-001-STD

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

 Sample command when executed on remote machine:

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

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

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

This command generates the receipt file, receipt_SL-DG7470-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-7470/7475 Installation and Use (6806800S49C)

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-DG7470-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-7470/7475 Installation and Use (6806800S49C)

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

This is packaged as part of BBS release. The License Manager and BSF service RPMs are also distributed along with the ViewCheck RPMs. BSF service RPMs provide access to CLI and XML.

 ViewCheck Service OS image

You can download this image from SWORDS.

Chapter 4

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-7470/7475 blades, the ViewCheck RPM is created for PNE 4.x environment. The ViewCheck RPM comes along with 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

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

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

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

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

ViewCheck on ATCA-7470/7475 Installation and Use (6806800S49C)

+ 65 hidden pages

Artesyn ATCA-7470, ATCA-7475 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

ViewCheck on ATCA-7470/7475

About this Manual

Overview of Contents

Abbreviations

Conventions

Summary of Changes

Introduction

1.1 Overview

1.2 ViewCheck Access Methods

1.2.1 CLI

1.2.2 XML

Concepts of ViewCheck

2.1 Overview

2.2 Test Identification

2.3 Device Category

2.4 Test ID

2.5 Device Instance

2.6 Monitor ID

2.7 Error ID

License Management

3.1 Overview

3.2 Orion License RPM Installation

3.3 Obtaining the Activation Record

3.4 Verifying the Installation of a Value-added Software Module

3.5 Returning the License

Installation of ViewCheck

4.1 Overview

4.2 ViewCheck RPM Image