| Sun StorageTek QFS File System Configuration and Administration Guide |    
|
| Sun StorageTek QFS File System Configuration and Administration Guide |
|
| A P P E N D I X C |
|
Using the samu(1M) Operator Utility |
This chapter shows how to use samu(1M) to control the devices configured within your Sun StorageTek QFS environment. Many samu(1M) displays are useful only for sites using the storage and archive management mechanism. If you are using samu(1M) in a Sun StorageTek QFS environment, some displays do not apply to you.
This chapter contains the following sections:
The operations that you can perform from within samu(1M) can also be performed by using the samcmd(1M) command. For more information about samcmd(1M), see the samcmd(1M) man page.
The samu(1M) operator utility requires a display terminal that displays a minimum of 24 lines by 80 characters wide. The utility includes the following features:
The display windows shown in this chapter are representative examples. The exact format and amount of information displayed on your terminal can be different depending on your terminal model and the devices configured in your Sun StorageTek QFS environment.
The following sections describe how to start and stop samu(1M), interact with the utility, access the help windows, and view operator displays.
|
To start samu(1M), type the samu(1M) command from the command line:
The system starts samu(1M) and shows the help display. This is the default initial display. To view a different samu(1M) display, follow the steps in To Display a samu(1M) Screen.
The samu(1M) utility enables you to select its initial display. For more information about the samu(1M) command-line options, see the samu(1M) man page.
|
Note - samu(1M), like the vi(1) editor, is based on the curses(3CURSES) routine. If you have trouble invoking samu(1M), make sure that your terminal type is defined correctly. |
|
The samu(1M) command accepts options on its command line for displaying different samu(1M) screens.
1. Type a colon (:) to bring up the samu(1M) prompt.
After you type in the colon, the following appears in the lower left:
2. Type the letter that corresponds to the display you want to view and press return.
For example, to view the v display, type a v and press Return after the Command: prompt.
For a complete list of letters to type and the displays to which they correspond, see (h) - Help Display.
|
To exit samu(1M), type one of the following:
The samu(1M) operator utility exits and returns you to the command shell.
Interacting with samu(1M) is similar to interacting with the UNIX vi(1) editor with respect to paging forward or backward, entering commands, refreshing the display, and quitting the utility.
Each display has its own section in this chapter, and each display section shows the control key sequences you can use to navigate in that display. The samu(1M) man page summarizes the control key navigation sequences.
The last line of the display window shows the command and display error messages. If a command error occurs, automatic display refreshing halts until the next operator action.
Each device included in the Sun StorageTek QFS environment is assigned an Equipment Ordinal (for example, 10) in the mcf file. Many samu(1M) commands reference a specific device using that Equipment Ordinal.
Example. The syntax for the :off command is as follows:
For eq, type the Equipment Ordinal for the device you are trying to address.
When you start samu(1M), the system automatically displays the first help screen.
For more information about the help (h) display, see (h) - Help Display.
To move forward or backward from one screen to the next, type the following key sequence:
You can return to the help display at any time by pressing the h key.
You can view the samu(1M) operator displays by pressing the key corresponding to each display. The lowercase keys a through w display operational information.
For displays that overflow the screen area, the word more appears on the bottom of the screen display, indicating that the display contains additional information. You can use Ctrl-f to page forward and see more content.
CODE EXAMPLE C-1 contains the word more, indicating that more information appears on subsequent screens.
If samu(1M) prompts you to enter a device, enter its associated Equipment Ordinal. The configuration display (c) shows Equipment Ordinals for all removable media devices. To control all displays, use the control keys listed for the display.
The following sections describe the operator displays in alphabetical order. Examples are provided, and when necessary, displays are followed by a table describing the fields displayed.
|
Note - If you have the Sun StorageTek QFS software installed without the Sun StorageTek SAM software, only some of the operator displays will be available. |
The a display shows the archiver status.
You can invoke this display differently, depending on what you need to view, as follows:
For filesystem, specify the name of a file system.
TABLE C-1 shows the control keys you can use in the a display.
TABLE C-2 shows the control keys you can use in the :a filesystem display.
CODE EXAMPLE C-2 shows activity and statistics for a single file system in the summary display.
TABLE C-3 shows the fields in the detail display.
The c display shows your configuration's connectivity. It lists all device names and Equipment Ordinals.
To invoke the device configuration display, type the command with the following format:
TABLE C-4 shows the control keys you can use in this display.
CODE EXAMPLE C-3 shows the device configuration display.
TABLE C-5 shows the field descriptions for this display.
|
Current operating state of the device. Valid device states are as follows:
|
|
|
Name of the storage Family Set or library to which the device belongs. |
The C display shows the content of a specified memory address. To show the content at an address, enter the address in hexadecimal.
To invoke this display, type the following command:
For hex-address, specify the address of a memory location in hexadecimal. For example:
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-4 shows the memory display. The output has been truncated for inclusion in this manual.
The d display shows the events being traced as specified in the defaults.conf file. For more information about enabling trace files, see the defaults.conf(4) man page.
To invoke this display, type the following command:
CODE EXAMPLE C-5 shows trace file information. It includes information about the daemons being traced, the paths to the trace files, the events being traced, and information about the size and age of the trace files.
The D display shows the disk volume dictionary, which keeps track of the disk media for disk archiving that has been defined in the diskvols.conf file. The dictionary contains information about each VSN, including the capacity, space remaining, and flags indicating the status of the VSN. These flags include unavailable, read only, and bad media.
To invoke this display, type the following command:
CODE EXAMPLE C-6 shows the device configuration display.
TABLE C-6 shows the flags for the D display.
The diskvols samu(1M) command can be used to set or clear the disk volume dictionary flags. See The :diskvols volume [+flag | -flag] Command.
The f display shows the components of your Sun StorageTek QFS file systems.
To invoke this display, type the following command:
CODE EXAMPLE C-7 shows the file systems display.
TABLE C-7 shows the field descriptions for this display.
|
Current operating state of the device. Valid device states are as follows:
|
|
|
Device status. For a description of status codes, see Operator Display Status Codes. |
|
|
Name of the host system upon which the file system is mounted. |
The F display shows the label on an optical disk.
To invoke this display, type the following command:
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
The h display shows a summary of the samu(1M) displays available. By default, this is the first display that the system presents when you enter the samu(1M) command at the command line.
To invoke this display, type the following command:
TABLE C-8 shows the control keys you can use in this display.
There are several pages of help screens, but this manual shows only the first. Subsequent help screens show samu(1M) commands.
CODE EXAMPLE C-8 shows the initial help screen for the Sun StorageTek SAM file system. On a Sun StorageTek QFS file system, not all of the displays appear in the initial help screen. For example, the removable media displays are not available if you are running a Sun StorageTek QFS system. If you are using the SAM-QFS configuration, the help screen appears as shown in CODE EXAMPLE C-8.
The I display shows the content of inodes.
You can invoke this display differently, depending on what you need to view, as follows:
For filesystem, specify the name of a file system.
For inode-number, specify the inode number in either hexadecimal or decimal.
TABLE C-9 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-9 shows the inode display.
The J display shows the shared memory segment for the preview queue.
To invoke this display, type the following command:
TABLE C-10 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-10 shows the preview shared memory display. This output has been truncated for inclusion in this manual.
The K display shows kernel statistics, such as the number of inodes currently in memory.
To invoke this display, type the following command:
TABLE C-11 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-11 shows the kernel statistics display.
The l display shows the usage information for the file system, including the capacity and space used for each library and file system.
To invoke this display, type the following command:
CODE EXAMPLE C-12 shows an example of a usage display.
|
Note - In versions of the software before 4U3, this display showed license information for the file system. |
The L display shows the location of the shared memory tables. It also shows some system defaults that are kept in shared memory.
To invoke this display, type the following command:
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-13 shows the shared memory tables.
The m display shows the status of mass storage file systems and their member drives. This display shows only mounted file systems.
To invoke this display, type the following command:
CODE EXAMPLE C-14 shows the m display. Member drives are indented one space and appear directly below the file system to which they belong.
TABLE C-12 shows the field descriptions for this display.
|
Device status. For a description of status codes, see Operator Display Status Codes. |
|
|
Ordinal number of the disk device within the storage Family Set. |
|
The M display shows the raw shared memory segment in hexadecimal. This is a device table.
To invoke this display, type the following command:
TABLE C-13 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-15 shows the shared memory display. The output has been truncated for inclusion in this manual.
The n display shows the status of the stager for all media. It displays a list of outstanding stage requests.
You can invoke this display differently, depending on what you need to view, as follows:
For mt, specify one of the media types shown in the mcf(4) man page.
CODE EXAMPLE C-16 shows the staging status display.
The N display shows all mount point parameters, the superblock version, and other file system information.
To invoke this display, type the following command:
TABLE C-14 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-17 shows the file system parameters display.
The o display shows the status of all optical disk drives configured within the environment.
To invoke this display, type the following command:
TABLE C-15 shows the control keys you can use in this display.
CODE EXAMPLE C-18 shows the optical disk status display.
Optical disk status samu 4.6 Thu Oct 11 13:15:40 ty eq status act use state vsn mo 35 --l---wo-r 1 29% ready oper2 |
TABLE C-16 shows the field descriptions for this display.
|
Device status. For a description of status codes, see Operator Display Status Codes. |
|
|
Current operating state of the optical disk. Valid device states are as follows:
|
|
|
Volume serial name assigned to the optical disk, or the keyword nolabel if the volume is not labeled. |
The p display lists information about pending load requests for removable media. You can use the mt argument to select either a specific type of media, such as DLT tape, or a family of media, such as tape. The priority display lists the priority in the preview queue, rather than the user queue, and sorts the entries by priority.
It displays mount requests in the following formats:
You can invoke this display differently, depending on what you need to view, as follows:
For mt, specify one of the media types shown in the mcf(4) man page.
TABLE C-17 shows the control keys you can use in this display.
CODE EXAMPLE C-19 shows the removable media load requests display.
Removable media load requests all both samu 4.6 09:14:19 Sept 8 2006 count: 1 index type pid user rb flags wait count vsn 0 dt 15533 root 150 W--f--- 0:00 DAT001 |
TABLE C-18 shows the field descriptions for this display.
|
UNIX process identifier. A process identifier of 1 indicates NFS access. |
|
|
Equipment Ordinal of the automated library in which the requested VSN resides. |
|
|
Flags for the device. See TABLE C-19. |
|
TABLE C-19 shows the flags for the p display.
The P display lists the services registered with the Sun StorageTek QFS single port multiplexer.
To invoke this display, type the following command:
TABLE C-20 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-20 shows the active services display.
Active Services samu 4.6 09:08:33 Sept 8 2006 Registered services for host `pup': sharedfs.qfs2 sharedfs.qfs1 2 services registered. |
The r display enables you to monitor the activity on removable media devices such as tape drives. You can monitor either a specific type of device, such as video tape, or a family of devices such as all tape devices.
You can invoke this display differently, depending on what you need to view, as follows:
For eq, specify the Equipment Ordinal for the device.
CODE EXAMPLE C-21 shows the removable media status display.
Removable media status: all samu 4.6 09:11:27 Sept 8 2006 ty eq status act use state vsn dt 150 --l------r 0 63% ready DAT001 |
TABLE C-21 shows the field descriptions for this display.
|
Device status. For a description of status codes, see Operator Display Status Codes. |
|
|
Current operating state of the removable media. Valid device states are as follows:
|
|
|
Volume serial name assigned to the volume, or the keyword nolabel if the volume is not labeled. Blank if no volume is present in the transport, or device is off. |
The R display shows information and status on Sun SAM-Remote configurations.
To invoke this display, type the following command:
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
The s display shows the status for all devices configured within the environment.
To invoke this display, type the following command:
TABLE C-22 shows the control keys you can use in this display.
CODE EXAMPLE C-22 shows the device status display.
TABLE C-23 shows the field descriptions for this display.
|
Path to the device. For file system devices, this is the file system name. |
|
|
Equipment Ordinal of the family, set to which the device belongs. |
|
|
Device status. For a description of status codes, see Operator Display Status Codes. |
The S display shows raw device data.
To invoke this display, type the following command:
TABLE C-24 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
The t display shows the status of all tape drives configured within the environment.
To invoke this display, type the following command:
TABLE C-25 shows the control keys you can use in this display.
CODE EXAMPLE C-23 shows the tape drive status display.
TABLE C-26 shows the field descriptions for this display.
|
Device status. For a description of status codes, see Operator Display Status Codes. |
|
|
Current operating state of the removable media. Valid device states are as follows:
|
|
|
Volume serial name assigned to the volume, or the keyword nolabel if volume is not labeled. Blank if no volume is present in the transport, or device is off. |
The T display shows the SCSI status of a SCSI device.
To invoke this display, type the following command:
TABLE C-27 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
The u display lists all files in the staging queue.
To invoke this display, type the following command:
TABLE C-28 shows the control keys you can use in this display.
CODE EXAMPLE C-24 shows the staging queue display.
TABLE C-29 shows the field descriptions for this display.
The U display shows the device table in a human-readable form.
You can invoke this display differently, depending on what you need to view, as follows:
For eq, specify the Equipment Ordinal of the device.
TABLE C-30 shows the control keys you can use in this display.
This display is designed for debugging. It is intended to be used only with the assistance of a Sun Microsystems support staff person.
CODE EXAMPLE C-25 shows the device table display.
The v display shows the location and VSN of all disks or tapes currently cataloged in the automated library.
You can invoke this display differently, depending on what you need to view, as follows:
For eq, specify the Equipment Ordinal of the device. Type the keyword historian to view the historian catalog.
At certain times, samu(1M) prompts for a device to be entered, as follows:
For eq, specify the Equipment Ordinal of the device or press return. Pressing return displays information for the previous device specified.
For a list of all device names and Equipment Ordinals, see (c) - Device Configuration Display.
TABLE C-31 shows the control keys you can use in this display.
CODE EXAMPLE C-26 shows the automated library catalog display.
TABLE C-32 shows the field descriptions for this display.
|
Name of the specified automated library and time the display refreshed. |
|
|
Number of accesses to this volume since the last audit operation. |
|
|
Flags for the device. See TABLE C-33 for information about the flags. |
|
TABLE C-33 shows the flags from the flags field in TABLE C-32. In some cases, more than one flag can occur in a field, and one flag overrides the other.
The w display shows queued stage requests for which the volumes have not yet been loaded.
You can invoke this display differently, depending on what you need to view, as follows:
For mt, specify one of the media types shown in the mcf(4) man page.
TABLE C-34 shows the control keys you can use in this display.
CODE EXAMPLE C-27 shows the pending stage queue.
TABLE C-35 shows the field descriptions for this display.
|
The position (in decimal format) of the archive file on the specific medium. |
|
The operator displays have different status codes for the removable media device displays and the file system displays. The following sections describe these status codes.
The o, r, s, and t operator displays show status codes for removable media devices. Status codes are displayed in a 10-position format, reading from left (position 1) to right (position 10).
The status codes in this section do not apply to the samu(1M) f, m, and v displays. For information about the status codes for the f and m displays, see File System Display Status Codes. For information about the status codes for the v display, see (v) - Automated Library Catalog Display.
TABLE C-36 defines the valid status codes for each position.
|
For automated libraries, all storage slots occupied. For tape and magneto-optical drives, media is full. |
|
The f and m operator displays show status codes for file systems. Status codes are displayed in an 11-position format, reading from left (position 1) to right (position 11).
The status codes in this section do not apply to the samu(1M) c, o, r, s, t, or v displays. For information about the status codes for the o, r, s, and t displays, see Removable Media Device Display Status Codes. For information about the status codes for the v display, see (v) - Automated Library Catalog Display.
TABLE C-37 defines the valid status codes for each position.
The c, m, o, r, s, and t operator displays show device state codes. These codes represent the current access state for the device. TABLE C-38 defines the valid state codes.
|
The device is available for access. For certain displays, this state might be superseded by the states ready or notrdy. |
|
|
The device is available for read-only access. For certain displays, this state might be superseded by the states ready or notrdy. |
|
|
The device is not available for access. For tape and optical disk drives, possible reasons for the device to be in the off state include the following:
|
|
|
The device is not available for new connections. Operations in progress continue until completion. |
|
|
The device is on and the disk or tape loaded in the transport is available for access. |
|
|
The device is on, but no disk or tape is present in the transport. |
|
|
The device is unavailable for access and cannot be used for automatic operations. You can continue to use the load(1M) and unload(1M) commands for moving media while the device is in the unavail state. |
|
|
The nalloc flag has been set, which prohibits any future allocation to this device. For more information, see Per-logical unit number (LUN) Allocation Control. |
You can use the samu(1M) down, off, and on device state commands to change device states to down, off, or on. You can enter these commands from any samu(1M) display, but if you enter them from the c, m, o, r, s, or t display, you can see the device state change in the display. For example, you could set a device state to off from within the P display, but you would not be able to see the new device state reflected in the display.
The following procedures show what to type to change a device's state from down to on and from on to down.
1. Bring up a samu(1M) display that shows drive and automated library device states.
The following samu(1M) displays all show device states: c, m, o, r, s, and t.
2. Visually inspect the display to verify that the device is in the down state.
Turning the device off halts all activity so the device can be started cleanly in the next step. For example:
For eq, specify the Equipment Ordinal of the device.
For eq, specify the Equipment Ordinal of the device.
1. Bring up a samu(1M) display that shows drive and automated library device states.
The following samu(1M) displays all show device states: c, m, o, r, s, and t.
2. Visually inspect the display to verify that the device is in the on state.
Turning the device off halts all activity so the device can be stopped cleanly in the next step. For example:
For eq, specify the Equipment Ordinal of the device.
For eq, specify the Equipment Ordinal of the device.
The following sections describe the operator commands that you can enter from the samu(1M) operator utility's command interface. You can enter the commands from any display.
The following types of operator commands are available:
If you want to enter any operator commands from the Solaris OS command line, you must use them as arguments to the samcmd(1M) command. For more information about the samcmd(1M) command, see the samcmd(1M) man page.
In the following subsections, each samu(1M) command is prefaced with a colon (:) when it is entered to designate that a command is being entered and not a series of hot keys.
TABLE C-39 shows the device commands and their actions.
|
Restricts access to device eq by preventing new connections to the device. Existing operations continue until completion. |
|
|
Selects device eq and makes it unavailable for use with the file system. You might set a drive state to unavail, for example, in a disaster recovery situation in which you are trying to load media to restore a file system and you do not want the Sun StorageTek SAM software to attempt to use this drive. |
|
|
Unloads the mounted media for the specified removable media device eq. For magazine devices, the unload command unloads the mounted cartridge and ejects the magazine. |
|
|
Sets the nalloc flag on the device, which prohibits any future allocation to this device. For more information, see Per-logical unit number (LUN) Allocation Control. |
|
|
Removes the nalloc flag from the device. The nalloc flag prohibits any future allocation to this device. The on command also removes this flag. For more information, see Per-logical unit number (LUN) Allocation Control. |
All of these commands are used in the following format: :command eq. For eq, specify the Equipment Ordinal of the device.
The following commands enable you to manage I/O characteristics dynamically.
The flush_behind command sets the maximum flush_behind value. When set to a value greater than 0, modified pages that are being written sequentially are written to disk asynchronously to help the Solaris kernel layer keep the pages clean. This option sets the maximum flush_behind value.
For value, specify an integer number of kilobytes such that 0 
value 8192. By default, value=0, which disables flush_behind.
For eq, specify the Equipment Ordinal for the file system.
These commands enable you to control whether the file system caches NFS data written to the server even if NFS has requested that the data be written synchronously through to disk. The force_nfs_async command caches NFS data. The noforce_nfs_async command, which is the default, synchronously writes data through to disk.
The force_nfs_async command is effective only if the file system is mounted as an NFS server and only if the clients are mounted with the noac NFS mount option. For more information about mounting an NFS file system, see the mount_nfs(1M) man page.
For eq, specify the Equipment Ordinal for the file system.
|
Caution - The force_nfs_asyncoption violates NFS protocols. Use this command with caution. In the event of a server interruption, data can be lost. Data is cached on the NFS server and cannot be seen immediately by all the clients if there are multiple NFS servers. Multiple NFS servers can be enabled within the Sun StorageTek QFS shared file system. For more information about the Sun StorageTek QFS shared file system, see Configuring a Sun StorageTek QFS Shared File System. |
The readahead command specifies the maximum number of bytes that can be read ahead by the file system.
For eq, specify the Equipment Ordinal for the file system.
For contig, specify units of 1-kilobyte blocks. This must be an integer such that 1 < contig < 8192. The contig specified is truncated to a multiple of 8 kilobytes. The default contig is 8 (131072 bytes).
For example, the following command sets the maximum contiguous block size to 262,144 bytes for the file system defined as Equipment Ordinal 3:
This value can also be configured in the samfs.cmd file by specifying the readahead directive. For more information, see the samfs.cmd(4) man page.
These options specify whether or not the file system aligns the writebehind buffer. Specify sw_raid if the software RAID feature of a package such as Solstice DiskSuite
is also used on this file system. The default setting is nosw_raid.
For eq, specify the Equipment Ordinal for a file system.
The writebehind command specifies the maximum number of bytes that can be written behind by a file system.
For eq, specify the Equipment Ordinal for a file system.
For contig, specify units of 1-kilobyte blocks. This must be an integer such that 1 < contig < 8192. The default contig is 8 (131072 bytes).
For example, the following command sets the maximum contiguous block size to 262,144 bytes for the file system defined as Equipment Ordinal 50:
This value can also be configured in the samfs.cmd file by specifying the writebehind directive. For more information, see the samfs.cmd(4) man page.
The wr_throttle command sets the number of outstanding write bytes for one file to value kilobytes.
For eq, specify the Equipment Ordinal for a file system.
For value, specify an integer number of kilobytes. If value=0, there is no limit. The default is 16384.
The commands in this section control I/O on Sun StorageTek QFS file systems. They enable you to change the type of I/O for an individual file based on I/O size and history. If direct I/O is specified for a file, for example, through the setfa(1) command, these options are ignored and all I/O to regular files is direct, if possible.
These commands refer to both well-aligned and misaligned I/O. Well-aligned I/O occurs when the file offset falls on a 512-byte boundary and when the length of the I/O transfer is at least 512 bytes. Misaligned I/O occurs when the file offset does not fall on a 512-byte boundary and the length of the transfer is less than 512 bytes.
For more information about I/O and I/O management, see Advanced Topics.
These commands set the lower limits for well-aligned I/O to value 1024-byte blocks. Use the dio_rd_form_min command to set the value for reads, and use the dio_wr_form_min command to set the value for writes.
For eq, specify the Equipment Ordinal for the file system.
For value, specify an integer number of 1024-byte blocks to use for the lower limit. By default, value=256. If value=0, automatic I/O switching is disabled.
These commands set the lower limit for misaligned I/O to value 1024-byte blocks. Use the dio_rd_ill_min command to set the value for reads, and use the dio_wr_ill_min command to set the value for writes.
For eq, specify the Equipment Ordinal for the file system.
For value, specify an integer number of 1024-byte blocks to use for the lower limit. By default, value=256. If value=0, automatic I/O switching is disabled.
These commands set the number of consecutive I/O transfers that can occur, with a buffer size greater than the specified lower limits, to value operations.
For eq, specify the Equipment Ordinal for the file system.
For value, specify the number of consecutive I/O transfers with a buffer size greater than the specified lower limit. The specified lower limit is the value of dio_rd_form_min for aligned reads or dio_rd_ill_min for misaligned reads. By default, value=0, which means that no default direct reads occur based on I/O sizes.
For more information, see one or more of the following commands or mount parameters:
These commands set or clear the direct I/O sparse zeroing mount option.
The dio_szero option causes uninitialized areas of sparse files written with direct I/O to be zeroed when the area is accessed. This makes the sparse file behavior the same as that for paged I/O. By default, sparse files written by direct I/O do not have the uninitialized areas zeroed for performance reasons. The default is nodio_szero.
For eq, specify the Equipment Ordinal for the file system.
These commands enable you to control whether direct I/O is used as the default I/O mode. By default, the I/O mode is buffered and uses the page cache. The forcedirectio command enables direct I/O for all transfers. The noforcedirectio command enables the default, which is buffered I/O.
For eq, specify the Equipment Ordinal for the file system.
When direct I/O is specified, the system transfers data directly between the user's buffer and disk. Use direct I/O only if the file system is used for large, block-aligned, sequential I/O.
For more information about I/O, see Advanced Topics.
The following file system commands are supported on Sun StorageTek QFS shared file systems only.
The metatimeo command sets the Sun StorageTek QFS shared file system metadata cache timeout value. For more information about using this feature, see Retaining Cached Attributes: the meta_timeo=n Option.
For eq, specify the Equipment Ordinal of the file system.
For interval, specify an interval in seconds. The default interval is 3. After this interval expires, the client host systems obtain a new copy of the metadata information from the metadata server host.
These commands enable or disable multihost reads and writes. For information about this feature, see Enabling Multiple Host Reads and Writes: the mh_write Option.
For eq, specify the Equipment Ordinal of the file system.
These commands set the minimum and maximum block allocation size.
For eq, specify the Equipment Ordinal of the file system.
For value, and for more information about this feature, see Tuning Allocation Sizes: the minallocsz=n and maxallocsz=n Options.
These commands tune the amount of time granted for read, write, and append leases. For information about this feature, see Using Leases in a Sun StorageTek QFS Shared File System: the rdlease=n, wrlease=n, and aplease=n Options.
For eq, specify the Equipment Ordinal of the file system.
For interval, specify an integer number of seconds. All three leases enable you to specify an interval such that 15 interval 600. The default interval is 30.
The following commands enable you to control leases, allocation sizes, and various other file system characteristics.
These commands set or clear the application binary recovery (ABR) mount option.
For use in an Oracle RAC environment with Sun StorageTek QFS asynchronous I/O (AIO) only. These mount options disable or enable ABR of software mirrors. They apply only to Sun StorageTek QFS file systems built on Solaris Volume Manager mirrored volumes that support ABR.
For eq, specify the Equipment Ordinal for the file system.
These commands set or clear the direct mirror reads (DMR) mount option.
For use in an Oracle Real Application Cluster (RAC) environment with Sun StorageTek QFS AIO only. These mount options disable or enable DMR of software mirrors. They apply only to Sun StorageTek QFS file systems built on Solaris Volume Manager mirrored volumes that support DMR.
For eq, specify the Equipment Ordinal for the file system.
The invalid command specifies that the file system hold cached attributes for at least interval seconds after a file is modified. You can specify this command only if the file system was mounted originally with the reader mount option. For information about mount options, see the mount_samfs(1M) man page.
For eq, specify the Equipment Ordinal for the file system.
For interval, specify the number of seconds to hold the attributes after file modification. For example, assume that interval=30. In such a file system, if you issue an ls(1) command, you might not see a newly created file appear in its output for 30 seconds after it has been created on its writer host.
The mm_stripe command sets the metadata stripe width for the file system to value 16-kilobyte disk allocation units (DAUs).
For eq, specify the Equipment Ordinal of the file system.
For value, specify either 0 or 1. If value=1, which is the default, the file system writes one DAU of metadata to one LUN before switching to another LUN. If value=0, the metadata is round-robined across all available metadata LUNs.
The qwrite and noqwrite commands control the ability to perform simultaneous reads and writes to the same file from different threads. Specify qwrite only if file system users handle multiple simultaneous transactions to the same file. For example, this is useful in database applications. The qwrite feature improves I/O performance by queuing multiple requests at the drive level. The qwrite specification is disabled for NFS reads or writes of the file system.
The default setting is noqwrite, so the file system disables simultaneous reads and writes to the same file. This is the mode defined by the UNIX vnode interface standard that gives exclusive access to only one writer and forces other writers and readers to wait.
For eq, specify the Equipment Ordinal of the file system.
The refresh_at_eof and norefresh_at_eof commands can be used for fast updates to Sun StorageTek QFS hosts that are mounted with the reader mount option in a multireader file system. This option ensures that the system refreshes the current file size when the read buffer exceeds the end of file. You can use this, for example, if the writer host system is appending to a file and the reader is issuing tail(1) commands with the -f option. The default is norefresh_at_eof.
For eq, specify the Equipment Ordinal of the file system.
The suid and nosuid commands control whether running programs are allowed to automatically change their owner IDs. For more information about the implications of using these mount options, see the suid and nosuid mount option descriptions on the mount_ufs(1M) man page and see the suid(2) man page.
For eq, specify the Equipment Ordinal of the file system.
The stripe command sets the stripe width for the file system to value disk allocation units (DAUs). The stripe width specifies that value multiplied by the DAU bytes are written to one LUN before switching to the next LUN. You can use the sammkfs(1M) -a command to set the DAU size on the file system when it is initialized.
For eq, specify the Equipment Ordinal of the file system.
For value, specify an integer such that 0 < value < 255. If value=0, files are round-robin on each slice. The default value on file systems with an ms Equipment Type and on file systems with an ma Equipment Type with no striped group (gXXX) components is as follows:
By default, value=0 on a Sun StorageTek QFS shared file system.
By default, value=0 on file systems with an ma Equipment Type with any striped group (gXXX) components.
The system sets value=0 if mismatched striped groups exist.
For more information about file system types, see Design Basics and Configuring the File System.
The sync_meta command determines whether metadata is written to disk every time it changes. If you are using this command on Sun StorageTek QFS shared file system, also see Specifying the Frequency With Which Metadata Is Written: the sync_meta=n Option.
For eq, specify the Equipment Ordinal of the file system.
For value, specify either 0 or 1, as follows:
The trace command enables tracing for a file system. The notrace command disables tracing. These are global directives that affect all operations. For more information about file system tracing, see the defaults.conf(4) man page.
For eq, specify the Equipment Ordinal of a file system.
The following commands enable you to control tracing, open access to a disk device, and perform several other miscellaneous tasks.
The clear command clears the specified VSN from the removable media mount requests display. For more information, see (p) - Removable Media Load Requests Display.
For vsn, specify the volume to mount. Any process waiting for the VSN mount is aborted.
For index, specify the decimal ordinal of the VSN in the removable media display.
The devlog command sets one or more events to be logged.
For eq, specify the Equipment Ordinal of a device.
For option, specify one or more event types. Possible event types are as follows: all, date, default, detail, err, event, label, mig, module, msg, none, retry, stage, syserr, and time. For information about these options, see the defaults.conf(4) man page. If no option is specified, the system does not change the current events being logged for the eq specified.
The diskvols command sets or clears flags in the disk volume dictionary.
For volume, specify the volume in the disk volume dictionary.
For flag, specify one of the five flags in the D samu(1M) display. For information about the disk volume dictionary and the flags see (D) - Disk Volume Dictionary or the samu(1M) man page.
The dtrace commands are as follows:
The dtrace commands specify various tracing options. TABLE C-40 shows the tracing control command arguments.
The fs command sets the file system to be displayed through the N display.
For fsname, specify the name of the file system to be examined.
The mount command selects a Sun StorageTek QFS file system. For mntpt, specify the mount point of a file system.
The open command enables access to the specified disk device. You must issue this command before you can use the read command, disk sector display (S), or file label display (F).
For eq, specify the Equipment Ordinal of a device.
The read command reads the specified sector from the currently opened disk device. You must open the device before it can be read.
For addr, specify the hexadecimal sector address.
The refresh command determines the amount of time between samu(1M) screen refreshes.
For i, specify a time in seconds.
The snap command sends a snapshot of a display window to filename, which is the name of a file to receive the display information.
To aid in problem reporting, you can take a snapshot of all the samu(1M) utility's displays. Each new snapshot is appended to the snapshots file. The default file is snapshots in the current working directory. The file can be printed, examined using vi(1), or faxed to Sun Microsystems customer support staff.
The ! command enables you to run a shell command without leaving the samu(1M) operator utility.
| Sun StorageTek QFS File System Configuration and Administration Guide | 819-7935-10 |
|
Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.
To Invoke samu(1M)