diff --git a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/config_environment.rst b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/config_environment.rst index 8034595cb..de1c3f7d9 100644 --- a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/config_environment.rst +++ b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/config_environment.rst @@ -33,17 +33,6 @@ Update DHCP configuration file:: makedhcp -n makedhcp -a -setup DNS -````````` - -Set site.forwarders to your site-wide DNS servers that can resolve site or public hostnames. The DNS on the MN will forward any requests it can't answer to these servers:: - - chdef -t site forwarders=8.8.8.8 - -Run makedns to get the hostname/IP pairs copied from /etc/hosts to the DNS on the MN:: - - makedns -n - Config passwd table ``````````````````` @@ -56,10 +45,6 @@ For hardware management with ipmi, add the following line:: "ipmi","ADMIN","admin",,,, -For OS provisioning, add the following line:: - - "system","root","cluster",,,, - Verify the genesis pkg `````````````````````` diff --git a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/mtms_discovery.rst b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/mtms_discovery.rst index 68e907ee0..af863e5fb 100644 --- a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/mtms_discovery.rst +++ b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/mtms_discovery.rst @@ -11,9 +11,13 @@ Discover server and define After environment is ready, and the server is powered, we can start server discovery process. The first thing to do is discovering the FSP/BMC of the server. It is automatically powered on when the physical server is powered. -The following command can be used to discovery FSP/BMC within an IP range and write the discovered node definition into a stanza file:: +The following command can be used to discovery BMC within an IP range and write the discovered node definition into a stanza file:: - lsslp -s PBMC -u --range 50.0.100.1-100 -z > ./pbmc.stanza + bmcdiscover -s nmap --range 50.0.100.1-100 -z > ./bmc.stanza + +**Note**: bmcdiscover will use username/password pair set in ``passwd`` table with **key** equal **ipmi**. If you'd like to use other username/password, you can use :: + + bmcdiscover -s nmap --range 50.0.100.1-100 -z -u -p > ./bmc.stanza You need to modify the node definition in stanza file before using them, the stanza file will be like this:: @@ -21,12 +25,10 @@ You need to modify the node definition in stanza file before using them, the sta cn1: objtype=node bmc=50.0.100.1 - nodetype=mp mtm=8247-42L serial=10112CA groups=pbmc,all mgt=ipmi - hidden=0 Then, define it into xCATdb:: @@ -47,7 +49,7 @@ The server definition will be like this:: postscripts=syslog,remoteshell,syncfiles serial=10112CA -After the physical server is defined into xCATdb, the next thing is update the node definition with the scheduled node info like this:: +After the physical server is defined into xCATdb, the next thing is update the node definition with the example node attributes:: # chdef cn1 ip=10.0.101.1 1 object definitions have been created or modified. @@ -57,6 +59,8 @@ Then, add node info into /etc/hosts and DNS:: makehosts cn1 makedns -n + + Start discovery process ----------------------- diff --git a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/pbmc_discovery_with_bmcdiscover.rst b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/pbmc_discovery_with_bmcdiscover.rst new file mode 100644 index 000000000..a5f0a5d42 --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/pbmc_discovery_with_bmcdiscover.rst @@ -0,0 +1,40 @@ +Discover server and define +-------------------------- + +After environment is ready, and the server is powered, we can start server discovery process. The first thing to do is discovering the FSP/BMC of the server. It is automatically powered on when the physical server is powered. + +The following command can be used to discovery BMC within an IP range and write the discovered node definition into xCAT database:: + + bmcdiscover -s nmap --range 50.0.100.1-100 -z -w + +The discovered BMC node will be like this:: + + # lsdef node-8247-42l-10112ca + Object name: node-8247-42l-10112ca + bmc=50.0.100.1 + cons=ipmi + groups=all + mgt=ipmi + mtm=8247-42L + postbootscripts=otherpkgs + postscripts=syslog,remoteshell,syncfiles + serial=10112CA + +**Note**: + 1. The BMC node is just used to control the physical during hardware discovery process, it will be deleted after the correct server node object is found. + + 2. bmcdiscover will use username/password pair set in ``passwd`` table with **key** equal **ipmi**. If you'd like to use other username/password pair, you can use :: + + bmcdiscover -s nmap --range 50.0.100.1-100 -z -w -u -p + +Start discovery process +----------------------- + +To start discovery process, just need to power on the PBMC node remotely with the following command, and the discovery process will start automatically after the host is powered on:: + + rpower node-8247-42l-10112ca on + +**[Optional]** If you'd like to monitor the discovery process, you can use:: + + makeconsercf node-8247-42l-10112ca + rcons node-8247-42l-10112ca diff --git a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/pbmc_discovery_with_lsslp.rst b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/pbmc_discovery_with_lsslp.rst new file mode 100644 index 000000000..9f9b682d9 --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/pbmc_discovery_with_lsslp.rst @@ -0,0 +1,52 @@ +Discover server and define +-------------------------- + +After environment is ready, and the server is powered, we can start server discovery process. The first thing to do is discovering the FSP/BMC of the server. It is automatically powered on when the physical server is powered. + +The following command can be used to discovery FSP/BMC within an IP range and write the discovered node definition into a stanza file:: + + lsslp -s PBMC -u --range 50.0.100.1-100 -z > ./pbmc.stanza + +You need to modify the node definition in stanza file before using them, the stanza file will be like this:: + + # cat pbmc.stanza + cn1: + objtype=node + bmc=50.0.100.1 + nodetype=mp + mtm=8247-42L + serial=10112CA + groups=pbmc,all + mgt=ipmi + hidden=0 + +Then, define it into xCATdb:: + + # cat pbmc.stanza | mkdef -z + 1 object definitions have been created or modified. + +The server definition will be like this:: + + # lsdef cn1 + Object name: cn1 + bmc=50.0.100.1 + groups=pbmc,all + hidden=0 + mgt=ipmi + mtm=8247-42L + nodetype=mp + postbootscripts=otherpkgs + postscripts=syslog,remoteshell,syncfiles + serial=10112CA + +After the physical server is defined into xCATdb, the next thing is update the node definition with the scheduled node info like this:: + + # chdef cn1 ip=10.0.101.1 + 1 object definitions have been created or modified. + +Then, add node info into /etc/hosts and DNS:: + + makehosts cn1 + makedns -n + + diff --git a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/seq_discovery.rst b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/seq_discovery.rst index f87ee1df0..929dd0335 100644 --- a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/seq_discovery.rst +++ b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/seq_discovery.rst @@ -47,5 +47,5 @@ Stop the current sequential discovery process:: Note: The sequential discovery process will be stopped automatically when all of the node names in the node pool are used up. -.. include:: pbmc_discovery.rst +.. include:: pbmc_discovery_with_bmcdiscover.rst .. include:: standard_cn_definition.rst diff --git a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/switch_discovery.rst b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/switch_discovery.rst index 6c972df7b..cb8e45e80 100644 --- a/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/switch_discovery.rst +++ b/docs/source/guides/admin-guides/manage_clusters/ppc64le/discovery/switch_discovery.rst @@ -57,7 +57,7 @@ Add cn1 into DNS:: makehosts cn1 maekdns -n -.. include:: pbmc_discovery.rst +.. include:: pbmc_discovery_with_bmcdiscover.rst Verify node definition ----------------------