legacy

Runs commands in the legacy command-line interface.

Read syntax diagramSkip visual syntax diagram
>>-legacy--+----------+----------------------------------------->
           +- –?----+
           +- –h----+
           '- –help-'

>--"--+-MONITOR--------------------------------------------+--+-TRACE--+-DISABLE--module--------------------+-+----SETAUTOFAILOVER--+-HELP--------+----"-><
      +-ON-------------------------------------------------+  |        +-EMIT--"--string--"--ENABLE--module-+ |                     +-ENABLE STOP-+
      | .-OFF-.                                            |  |        +-LIST-------------------------------+ |                     +-ENABLE LOSS-+
      +-+-----+--------------------------------------------+  |        '-VERBOSITY--level-------------------' |                     '-DISABLE-----'
      +-IP--address--+------+--number--+----------+--value-+  +-SHOW--show_class------------------------------+
      |              '-PORT-'          '-INTERVAL-'        |  '-STATISTICS--statistics_type-------------------'
      '-QUERY----------------------------------------------'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
MONITOR
Controls the real time monitor that runs as a part of a server and sends performance statistics to the central monitoring facility for the cluster.
Note: This parameter should be used only by trained service technicians.
ON
Starts the real time monitor.
OFF
Stops the real time monitor.
IP address
Specifies the IP address for the central monitoring facility.
PORT number
Specifies the port number for the central monitoring facility. The default is 2700.
INTERVAL value
Specifies the time duration in seconds after which the server collects and sends statistics. The default is 20 seconds.
QUERY
Displays real time monitor status and parameters.
TRACE
Configures tracing functions. If this parameter is specified without any additional options, this command prints online help about all the trace command variants
DISABLE module
Disables tracing on the specified module. If you do not specify a module, this command prints out all of the disabled trace modules. You can use single-wildcard (?) and multiple-wildcard characters (*) to specify more than one module

Example: TM.*

disables all of the TM modules

Example: WAL:WALF????:*

disables the WAL:WALFLUSH:WALWRITERREP and WAL:WALFORCE:WALWRITERREP modules.

