Commands Reference, Volume 2

drmgr Command

Purpose

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

Syntax

drmgr { -iscript_name [-w minutes ] [ -f ] | -u script_name } [ -Dhostname ]

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/or middleware with the addition or removal of those resources with respect to the operating system. DLPAR scripts are invoked both before and after DLPAR operations. DLPAR scripts are provided so that applications can be cleanly quiesed and restarted.

When installing scripts, the drmgr copies the script to a private repository. The default location, of which is /usr/lib/dr/scripts/all. The user may specify an alternate location for this repository through the -R base_script_directory option. In addition, a user may also install scripts to be executed only on selected host machines by specifying the -D hostname option. The hostname parameter serves as an extension to the base path and is compared to the current hostname using the 'uname -n' command. If the -D parameter is used to install a script, then it has to be used to uninstall it.

Note that the various action flags specified above cannot be combined. That is, a user cannot combine -R and -S flags, -l and -R flags and so on.

Flags

-b	This option will rebuild the scripts information file managed by drmgr. In general, this option should only be used when restoring scripts from another systems.
-D hostname	This flag specifies the hostname of the machine on which the script can be invoked.
-f	Forces the replacement of an existing script.
-i script_name	This flag is used to install a script. The script_name is the script to be installed with complete path. If the path is not specified, the current directory is assumed. In case of any name conflicts, drmgr will issue a warning and will not install the script. Any existing script can be overwritten by specifying -f flag.
-l	This option will display the details regarding the DLPAR scripts that are currently installed.
-R base_script_directory	This option can be used to change the base script install directory.
-S syslog_ID	This ID string will be used as the syslog ID string while logging the syslog messages. Note that this ID string is appended to every entry logged in syslog by drmgr.
-u script_name	Uninstalls a DLPAR script. If the script was installed with the -D option, then the same parameter should be used to uninstall it. If no directory is specified, drmgr will try to remove the DLPAR script from "all" install directory.
-w minutes	Overrides the time limit value specified by the vendor for the script. The script will be aborted if it exceeds the specified time limit.

Exit Status

0

Successfully completed the requested operation

>0

The command failed. The cause of failure may be one of the following:

File/Directory does not exist.
The length of the parameter exceeds the system limit (PATH_MAX).
Too many arguments were specified.
You must have root authority to run this command.

Related Information

Dynamic Logical Partitioning in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.