drmgr Command

Purpose

The drmgr command is used to install and configure dynamic logical partitioning (DLPAR) scripts.

Syntax

drmgr { -i script_name [-w minutes ] [ -f ] [ -c ] [ -r ] | -u script_name } [ -D hostname ]

drmgr [ -b ]

drmgr [ -R script_install_root_directory ]

drmgr [ -S syslog_ID ]

drmgr [ -l ]

Description

DLPAR scripts are provided by system administrators and vendors to coordinate the consumption of resources (for example, specific processors and large amounts of pinned memory) by applications and middleware with the addition or removal of those resources with respect to the operating system. DLPAR scripts are run both before and after DLPAR operations. DLPAR scripts are provided so that applications can be cleanly quiesced and restarted.

Note: The specified action flags cannot be combined. That is, a user cannot combine -R and -S flags, -l and -R flags, and so on.

Flags

Flag Description
-c Specifies the type of resource that is to be dynamically configured.
-b Rebuilds the scripts' information file that is managed by the drmgr command. In general, this option must be used only when restoring scripts from another systems.
-D hostname Specifies the hostname of the system on which the script can be started.
-f Forces the replacement of an existing script.
-i script_name Installs the script_name script. The script_name must have complete path. If the path is not specified, the current directory is assumed. If any name conflicts, the drmgr command issues a warning and does not install the script. Any existing script can be overwritten by specifying the -f flag.
-l Displays the details on the DLPAR scripts that are currently installed.
-r Removes the resource dynamically.
-R base_script_directory Changes the base script installation directory.
-S syslog_ID Logs syslog messages with the specified syslog ID string. This ID string is appended to every entry logged in syslog by the drmgr command.
-u script_name Uninstalls a DLPAR script. If the script was installed with the -D option, the same parameter must be used to uninstall it. If no directory is specified, the drmgr command removes the DLPAR script from "all" installation directory.
-w minutes Overrides the time limit value specified by the vendor for the script. The script is stopped if it exceeds the specified time limit.

Exit Status

0
Successfully completed the requested operation.
>0
The command failed. The cause of failure can be:
  • File or directory does not exist.
  • The length of the parameter exceeds the system limit (PATH_MAX).
  • Too many arguments were specified.
  • You do not have root authority to run this command.

Example

  1. To forcefully remove memory, enter the following command:
    drmgr -rf -c mem