Return-Path: X-Original-To: apmail-deltacloud-commits-archive@www.apache.org Delivered-To: apmail-deltacloud-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 82BB3DB5C for ; Wed, 6 Mar 2013 22:09:19 +0000 (UTC) Received: (qmail 20842 invoked by uid 500); 6 Mar 2013 22:09:19 -0000 Delivered-To: apmail-deltacloud-commits-archive@deltacloud.apache.org Received: (qmail 20798 invoked by uid 500); 6 Mar 2013 22:09:19 -0000 Mailing-List: contact commits-help@deltacloud.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@deltacloud.apache.org Delivered-To: mailing list commits@deltacloud.apache.org Received: (qmail 20728 invoked by uid 99); 6 Mar 2013 22:09:19 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 06 Mar 2013 22:09:19 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id C73B7830E9E; Wed, 6 Mar 2013 22:09:18 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: marios@apache.org To: commits@deltacloud.apache.org X-Mailer: ASF-Git Admin Mailer Subject: [2/5] SITE: addresses DTACLOUD-478, DTACLOUD-479 and removes crud Message-Id: <20130306220918.C73B7830E9E@tyr.zones.apache.org> Date: Wed, 6 Mar 2013 22:09:18 +0000 (UTC) http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/cimi-rest/cimi-rest-volumes.html ---------------------------------------------------------------------- diff --git a/site/output/cimi-rest/cimi-rest-volumes.html b/site/output/cimi-rest/cimi-rest-volumes.html index 906fe30..361439d 100644 --- a/site/output/cimi-rest/cimi-rest-volumes.html +++ b/site/output/cimi-rest/cimi-rest-volumes.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -115,7 +115,7 @@ A Volume Collection resource represents the collection of Volumes within a Provi - - + - -
    - -
    +

    Retrieve the Volume Collection

    @@ -320,8 +314,7 @@ Server: thin 1.5.0 codename Knife </Volume> -
    -

    Using VolumeTemplate with VolumeConfiguration by value - Example request:

    +

    Using VolumeTemplate with VolumeConfiguration by value - Example request:

     POST /cimi/volumes HTTP/1.1
 Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
