Use the HMC Scanner to quickly extract all the details of the POWER Servers the HMC is connected too and saved in a Microsoft Excel spreadsheet.
The tool is available at the end of this document as a compressed file that needs to be extracted on an empty directory. Latest version is " hmcScanner-0.11.42.zip".
|HMC Scanner is a Java program that uses SSH to connect to an HMC or SDMC or FSM or IVM (IVM is experimental). It downloads the system configuration and produces a single Excel spreadsheet that contains the configuration of servers and LPARs. In PureFlex environments, only Power Systems compute nodes are detected. Optional HTML and CSV outputs are available.|
The result is a simple way to document configuration and to easily look at most important configuration parameters.
Excel information is organized in tabs:
- System summary: name, serial number, cores, memory, service processor IP for each server
- LPAR Summary: list of all LPAR by serve with status, environment, version, processor mode
- LPAR CPU: processor configuration of each LPAR
- LPAR MEM: memory configuration of each LPAR
- Physical Slots: list of all slots of each system with LPAR assignment, description, physical location, drc_index
- Virtual Ethernet: network configuration of each virtual switch and each LPAR
- Virtual SCSI: configuration of all virtual SCSI adapters, both client and server
- VSCSI Map: devices mapped by each VIOS to partitions
- Virtual Fibre: Virtual Fibre channel configuration of client and server with identification of physical adapter assigned
- SEA: SEA configuration and statistics for all VIOS
- SW Cores: LPAR and virtual processor pool configuration matrix to compute the number of software licenses. Simulation of alternative scenarios is possible.
- CPU Pool Usage: monthly average history of CPU usage of each system.
- Sys RAM Usage: monthly average history of physical memory assignement to each LPAR.
- LPAR CPU Usage:monthly average history of CPU usage of each LPAR.
- CPU Pool Daily Usage: 1 year of CPU usage of every pool and subpools of each system. Based on daily averages.
- LPAR Daily Usage: 1 year of CPU usage of every LPAR of each system. Based on daily averages.
- CPU Pool HourlyUsage: 2 months of CPU usage of every pool and sub-pools of each system. Based on hourly averages.
- LPAR Hourly Usage: 2 months of CPU usage of every LPAR of each system. Based on hourly averages.
The tool is constantly updated to match changes in tool syntax and to manage new data types or new features. If you have any problem or any suggestion to improve HMC Scanner, send me (Federico Vagnini in IBM, Italy) an mail (email@example.com). Since new features are mostly suggested by users, propose yours! Always include the downloaded files to allow be proper debugging.
This tool is not officially supported by IBM. No guarantee is given or implied, and you cannot obtain help from IBM. It a personal project of the author, Federico Vagnini (IBM Italy).
See also pGraph page form the same author. It allows multiple nmon, vmstat, iostat, sar, lslparutil files to be loaded regardless of their size. Graphs are provided together with a useful "time zoom" that allows you to select the time period to show.
There are few parameters that can be changed in order to override default setup. Run the batch file with no parameters to get syntax help or use full java syntax:
hmcScanner.Loader <HMC name/IP> <user> [-p <password>] [-dir <local dir>] [-perf <start> <end> <d|h>] [-readlocal] [-key [file] ] [-stats] [-sanitize] [-csv] [-csvchar <char>] [-html] [-log <file>] [-proxy <http|socks4|socks5> <host> <port> [user] [password] ] [-m <managed system>] [-timeout <secconds>] [-novios] -dir <local dir> is the directory where data will be stored. Default is current directory. -perf <start> and <end> is data collection retrieval interval. Syntax is: YYYYMMDD <d|h> d=daily data samples; h=hourly data samples -readlocal will force reading of existing local data without contacting HMC -key will use OpenSSH private key (default $HOME/.ssh/id_rsa) -stats will produce system statistics. It does NOT require -perf! -sanitize will remove sensitive data. -csv creates one .csv file for each sheet in a separate directory. -csvchar defines che separator char is CSV (default is comma). -html creates HTML report in a separate directory. -log <file> logs SSH activity into file -proxy <http|socks4|socks5> <host> <port> [user] [password] select proxy type, host, port to use for SSH communication -m <managed system> restrics the scan to the provided managed system -timeout <seconds> Timeout SSH connection after idle seconds. Use with care! Default is no timeout. -csvdir <directory> directory where csv files will be written. Default is <hmc>_<date>_<time>_CSV -htmldir <directory> directory where html files will be written. Default is <hmc>_<date>_<time>_HTML -novios do not collect data from VIOS to speed up pure hw config scanning.
The spreadsheet file can be generated again from already downloaded files by using the -readlocal switch. HMC is not contacted.
In order to have in the spreadsheet the tabs with the history of CPU and memory usage, the HMC must collect performance data and you have to provide the -stats switch. Allow some more time to download the data.
The -perf switch has no effect in spreadsheet content. It is just a simple way to download lslparutil data from HMC in raw format. It can be later loaded by tools like pGraph.
- LPAR names with commas prevent hmcScanner from working. Best practice is to have alphanumeric characters and underscore.
- If you encounter Java memory errors, change maximum Java allowed values by editing script and adding "-Xmx1024m" before "hmcScanner.Loader"
- VIOS partitions with a huge set of disks can require a long time to download data. Allow hmcScanner to run and finish or use -novios to skip data collection from VIOS
If you find errors or have question, email me:
- Subject: HMC Scanner
- E-mail: firstname.lastname@example.org
- Which kind of information can be retrieved by hmcScanner and how?
- hmcScanner runs commands on HMC only and can retrieve only information known by HMC. The LPARs present on managed systems are not contacted by any means. The HMC uses RMC protocol to contact the LPAR to get some information but is it not able to run operating system commands. Only exception is VIOS: HMC can use RMC protocol to run padmin commands and hmcScanner exploits this option to get VIOS specific configuration.
- The data related to VIOS configuration is missing in hmcScanner report
- When RMC protocol is not working, HMC can not run commands on a VIOS. Ensure that there is network connectivity between HMC and VIOS and that no firewall blocks TCP/UDP on port 657 bidirectional. The protocol is the same used by dynamic LPAR reconfiguration. The RMC status is shown in hmcScanner report under LPAR_Summary tab under RMC State column.
- The operating system version in the report is missing or obsolete
- Operating system version is detected by HMC by using RMC protocol. If protocol is not working the value can not be identified or updated. Updates are not immediately available. Please run the following command on all managed systems: lssyscfg -r lpar -m <managed system> --osrefresh -F name, os_version
- There is no performance data in the report even if I use -stats flag, or data is present only for some LPARs
- Performance data needs to be enabled on the HMC for each managed system. By default it is not activated. You can see the status in the report in the System_Summary tab under the Per Sample Rate column: if the cell is empty or has a zero value, data collection is not active. You can enable the data collection on the GUI looking at managed system menu or by using the CLI: chlparutil -r config -s <seconds> -m <managed system> (I suggest 30 minutes) or chlparutil -r config -s <seconds> for all managed systems. If you add a new managed system it will not have collection enabled. If you have a dual HMC setup and want both HMCs to collect data, you need to enable collection on both HMCs.
- I see performance data on the report but I was expecting more data
- There is currently a bug on HMC software that prevents a full extraction of performance data using lslparutil command as hmcScanner does. In order to fix the issue you need to upgrade the HMC code version V8 R8.2 Service pack 2 or later (PTF MH01488 HMC V8 R8.2.0 Service Pack 2)
Was this topic helpful?
02 May 2022