fog--fog/lib/fog/hp/docs/connect.md

Connecting to HP Cloud Services using Ruby Fog Bindings

The HP Cloud uses OpenStack as the platform and you can connect and set up your HP Cloud using Ruby Fog. To begin, connect using the following instructions:

• Initial Connection
• Availability Zones
• Optional Parameters

Initial Connection

To connect to the HP Cloud, follow these steps:

1. Enter IRB

    irb
   

2. Require the Fog library and Rubygems:

    require 'rubygems'
    require 'fog'
   

   Note: If the require 'rubygems' command returns a value of false, enter IRB with the following command:

    irb -r 'rubygems'
   

3. Establish a connection to the desired HP Cloud service

    conn = Fog::<SERVICE-NAME>.new(
           :provider      => "HP",
           :hp_access_key  => "<your_ACCESS_KEY>",
           :hp_secret_key => "<your_SECRET_KEY>",
           :hp_auth_uri   => "<IDENTITY_ENDPOINT_URL>",
           :hp_tenant_id => "<your_TENANT_ID>",
           :hp_avl_zone => "<your_AVAILABILITY_ZONE>",
           <other optional parameters>
           )
   

Where SERVICE-NAME can be Compute, Storage, CDN or other services. Please surf on over to the Block Storage for the details on how to connect to that service.

Note: You must use the :hp_access_key parameter rather than the now-deprecated :hp_account_id parameter you might have used in previous versions of the HP Cloud Services Extensions to Ruby Fog.

You can find the values the access key, secret key, and other values by clicking the API Keys button in the Console Dashboard.

Availability Zones

You cannot specify an availability zone if you have not activated it. To activate an availability zone, go to the Management Console dashboard and click the **Activate** button. You are required to set an availability zone to establish a connection; there is no default availability zone value.

The current usable availability zones for the compute service:

• az-1.region-a.geo-1
• az-2.region-a.geo-1
• az-3.region-a.geo-1

The current usable availability zones for the storage service:

• region-a.geo-1
• region-b.geo-1

The current usable availability zones for the CDN:

• region-a.geo-1
• region-b.geo-1

The current usable availability zones for the block storage service:

• az-1.region-a.geo-1
• az-2.region-a.geo-1
• az-3.region-a.geo-1

Optional Parameters

This section describes the optional parameters that you can use when connecting to any of the HP Cloud services. The examples below show the Compute service, but these optional parameters work with all of the HP Cloud services.

The user_agent parameter allows you to specify a string to pass as a user_agent header for the connection. You can use this to track the caller of the operations. You can set the user_agent parameter as follows:

    conn = Fog::Compute.new(
           ...
           ...
           :user_agent => "MyApp/x.x.x")

This inserts a user_agent string such as hpfog/x.x.x (MyApp/x.x.x) into the header.

In addition to the user_agent parameter, there are several additional parameters you can set using the connection_options parameter. These options are provided by the Excon library and allow you to modify the underlying connection to a service. These options are Instrumentation, Timeouts, Proxy, and HTTPS/SSL.

Instrumentation

Use this parameter for debugging purposes. When you use the default instrumentor Excon::StandardInstrumentor, all events are output to stderr. You can also designate your own instrumentor. You can set the default instrumentor as follows:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {:instrumentor => Excon::StandardInstrumentor})

For convenience of debugging HTTP requests, we have created a custom instrumentor Excon::SimpleHttpInstrumentor. This instrumentor shows the HTTP calls in afashion which is similar to a curl output. You can set the custom SimpleHttpInstrumentor as follows:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {:instrumentor => Excon::SimpleHttpInstrumentor, :instrumentor_name => 'SimpleHttp'})

Timeouts

Use this parameter to set different timeout values. You can set the timeouts parameter as follows:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {
                  :connect_timeout => <time_in_secs>,
                  :read_timeout => <time_in_secs>,
                  :write_timeout => <time_in_secs>})

Proxy

Use this parameter to specify a proxy URL for both HTTP and HTTPS connections. You can set the proxy parameter as follows:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {:proxy => 'http://myproxyurl:4444'})

HTTPS/SSL

By default, peer certificates are verified when you use secure socket layer (SSL) for HTTPS. Sometimes this does not work due to configurations in different operating systems, causing connection errors. To help avoid this, you can set HTTPS/SSL parameters. To set the path to the certificates:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {:ssl_ca_path => "/path/to/certs"})

To set the path to a certificate file:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {:ssl_ca_file => "/path/to/certificate_file"})

To set turn off peer verification:

    conn = Fog::Compute.new(
           ...
           ...
           :connection_options => {:ssl_verify_peer => false})

Note: This makes your connection less secure.

For further information on these options, please see the Excon documentation.

---

Documentation Home | Examples