Use > Server Automation > Global Shell utilities syntax

Global Shell utilities syntax

Global Shell operations (permissions)

The actions that an SA user can perform within the Global Shell are determined by the operations specified by the aaa utility. Most of these operations, such as readServerFilesystem, can be granted on both managed servers and on a login basis. The login is the user name on the managed server, such as the Administrator user on Windows or root on UNIX.

A login is not specific to a particular platform (operating system). For example, if the permissions specify that a user can read the file system as root, then root will appear under the files subdirectory, regardless of the platform. The Server Explorer of the SA Client displays the login names that you have been authorized to access that server's file system.

The operations are listed in the /opsw/Permissions directory of the OGFS.

The following table identifies and describes the server operations in Global Shell. In the table, the On Server column identifies which operations can be granted for a set of managed servers, and the On Login column identifies the operations that can be granted for specific logins (users).

Global Shell operations

Operation
(Permission)

Description

On Server

On Login

launchGlobalShell

Launches the Global Shell.

No

No

loginToServer

Opens a shell session on a UNIX server. In the SA Client, this is the Remote Terminal feature that opens a terminal window for a UNIX server.

Yes

Yes

readServerComplus

Reads COM Plus objects as a specific login. In the SA Client, use the Server Explorer to browse these objects on a Windows server.

Yes

Yes

readServerFilesystem

Reads a managed server as a specific login. In the SA Client, use the Server Explorer to browse the file system of a managed server.

Yes

Yes

readServerMetabase

Reads IIS Metabase objects as a specific login. In the SA Client, use the Server Explorer to browse these objects on a Windows server.

Yes

Yes

readServerRegistry

Reads registry files as a specific login. In the SA Client, use the Server Explorer to view the Windows Registry.

Yes

Yes

relayRdpToServer

Opens an RDP session on a Windows server. In the SA Client, this is the Remote Terminal feature that opens an RDP client window for a Windows server.

Yes

No

runCommandOnServer

Runs a command or script on a
managed server using a rosh
operation, where that command or script already exist. In the SA Client, this is used for Windows Services when you use the Server Explorer.

Yes

Yes

runTrustedOnServer

Only for internal use by Server Automation. Do not use this operation. Server Automation uses this operation for scripts in /opsw/Script/Shared, which implement certain Server Automation features. These scripts are provided with Server Automation and cannot be created or modified by users.

Yes

Yes

writeServerFilesystem

Modifies files on a managed server as a specific login. In the SA Client, use the Server Explorer to modify the file system of a managed server.

Yes

Yes

Send Help Center feedback