POCCI(1)

NAME
pOCCI - OCCI compliance testing and client

SYNOPSIS
pOCCI [OPTIONS]

DESCRIPTION
pOCCI is OCCI implementation written in python. pOCCI tool performs OCCI compliance testing as described in: http://www.etsi.org/deliver/etsi_ts/103100_103199/103142/01.01.01_60/ts_103142v010101p.pdf.

OPTIONS

-h, --help
    Usage message.

-a, --auth-type AUTH-TYPE
    Authentication type to use. Default is basic. Available values: basic, x509.

-c, --cert FILE
    User SSL certificate file, if x509 autentization is used.

-e, --endpoint, --url URL
    OCCI server endpoint. For example: https://example.com:11443.

-f, --format FORMAT
    Output format (plain, json, html, htmltable). Default is json.

-k, --key FILE
    User SSL key file, if x509 autentization is used.

-l, --list
    Get list of all OCCI compliance tests.

-m, --mime-type MIME-TYPE
    Render format to communicate with OCCI server. If text/occi is selected, listing of categories is performed through text/plain due to HTTP Headers size limitations. Default is text/plain. Possible values: text/plain, text/occi, text/occi+plain.

-p, --password PASSWORD
    User password, if basic autentization is used.

-P, --passphrase PASSPHRASE
    Passphrase for SSL user key, if x509 autentization is used. Default is no passphrase.

-s, --keystone
    Keystone tenant for authentication.

-S, --ignore-ssl
    Ignore SSL errors. Default is false.

-t, --tests TEST1,...
    List of OCCI compliance tests to perform. Separated by commas.

-u, --user USER
    User name, if basic autentization is used.

-v, --verbose
    Verbose mode: communication, HTTP Headers, transferred data.

-V, --version
    Print version information.

EXIT STATUS

0   All OCCI compliance tests OK.

1   Some OCCI compliance tests FAILED.

2   Error from OCCI testsuite framework.

ENVIRONMENT

X509_CERT_DIR
    CA path to use.

X509_USER_PROXY
    User proxy certificate file to use, if --cert option is not specified.

FILES

~/.pOCCI.cfg, /etc/pOCCI.cfg
    pOCCI configuration file. Available options and default values:
     * url
     * authtype = 'basic'
     * capath = '/etc/grid-security/certificates'
     * cachain
     * ignoressl = False
     * user
     * passwd
     * cert
     * key
     * passphrase
     * keystone
     * curlverbose = False
     * connectiontimeout = 60
     * timeout = 120
     * mimetype = 'text/plain'
     * outputformat = 'json'
     * occi.tests.category = {'term': 'compute', 'class': 'kind', 'scheme': 'http://schemas.ogf.org/occi/infrastructure#'}
     * occi.tests.entity = {}

EXAMPLES

pOCCI.cfg file example:
    [main]
    url = 'https://example.com:11443'
    authtype = 'basic'
    ignoressl = False
    user = 'oneadmin'
    passwd = 'good-password'
    mimetype = 'text/plain'
    outputformat = 'json'
    curlverbose = False
    connectiontimeout = 60
    timeout = 120
    occi.tests.entity = {'occi.core.title': 'one-172'}

BUGS
Please report all bugs to issue tracker at https://github.com/CESNET/pOCCI/issues.

AUTHORS
CESNET