advertisement
21
Remote Tasks — Reference
From Remote Tasks you can:
• Run commands on local and remote systems, batch files and executable files on the local systems, and schedule local and remote tasks.
• Change power status for a system.
• Deploy OpenManage Server Administrator on systems.
• Deploy iDRAC Service Module (iSM) on systems.
• Collect firmware and driver inventory.
• View the remote tasks.
Remote Tasks:
• Common Tasks
– Create Command Line Task
– Create Deployment Task
– Create Power Task
– Create F/W & Driver Inventory Task
• Remote Tasks
– Server Power Options
– Deploy Server Administrator
– Command Line
• F/W & Driver Inventory Task
Related Links
Managing RACADM Command Line Tasks
Deploying Server Administrator
Collecting Firmware and Driver Inventory
Working With Sample Remote Tasks Use Cases
Using the Sample - Server XML Configuration Command Line Task
Deploying iDRAC Service Module
249
Remote Tasks Home
To view Remote Tasks page, in OpenManage Essentials, click Manage → Remote Tasks.
Related Links
Managing RACADM Command Line Tasks
Deploying Server Administrator
Collecting Firmware and Driver Inventory
Working With Sample Remote Tasks Use Cases
Using the Sample - Server XML Configuration Command Line Task
Deploying iDRAC Service Module
Remote Tasks
Remote Tasks page lists the following information:
• All Tasks
• Server Power Options
• Server Administrator Deployment
• Command Line
• Firmware & Driver Inventory
Related Links
Managing RACADM Command Line Tasks
Deploying Server Administrator
Collecting Firmware and Driver Inventory
Working With Sample Remote Tasks Use Cases
Using the Sample - Server XML Configuration Command Line Task
Deploying iDRAC Service Module
All Tasks
Field
Scheduled State
Description
Displays if the task is enabled.
Task Name Names of the task.
250
Field
Task Label
Last Run
Created On
Updated On
Updated By
Description
Type of task that is run, for example; for a command line task the options displayed are
Remote Server Administrator Command, Generic
Command, IPMI Command, and RACADM
Command Line.
The last time and date information when the task was run.
The time and date on which the task was created.
The time and date information when the task was run.
The name of the user.
Related Links
Managing RACADM Command Line Tasks
Deploying Server Administrator
Collecting Firmware and Driver Inventory
Working With Sample Remote Tasks Use Cases
Using the Sample - Server XML Configuration Command Line Task
Deploying iDRAC Service Module
Task Execution History
Lists the details of the system update tasks or remote tasks.
Field
Status
Description
Displays an icon representing the task status:
— Running or pending
— Completed
— Stopped
— Failed
Task Name
— Warning
The name of the task.
251
Field
Start Time
% Completed
Task State
Successful / Attempted Targets
End Time
Executed by User
Description
Time and date at which the system update task started.
The task’s progress information.
Provides these task states:
• Running
• Completed
• Stopped
• Failed
• Warning
NOTE: The task status displays warning if the
After update if required, reboot the device option was not selected for the system update task.
The number of target systems on which the task is successfully executed.
Time and date at which the system update task ends.
The user information.
Server Power Options
Select this option to change the power state or restart systems.
Description Field
General
Task Name
Select the type
Provide a name for this server power options task.
Select from the following options:
• Reboot — Restarts the system without powering off.
• Power Cycle — Powers off and then restarts the system.
NOTE: Make sure that the shutdown option is configured for the operating system before you perform a graceful shutdown using this option. If you use this option without configuring it on the operating system, it restarts the managed system instead of performing a shutdown operation.
• Power Off — Powers off the system.
252
Field
Shutdown OS first
Task Target
Select a query
Select the device(s) for this task to target
Enable All
Schedule and Credentials
Set schedule
Enter User Name and Password
Description
• Power On — Powers on the system. This option works only on target systems that contain RAC.
Select to shut down the operating system before executing the server power options task.
Select a query from the drop-down list. To create a new query, click New.
Select the devices to which you want to assign this task.
Select to override the device capability and allow all the available devices for selection as task targets.
Select from these options:
• Activate Schedule—Select this option to activate a schedule for the task.
• Run now—Select this option to run the task immediately.
• Set schedule—Select this option to set a date and time for the task to run.
• Run Once—Select this option tot run the task on the planned schedule only once.
• Periodic—Select this option to run the task frequently at specified intervals:
– Hourly—Select this option to run the task once every hour.
– Daily—To run the task once every day.
– Weekly—To run the task once every week.
– Monthly—To run the task once every month.
Range of Recurrence:
• Start—To specify the date and time at which the task should begin.
• No End Date—To continuously run this task based on the selected frequency. For example, if you selected Hourly, then this task continuously runs every hour from the start time.
• End By—To stop the task at the specified date and time.
User Name—Provide in the format domain\user name or local host\user name.
253
Field Description
Password—Provide the password.
Power On works only on target systems with iDRAC; use the IPMI credentials to perform Power
On task.
If you selected Power On, then provide the KG key.
KG Key—Enter the KG Key. DRAC also supports
IPMI KG Key. Each BMC is configured to require an access key in addition to user credentials. The KG key is prompted only for power-on task and not other power tasks because it is an IPMI task.
NOTE: The KG key is a public key that is used to generate an encryption key for use between the firmware and the application; and is available only on Dell PowerEdge 9G and later systems. The KG key value is an even number of hexadecimal characters. In the format, yxxx, y denotes alphanumeric characters and x denotes numbers.
Related Links
Deployment Task
Select this option to create tasks to deploy either Server Administrator or iDRAC Service Module (iSM) on selected servers.
Description Field
General
Deployment Type
Task Name
Select the type
Installer Path
Select the type of deployment from the following options:
• Server Administrator
• iDRAC Service Module
Provide a name for the task.
Select from the target type from the following options:
• Windows
• Linux
The location where the Server Administrator or iSM installer is available.
254
Field
Install Arguments
NOTE: Applicable only for Server
Administrator deployment task.
Generate Trusted Key
64-bit System
Allow reboot (if required)
Description
For Windows, packages with .dup, .msi, and .msp. file extensions are available. Msi packages enable
Server Administrator installation and upgrades while dup and msp packages enable only Server
Administrator upgrades.
• For Server Administrator deployment on Linux:
– Packages with the tar.gz file extensions are available.
– The.sign file is required for verification.
The .sign file must be available in the same folder as the tar.gz file.
• For iSM deployment on Linux:
– Packages with the tar.gz, .rpm and .bin file extensions are available.
– For deploying the .rpm file, the RPM-GPG-
KEY file must be available in the same folder as the .rpm file.
(Optional) Provide arguments.
For example, in Windows, the parameters are as follows:
• ADDLOCAL = IWS—Server Administrator web server only
• ADDLOCAL = SSA—Server instrumentation only
For example, in Linux, the parameters are as follows:
• -w - Server administrator web server only
• -d - Server instrumentation only
See the Dell OpenManage Installation and Security
User's Guide at dell.com/support/manuals for a complete list of arguments.
This option is available if you selected Linux. Select this option to generate a trusted key.
Select this option if you are deploying the 64-bit version of Server Administrator on a managed node.
Select this option to restart the server once you deploy Server Administrator on the server.
Upload and Install GPG key (requires GPG key in same folder)
This option is available if you select a .rpm file for iSM deployment. Select this option to validate the .rpm file on the target device.
255
Field
NOTE: Applicable only for iSM deployment task.
Task Target
Select a query
Description
Select server(s) for this task to target
Enable all
NOTE: Applicable only for iSM deployment task.
Schedule and Credentials
Set schedule
Select a query from the drop-down list. To create a new query, click New.
Select the severs to which you want to assign this task.
Select to override the device capability and display all the available devices for selection as task targets.
Select from these options:
• Activate Schedule — Select this option to activate a schedule for the task.
• Run now — Select this option to run the task immediately.
• Set schedule — Select this option to set a date and time for the task to run.
Enter credentials of remote target(s)
User Name
Password
Enable Sudo
SSH Port
Provide in the format domain\user name or local host\user name.
Provide the password.
Select this option to deploy Server Administrator or iSM using Sudo.
Provide the SSH port number.
Related Links
Deploying Server Administrator
Command Line Task
Select this option to create command line tasks.
256
Field
Task Name
Remote Server Administrator Command
Description
Provide name of the task.
Select this option to run Remote Server
Administrator Command on selected servers.
Select this option to run executable and commands on the system with OpenManage
Essentials.
Select this option to run IPMI commands on selected servers.
Select this option to run RACADM commands on selected servers.
Related Links
Managing RACADM Command Line Tasks
Deploying Server Administrator
Collecting Firmware and Driver Inventory
Working With Sample Remote Tasks Use Cases
Using the Sample - Server XML Configuration Command Line Task
Deploying iDRAC Service Module
Remote Server Administrator Command
Remote Server Administrator Command
Field
Command
Description
Provide command, for example, omereport system summary.
Ping Device
Output to file
This option performs a ping test to verify if a device is reachable before it runs a task against it.
This option can be used when using $IP or
$RAC_IP and it decreases the time it takes to run the task(s) as it skips unreachable devices.
Select to enable output to a log file. This option captures standard output and writes it to the log file. If you select this option, enter the path name and file name of the log file. This option is disabled by default.
257
Field
Append
Include errors
SSH Port number
Generate Trusted Key for Linux
Task Target
Select a query
Select the server(s) for this task target
Enable All
Schedule and Credentials
Set schedule
Description
Select to append output from the completed command to the specified file. If the file does not exist, it is created.
Select to write all OpenManage Essentialsdetected errors to the log file. For example, if no response is received to a ping request before the execution of the command, an error is written to the log file.
Provide the Secure Shell (SSH) port number on the managed Linux system. The default value for the port number is 22.
Select this option to generate a trusted device key for communicating with devices. This option is disabled by default.
NOTE: The first time that OpenManage
Essentials communicates with a managed device with Linux operating system, a key is generated and stored on both the devices.
This key is generated per device and enables a trust relationship with the managed device.
Select a query from the drop-down list. To create a new query, click New.
Select the severs to which you want to assign this task.
Select to override the device capability and allow all the available devices for selection as task targets.
Select from these options:
• Activate Schedule—Select this option to activate a schedule for the task.
• Run now—Select this option to run the task immediately.
• Set schedule—Select this option to set a date and time for the task to run.
• Run Once—Select this option to run the task on the planned schedule only once.
• Periodic—Select this option to run the task frequently at specified intervals.
– Hourly—Select this option to run the task once every hour.
258
Field
Enter credentials of the remote target(s)
Description
– Daily—To run the task once every day.
– Weekly—To run the task once every week.
– Monthly—To run the task once every month.
Range of Recurrence:
• Start—To specify the date and time at which the task should begin.
• No End Date—To continuously run this task based on the selected frequency. For example, if you selected Hourly, then this task continuously runs every hour from the start time.
• End By—To stop the task at the specified date and time.
User Name—Provide in the format domain\user name or local host\user name.
Password—Provide the password.
Related Links
Using the Sample - Server XML Configuration Command Line Task
Generic Command
Field
Task Name
Description
Enter a name for the task. By default, the task name is populated in the format:
<task name>-<date and time>.
Command
Arguments
Provide the fully qualified path name and file name of the executable, command, or script file that launches the application program. For example:
• Tracert
• C:\scripts\trace.bat
• D:\exe\recite.exe
Enter command line switches to a command or executable or pass values to a script or batch file.
For example, -4 $IP. If this argument is passed to tracert command, it executes IPV4 only Traceroute against the IPs of servers selected in Task Target tab. The command run would be tracert -4
10.35.0.55 .
For more information, see About Tokens .
259
Field
Ping Device
Output to file
Append
Include errors
Schedule and Credentials
Set schedule
Description
This option performs a ping test to verify if a device is reachable before it runs a task against it.
This option can be used when using $IP or
$RAC_IP and it decreases the time it takes to run the task(s) as it skips unreachable devices.
Select to enable output to a log file. This option captures standard output from the running application and writes it to the log file. If you select this option, you must enter the path name and file name of the log file. This option is disabled by default.
Select this option to continue writing to the same file if you run a task multiple times.
Select to write all OpenManage Essentialsdetected errors to the log file. For example, if no response is received to a ping request before the execution of the command, an error is written to the log file.
Select from these options:
• Activate Schedule—Select this option to activate a schedule for the task.
• Run now—Select this option to run the task immediately.
• Set schedule—Select this option to set a date and time for the task to run.
• Run Once—Select this option to run the task on the planned schedule only once.
• Periodic—Select this option to run the task frequently at specified intervals.
– Hourly—Select this option to run the task once every hour.
– Daily—To run the task once every day.
– Weekly—To run the task once every week.
– Monthly—To run the task once every month.
Range of Recurrence:
• Start—To specify the date and time at which the task should begin.
• No End Date—To continuously run this task based on the selected frequency. For example, if you selected Hourly, then this task continuously runs every hour from the start time.
• End By—To stop the task at the specified date and time.
260
Field
Enter the credentials with appropriate privileges to run this task on this system
Description
User Name—Provide OpenManage Essentials user credentials in the format domain\user name or local host\user name.
Password—Provide the password.
Related Links
Using the Sample - Server XML Configuration Command Line Task
IPMI Command
Field
Command
Description
Provide the IPMI command you want to run on selected targets.
Ping Device
Output to file
Append
Include errors
This option performs a ping test to verify if a device is reachable before it runs a task against it. This option can be used when using $IP or $RAC_IP and it decreases the time it takes to run the task(s) as it skips unreachable devices.
Select to enable output to a log file. This option captures standard output from the running application and writes it to the log file. If you select this option, enter the path name and file name of the log file. This option is disabled by default.
Select to append output from the completed command to the specified file. If the file does not exist, it is created.
Select to write all OpenManage Essentials-detected errors to the log file. For example, if no response is received to a ping request before the execution of the command, an error is written to the log file.
Task Target
Select a query
Select server(s) for this task to target
Select a query from the drop-down list. To create a new query, click New.
Select the severs to which you want to assign this task.
Enable All Select to override the device capability and allow all the available devices for selection as task targets.
Schedule and Credentials
261
Field
Set schedule
Description
Select from these options:
• Activate Schedule—Select this option to activate a schedule for the task.
• Run now—Select this option to run the task immediately.
• Set schedule—Select this option to set a date and time for the task to run.
• Run Once—Select this option to run the task on the planned schedule only once.
• Periodic—Select this option to run the task frequently at specified intervals.
– Hourly—Select this option to run the task once every hour.
– Daily—To run the task once every day.
Weekly—To run the task once every week.
– Monthly—To run the task once every month.
Range of Recurrence:
• Start—To specify the date and time at which the task should begin.
• No End Date—To continuously run this task based on the selected frequency. For example, if you selected Hourly, then this task continuously runs every hour from the start time.
• End By—To stop the task at the specified date and time.
Enter Remote Access Controller credentials for target(s)
User Name
Password
KG key
The RACADM task requires IPMI credentials.
Provide IPMI credentials to run the task.
Provide the password.
Enter the KG key value. DRAC also supports IPMI
KG key value. Each BMC or DRAC is configured to require an access key in addition to user credentials.
NOTE: The KG key is a public key that is used to generate an encryption key for use between the firmware and the application. The KG key value is an even number of hexadecimal characters.
Related Links
Using the Sample - Server XML Configuration Command Line Task
262
RACADM Command Line
Field
Command
Ping Device
Output to file
Append
Include errors
Task Target
Select a query
Select the server(s) for this task to target
Enable All
Schedule and Credentials
Set schedule
Description
Provide the RACADM command you want to run on the servers.
This option performs a ping test to verify if a device is reachable before it runs a task against it.
This option can be used when using $IP or
$RAC_IP and it decreases the time it takes to run the task(s) as it skips unreachable devices.
Select to enable output to a log file. This option captures standard output from the running application and writes it to the log file. If you select this option, you must enter the path name and file name of the log file. This option is disabled by default.
Select to append output from the completed command to the specified file. If the file does not exist, it is created.
Select to write all OpenManage Essentialsdetected errors to the log file. For example, if no response is received to a ping request before the execution of the command, an error is written to the log file.
Select a query from the drop-down list. To create a new query, click New.
Select the severs to which you want to assign this task.
Select to override the device capability and allow all the available devices for selection as task targets.
Select from these options:
• Activate Schedule—Select this option to activate a schedule for the task.
• Run now—Select this option to run the task immediately.
• Set schedule—Select this option to set a date and time for the task to run.
• Run Once—Select this option to run the task on the planned schedule only once.
263
Field
Enter Remote Access Controller credentials for target(s)
Description
• Periodic—Select this option to run the task frequently at specified intervals.
– Hourly—Select this option to run the task once every hour.
– Daily—To run the task once every day.
– Weekly—To run the task once every week.
– Monthly—To run the task once every month.
Range of Recurrence:
• Start—To specify the date and time at which the task should begin.
• No End Date—To continuously run this task based on the selected frequency. For example, if you selected Hourly, then this task continuously runs every hour from the start time.
• End By—To stop the task at the specified date and time.
User Name—The RACADM task requires IPMI credentials. Provide IPMI credentials to run the task.
Password—Provide the password.
Related Links
Using the Sample - Server XML Configuration Command Line Task
Firmware and Driver Inventory Collection Task
Select this option to collect firmware and driver inventory information from a server that does not have
Dell OpenManage Server Administrator installed.
Description Field
General
Task Name
Filter devices based on operating system
Select the Operating System
Provide a name for the inventory collection task.
Select to filter devices to be displayed in the Task
Target based on the selected operating system.
Select from the following options:
• Windows
• Linux
264
Field
64–bit System
Task Target
Select a query
Select the servers(s) for this task to target
Schedule and Credentials
Set schedule
Enter credentials of the remote targets
Description
Select this option if the target server is running a
64-bit operating system.
Select a query from the drop-down list. To create a new query, click New.
Select the servers you want to assign the task.
Select from these options:
• Activate Schedule — Select this option to activate a schedule for the task.
• Run now — Select this option to run the task immediately.
• Set schedule — Select this option to set a date and time to run the task.
• Run Once — Select this option tot run the task on the planned schedule only once.
• Periodic — Select this option to run the task frequently at specified intervals:
– Hourly — Select this option to run the task once every hour.
– Daily — Select this option to run the task once every day.
– Weekly — Select this option to run the task once every week.
– Monthly — Select this option to run the task once every month.
Range of Recurrence:
• Start — To specify the date and time at which the task should begin.
• No End Date — To continuously run this task based on the selected frequency. For example, if you selected Hourly, then this task continuously runs every hour from the start time.
• End By — To stop the task at the specified date and time.
User Name — Provide in the format domain\user name or local host\user name.
Password — Provide the password.
Related Links
Collecting Firmware and Driver Inventory
265
advertisement