CLI Tools Reference

shaker

Executes specified scenario in OpenStack cloud, stores results and generates HTML report.

usage: shaker [-h] [--agent-dir AGENT_DIR]
              [--agent-join-timeout AGENT_JOIN_TIMEOUT]
              [--agent-loss-timeout AGENT_LOSS_TIMEOUT]
              [--artifacts-dir ARTIFACTS_DIR] [--book BOOK]
              [--cleanup-on-exit] [--config-dir DIR] [--config-file PATH]
              [--custom-user-opts CUSTOM_USER_OPTS] [--debug]
              [--dns-nameservers DNS_NAMESERVERS]
              [--external-net EXTERNAL_NET] [--flavor-name FLAVOR_NAME]
              [--image-name IMAGE_NAME] [--log-config-append PATH]
              [--log-date-format DATE_FORMAT] [--log-dir LOG_DIR]
              [--log-file PATH] [--matrix MATRIX] [--no-report-on-error]
              [--nocleanup-on-exit] [--nodebug] [--nono-report-on-error]
              [--noos-insecure] [--nouse-journal] [--nouse-json]
              [--nouse-syslog] [--nowatch-log-file] [--os-auth-url <auth-url>]
              [--os-cacert <auth-cacert>]
              [--os-identity-api-version <identity-api-version>]
              [--os-insecure] [--os-interface <os-interface>]
              [--os-password <auth-password>] [--os-profile <hmac-key>]
              [--os-project-domain-name <auth-project-domain-name>]
              [--os-project-name <auth-project-name>]
              [--os-region-name <auth-region-name>]
              [--os-tenant-name <auth-tenant-name>]
              [--os-user-domain-name <auth-user-domain-name>]
              [--os-username <auth-username>] [--output OUTPUT]
              [--polling-interval POLLING_INTERVAL] [--report REPORT]
              [--report-template REPORT_TEMPLATE]
              [--reuse-stack-name REUSE_STACK_NAME] [--scenario SCENARIO]
              [--scenario-availability-zone SCENARIO_AVAILABILITY_ZONE]
              [--scenario-compute-nodes SCENARIO_COMPUTE_NODES]
              [--server-endpoint SERVER_ENDPOINT] [--stack-name STACK_NAME]
              [--subunit SUBUNIT] [--syslog-log-facility SYSLOG_LOG_FACILITY]
              [--use-journal] [--use-json] [--use-syslog] [--watch-log-file]

