Using the NIM dkls_init operation

Use the dkls_init operation to prepare resources for use by a diskless client.

The command line syntax for the dkls_init operation is as follows:
nim -o dkls_init -a Attribute=Value ... TargetName |TargetNames

The target of a dkls_init operation can be any diskless NIM client or group of diskless NIM clients.

The following are required attributes that can be specified for the dkls_init operation:

Item Description
-a paging=Value Specifies the paging resource that contains client paging files.
-a spot=Value Specifies the SPOT resource to be used to provide network boot support and the /usr file system for clients.
One of the following two attributes must be specified for the dkls_init operation:
Item Description
-a root=Value Specifies the root resource that contains the client root (/) directories. The root resource must be served by the same machine that serves the SPOT resource.
-a shared_root=Value Specifies the shared_root resource that contains the client root (/) directories. The shared_root resource must have been created from the same SPOT resource that is specified by the -a spot attribute.

The following are optional attributes that can be specified for the dkls_init operation:

Item Description
-a dump=Value Specifies the dump resource that contains client dump files.
-a configdump=Value Specifies the type of firmware-assisted dump to configure on the client. Valid values are:
  • selective, which avoids dumping user data.
  • full, which dumps all of the memory of the client partition.
  • none, which unconfigures the dump.

The selective and full memory dumps are collected in the dump resource allocated to the client. Only POWER6 or later clients that have the appropriate firmware installed can dump to the dump resource.

-a group=Value Specifies the name of a resource group to use for the installation. A resource group can be specified as an alternative to specifying multiple resources as separate attributes.
-a home=Value Specifies the home resource that contains client /home directories.
-a resolv_conf=Value Specifies the resolv_conf resource to configure Domain Name Protocol name server information on the client.
-a shared_home=Value Specifies the shared_home resource that contains a common /home directory for multiple clients.
-a size=Value Specifies the size in megabytes for client paging files.
-a tmp=Value Specifies the tmp resource that contains client /tmp directories.
-a verbose=Value Displays information for debugging. Valid values are 1-5. Use verbose=5 to show maximum detail. The default is to show no debugging output.

The dkls_init operation populates client directories and creates client paging files. A network boot image is also allocated to the client. When the client boots over the network, it obtains the boot image and is configured to mount the remaining resources.