@@ -405,7 +398,6 @@ Server: thin 1.5.0 codename Knife
    -

     Back to top

    http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/clients.html ---------------------------------------------------------------------- diff --git a/site/output/clients.html b/site/output/clients.html index b951a0a..b88b2a6 100644 --- a/site/output/clients.html +++ b/site/output/clients.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -97,7 +97,6 @@ -

     Back to top

    http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/command-tools.html ---------------------------------------------------------------------- diff --git a/site/output/command-tools.html b/site/output/command-tools.html index 150cb6e..212258d 100644 --- a/site/output/command-tools.html +++ b/site/output/command-tools.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -103,14 +103,10 @@

    The deltacloud core developers use (almost exclusively) cURL as a command line client for working with a deltacloud server. You can find more information on working with cURL against deltacloud here.

    -
    - -


    +


    /deprecated:


    -
    - -


    +


    Using Deltacloud command tool

    @@ -119,7 +115,7 @@ 

    $ deltacloudc collection operation [options]
    -
    Collection
    +
    Collection
    refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc., as described in a greater detail in the Deltacloud REST API documentation.
    @@ -129,11 +125,9 @@
    Options
    - are listed by invoking deltacloudc -h. The important option is -u, which specifies the API_URL, where the Deltacloud server is running. The API_URL takes the form of http://[user]:[password]@[api_url]:[port]/[api]. Alternatively, you can set the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). If your username or your password contains special characters, it's necessary to use options -U and -P in addition to the option -u. Check the list of credentials you need for each back-end cloud provider. + are listed by invoking deltacloudc -h. The important option is -u, which specifies the API_URL, where the Deltacloud server is running. The API_URL takes the form of http://[user]:[password]@[api_url]:[port]/[api]. Alternatively, you can set the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). If your username or your password contains special characters, it's necessary to use options -U and -P in addition to the option -u. Check the list of credentials you need for each back-end cloud provider.
    -
    - -

    +

    The following examples assume that the Deltacloud server is running on your local machine port 3001 (the deltacloudd server daemon defaults to 'localhost:3001') and that it was started with the 'mock' provider (i.e. deltacloudd -i mock ).

    List all collections available in the current driver:

    @@ -152,8 +146,6 @@ The following examples assume that the Deltacloud server is running on your loca 
    $ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt
    - -

    Example request:

    @@ -221,7 +220,6 @@ Content-Length: 182


    -

     Back to top

    http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/contact.html ---------------------------------------------------------------------- diff --git a/site/output/contact.html b/site/output/contact.html index 2c8d0a0..272d86b 100644 --- a/site/output/contact.html +++ b/site/output/contact.html @@ -44,7 +44,7 @@ About
  • Download
    • http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/contribute.html ---------------------------------------------------------------------- diff --git a/site/output/contribute.html b/site/output/contribute.html index 7500d76..58a10c5 100644 --- a/site/output/contribute.html +++ b/site/output/contribute.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -97,7 +97,6 @@ -

     Back to top

    http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/credentials.html ---------------------------------------------------------------------- diff --git a/site/output/credentials.html b/site/output/credentials.html index 362d522..58228b4 100644 --- a/site/output/credentials.html +++ b/site/output/credentials.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -98,18 +98,16 @@


    Cloud provider credentials

    - - - + + - - - - - + + + @@ -117,8 +115,8 @@ - - + @@ -126,8 +124,8 @@ - - + @@ -135,8 +133,8 @@ - - + @@ -144,8 +142,8 @@ - - + @@ -153,8 +151,8 @@ - - + @@ -162,8 +160,8 @@ - - + @@ -171,8 +169,8 @@ - - + @@ -180,8 +178,8 @@ - - + @@ -191,8 +189,8 @@ - - + @@ -200,8 +198,8 @@ - - + @@ -209,8 +207,8 @@ - - + @@ -218,8 +216,8 @@ - - + @@ -227,10 +225,9 @@ - +
    Cloud
    Cloud Driver Username Password Notes
    +
    mock mockmockpassword The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
    +
    Amazon EC2/S3 ec2Secret Access Key This information can be found on the Security Credentials page in your AWS account.
    +
    Eucalyptus eucalyptusSecret Access Key
    +
    GoGrid gogridShared Secret Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
    +
    IBM SmartCloud sbcPassword
    +
    Microsoft Azure (Storage Account only) azurePrimary Access Key The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
    +
    OpenNebula opennebulaOpenNebula password Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
    +
    Rackspace Cloud Servers/Cloud Files rackspaceAPI Key Obtain the key from the API Access page in your control panel.
    +
    RHEV-M rhevmRHEV-M password Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
    +
    Rimuhosting rimuhostingAPI Key
    +
    Terremark terremarkPassword
    +
    VMware vSphere vspherevSphere user password Set environment variable API_PROVIDER to the hostname of the vSphere server.
    +
    OpenStack openstackOpenStack user password Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.
    -

     Back to top

    http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/curl-examples.html ---------------------------------------------------------------------- diff --git a/site/output/curl-examples.html b/site/output/curl-examples.html index a454722..40cf61a 100644 --- a/site/output/curl-examples.html +++ b/site/output/curl-examples.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -106,7 +106,7 @@

    The cURL documentation is pretty comprehensive, but the following are some general points to remember for using cURL against Deltacloud. All the examples on this page assume the deltacloud server is running at localhost:3001:

      -
    • +
    • Credentials are specified with --user "name:password"
    • @@ -122,13 +122,12 @@ curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http:/
    - -
    +
    - -
    +
    -
    - -

    Working with instances

    +

    Working with instances

    Display a complete list of instances in xml format:

    @@ -356,7 +352,6 @@ listener_balancer_port=80&listener_instance_port=3001" http://localhost:3001

    Delete a storage snapshot:

    curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_snapshots/snap-dda6cebc?format=xml
    -

     Back to top

    http://git-wip-us.apache.org/repos/asf/deltacloud/blob/c7f4d022/site/output/download.html ---------------------------------------------------------------------- diff --git a/site/output/download.html b/site/output/download.html index 3362825..e850215 100644 --- a/site/output/download.html +++ b/site/output/download.html @@ -44,7 +44,7 @@ About
  • Download
    • @@ -109,10 +109,9 @@ signatures from our main distribution directory.

    Current release

    - - - - +
    server-gem
    + + - - + + - - + + - - + + - -
    server-gem deltacloud-core-1.1.1.gem ( @@ -122,8 +121,8 @@ )
    server-sources
    server-sources deltacloud-core-1.1.1.tgz ( @@ -133,8 +132,8 @@ )
    client-gem
    client-gem deltacloud-client-1.1.1.gem ( @@ -144,8 +143,8 @@ )
    client-sources
    client-sources deltacloud-client-1.1.1.tgz ( @@ -155,9 +154,7 @@ )
    -

    +

    Old releases

    Older releases of Apache Deltacloud can be found here. We highly recommend to not use @@ -207,7 +204,6 @@ $ gpg --import KEYS $ gpg --verify deltacloud-core-1.1.1.tar.gz.asc - 

    @@ -151,9 +150,8 @@ The driver and provider can be selected through the request headers  X-D
 
 
    Compute Driver Functionality
    
 