optional arguments:
  -h, --help            show this help message and exit
  --agent-dir AGENT_DIR
                        If specified, directs Shaker to write execution script
                        for the shell class in agent(s) instance defined
                        directory. Defaults to /tmp directory.
  --agent-join-timeout AGENT_JOIN_TIMEOUT
                        Timeout to treat agent as join failed in seconds,
                        defaults to env[SHAKER_AGENT_JOIN_TIMEOUT] (time
                        between stack deployment and start of scenario
                        execution).
  --agent-loss-timeout AGENT_LOSS_TIMEOUT
                        Timeout to treat agent as lost in seconds, defaults to
                        env[SHAKER_AGENT_LOSS_TIMEOUT]
  --artifacts-dir ARTIFACTS_DIR
                        If specified, directs Shaker to store there all its
                        artifacts (output, report, subunit and book). Defaults
                        to env[SHAKER_ARTIFACTS_DIR].
  --book BOOK           Generate report in ReST format and store it into the
                        specified folder, defaults to env[SHAKER_BOOK].
  --cleanup-on-exit     Clean up the heat-stack when exiting execution.
  --config-dir DIR      Path to a config directory to pull `*.conf` files
                        from. This file set is sorted, so as to provide a
                        predictable parse order if individual options are
                        over-ridden. The set is parsed after the file(s)
                        specified via previous --config-file, arguments hence
                        over-ridden options in the directory take precedence.
                        This option must be set from the command-line.
  --config-file PATH    Path to a config file to use. Multiple config files
                        can be specified, with values in later files taking
                        precedence. Defaults to None. This option must be set
                        from the command-line.
  --custom-user-opts CUSTOM_USER_OPTS
                        Set custom user option parameters for the scenario.
                        The value is specified in YAML, e.g. custom_user_opts
                        = { key1:value1, key2:value2} The values specified can
                        be referenced in the usual python way. e.g. {{
                        CONF.custom_user_opts['key1'] }}. This option is
                        useful to inject custom values into heat environment
                        files
  --debug, -d           If set to true, the logging level will be set to DEBUG
                        instead of the default INFO level.
  --dns-nameservers DNS_NAMESERVERS
                        Comma-separated list of IPs of the DNS nameservers for
                        the subnets. If no value is provided defaults to
                        Google Public DNS.
  --external-net EXTERNAL_NET
                        Name or ID of external network, defaults to
                        env[SHAKER_EXTERNAL_NET]. If no value provided then
                        Shaker picks any of available external networks.
  --flavor-name FLAVOR_NAME
                        Name of image flavor. The default is created by
                        shaker-image-builder.
  --image-name IMAGE_NAME
                        Name of image to use. The default is created by
                        shaker-image-builder.
  --log-config-append PATH, --log-config PATH, --log_config PATH
                        The name of a logging configuration file. This file is
                        appended to any existing logging configuration files.
                        For details about logging configuration files, see the
                        Python logging module documentation. Note that when
                        logging configuration files are used then all logging
                        configuration is set in the configuration file and
                        other logging configuration options are ignored (for
                        example, log-date-format).
  --log-date-format DATE_FORMAT
                        Defines the format string for %(asctime)s in log
                        records. Default: None . This option is ignored if
                        log_config_append is set.
  --log-dir LOG_DIR, --logdir LOG_DIR
                        (Optional) The base directory used for relative
                        log_file paths. This option is ignored if
                        log_config_append is set.
  --log-file PATH, --logfile PATH
                        (Optional) Name of log file to send logging output to.
                        If no default is set, logging will go to stderr as
                        defined by use_stderr. This option is ignored if
                        log_config_append is set.
  --matrix MATRIX       Set the matrix of parameters for the scenario. The
                        value is specified in YAML format. E.g. to override
                        the scenario duration one may provide: "{time: 10}",
                        or to override list of hosts: "{host:[ping.online.net,
                        iperf.eenet.ee]}". When several parameters are
                        overridden all combinations are tested
  --no-report-on-error  Do not generate report for failed scenarios
  --nocleanup-on-exit   The inverse of --cleanup-on-exit
  --nodebug             The inverse of --debug
  --nono-report-on-error
                        The inverse of --no-report-on-error
  --noos-insecure       The inverse of --os-insecure
  --nouse-journal       The inverse of --use-journal
  --nouse-json          The inverse of --use-json
  --nouse-syslog        The inverse of --use-syslog
  --nowatch-log-file    The inverse of --watch-log-file
  --os-auth-url <auth-url>
                        Authentication URL, defaults to env[OS_AUTH_URL].
  --os-cacert <auth-cacert>
                        Location of CA Certificate, defaults to
                        env[OS_CACERT].
  --os-identity-api-version <identity-api-version>
                        Identity API version, defaults to
                        env[OS_IDENTITY_API_VERSION].
  --os-insecure         When using SSL in connections to the registry server,
                        do not require validation via a certifying authority,
                        defaults to env[OS_INSECURE].
  --os-interface <os-interface>
                        Interface type. Valid options are public, admin and
                        internal. defaults to env[OS_INTERFACE].
  --os-password <auth-password>
                        Authentication password, defaults to env[OS_PASSWORD].
  --os-profile <hmac-key>
                        HMAC key for encrypting profiling context data,
                        defaults to env[OS_PROFILE].
  --os-project-domain-name <auth-project-domain-name>
                        Authentication project domain name. Defaults to
                        env[OS_PROJECT_DOMAIN_NAME].
  --os-project-name <auth-project-name>
                        Authentication project name. This option is mutually
                        exclusive with --os-tenant-name. Defaults to
                        env[OS_PROJECT_NAME].
  --os-region-name <auth-region-name>
                        Authentication region name, defaults to
                        env[OS_REGION_NAME].
  --os-tenant-name <auth-tenant-name>
                        Authentication tenant name, defaults to
                        env[OS_TENANT_NAME].
  --os-user-domain-name <auth-user-domain-name>
                        Authentication username. Defaults to
                        env[OS_USER_DOMAIN_NAME].
  --os-username <auth-username>
                        Authentication username, defaults to env[OS_USERNAME].
  --output OUTPUT       File for output in JSON format, defaults to
                        env[SHAKER_OUTPUT]. If it is empty, then output will
                        be saved to /tmp/shaker_<time_now>.json
  --polling-interval POLLING_INTERVAL
                        How frequently the agent polls server, in seconds
  --report REPORT       Report file name, defaults to env[SHAKER_REPORT].
  --report-template REPORT_TEMPLATE
                        Template for report. Can be a file name or one of
                        aliases: "interactive", "json". Defaults to
                        "interactive".
  --reuse-stack-name REUSE_STACK_NAME
                        Name of an existing Shaker heat stack to reuse. The
                        default is to not reuse an existing stack. Caution
                        should be taken to only reuse stacks meant for a
                        specific scenario. Also certain configs e.g. image-
                        name, flavor-name, stack-name, etc will be ignored
                        when reusing an existing stack.
  --scenario SCENARIO   Comma-separated list of scenarios to play. Each entity
                        can be a file name or one of aliases:
                        "misc/instance_metadata",
                        "openstack/cross_az/full_l2",
                        "openstack/cross_az/full_l3_east_west",
                        "openstack/cross_az/full_l3_north_south",
                        "openstack/cross_az/perf_l2",
                        "openstack/cross_az/perf_l3_east_west",
                        "openstack/cross_az/perf_l3_north_south",
                        "openstack/cross_az/udp_l2",
                        "openstack/cross_az/udp_l2_mss8950",
                        "openstack/cross_az/udp_l3_east_west",
                        "openstack/dense_l2", "openstack/dense_l3_east_west",
                        "openstack/dense_l3_north_south",
                        "openstack/external/dense_l3_north_south_no_fip",
                        "openstack/external/dense_l3_north_south_with_fip",
                        "openstack/external/full_l3_north_south_no_fip",
                        "openstack/external/full_l3_north_south_with_fip",
                        "openstack/external/perf_l3_north_south_no_fip",
                        "openstack/external/perf_l3_north_south_with_fip",
                        "openstack/full_l2", "openstack/full_l3_east_west",
                        "openstack/full_l3_north_south", "openstack/perf_l2",
                        "openstack/perf_l3_east_west",
                        "openstack/perf_l3_north_south",
                        "openstack/qos/perf_l2", "openstack/udp_l2",
                        "openstack/udp_l3_east_west",
                        "openstack/udp_l3_north_south", "spot/ping",
                        "spot/tcp", "spot/udp". Defaults to
                        env[SHAKER_SCENARIO].
  --scenario-availability-zone SCENARIO_AVAILABILITY_ZONE
                        Comma-separated list of availability_zone. If
                        specified this setting will override the
                        availability_zone accomodation setting in the scenario
                        test definition.Defaults to SCENARIO_AVAILABILITY_ZONE
  --scenario-compute-nodes SCENARIO_COMPUTE_NODES
                        Number of compute_nodes. If specified this setting
                        will override the compute_nodes accomodation setting
                        in the scenario test definition. Defaults to
                        SCENARIO_COMPUTE_NODES
  --server-endpoint SERVER_ENDPOINT
                        Address for server connections (host:port), defaults
                        to env[SHAKER_SERVER_ENDPOINT].
  --stack-name STACK_NAME
                        Name of test heat stack. The default is a uniquely
                        generated name.
  --subunit SUBUNIT     Subunit stream file name, defaults to
                        env[SHAKER_SUBUNIT].
  --syslog-log-facility SYSLOG_LOG_FACILITY
                        Syslog facility to receive log lines. This option is
                        ignored if log_config_append is set.
  --use-journal         Enable journald for logging. If running in a systemd
                        environment you may wish to enable journal support.
                        Doing so will use the journal native protocol which
                        includes structured metadata in addition to log
                        messages.This option is ignored if log_config_append
                        is set.
  --use-json            Use JSON formatting for logging. This option is
                        ignored if log_config_append is set.
  --use-syslog          Use syslog for logging. Existing syslog format is
                        DEPRECATED and will be changed later to honor RFC5424.
                        This option is ignored if log_config_append is set.
  --watch-log-file      Uses logging handler designed to watch file system.
                        When log file is moved or removed this handler will
                        open a new log file with specified path
                        instantaneously. It makes sense only if log_file
                        option is specified and Linux platform is used. This
                        option is ignored if log_config_append is set.

