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..9918f7873 --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/openbmc/index.rst @@ -0,0 +1,12 @@ +OpenPOWER (OpenBMC managed) +=========================== + +The following sections documents the procedures in managing OpenPOWER servers in an xCAT cluster. +These are machines use the IBM Power Architecture and is **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..d9df935a3 --- /dev/null +++ b/docs/source/guides/admin-guides/manage_clusters/openbmc/openbmc.rst @@ -0,0 +1,60 @@ +Manually Define Nodes +===================== + +**Manually Define Node** means the admin knows the detailed information of the physical server and manually defines it into xCAT database with ``mkdef`` commands. + +In this document, the following configuration is used in the example + +Compute Node info:: + + CN Hostname: cn1 + BMC Address: 50.0.101.1 + OpenBMC username: root + OpenBMC Password: 0penBMC + +Execute ``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=OpenBMC + +The manually defined node will be like this:: + + # lsdef cn1 + Object name: cn1 + bmc=50.0.101.1 + bmcpassword=OpenBMC + bmcusername=root + cons=openbmc + groups=openbmc,all + mgt=openbmc + postbootscripts=otherpkgs + postscripts=syslog,remoteshell,syncfiles + +Hardware Management +=================== + +Remote Power Control +```````````````````` + +The next important thing is to control the power of a remote physical machine. For this purpose, ``rpower`` command is involved. :: + + rpower cn1 on + rpower cn1 off + rpower cn1 boot + rpower cn1 reset + +Get the current rpower state of a machine, refer to the example below. :: + + # rpower cn1 state + cn1: on + +Remote Console +`````````````` + +In order to get the command line console remotely. xCAT provides the ``rcons`` command. + +#. Make sure the ``conserver`` is configured by running ``makeconservercf``. + +#. After that, you can get the command line console for a specific machine with the ``rcons`` command :: + + rcons cn1 +