-  
-    
-      
+
+
@@ -181,11 +179,10 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-  
-  
-    
-      
+
+
+
@@ -199,8 +196,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -213,8 +210,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -227,8 +224,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -241,8 +238,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -255,8 +252,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -269,8 +266,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -283,8 +280,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -297,8 +294,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -311,8 +308,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -325,8 +322,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -339,8 +336,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -353,8 +350,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -367,16 +364,27 @@ The driver and provider can be selected through the request headers  X-D
       
-  
-
     
     
       
         Create new instances
       
         List all/get details about instances
       
    
+    
    
         Amazon EC2
       
       yesyes
       
     
    
+
    
         Eucalyptus
       
       yesyes
       yes
     
    
+
    
         Fujitsu FGCP
       
       yesyes
       yes
     
    
+
    
         IBM SmartCloud
       
       yesyes
       yes
     
    
+
    
         GoGrid
       
       yesyes
       yes
     
    
+
    
         OpenNebula
       
       yesyes
       yes
     
    
+
    
         Rackspace
       
       yesyes
       yes
     
    
+
    
         RHEV-M
       
       yesyes
       yes
     
    
+
    
         RimuHosting
       
       yesyes
       yes
     
    
+
    
         Terremark
       
       yesyes
       yes
     
    
+
    
         vSphere
       
       yesyes
       yes
     
    
+
    
         OpenStack
       
       yesyes
       yes
     
    
+
    
         Arubacloud
       
       yesyes
       yes
     
    
-
-

    
+
+
+        DigitalOcean
+      
+      yes
+      yes
+      yes
+      yes
+      yes
+      yes
+      yes
+      yes
+      yes
+    
+
+

    
 
 
    Storage Driver Functionality
    
 
-  
-    
-      
+
+
@@ -395,11 +403,10 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-  
-  
-    
-      
+
+
+
@@ -409,8 +416,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -420,8 +427,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -431,8 +438,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -442,8 +449,8 @@ The driver and provider can be selected through the request headers  X-D
       
-    
-      
+
@@ -453,9 +460,19 @@ The driver and provider can be selected through the request headers  X-D
       
-  
-
     
     
       
         Create new buckets
       
         Read/write individual blob attributes
       
    
+    
    
         Amazon S3
       
       yesyes
       yes
     
    
+
    
         Eucalyptus Walrus
       
       yesyes
       yes
     
    
+
    
         Rackspace CloudFiles
       
       yesyes
       yes
     
    
+
    
         Microsoft Azure
       
       yesyes
       yes
     
    
+
    
         Google Storage
       
       yesyes
       yes
     
    
-

    
+
+
+        Openstack object-store (swift)
+      
+      yes
+      yes
+      yes
+      yes
+      yes
+      yes
+    
+
+

    
 
    
 Deltacloud uses basic HTTP authentication to receive credentials from the client and passes them through to the particular back-end cloud. The credentials always consist of a username and password and they are never stored on the server. The exact credentials for logging into the server, and a place where you can find them, depends on the backend cloud that the server is talking to.
 
    
@@ -467,22 +484,18 @@ The following table gives details about the credentials that must be provided fo
 
