Metadata-Version: 2.0
Name: cinderdiags
Version: 2.2.2
Summary: UNKNOWN
Home-page: http://github.com/hp-storage/diags
Author: HPE Storage Cloud Team
Author-email: richard.hagarty@hpe.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: pbr (>=1.8)
Requires-Dist: python-3parclient (>=4.0)
Requires-Dist: python-lefthandclient (>=2.0)

===============================
cinderdiags
===============================

HPE Storage OpenStack Cinder Diagnostic CLI

* Free software: Apache license

Overview
---------

This CLI tool can be used to validate a user cinder.conf file and also
to verify software installed on Cinder and Nova nodes.

** Note that versions >= 2.0.0 of this package only work with the re-branded versions of the "HPE" cinder drivers.
To run against the older "HP" cinder drivers, please install the latest 1.0.x version of this package.

Requirements
------------

| cliff
| cliff-tab
| python-3parclient

Installation instructions
-------------------------

pip install cinderdiags

Running the CLI
---------------

To view command options::

    cinderdiags --help

Example commands::

    cinderdiags help options-check
    cinderdiags options-check -v
    cinderdiags help software-check
    cinderdiags software-check --log-file tmp.txt
    cinderdiags software-check -software python-lefthandclient --package-min-version 2.0.0

Configuration File
------------------

Before executing cinderdiags, the user must create a cli.conf configuration file. The following
example shows the required fields and format::

    [MY-CINDER-NODE]                         # required section name - must be unique
    service=cinder                           # service type = cinder or nova
    host_ip=15.125.224.1                     # host system where service is running
    ssh_user=admin                           # SSH credentials for host system
    ssh_password=admin
    conf_source=/etc/cinder/cinder.conf      # if cinder node, location of cinder config file

    [MY-NOVA-NODE]
    service=nova
    host_ip=15.125.224.1
    ssh_user=admin

By default, this file needs to exist in the /etc/cinderdiags/ directory. Alternatively, this file
path can be passed into the CLI command using the argument '-conf-file <file path>'.