EMIT "string"
Write the specified string to the trace log, /usr/tank/server/log/log.trace.
ENABLE module
Enables tracing on the specified module. If you do not specify a module, this command prints out all of the enabled trace modules. You can use single-wildcard (?) and multiple-wildcard characters (*) to specify more than one module (for example, TM:* would enable all of the TM modules, and WAL:WALF????:* would enable the WAL:WALFLUSH:WALWRITERREP and WAL:WALFORCE:WALWRITERREP modules.

Example: TM.*

enables all of the TM modules

Example: WAL:WALF????:*

enables the WAL:WALFLUSH:WALWRITERREP and WAL:WALFORCE:WALWRITERREP modules.

LIST
Displays a list of all the trace modules that you can enable or disable in the metadata server. If a module is enabled, it is prefixed with an asterisk (*).
VERBOSITY level
Sets amount of output that is generated from tracing, based on the verbosity level. You can specify a value from 0 to 9. A value of 0, which is the default, emits only the most important messages, whereas a value of 9 emits all messages. If you do not specify a level, the current verbosity level is displayed.
SHOW show_class
Displays information about the specified show class.
Note: This parameter should be used only by trained service technicians.
You can specify one of the following show classes:
ASMSESSIONS
Displays information about the administrative sessions.
BUFPOOL [master]
Displays information about pages in the buffer pool, both the clean list and dirty list. Clean pages are pages available for reuse. The value for master is a flag that can be set to 0 or 1. The default is 0.

If the master metadata server is not specified, this command displays the buffer pool of the subordinate metadata server's workload. Specifying SHOW BUFPOOL 1 displays the buffer pool of the master metadata server's workload.

CLEANLIST [master]
Displays information about only clean pages in the buffer pool (see the BUFPOOL keyword).
CMATTACHPOINTS | CMATT
Displays the attach-points table.
CMARENAS
Displays the arenas table.
Tip: The output for this command can be quite large.
CMCP
Displays copy partition statistics.
CMFILESETS | CMCONT
Displays information about the filesets served by the subordinate metadata server.
CMLOADMAP [detail] | CMLOAD [detail]
Displays the load map, which maps the write-ahead log to the metadata server. If the value for detail is greater than 0, this keyword displays additional information.
CMPOLSTAT fileset
Displays storage pool use by a fileset.
CMSMASTERREC | CMM
Displays the contents of the Cluster Manager master record.
CMSECTOR sector_number
Reads the raw contents of a Cluster Manager sector sector_number from Logical Volume Manager (LVM) and displays the data in dump format.
CMSPACERECLAIM | CMSPREC
Displays information about the space-reclamation thread on the master metadata server.
CMSTGPOOLS | CMSTG
Displays information about the storage pools.
CMSVCCLASSES | CMSVC
Displays the service-class table.
CMVOLUMES | CMVOL
Displays the volumes table.
CMCONTBIND | CMCB
Displays the fileset-bindings table, which maps the write-ahead-log volume to which each fileset is bound.
CMWALVOLS | MWALS
Displays the write-ahead-log volumes table.
CONDITION | COND
Displays information about the condition of the metadata server.
DBPAGE space_ID page_address [format] [master]
Displays the contents of a page.
DBPAGEHDR space_ID page_address [format] [master]
Displays the contents of a page (header only).
DBPAGETABLE [master]
Displays information about locked pages (see the BUFPOOL keyword).
DBSPACE [master]
Displays information about DB Spaces (see the BUFPOOL keyword).
DBTXNTABLE [master]
Displays information about in-flight transactions (see the BUFPOOL keyword).
DIODISKS
Displays the open disk table.
DIRTYLIST [master]
Displays information about only dirty pages in the buffer pool (see the BUFPOOL keyword).
DISPATCHERSTATS | DSPSTATS
Displays dispatcher and queue statistics.
FLASHCLEANER fileset_ID [flags] [dump_ID]
Displays information about a fileset's FlashCopy® images.
FLASHTABLE [fileset_ID]
Displays information about a fileset's FlashCopy image table.
FSCK
Displays information about an active metadata check that is in progress.
FSCKSUB
Displays information about an active metadata check that is in progress on a subordinate metadata server.
GIODISKS
Displays information about the global disk.
GSNODES
Displays information about the engine.
INDEXSTATS space_id page_address [format] [master] | INDEX space_id page_address [format] [master]
Verifies the structural integrity of an index, and shows statistics on the index as a side-effect.
LATCH
Displays all active latches.
LATCHSTATS
Displays latch contention statistics.
LATCHX
Displays all active exclusive latches.
LATCHXSTATS
Displays exclusive-latch contention statistics.
LMCLIENTS
Displays a list of clients that are known to the lock manager.
LMALLLOCKS
Display all of the locks in the lock manager.
LMLOCKSBYCLIENT [client_ID]
Display all of the locks held by the specified client. To display a list all registered clients, use the TMCLIENTS keyword.
LMLOCKSBYOID [O] [I] [D] | LMLOCKS [O] [I] [D]
Display all of the locks held for the specified object.
LMSTATS
Displays summary statistics on the lock manager.
LVMDISKS
Displays the disk table.
LVMMASTERREC | LVMMR
Displays master control block, including:
  • Global ID of master disk.
  • Sector size of master disk.
  • Size, in bytes, of the logical and physical partitions for this LVM installation.
  • Installation common sector size, bytes.
  • Number of sectors per partition.
  • Number of physical partitions reserved to hold LVM persistent metadata.
  • Starting sector numbers for the shadow copies of the LVM persistent tables.
  • Index (0 or 1) of the shadow copy that contains the committed copy of the LVM persistent tables.
  • Update sequence (version) number.
LVMPARTMAP | LVMPM volume_ID
Displays a volume's partition map.
LVMREP
Displays information about the volume manager on a subordinate metadata server.
LVMVOLDESC volume_ID
Displays information about a volume's description.
LVMVOLUMES
Displays the volume table, including the following information:
  • Logical volume class.
  • Logical volume ID.
  • Size, in bytes, of logical pages.
  • Capacity, in number of logical partitions.
  • Number of formatted logical partitions.
  • Node ID of subordinate that has locked this logical volume.
  • Partition map for each logical partition, including the following data:
    • Logical partition.
    • LVM-assigned disk number of physical disk.
    • Partition status flags.
    • Physical partition number on disk.
MASTERWALSTATS | MWALSTATS
Displays write-ahead-log statistics for the master metadata server.
MUTEX
Displays all active mutexes (mutual exclusion locks).
MUTEXSTATS
Displays statistics about mutexes.
OMFILESETS | OMCONT [fileset_ID]
Displays all fileset information.
OMFILESETSTATS | OMCS [fileset_ID]
Displays statistics about a specific fileset.
OMOBJ [raw | pit | write | main] [object] [count count] [start start]
Displays object.
OPTCONFIG
Displays information on the metadata server configurable parameters.
PMCONFLICTS [ALL | command]
Displays a list of conflicting commands for each of all the existing commands or for a specified command.
PMTABLE
Displays information about long-running administrative commands.
SCARENASTATS | SCAS [fileset_ID] [pool_ID]
Displays statistics about a fileset's free-space map as well as the free-space map cache.
SCSTSDSTATS | SCSS [fileset_ID
Displays statistics about a fileset's security descriptor table.
SERVERHANG
Displays the major data structures used for detecting when a metadata server hangs.
STATEINFO
Displays information about the state of the cluster and metadata servers.
SUBWALSTATS
Displays write-ahead-log statistics for the subordinate metadata server.
THREAD (STATE [force]) | (STACK [ALL | thread_ID]) | USAGE | HELP
Displays information about threads.
TMATIMESTATS
Displays information about transaction manager access time attribute (tmatime) statistics.
TMATIMESTATSRESET
Resets information about tmatime statistics.
TMCLIENTS
Displays statistics for registered clients.
TMFILTERS
Displays information about metadata server transaction-manager filters.
TMPATH cluster_ID fileset_ID local_OID [epoch_ID]
Displays information about metadata server transaction-manager filters.
VERSION
Displays information about the metadata server version.
WALCKPT [master]
Displays write-ahead-log context for the local node (see the BUFPOOL keyword).
WALSTATS [master]
Displays write-ahead-log statistics (see the BUFPOOL keyword).
WALWRITER [master]
Displays write-ahead-log statistics (see the BUFPOOL keyword).
STATISTICS statistics_type
Displays information about the specified show class. You can specify one of the following types:
RESET
Resets the statistics buffer.
SHOWALL
Displays all statistics about the Cluster Manager master transactions and the SAN File System protocol received by the master and subordinate metadata servers.
SHOWBTREE
Displays B-tree statistics. A B-tree is a file access structure that provides a balanced search tree depth when accessing records. B-trees are used by SAN File System to store file system object and metadata information.
SHOWBUF
Displays statistics about the buffer pool.
SHOWCM
Displays statistics about the Cluster Manager master transactions received by the master and subordinate metadata server.
SHOWDSP
Displays dispatcher and queue statistics.
SHOWGIO
Displays statistics about the global disk table.
SHOWLATCH
Displays statistics about latches.
SHOWLATCHS
Displays statistics about extended latches.
SHOWLM
Displays statistics about the lock manager.
SHOWMUTEX
Displays statistics about mutexes.
SHOWSTP
Displays statistics about the SAN File System protocol by the message type that is received by the metadata servers.
SHOWWAL
Displays write-ahead-log statistics for the master and subordinate metadata server.
SETAUTOFAILOVER
Enables or disables the failover script.
HELP
Displays a short help message.
ENABLE STOP
Enables the failover script to run for a stopserver command.
ENABLE LOSS
Enables the failover script to run for a server loss.
DISABLE
Disables all failover scripts from running.

Prerequisites

This task must be performed only by trained service technicians.

Description

If the legacy command string contains single quotation marks (') or double quotation marks ("), you must precede the character with a backslash (\).

Example

Running a legacy command The following example runs the show command from the legacy CLI:
sfscli> legacy "SHOW TMCLIENTS"
List of identified clients:
  ClientId=1010513811, ClientName="st-client-1", SendInProg=0, SendMsgNo=2,
  ccb_sendAcked=1, DeliveredMsgNo=1, IPaddress=192.168.1.10, IPport= 32769

Parent topic: Administrative commands

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