Manuals

remote Commands : Dell Command Line Interface Reference Back to Contents Page

remote Commands

The CLI supports remote management by allowing you to locate and open a controller on another computer. Managing a controller that is opened remotely is essentially the same as managing one that is opened locally.

The remote commands only work if the FAST Remote Management Services Agent (network services software) is running on the system you want to configure. The FAST Remote Management Services Agent is part of the storage management software that comes with the controller product. In addition, the remote commands and any associated switches are supported only on Windows NT.

Specifically, this chapter discusses the remote commands listed in Table 1.

Table 1. remote Commands

Command Summary Description

remote add Adds a computer's connection information to the network connection database

remote delete Deletes a computer's connection information from the network connection database

remote list Displays a list of all remote computers

remote lock Locks a computer's connection information in the network connection database

remote scan Updates the network connection database

remote unlock Unlocks a computer's connection information in the network connection database

remote users Displays a list of users who are accessing remote controllers

Use the following syntax for remote commands:

remote command [object][/switch{=value}[parameter]

Some of the commands discussed in this chapter allow you to specify a computer name. The format for specifying the computer name depends on whether you are also supplying a controller name. For example, the following commands do not require the \\ as part of the computer name because no controller name is specified:

AFA0> remote delete bulldog

AFA0> remote lock bulldog

The following command requires the \\ as part of the computer name because a controller name is specified:

AFA0> remote users \\bulldog\afa0

When managing remote controllers, you use your current login information. This means the controller you are managing must reside in a domain that recognizes your login information.

remote add

To add a computer's connection information to the network connection database, use the remote add command. The network connection database contains connection information for remote computers that are running the FAST Remote Management Services Agent (network services software).

Note that the CLI automatically locks connection information for computers added to the network connection database by the remote add command. This action prevents the remote scan command from removing manually added computers.

Command Availability

This command is supported only on Windows NT.

Syntax

remote add {string} {string}

Parameters

{string}

Specifies the network address for the computer. The format of the address depends on the network protocol you specify in the second {string}. Table 2 gives examples of valid network address values according to the different network protocols.

Table 2. Network Address Values According to Network Protocol

Network Protocol Valid Network Address Values

TCP/IP A four-octet internet address, for example: 128.10.2.30 A host name, for example: bulldog.safekennel.com A computer name (only if you properly configure WINS or DNS on the network and the computer name is part of the local domain), for example: myserver

SPX A fully formed IPX address, for example: ~0000000108002B30612C A Windows NT server name, for example: myserver

NETBEUI A Windows NT server name, for example: \\myserver

{string}

Specifies the network protocol. You can specify one of the valid strings listed in Table 3.

Table 3. Network Protocol Values.

Network Protocl Value Meaning

TCPIP Specifies the TCP/IP protocol.

SPX Specifies the SPX or IPX protocol (for Novell networks).

NETBEUI Specifies the NETBEUI protocol (for Microsoft networks).

Examples

Before adding a computer's connection information to the network connection database, it is useful to invoke the remote list command, as in the following example:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote  Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      L         \\\TIGERNET\\SUPREME

The following examples add the connection information for the computers called JAWS and WEREWOLF to the network connection database:

 AFA0> remote add werewolf.mgm.movies.com TCPIP
 Executing: remote add "werewolf.mgm.movies.com" "TCPIP"

Use the remote list command after using the remote add command to ensure that the computer appears in the list (that is, the connection information for the computer now exists in the network connection database), as in the following example. Note that WEREWOLF and JAWS now appear in the list:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF

Related Information

remote Commands:

remote delete (remote delete)
remote list (remote list)
remote scan (remote scan)

remote delete

To delete a computer's or a NetWare server's connection information from the network connection database, use the remote delete command. The network connection database contains connection information for remote computers that are running the FAST Remote Management Services Agent (network services software). The command deletes the connection information for the remote computer or NetWare server even if it is locked.

Command Availability

This command is supported only on Windows NT.

Syntax

remote delete [/domain{=string}] [/netware{=boolean}] {string}

Parameters

{string}

Specifies the name of the computer or NetWare server whose connection information you want to delete from the network connection database.

Switches

/domain{=string}

Specifies the Windows domain in which the computer specified in {string} resides.

This switch defaults to the local Windows domain (the one you are logged on to) if you do not specify this switch (that is, the command assumes the specified computer resides in the local Windows domain).

This switch is supported only on Windows NT.

/netware{=boolean}

Specifies whether to delete a NetWare server's connection information from the network connection database. If you set this switch to TRUE, the command deletes the connection information for the NetWare server you specified in {string}.

This switch defaults to FALSE, which means the command does not delete a NetWare server's connection information from the network connection database.

If you specify both the /domain and /netware switches, the command displays an appropriate error message.

This switch is supported only on Windows NT.

Examples

Before deleting a computer's connection information from the network connection database, it is useful to invoke the remote list command, as in the following example:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF

The following example deletes the connection information for the computer called WEREWOLF from the network connection database. The command assumes the local domain (in this example, the local domain is tigernet):

 AFA0> remote delete \\werewolf
 Executing: remote delete "\\werewolf"

The following example deletes the connection information for the computer called JAWS from the network connection database. This example specifies the tigernet domain:

 AFA0> remote delete /domain=tigernet jaws
 Executing: remote delete /domain="tigernet" "jaws"

Use the remote list command after using the remote delete command to ensure that the computer no longer appears in the list (that is, the connection information for the computer no longer exists in the network connection database), as in the following example. Note that WEREWOLF and JAWS no longer appear in the list:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      L         \\\TIGERNET\\SUPREME

Related Information

remote Commands:

remote add (remote add)
remote list (remote list)
remote scan (remote scan)

remote list

To display a list of all remote computers that are running the FAST Remote Management Services Agent (network services software), use the remote list command.

You might want to use the remote scan command prior to the remote list command to ensure that the CLI has placed connection information for all remote computers that can run the FAST Remote Management Services Agent in the network connection database.

Command Availability

This command is supported only on Windows NT.

Syntax

remote list [/netware{=boolean}] [{string}]

Parameters

{string}

Specifies the Windows domain to search for computers that can run the FAST Remote Management Services Agent. If you do not specify this parameter, the command searches only the local Windows domain (the one you are logged on to).

If you specify a Windows domain (by entering a valid string) and the /netware switch (by entering the value TRUE), the command returns an error.

Switches

/netware{=boolean}

Specifies whether to display a list of known NetWare servers that reside in the NetWare domain (instead of the Windows NT domain). If you set this switch to TRUE, the command displays only the known Netware servers. If you use this switch, the system can take significantly longer to display the list than if the default setting is used.

This switch defaults to FALSE, which means the command does not display a list of known NetWare servers.

If you specify a Windows domain (by entering a valid string) and the /netware switch (by entering the value TRUE), the command returns an error.

This switch is supported only on Windows NT.

Examples

The following example displays a list of remote computers that can run the FAST Remote Management Services Agent (and that have connection information in the network connection database). The example also uses the remote scan command prior to the remote list command.

 AFA0> remote scan
 Executing: remote scan
 
 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\COLUMBO
      U         \\\TIGERNET\\GOR
      L         \\\TIGERNET\\SHAFT
      U         \\\TIGERNET\\THE TULIP
      U         \\\TIGERNET\\THEFLY
      U         \\\TIGERNET\\YETI

The following example displays a list of remote computers that can run the FAST Remote Management Services Agent and that are currently available to use for controller operations:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\SUPREME

The remote list command displays two columns of information:

The Lock Status column

This column displays an L (the computer's connection information is locked in the network connection database ) or a U (the computer's connection information is unlocked in the network connection database).
The Computer column

This column displays the domain and the computer name for each computer whose associated connection information resides in the network connection database.

Related Information

remote Commands:

remote lock (remote lock)
remote scan (remote scan)
remote unlock (remote unlock)

remote lock

To lock a computer's or NetWare server's connection information in the network connection database, use the remote lock command. The network connection database contains connection information for remote computers that are running the FAST Remote Management Services Agent (network services software). The lock operation prevents the remote scan command from deleting the computer's connection information from the network connection database.

Command Availability

This command is supported only on Windows NT.

Syntax

remote lock [/domain{=string}] [/netware{=boolean}] {string}

Parameters

{string}

Specifies the name of the computer or NetWare server to lock.

Switches

/domain{=string}

Specifies the Windows domain in which the computer specified in {string} resides.

This switch defaults to the local Windows domain (the one you are logged on to) if you do not specify this switch (that is, the command searches only the local Windows domain).

This switch is supported only on Windows NT.

/netware{=boolean}

Specifies whether to lock a NetWare server record in the network connection database. If you set this switch to TRUE, the command locks the record for the NetWare server you specified in {string}.

This switch defaults to FALSE, which means the command does not lock a NetWare server record in the network connection database.

If you specify both the /domain and /netware switches, the command displays an appropriate error message.

This switch is supported only on Windows NT.

Examples

Before locking a computer's connection information in the network connection database, it is useful to invoke the remote list command, as in the following example:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF

The following example locks the computer called GOR:

 AFA0> remote lock \\gor
 Executing: remote lock "\\gor"

Use the remote list command after using the remote lock command to ensure that the computer is locked (that is, the connection information for the computer is now locked in the network connection database), as in the following example. Note that GOR now appears in the list with an L (instead of a U) in the Lock Status column:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      L         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF

Related Information

remote Commands:

remote list (remote list)
remote scan (remote scan)
remote unlock (remote unlock)

remote scan

To search a domain for computers running the FAST Remote Management Services Agent (network services software), use the remote scan command. The command places in the network connection database a record for each computer found to be running the FAST Remote Management Services Agent.

The command also checks the records for computers currently in the network connection database to determine if these computers are still running the FAST Remote Management Services Agent. If not, the command removes the record from the network connection database. If you previously locked a computer with the remote lock command, however, the remote scan command does not remove the record from the network connection database even if the associated computer is not currently running the FAST Remote Management Services Agent.

Command Availability

This command is supported only on Windows NT.

Syntax

remote scan [{string}]

Parameters

{string}

Specifies the name of the domain you want to scan. If you do not specify a domain name, the command assumes the local domain.

Examples

The following example scans the domain called tigernet:

 AFA0>  remote scan tigernet
 Executing: remote scan "tigernet"

The following example scans the local domain:

 AFA0>  remote scan
 Executing: remote scan

Related Information

remote Commands:

remote list (remote list)
remote lock (remote lock)
remote unlock (remote unlock)

remote unlock

To unlock a computer's or NetWare server's connection information in the network connection database, use the remote unlock command. The network connection database contains connection information for remote computers that are running the FAST Remote Management Services Agent (network services software). This unlocking operation allows the remote scan command to delete the computer's connection information from the network connection database.

Command Availability

This command is supported only on Windows NT.

Syntax

remote unlock [/domain{=string}] [/netware{=boolean}] {string}

Parameters

{string}

Specifies the name of the computer or NetWare server whose associated connection information you want to unlock.

Switches

/domain{=string}

Specifies the domain in which the computer specified in {string} resides.

This switch defaults to the local domain (the one you are logged on to) if you do not specify this switch (that is, the command searches only the local domain).

This switch is supported only on Windows NT.

/netware{=boolean}

Specifies whether to unlock a NetWare server record in the network connection database. If you set this switch to TRUE, the command unlocks the record for the NetWare server you specified in {string}.

This switch defaults to FALSE, which means the command does not unlock a NetWare server record in the network connection database.

If you specify both the /domain and /netware switches, the command displays an appropriate error message.

This switch is supported only on Windows NT.

Examples

Before unlocking a computer's connection information in the network connection database, it is useful to invoke the remote list command, as in the following example:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      L         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF

The following example unlocks the computer called GOR:

 AFA0> remote unlock \\gor
 Executing: remote unlock "\\gor"

Use the remote list command after using the remote unlock command to ensure that the computer is unlocked (that is, the connection information for the computer is now unlocked in the network connection database), as in the following example. Note that GOR now appears in the list with a U (instead of an L) in the Lock Status column:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      L         \\\TIGERNET\\YETI
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF

Related Information

remote Commands:

remote list (remote list)
remote lock (remote lock)
remote scan (remote scan)

remote users

To display a list of users who are accessing controllers on a remote computer, use the remote users command. The display indicates what mode (read-write or read-only) the user is accessing the controller.

Command Availability

This command is supported only on Windows NT.

Syntax

remote users [/domain{=string}] {string}

Parameters

{string}

Specifies the name of the computer and associated controller for which you want to display a list of users.

If you do not specify a computer name, the command assumes the local computer. You must, however, specify the controller name. Otherwise, the command fails to display the user list.

Switches

/domain{=string}

Specifies the domain to search for users who are accessing controllers on the specified computer that resides in this domain.

This switch defaults to the local domain (the one you are logged on to) if you do not specify this switch (that is, the command searches only the local domain).

This switch is supported only on Windows NT.

Examples

Before displaying a list of users accessing controllers on computers, it is useful to invoke the remote list command, as in the following example:

 AFA0> remote list tigernet
 Executing: remote list "tigernet"
 
 The following hosts are offering Remote Services.
 Lock Status    Computer
 ------------ --------------------------
      U         \\\TIGERNET\\GOR
      U         \\\TIGERNET\\KINGKONG
      L         \\\TIGERNET\\OAK
      U         \\\TIGERNET\\REVATHY
      U         \\\TIGERNET\\SHAFT
      U         \\\TIGERNET\\BULLDOG
      U         \\\TIGERNET\\GOLIATH
      U         \\\TIGERNET\\JAWS
      L         \\\TIGERNET\\SUPREME
      U         \\\TIGERNET\\WEREWOLF
      U         \\\TIGERNET\\YETI

The following example displays a list of users accessing the controller on the system YETI. The domain defaults to the local domain:

AFA0> remote users \\yeti\afa0

Executing: remote users "\\yeti\afa0"

mcleod@YETI read write

Note that the user in the example opened the controller for read-write operations. The command displays read write when a user opens the controller for read-write operations and read only when a user opens the controller for read-only operations.

The following example displays a list of users accessing the controller on the system SHAFT. The domain is tigernet:

AFA0> remote users /domain=tigernet \\shaft\afa0

Executing: remote users /domain="tigernet" "\\shaft\afa0"

bsharos@SHAFT read write

Related Information

remote Commands:

remote list (remote list)

Back to Contents Page