'\" t
.\"     Title: heat-boto
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 03/31/2012
.\"    Manual: System administration commands
.\"    Source: Heat 0.0.1
.\"  Language: English
.\"
.TH "HEAT" "1" "03/31/2012" "HEAT 0\&.0\&.1" "System administration commands"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
heat-boto \- perform a heat action via the heat API
.SH "SYNOPSIS"
.sp
heat-boto COMMAND [OPTIONS]
.SH "DESCRIPTION"
.sp
\fBheat-boto\fR is a tool to orchestrate the setup of multiple cloud applications\&.

\fBheat-boto\fR is port a of the \fBheat\fR tool to use the boto client library\&.

.SH CONFIGURATION FILES

heat-boto uses the boto client library, which looks for configuration in /etc/boto.cfg

heat installs a default version of this file, but you will need to update the
aws_access_key_id and aws_secret_access_key values with your real keystone credentials\&.

Use keystone ec2-credentials-list to retrieve your keystone ec2 access keys\&.

.SH "COMMANDS"

.PP
\fBcreate\fP
.RS 4
Create stack as defined in template file
.RE
.PP
\fBdelete\fP
.RS 4
Delete specified stack
.RE
.PP
\fBdescribe\fP
.RS 4
Provide detailed information about the specified stack, or if no arguments are given all stacks
.RE
.PP
\fBestimate-template-cost\fP
.RS 4
Currently not implemented
.RE
.PP
\fBevent-list\fP
.RS 4
List events related to specified stacks, or if no arguments are given all stacks
.RE
.PP
\fBgettemplate\fP
.RS 4
Get the template for a running stack
.RE
.PP
\fBhelp\fP
.RS 4
Provide help/usage information
.RE
.PP
\fBlist\fP
.RS 4
List summary information for all stacks
.RE
.PP
\fBresource\fP
.RS 4
List information about a specific resource
.RE
.PP
\fBresource-list\fP
.RS 4
List all resources for a specified stack
.RE
.PP
\fBresource-list-details\fP
.RS 4
List details of all resources for a specified stack or physical resource ID, optionally filtered by a logical resource ID
.RE
.PP
\fBupdate\fP
.RS 4
Update a running stack with a modified template or template parameters - currently not implemented
.RE
.PP
\fBvalidate\fP
.RS 4
Validate a template file syntax
.RE

.SH "OPTIONS"
.PP
\fB\-d\fR, \fB\-\-debug\fR
.RS 4
Enable verbose debug level output
.RE
.PP
\fB\-H\fR, \fB\-\-host\fR
.RS 4
Specify the hostname running the heat API service
.RE
.PP
\fB\-k\fR, \fB\-\-insecure\fR
.RS 4
Use plain HTTP instead of HTTPS
.RE
.PP
\fB\-P\fR, \fB\-\-parameters\fR
.RS 4
Stack input parameters
.RE
.PP
\fB\-p\fR, \fB\-\-port\fR
.RS 4
Specify the port to connect to for the heat API service
.RE
.PP
\fB\-R\fR, \fB\-\-region\fR
.RS 4
Region name. When using keystone authentication "version 2.0 or later this identifies the region
.RE
.PP
\fB\-f\fR, \fB\-\-template\fR-file
.RS 4
Path to file containing the stack template
.RE
.PP
\fB\-u\fR, \fB\-\-template\fR-url
.RS 4
URL to stack template
.RE
.PP
\fB\-t\fR, \fB\-\-timeout\fR
.RS 4
Stack creation timeout (default is 60 minutes)
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Enable verbose output
.RE
.PP
\fB\-y\fR, \fB\-\-yes\fR
.RS 4
Do not prompt for confirmation, assume yes
.RE


.PP
.SH "USAGE EXAMPLES"
.sp

heat-boto -d create wordpress --template-file=templates/WordPress_Single_Instance.template --parameters="InstanceType=m1.xlarge;DBUsername=${USER};DBPassword=verybadpass;KeyName=${USER}_key"

heat-boto list

heat-boto describe wordpress

heat-boto resource-list wordpress

heat-boto resource-list-details wordpress

heat-boto resource-list-details wordpress WikiDatabase

heat-boto resource wordpress WikiDatabase

heat-boto event-list

heat-boto delete wordpress

.SH "AUTHOR"
.sp
See the AUTHORS file for a complete list of contributors\&.
.SH "COPYRIGHT"
.sp
Copyright \(co 2012, Red Hat Inc
.sp
Heat is released under the terms of the ASL 2 License\&.
.sp
Extensive documentation as well as IRC and mailing list info is available on the heat home page: https://heat\&-api\&.org/