Setup to run atcatester
One time setup is installation of atcatester in pgpxe01 server.
Related CMM test case: TEST ID:
1.43.1
Run atcatester for ShMC
Steps:
1. Flash firmware into both CMMs in Chassis.
2. Configure CMM's IP address and submask need to be 255.255.255.0 (if
using 255.255.0.0, test script is not possible to able to run it, refer
troubleshoot section) *Do NOT change pgpxe01 server IP
subnetmask.
3. Disable password needed for CMM access on Active CMM
- cmmset -t level:admin -d authtypes -v none
==>Success
4. Verify the password is not need has been configured.
- cmmget -t level:admin -d authtypes
==> none
5. Goto where atcatester installed, example pgpxe01
6. Run atcatester test cases as below (example):
- esoatcatester -u root -v -c shmctest 128.0.10.78 308
Troubleshoot:
This is what happen when IP subnetmask is 255.255.0.0
[kyfoo@4Y2ZS1S-radisys ~]$ esoatcatester -u root -v -c shmctest 128.0.10.78
309
* Log into atca_tester_logs/2012_03_27_12_25_50
* Initializing session
(128.0.10.78:623)...
* Transport error:
Request timed out (NetFn:0x06 Cmd:0x38 Resp:0x20 -
GetChannelAuthCapabilities)
List of ShMC test cases:
[kyfoo@4Y2ZS1S-radisys ~]$ esoatcatester list shmctest
--- Basic ATCA
& IPMI requirements test package ---
--- LEDs requirements test package
---
--- Sensors test package ---
--- Shelf Manager and Shelf test package
---
300 - Address Table presence and Get Address Info command (ShMC
Test)
301 - Get/Set Shelf Address Info commands (Interactive)(ShMC
Test)
302 - SEL Device (ShMC Test)
303 - SDR Repository
(ShMC Test)
304 - SDR Repository storage (ShMC Test)
305 -
Temperature Thresholds Crossing (single board,correct order) (ShMC
Test)
306 - Temperature Thresholds Crossing (single board,incorrect
order) (ShMC Test)
307 - Temperature Thresholds Crossing
(multi-board) (ShMC Test)
308 - Temperature Thresholds Crossing
(power down/extract board) (Interactive)(ShMC Test)
312 - Board
communication lost/recovered (Interactive)(ShMC Test)
313 - Board
extracted/replaced when communication lost/recovered (Interactive)(ShMC
Test)
315 - Shelf Manager IPMB Address (Interactive)(ShMC
Test)
322 - Temperature Thresholds Crossing (communication lost)
(Interactive)(ShMC Test)
323 - Temperature Thresholds Crossing
(multiple power levels) (ShMC Test)
324 - FRU Inventory Device
Lock/Write commands (Interactive)(ShMC Test)
325 - Insufficient power
budget (Interactive)(ShMC Test)
326 - Shelf Manager Controlled
Activation (Interactive)(ShMC Test)
327 - Shelf Manager Controlled
Deactivation (Interactive)(ShMC Test)
--- IPMB related test package
---
400 - IPMB reliability (w/o an ATCA board) (ShMC Test)
404 - IPMB hang detection and recovery (IPMB errors on bus) (Interactive)(ShMC
Test)
--- RMCP interface requirements test package ---
--- MMC and Carrier
IPMC test package ---
--- Description test package ---
701 -
Active Shelf Manager Description (ShMC Test)
--- HPM Tests (IPMC)
---
--- HPM Tests (MMC) ---
Below are the help from ATCA
tester:
Usage: esoatcatester [OPTIONS]... test
(ipmc[/frus][:testseq][_sensors])+
esoatcatester [OPTIONS]...
carriertest (ipmc[:testseq][_sensors])+
esoatcatester
[OPTIONS]... mmctest mmc@ipmc[:testseq][_sensors]
esoatcatester [OPTIONS]... shmctest [testseq]
esoatcatester [OPTIONS]... shelftest [testseq]
esoatcatester [OPTIONS]... nettest [testseq]
esoatcatester [OPTIONS]... list [mode] [testseq]
hostname: Shelf Manager hostname or IP address.
testseq: A comma separated list of test numbers
or test ranges
(without any blank character),
optionnaly followed by a 'not'
clause
(e.g. 1-7,10not2,4-5 is equivalent to tests
1,3,6,7,10).
Note that 'not10' means all tests except test
#10.
testseq is altered by -i and -I options.
If no testseq
is specified, all possible tests are
selected according to the given
command.
COMMANDS:
test
(ipmc[/frus][:testseq][_sensors])+
execute
IPMC and FRU test(s).
ipmc is the IPMB address (in hexadecimal e.g. 0x82
or 82
mean 0x82) of the IPMC to test.
frus is a comma separated list of FRUs or FRUs ranges on
which
FRU tests are executed. Non-FRU (IPMC) tests are executed
only
if frus contains '0'. If no frus is specified then '0'
is added to frus. If frus is equal to 255, then tests
are executed on
all FRUs present on the IPMC.
Note that frus is subject to the same
rules as testseq.
Instead of ipmc/frus syntax, it is possible to select the FRU to
test
with a character string containing a site type among
[board,
shmc, pem, shelffru, fan, fanfilter, alarm] followed by
a
site number (in decimal e.g. board1, shmc2, fan3, etc...).
sensors is a comma separated list of sensors numbers
(in
hexadecimal e.g. 0x10 or 10 mean 0x10) or sensors ranges
on which
sensors tests are executed.
hpmtest
ipmc[:testseq]
execute HPM (IPMC)
test(s).
ipmc is the IPMB address (in hexadecimal e.g. 0x82
or 82
mean 0x82) of the IPMC to test.
hpmmmctest
mmc@ipmc[:testseq]
execute HPM
(MMC) test(s).
mmc is the IPMB-L address of the MMC to test.
ipmc is the
IPMB address of the Carrier hosting the Module.
carriertest
(ipmc[:testseq][_sensors])+
execute
Carrier IPMC, IPMC and FRU test(s).
ipmc is the IPMB address (in hexadecimal e.g. 0x82
or 82
mean 0x82) of the Carrier IPMC to test.
Instead of ipmc syntax, it is possible to select the Carrier
IPMC
to test with a character string containing 'board'
followed by a site number (in decimal e.g. board1, board14, etc...).
sensors is a comma separated list of sensors numbers
(in
hexadecimal e.g. 0x10 or 10 mean 0x10) or sensors ranges
on which
sensors tests are executed.
mmctest
mmc@ipmc[:testseq]
execute MMC
test(s).
mmc is the IPMB-L address of the MMC to test.
ipmc is the
IPMB address of the Carrier hosting the Module.
Instead of mmc syntax, it is possible to select the MMC
to
test with a character string containing 'amcsite'
followed by a site
number (in decimal e.g. amcsite3)
Instead of ipmc syntax, it is possible to select the Carrier
hosting
the Module to test with a character string containing
'board'
followed by a site number (in decimal e.g. board1, board14,
etc...).
Using this syntax, "
amcsite6@board3" will select MMC
located
on AMC Module plugged in AMC site #6 of Carrier Board in slot
#3.
shmctest
[testseq]
execute Shelf Manager
test(s).
shelftest
[testseq]
execute Shelf test(s).
nettest
[testseq]
execute Network test(s).
list [mode] [testseq]
list all available test scripts.
mode is a test filter among [test, carriertest, mmctest, shmctest, shelftest,
nettest].
If no mode is specified, list all tests according to given
options.
testseq is an optional test list that will act as a filter as
well.
Note that only -i, -I, -c and -C options are meaningful for
this command
(see below for options).
OPTIONS:
-p, --port=PORT connect to port PORT (Default is
623)
-a, --authentication=METHOD use authentication METHOD (Default is
0)
(0=None, 1=MD2, 2=MD5,
4=Straight)
-u, --user=USER use USER as login (Default is
"")
-w, --passwd=PASSWD use PASSWD to login (Default is
"")
-b, --autodeact set this flag to indicate that
ShMC
auto deactivates FRU in M5 (Default is
not set)
-v, --verbose enable verbose mode
-q,
--quiet if set, no messages are displayed on stdout
during
the test session. However, logs are
still available.
-Q, --almostquiet like --quiet except that
only log directory is displayed on stdout.
Note that if -Q is set, -q has no effect.
-f, --restorefrus
if set, FRUs initial hotswap state is
restored
at the end of the test
session.
-o, --nopresence Do not check MMC/IPMC/FRU presence
before starting the tests.
-k, --check=CHECK check commands
responses (Hexadecimal number representing 4
bits)
(Bit 0: check PICMG defined commands
exact response length)
(Bit 1: check IPMI
defined commands exact response length)
(Bit 2: check PICMG defined commands reserved bits and
fields)
(Bit 3: check IPMI defined
commands reserved bits and fields)
(Default
is 7: Bit 0,1,2 = 1 and Bit 3 = 0)
-l, --log=DIR test log
files directory will be created
in subdir
DIR (Default is "atca_tester_logs")
of the
log files root path - see
ATCA_TESTER_LOGS_PATH
environment variable
description below.
-n, --runs=#RUNS number of test runs to
execute (Default is 1)
-s, --stop=LEVEL stop on error
depending on LEVEL (Default is 0)
(0=don't
stop, 1=stop on error, 2=stop on error or
warning,
3=stop on error, warning or
info)
-r, --random shuffle test sequence before each
run
-i, --interactive if set, select only interactive
tests
(Mutually exclusive with
-I).
-I, --nointeractive if set, select only non interactive
tests
(Mutually exclusive with
-i).
-c, --nologcolor if set, strip colors from log
file.
-C, --nocolor if set, strip colors from log file
and from stdout.
--version print version and
exit.
-x, --xmlfile=FILE use XML FILE for Description
test.
-h, --help print this page.
TIMEOUT OPTION:
-t, --timeout Timeout in seconds for the responses to come from the
DUT.
MINISCOPE OPTION:
-H, --minihost IP address or Host name of your PC where
miniscope is running.
-P, --miniport Port of your PC at which
miniscope is running.
ENVIRONMENT VARIABLES:
ATCA_TESTER_LOGS_PATH
Log files root path. If not
defined, defaults to current working
directory. Subdir defined
by --log option described above will
be appended to it.
