C H A P T E R 6 |
Using the samu(1M) Operator Utility |
This chapter shows how to use samu(1M) to control the devices configured within your Sun StorEdge QFS or Sun StorEdge SAM-FS 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 StorEdge 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 StorEdge QFS or Sun StorEdge SAM-FS 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 Invoke samu(1M) |
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 allows 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. |
To Display a samu(1M) Screen |
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:
Note - You access the help screen and all the display screens in samu(1M) through this same method. After you type a colon character, the Command prompt appears. |
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 Stop samu(1M) |
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 StorEdge QFS or Sun StorEdge SAM-FS environment is assigned an Equipment Ordinal (for example, 10) in the mcf file. Many samu(1M) commands reference a specific device.
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. This help screen differs depending on whether you have a Sun StorEdge QFS or Sun StorEdge SAM-FS file system.
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. CODE EXAMPLE 6-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.
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 6-1 shows the control keys you can use in the a display.
TABLE 6-2 shows the control keys you can use in the :a filesystem display.
CODE EXAMPLE 6-2 shows activity and statistics for a single file system in the summary display.
TABLE 6-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 6-4 shows the control keys you can use in this display.
CODE EXAMPLE 6-3 shows the device configuration display.
TABLE 6-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 6-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 6-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 f display shows the components of your Sun StorEdge QFS or Sun StorEdge SAM-FS file systems.
To invoke this display, type the following command:
CODE EXAMPLE 6-6 shows the file systems display.
TABLE 6-6 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 6-7 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 6-7 shows the initial help screen for the Sun StorEdge SAM-FS file system. On a Sun StorEdge 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 StorEdge QFS system. If you are using Sun SAM-QFS software, the help screen appears as shown in CODE EXAMPLE 6-7.
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 6-8 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 6-8 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 6-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 6-9 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 6-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 6-10 shows the kernel statistics display.
The l display shows shows the licenses and expiration dates for Sun StorEdge QFS and Sun StorEdge SAM-FS software.
To invoke this display, type the following command:
CODE EXAMPLE 6-11 shows an example of a license display.
The sample display shows license information for a Sun StorEdge SAM-FS file system. The license information is derived from the license keys in the following file:
This display shows the following information for the 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 6-12 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 6-13 shows the m display. Member drives are indented one space and appear directly below the file system to which they belong.
TABLE 6-11 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 S et. |
|
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 6-12 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 6-14 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 6-15 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 6-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 6-16 shows the file system parameters display.
The o display shows the status of all optical disk drives configured within the Sun StorEdge SAM-FS environment.
To invoke this display, type the following command:
TABLE 6-14 shows the control keys you can use in this display.
CODE EXAMPLE 6-17 shows the optical disk status display.
Optical disk status samu 4.2 Thu Oct 11 13:15:40 ty eq status act use state vsn mo 35 --l---wo-r 1 29% ready oper2 |
TABLE 6-15 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 6-16 shows the control keys you can use in this display.
CODE EXAMPLE 6-18 shows the removable media load requests display.
TABLE 6-17 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 6-18. |
|
TABLE 6-18 shows the flags for the p display.
The P display lists the services registered with the Sun StorEdge QFS and Sun StorEdge SAM-FS single port multiplexer.
To invoke this display, type the following command:
TABLE 6-19 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 6-19 shows the active services display.
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 6-20 shows the removable media status display.
Removable media status: all samu 4.2 09:11:27 Sept 8 2004 License: License never expires. ty eq status act use state vsn dt 150 --l------r 0 63% ready DAT001 |
TABLE 6-20 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 Sun StorEdge SAM-FS environment.
To invoke this display, type the following command:
TABLE 6-21 shows the control keys you can use in this display.
CODE EXAMPLE 6-21 shows the device status display.
TABLE 6-22 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 6-23 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 Sun StorEdge SAM-FS environment.
To invoke this display, type the following command:
TABLE 6-24 shows the control keys you can use in this display.
CODE EXAMPLE 6-22 shows the tape drive status display.
TABLE 6-25 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 6-26 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 6-27 shows the control keys you can use in this display.
CODE EXAMPLE 6-23 shows the staging queue display.
TABLE 6-28 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 6-29 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 6-24 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 6-30 shows the control keys you can use in this display.
CODE EXAMPLE 6-25 shows the automated library catalog display.
TABLE 6-31 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 6-32 for information about the flags. |
|
In some cases, more than one flag can occur in a field, and one flag overrides the other. TABLE 6-32 shows the flags from the flags field in TABLE 6-31.
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 6-33 shows the control keys you can use in this display.
CODE EXAMPLE 6-26 shows the pending stage queue.
TABLE 6-34 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 displays.
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 6-35 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 c, 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 6-36 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 6-37 defines the valid state codes.
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 operating system (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 6-38 shows the device commands and their actions.
CODE EXAMPLE 6-27 shows the formats for the device control commands.
:down eq :idle eq :off eq :on eq :unavail eq :unload eq |
For eq, specify the Equipment Ordinal of the device.
TABLE 6-39 shows the archiver commands and their actions.
CODE EXAMPLE 6-28 shows the formats for the archiver commands.
The arguments to these commands are optional. If no arguments are specified, all file systems are affected. If arguments are specified, the command takes action based on the type of archive file specified (dk or rm) or the file system specified. TABLE 6-40 shows the archiver command arguments.
Specifies that this command pertains to removable media files. |
|
Specifies that this command pertains to a specific file system. Enter a file system name for fsname. |
|
Specifies the name of a specific archive request file in the following format: This file name has three components. Use a period to separate each component. The first component is the name of the archive set. The second component is the copy number (1, 2, 3, or 4). The third component is a sequence number that the archiver assigns. More than one archive request can exist at one time. You can use the showqueue(1M) command to obtain the names of the archive request files in the system. CODE EXAMPLE 6-29 shows how to use this command. Alternatively, you can go to the following directory and list the files present: |
|
Specifies a specific directory name. This is the directory to scan. |
|
CODE EXAMPLE 6-29 shows using the showqueue(1M) command to obtain an archreq file name that can be used as input to the arrmarchreq samu(1M) command.
CODE EXAMPLE 6-29 shows that files arset1.2.0 and arset1.1.1 are archive request files.
The hwm_archive command invokes the archiver when the amount of data in the file system increases to a level above the releaser's high-water mark. You can set the releaser's high-water mark by using the thresh command. For information about the thresh command, see The :thresh eq high low Command. The nohwm_archive command disables this capability and is the default.
For eq, specify the Equipment Ordinal for the file system.
The thresh command sets the high and low thresholds for a file system to control file archiving.
For eq, specify the Equipment Ordinal of the storage family set.
For high, specify the high threshold.
For low, specify the low threshold.
For example, the following command sets the high threshold to 50 percent and the low threshold to 40 percent for the storage Family Set whose file system Equipment Ordinal is 10:
The following commands allow you to control aspects of the partial release feature. For more information about the partial release feature, see the Releasing chapter in the Sun StorEdge SAM-FS Storage and Archive Management Guide.
The maxpartial command sets the maximum partial release size for the file system to value kilobytes. The partial release size cannot be set larger than this maxpartial setting.
For eq, specify the Equipment Ordinal for the file system.
For value, specify an integer such that 0 value 2097152.
The partial command sets the number of kilobytes to leave online after release of the file. For more information, see the Releasing chapter in the Sun StorEdge SAM-FS Storage and Archive Management Guide.
For eq, specify the Equipment Ordinal for the file system.
For value, specify the number of kilobytes to leave online. The default size is 16.
The following commands allow you to control staging activities.
The partial_stage command sets the partial stage size for the file system to value kilobytes. For a file with the partial release attribute, value specifies the file offset past which access results in the entire file being staged to disk.
For eq, specify the Equipment Ordinal for the file system.
For value, specify an integer that is greater than 0 but is less than the value specified for the maxpartial setting. For more information about the maxpartial setting, see The :maxpartial eq value Command. For more information about the partial release feature, see the Releasing chapter in the Sun StorEdge SAM-FS Storage and Archive Management Guide.
The stage_flush_behind command sets the maximum stage flush-behind value. Pages being staged are written to disk asychronously to help the Solaris VM layer keep the pages clean.
For eq, specify the Equipment Ordinal for the file system.
For value, specify an integer number of kilobytes such that 0 value 8192. By default, value=0, which disables stage_flush_behind.
The stage_n_window command works with the stage(1) command's -n option. This samu(1M) command sets the stage(1) command's -n option for the file system to value. This command is effective for files read directly from the archive media and for which stage -n has been specified. For a file with the stage -n attribute set, value is the amount of data that is staged to the application's buffer at any one time.
For eq, specify the Equipment Ordinal for the file system.
For value, specify an integer such that 64 value 2097152 kilobytes. The default is 256 for all for all file systems except for the Sun StorEdge QFS shared file system, which is set to the value of the minallocsz mount option.
The stage_retries command sets the number of stage retries attempted per archive copy when certain errors are encountered.
For eq, specify the Equipment Ordinal for the file system.
For value, specify a number such that 0 value 20. When value=0, retries are not attempted. The default is 3.
The stclear command clears a stage request.
For mt, specify the media type; for information about valid media types, see the mcf(4) man page.
For vsn, specify the volume to mount.
The stidle command idles the stager. Use this command if you want the stager to finish its current tasks and not commence any additional staging.
The strun command restarts staging activity. You can use this command to restart the stager after you have issued the stidle command.
The following commands allow 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 allow 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_async option 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 StorEdge QFS shared file system. For more information about the Sun StorEdge QFS shared file system, see Sun StorEdge 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 StorEdge QFS and Sun StorEdge SAM-FS file systems. They allow 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 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 allow you to control whether direct I/O be 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 StorEdge QFS shared file systems only.
The metatimeo command sets the Sun StorEdge QFS shared file system metadata cache time out 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 15. 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 StorEdge 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 allow you to control leases, allocation sizes, and various other file system characteristics.
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 a Sun StorEdge QFS multireader file system on 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 setuid and nosetuid commands control whether setuid execution is allowed for this file system. These mount options 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 setuid(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 StorEdge 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 File System Design and see Volume Management.
The sync_meta command determine whether metadata is written to disk every time it changes. If you are using this command on Sun StorEdge 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 control media activities in an automated library.
The audit command causes the specified automated library device to mount each volume, read the VSN, and rebuild the library catalog.
If -e is specified, and the volume is on a tape cartridge, the tape skips to the end of data (EOD) and updates the space available. Note that the skip to EOD is not interruptible. Under certain conditions, it can take hours to complete.
For eq, specify the Equipment Ordinal of an automated library device.
For slot, specify the slot number containing the volume you want to load.
For side, specify the side of a magneto-optical disk. Must be 1 or 2. This argument is not applicable to tape cartridges.
This command is not supported for network-attached libraries.
The export command causes the specified automated library to export a volume to the mail slot. The volume is identified by its slot position within the automated library.
The import command causes the specified automated library to allow you to add a cartridge. For eq, specify the Equipment Ordinal of the automated library.
The load command enables you to load by either a physical or a logical identifier, as follows:
For eq, specify the Equipment Ordinal or device name.
For slot, specify the slot number containing the volume you want to load.
For side, specify the side of a magneto-optical disk. Must be 1 or 2. This argument is not applicable to tape cartridges.
For mt, specify the media type; for information about valid media types, see the mcf(4) man page.
For vsn, specify the volume to mount.
The priority command sets the load priority for a process. You can specify this command from the removable media mount requests display. For more information, see (p) - Removable Media Load Requests Display.
For pid, specify the priority shown in the p display.
For newpri, specify the priority you want to give the request. This should be an integer number.
The following commands allow 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 dtrace commands are as follows:
The dtrace commands specify various tracing options. TABLE 6-41 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 StorEdge QFS or Sun StorEdge SAM-FS 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.
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.