Artesyn ATCA-9405 User Manual
ViewCheck on ATCA-9405
Installation and Use
P/N: 6806800S51E
September 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 Artesyn Embedded Technologies
Marketing Communications
2900 S. Diablo Way, Suite 190
Tempe, Arizona 85282
Lilienthalstr. 17-19
85579 Neubiberg/Munich
Germany
Contents
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.7 Error ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3 Installation of ViewCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.2 ViewCheck RPM Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.3 BSF Service RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.4 ViewCheck Service OS Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.5 Access and Execution of a Test Using CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.6 Access and Execution of a Test Using XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.6.1 Authenticate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.6.2 Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.6.3 GetClassList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3.6.4 DescribeClass. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.6.5 InvokeMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3.7 ViewCheck Service LOG Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.8 ViewCheck TestLog Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
3
Contents
Contents
Contents
4 Commands Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.2 Generic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.2.1 configure-error-strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.2.2 configure-log-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4.2.3 device-category. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.2.4 diag-service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.2.5 hw-inventory-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.2.6 list-all-tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
4.2.7 list-device-instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
4.2.8 purge-all-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
4.2.9 purge-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
4.2.10 set-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.2.11 show-all-monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.2.12 show-all-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.2.13 show-diag-scan-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.2.14 show-log-content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.2.15 show-log-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.2.16 show-log-level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.2.17 show-running-mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.2.18 show-systemerror-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2.19 start-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2.20 start-diag-scan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.21 stop-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.2.22 stop-diag-scan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.2.23 switch-mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.2.24 version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4.3 Test Management and Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
4.3.1 start-test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
4.3.2 show-test-help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
4.3.3 list-tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
4.3.4 show-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
4.3.5 show-test-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.3.6 stop-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
4.4 Monitoring Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
Contents
4.4.1 show-monitor-id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4.4.2 show-poll-interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
4.4.3 start-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
4.4.4 set-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
4.4.5 set-poll-interval-default. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
4.4.6 stop-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
4.4.7 set-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
4.4.8 show-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
4.4.9 show-networkcounter-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
4.4.10 show-networkerror-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
4.4.11 exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
4.5 InService Monitoring Specifics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
4.5.1 Monitoring HW Device Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
4.5.2 Monitoring Device Critical Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
4.6 OOSD Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
4.6.1 CPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
4.6.2 HDD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
4.6.3 Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
4.6.4 OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
4.6.5 PCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
4.6.6 IPMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
4.6.7 NETWORK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
4.6.8 FPGA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
4.6.9 I2C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
4.6.10 USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
4.6.11 RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
A Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
A.1 Artesyn Embedded Technologies - Embedded Computing Documentation . . . . . . . . . . . . . . . . 87
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
5
Contents
Contents
Contents
6
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
List of Tables
Table 3-1 RPM Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Table 3-2 ViewCheck Service OS Image Files on SP and PP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Table 4-1 configure-error-strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Table 4-2 configure-log-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Table 4-3 diag-service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Table 4-4 purge-log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Table 4-5 set-log-level Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Table 4-6 set-log-level Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Table 4-7 show-log-content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Table 4-8 start-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Table 4-9 start-diag-scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Table 4-10 stop-all-monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Table 4-11 switch-mode Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Table 4-12 start-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Table 4-13 show-test-help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Table 4-14 show-test-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Table 4-15 show-test-result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Table 4-16 stop-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Table 4-17 show-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Table 4-18 start-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Table 4-19 set-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Table 4-20 set-poll-interval-default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Table 4-21 stop-monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Table 4-22 set-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Table 4-23 show-rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Table 4-24 Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Table A-1 Artesyn Embedded Technologies - Embedded Computing Publications . . . . . . . . . . . . . . . 87
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
7
List of Tables
8
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
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.
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
INSM In Service Monitoring. Functional module in ViewCheck
Lists the relevant manuals and provides additional information.
Framework.
Interfaces (CLI and XML)
framework handling the monitoring functionality of
various critical parameters in the blade.
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
9
About this Manual
Abbreviation Definition
OOSD Online Out of service Diagnostics. Functional module in
PP Packet Processor
SP Service Processor
XML Extensible Markup Language
Conventions
The following table describes the conventions used throughout this manual.
Notation Description
0x00000000 Typical notation for hexadecimal numbers (digits are
About this Manual
ViewCheck framework that manages Test Management
requests related to Out of Service Diagnostics.
0 through F), for example used for addresses and
offsets
10
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-9405 Installation and Use (6806800S51E)
Omission of information from example/command
that is not necessary at the time being
About this Manual
Notation Description
.. Ranges, for example: 0..4 means one of the integers
0,1,2,3, and 4 (used in registers)
| Logical OR
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
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
No danger encountered. Pay attention to important
information
11
About this Manual
Summary of Changes
Part Number Date Description
6806800S51A October, 2013 Initial version.
About this Manual
6806800S51B
6806800S51C May, 2014 R2.6 Release
6806800S51D May, 2014 Added notice in sections Orion License RPM
6806800S51E September, 2014 Added show-all-test-status on page 53,show-
March, 2014 Updated the sections Overview on page 21,
ViewCheck RPM Image on page 21 and BSF
Service RPM on page 23.
Added new commands in Generic
Commands on page 45, a test in Memory on
page 82 and section FPGA on page 84.
Updated ViewCheck Service OS Image on
page 25 and OOSD Tests on page 80.
Re-branded to Artesyn template.
Installation, Overview, ViewCheck RPM Image,
and BSF Service RPM.
log-level on page 56, switch-mode on page
60, ViewCheck TestLog Information on page
43, and SfpDetectionTest command.
12
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
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 Storage devices, Ethernet counters and errors.
ViewCheck can be accessed locally using Command Line Interface (CLI) and Extensible Markup
Language (XML) interfaces provided via Blade Services Framework (BSF) service.
ViewCheck can provide both:
InService Diagnostics
In this mode, the diagnostics service can run while the blades are instantiated with
customer applications and providing service.
ViewCheck can monitor key hardware parameters like Network Counters, and Network
errors. In addition, watching for kernel critical errors logged by various hardware devices
and device drivers.
Chapter 1
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 21.
For more information on commands supported for InService and OOS, refer Commands
Execution on page 45.
ViewCheck on ATCA-9405 is supported on P2020 service processor (SP) and two Cavium
OCTEON II packet processors (PP). Procedure to install and accessing ViewCheck on SP and PP
are different and is detailed in Installation of ViewCheck on page 21.
1.2 ViewCheck Access Methods
This section explains the different methods to access ViewCheck services on the Artesyn ATCA
blades.
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
13
Introduction
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
Generate Hardware inventory.
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.
BSF, 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 21.
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-9405 Installation and Use (6806800S51E)
Introduction
In addition, XML notifications are generated with following details:
State changes about the diagnostic test under execution
Pre-determined monitor exceeding 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-9405 Installation and Use (6806800S51E)
15
Introduction
16
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
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 available
on the blade.
Following are the examples of tests that can be executed on the devices:
Ping Flood test
Network connectivity test in case of Network Device Category
Each of these tests would be associated with a unique Test Identifier (Test ID).
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
17
Concepts of ViewCheck
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
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. 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, or eth2 are used to identify unique devices in
networking devices 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.
2.6 Monitor ID
ViewCheck service monitors pre-identified parameters for hardware devices. These
parameters are Network Device counters, Network Device errors and so on. 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.
18
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
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.
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 45.
Concepts of ViewCheck
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
19
Concepts of ViewCheck
20
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
Installation of ViewCheck
3.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 RPM contains all ViewCheck services. BSF service RPMs are also distributed along with
the ViewCheck RPMs. BSF service RPMs provide access to CLI and XML.
If user wants to move to a newly available ViewCheck and BSF RPMs, the current set of RPMs
should be uninstalled before installing the new RPMs. For more information, see ViewCheck
RPM Image and BSF Service RPM.
Chapter 3
ViewCheck Service OS image
You can download this image from SWORDS. This also contains the ViewCheck OOS image
for PPs.
3.2 ViewCheck RPM Image
The ViewCheck RPM Image functionally comprises Diagnostics Framework, specific test cases,
and test suites. The ViewCheck RPM always uses same OS variant and compile time
environment based on the BBS release of the target blade. For ATCA-9405 Service Processor
(SP) blade, the ViewCheck RPM is created for PNE 4.1 environment.
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-9405 Installation and Use (6806800S51E)
21
Installation of ViewCheck
Using the following command, you can install the ViewCheck RPM Image:
rpm -iv --nodeps diagnostics<RELEASE>_<BUILD>.<DIST>.<OS>.9405sp.rpm
After installing the ViewCheck RPM, ViewCheck service should be started explicitly using
command, /opt/diagnostics/etc/init.d/diagcore start.
Using the following command, you can remove the ViewCheck RPM Image:
rpm -e diagnostics-<RELEASE>_<BUILD>.<DIST>.<OS>.9405sp.rpm
You need to stop the Diagnostics Core service, before performing un-installation using the
/opt/diagnostics/etc/init.d/diagcore stop script.
The following table provides details of the files that are created on the blade once the
ViewCheck RPM is installed.
Table 3-1 RPM Files
File Name Path Descriptions
diagcored /opt/diagnostics/bin/ ViewCheck Core - Daemon
diagconfig.xml
diaguserconf.xml
diagcore /opt/diagnostics/etc/init.d/ Script to Start/Stop ViewCheck Core
libdiagintf.so on 9405_SP: /lib/
<TestScripts>.sh /opt/diagnostics/tools/diagt
EmrDiag_Debug.log /opt/diagnostics/var/log/dia
22
/opt/diagnostics/etc/diag/ ViewCheck configuration file and user
configuration file.
Interface library between ViewCheck
on 9405_PP: /lib/ and /lib64/
estscripts/
g/service/
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
core daemon and BSF application.
Tes t scripts
ViewCheck daemon service log
Table 3-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/diagt
estutils/
3.3 BSF Service RPM
BSF service is distributed as a package contains 3 RPMs namely eMIND, BSFCore, and
Diagnostics Transport layer service. Following are the list of RPM:
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
Utilities and Tools used by ViewCheck
application
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
23
Installation of ViewCheck
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
After installing the BSF RPMs, BSF services should be started explicitly using command,
/opt/ssf/etc/config/S99SsfBsfRun.sh start.
You can uninstall the BSF using the following RPM commands:
rpm -e ssf_diagnosticsTLS_rel-<BLADE>-<DIST>-
<RELEASEBUILD>.<ARCH>.rpm
rpm -e ssf_csim_rel-<BLADE>-<DIST>-<RELEASEBUILD>.<ARCH>.rpm
rpm -e ssf_main_rel-<BLADE>-<DIST>-<RELEASEBUILD>.<ARCH>.rpm
After the installation, the BSF binary files are installed at the /opt/ssf location.
The BSF applications can be started, stopped and restarted using below script.
sh /opt/ssf/etc/config/S99SsfBsfRun.sh start/stop/restart
You need to stop the BSF services, before performing uninstallation using below script.
/opt/ssf/etc/config/S99SsfBsfRun.sh stop
The order of removal of RPMs is a reverse procedure to that of installation.
24
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
3.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-9405 SP, the ViewCheck service OS is created with PNE
4.x3.x4.13.0 as the OS. For 9405 PP the OOSD image is build from cavium SDK. The 9405 PP
OOSD image is packaged along with 9405 SP OOSD image. So there is a single ViewCheck OS
image for ATCA-9405 blade.
The ViewCheck service OS along with the ViewCheck RPM, test suites, and test procedures are
distributed as an ISO file that contains:
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
Installation of ViewCheck
The following table provides details of the files that are distributed as part of this image once
the ViewCheck service OS is installed.
Table 3-2 ViewCheck Service OS Image Files on SP and PP
File Name Remarks
diagnostics-RELEASEBUILD.windriver4.1.linux.atca940
5sp.gz
Net bootable Ram Disk image with
ViewCheck RPM, Orion License RPM, and BSF
services package.
ViewCheck OOS image for PP with ViewCheck RPM
and BSF service packages.
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
25
Installation of ViewCheck
Installing the ViewCheck Service OS image on SP
Before installing the ViewCheck service OS Image, you should have the knowledge of
configuring TFTP Server, configuring ATCA-9405 for Network Booting and Booting ATCA-9405
using a ramdisk. For more information, refer to the section 2.3 in Blade Services Software on
ATCA-9405 PR guide.
1. Once the blade is configured to boot with ramdisk image, it will have ViewCheck
and Blade Services Framework installed.
2. SP should also have the interfaces to PP1 and PP2 configured so that a
communication can be established between SP and PP's.
Installing the ViewCheck Service OS image on PP
The following procedure is to boot the ViewCheck OOS image on PP. For more information,
refer to section 2.6.5 in Blade Services Software on ATCA-9405 Programmer’s Reference Guide.
26
Before installing ViewCheck Service OS image on PP, make sure that vlans are configured
appropriately to reach Octeons.
1. On SP, go to /opt/diagnostics/etc/diag/ location and execute the
runlinux scripts.
For installing ViewCheck Service OS image on PP1, execute ./runlinux 1
command.
For installing ViewCheck Service OS image on PP2, execute ./runlinux 2
command.
Installing ViewCheck Service OS Image on USB
The ViewCheck service OS image can be installed on any external USB drive using flashprep
and flashinstall tools available on the board.
Use the flashrc tool available on the board to install the ViewCheck service OS image on USB
device.
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
Installation of ViewCheck
For more information on installation, refer section 2.6.5 in Blade Services Software on ATCA-9405
Programmer’s Reference Guide.
Before installing on USB, the image needs to be converted into tar.bz2 format using
mk_atca_9405_sp_bzip2_format.sh script provided along with this release.
Example
./mk_atca_9405_sp_bzip2_format.sh <ViewCheck service image>
For this, any Linux PC can be used.
3.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 Tel ne t 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
3. Type your username and password.
ViewCheck on ATCA-9405 Installation and Use (6806800S51E)
27
Loading...