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 ] | -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 |
|---|---|
| -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 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.