shaker-spot

Executes specified scenario from the local node, stores results and generates HTML report.

usage: shaker-spot [-h] [--artifacts-dir ARTIFACTS_DIR] [--book BOOK]
                   [--config-dir DIR] [--config-file PATH]
                   [--custom-user-opts CUSTOM_USER_OPTS] [--debug]
                   [--log-config-append PATH] [--log-date-format DATE_FORMAT]
                   [--log-dir LOG_DIR] [--log-file PATH] [--matrix MATRIX]
                   [--no-report-on-error] [--nodebug] [--nono-report-on-error]
                   [--nouse-journal] [--nouse-json] [--nouse-syslog]
                   [--nowatch-log-file] [--output OUTPUT] [--report REPORT]
                   [--report-template REPORT_TEMPLATE] [--scenario SCENARIO]
                   [--scenario-availability-zone SCENARIO_AVAILABILITY_ZONE]
                   [--scenario-compute-nodes SCENARIO_COMPUTE_NODES]
                   [--subunit SUBUNIT]
                   [--syslog-log-facility SYSLOG_LOG_FACILITY] [--use-journal]
                   [--use-json] [--use-syslog] [--watch-log-file]

optional arguments:
  -h, --help            show this help message and exit
  --artifacts-dir ARTIFACTS_DIR
                        If specified, directs Shaker to store there all its
                        artifacts (output, report, subunit and book). Defaults
                        to env[SHAKER_ARTIFACTS_DIR].
  --book BOOK           Generate report in ReST format and store it into the
                        specified folder, defaults to env[SHAKER_BOOK].
  --config-dir DIR      Path to a config directory to pull `*.conf` files
                        from. This file set is sorted, so as to provide a
                        predictable parse order if individual options are
                        over-ridden. The set is parsed after the file(s)
                        specified via previous --config-file, arguments hence
                        over-ridden options in the directory take precedence.
                        This option must be set from the command-line.
  --config-file PATH    Path to a config file to use. Multiple config files
                        can be specified, with values in later files taking
                        precedence. Defaults to None. This option must be set
                        from the command-line.
  --custom-user-opts CUSTOM_USER_OPTS
                        Set custom user option parameters for the scenario.
                        The value is specified in YAML, e.g. custom_user_opts
                        = { key1:value1, key2:value2} The values specified can
                        be referenced in the usual python way. e.g. {{
                        CONF.custom_user_opts['key1'] }}. This option is
                        useful to inject custom values into heat environment
                        files
  --debug, -d           If set to true, the logging level will be set to DEBUG
                        instead of the default INFO level.
  --log-config-append PATH, --log-config PATH, --log_config PATH
                        The name of a logging configuration file. This file is
                        appended to any existing logging configuration files.
                        For details about logging configuration files, see the
                        Python logging module documentation. Note that when
                        logging configuration files are used then all logging
                        configuration is set in the configuration file and
                        other logging configuration options are ignored (for
                        example, log-date-format).
  --log-date-format DATE_FORMAT
                        Defines the format string for %(asctime)s in log
                        records. Default: None . This option is ignored if
                        log_config_append is set.
  --log-dir LOG_DIR, --logdir LOG_DIR
                        (Optional) The base directory used for relative
                        log_file paths. This option is ignored if
                        log_config_append is set.
  --log-file PATH, --logfile PATH
                        (Optional) Name of log file to send logging output to.
                        If no default is set, logging will go to stderr as
                        defined by use_stderr. This option is ignored if
                        log_config_append is set.
  --matrix MATRIX       Set the matrix of parameters for the scenario. The
                        value is specified in YAML format. E.g. to override
                        the scenario duration one may provide: "{time: 10}",
                        or to override list of hosts: "{host:[ping.online.net,
                        iperf.eenet.ee]}". When several parameters are
                        overridden all combinations are tested
  --no-report-on-error  Do not generate report for failed scenarios
  --nodebug             The inverse of --debug
  --nono-report-on-error
                        The inverse of --no-report-on-error
  --nouse-journal       The inverse of --use-journal
  --nouse-json          The inverse of --use-json
  --nouse-syslog        The inverse of --use-syslog
  --nowatch-log-file    The inverse of --watch-log-file
  --output OUTPUT       File for output in JSON format, defaults to
                        env[SHAKER_OUTPUT]. If it is empty, then output will
                        be saved to /tmp/shaker_<time_now>.json
  --report REPORT       Report file name, defaults to env[SHAKER_REPORT].
  --report-template REPORT_TEMPLATE
                        Template for report. Can be a file name or one of
                        aliases: "interactive", "json". Defaults to
                        "interactive".
  --scenario SCENARIO   Comma-separated list of scenarios to play. Each entity
                        can be a file name or one of aliases:
                        "misc/instance_metadata",
                        "openstack/cross_az/full_l2",
                        "openstack/cross_az/full_l3_east_west",
                        "openstack/cross_az/full_l3_north_south",
                        "openstack/cross_az/perf_l2",
                        "openstack/cross_az/perf_l3_east_west",
                        "openstack/cross_az/perf_l3_north_south",
                        "openstack/cross_az/udp_l2",
                        "openstack/cross_az/udp_l2_mss8950",
                        "openstack/cross_az/udp_l3_east_west",
                        "openstack/dense_l2", "openstack/dense_l3_east_west",
                        "openstack/dense_l3_north_south",
                        "openstack/external/dense_l3_north_south_no_fip",
                        "openstack/external/dense_l3_north_south_with_fip",
                        "openstack/external/full_l3_north_south_no_fip",
                        "openstack/external/full_l3_north_south_with_fip",
                        "openstack/external/perf_l3_north_south_no_fip",
                        "openstack/external/perf_l3_north_south_with_fip",
                        "openstack/full_l2", "openstack/full_l3_east_west",
                        "openstack/full_l3_north_south", "openstack/perf_l2",
                        "openstack/perf_l3_east_west",
                        "openstack/perf_l3_north_south",
                        "openstack/qos/perf_l2", "openstack/udp_l2",
                        "openstack/udp_l3_east_west",
                        "openstack/udp_l3_north_south", "spot/ping",
                        "spot/tcp", "spot/udp". Defaults to
                        env[SHAKER_SCENARIO].
  --scenario-availability-zone SCENARIO_AVAILABILITY_ZONE
                        Comma-separated list of availability_zone. If
                        specified this setting will override the
                        availability_zone accomodation setting in the scenario
                        test definition.Defaults to SCENARIO_AVAILABILITY_ZONE
  --scenario-compute-nodes SCENARIO_COMPUTE_NODES
                        Number of compute_nodes. If specified this setting
                        will override the compute_nodes accomodation setting
                        in the scenario test definition. Defaults to
                        SCENARIO_COMPUTE_NODES
  --subunit SUBUNIT     Subunit stream file name, defaults to
                        env[SHAKER_SUBUNIT].
  --syslog-log-facility SYSLOG_LOG_FACILITY
                        Syslog facility to receive log lines. This option is
                        ignored if log_config_append is set.
  --use-journal         Enable journald for logging. If running in a systemd
                        environment you may wish to enable journal support.
                        Doing so will use the journal native protocol which
                        includes structured metadata in addition to log
                        messages.This option is ignored if log_config_append
                        is set.
  --use-json            Use JSON formatting for logging. This option is
                        ignored if log_config_append is set.
  --use-syslog          Use syslog for logging. Existing syslog format is
                        DEPRECATED and will be changed later to honor RFC5424.
                        This option is ignored if log_config_append is set.
  --watch-log-file      Uses logging handler designed to watch file system.
                        When log file is moved or removed this handler will
                        open a new log file with specified path
                        instantaneously. It makes sense only if log_file
                        option is specified and Linux platform is used. This
                        option is ignored if log_config_append is set.

