Using a hosts file

Typically, the HCP system uses DNS for system addressing. If this is not the case, to access the system, you need to provide mappings of the hostname of each target tenant or bucket to one or more node IP addresses.

You specify hostname mappings in the hosts file on the client. The location of this file depends on the client operating system:

On Windows®, by default: c:\windows\system32\drivers\etc\hosts

On Unix: /etc/hosts

On Mac OS® X: /private/etc/hosts

Hostname mappings

Each entry in a hosts file maps one or more fully qualified hostnames to a single IP address. For example, the entry below maps the hostname of the europe tenant in the HCP system named hcp.example.com to the IP address 192.168.210.16:

192.168.210.16 europe.hcp.example.com

The following considerations apply to hosts file entries:

Each entry must appear on a separate line.

Multiple hostnames in a single line must be separated by white space. With some versions of Windows, these must be single spaces.

Each hostname can map to multiple IP addresses.

You can include comments in a hosts file either on separate lines or following a mapping on the same line. Each comment must start with a number sign (#). Blank lines are ignored.

Hostname mapping considerations

You can map a hostname to any number of IP addresses. The way multiple mappings are used depends on the client platform. For information on how your client handles multiple mappings in a hosts file, see your client documentation.

If any of the HCP nodes listed in the hosts file are unavailable, timeouts may occur when you use a hosts file to access the system through the HS3 API.

Sample hosts file

Here’s a sample hosts file that contains mappings at the tenant and bucket levels:

# HCP tenant-level mappings
192.168.210.16 europe.hcp.example.com
192.168.210.17 europe.hcp.example.com
192.168.210.18 europe.hcp.example.com
192.168.210.19 europe.hcp.example.com

# bucket-level mappings
192.168.210.16 finance.europe.hcp.example.com hr.europe.hcp.example.com
192.168.210.17 finance.europe.hcp.example.com hr.europe.hcp.example.com
192.168.210.18 finance.europe.hcp.example.com hr.europe.hcp.example.com
192.168.210.19 finance.europe.hcp.example.com hr.europe.hcp.example.com

Trademark and LegalDisclaimer

© 2016 Hitachi Data Systems Corporation. All rights reserved.