
pyami
*****


boto.pyami
==========


boto.pyami.bootstrap
====================

class class boto.pyami.bootstrap.Bootstrap

   The Bootstrap class is instantiated and run as part of the PyAMI
   instance initialization process.  The methods in this class will be
   run from the rc.local script of the instance and will be run as the
   root user.

   The main purpose of this class is to make sure the boto
   distribution on the instance is the one required.

   create_working_dir()

   fetch_s3_file(s3_file)

   load_boto()

   load_packages()

   main()

   write_metadata()


boto.pyami.config
=================

class class boto.pyami.config.Config(path=None, fp=None, do_load=True)

   dump()

   dump_safe(fp=None)

   dump_to_sdb(domain_name, item_name)

   get(section, name, default=None)

   get_instance(name, default=None)

   get_user(name, default=None)

   get_value(section, name, default=None)

   getbool(section, name, default=False)

   getfloat(section, name, default=0.0)

   getint(section, name, default=0)

   getint_user(name, default=0)

   load_credential_file(path)

      Load a credential file as is setup like the Java utilities

   load_from_path(path)

   load_from_sdb(domain_name, item_name)

   save_option(path, section, option, value)

      Write the specified Section.Option to the config file specified
      by path. Replace any previous value.  If the path doesn't exist,
      create it. Also add the option the the in-memory config.

   save_system_option(section, option, value)

   save_user_option(section, option, value)

   setbool(section, name, value)


boto.pyami.copybot
==================

class class boto.pyami.copybot.CopyBot

   copy_bucket_acl()

   copy_key_acl(src, dst)

   copy_keys()

   copy_log()

   main()


boto.pyami.installers
=====================

class class boto.pyami.installers.Installer(config_file=None)

   Abstract base class for installers

   add_cron(name, minute, hour, mday, month, wday, who, command, env=None)

      Add an entry to the system crontab.

   add_env(key, value)

      Add an environemnt variable

   add_init_script(file)

      Add this file to the init.d directory

   install()

      Do whatever is necessary to "install" the package.

   start(service_name)

      Start a service.

   stop(service_name)

      Stop a service.


boto.pyami.installers.ubuntu
============================


boto.pyami.installers.ubuntu.apache
===================================

class class boto.pyami.installers.ubuntu.apache.Apache(config_file=None)

   Install apache2, mod_python, and libapache2-svn

   install()

   main()


boto.pyami.installers.ubuntu.ebs
================================

Automated installer to attach, format and mount an EBS volume. This
installer assumes that you want the volume formatted as an XFS file
system.  To drive this installer, you need the following section in
the boto config passed to the new instance. You also need to install
dateutil by listing python-dateutil in the list of packages to be
installed in the Pyami seciont of your boto config file.

If there is already a device mounted at the specified mount point, the
installer assumes that it is the ephemeral drive and unmounts it,
remounts it as /tmp and chmods it to 777.

Config file section:

   [EBS]
   volume_id = <the id of the EBS volume, should look like vol-xxxxxxxx>
   logical_volume_name = <the name of the logical volume that contaings 
       a reference to the physical volume to be mounted. If this parameter
       is supplied, it overrides the volume_id setting.>
   device = <the linux device the EBS volume should be mounted on>
   mount_point = <directory to mount device, defaults to /ebs>

class class boto.pyami.installers.ubuntu.ebs.EBSInstaller(config_file=None)

   Set up the EBS stuff

   attach()

   create_backup_cleanup_script(use_tag_based_cleanup=False)

   create_backup_script()

   handle_mount_point()

   install()

   main()

   make_fs()

   update_fstab()


boto.pyami.installers.ubuntu.installer
======================================

class class boto.pyami.installers.ubuntu.installer.Installer(config_file=None)

   Base Installer class for Ubuntu-based AMI's

   add_cron(name, command, minute='*', hour='*', mday='*', month='*', wday='*', who='root', env=None)

      Write a file to /etc/cron.d to schedule a command env is a dict
      containing environment variables you want to set in the file
      name will be used as the name of the file

   add_env(key, value)

      Add an environemnt variable For Ubuntu, the best place is
      /etc/environment.  Values placed here do not need to be
      exported.

   add_init_script(file, name)

      Add this file to the init.d directory

   create_user(user)

      Create a user on the local system

   install()

      This is the only method you need to override

   start(service_name)

   stop(service_name)


boto.pyami.installers.ubuntu.mysql
==================================

This installer will install mysql-server on an Ubuntu machine. In
addition to the normal installation done by apt-get, it will also
configure the new MySQL server to store it's data files in a different
location.  By default, this is /mnt but that can be configured in the
[MySQL] section of the boto config file passed to the instance.

class class boto.pyami.installers.ubuntu.mysql.MySQL(config_file=None)

   change_data_dir(password=None)

   install()

   main()


boto.pyami.installers.ubuntu.trac
=================================

class class boto.pyami.installers.ubuntu.trac.Trac(config_file=None)

   Install Trac and DAV-SVN Sets up a Vhost pointing to [Trac]->home
   Using the config parameter [Trac]->hostname Sets up a trac
   environment for every directory found under [Trac]->data_dir

   [Trac] name = My Foo Server hostname = trac.foo.com home =
   /mnt/sites/trac data_dir = /mnt/trac svn_dir = /mnt/subversion
   server_admin = root@foo.com sdb_auth_domain = users # Optional
   SSLCertificateFile = /mnt/ssl/foo.crt SSLCertificateKeyFile =
   /mnt/ssl/foo.key SSLCertificateChainFile = /mnt/ssl/FooCA.crt

   install()

   main()

   setup_vhost()


boto.pyami.launch_ami
=====================

boto.pyami.launch_ami.main()

boto.pyami.launch_ami.usage()


boto.pyami.scriptbase
=====================

class class boto.pyami.scriptbase.ScriptBase(config_file=None)

   main()

   mkdir(path)

   notify(subject, body='')

   run(command, notify=True, exit_on_error=False, cwd=None)

   umount(path)


boto.pyami.startup
==================

class class boto.pyami.startup.Startup(config_file=None)

   main()

   run_scripts()
