Skip to main content

A CLI for the IBM Z HMC, written in pure Python

Project description

zhmccli - A CLI for the IBM Z HMC, written in pure Python

Version on Pypi Travis test status (master) Appveyor test status (master) Docs build status (latest) Test coverage (master) Code Climate

Overview

The zhmccli package is a CLI written in pure Python that interacts with the Hardware Management Console (HMC) of IBM Z or LinuxONE machines. The goal of this package is to provide an easy-to-use command line interface for operators.

The zhmccli package uses the API provided by the zhmcclient package, which interacts with the Web Services API of the HMC. It supports management of the lifecycle and configuration of various platform resources, such as partitions, CPU, memory, virtual switches, I/O adapters, and more.

Installation

The quick way:

$ pip install zhmccli

For more details, see the Installation section in the documentation.

Quickstart

The following example code lists the machines (CPCs) managed by an HMC:

$ hmc_host="<IP address or hostname of the HMC>"
$ hmc_userid="<userid on that HMC>"
$ zhmc -h $hmc_host -u $hmc_userid cpc list
Enter password (for user <hmc_user> at HMC <hmc_host>): .......
+----------+------------------+
| name     | status           |
|----------+------------------|
| P000S67B | service-required |
+----------+------------------+

Documentation

The zhmccli documentation is on RTD:

Contributing

For information on how to contribute to this project, see the Development section in the documentation.

License

The zhmccli package is licensed under the Apache 2.0 License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zhmccli-0.19.0.tar.gz (87.8 kB view hashes)

Uploaded Source

Built Distribution

zhmccli-0.19.0-py2.py3-none-any.whl (51.1 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page