Clone this wiki locally
Eucalyptus is open source software for building AWS-compatible private clouds.
This Eucalyptus wiki is a collection of technical documents for cloud users, cloud administrators, code contributors and partners.
For the official Eucalyptus web site, visit eucalyptus.com.
About Eucalyptus — Eucalyptus is a set of web services, modeled after and compatible with Amazon Web Services (AWS). Written mostly in Java, Eucalyptus integrates components from over 100 open source projects, tested and packaged into a single easy-to-install and easy-to-use product. Eucalyptus runs on virtualized infrastructure (Linux+KVM).
Acronym — Eucalyptus is actually an acronym, which stands for "Elastic Utility Computing Architecture, Linking Your Programs To Useful Systems".
Architecture — You can see the design documents for Eucalyptus in our architecture repository.
AWS Tools — Eucalyptus is AWS Compatible. See the AWS tools we recommend, and how to configure them for use with Eucalyptus, on our AWS Tools page.
Bugs — You can file bugs on our Jira instance.
Documentation — Reference all of our product documentation.
Feedback — You can always ask questions on any of our Eucalyptus mailing lists.
Install — To install Eucalyptus, try the one-line installer with Faststart. After install completes (usually in less than 30 minutes) you can immediately begin using your private cloud platform with the default account, user and password.
IRC — You can find us on Freenode IRC on #eucalyptus
Mailing List — Join one of the Eucalyptus mailing lists to keep up with latest developments and join our users and developers in conversation.
Nightlies — You can install nightly builds of the latest Eucalyptus development builds by following these instructions.
People — Lots of great people contribute to Eucalyptus. Meet some of them.
Videos — You can see how Eucalyptus works on videos at YouTube.
For Cloud Users
- Bundling Images - How to use euca-bundle-vol to "rebundle" modified VM instances back into the Eucalyptus image catalog as a new EMI.
- Instance Best Practices - Recommendations regarding best practices associated with instance and image management.
- Convert AMI to EMI - How to import an AMI (Amazon Machine Image) into Eucalyptus as an EMI (Eucalyptus Machine Image).
- Kexec Loader - How to use a specialized EKI and ERI to boot the EMI's own in-filesystem kernel and ramdisk using GRUB.
- Using PHP with Eucalyptus - How to use the Amazon AWS PHP SDK with Eucalyptus.
- Starter Images - Starter Images that can be accessed via emis.eucalyptus.com or eustore.
- Stackato Image - Information regarding status of getting Stackato image to work on Eucalyptus.
- Fog - Information regarding status of Fog working with Eucalyptus
- Ansible - Using Ansible to orchestrate EC2 and Eucalyptus instances; deployment and configuration management.
For Cloud Administrators
- Network Troubleshooting FAQ - How to solve common VM networking problems.
- Eutester and Nagios - How to setup and configure Eutester and Nagios to carry out a simple test of cloud availablity.
- Keepalived VIP on Cluster Controllers - How to install and configure keepalived to be used as a shared IP for Node Controller gateways when using MANAGED mode and a private network.
- Eucalyptus Storage - High-level overview of storage in Eucalyptus including Walrus and the Storage Controller and how they work. Also includes some best practices and recommendations.
- Design Docs - Internal Eucalyptus design documentation.
- Debugging Eucalyptus Java-language components - Advice on working with Eucalyptus from an IDE.
- Debugging Eucalyptus C-language components - Tools and advice to debug the components of Eucalyptus written in C** — Node Controller and Cluster Controller.
- Image deployment and construction - Details of how disk images are deployed in the system
- Developer Guide (incomplete) - A work-in-progress guide to getting started on the Eucalyptus code and architecture.
- Generating API WSDLS - How to generate the WSDLS for Eucalyptus services.