xcat-inventory is an inventory tool for the cluster managed by xCAT(http://xcat.org), the features include:
-
a object based view of the cluster inventory, which is flexible, extensible and well formatted
-
interfaces to export/import the cluster inventory data in yaml/json format, which can be then managed under source control
-
inventory templates for typical clusters, which help user to define a cluster easily
-
ability to intergrate with Ansible(Comming soon)
- Installing
- Building
- Dependencies
- Platform Restrictions
- Command Synopsis
- Typical use cases
- Reporting bugs
Download "xcat-inventory" package from xcat-inventory to xCAT management node, and run yum install xcat-inventory.rpm to install it
[root@boston01 ~]# git clone https://github.com/xcat2/xcat-inventory.git
Cloning into 'xcat-inventory'...
remote: Counting objects: 1844, done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 1844 (delta 0), reused 6 (delta 0), pack-reused 1837
Receiving objects: 100% (1844/1844), 401.48 KiB | 0 bytes/s, done.
Resolving deltas: 100% (1072/1072), done.
[root@boston01 ~]#
[root@boston01 ~]# cd xcat-inventory
[root@boston01 xcat-inventory]# ./makepythonrpm xcat-inventory
xcat-inventory/
xcat-inventory/cli/
xcat-inventory/cli/xcat-inventory
:
:
:
xcat-inventory/requirements.txt
Building /root/rpmbuild/RPMS/noarch/xcat-inventory-0.1.4*.noarch.rpm ...
/root/rpmbuild/RPMS/noarch/xcat-inventory-0.1.4-c10.noarch.rpm
[root@boston01 xcat-inventory]#
[root@boston01 xcat-inventory]# yum -y install /root/rpmbuild/RPMS/noarch/xcat-inventory-0.1.4-c10.noarch.rpm
Loaded plugins: product-id, search-disabled-repos, subscription-manager
This system is not registered with an entitlement server. You can use subscription-manager to register.
Examining /root/rpmbuild/RPMS/noarch/xcat-inventory-0.1.4-c10.noarch.rpm: 1:xcat-inventory-0.1.4-c10.noarch
Marking /root/rpmbuild/RPMS/noarch/xcat-inventory-0.1.4-c10.noarch.rpm as an update to 1:xcat-inventory-0.1.4-c4.noarch
Resolving Dependencies
--> Running transaction check
---> Package xcat-inventory.noarch 1:0.1.4-c4 will be updated
---> Package xcat-inventory.noarch 1:0.1.4-c10 will be an update
--> Finished Dependency Resolution
Dependencies Resolved
=============================================================================================================================
Package Arch Version Repository Size
=============================================================================================================================
Updating:
xcat-inventory noarch 1:0.1.4-c10 /xcat-inventory-0.1.4-c10.noarch 258 k
Transaction Summary
=============================================================================================================================
Upgrade 1 Package
Total size: 258 k
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Updating : 1:xcat-inventory-0.1.4-c10.noarch 1/2
Cleanup : 1:xcat-inventory-0.1.4-c4.noarch 2/2
Verifying : 1:xcat-inventory-0.1.4-c10.noarch 1/2
Verifying : 1:xcat-inventory-0.1.4-c4.noarch 2/2
Updated:
xcat-inventory.noarch 1:0.1.4-c10
Complete!
[root@boston01 xcat-inventory]#
Several python packages are required:
- Psycopg: PostgreSQL adapter for the Python
- SQLAlchemy(above 0.8.0): Python SQL toolkit and Object Relational Mapper
- PyMySQL(0.7.x): a pure-Python MySQL client library
- PyYAML: YAML parser and emitter for the Python
- Six: a Python 2 and 3 compatibility library
In most cases, these packages will be installed during xcat-inventory installation.
If you are prompted that some of them cannot be found during xcat-inventory installation, you can download the package from dep-url and install it manually.
If you are prompted No module named xxx when you run xcat-inventory, you can install the missing package with one of the following way:
- install the corresponding rpm/deb package
- install the python package with
pip - download the python package tarball from PyPi(https://pypi.python.org/pypi), uncompress it and install the package with
python setup.py install
The xcat-inventory is arch independent, i.e, you can install it on xCAT management nodes with architecture X86_64,ppc64, or ppc64le
Currently, only rpm package is shipped, which can be installed on Linux distributions like Redhat 7.x, CentOS 7.x and SuSE.
The installation and function verification is finished on rhels7.x.
For other Linux distributions, you might need to handle the dependency issue by yourself.
Show usage info:
# xcat-inventory help
# xcat-inventory export -h
# xcat-inventory import -h
Export the inventory data from xcat database:
- dump cluster inventory data to screen
# xcat-inventory export
- dump cluster inventory data to screen in yaml format
# xcat-inventory export --format yaml
- dumo cluster inventory data to screen in json format
# xcat-inventory export --format json
- dump cluster inventory data to a file
# xcat-inventory export -f /tmp/cluster
- dump osimage inventory data to a file
# xcat-inventory export -t osimage -f /tmp/osimage
- dump the inventory data of osimage "rhels6.5-x86_64-netboot-compute" to a file
# xcat-inventory export -t osimage -o rhels6.5-x86_64-netboot-compute -f /tmp/osimage
- export cluster inventory data to a directory
# xcat-inventory export -d /tmp/mm/
The osimage objects has been exported to directory /tmp/mm/osimage
The cluster inventory data has been dumped to /tmp/mm/cluster.json
all objects except "osimage" are dumped to a file "cluster.json" or "cluster.yaml", "osimage" objects are exported to osimage directories under a subdirectory "osimage".
Each osimage direcotry contains a "definition.yaml" or "definition.json", and the customized osimage files(files which are not under directory /opt/xcat/share/xcat/), such as pkglist,otherpkglist,synclists,partitionfile,template and exlists
- export an osimage objec to a directory
# xcat-inventory export -t osimage -o rhels7.4-ppc64le-install-service -d /tmp/mm/osimage/
- Import cluster inventory file to xcat database
# xcat-inventory import -f /tmp/cluster
- Import "node" and "network" objects from inventory file to xcat database
# xcat-inventory import -f /tmp/cluster -t node,network
- Import a network object from cluster inventory file
# xcat-inventory import -f /tmp/cluster -t network -o 192_168_122_0-255_255_255_0
- Import cluster inventory data from an inventory directory
# xcat-inventory import -d /tmp/mm/
- Import an osimage object from cluster inventory directory
# xcat-inventory import -d /tmp/mm/ -t osimage -o sles12.2-ppc64le-install-compute
- Import an osimage inventory directory
# xcat-inventory import -d /tmp/mm/osimage/rhels7.4-x86_64-netboot-compute/
- Import osimage inventory file with variables
# xcat-inventory import -e GITREPO=/tmp/ -e SWDIR=/tmp -f /tmp/osimage/osimage.withvar.yaml
The format of variables in osimage inventory file is {{<variable name>}}
This section presents some typical usecases xcat-inventory usecase
For any bugs or feature request, please open ticket in issues