storage_rebuild(8) | User Manuals | storage_rebuild(8) |
NAME¶
storage_rebuild - RozoFS disk rebuild utility
SYNOPSIS¶
- Rebuilding a full storage node
-
all files : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>]
nominal files only : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] --nominal
spare files only : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] --spare - Rebuilding only one logical storage within a storage node
-
all files : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] -s <cid>/<sid>
nominal files only : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] -s <cid>/<sid> --nominal
spare files only : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] -s <cid>/<sid> --spare - Rebuilding only a device of a logical storage
-
on the same device : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] -s <cid>/<sid> -d <device>
relocating files : storage_rebuild [-r <exports>] [-p <//>] [-t <MB/s>] [-l <loop>] -s <cid>/<sid> -d <device> -R - Clearing error counters a device of a logical storage
- storage_rebuild -C [-r <exports>] -s <cid>/<sid> -d <device>
- Rebuilding only a FID of a logical storage
- storage_rebuild [-r <exports>] [-t <MB/s>] [-l <loop>] -s <cid>/<sid> -f <FID>
- Getting the list of FID that are to be rebuilt. Then use rozo_fid2pathname utility on export node to translate FIDs to full path names.
- storage_rebuild -id <id> -list
- Pause a running rebuild in order to resume it later.
- storage_rebuild -id <id> -pause
- Resume a failed or paused rebuild.
- storage_rebuild -id <id> -resume [-l <loop>]
- Abort definitively a rebuild.
- storage_rebuild -id <id> -abort
DESCRIPTION¶
storage_rebuild rebuilds
. either a file on a logical storage
. or a device of a logical storage
. or all devices of a logical storage
. or all devices of a storage node.
When the rebuild fails, one can get the list of FIDs that have not been rebuilt. Then with rozo_fid2pathname utility on export node one can translate these FIDs to full path names.
A rebuild can be paused temporarily. It is then possible to resume a paused or failed rebuild (i.e only rebuild the files that are not yet rebuilt).
A monitoring rebuild file provides information on the ongoing rebuild. The name of the rebuild monitoring file is displayed on return from the rebuild command except when --quiet option is set. In any case the name of the rebuild monitoring file can be found in the syslog file.
MAIN OPTIONS¶
ACTION OPTIONS¶
MISCELLANEOUS OPTIONS¶
EXAMPLES¶
Rebuilding a whole storage node as fast as possible:
storage_rebuild --parallel 64
Rebuilding every device of storage instance 2 of cluster 1:
storage_rebuild --sid 1/2
Rebuilding only device 3 of storage instance 2 of cluster 1:
storage_rebuild --sid 1/2 --device 3
Rebuilding by relocating device 3 of sid 2 of cluster 1 on other
devices:
storage_rebuild --sid 1/2 --device 3 --relocate
Putting device 3 of storage instance 2 of cluster 1 back in
service when it has been set out of service by an automatic rebuild with
relocation (self healing)
storage_rebuild --sid 1/2 --device 3 --clear
FILES¶
/etc/rozofs/storage.conf (/usr/local/etc/rozofs/storage.conf)
REPORTING BUGS¶
Report bugs to <bugs@fizians.org>.
COPYRIGHT¶
Copyright (c) 2013 Fizians SAS. <http://www.fizians.com>
Rozofs is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
Rozofs is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
AUTHOR¶
Fizians <http://www.fizians.org>
SEE ALSO¶
rozofs(7), storage.conf(5), rozofs.conf(5), exportd(8), rozofsmount(8)
DECEMBER 2014 | RozoFS |