shaker-image-builder

Builds base image in OpenStack cloud. The image is based on Ubuntu cloud image distro and configured to run shaker-agent.

usage: shaker-image-builder [-h] [--cleanup-on-exit] [--config-dir DIR]
                            [--config-file PATH] [--debug]
                            [--dns-nameservers DNS_NAMESERVERS]
                            [--external-net EXTERNAL_NET]
                            [--flavor-disk FLAVOR_DISK]
                            [--flavor-name FLAVOR_NAME]
                            [--flavor-ram FLAVOR_RAM]
                            [--flavor-vcpus FLAVOR_VCPUS]
                            [--image-builder-distro IMAGE_BUILDER_DISTRO]
                            [--image-builder-mode IMAGE_BUILDER_MODE]
                            [--image-builder-template IMAGE_BUILDER_TEMPLATE]
                            [--image-name IMAGE_NAME]
                            [--log-config-append PATH]
                            [--log-date-format DATE_FORMAT]
                            [--log-dir LOG_DIR] [--log-file PATH]
                            [--nocleanup-on-exit] [--nodebug]
                            [--noos-insecure] [--nouse-journal] [--nouse-json]
                            [--nouse-syslog] [--nowatch-log-file]
                            [--os-auth-url <auth-url>]
                            [--os-cacert <auth-cacert>]
                            [--os-identity-api-version <identity-api-version>]
                            [--os-insecure] [--os-interface <os-interface>]
                            [--os-password <auth-password>]
                            [--os-profile <hmac-key>]
                            [--os-project-domain-name <auth-project-domain-name>]
                            [--os-project-name <auth-project-name>]
                            [--os-region-name <auth-region-name>]
                            [--os-tenant-name <auth-tenant-name>]
                            [--os-user-domain-name <auth-user-domain-name>]
                            [--os-username <auth-username>]
                            [--reuse-stack-name REUSE_STACK_NAME]
                            [--stack-name STACK_NAME]
                            [--syslog-log-facility SYSLOG_LOG_FACILITY]
                            [--use-journal] [--use-json] [--use-syslog]
                            [--watch-log-file]

