Manual Reference Pages - EUCA2OOLS.INI (5)
- configuration for euca2ools
files are used to configure the euca2ools suite of command
line tools. They store the locations of the services for
the commands to contact, the security credentials to use
to authenticate to them, and other configuration options
is broken into a number of sections. Sections are
denoted by section headers, which consist of section
names surrounded by square braces. Within each section,
an option is set by listing its name, an
sign, and its value. For example, the following enables
debugging for all commands by setting the
option in the
debug = true
Most sections have user-defined names. Such a sections
name is defined by a second word in its header. Named
sections provide a means of choosing different
configuration using the command line. For example, the
following defines two regions with different URLs for
their EC2 services that one can select using the
command line option:
ec2-url = https://ec2.us-east-1.amazonaws.com/
ec2-url = https://ec2.eu-west-1.amazonaws.com/
Named sections can contain
wildcards, which makes them act as fallbacks when options
are not available in sections with more specific names
that contain fewer wildcards. Sections with more specific
names take precedence over those with less specific names.
sections function as defaults when the value for an option
cannot be found anywhere else.
Named sections can also be organized into groups by
choosing names for groups and prepending section names
with them, separated by
characters. When combined with wildcards, this allows
one to specify defaults for several sections at once
and then override them as needed as in the following
certificate = /usr/share/euca2ools/certs/cert-ec2.pem
verify-ssl = true
certificate = /usr/share/euca2ools/certs/cert-ec2-gov.pem
Finally, options in named sections may refer to other
sections by using the
keyword followed by the section name to refer to.
This differs from simply duplicating the option from the
other section in that commands that are sensitive to the
name of the section the option came from, such as those
that use AWS signature version 4, will be able to determine
which section an option originates from.
option provided by most euca2ools commands allows one to
those commands use to find configuration data by supplying
it with a user name, a region name, or both in one of the
environment variable works the same way, but with lower
The global section contains settings that affect all
When set to
enable debugging for all commands. When set to
enable debugging for all commands and additionally colorize
debug output based on severity level.
The name of the region to use when no region is otherwise
The maximum number of times commands should retry their
requests to the server before giving up. The default is 2.
The amount of time, in seconds, to wait for the server to
respond to requests before giving up. The default is 30.
A user section contains information that is specific to
an identity in the cloud, usually an IAM user.
The accounts 12-digit ID number.
The users access key ID to use for authentication.
Access key IDs come paired with secret keys; the ID
specified with this option must correspond to the secret
key specified with the
The users secret key to use for authentication.
Secret keys come paired with access key IDs; the secret
key specified with this option must correspond to the
access key ID specified with the
The file name containing the users signing certificate.
This is used only by commands that bundle images:
The file name containing the private key for the users
signing certificate. This is used only by commands that
bundle and unbundle images:
A region section contains information that is specific to
a cloud region, such as a Eucalyptus installation or an
Amazon Web Services region.
The URL to use to contact the service with the name
For a list of valid service names, see
to use for this region when no other user is otherwise
The file name containing the clouds image-bundling
certificate. This is used only by commands that bundle
Force commands that access the s3 service to use AWS
signature version 4. The default is false.
The location constraint needed to create buckets in the
regions object storage service.
Whether or not to verify the servers SSL certificates.
The default is false.
The location of the XSLT stylesheet for
to use to reformat VPN connection information. If the
location is an HTTP or HTTPS URL it will be downloaded
as needed. If it contains
that will be replaced with the desired format.
Commands that create access keys can format their
output in the form of a
file, simplifying the process of distributing access
keys and URL information to users. This can replace
files generated by eucalyptuss
configuration data are read from files in alphabetical
order in the following locations:
In cases where the same option is defined in more than
one file, the file that appears last in this list will
first appeared in euca2ools 3.0.
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.