Administrative commands

The following table provides a brief description and administrative role for each command in the administrative command-line interface.

Command Description Roles
General
exit Ends an stscli session. Monitor, Backup, Operator, Administrator
help Displays a list of commands available in the administrative command-line interface and optionally displays the syntax or brief description of each command. Monitor, Backup, Operator, Administrator
quit Ends the stscli session. Monitor, Backup, Operator, Administrator
setoutput Sets the output format for the administrative command-line interface. Monitor, Backup, Operator, Administrator
Alerts and logs
addsnmpmgr Adds an SNMP manager to receive SNMP traps. To generate traps, you must add an SNMP manager and set the SNMP traps to be generated (using the settrapcommand). Administrator
catlog Displays the contents of the various log files maintained by the administrative server and the cluster. Monitor, Backup, Operator, Administrator
clearlog Clears the audit log and cluster log files. Because the event log is a subset of the cluster log, the event log is also cleared when you clear the cluster log. Administrator
collectdiag Collects data on all SAN File System components running in the system and saves the diagnostic results to various files on one or more specified engines. Operator, Administrator
lssnmpmgr Displays a list of SNMP managers and their attributes. Monitor, Backup, Operator, Administrator
lstrapsetting Displays a list of event types that currently generate an SNMP trap. Monitor, Backup, Operator, Administrator
rmsnmpmgr Removes an SNMP manager (recipient). Administrator
settrap Specifies whether an SNMP trap is generated and sent to all SNMP managers when a specific type of event occurs on the metadata server. Administrator
Clients
addprivclient Grants privileged access to the SAN File System global namespace to the specified clients. Administrator
lsclient Displays a list of clients that are currently being served by one or more metadata servers in the cluster. Monitor, Backup, Operator, Administrator
reportclient Displays a list of clients that have access to the specified volume or LUN. Monitor, Backup, Operator, Administrator
rmprivclient Revokes privileged access to the SAN File System global namespace from the specified clients. Administrator
Cluster
chadvclusterconfig Modifies the advanced cluster settings that require a restart when changed.
Note: This command should be used only by trained service personnel.
Administrator
chclusterconfig Modifies the cluster settings that do not require a restart when changed. Administrator
quiescecluster Changes the state of all metadata servers in the cluster to one of three quiescent states. Operator, Administrator
resumecluster Brings all metadata servers in the cluster to the online state. Operator, Administrator
startcluster Starts all metadata servers in the cluster and brings them to the full online state. Operator, Administrator
statcluster Displays status, network, workload, and configuration information about the cluster. Monitor, Backup, Operator, Administrator
stopcluster Stops all metadata servers in the cluster gracefully. Operator, Administrator
upgradecluster Verifies that all the engines in the cluster have been upgraded to the new version of the software and then initiates the cluster upgrade process. Administrator
Engines
lsengine Displays a list of storage engines and their attributes. Monitor, Backup, Operator, Administrator
restartengine Reboots one or more storage engines. Operator, Administrator
startengine Starts the CPU and operating system on one or more storage engines. Operator, Administrator
statengine Displays status information about a specific storage engine. Monitor, Backup, Operator, Administrator
stopengine Shuts down the operating system and powers off one or more storage engines. Operator, Administrator
Filesets
attachfileset Attaches an existing detached fileset to a specific point in the global namespace or moves an already attached fileset to a new attach location. Administrator
autofilesetserver Reassigns the specified filesets to be hosted by another metadata server automatically if the current metadata server goes down. Administrator
chfileset Modifies the settings of one or more filesets. Administrator
detachfileset Detaches one or more filesets from the global namespace. Administrator
lsfileset Displays a list of filesets and their attributes. Monitor, Backup, Operator, Administrator
mkfileset Creates a new fileset. Administrator
reportfilesetuse Displays the filesets usage statistics per storage pool. Monitor, Backup, Operator, Administrator
rmfileset Removes one or more empty, detached filesets and optionally the files in the filesets, including any FlashCopy® images. Administrator
setfilesetserver Reassigns an existing fileset to be hosted by a different metadata server. Administrator
statfileset Displays the transaction statistics for one or more specified filesets being served by the local metadata server. Monitor, Backup, Operator, Administrator
FlashCopy images
lsimage Displays a list of FlashCopy images in all filesets or a specified fileset. Monitor, Backup, Operator, Administrator
mkimage Creates a near-instantaneous FlashCopy image of the file layout and contents of the specified fileset and stores it in that fileset. Backup, Operator, Administrator
reverttoimage Reverts the current fileset to a specified FlashCopy image of the file layout and contents. Administrator
rmimage Deletes one or more FlashCopy images for a specific fileset. Backup, Operator, Administrator
LDAP
chldapconfig Modifies LDAP configuration settings. Administrator
statldap Display a list of LDAP settings. Monitor, Backup, Operator, Administrator
Metadata
builddrscript Converts the system-metadata disaster-recovery file, created by the mkdrfile command, into a set of recovery scripts. You then run these scripts to recreate the system metadata in the event of a disaster. Backup, Operator, Administrator
lsdrfile Displays a list of system-metadata disaster-recovery files. Monitor, Backup, Operator, Administrator
mkdrfile Creates a new system-metadata disaster-recovery dump file. Backup, Operator, Administrator
rmdrfile Deletes an existing system-metadata disaster-recovery dump file. Backup, Operator, Administrator
startmetadatacheck Starts the utility that performs a consistency check on the metadata for the entire system or a set of filesets, generates reports in the cluster log, and optionally repairs inconsistencies in the metadata. Administrator
stopmetadatacheck Stops the metadata check utility that is currently in progress. Administrator
Metadata servers
addserver Adds a metadata server on a specific engine to the cluster. Administrator
dropserver Stops and drops a metadata server on a specific engine from the cluster. Administrator
lsautorestart Displays a list of metadata servers and the automatic-restart settings for each. Monitor, Backup, Operator, Administrator
lsserver Displays a lists of all metadata servers in the cluster and their attributes if issued from the master metadata server, or displays attributes about the local metadata server if issued from a subordinate metadata server. Monitor, Backup, Operator, Administrator
setautorestart Sets the configuration parameters for the metadata server restart service. Administrator
setport Sets the port values for the metadata server. Administrator
startautorestart Enables the metadata server to restart automatically if it is down. Administrator
startserver Starts the specified metadata server. Operator, Administrator
statserver Displays status, configuration, and workload information for a specific metadata server in the cluster, if issued from the master metadata server. Lists status, configuration, and workload information for the local metadata server, if issued from a subordinate metadata server. Monitor, Backup, Operator, Administrator
stopautorestart Disables the metadata server from restart automatically if it is down. Administrator
stopserver Shuts down a subordinate metadata server gracefully. Operator, Administrator
Policies
catpolicy Displays the rules of the specified policies. Monitor, Backup, Operator, Administrator
lspolicy Lists the active and inactive policies. Monitor, Backup, Operator, Administrator
mkpolicy Creates a policy. Administrator
rmpolicy Deletes one or more inactive policies. Administrator
statpolicy Displays policy statistics for each fileset, optionally based on a specified storage pool or rule. Monitor, Backup, Operator, Administrator
usepolicy Directs the metadata server to make an existing policy the active policy and applies its rules to all subsequent file creations. Administrator
Processes
lsproc Displays a list of long-running processes that are not yet complete and their attributes. Monitor, Backup, Operator, Administrator
Storage pools
chpool Modifies the settings of one or more storage pools. Administrator
disabledefaultpool Disables the use of the default storage pool and makes the current default storage pool a regular storage pool. Administrator
lspool Displays a list of the existing storage pools and their attributes. Monitor, Backup, Operator, Administrator
mkpool Defines one or more new user storage pools. Administrator
rmpool Deletes one or more empty, unreferenced storage pools. Administrator
setdefaultpool Changes a user storage pool to the default storage pool, and changes the previous default storage pool to a regularuser storage pool. Administrator
Users
lsadmuser Displays a list of administrative users and their attributes. Monitor, Backup, Operator, Administrator
resetadmuser Forces all administrative users to log in again. Administrator
Volumes and LUNs
activatevol Expands the size of one or more volumes. Administrator
chvol Modifies the settings of one or more volumes. Administrator
expandvol Modifies the settings of one or more volumes. Administrator
lslun Lists the LUNs that are accessible from SAN File System. Monitor, Backup, Operator, Administrator
lsvol Displays a list of available volumes. Monitor, Backup, Operator, Administrator
mkvol Adds one or more volumes to a storage pool. Administrator
rediscoverluns Rediscovers LUNs on the SAN that are visible to SAN File System. Monitor, Backup, Operator, Administrator
reportvolfiles Displays a list of files, and their attributes, for the specified volume. Backup, Operator, Administrator
rmvol Removes one or more volumes from a storage pool and redistributes the contents to other volumes in the same storage pool. Administrator
suspendvol Suspends one or more volumes so that the metadata server cannot allocate new data on the volumes. Administrator

Parent topic: Commands

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.