This is a list of additional tools that are provided by xCAT. They are located in /opt/xcat/share/xcat/tools/, but should also be in your path. Many of these tools have been contributed by xCAT users that are not part of the core xCAT development team. That means they might not be supported as well as the main xCAT code. Read the help here, take a look at the code, and use at your own risk. If you have problems with a tool, post to the xCAT mailing list and the author will try to help you.
Error: execution of './share/xcat/tools/detect_dhcpd --help' failed with rc=2.
Usage: dhcphelper -h
dhcphelper -r|--rm -m|--mac [ -a|--ip ] [ -n|--name ]
delete the dhcp lease of specified , and
go-xcat version 1.0.53
Usage: go-xcat [OPTION]... [ACTION]
Install xCAT automatically
Options:
Mandatory arguments to long options are mandatory for short options too.
-h, --help display this help and exit
--xcat-core=[URL] use a different URL or path for the xcat-core
repository
--xcat-dep=[URL] use a different URL or path for the xcat-dep
repository
-x, --xcat-version=[VERSION] specify the version of xCAT; imply the subdirectory
of corresponding xCAT version under
http://xcat.org/files/xcat/repos/yum/ or
http://xcat.org/files/xcat/repos/apt/
cannot use with --xcat-core
-y, --yes answer yes for all questions
Actions:
install installs all the latest versions of xcat-core
and xcat-dep packages from the repository
update updates installed xcat-core packages to the
latest version from the repository
uninstall removes xCAT from this system
completely uninstall removes xCAT from this system and cleans up
all the traces xCAT made
Examples:
go-xcat
go-xcat install
go-xcat update
go-xcat --yes install
go-xcat -x 2.12 -y install
go-xcat --xcat-version=devel install
go-xcat --xcat-version=stable install
go-xcat --xcat-core=/path/to/xcat-core.tar.bz2 \
--xcat-dep=/path/to/xcat-dep.tar.bz2 install
go-xcat --xcat-core=http://xcat.org/path/to/xcat-core.tar.bz2 \
--xcat-dep=http://xcat.org/path/to/xcat-dep.tar.bz2 install
go-xcat uninstall
go-xcat completely uninstall
xCAT: http://xcat.org/
Full documentation at: http://xcat-docs.readthedocs.io/en/stable
Error: execution of './share/xcat/tools/mac2linklocal --help' failed with rc=2.
Error: execution of './share/xcat/tools/mktoolscenter --help' failed with rc=2.
nodesw changes the vlan of a node to a specified vlan requires xCAT 2.0, Switch configured with SNMP sets, and only tested on SMC8648T nodesw -h|--help nodesw [-v]vlan nodesw [-v] show Author: Vallard Benincosa
Error: execution of './share/xcat/tools/reorgtbls --help' failed with rc=2.
Error: execution of './share/xcat/tools/rmblade --help' failed with rc=2.
Error: execution of './share/xcat/tools/rmnodecfg --help' failed with rc=2.
test_hca_state (part of the BEF_Scripts for xCAT) v3.2.27
Usage: test_hca_state NODERANGE [FILTER] | xcoll
--help Display this help output.
NODERANGE
An xCAT noderange on which to operate.
FILTER
A string to match in the output, filtering out everything else. This
is passed to "egrep" and can be a simple string or a regular
expression.
Purpose:
This tool provides a quick and easily repeatable method of
validating key InfiniBand adapter (HCA) and node based InfiniBand
settings across an entire cluster.
Having consistent OFED settings, and even HCA firmware, can be very
important for a properly functioning InfiniBand fabric. This tool
can help you confirm that your nodes are using the settings you
want, and if any nodes have settings descrepancies.
Example output:
#
# This example shows that all of rack 14 has the same settings.
#
root@mgt1:~ # test_hca_state rack14 | xcoll
====================================
rack14
====================================
OFED Version: MLNX_OFED_LINUX-2.0-3.0.0.3 (OFED-2.0-3.0.0):
mlx4_0
PCI: Gen3
Firmware installed: 2.30.3200
Firmware active: 2.30.3200
log_num_mtt: 20
log_mtts_per_seg: 3
Port 1: InfiniBand phys_state: 5: LinkUp
state: 4: ACTIVE
rate: 40 Gb/sec (4X FDR10)
symbol_error: 0
port_rcv_errors: 0
Port 2: InfiniBand phys_state: 3: Disabled
state: 1: DOWN
rate: 10 Gb/sec (4X)
symbol_error: 0
port_rcv_errors: 0
IPoIB
recv_queue_size: 8192
send_queue_size: 8192
ib0:
Mode: datagram
MTU: 4092
Mode: up
ib1:
Mode: datagram
MTU: 4092
Mode: up
#
# This example uses a FILTER on the word 'firmware'. In this case, we've
# upgraded the firmware across rack11 and rack12.
#
# - On rack11, we've also restarted the IB stack (/etc/init.d/openibd
# restart) to activate the new firmware.
#
# - Rack 12 has also been updated, as we can see from the 'Firmware
# installed' line, but it's nodes are still running with their prior
# level of firmware and must reload the IB stack to have it take effect.
#
root@mgt1:~ # test_hca_state rack11,rack12 firmware | xcoll
====================================
rack11
====================================
Firmware installed: 2.30.3200
Firmware active: 2.30.3200
====================================
rack12
====================================
Firmware installed: 2.30.3200
Firmware active: 2.11.1260
Author: Brian Finley
Error: execution of './share/xcat/tools/xCATreg --help' failed with rc=2.