cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [1/2] git commit: updated refs/heads/hotfix/4.4-readme to 881275c
Date Tue, 05 Aug 2014 15:33:03 GMT
Repository: cloudstack
Updated Branches:
  refs/heads/hotfix/4.4-readme [created] 881275c16

README: Give CloudStack its much deserved readme file

Signed-off-by: Rohit Yadav <>
(cherry picked from commit d753e765f7ca848e4cc79d25ba5fa986b8b63522)



Branch: refs/heads/hotfix/4.4-readme
Commit: 7e9269eb2d9792834d7175184e58a901bec18039
Parents: 9315321
Author: Rohit Yadav <>
Authored: Tue Aug 5 15:54:40 2014 +0200
Committer: Daan Hoogland <>
Committed: Tue Aug 5 17:31:08 2014 +0200

---------------------------------------------------------------------- | 175 +++++++++++++++++++++++++++++++++++++--------------------
 pom.xml   |   1 +
 2 files changed, 115 insertions(+), 61 deletions(-)
diff --git a/ b/
index 009df83..600f783 100644
--- a/
+++ b/
@@ -1,84 +1,137 @@
-Apache CloudStack Version 4.4.1
+# Apache CloudStack
-# About Apache CloudStack
+Apache CloudStack is open source software designed to deploy and manage large
+networks of virtual machines, as a highly available, highly scalable
+Infrastructure as a Service (IaaS) cloud computing platform. CloudStack is used
+by a number of service providers to offer public cloud services, and by many
+companies to provide an on-premises (private) cloud offering, or as part of a
+hybrid cloud solution.
-Apache CloudStack is software designed to deploy 
-and manage large networks of virtual machines, as a highly 
-available, highly scalable Infrastructure as a Service (IaaS) 
-cloud computing platform. CloudStack is used by a number of 
-service providers to offer public cloud services, and by many 
-companies to provide an on-premises (private) cloud offering.
+CloudStack is a turnkey solution that includes the entire "stack" of features
+most organizations want with an IaaS cloud: compute orchestration,
+Network-as-a-Service, user and account management, a full and open native API,
+resource accounting, and a first-class User Interface (UI).
-Apache CloudStack currently supports the most popular hypervisors: 
-VMware, Oracle VM, KVM, XenServer and Xen Cloud Platform. 
-CloudStack also offers bare metal management of servers, 
-using PXE to provision OS images and IPMI to manage the server. 
-Apache CloudStack offers three methods for managing cloud 
-computing environments: an easy to use Web interface, command 
-line tools, and a full-featured RESTful API.
+CloudStack currently supports the most popular hypervisors:
+VMware, KVM, XenServer, Xen Cloud Platform (XCP) and Hyper-V.
-Visit us at [Apache CloudStack](
+Users can manage their cloud with an easy to use Web interface, command line
+tools, and/or a full-featured RESTful API. In addition, CloudStack provides an
+API that's compatible with AWS EC2 and S3 for organizations that wish to deploy
+hybrid clouds.
-## Mailing lists
-[Development Mailing List](
-[Users Mailing List](
-[Commits Mailing List](
-[Issues Mailing List](
-[Marketing Mailing List](
+For more information on Apache CloudStack, please visit:
-# License
+## Who Uses CloudStack?
-Licensed to the Apache Software Foundation (ASF) under one
-or more contributor license agreements.  See the NOTICE file
-distributed with this work for additional information
-regarding copyright ownership.  The ASF licenses this file
-to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance
-with the License.  You may obtain a copy of the License at
+There are more than 150 known organisations using Apache CloudStack (or a
+commercial distribution of CloudStack). Our users include many major service
+providers running CloudStack to offer public cloud services, product vendors who
+incorporate or integrate with Cloudstack in their own products, organisations
+who have used Cloudstack to build their own private clouds, and systems
+integrators that offer CloudStack related services.
+For case studies highlighting successful deployments of Apache CloudStack, please
-Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-KIND, either express or implied.  See the License for the
-specific language governing permissions and limitations
-under the License.
+For the up-to-date list of current users, please visit:
-# Building CloudStack
+If you are using CloudStack in your organisation and your company isn't listed
+above, please complete our brief adoption survey. We're happy to keep your
+company name anonymous if you require.
-See the INSTALL file.
+CloudStack survey page:
-# Notice of Cryptographic Software
+## License
-This distribution includes cryptographic software. The country in which you currently 
-reside may have restrictions on the import, possession, use, and/or re-export to another

-country, of encryption software. BEFORE using any encryption software, please check your

-country's laws, regulations and policies concerning the import, possession, or use, and 
-re-export of encryption software, to see if this is permitted. See

-for more information.
+Please see the LICENSE file included in the root directory of the source tree.
-The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has 
-classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which 
-includes information security software using or performing cryptographic functions with 
-asymmetric algorithms. The form and manner of this Apache Software Foundation distribution

-makes it eligible for export under the License Exception ENC Technology Software 
-Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 
-740.13) for both object code and source code.
+## Downloading
-The following provides more details on the included cryptographic software: 
+You can download released versions from:
-  CloudStack makes use of JaSypt cryptographic libraries
+## Building
-  CloudStack has a system requirement of MySQL, and uses native database encryption 
-  functionality. 
+Please see the file included in the root directory of the source tree.
-  CloudStack makes use of the Bouncy Castle general-purpose encryption library.
+### Tooling
-  CloudStack can optionally interacts with and controls OpenSwan-based VPNs.
+Please see the file included in the root directory of the source tree.
-  CloudStack has a dependency on Apache WSS4J as part of the AWSAPI implementation. 
+## Documentation
-  CloudStack has a dependency on and makes use of JSch - a java SSH2 implementation. 
+Project wiki:
+Getting started documentation:
+Installation documentation:
+Administration documentation:
+Latest release notes:
+Design documents::
+API documentation:
+## Getting Involved and Contributing
+Interested in helping out with Apache CloudStack? Great! We welcome
+participation from anybody willing to work The Apache Way and make a
+contribution. Note that you do not have to be a developer in order to contribute
+to Apache CloudStack. We need folks to help with documentation, translation,
+promotion etc.
+If you're interested in learning more or participating in the Apache CloudStack
+project, the mailing lists are the best way to do that. While the project has
+several communications channels, the mailing lists are the most active and the
+official channels for making decisions about the project itself.
+Mailing lists:
+IRC, join us on on:
+- `#cloudstack`: General Apache CloudStack conversation and end user support
+- `#cloudstack-dev`: Development discussions
+- `#cloudstack-meeting`: Weekly and ad-hoc meeting room for the CloudStack community
+Bug reporting:
+Developer resources:
+For more details please see our contributing page:
+### News and Events
+Planet CloudStack:
+Events and meetup:
+### Reporting Security Vulnerabilities
+If you've found an issue that you believe is a security vulnerability in a
+released version of CloudStack, please report it to
+`` with details about the vulnerability, how it
+might be exploited, and any additional information that might be useful.
+For more details, please visit:
diff --git a/pom.xml b/pom.xml
index 136378d..4f00b35 100644
--- a/pom.xml
+++ b/pom.xml
@@ -703,6 +703,7 @@
+              <exclude></exclude>

View raw message