| Sun StorEdge SAM-FS File System Configuration and Administration Guide |    
|
| Sun StorEdge SAM-FS File System Configuration and Administration Guide |
|
| A P P E N D I X B |
|
Using the samu(1M) Operator Utility |
This chapter shows how to use samu(1M) to control the devices configured within your Sun StorEdge SAM-FS environment. Many samu(1M) displays are useful only for sites using the storage and archive management mechanism.
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 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 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 StorEdge SAM-FS environment is assigned an Equipment Ordinal (for example, 10) in the mcf(4) 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. This help screen differs depending on whether you have the Sun StorEdge QFS or the Sun StorEdge SAM-FS software installed.
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 B-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 B-1 shows the control keys you can use in the a display.
TABLE B-2 shows the control keys you can use in the :a filesystem display.
CODE EXAMPLE B-2 shows activity and statistics for a single file system in the summary display.
TABLE B-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 B-4 shows the control keys you can use in this display.
CODE EXAMPLE B-3 shows the device configuration display.
TABLE B-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 B-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 B-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 B-6 shows the device configuration display.
TABLE B-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 StorEdge SAM-FS file systems.
To invoke this display, type the following command:
CODE EXAMPLE B-7 shows the file systems display.
TABLE B-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 B-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 B-8 shows the initial help screen for the Sun StorEdge SAM-FS file system.
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 B-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 B-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 B-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 B-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 B-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 B-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 B-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 B-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 B-14 shows the m display. Member drives are indented one space and appear directly below the file system to which they belong.
TABLE B-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 B-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 B-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 B-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 B-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 B-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 B-15 shows the control keys you can use in this display.
CODE EXAMPLE B-18 shows the optical disk status display.
Optical disk status samu 4.4 Thu Oct 11 13:15:40 ty eq status act use state vsn mo 35 --l---wo-r 1 29% ready oper2 |
TABLE B-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 B-17 shows the control keys you can use in this display.
CODE EXAMPLE B-19 shows the removable media load requests display.
Removable media load requests all both samu 4.4 09:14:19 Sept 8 2005 count: 1 index type pid user rb flags wait count vsn 0 dt 15533 root 150 W--f--- 0:00 DAT001 |
TABLE B-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 B-19. |
|
TABLE B-19 shows the flags for the p display.
The P display lists the services registered with the Sun StorEdge SAM-FS single port multiplexer.
To invoke this display, type the following command:
TABLE B-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 B-20 shows the active services display.
Active Services samu 4.4 09:08:33 Sept 8 2005 Registered services for host 'pup': sharedfs.qfs2 sharedfs.qfs1 2 service(s) 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 B-21 shows the removable media status display.
Removable media status: all samu 4.4 09:11:27 Sept 8 2005 ty eq status act use state vsn dt 150 --l------r 0 63% ready DAT001 |
TABLE B-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 B-22 shows the control keys you can use in this display.
CODE EXAMPLE B-22 shows the device status display.
TABLE B-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 B-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 B-25 shows the control keys you can use in this display.
CODE EXAMPLE B-23 shows the tape drive status display.
TABLE B-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 B-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 B-28 shows the control keys you can use in this display.
CODE EXAMPLE B-24 shows the staging queue display.
TABLE B-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 B-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 B-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 B-31 shows the control keys you can use in this display.
CODE EXAMPLE B-26 shows the automated library catalog display.
TABLE B-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 B-33 for information about the flags. |
|
TABLE B-33 shows the flags from the flags field in TABLE B-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 B-34 shows the control keys you can use in this display.
CODE EXAMPLE B-27 shows the pending stage queue.
TABLE B-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 B-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 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 B-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 B-38 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 B-39 shows the device commands and their actions.
All of these commands are used in the following format: :command eq. For eq, specify the Equipment Ordinal of the device.
TABLE 0-1 shows the archiver commands and their actions.
CODE EXAMPLE 0-1 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 0-2 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 0-2 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 0-2 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 0-2 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 enable 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 enable 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 asynchronously 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 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.
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 SAM-FS 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 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 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 StorEdge QFS AIO only. These mount options disable or enable ABR of software mirrors. They apply only to Sun StorEdge 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 RAC environment with Sun StorEdge QFS AIO only. These mount options disable or enable DMR of software mirrors. They apply only to Sun StorEdge 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 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 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 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 Design Basics and see System Configuration Tasks.
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 enable 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 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 B-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 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.
| Sun StorEdge SAM-FS File System Configuration and Administration Guide | 819-4333-10 |
|
Copyright © 2006, Sun Microsystems, Inc. All Rights Reserved.
To Invoke samu(1M)