optional arguments:
  -h, --help            show this help message and exit
  --cleanup-on-exit     Clean up the heat-stack when exiting execution.
  --config-dir DIR      Path to a config directory to pull `*.conf` files
                        from. This file set is sorted, so as to provide a
                        predictable parse order if individual options are
                        over-ridden. The set is parsed after the file(s)
                        specified via previous --config-file, arguments hence
                        over-ridden options in the directory take precedence.
                        This option must be set from the command-line.
  --config-file PATH    Path to a config file to use. Multiple config files
                        can be specified, with values in later files taking
                        precedence. Defaults to None. This option must be set
                        from the command-line.
  --debug, -d           If set to true, the logging level will be set to DEBUG
                        instead of the default INFO level.
  --dns-nameservers DNS_NAMESERVERS
                        Comma-separated list of IPs of the DNS nameservers for
                        the subnets. If no value is provided defaults to
                        Google Public DNS.
  --external-net EXTERNAL_NET
                        Name or ID of external network, defaults to
                        env[SHAKER_EXTERNAL_NET]. If no value provided then
                        Shaker picks any of available external networks.
  --flavor-disk FLAVOR_DISK
                        Shaker image disk size in GB, defaults to
                        env[SHAKER_FLAVOR_DISK]
  --flavor-name FLAVOR_NAME
                        Name of image flavor. The default is created by
                        shaker-image-builder.
  --flavor-ram FLAVOR_RAM
                        Shaker image RAM size in MB, defaults to
                        env[SHAKER_FLAVOR_RAM]
  --flavor-vcpus FLAVOR_VCPUS
                        Number of cores to allocate for Shaker image, defaults
                        to env[SHAKER_FLAVOR_VCPUS]
  --image-builder-distro IMAGE_BUILDER_DISTRO
                        Operating System Distribution for shaker image when
                        using diskimage-builder, defaults to ubuntu Allowed
                        values: ubuntu, centos7
  --image-builder-mode IMAGE_BUILDER_MODE
                        Image building mode: "heat" - using Heat template
                        (requires Glance v1 for base image upload); "dib" -
                        using diskimage-builder elements (requires qemu-utils
                        and debootstrap). If not set, switches to "dib" if
                        Glance v1 is not available. Can be specified as
                        env[SHAKER_IMAGE_BUILDER_MODE] Allowed values: heat,
                        dib
  --image-builder-template IMAGE_BUILDER_TEMPLATE
                        Heat template containing receipt of building the
                        image. Can be a file name or one of aliases: "centos",
                        "debian", "ubuntu". Defaults to "ubuntu".
  --image-name IMAGE_NAME
                        Name of image to use. The default is created by
                        shaker-image-builder.
  --log-config-append PATH, --log-config PATH, --log_config PATH
                        The name of a logging configuration file. This file is
                        appended to any existing logging configuration files.
                        For details about logging configuration files, see the
                        Python logging module documentation. Note that when
                        logging configuration files are used then all logging
                        configuration is set in the configuration file and
                        other logging configuration options are ignored (for
                        example, log-date-format).
  --log-date-format DATE_FORMAT
                        Defines the format string for %(asctime)s in log
                        records. Default: None . This option is ignored if
                        log_config_append is set.
  --log-dir LOG_DIR, --logdir LOG_DIR
                        (Optional) The base directory used for relative
                        log_file paths. This option is ignored if
                        log_config_append is set.
  --log-file PATH, --logfile PATH
                        (Optional) Name of log file to send logging output to.
                        If no default is set, logging will go to stderr as
                        defined by use_stderr. This option is ignored if
                        log_config_append is set.
  --nocleanup-on-exit   The inverse of --cleanup-on-exit
  --nodebug             The inverse of --debug
  --noos-insecure       The inverse of --os-insecure
  --nouse-journal       The inverse of --use-journal
  --nouse-json          The inverse of --use-json
  --nouse-syslog        The inverse of --use-syslog
  --nowatch-log-file    The inverse of --watch-log-file
  --os-auth-url <auth-url>
                        Authentication URL, defaults to env[OS_AUTH_URL].
  --os-cacert <auth-cacert>
                        Location of CA Certificate, defaults to
                        env[OS_CACERT].
  --os-identity-api-version <identity-api-version>
                        Identity API version, defaults to
                        env[OS_IDENTITY_API_VERSION].
  --os-insecure         When using SSL in connections to the registry server,
                        do not require validation via a certifying authority,
                        defaults to env[OS_INSECURE].
  --os-interface <os-interface>
                        Interface type. Valid options are public, admin and
                        internal. defaults to env[OS_INTERFACE].
  --os-password <auth-password>
                        Authentication password, defaults to env[OS_PASSWORD].
  --os-profile <hmac-key>
                        HMAC key for encrypting profiling context data,
                        defaults to env[OS_PROFILE].
  --os-project-domain-name <auth-project-domain-name>
                        Authentication project domain name. Defaults to
                        env[OS_PROJECT_DOMAIN_NAME].
  --os-project-name <auth-project-name>
                        Authentication project name. This option is mutually
                        exclusive with --os-tenant-name. Defaults to
                        env[OS_PROJECT_NAME].
  --os-region-name <auth-region-name>
                        Authentication region name, defaults to
                        env[OS_REGION_NAME].
  --os-tenant-name <auth-tenant-name>
                        Authentication tenant name, defaults to
                        env[OS_TENANT_NAME].
  --os-user-domain-name <auth-user-domain-name>
                        Authentication username. Defaults to
                        env[OS_USER_DOMAIN_NAME].
  --os-username <auth-username>
                        Authentication username, defaults to env[OS_USERNAME].
  --reuse-stack-name REUSE_STACK_NAME
                        Name of an existing Shaker heat stack to reuse. The
                        default is to not reuse an existing stack. Caution
                        should be taken to only reuse stacks meant for a
                        specific scenario. Also certain configs e.g. image-
                        name, flavor-name, stack-name, etc will be ignored
                        when reusing an existing stack.
  --stack-name STACK_NAME
                        Name of test heat stack. The default is a uniquely
                        generated name.
  --syslog-log-facility SYSLOG_LOG_FACILITY
                        Syslog facility to receive log lines. This option is
                        ignored if log_config_append is set.
  --use-journal         Enable journald for logging. If running in a systemd
                        environment you may wish to enable journal support.
                        Doing so will use the journal native protocol which
                        includes structured metadata in addition to log
                        messages.This option is ignored if log_config_append
                        is set.
  --use-json            Use JSON formatting for logging. This option is
                        ignored if log_config_append is set.
  --use-syslog          Use syslog for logging. Existing syslog format is
                        DEPRECATED and will be changed later to honor RFC5424.
                        This option is ignored if log_config_append is set.
  --watch-log-file      Uses logging handler designed to watch file system.
                        When log file is moved or removed this handler will
                        open a new log file with specified path
                        instantaneously. It makes sense only if log_file
                        option is specified and Linux platform is used. This
                        option is ignored if log_config_append is set.

