eucalyptus.conf, euca_conf is confusing and underdocumented

Bug #458211 reported by Etienne Goyer on 2009-10-22
This bug affects 1 person
Affects Status Importance Assigned to Milestone
graziano obertelli
eucalyptus (Ubuntu)
Dustin Kirkland 

Bug Description

The configuration file /etc/eucalyptus/eucalyptus.conf, used by all Eucalyptus services (-cloud, -cc, -nc, etc) is very confusing and practically undocumented. The inline comments are helpful, but they do not provide enough context for the administrator to decide which configuration directive are relevant to his specific setup.

For example, let's say a system administrator is configuring a machine running only the Walrus service, to be registered with a CLC running on another machine. Is it relevant for him to define VNET_PRIVINTERFACE directive and, if so, what value should he use? And so on for pretty much all directives.

At the very least, a eucalyptus.conf man page explaining in which context each directive are relevant would desirable. Better yet would be to break eucalyptus.conf in service-specific configuration file that could be documented separately, either inline or in a man page.

Changed in eucalyptus (Ubuntu):
importance: Undecided → Medium
Thierry Carrez (ttx) on 2009-10-26
Changed in eucalyptus (Ubuntu):
importance: Medium → Wishlist
status: New → Triaged
summary: - eucalyptus.conf is confusing and underdocumented
+ eucalyptus.conf, euca_conf is confusing and underdocumented
Changed in eucalyptus (Ubuntu):
assignee: nobody → Dustin Kirkland (kirkland)
Changed in eucalyptus:
status: New → Confirmed
Changed in eucalyptus (Ubuntu):
status: Triaged → In Progress
Changed in eucalyptus (Ubuntu):
status: In Progress → Fix Committed
Launchpad Janitor (janitor) wrote :

This bug was fixed in the package eucalyptus - 1.6.2~bzr1120-0ubuntu7

eucalyptus (1.6.2~bzr1120-0ubuntu7) lucid; urgency=low

  [ Thierry Carrez ]
  * debian/eucalyptus-sc.config: Ask for cluster name on SC-only installs
    (LP: #497831)

  [ Dustin Kirkland ]
  * debian/eucalyptus-common.install, debian/eucalyptus-common.manpages,
    debian/eucalyptus-common.postinst, debian/eucalyptus-common.preinst,
    debian/eucalyptus-defaults.conf, debian/eucalyptus-nc.postinst,
    debian/eucalyptus.conf, tools/euca_conf.8, tools/
    - Massive rework fixing LP: #487275, improving the conffile handling
      of eucalyptus.conf and euca_conf
      + create /usr/share/eucalyptus/eucalyptus-defaults.conf,
        which contains generic, distro defaults
      + first source /usr/share/eucalyptus/eucalyptus-defaults.conf,
        in eucalyptus.conf
      + next source /etc/eucalyptus/eucalyptus-local.conf, in
        eucalyptus.conf, containing site-specific customizations
      + finally, allow for admin customizations at the bottom of
      + move euca_conf.1 to euca_conf.8, and actually install it,
        LP: #458211
      + fix tools/ to use $FILE instead of eucalyptus.conf
      + have tools/ write to eucalyptus-local.conf
      + drop serveral postinst calls to euca_conf, now that these
        defaults are set/sourced in eucalyptus-defaults.conf
      + maintainer script fixes seeding eucalyptus-local.conf on new
        installs, moving existing eucalyptus.conf data to
        eucalyptus-local.conf on upgrades
  * debian/eucalyptus-common.links, debian/eucalyptus-common.manpages,
    tools/eucalyptus.conf.5: move most of the inline documentation from
    eucalyptus.conf to a manpage, LP: #458211
 -- Dustin Kirkland <email address hidden> Sun, 10 Jan 2010 22:08:59 -0600

Changed in eucalyptus (Ubuntu):
status: Fix Committed → Fix Released
Changed in eucalyptus:
assignee: nobody → Mitch Garnaat (mitch-garnaat)

Targeting 2.0.4 to add manpages for euca_conf and eucalyptus.conf.

Changed in eucalyptus:
milestone: none → 2.0.4
assignee: Mitch Garnaat (mitch-garnaat) → graziano obertelli (graziano.obertelli)
importance: Undecided → Low
Andy Grimm (agrimm) wrote :

This issue is now being tracked upstream at

Please watch that issue for further updates.

To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers