Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME samadm - Sun QFS and SAM-QFS main administrative command SYNOPSIS samadm servicetag add|delete samadm eq-add eq_number# samadm eq-release eq_number# samadm eq-remove eq_number# samadm eq-alloc eq_number# samadm eq-noalloc eq_number# samadm -?|--help DESCRIPTION The samadm command is a single command line interface to many Sun QFS and SAM-QFS commands. Initially, it contains commands that are new to Sun QFS and SAM-QFS 5.0, but will in the future contain subcommands for most QFS administra- tive functions. The detailed description of each subcommand follows. SUBCOMMANDS servicetag The add operand to the servicetag subcommand adds ser- vice tags to the service tag repository depending on whether the SUNWqfs or SUNWsamfs package is installed. If the SUNWqfs package is installed, a Sun QFS service tag is added. If the SUNWsamfs package is installed, both a Sun QFS and a SAM-QFS service tag are added. See stclient(1M) for more information on service tags. The delete operand to the servicetag subcommand deletes both Sun QFS and SAM-QFS service tags from the service tag repository. The servicetag subcommand is not intended to be needed to be invoked by the administrator. The Sun QFS software automatically adds service tags when first con- figured or mounted, and deletes service tags when the Sun QFS or SAM-QFS package is removed. eq-add This subcommand adds an equipment to an existing mounted Sun QFS file system. The equipment must be added to the mcf(4) file, and samd config must be run prior to adding the equipment number to a file system. The equipment will be placed into the off state. In a non-shared file system, after the equipment number is added, it is placed into the on state. In a shared file system, after the equipment number is added, it is initially placed into the unavail state. All the mcf files on the clients must be updated to include the new/changed equipment number, and samd con- fig run. After this has been done, To place this equip- ment number into full read/write status, change the state to alloc via samadm eq-alloc eq_number#. eq-release This subcommand releases the disk space associated with files that have valid archive copies from SAM-QFS. It can be used prior to an eq-remove command to quickly release space on a device that is to be removed for hardware failure or other reasons. The eq-release subcommand starts a background process called sam-shrink which releases space on the equipment number The releasing process may take some time to com- plete. Progress can be monitored via samu(1M) (m display). When the release is started, the equipment is first put into noalloc state to prevent further data allocation on that equipment. When the releasing pro- cess is complete, the equipment is placed into off state if all space was successfully released. eq-remove This subcommand removes an equipment number from an existing mounted Sun QFS file system. It is intended to be used to remove an equipment for reuse, or to remove an equipment that needs replacement because of hardware failure. The eq-remove subcommand starts a background process called sam-shrink which copies the data on the equipment number to be removed to other equipments in the file system. The removal process may take some time to com- plete. Progress can be monitored via samu(1M) (m display). When the remove is started, the equipment to be removed is first put into noalloc state to prevent further data allocation on that equipment. When the removal process is complete, the equipment is placed into off state if all space was successfully moved to other equipments. eq-alloc This subcommand changes the state of an equipment number to alloc which allows new data allocations to be placed on it. This subcommand is only legal for equipments which are currently in the noalloc or unavail state. eq-noalloc This subcommand changes the state of an equipment number to noalloc which prevents new data allocations to be placed on it. This subcommand is only legal for equip- ments which are currently in the on state. -?|--help Displays a command syntax summary. SEE ALSO samservicetag(1M) samu(1M) samd(1M) mcf(4)