shaker-agent

Client-side process that is run inside pre-configured image.

usage: shaker-agent [-h] [--agent-dir AGENT_DIR] [--agent-id AGENT_ID]
                    [--agent-socket-conn-retries AGENT_SOCKET_CONN_RETRIES]
                    [--agent-socket-recv-timeout AGENT_SOCKET_RECV_TIMEOUT]
                    [--agent-socket-send-timeout AGENT_SOCKET_SEND_TIMEOUT]
                    [--config-dir DIR] [--config-file PATH] [--debug]
                    [--log-config-append PATH] [--log-date-format DATE_FORMAT]
                    [--log-dir LOG_DIR] [--log-file PATH] [--nodebug]
                    [--nouse-journal] [--nouse-json] [--nouse-syslog]
                    [--nowatch-log-file] [--polling-interval POLLING_INTERVAL]
                    [--server-endpoint SERVER_ENDPOINT]
                    [--syslog-log-facility SYSLOG_LOG_FACILITY]
                    [--use-journal] [--use-json] [--use-syslog]
                    [--watch-log-file]

optional arguments:
  -h, --help            show this help message and exit
  --agent-dir AGENT_DIR
                        If specified, directs Shaker to write execution script
                        for the shell class in agent(s) instance defined
                        directory. Defaults to /tmp directory.
  --agent-id AGENT_ID   Agent unique id, defaults to MAC of primary interface.
  --agent-socket-conn-retries AGENT_SOCKET_CONN_RETRIES
                        Prior to exiting, the number of reconnects the Agent
                        will attempt with the server upon socket operation
                        errors.
  --agent-socket-recv-timeout AGENT_SOCKET_RECV_TIMEOUT
                        The amount of time the socket will wait for a response
                        from a sent message, in milliseconds.
  --agent-socket-send-timeout AGENT_SOCKET_SEND_TIMEOUT
                        The amount of time the socket will wait until a sent
                        message is accepted, in milliseconds.
  --config-dir DIR      Path to a config directory to pull `*.conf` files
                        from. This file set is sorted, so as to provide a
                        predictable parse order if individual options are
                        over-ridden. The set is parsed after the file(s)
                        specified via previous --config-file, arguments hence
                        over-ridden options in the directory take precedence.
                        This option must be set from the command-line.
  --config-file PATH    Path to a config file to use. Multiple config files
                        can be specified, with values in later files taking
                        precedence. Defaults to None. This option must be set
                        from the command-line.
  --debug, -d           If set to true, the logging level will be set to DEBUG
                        instead of the default INFO level.
  --log-config-append PATH, --log-config PATH, --log_config PATH
                        The name of a logging configuration file. This file is
                        appended to any existing logging configuration files.
                        For details about logging configuration files, see the
                        Python logging module documentation. Note that when
                        logging configuration files are used then all logging
                        configuration is set in the configuration file and
                        other logging configuration options are ignored (for
                        example, log-date-format).
  --log-date-format DATE_FORMAT
                        Defines the format string for %(asctime)s in log
                        records. Default: None . This option is ignored if
                        log_config_append is set.
  --log-dir LOG_DIR, --logdir LOG_DIR
                        (Optional) The base directory used for relative
                        log_file paths. This option is ignored if
                        log_config_append is set.
  --log-file PATH, --logfile PATH
                        (Optional) Name of log file to send logging output to.
                        If no default is set, logging will go to stderr as
                        defined by use_stderr. This option is ignored if
                        log_config_append is set.
  --nodebug             The inverse of --debug
  --nouse-journal       The inverse of --use-journal
  --nouse-json          The inverse of --use-json
  --nouse-syslog        The inverse of --use-syslog
  --nowatch-log-file    The inverse of --watch-log-file
  --polling-interval POLLING_INTERVAL
                        How frequently the agent polls server, in seconds
  --server-endpoint SERVER_ENDPOINT
                        Address for server connections (host:port), defaults
                        to env[SHAKER_SERVER_ENDPOINT].
  --syslog-log-facility SYSLOG_LOG_FACILITY
                        Syslog facility to receive log lines. This option is
                        ignored if log_config_append is set.
  --use-journal         Enable journald for logging. If running in a systemd
                        environment you may wish to enable journal support.
                        Doing so will use the journal native protocol which
                        includes structured metadata in addition to log
                        messages.This option is ignored if log_config_append
                        is set.
  --use-json            Use JSON formatting for logging. This option is
                        ignored if log_config_append is set.
  --use-syslog          Use syslog for logging. Existing syslog format is
                        DEPRECATED and will be changed later to honor RFC5424.
                        This option is ignored if log_config_append is set.
  --watch-log-file      Uses logging handler designed to watch file system.
                        When log file is moved or removed this handler will
                        open a new log file with specified path
                        instantaneously. It makes sense only if log_file
                        option is specified and Linux platform is used. This
                        option is ignored if log_config_append is set.

