From 61eb8c29078c88ae9aa2c378b3070781943f9186 Mon Sep 17 00:00:00 2001 From: nott Date: Tue, 22 Jan 2013 14:22:59 +0000 Subject: [PATCH] add multi-domain and nics info git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@14945 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man8/makehosts.8.pod | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/xCAT-client/pods/man8/makehosts.8.pod b/xCAT-client/pods/man8/makehosts.8.pod index 563d817b7..e27344959 100644 --- a/xCAT-client/pods/man8/makehosts.8.pod +++ b/xCAT-client/pods/man8/makehosts.8.pod @@ -10,10 +10,19 @@ B {B<-h>|B<--help>} =head1 DESCRIPTION -B updates the /etc/hosts file based on entries in the hosts table in the xCAT database. -If your node hostnames and IP addresses follow a regular pattern, you can use just a few regular expressions -in the hosts table and then easily generate /etc/hosts using makehosts. - +B updates the /etc/hosts file based on information stored in the +xCAT database object definitions. + +The main three bits of information needed are: node hostname, node ip and network domain name. + +The hostname and ip address are specified as part of the node definition. + +The domain value is taken either from the xCAT network definition associated with the node or from the cluster site definition. If you are using multiple domains in the cluster you should add the domain names to the appropriate xCAT network definition. + +Note: If your node hostnames and IP addresses follow a regular pattern, you can use just a few regular expressions to generate /etc/hosts using makehosts. For details on using regular expressions see the "xcatdb" man page. + +If you specify additional network interfaces in your xCAT node definitions they will also be added to the /etc/hosts file. You can specify additional network interface information (NICs) using the following node attributes: nicips, nichostnamesuffixes, nictypes, niccustomscripts, nicnetworks. You can get a description of these attributes by running "lsdef -t node -h | more" or "man nics". + =head1 OPTIONS =over 6 @@ -35,7 +44,7 @@ from the mac address stored in mac table. =item B<-d> -Delete rather than create records. +Delete rather than create records. This will also delete any additional network interfaces (NICs) included in the node definitions. =back @@ -43,6 +52,12 @@ Delete rather than create records. =over 2 +=item * + +Add entries to /etc/hosts for all nodes included in the xCAT node group called "compute". + + makehosts compute + =item * If the xCAT hosts table contains: