@ -241,48 +241,32 @@ else // No healing at this point forward, some disks are offline or dead.
fi
* /
// error returned when some disks are found to be unformatted.
var errSomeDiskUnformatted = errors . New ( "some disks are found to be unformatted" )
// error returned when some disks are offline.
var errSomeDiskOffline = errors . New ( "some disks are offline" )
// errDiskOrderMismatch - returned when disk UUID is not in consistent JBOD order.
var errDiskOrderMismatch = errors . New ( "disk order mismatch" )
// Returns error slice into understandable errors.
func reduceFormatErrs ( errs [ ] error , diskCount int ) ( err error ) {
var errUnformattedDiskCount = 0
var errDiskNotFoundCount = 0
var errCorruptedFormatCount = 0
for _ , dErr := range errs {
if dErr == errUnformattedDisk {
errUnformattedDiskCount ++
} else if dErr == errDiskNotFound {
errDiskNotFoundCount ++
} else if dErr == errCorruptedFormat {
errCorruptedFormatCount ++
}
}
if errCorruptedFormatCount > 0 {
return errCorruptedFormat
}
// Unformatted disks found, we need to figure out if any disks are offline.
if errUnformattedDiskCount > 0 {
// Returns errUnformattedDisk if all disks report unFormattedDisk.
if errUnformattedDiskCount < diskCount {
if errDiskNotFoundCount > 0 {
// Only some disks are fresh but some disks are offline as well.
return errSomeDiskOffline
}
// Some disks are fresh disks an unformatted, not disks are offline.
return errSomeDiskUnformatted
}
// All disks returned unformatted, all disks must be fresh.
return errUnformattedDisk
}
// No unformatted disks found no need to handle disk not found case, return success here.
return nil
// formatErrsSummary - summarizes errors into different classes
func formatErrsSummary ( errs [ ] error ) ( formatCount , unformattedDiskCount ,
diskNotFoundCount , corruptedFormatCount , otherErrCount int ) {
for _ , err := range errs {
switch err {
case errDiskNotFound :
diskNotFoundCount ++
case errUnformattedDisk :
unformattedDiskCount ++
case errCorruptedFormat :
corruptedFormatCount ++
case nil :
// implies that format is not nil
formatCount ++
default :
otherErrCount ++
}
}
return
}
// loadAllFormats - load all format config from all input disks in parallel.
@ -469,29 +453,50 @@ func findDiskIndex(disk string, jbod []string) int {
return - 1
}
// reorderDisks - reorder disks in JBOD order.
func reorderDisks ( bootstrapDisks [ ] StorageAPI , formatConfigs [ ] * formatConfigV1 ) ( [ ] StorageAPI , error ) {
var savedJBOD [ ] string
for _ , format := range formatConfigs {
if format == nil {
continue
// reorderDisks - reorder disks in JBOD order, and return reference
// format-config. If assignUUIDs is true, it assigns UUIDs to disks
// with missing format configurations in the reference configuration.
func reorderDisks ( bootstrapDisks [ ] StorageAPI ,
formatConfigs [ ] * formatConfigV1 , assignUUIDs bool ) ( * formatConfigV1 ,
[ ] StorageAPI , error ) {
// Pick first non-nil format-cfg as reference
var refCfg * formatConfigV1
for _ , formatConfig := range formatConfigs {
if formatConfig != nil {
refCfg = formatConfig
break
}
savedJBOD = format . XL . JBOD
break
}
// Pick the first JBOD list to verify the order and construct new set of disk slice.
if refCfg == nil {
return nil , nil , fmt . Errorf ( "could not find any valid config" )
}
refJBOD := refCfg . XL . JBOD
// construct reordered disk slice
var newDisks = make ( [ ] StorageAPI , len ( bootstrapDisks ) )
for fIndex , format := range formatConfigs {
if format == nil {
continue
}
jIndex := findDiskIndex ( format . XL . Disk , saved JBOD)
jIndex := findDiskIndex ( format . XL . Disk , ref JBOD)
if jIndex == - 1 {
return nil , errors . New ( "Unrecognized uuid " + format . XL . Disk + " found" )
return nil , nil , errors . New ( "Unrecognized uuid " + format . XL . Disk + " found" )
}
newDisks [ jIndex ] = bootstrapDisks [ fIndex ]
}
return newDisks , nil
if assignUUIDs {
// Based on orderedDisks generate new UUIDs in the ref. config
// for disks without format-configs.
for index , disk := range newDisks {
if disk == nil {
refCfg . XL . JBOD [ index ] = mustGetUUID ( )
}
}
}
return refCfg , newDisks , nil
}
// loadFormat - loads format.json from disk.
@ -550,81 +555,14 @@ func isFormatFound(formats []*formatConfigV1) bool {
return true
}
// Heals any missing format.json on the drives. Returns error only for unexpected errors
// as regular errors can be ignored since there might be enough quorum to be operational.
// Heals only fresh disks.
func healFormatXLFreshDisks ( storageDisks [ ] StorageAPI ) error {
formatConfigs := make ( [ ] * formatConfigV1 , len ( storageDisks ) )
var referenceConfig * formatConfigV1
// Loads `format.json` from all disks.
for index , disk := range storageDisks {
// Disk not found or ignored is a valid case.
if disk == nil {
// Return nil, one of the disk is offline.
return nil
}
formatXL , err := loadFormat ( disk )
if err != nil {
if err == errUnformattedDisk {
// format.json is missing, should be healed.
continue
} else if err == errDiskNotFound { // Is a valid case we
// can proceed without healing.
return nil
}
// Return error for unsupported errors.
return err
} // Success.
formatConfigs [ index ] = formatXL
}
// All `format.json` has been read successfully, previously completed.
if isFormatFound ( formatConfigs ) {
// Return success.
return nil
}
// All disks are fresh, format.json will be written by initFormatXL()
if isFormatNotFound ( formatConfigs ) {
return initFormatXL ( storageDisks )
}
// Validate format configs for consistency in JBOD and disks.
if err := checkFormatXL ( formatConfigs ) ; err != nil {
return err
}
if referenceConfig == nil {
// This config will be used to update the drives missing format.json.
for _ , formatConfig := range formatConfigs {
if formatConfig == nil {
continue
}
referenceConfig = formatConfig
break
}
}
// Collect new JBOD.
newJBOD := referenceConfig . XL . JBOD
// Reorder the disks based on the JBOD order.
orderedDisks , err := reorderDisks ( storageDisks , formatConfigs )
if err != nil {
return err
}
// From ordered disks fill the UUID position.
for index , disk := range orderedDisks {
if disk == nil {
newJBOD [ index ] = mustGetUUID ( )
}
}
// Collect new format configs.
var newFormatConfigs = make ( [ ] * formatConfigV1 , len ( orderedDisks ) )
// collectNSaveNewFormatConfigs - creates new format configs based on
// the reference config and saves it on all disks, this is to be
// called from healFormatXL* functions.
func collectNSaveNewFormatConfigs ( referenceConfig * formatConfigV1 ,
orderedDisks [ ] StorageAPI ) error {
// Collect new format configs that need to be written.
var newFormatConfigs = make ( [ ] * formatConfigV1 , len ( orderedDisks ) )
for index := range orderedDisks {
// New configs are generated since we are going
// to re-populate across all disks.
@ -633,13 +571,35 @@ func healFormatXLFreshDisks(storageDisks []StorageAPI) error {
Format : referenceConfig . Format ,
XL : & xlFormat {
Version : referenceConfig . XL . Version ,
Disk : new JBOD[ index ] ,
JBOD : new JBOD,
Disk : referenceConfig . XL . JBOD [ index ] ,
JBOD : referenceConfig . XL . JBOD ,
} ,
}
newFormatConfigs [ index ] = config
}
// Initialize meta volume, if volume already exists ignores it.
if err := initMetaVolume ( orderedDisks ) ; err != nil {
return fmt . Errorf ( "Unable to initialize '.minio.sys' meta volume, %s" , err )
}
// Save new `format.json` across all disks, in JBOD order.
return saveFormatXL ( orderedDisks , newFormatConfigs )
}
// Heals any missing format.json on the drives. Returns error only for
// unexpected errors as regular errors can be ignored since there
// might be enough quorum to be operational. Heals only fresh disks.
func healFormatXLFreshDisks ( storageDisks [ ] StorageAPI ,
formatConfigs [ ] * formatConfigV1 ) error {
// Reorder the disks based on the JBOD order.
referenceConfig , orderedDisks , err := reorderDisks ( storageDisks ,
formatConfigs , true )
if err != nil {
return err
}
// Fill in the missing disk back from format configs.
// We need to make sure we have kept the previous order
// and allowed fresh disks to be arranged anywhere.
@ -658,37 +618,37 @@ func healFormatXLFreshDisks(storageDisks []StorageAPI) error {
}
}
// Initialize meta volume, if volume already exists ignores it.
if err := initMetaVolume ( orderedDisks ) ; err != nil {
return fmt . Errorf ( "Unable to initialize '.minio.sys' meta volume, %s" , err )
}
// Save new `format.json` across all disks, in JBOD order.
return saveFormatXL ( orderedDisks , newFormatConfigs )
// apply new format config and save to all disks
return collectNSaveNewFormatConfigs ( referenceConfig , orderedDisks )
}
// Disks from storageDiks are put in assignedDisks if found in orderedDisks and in unAssignedDisks otherwise
func splitDisksByUse ( storageDisks , orderedDisks [ ] StorageAPI ) ( assignedDisks [ ] StorageAPI , unAssignedDisks [ ] StorageAPI ) {
// Populate unAssignDisks
// collectUnAssignedDisks - collect disks unassigned to orderedDisks
// from storageDisks and return them.
func collectUnAssignedDisks ( storageDisks , orderedDisks [ ] StorageAPI ) (
uDisks [ ] StorageAPI ) {
// search for each disk from storageDisks in orderedDisks
for i := range storageDisks {
found := false
for j := range orderedDisks {
if storageDisks [ i ] == orderedDisks [ j ] {
found = true
assignedDisks = append ( assignedDisks , storageDisks [ i ] )
break
}
}
if ! found {
unAssignedDisks = append ( unAssignedDisks , storageDisks [ i ] )
// append not found disk to result
uDisks = append ( uDisks , storageDisks [ i ] )
}
}
return assignedDisks , unAssigned Disks
return uDisks
}
// Inspect the content of all disks to guess the right order according to the format files.
// The right order is represented in orderedDisks
func reorderDisksByInspection ( orderedDisks , storageDisks [ ] StorageAPI , formatConfigs [ ] * formatConfigV1 ) ( [ ] StorageAPI , error ) {
// Inspect the content of all disks to guess the right order according
// to the format files. The right order is represented in orderedDisks
func reorderDisksByInspection ( orderedDisks , storageDisks [ ] StorageAPI ,
formatConfigs [ ] * formatConfigV1 ) ( [ ] StorageAPI , error ) {
for index , format := range formatConfigs {
if format != nil {
continue
@ -701,7 +661,8 @@ func reorderDisksByInspection(orderedDisks, storageDisks []StorageAPI, formatCon
continue
}
volName := ""
// Avoid picking minioMetaBucket because ListVols() returns a non ordered list
// Avoid picking minioMetaBucket because ListVols()
// returns a non ordered list
for i := range vols {
if vols [ i ] . Name != minioMetaBucket {
volName = vols [ i ] . Name
@ -742,84 +703,28 @@ func reorderDisksByInspection(orderedDisks, storageDisks []StorageAPI, formatCon
}
// Heals corrupted format json in all disks
func healFormatXLCorruptedDisks ( storageDisks [ ] StorageAPI ) error {
formatConfigs := make ( [ ] * formatConfigV1 , len ( storageDisks ) )
var referenceConfig * formatConfigV1
// Loads `format.json` from all disks.
for index , disk := range storageDisks {
// Disk not found or ignored is a valid case.
if disk == nil {
// Return nil, one of the disk is offline.
return nil
}
formatXL , err := loadFormat ( disk )
if err != nil {
if err == errUnformattedDisk || err == errCorruptedFormat {
// format.json is missing or corrupted, should be healed.
continue
} else if err == errDiskNotFound { // Is a valid case we
// can proceed without healing.
return nil
}
// Return error for unsupported errors.
return err
} // Success.
formatConfigs [ index ] = formatXL
}
// All `format.json` has been read successfully, previously completed.
if isFormatFound ( formatConfigs ) {
// Return success.
return nil
}
// All disks are fresh, format.json will be written by initFormatXL()
if isFormatNotFound ( formatConfigs ) {
return initFormatXL ( storageDisks )
}
// Validate format configs for consistency in JBOD and disks.
if err := checkFormatXL ( formatConfigs ) ; err != nil {
return err
}
if referenceConfig == nil {
// This config will be used to update the drives missing format.json.
for _ , formatConfig := range formatConfigs {
if formatConfig == nil {
continue
}
referenceConfig = formatConfig
break
}
}
// Collect new JBOD.
newJBOD := referenceConfig . XL . JBOD
func healFormatXLCorruptedDisks ( storageDisks [ ] StorageAPI ,
formatConfigs [ ] * formatConfigV1 ) error {
// Reorder the disks based on the JBOD order.
orderedDisks , err := reorderDisks ( storageDisks , formatConfigs )
referenceConfig , orderedDisks , err := reorderDisks ( storageDisks ,
formatConfigs , true )
if err != nil {
return err
}
// From ordered disks fill the UUID position.
for index , disk := range orderedDisks {
if disk == nil {
newJBOD [ index ] = mustGetUUID ( )
}
}
// For disks with corrupted formats, inspect the disks contents to guess the disks order
orderedDisks , err = reorderDisksByInspection ( orderedDisks , storageDisks , formatConfigs )
// For disks with corrupted formats, inspect the disks
// contents to guess the disks order
orderedDisks , err = reorderDisksByInspection ( orderedDisks , storageDisks ,
formatConfigs )
if err != nil {
return err
}
// At this stage, all disks with corrupted formats but with objects inside found their way.
// Now take care of unformatted disks, which are the `unAssignedDisks`
_ , unAssignedDisks := splitDisksByUse ( storageDisks , orderedDisks )
// At this stage, all disks with corrupted formats but with
// objects inside found their way. Now take care of
// unformatted disks, which are the `unAssignedDisks`
unAssignedDisks := collectUnAssignedDisks ( storageDisks , orderedDisks )
// Assign unassigned disks to nil elements in orderedDisks
for i , disk := range orderedDisks {
@ -829,27 +734,8 @@ func healFormatXLCorruptedDisks(storageDisks []StorageAPI) error {
}
}
// Collect new format configs.
var newFormatConfigs = make ( [ ] * formatConfigV1 , len ( orderedDisks ) )
// Collect new format configs that need to be written.
for index := range orderedDisks {
// New configs are generated since we are going
// to re-populate across all disks.
config := & formatConfigV1 {
Version : referenceConfig . Version ,
Format : referenceConfig . Format ,
XL : & xlFormat {
Version : referenceConfig . XL . Version ,
Disk : newJBOD [ index ] ,
JBOD : newJBOD ,
} ,
}
newFormatConfigs [ index ] = config
}
// Save new `format.json` across all disks, in JBOD order.
return saveFormatXL ( orderedDisks , newFormatConfigs )
// apply new format config and save to all disks
return collectNSaveNewFormatConfigs ( referenceConfig , orderedDisks )
}
// loadFormatXL - loads XL `format.json` and returns back properly
@ -900,8 +786,11 @@ func loadFormatXL(bootstrapDisks []StorageAPI, readQuorum int) (disks []StorageA
if err = checkFormatXL ( formatConfigs ) ; err != nil {
return nil , err
}
// Erasure code requires disks to be presented in the same order each time.
return reorderDisks ( bootstrapDisks , formatConfigs )
// Erasure code requires disks to be presented in the same
// order each time.
_ , orderedDisks , err := reorderDisks ( bootstrapDisks , formatConfigs ,
false )
return orderedDisks , err
}
func checkFormatXLValue ( formatXL * formatConfigV1 ) error {
Aditya Manthramurthy
7 years ago
committed by