In order to manage a HMC with the LPAR-Tool, the HMC must be registered once. The HMC must be accessible via SSH.

hmc add [-v] [<user>@]<hmc> ...
  -v   # verbose only, show actions but do not carry them out

<user>   # the account to use on the HMC

At least one  HMC must be specified. Optionally, a user account to be used can also be specified, e.g. hscroot@hmc01. If necessary, multiple HMCs can be given and registered.

When registering an HMC, the connected managed systems and LPARs are determined:

$ hmc add hmc01
hmc01: 
ms01(304F13Y)
> aix01
> aix02
...
$

The collected information is saved in the home directory in the files hmc.list, ms.list and lpar.list.

$ ls -l *.list
-rw-r--r--. 1 user01 staff   495 Dec 20 10:40 hmc.list
-rw-r--r--. 1 user01 staff 22825 Dec 20 10:40 lpar.list
-rw-r--r--. 1 user01 staff  2480 Dec 20 10:40 ms.list
$ 

These files allow the LPAR-Tool to quickly map between LPARs, managed systems and HMCs. If changes have occurred, e.g. because LPARs were moved to another managed system using LPM, these files must be updated. This is done with the hmc rescan command.