-
-
    Cloud provider credentials
    
+
    Cloud provider credentials
    
 
-  
-    
-      
+
+
-    
-  
-  
-    
-      
+
+
+
@@ -490,8 +503,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -499,8 +512,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -508,8 +521,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -523,8 +536,8 @@ The following table gives details about the credentials that must be provided fo
           in Windows. Then use Username to authenticate.
       
-    
-      
+
@@ -534,8 +547,8 @@ The following table gives details about the credentials that must be provided fo
       Go to My Account > API Keys for your account and click on the key you want to use to find the Shared Secret.
       
-    
-      
+
@@ -543,8 +556,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -554,8 +567,8 @@ The following table gives details about the credentials that must be provided fo
       The Storage Account Name is chosen when you create the service (e.g. name in name.blob.core.windows.net). The name and the access key are available from the service control panel.
       
-    
-      
+
@@ -563,8 +576,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -572,8 +585,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -581,8 +594,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -592,8 +605,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -601,8 +614,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -610,8 +623,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -619,8 +632,8 @@ The following table gives details about the credentials that must be provided fo
       
-    
-      
+
@@ -628,11 +641,17 @@ The following table gives details about the credentials that must be provided fo
       
-
-  
-
    Cloud
    Cloud
       Driver
       Username
       Password
       Notes
    
+    
    
         mock
       
       mockmockpassword
       The mock driver does not communicate with any cloud; it just pretends to be a cloud.
     
    
+
    
         Amazon EC2/S3
       
       ec2Secret Access Key
       Retrieve neccessary information from the Security Credentials page in your AWS account.
     
    
+
    
         Eucalyptus
       
       eucalyptusSecret Access Key
       
     
    
+
    
         Fujitsu FGCP
       
       fgcp
     
    
+
    
         GoGrid
       
       gogrid
     
    
+
    
         IBM SmartCloud
       
       sbcPassword
       
     
    
+
    
         Microsoft Azure (Storage Account only)
       
       azure
     
    
+
    
         OpenNebula
       
       opennebulaOpenNebula password
       Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
     
    
+
    
         OpenStack
       
       openstackThe username is OpenStack user name and tenant_name concatenated with a '+' and password is your openstack service password.
       Set the environment variable API_PROVIDER to the URL of Keystone Identity service. Alternatively use the '-P' option when starting the Deltacloud server. See notes for more info.
     
    
+
    
         Rackspace Cloud Servers/Cloud Files
       
       rackspaceAPI Key
       Obtain the key from the API Access page in your control panel.
     
    
+
    
         RHEV-M
       
       rhevmRHEV-M password
       Set the environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint. 
     
    
+
    
         Rimuhosting
       
       rimuhostingAPI Key
       
     
    
+
    
         Terremark
       
       terremarkPassword
       
     
    
+
    
         VMware vSphere
       
       vspherevSphere user password
       Set the environment variable API_PROVIDER to the hostname of the vSphere server and the Datastore.
     
    
+
    
         Arubacloud
       
       arubacloudPassword
       
     
    
-
-

    
+
+
+        DigitalOcean
+      
+      digitalocean
+      Client Key
+      API Key
+      Obtain these credentials from the API access page of your digitalocean account.
+    
+
+

    
 
 
    Notes on specific drivers
    
 
@@ -728,12 +747,11 @@ The OpenNebula driver has been updated to support v3.x of the OpenNebula API. Th
       FGCP virtual systems and networks are both mapped to realms:
       
    
 
      
-      
    • Creating a firewall is equivalent to creating a FGCP virtual system. Specify a system descriptor ID as firewall description (e.g. "1-tier Skeleton").
      • 
+
    • Creating a firewall is equivalent to creating a FGCP virtual system. Specify a system descriptor ID as firewall description (e.g. "1-tier Skeleton").
      • 
       
    • Destroying a firewall destroys the virtual system. All instances in it need to be in the STOPPED state. This operation first stops the firewall and therefore it can take five minutes until the firewall actually disappears.
      • 
       
    • When creating an instance, specify a network segment realm as target location.
      • 
       
    
-
-
    +
    @@ -834,7 +852,6 @@ The username and password in 401 challenge should be the same as you use in the
    -