Reference Guide

376 Brocade Fabric OS Command Reference

53-1004112-02

fosExec

Executes any Fabric OS command on a specified remote domain or logical switch context or on all remote

domains or logical switches.

Synopsis fosexec --fid FID -cmd "cmd [args]"

fosexec --fid all [-force] -cmd "cmd [args]"

fosexec --domain DID -cmd "cmd [args]"

fosexec --domain all -cmd "cmd [args]"

Description Use this command to execute any Fabric OS command on a specified remote domain or logical switch context or

on all remote domains or logical switches.

The target logical switch is identified by its fabric ID (FID). When used with the --fid all option, the specified

command is executed in all logical switches.

The target remote domain is identified by its Domain ID (DID). When used with the --domain all option, the

specified command is executed in all remote domains.

The FIDs must be part of the FID permission list associated with the user account. If you execute fosexec --fid all

and you do not have permission to one or more of the logical switches (FIDs), the command prompts for

confirmation to continue with the execution of the command in the FIDs for which you do have permission. You

can override the prompt for confirmation with the -force option. Refer to userConfig help for more information on

logical switch access permissions.

Executing chassis-level commands through fosexec --fid all results in redundant output.

Use the configure command to set the Remote Fosexec feature. By default, the Remote Fosexec feature is

disabled.

Notes The --domain option can be executed only if the Remote Fosexec feature is enabled on local and remote switches.

The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric

OS Commands" and "Command Availability" for details.

Operands This command has the following operands:

-cmd "cmd [args]"

Specifies the command to be executed including command options if applicable. The entire

command string must be enclosed in double quotation marks.

--fid FID

Specifies the Fabric ID of the logical switch for which the command is executed.

--fid all

Executes the specified command in all logical switch contexts configured on the physical

switch.