shaker-report

Generates report based on raw results stored in JSON format.

usage: shaker-report [-h] [--book BOOK] [--config-dir DIR]
                     [--config-file PATH] [--debug] [--input INPUT]
                     [--log-config-append PATH]
                     [--log-date-format DATE_FORMAT] [--log-dir LOG_DIR]
                     [--log-file PATH] [--nodebug] [--nouse-journal]
                     [--nouse-json] [--nouse-syslog] [--nowatch-log-file]
                     [--report REPORT] [--report-template REPORT_TEMPLATE]
                     [--subunit SUBUNIT]
                     [--syslog-log-facility SYSLOG_LOG_FACILITY]
                     [--use-journal] [--use-json] [--use-syslog]
                     [--watch-log-file]

optional arguments:
  -h, --help            show this help message and exit
  --book BOOK           Generate report in ReST format and store it into the
                        specified folder, defaults to env[SHAKER_BOOK].
  --config-dir DIR      Path to a config directory to pull `*.conf` files
                        from. This file set is sorted, so as to provide a
                        predictable parse order if individual options are
                        over-ridden. The set is parsed after the file(s)
                        specified via previous --config-file, arguments hence
                        over-ridden options in the directory take precedence.
                        This option must be set from the command-line.
  --config-file PATH    Path to a config file to use. Multiple config files
                        can be specified, with values in later files taking
                        precedence. Defaults to None. This option must be set
                        from the command-line.
  --debug, -d           If set to true, the logging level will be set to DEBUG
                        instead of the default INFO level.
  --input INPUT         File or list of files to read test results from,
                        defaults to env[SHAKER_INPUT].
  --log-config-append PATH, --log-config PATH, --log_config PATH
                        The name of a logging configuration file. This file is
                        appended to any existing logging configuration files.
                        For details about logging configuration files, see the
                        Python logging module documentation. Note that when
                        logging configuration files are used then all logging
                        configuration is set in the configuration file and
                        other logging configuration options are ignored (for
                        example, log-date-format).
  --log-date-format DATE_FORMAT
                        Defines the format string for %(asctime)s in log
                        records. Default: None . This option is ignored if
                        log_config_append is set.
  --log-dir LOG_DIR, --logdir LOG_DIR
                        (Optional) The base directory used for relative
                        log_file paths. This option is ignored if
                        log_config_append is set.
  --log-file PATH, --logfile PATH
                        (Optional) Name of log file to send logging output to.
                        If no default is set, logging will go to stderr as
                        defined by use_stderr. This option is ignored if
                        log_config_append is set.
  --nodebug             The inverse of --debug
  --nouse-journal       The inverse of --use-journal
  --nouse-json          The inverse of --use-json
  --nouse-syslog        The inverse of --use-syslog
  --nowatch-log-file    The inverse of --watch-log-file
  --report REPORT       Report file name, defaults to env[SHAKER_REPORT].
  --report-template REPORT_TEMPLATE
                        Template for report. Can be a file name or one of
                        aliases: "interactive", "json". Defaults to
                        "interactive".
  --subunit SUBUNIT     Subunit stream file name, defaults to
                        env[SHAKER_SUBUNIT].
  --syslog-log-facility SYSLOG_LOG_FACILITY
                        Syslog facility to receive log lines. This option is
                        ignored if log_config_append is set.
  --use-journal         Enable journald for logging. If running in a systemd
                        environment you may wish to enable journal support.
                        Doing so will use the journal native protocol which
                        includes structured metadata in addition to log
                        messages.This option is ignored if log_config_append
                        is set.
  --use-json            Use JSON formatting for logging. This option is
                        ignored if log_config_append is set.
  --use-syslog          Use syslog for logging. Existing syslog format is
                        DEPRECATED and will be changed later to honor RFC5424.
                        This option is ignored if log_config_append is set.
  --watch-log-file      Uses logging handler designed to watch file system.
                        When log file is moved or removed this handler will
                        open a new log file with specified path
                        instantaneously. It makes sense only if log_file
                        option is specified and Linux platform is used. This
                        option is ignored if log_config_append is set.

shaker-cleanup

Removes base image from OpenStack cloud.

usage: shaker-cleanup [-h] [--cleanup] [--cleanup-on-exit] [--config-dir DIR]
                      [--config-file PATH] [--debug]
                      [--dns-nameservers DNS_NAMESERVERS]
                      [--external-net EXTERNAL_NET]
                      [--flavor-name FLAVOR_NAME] [--image-name IMAGE_NAME]
                      [--log-config-append PATH]
                      [--log-date-format DATE_FORMAT] [--log-dir LOG_DIR]
                      [--log-file PATH] [--nocleanup] [--nocleanup-on-exit]
                      [--nodebug] [--noos-insecure] [--nouse-journal]
                      [--nouse-json] [--nouse-syslog] [--nowatch-log-file]
                      [--os-auth-url <auth-url>] [--os-cacert <auth-cacert>]
                      [--os-identity-api-version <identity-api-version>]
                      [--os-insecure] [--os-interface <os-interface>]
                      [--os-password <auth-password>]
                      [--os-profile <hmac-key>]
                      [--os-project-domain-name <auth-project-domain-name>]
                      [--os-project-name <auth-project-name>]
                      [--os-region-name <auth-region-name>]
                      [--os-tenant-name <auth-tenant-name>]
                      [--os-user-domain-name <auth-user-domain-name>]
                      [--os-username <auth-username>]
                      [--reuse-stack-name REUSE_STACK_NAME]
                      [--stack-name STACK_NAME]
                      [--syslog-log-facility SYSLOG_LOG_FACILITY]
                      [--use-journal] [--use-json] [--use-syslog]
                      [--watch-log-file]

