Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Using a hosts file


Typically, the HCP system uses DNS for system addressing. If this is not the case, for access to a namespace by hostname, you need to provide a mapping of the namespace hostname to an IP address for the HCP system.

To find out whether the HCP system is configured for DNS and to learn the IP addresses for the system, contact your tenant administrator.

NoteWebHelp.png

Note: For information about considerations for using hostnames and IP addresses, see Hostname and IP address considerations.

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/host

Hostname mappings

Each entry in a hosts file maps one or more fully qualified hostnames to a single IP address. For example, if one of the IP addresses for the HCP system is 192.168.210.16, you would add this line to the hosts file to enable access to the namespace named finance that's owned by the tenant named europe:

192.168.210.16 finance.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

An HCP system has multiple IP addresses. You can map each hostname to more than one of these IP addresses in the hosts file. The way multiple mappings are used depends on the client platform. For information about how your client handles multiple mappings in a hosts file, see your client documentation.

NoteWebHelp.png

Note: If any of the IP addresses listed in the hosts file are unavailable, timeouts may occur when you use a hosts file for namespace access.

Sample hosts file entries

The following lines show the portion of a hosts file that maps the hostnames for two namespaces, which are owned by a single tenant, to two IP addresses, 192.168.130.13 and 192.168.130.14. The example has only a single hostname per entry to make the file contents easier to read.

# europe tenant data access
192.168.130.13 finance.europe.hcp.example.com # finance namespace
192.168.130.14 finance.europe.hcp.example.com # finance namespace
192.168.130.13 support.europe.hcp.example.com # support namespace
192.168.130.14 support.europe.hcp.example.com # support namespace

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

 

  • Was this article helpful?