fvagnini/hmcscanner repository overview

This image scans a Power HMC and produces an Excel report with all collected data. Numeric tags are multi platform image for both ppc64le and amd64 systems and should be preferred.

The container connects to the HMC using the port 443 and uses HMC's credentials. It has been tested with HMC v11 code.

The container's configuration is made by providing a configuration file that sets environmental values and providing a volume to allow the report to be collected once the container completes the job.

A sample configuration file named setup.txt is the following:

HMC=172.17.251.91
USER=hscroot
PASSWORD=abc123
DATADIR=/data
EXCEL=/data/excel.xlsx

It provides the HMC address and credentials for connection.

DATADIR is the directory inside the container where all generated data will be created

EXCEL is the name of the report written inside the container

In order to obtain the data from your environment you need to provide a volume to the container. The easiest way is to create a directory that is world writeable and mount it to the DATADIR path inside the container:

mkdir datadir
chmod 777 datadir
podman run --rm --pull=always -v ./datadir:/data:z --env-file setup.txt fvagnini/hmcscanner

This assumes that you are using the above setup.txt that stores all data in /data directory that is where ./datadir is mounted.

Keep --pull=always to be sure to have latest code or you will use your locally cached version.

You will find the report datadir/excel.xlsx together with all data downloaded by the scanner and application logs.

hmcScanner will provide a progression log on the console. If issues occour, a debug.zip file will be generated with instruction on how to use it.

Tag summary