optional arguments:
  -h, --help            show this help message and exit
  --cleanup             Cleanup the image and the flavor.
  --cleanup-on-exit     Clean up the heat-stack when exiting execution.
  --config-dir DIR      Path to a config directory to pull `*.conf` files
                        from. This file set is sorted, so as to provide a
                        predictable parse order if individual options are
                        over-ridden. The set is parsed after the file(s)
                        specified via previous --config-file, arguments hence
                        over-ridden options in the directory take precedence.
                        This option must be set from the command-line.
  --config-file PATH    Path to a config file to use. Multiple config files
                        can be specified, with values in later files taking
                        precedence. Defaults to None. This option must be set
                        from the command-line.
  --debug, -d           If set to true, the logging level will be set to DEBUG
                        instead of the default INFO level.
  --dns-nameservers DNS_NAMESERVERS
                        Comma-separated list of IPs of the DNS nameservers for
                        the subnets. If no value is provided defaults to
                        Google Public DNS.
  --external-net EXTERNAL_NET
                        Name or ID of external network, defaults to
                        env[SHAKER_EXTERNAL_NET]. If no value provided then
                        Shaker picks any of available external networks.
  --flavor-name FLAVOR_NAME
                        Name of image flavor. The default is created by
                        shaker-image-builder.
  --image-name IMAGE_NAME
                        Name of image to use. The default is created by
                        shaker-image-builder.
  --log-config-append PATH, --log-config PATH, --log_config PATH
                        The name of a logging configuration file. This file is
                        appended to any existing logging configuration files.
                        For details about logging configuration files, see the
                        Python logging module documentation. Note that when
                        logging configuration files are used then all logging
                        configuration is set in the configuration file and
                        other logging configuration options are ignored (for
                        example, log-date-format).
  --log-date-format DATE_FORMAT
                        Defines the format string for %(asctime)s in log
                        records. Default: None . This option is ignored if
                        log_config_append is set.
  --log-dir LOG_DIR, --logdir LOG_DIR
                        (Optional) The base directory used for relative
                        log_file paths. This option is ignored if
                        log_config_append is set.
  --log-file PATH, --logfile PATH
                        (Optional) Name of log file to send logging output to.
                        If no default is set, logging will go to stderr as
                        defined by use_stderr. This option is ignored if
                        log_config_append is set.
  --nocleanup           The inverse of --cleanup
  --nocleanup-on-exit   The inverse of --cleanup-on-exit
  --nodebug             The inverse of --debug
  --noos-insecure       The inverse of --os-insecure
  --nouse-journal       The inverse of --use-journal
  --nouse-json          The inverse of --use-json
  --nouse-syslog        The inverse of --use-syslog
  --nowatch-log-file    The inverse of --watch-log-file
  --os-auth-url <auth-url>
                        Authentication URL, defaults to env[OS_AUTH_URL].
  --os-cacert <auth-cacert>
                        Location of CA Certificate, defaults to
                        env[OS_CACERT].
  --os-identity-api-version <identity-api-version>
                        Identity API version, defaults to
                        env[OS_IDENTITY_API_VERSION].
  --os-insecure         When using SSL in connections to the registry server,
                        do not require validation via a certifying authority,
                        defaults to env[OS_INSECURE].
  --os-interface <os-interface>
                        Interface type. Valid options are public, admin and
                        internal. defaults to env[OS_INTERFACE].
  --os-password <auth-password>
                        Authentication password, defaults to env[OS_PASSWORD].
  --os-profile <hmac-key>
                        HMAC key for encrypting profiling context data,
                        defaults to env[OS_PROFILE].
  --os-project-domain-name <auth-project-domain-name>
                        Authentication project domain name. Defaults to
                        env[OS_PROJECT_DOMAIN_NAME].
  --os-project-name <auth-project-name>
                        Authentication project name. This option is mutually
                        exclusive with --os-tenant-name. Defaults to
                        env[OS_PROJECT_NAME].
  --os-region-name <auth-region-name>
                        Authentication region name, defaults to
                        env[OS_REGION_NAME].
  --os-tenant-name <auth-tenant-name>
                        Authentication tenant name, defaults to
                        env[OS_TENANT_NAME].
  --os-user-domain-name <auth-user-domain-name>
                        Authentication username. Defaults to
                        env[OS_USER_DOMAIN_NAME].
  --os-username <auth-username>
                        Authentication username, defaults to env[OS_USERNAME].
  --reuse-stack-name REUSE_STACK_NAME
                        Name of an existing Shaker heat stack to reuse. The
                        default is to not reuse an existing stack. Caution
                        should be taken to only reuse stacks meant for a
                        specific scenario. Also certain configs e.g. image-
                        name, flavor-name, stack-name, etc will be ignored
                        when reusing an existing stack.
  --stack-name STACK_NAME
                        Name of test heat stack. The default is a uniquely
                        generated name.
  --syslog-log-facility SYSLOG_LOG_FACILITY
                        Syslog facility to receive log lines. This option is
                        ignored if log_config_append is set.
  --use-journal         Enable journald for logging. If running in a systemd
                        environment you may wish to enable journal support.
                        Doing so will use the journal native protocol which
                        includes structured metadata in addition to log
                        messages.This option is ignored if log_config_append
                        is set.
  --use-json            Use JSON formatting for logging. This option is
                        ignored if log_config_append is set.
  --use-syslog          Use syslog for logging. Existing syslog format is
                        DEPRECATED and will be changed later to honor RFC5424.
                        This option is ignored if log_config_append is set.
  --watch-log-file      Uses logging handler designed to watch file system.
                        When log file is moved or removed this handler will
                        open a new log file with specified path
                        instantaneously. It makes sense only if log_file
                        option is specified and Linux platform is used. This
                        option is ignored if log_config_append is set.