Reference Contents
Concat Information window
The Concat Information window provides a way to
view and modify a specific concatenated metadevice's
attributes and slices.
The Concat Information window contains:
Device Name
Enables you to type the name of a device
to use as a concat/stripe metadevice (d10,
for example).
The Device Name text field becomes read-write
as long as the concat/stripe is not open.
NOTE: If there is no device name, the window displays
an Attach button to enable attaching a device.
Status
Displays the status of the concatenated metadevice
(for example, "OK").
Size
Displays the size of the concatenated metadevice
(for example, "54.60 Mbyte").
Use
Shows how the concatenated metadevice is currently used
(for example, "Unassigned").
Hot Spare Pool
Displays the name of the hot spare pool associated
with the concatenated metadevice listed in the
Device Name field.
Remove/Attach (buttons)
If no hot spare pool is assigned, DiskSuite Tool
displays the Attach button. If a hot spare is assigned,
DiskSuite Tool toggles the Attach button to Remove.
Info...
Displays the Hot Spare Pool Information window.
Show Stripes (radio button toggle)
The Show Stripes toggle button hides or shows a scrolling
list of all striped metadeviced metadevices associated
with the concatenated metadevice named in the Device
Name field.
A label adjacent to the toggle shows the number of
striped metadeviced metadevices in the concatenated
metadevice.
--- Scrolling list --------------------------
The scrolling list shows the name, size, and status
for each striped metadevice associated with the
concatenated metadevice named in the Device Name field.
Stripe
Displays the name of the striped metadevice (for example,
"0").
Size
Displays the size of the striped metadevice (for example,
"54.60 Mbyte").
Status
Displays the current status of the striped metadevice
(for example, "Critical").
-------------------------------------------
Attach
Adds a new striped metadevice to the end of the
scrolling list.
Remove
Removes a striped metadevice from the scrolling list.
Info...
Displays the Stripe Information window.
Close
Dismisses the window.
Help
Displays online help for the window.
The Configuration Log Window
The Configuration Log Window logs DiskSuite
operations and errors.
The Configuration Log window contains:
File Menu
---------
Clear
Clears log entries.
Log to File...
Opens a log file for all current and subsequent
configuration log entries
Close
Dismisses this window
---- Logging to File Scrolling List -----------------
The scrolling list contains a log (history) of all
DiskSuite Tool operations. Each log entry has a time stamp.
Help button
-----------
Displays online help for the window.
The Controller Information window
The Controller Information window displays
information about a disk's controller.
The Controller Information window contains:
Device Name
Names the controller (for example, c0).
Fan Status
Displays the current fan status (for example,
FAILED).
Battery Status
Displays the current battery status (for example,
FAILED).
Vendor
Displays the vendor name.
Product ID
Displays the product identification number.
Product Rev
Displays the product revision number.
Firmware Rev
Displays the product firmware revision information.
Serial Number
Displays the product serial number.
Show Disks
Toggles on and off the disk information pane.
Device Mappings
Displays the Physical to Logical Device
Mapping window. The Physical to Logical
Device Mappings window is not dynamically
updated when new mappings are created.
[Disk Information Scrolling List]
Contains a scrolling list of all disks,
their size and status, on the controller.
Info...
Selecting a disk in the disk information pane
and clicking on the Info... button displays
the Disk Information window for that disk.
-----Buttons-----
Close
Dimisses the window.
Help
Displays online help for the window.
The Device Statistics window
The Device Statistics window displays statistical
information about a specific device. All information
is read-only.
The Device Statistics window contains:
Top Pane
--------
Device Name
Names the device (for example, c0t3d0).
Info... (button)
Displays an information window for the device.
Center Pane
-----------
Displays statistics for the device. Statistics
are presented in percentages. The statistical
information is identical to that provided by the
iostat(1M) command with the -x option.
Raw Thruput
Totals:
Reads:
Writes:
Derived Values
Avg Wait Queue Length:
Avg Service Time (msec):
Wait Probability:
Load:
Add Device to Statistics Graphs Window (button)
Adds the current device to the scrolling list
in the Statistics Graphs window.
Update (button)
Updates the Device Statistics window information.
Bottom Pane
-----------
Close Dismisses the window.
Help Displays online help for the window.
The Disk Information window
The Disk Information window displays information
about a specific disk. All information is read-only.
The Disk Information window contains:
Device Name
Names the disk.
Status
Shows the current status of the disk.
Type
Shows the type of disk.
In Use
Shows the percentage of the disk
currently in use.
Capacity
Shows the usable capacity of the disk.
The usable capacity of the disk is the disk
capacity less any space taken by state database
replicas or the disk label.
Unallocated
Shows the unallocated percentage of the disk.
Size
A pull-down menu to set the size options
for the slices listed in the window and
the Capacity field.
Controller Information...
Displays the Controller Information window
for the disk controller.
Device Mappings...
Displays the Physical to Logical Device
Mappings window. The Physical to Logical
Device Mappings window is not dynamically
updated when new mappings are created.
Show Slices
Toggles on or off the information about the
slices in the disk.
Slice Information...
Selecting a slice, then clicking on this button
displays the Slice Information window for the
selected slice.
Center Pane (Slice Information)
------------------------------
The center pane displays graphic information for
all 8 slices of the disk.
-----Buttons-----
Close Dismisses the window.
Help Displays online help for the window.
The Disk View window
The Disk View window graphically displays
logical-to-physical device mapping.
The Disk View window includes:
Basic Operation
---------------
You can drag-and-drop objects in the Metadevice
Editor window to the Disk View window to establish
color mappings between physical and logical devices.
Title Bar
---------
The top bar contains the version of DiskSuite
Tool and the host name. It also displays the
diskset information, either for a local
diskset, or the name of the shared diskset.
Canvas
----------
The center viewing area where physical mappings are
displayed. The canvas has scrollbars to control what
part of a display you can see.
The canvas displays controllers with their associated
disks. In addition, if you have a SPARCstorage Array
online, the Disk View canvas displays iconic information
about the current status of the SPARCstorage Array.
SPARCstorage Array Information
-----------------------------
Fibre-channel icon represents the SPARCstorage Array
controller.
World Wide Number: The Disk View canvas displays the last
four numbers of the SPARCstorage Array's World Wide
identification number just below the controller icon.
To see the whole 12-digit World Wide Number, display the
Controller Information window for the array.
Frames around disks: SPARCstorage Array trays.
(SPARCstorage Array 100 has a frame-within-a-frame)
(SPARCstorage Array 200 shows just the disks within
the tray frame, with no SCSI bus in the tray.)
Down-arrow icon represents stopped disks.
Wrench icon signals "needs maintenance."
Wrench and fan icons signal a failed fan or too
high temperatures.
Wrench and battery icons signal low NVRAM battery.
Note: The Controller Information window also displays
information on failures.
SPARCstorage Array Pop-Up Menu
-----------------------------
You can display a pop-up menu for a SPARCstorage
Array tray, for a disk within the tray, or for
a slice within a disk.
The pop-up menus for trays, disks, and slices are
the same:
-Info...
Displays an information window for the object.
-Device Mappings...
Displays the Physical To Logical Device Mappings window.
-Statistics...
Displays the Device Statistics window.
-Purge NVRAM
Purges fast write data NVRAM.
(Normally, you use this feature only if you cannot
get access to the SPARCstorage Array. Otherwise, use
Object --> Sync Cache to flush all outstanding writes
for the selected controller.)
-Sync NVRAM
Flushes all outstanding writes for the selected object.
-Fast Write
- The fast write feature increases write performance
by using the NVRAM in a SPARCstorage Array.
The submenu selections are:
Disable: to disable the fast write feature.
Enable: to enable the fast write feature.
Synchronous: to enable synchronous fast writes.
-Reserve Disks
Reserves a disk for exclusive use by a host.
No other host can use the disk until the disk is
released from the host.
If DiskSuite Tool is run on a host other than
the host issuing the reserve command, a status
of "Reserved" is shown for those disks in the
Information window, and a "lock" icon appears
under the disks in the Disk View canvas.
-Release Disks
Releases a disk from exclusive use by a host.
-Start Disks
Starts disks in a tray.
-Stop Disks
Stops disks in a tray.
NOTE: For SPARCstorage Arrays you must stop all the
disks in a tray to stop one. Normally, then, you would:
-Unmount all file systems on the disks in the tray
-Stop all applications that access the disks in the tray
-Stop the disks
Legend/Color Drop Sites
-----------------------
The bottom part of the Disk View window contains
the Legend, an area that includes color drop sites.
The color drop sites enable you to map physical-to
-logical associations by colors.
For example, to see all the slices that contain state
database replicas, drag the MetaDB object from the
Metadevice Editor window to a color drop site.
DiskSuite Tool will use that color for all slices that
contain state databases replicas.
-Getting Information
To get information on a color drop site, position
the mouse over the drop site and click the third
button. Select Info... from the pop-up menu to
display information windows.
-Clearing Color Drop Sites
To clear the color drop site (return it to the
"unassigned" status), position the mouse over the
drop site and click the third button. Select Clear
from the pop-up menu.
Toggling the Legend/Color Drop Sites
The Legend can be toggled on and off by the
View --> Show Legend menu selection.
NOTE: On a monochrome monitor black is the
"drop site," white represents the available slices,
and gray represents the rest of the slices.
-Filtering
The Set Filters button displays the Disk View Slice
Filters window, which enables you to set filtering
criteria for objects on the Disk View canvas.
Controllers
-----------
A scrolling list of all controllers in the current
configuration. The list contains buttons that you can
click to display a controller's disks on the canvas.
To display all the controllers at once, use the
View --> View All Controllers menu selection.
Panner
-------
Located in the bottom right corner, the Panner serves
as a virtual canvas, enabling quick navigation of the
canvas. In addition, the Panner serves as a drop site
for objects.
Message Area
------------
The Disk view window displays information and status
messages at the bottom left of the window.
----Disk View Menus----
File Menu
----------
File --> Rescan Configuration
Rescans the current configuration for physical
devices and metadevices.
File --> Close
Dismisses the Disk View window.
Object Menu
-----------
Object --> Info...
Displays information about which object is used
by the selected slice or disk.
Object --> Device Mappings...
Displays the Physical to Logical Device Mappings window.
Object --> Statistics...
Displays the Device Statistics window.
Objects --> Sync NVRAM
Flushes outstanding writes to the media from the
NVRAM in a SPARCstorage Array.
Objects --> Fast Write
The fast write feature increases write performance by
using the NVRAM in a SPARCstorage Array.
The submenu selections are:
Disable: to disable the fast write feature.
Enable: to enable the fast write feature.
Synchronous: to enable synchronous fast writes.
Objects --> Reserve Disks
Reserves all disks in a SPARCstorage array for a
particular host.
Objects --> Release Disks
Releases all disks in a SPARCstorage array for a
particular host.
Objects --> Start Disks
Brings online all disks.
Objects --> Stop Disks
Takes offline all disks.
View Menu
---------
View --> View All Controllers
Displays all controllers and their associated disks
on the canvas.
View --> Put Away All Controllers
Puts all controllers and their disks back into the
Controllers list.
View --> Clear All Drop Sites
Returns all color drop sites to Unassigned and
removes any mappings from the Disk View canvas.
View --> Show Legend
Toggles on and off the Legend area of the window.
View --> 50 Percent
Sets the zooming feature to 50 percent.
View --> 100 Percent
Sets the zooming feature to 100 percent.
View --> 200 Percent
Sets the zooming feature to 200 percent.
View --> Replica Slice
Collapses all disks to a view of slice 0. This feature
enables faster selection and drag-and-dropping of disks
in disksets.
Tools Menu
----------
The Disk View window can be configured to display a "Tools" menu.
The Tools menu can be configured to launch other applications,
such as AdminSuite Storage Manager, from DiskSuite Tool. See
the metatool-toolsmenu(4) man page for more information on
configuring this menu.
The Disk View Slice Filters window
The Disk View Slice Filters window enables you
to set filtering criteria for objects on the
Disk View canvas.
The Disk View Slice Filters window contains:
Use
-----
This area contains three radio buttons that
enable you to filter information shown in the
Disk View window.
Available for use as
Filters all disks and slices available for use as:
Anything
Hot Spare
Replica
Metadevice Component
Trans Log
Use the pull-down menu to select a criterion.
Currently in use as
Filters all disks and slices currently in-use use as:
Anything
File System
Swap
Replica
Metadevice Component
Hot Spare
Trans Log
Use the pull-down menu to select a criterion.
Don't care
The default setting, it sets filtering to
ignore the Use options.
Device Name
-----------
A toggle button to filter slices by regular expressions
that you type in the text field.
Size
-------
A toggle button to filter by integer and float (decimal)
values that you type in the text field.
Disk Type
-----------
A toggle button to filter by type of disk.
Broken
-------
A toggle button to filter by broken devices (slices
or disks with errors).
-----Buttons-----
OK Applies the criteria you have selected and
dismisses the window.
Apply Applies the criteria you have selected, but
does not dismiss the window.
Cancel Cancels all operations in this window and
dismisses the window.
Help Displays online help for this window.
The Find window
The Find window locates an object in the Metadevice
Editor window and places top-level matching devices
on the canvas.
Found objects are added or moved to the upper left
corner of the canvas.
You can search for an object by its name or mount point.
The Find window contains:
Device Name:
A text field for typing the name of a slice or
metadevice name.
Mount Point:
A text field for typing the name of a mount point.
-----Buttons-----
Find
Performs the search for the specified name or
mount point.
Cancel
Cancels all operations in the Find window and
dismisses the window.
Help
Displays online help for the current window.
The Hot Spare Pool Browser window
The Hot Spare Pool Browser window contains
Menus
---------
File Menu
--------
File --> Close
Dismisses the Hot Spare Pool Browser window.
Filters Menu
-----------
Filters --> On
Turns filters on.
Filters --> Off
Turns filters off.
Filters --> Set Filters...
Displays the Hot Spare Pool Filters window.
View Menu
---------
Sorts hot spare pools in the scrolling list
by the criteria:
Ascending
Descending
By Name
By Number of Spares
By Spares in Use
---- Scrolling List ----------------------
Device Name
Displays the name of the hot spare pool
(for example, "hsp000").
Min Size
Displays the minimum size of the hot
spare pool (for example, "2.00 Mbyte").
Max Size
Displays the maximum size of the hot
spare pool (for example, "16.00 Mbyte").
Spares
Displays the number of hot spares in the
hot spare pool (for example "5").
Spares In Use
Displays the number of hot spares currently
used by the hot spare pool (for example, "0").
Status
Displays the current status of the hot spare
pool (for example, "OK").
Select All
Selects all items in the scrolling list.
Toggles to Deselect All to enable you to
deselect all items in the scrolling list
after they are all selected.
The Hot Spare Pool Filters window
The Hot Spare Pool Filters window enables you to set
filtering criteria for the Host Spare Browser window.
Device Name
Activates the adjacent pull-down option menu
and text field.
The text field accepts any regular expression.
Size
Activates the adjacent pull-down option menus
and text field.
The text field accepts integer and float (decimal)
values.
Spares in Use
Filters for hot spare pools with hot spares
currently in use.
Broken Spares
Filters for any hot spare pool with a broken
hot spare.
-----Buttons-----
OK Applies the criteria you have selected and
dismisses the window.
Apply Applies the criteria you have selected, but
does not dismiss the window.
Cancel Cancels all operations in this window and
dismisses the window.
Help Displays online help for this window.
The Hot Spare Pool Information window
The Hot Spare Pool Information window provides a
way to view and modify a specific hot spare pool's
attributes.
The Hot Spare Pool Information window contains:
Device Name
Displays the name of the hot spare pool
(for example, hsp001).
Status
Displays the current status of the hot spare
pool (for example, OK).
Smallest
Displays the size of the smallest slice in the
hot spare pool (for example, 16.62 Mbyte).
Largest
Displays the size of the largest slice in the
hot spare pool (for example, 16.62 Mybte).
Associated With:
Shows information about the metadevice(s) with
which the hot spare slice is associated.
Info...
Displays an information window for the metadevice
currently selected in the Associated With:
scrolling list
Show Hot Spare
Toggles on or off the scrolling list of slices used
by the currrent hot spare pool.
---- Scrolling list --------------------
Slice
Shows the name of the slice used as a hot spare
(for example, c0t0d0s1).
Size
Displays the size of the hot spare slice (for
example, 327.00 Mbyte).
Status
Displays the current status of the hot spare
slice (for example, OK).
---------------------------------------
Enable
Brings a hot spare back online.
Remove
Removes from the hot spare pool the currently
selected hot spare slice.
Info...
Displays an information window for the currently
selected hot spare slice.
Slice
Enables you to type the name of a hot spare
slice to attach or replace.
Attach
Attaches the hot spare slice specified in
the Slice text field. Attaching adds the
slice to the hot spare pool.
Replace
Enables you to replace the currently selected
slice with the component in the Slice
text field.
Close
Dismisses the window.
Help
Displays online help for the window.
The Log to File window
The Log to File window enables you to save
the current Problem List window data to disk.
The Log to File window contains:
Filter
A text field into which you can type a new path.
Directories
A scrolling list of directories.
Double-clicking on a directory enters that
directory name in the Selection field.
Files
A scrolling list of files.
Selection
A text field into which you can type the name
of a directory or file.
-----Buttons-----
OK
Applies the criteria you have selected and
dismisses the window.
Filter
Applies the filtering criteria you entered
in the Filter field.
Cancel
Cancels all operations in this window and
dismisses the window.
Help
Displays online help for the window.
The Mapping Selector window
The Mapping Selector window enables you to
select a color for an object when:
- All color drop sites are currently assigned
- You drop an object from the Metadevice Editor
window into the DiskView window
The Mapping Selector window contains:
Color Buttons
------------
Clicking on the radio button next to a color
assignment selects that color to assign to
an object.
-----Buttons-----
OK
Applies the criteria you have selected and
dismisses the window.
Cancel
Cancels all operations in this window and
dismisses the window.
Help
Displays online help for the window.
The Metadevice Browser window
The Metadevice Browser window contains:
-----Menus-----
File Menu
File --> Close
Dismisses the Metadevice Browser window.
Filters Menu
Filters --> On
Activates any filters you have set in the
Metadevice Filters window.
Filters --> Off
Deactivates any filters you have set in the
Metadevice Filters window.
Filters --> Set Filters...
Displays the Metadevice Filters window.
View Menu
View --> Ascending
Sort scrolling list in ascending order.
View --> Descending
Sort scrolling list in descending order.
View --> By Name
Sort scrolling list by metadevice name.
View --> By Size
Sort scrolling list by metadevice size.
View --> By Type
Sort scrolling list by metadevice type.
View --> By Use
Sort scrolling list by metadevice usage.
---- Scrolling List ---------------------
Device Name
Displays the name of the metadevice (for
example, d0).
Size
Displays the size of the metadevice (for
example, 26.00 Mbyte).
Type
Displays the metadevice type (for example,
Concat/Stripe).
Status
Displays the status of the metadevice (for
example, OK).
Use
Displays the current use of the metadevice
(for example, Submirror).
Select All
Selects all items in the scrolling list. Toggles to
Deselect All to enable you to deselect all items in
the scrolling list after they are all selected.
Message Area (bottom left)
--------------------------
Filters: Off/On
Lets you know whether the filtering criteria set
in the Metadevice Filters window are on or off.
The Metadevice Editor window
The Metadevice Editor window serves as the main working
area for DiskSuite Tool. In this window you can create
all the objects you need to manage your disks.
The Metadevice Editor window includes:
Title Bar
----------
The top bar contains the version number of DiskSuite
Tool, the host name in brackets, and the diskset
name in angle brackets.
Canvas
----------
The center area (the canvas) serves as a drop target
for devices dragged from browser windows.
Scroll bars on the right and bottom control how much
of the configuration you can view.
The scroll bars determine what part of the
configuration is visible. Changing the size
of the entire window changes how much of
the configuration is visible.
Menus
----------
File Menu
File --> Save To File...
Saves the current configuration information
to a disk file.
File --> Restore From File...
Loads configuration information from a disk file.
File --> Rescan Configuration
Rescans the current configuration for changes in
physical devices and metadevices.
File --> Exit
Exits the Metadevice Editor window.
Object Menu
Object --> Info...
Shows information about the object(s)
in the Metadevice Editor window.
Object --> Statistics...
Displays the Device Statistics window for the
object(s) on the canvas.
Object --> Expand
Expands (magnifies) the view of the
object(s) in the Metadevice Editor window.
Object --> Collapse
Collapses (minimizes) the view of the
object(s) in the Metadevice Editor window.
Object --> Evaluate
Evaluates the status of the object(s). If there
are any errors or warnings, the Configuration Log
window displays them.
Object --> Put Away
Moves the object(s) on the canvas back
to the Objects list.
Object --> Commit
Saves changes made to the object(s) and updates
the configuration status.
Edit Menu
Edit --> Undo Last
Reverses the last unsaved change to the current configuration.
Edit --> Undo All
Reverses all unsaved changes made to the current configuration.
Edit --> Duplicate
Copies the currently selected objects and places the duplicates
next to the originals.
Edit --> Delete
Deletes the selected objects from the current configuration.
Edit --> Create
Uses the following submenus to create:
Trans metadevices
Edit --> Create --> Trans
RAID5 metadevices
Edit --> Create --> RAID
Mirrors
Edit --> Create --> Mirror
Concatenated and striped metadevices
Edit --> Create --> Concat/Stripe
Hot spare pool objects
Edit --> Create --> Spare Pool
Edit --> Select All
Selects all objects on the canvas.
Edit --> Clean Up Canvas
Arranges objects on the canvas in a grid.
Browse Menu
Browse --> Disk View...
Displays the Disk View window, which enables you to view
the relations between logical and physical devices.
Browse --> Statistics Graphs...
Displays the Statistics Graphs window.
Browse --> Slices...
Displays the Slice Browser window, which presents information
on slice usage in the current configuration.
Browse --> Metadevices...
Displays the Metadevice Browser window, which presents information
on the metadevices in the current configuration.
Browse --> Hot Spare Pools...
Displays the Hot Spare Pool Browser window, which presents
information on the hot spare pools in the current configuration.
Browse --> Find...
Displays the Find window, which enables you to find an object
in the Metadevice Editor window by name or mount point.
Browse --> Configuration Log...
Displays the Configuration Log window, which lists all
configuration messages.
Browse --> Problem List...
Displays the Problem List window, which lists all
current DiskSuite object errors. This list is updated
each time a change in DiskSuite status occurs.
Help Menu
Help --> On Help...
Explains how to use the online help in DiskSuite Tool.
Help --> On Window...
Displays online help for a window.
Tools Menu
DiskSuite Tool can be configured to display a "Tools" menu.
The Tools menu can be configured to launch other applications,
such as AdminSuite Storage Manager, from DiskSuite Tool. See
the metatool-toolsmenu(4) man page for more information on
configuring this menu.
Buttons
--------
Disk View...
Displays the Disk View window, which shows the
relations between physical and logical devices.
Slices...
Displays the Slice Browser window, which shows information
about the slices used in the current configuration.
Commit
Updates the state database with the current state of
the configuration.
Also evaluates the configuration for errors and displays
the evaluation results in the Configuration Log window.
Put Away
Puts the selected object back into the Objects list.
Objects:
--------
A scrolling list that enables you to view all the
objects currently in the configuration.
The pull-down menu in the Objects list filters the
list of objects by the criteria:
All
Metadevices
Hot Spare Pools
Problems
For each object the Objects list displays:
Name
Type
Status and problem severity
Current use
To view all the fields, you can scroll the list
vertically and horizontally.
Templates
----------
This area contains clickable icons that enable quick
creation of the 5 basic DiskSuite objects:
Trans metadevices
RAID5 metadevices
Mirrors
Concat/Stripe objects
Hot Spare Pool objects
Clicking on a icon creates a new, empty object and places
it on the canvas. Some icons can also be dragged and
dropped on the canvas, or dropped on existing objects.
Panner
----------
Located in the bottom right corner, the Panner serves
as a virtual canvas, enabling quick navigation of the
canvas. In addition, the Panner serves as a drop site
for objects.
Message Area
------------
The Metadevice Editor window displays information and status
messages at the bottom left of the window.
The Metadevice Filters window
The Metadevice Filters window enables you to set
filtering criteria for the Metadevice Browser window.
The Metadevice Filters window contains:
Use
Available for use as
Filters all metadevices available for use as:
Anything
Submirror
Trans Log
Trans Master
Currently in use as
Filters all metadevices currently in-use as:
Anything
File System
Swap
Trans Log
Trans Master
Metadevice Component
Submirror
Don't Care
Sets filtering to ignore the Use options.
Device Name
-----------
A toggle button to filter slices by regular
expressions that you type in the text field.
The text field accepts regular expressions
with "*" and "?" wildcard characters.
Size
------
A toggle button to filter by integer and float (decimal)
values that you type in the text field.
Type
------
A toggle button to filter by type of metadevice.
The pull-down menu sets filtering for all metadevices.
Broken
--------
A toggle button to filter by broken metadevices
(metadevices with errors).
-----Buttons-----
OK Applies the criteria you have selected and
dismisses the window.
Apply Applies the criteria you have selected, but
does not dismiss the window.
Cancel Cancels all operations in this window and
dismisses the window.
Help Displays online help for this window.
The Metadevice State Database Information
window
The Metadevice State Database Information
window contains the following elements:
Status
Displays the current status of the
metadevice state database (for example,
"OK").
Replicas
A scrolling list that displays the replicas
used by the current configuration.
---- Scrolling List --------------------
Slice
Names the slice that contains a state
database replica (for example, c0t1d0s2).
Used
Displays disk space used by the state
database replica (for example, 270.00 Kbyte).
Available
Displays disk space remaining on the slice
(for example, 53.66 Mbyte).
Replicas
Displays the number of replicas contained on
the slice (for example, 1).
Replica Status
Displays the current status of the slice
(for example, OK).
-----------------------------------------
Restore
Restores a slice. The Restore button is enabled
only if a selected slice does not display the
"OK" status.
Clicking on Restore causes DiskSuite Tool to
first take the selected slice out of the
metadevice state database, then attempt to
restore it to the state database.
If the restore succeeded, the slice reverts
to the "OK" status. If the restore did not
succeed, DiskSuite Tool does not permit the
slice to be part of the metadevice state
database.
NOTE: You do not need to click on the Commit
button (in the Metadevice Editor window)
to "restore" the slice. The restore operation
takes place immediately.
Remove
Removes a slice from the state database.
Info...
Displays the Slice Information window
for the currently selected slice.
Slice
Enables you to type the name of a slice
to attach or replace.
Replicas
Enables you to type the number of replicas
to create on the slice specified in the
Slice text field. (The default value is 1.)
Attach
Adds the slice in the Slice text field to
the scrolling list.
Replace
Replaces the selected slice with the slice
in the Slice text field.
NOTE: When replacing a slice, make sure the
number of replicas on the new slice equals
the number of replicas on the replaced slice.
----Buttons-----
Close
Dimisses the window.
Help
Displays online help for the window.
The Mirror Information window
The Mirror Information window displays information
about a specific mirror.
The Mirror Information window contains:
Device Name
Enables you to type the name of a device
to use as a mirror metadevice.
The Device Name text field becomes read-write
as long as the mirror is not open.
Status
Shows the current status of the mirror
(for example, OK).
Size
Shows the size of the mirror (for example,
979.54 Mbyte).
Use
Shows usage information (for example, /usr).
Pass
Shows the current pass number and enables
selecting a new pass number from the pull-
down menu.
Read Option
Shows the current read option and enables
selecting a new read option from the pull-
down menu.
Read options are:
Round Robin
Geometric
First
Write Option
Shows the current write option and enables
selecting a new write option from the pull-
down menu.
Write options are:
Parallel
Serial
Show Submirrors
Toggles on or off the information about the
devices in the mirror.
Center Pane (Slice Information)
------------------------------
The center pane contains a scrolling list of
all the devices in the mirror.
There are four fields:
Device Names the device.
Type Names the device type.
Size Names the device size.
Status Names the device status.
-----Buttons-----
Online Brings online a submirror selected
in the scrolling list.
Offline Takes offline a submirror selected
in the scrolling list.
Remove Removes a submirror selected in the
scrolling list.
Info Displays an information window for a
submirror selected in the scrolling
list.
Device: A text-entry field for typing in a
submirror name.
Attach Attaches the submirror specified in the
Device: field to the mirror.
Replace Replaces the submirror selected in the
scrolling list with the submirror
specified in the Device: field.
Close Dismisses the window.
Help Displays online help for the window.
The Physical to Logical Device Mappings
window
The Physical to Logical Device Mappings
window shows how physical devices correspond
to logical devices (metadevices).
Device
Names the current device (for example,
c0t3d0).
---- Scrolling list -----------------------
Shows metadevices that currently use the
device named in the Device text field.
The scrolling list contains information for:
Name
Size
Type
Status
Use
Slices Used
You can double-click on any item in the scrolling
list to get information on the item.
-----Buttons-----
Select All
Selects all items in the scrolling list.
Toggles to Deselect All to enable you to
deselect all items in the scrolling list
after they are all selected.
Close
Dismisses the window.
Help
Display online help for the window.
The Problem List window
The Problem List window logs DiskSuite operations
and errors.
The Problem List window contains:
File Menu
---------
File --> Rescan Configuration
Rescans the current configuration for changes
in physical devices and metadevices.
File --> Log to File...
Displays the Log To File window, enabling you
to save to disk a log file for all current and
subsequent Problem List data.
Close
Dismisses this window
---- Logging to File Scrolling List -----------------
The scrolling list contains a log (history) of all
problems reported by DiskSuite. Each log entry has
a time stamp and a brief description of the problem.
The Raid Information window
The Raid Information window displays information
about a specific RAID5 metadevice.
The Raid Information window contains:
Device Name
Enables you to type the name of a device
to use as a RAID5 metadevice.
The Device Name text field becomes read-write
as long as the RAID5 metadevice is not open.
Attach (button)
Sets the name of the RAID5 metadevice.
Status
Shows the current status of the RAID5 metadevice
(for example, OK).
Size
Shows the size of the RAID5 metadevice (for example,
979.54 Mbyte).
Use
Shows usage information (for example, as a Trans Master).
Hot Spare Pool
Displays the name (if any) of the hot spare pool
associated with the current RAID5 metadevice.
Remove/Attach
Enables you to remove (disassociate) or attach
(associate) the hot spare pool from the current
RAID5 metadevice.
Info...
A button that displays the Hot Spare Pool Information
window.
Interlace
Displays the default interlace value for striping
the RAID5 metadevice.
You can type a custom interlace value also (in the
Custom text field) and click on the Attach button to
set the new value.
Attach
Sets (attaches) the interlace value for the
RAID5 metadevice.
[Scrolling list]
A list of all the slices currently used by the
RAID5 metadevice. The scrolling list contains:
Slice Displays the slice name.
Size Displays the slice size.
Replicas Displays the number of replicas
on the slice.
Status Displays the current status of
the slice.
-----Buttons-----
Enable Brings online a RAID5 slice selected
in the scrolling list.
Remove Removes a RAID5 slice selected in the
scrolling list.
Info Displays the Slice Information window for
a slice selected in the scrolling list.
Slice: A text-entry field for typing in a slice
name to be added to RAID5 metadevice.
Attach Attaches the slice specified in the
Slice: field to the RAID5 metadevice.
Replace Replaces the slice selected in the scrolling
list with the slice specified in the
Slice: field.
Close Dismisses the window.
Help Displays online help for the window.
The Restore From File window
The Restore From File window enables you to
restore the current configuration file from disk.
The Restore From File window contains:
Filter
A text field into which you can type a new path.
Directories
A scrolling list of directories. Double-clicking
on a directory enters that directory name in the
Selection field.
Files
A scrolling list of files.
Selection
A text field into which you can type the name
of a directory or file.
-----Buttons-----
OK
Applies the criteria you have selected and
dismisses the window.
Filter
Applies the filtering criteria you have in the
Filter field.
Cancel
Cancels all operations in this window and
dismisses the window.
Close
Dimisses the window.
Help
Displays online help for the window.
The Save To File window
The Save To File window enables you to save
the current configuration file to disk.
The Save To File window contains:
Filter
A text field into which you can type a new path.
Directories
A scrolling list of directories.
Double-clicking on a directory enters
that directory name in the Selection field.
Files
A scrolling list of files in the current
directory.
Selection
A text field into which you can type the name
of a directory or file.
-----Butttons-----
OK
Applies the criteria you have selected and
dismisses the window.
Filter
Applies the filtering criteria you have typed
in the Filter field.
Cancel
Cancels all operations in this window and
dismisses the window.
Help
Displays online help for the window.
The Slice Browser window
The Slice Browser window provides a centralized
working area for all the slices in the current
configuration.
The Slice Browser window includes:
Title Bar
----------
The top bar contains the host name in brackets,
and the diskset name in angle brackets.
Menus
----------
File Menu
File --> Close
Exits the Slice Browser window.
Filters Menu
Filters --> On
Sets filtering criteria in the Slice Filters
window to on.
Filters --> Off
Sets filtering criteria in the Slice Filters
window to off.
Filters --> Set Filters...
Displays the Slice Filters window.
View Menu
View --> Ascending
Sort scrolling slice list in ascending order.
View --> Descending
Sort scrolling slice list in descending order.
View --> By Name
Sort scrolling slice list by slice name.
View --> By Size
Sort scrolling slice list by slice size.
View --> By Disk Type
Sort scrolling slice list by disk type.
View --> By Use
Sort scrolling slice list by slice usage.
Help Menu
Help --> On Help...
Explains how to use the online help in
DiskSuite Tool.
Help --> On Window...
Displays online help for a window.
Scrolling slice list fields
---------------------------
Device Name
Displays the name of the slice (for example, c3t3d0s2).
Size
Displays the size of the slice (for example,
980.96 Mbyte).
Disk Type
Displays the type of disk to which the slice belongs
(for example, SUN0424).
Status
Displays current status of the slice (for example, OK).
Use
Displays slice usage information (for example,
(Meta DB Replica).
Buttons
--------
Select All
Selects all slices in the scrolling slice list.
Deselect All (toggles from Select All)
Deselects all slices in the scrolling slice list.
Message Pane (bottom left)
-------------------------
Filters: On/Off
Signals that filtering criteria set in the Slice
Filters window are on or off.
The Slice Filters window
The Slice Filters window enables you to set filtering
criteria for objects in the Slice Browser window.
The Slice Filters window contains:
Use
-----
This area contains three radio buttons that
enable you to filter information shown in the
Slice Browser window.
Available for use as
Filters all disks and slices available for use as:
Anything
Hot Spare
Replica
Metadevice Component
Trans Log
Use the pull-down menu to select a criterion.
Currently in use as
Filters all disks and slices available for use as:
Anything
File System
Swap
Replica
Metadevice Component
Hot Spare
Trans Log
Use the pull-down menu to select a criterion.
Don't care
The default setting, it sets filtering to
ignore the Use options.
Device Name
-----------
A toggle button to filter slices by regular expressions
that you type in the text field.
Use the pull-down to select matches or does not match.
Size
-------
A toggle button to filter by integer or float (decimal)
values that you type in the text field.
Use the first pull-down to select from, greater than, less
than, equal to, or not equal to.
Use the second pull-down to select Gbytes, Mbytes, Kbytes,
or sectors.
Disk Type
-----------
A toggle button to filter by type of disk.
Use the pull-down to select from available disk types.
Broken
-------
A toggle button to filter by broken devices (slices
or disks with errors).
-----Buttons-----
OK Applies the criteria you have selected and
dismisses the window.
Apply Applies the criteria you have selected, but
does not dismiss the window.
Cancel Cancels all operations in this window and
dismisses the window.
Help Displays online help for this window.
The Slice Information window
The Slice Information window displays information
about a specific slice.
The Slice Information window contains:
Device Name
Shows the name of the slice (for example, "c0t0d0s0").
Status
Shows the current status of the slice
(for example, "OK").
Size
Shows the size of the slice (for example,
"26.00 Mbyte").
Start Block
Shows the starting block number for the
slice (for example "0"). If the slice has
a label, DiskSuite Tool displays the
starting point for it.
End Block
Shows the ending block for the slice
(for example, "52347").
Use
Show the current usage of the slice (for example,
"Unassigned").
Number of Replicas
Displays the number of state database replicas
associated with the slice.
-----Buttons-----
Enable
Brings a slice back online.
Disk Information...
Displays the Disk Information window for the
disk that contains the slice.
Device Mappings
Displays the Physical to Logical Device Mappings
window. The Physical to Logical Device Mappings
window is not dynamically updated when new
mappings are created.
Close
Dimisses the window.
Help
Displays online help for the window.
The Statistics Graphs window
The Statistics Graphs window displays statistical
information about a specific device. In addition,
you can view statistical information in graphs.
All information is read-only.
The Statistics Graphs window contains:
Menus
--------
File Menu
File --> Close
Dismisses the window.
All Graphs Menu
Contains commands that act upon all the
currently displayed graphs.
Pause Pauses graphing operations.
Continue Continues graphing operations.
Expand Expands a collapsed-view graph.
Collapse Collapses the view of a graph.
Put Away Removes the selected device from
the scrolling list.
Buttons
------------
Info... (button)
Displays an information window for the device.
Put Away
Removes the selected device from the scrolling list.
Pause
Pauses graphing operations.
Device
Names the device (for example, c0t3d0).
Scrolling device/metadevice list
-------------------------------
The scrolling list in the center of the window displays
statistics and graphs for either a slice or a metadevice.
Statistics are presented in percentages. The statistical
information is the same as that provided by the iostat(1M)
command with the -x option.
Each device graph in the scrolling list has an up and
a down navigation button on the top right. Pushing the
down button exchanges the device graph with the device
graph below it. Pushing the up button exchanges the
device graph with the device graph above it.
Each device in the scrolling list contains two vertical
statistics scales. These two vertical scales graph two
types of statistics:
Ops/sec
Number of disk I/O operations per second, measured
by reads, writes, and totals.
Kbytes/sec
Disk I/O in Kbytes per second. Measures reads, writes,
and totals.
Load
Measurement of disk load either as percentage of time
busy, or as a wait queue. The wait queue shows the average
number of transactions queued for service.
The Stripe Information window
The Stripe Information window enables you to view
information and change attributes for a striped
metadevice.
The Stripe Information window contains:
Device Name
Shows the stripe name for a device (for example,
stripe 0 of d21).
Status
Shows the status of the stripe (for example, OK).
Size
Shows the size of the stripe (for example,
798.56 Mybte).
Interlace
This area shows the default interlace value for
the striped metadevice and enables you to type
a custom interlace value.
To set a custom interlace value, click the
Custom radio button, type a new value in the
entry field, and use the pull-down to select
Kbytes, Mbytes, or sectors.
Attach
Sets (attaches) the interlace value for the striped
metadevice.
Show Slice
A toggle button that hides or shows the scrolling list
of slices.
The number of slices in the scrolling list is shown to
the right of the Show Slice toggle button.
--- Scrolling List ----------------------
Slice
Displays the slice name.
Size
Displays the slice size.
Replicas
Displays the number of replicas on the slice.
Status
Displays the status of the slice.
----------------------------------
Enable
Brings a slice online.
Remove
Removes a slice from the stripe.
Info...
Displays the Slice Information window.
Slice
A text field for typing a slice name to add to
the scrolling list or replacing a slice in the
scrolling list.
Attach
Adds the slice in the Slice text field to the
scrolling list.
Replace
Replaces a slice in the scrolling list with the slice
in the Slice text field.
Close
Dismisses the window.
Help
Displays online help for the window.
The Trans Information window
The Trans Information window enables you to view
information and change attributes for a Trans metadevice
metadevice (used for UFS logging).
Device Name
Enables you to type the name of a device
to use as a Trans metadevice.
The name can be a standard name (like d1,
d2, d3, and so forth).
The Device Name text field becomes read-write
as long as the Trans metadevice is not open
and as long as it does not have an attached
logging device.
Attach
Attaches (adds) the device in the Device Name
field to the Trans metadevice object in the canvas of
the Metadevice Editor window.
Status
Displays the current status of the device
in the Device Name field (for example, OK).
Size
Displays the size of the device in the
Device Name field (for example, 9.52 Mbyte).
Use
Displays the current usage of the Trans metadevice
device (for example, Unassigned).
---------------
Master
Enables you to type the slice or metadevice
name for the Master component of the Trans metadevice.
Attach
Attaches (adds) the device in the Master text
field to the current Trans metadevice device.
Type
Shows the type of device in the Master text field
(for example, Mirror).
Status
Displays the status of the device in the Master
text field (for example, OK).
Size
Displays the size of the device in the Master
text field (for example, 9.52 Mbyte).
Info...
Displays an information window for the device
in the Master text field.
------------------
Log
Enables you to type the name of a device
for the log used for the current Trans metadevice.
Attach
Attaches (adds) the device in the Log text
field to the current Trans metadevice.
Type
Shows the type of device in the Log text
field (for example, Concat/Stripe).
Status
Displays the status of the device in the Log
text field (for example, OK).
Size
Displays the size of the device in the Log
text field (for example, 51.88 Mbyte).
Info...
Displays an information window for the device
in the Log text field.
-----Buttons-----
Close Dismisses the window.
Help Displays online help for the window.
The Tray Information window
The Tray Information window displays information
about a specific SPARCstorage Array tray.
The Tray Information window contains:
Device Name
Names the tray (for example, Tray1).
Show Disks
Toggles on and off the disk information pane.
Device Mappings
Displays the Physical to Logical Device
Mapping window. The Physical to Logical
Device Mappings window is not dynamically
updated when new mappings are created.
[Disk Information Pane]
Contains a scrolling list of all disks,
their size and status, on the tray.
Info...
Selecting a disk in the disk information pane
and clicking on the Info... button displays
the Disk Information window for that disk.
-----Buttons-----
Close
Dimisses the window.
Help
Displays online help for the window.