Chapter 75. software This chapter describes the commands under the software command. 75.1. software config create Create software config Usage: Table 75.1. Positional Arguments Value Summary <config-name> Name of the software config to create Table 75.2. Optional Arguments Value Summary -h, --help Show this help message and exit --config-file <config-file> Path to json/yaml containing map defining <inputs>, <outputs>, and <options> --definition-file <destination-file> Path to software config script/data --group <group> Group name of tool expected by the software config Table 75.3. Output Formatters Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to json -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated Table 75.4. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 75.5. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 75.6. Table Formatter Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 75.2. software config delete Delete software configs Usage: Table 75.7. Positional Arguments Value Summary <config> Ids of the software configs to delete Table 75.8. Optional Arguments Value Summary -h, --help Show this help message and exit 75.3. software config list List software configs Usage: Table 75.9. Optional Arguments Value Summary -h, --help Show this help message and exit --limit <limit> Limit the number of configs returned --marker <id> Return configs that appear after the given config id Table 75.10. Output Formatters Value Summary -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated Table 75.11. CSV Formatter Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 75.12. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 75.13. Table Formatter Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 75.4. software config show Show software config details Usage: Table 75.14. Positional Arguments Value Summary <config> Id of the config Table 75.15. Optional Arguments Value Summary -h, --help Show this help message and exit --config-only Only display the value of the <config> property. Table 75.16. Output Formatters Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to yaml -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated Table 75.17. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 75.18. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 75.19. Table Formatter Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 75.5. software deployment create Create a software deployment. Usage: Table 75.20. Positional Arguments Value Summary <deployment-name> Name of the derived config associated with this deployment. This is used to apply a sort order to the list of configurations currently deployed to the server. Table 75.21. Optional Arguments Value Summary -h, --help Show this help message and exit --input-value <key=value> Input value to set on the deployment. this can be specified multiple times. --action <action> Name of an action for this deployment. this can be a custom action, or one of CREATE, UPDATE, DELETE, SUSPEND, RESUME. Default is UPDATE --config <config> Id of the configuration to deploy --signal-transport <signal-transport> How the server should signal to heat with the deployment output values. TEMP_URL_SIGNAL will create a Swift TempURL to be signaled via HTTP PUT. ZAQAR_SIGNAL will create a dedicated zaqar queue to be signaled using the provided keystone credentials.NO_SIGNAL will result in the resource going to the COMPLETE state without waiting for any signal --container <container> Optional name of container to store temp_url_signal objects in. If not specified a container will be created with a name derived from the DEPLOY_NAME --timeout <timeout> Deployment timeout in minutes --server <server> Id of the server being deployed to Table 75.22. Output Formatters Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to yaml -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated Table 75.23. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 75.24. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 75.25. Table Formatter Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 75.6. software deployment delete Delete software deployment(s) and correlative config(s). Usage: Table 75.26. Positional Arguments Value Summary <deployment> Id of the deployment(s) to delete. Table 75.27. Optional Arguments Value Summary -h, --help Show this help message and exit 75.7. software deployment list List software deployments. Usage: Table 75.28. Optional Arguments Value Summary -h, --help Show this help message and exit --server <server> Id of the server to fetch deployments for --long List more fields in output Table 75.29. Output Formatters Value Summary -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated Table 75.30. CSV Formatter Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 75.31. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 75.32. Table Formatter Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 75.8. software deployment metadata show Get deployment configuration metadata for the specified server. Usage: Table 75.33. Positional Arguments Value Summary <server> Id of the server to fetch deployments for Table 75.34. Optional Arguments Value Summary -h, --help Show this help message and exit 75.9. software deployment output show Show a specific deployment output. Usage: Table 75.35. Positional Arguments Value Summary <deployment> Id of deployment to show the output for <output-name> Name of an output to display Table 75.36. Optional Arguments Value Summary -h, --help Show this help message and exit --all Display all deployment outputs --long Show full deployment logs in output 75.10. software deployment show Show SoftwareDeployment Details. Usage: Table 75.37. Positional Arguments Value Summary <deployment> Id of the deployment Table 75.38. Optional Arguments Value Summary -h, --help Show this help message and exit --long Show more fields in output Table 75.39. Output Formatters Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated Table 75.40. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 75.41. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 75.42. Table Formatter Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show.

Commands:
openstack software config create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--config-file <config-file>] [--definition-file <destination-file>] [--group <group>] <config-name>
openstack software config delete [-h] <config> [<config> ...]
openstack software config list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--limit <limit>] [--marker <id>]
openstack software config show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--config-only] <config>
openstack software deployment create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--input-value <key=value>] [--action <action>] [--config <config>] [--signal-transport <signal-transport>] [--container <container>] [--timeout <timeout>] --server <server> <deployment-name>
openstack software deployment delete [-h] <deployment> [<deployment> ...]
openstack software deployment list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--server <server>] [--long]
openstack software deployment metadata show [-h] <server>
openstack software deployment output show [-h] [--all] [--long] <deployment> [<output-name>]
openstack software deployment show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--long] <deployment>