diff --git a/docs/source/guides/admin-guides/manage_clusters/index.rst b/docs/source/guides/admin-guides/manage_clusters/index.rst index d44e4a099..c2750c383 100644 --- a/docs/source/guides/admin-guides/manage_clusters/index.rst +++ b/docs/source/guides/admin-guides/manage_clusters/index.rst @@ -11,3 +11,4 @@ The sections are organized based on hardware architecture. ppc64le/index.rst x86_64/index.rst + openbmc/index.rst diff --git a/docs/source/guides/admin-guides/manage_clusters/openbmc/configure.rst b/docs/source/guides/admin-guides/manage_clusters/openbmc/configure.rst new file mode 100644 index 000000000..0c9de13f3 --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/openbmc/configure.rst @@ -0,0 +1,9 @@ +Configure passwords +=================== + +Configure the passwords for Management modules of the compute nodes. + +* For OpenBMC managed systems: :: + + chtab key=openbmc passwd.username=root passwd.password=0penBMC + diff --git a/docs/source/guides/admin-guides/manage_clusters/openbmc/index.rst b/docs/source/guides/admin-guides/manage_clusters/openbmc/index.rst new file mode 100644 index 000000000..b6252768b --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/openbmc/index.rst @@ -0,0 +1,11 @@ +OpenPOWER (OpenBMC managed) +=========================== + +The following sections document the procedures in managing OpenPOWER servers in an xCAT cluster. +OpenPower servers are machines that use IBM Power Architecture and are **OpenBMC** managed. + +.. toctree:: + :maxdepth: 2 + + configure.rst + openbmc.rst diff --git a/docs/source/guides/admin-guides/manage_clusters/openbmc/openbmc.rst b/docs/source/guides/admin-guides/manage_clusters/openbmc/openbmc.rst new file mode 100644 index 000000000..54b460176 --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/openbmc/openbmc.rst @@ -0,0 +1,60 @@ +Manually Define Nodes +===================== + +If admin knows the detailed information of the physical server, ``mkdef`` command can be used to manually define it into xCAT database. + +In this document, the following configuration is used as an example + +Compute Node info:: + + CN Hostname: cn1 + BMC Address: 50.0.101.1 + OpenBMC username: root + OpenBMC Password: 0penBMC + +Run ``mkdef`` command to define the node: :: + + mkdef -t node cn1 groups=openbmc,all mgt=openbmc cons=openbmc bmc=50.0.101.1 bmcusername=root bmcpassword=0penBmc + +The manually defined node will be :: + + # lsdef cn1 + Object name: cn1 + bmc=50.0.101.1 + bmcpassword=0penBmc + bmcusername=root + cons=openbmc + groups=openbmc,all + mgt=openbmc + postbootscripts=otherpkgs + postscripts=syslog,remoteshell,syncfiles + +Hardware Management +=================== + +Remote Power Control +```````````````````` + +``rpower`` command can be used to control the power of a remote physical machine. :: + + rpower cn1 on + rpower cn1 off + rpower cn1 boot + rpower cn1 reset + +To get the current rpower state of a machine: :: + + # rpower cn1 state + cn1: on + +Remote Console +`````````````` + +``rcons`` command can be used to get command line remote console. + +#. Make sure the ``conserver`` is configured by running ``makeconservercf cn1``. + +#. Start command line remote console: :: + + rcons cn1 +