Add-iBMCSPRAIDVolume

NAME Add-iBMCSPRAIDVolume



SYNOPSIS

Add new volume for current RAID setting of the SP service.





SYNTAX

Add-iBMCSPRAIDVolume [-Session] <RedfishSession[]> -Location <String[]> -DeviceName <String[]> [-CardModel

{LSI3008}] -RAIDLevel {RAID0 | RAID1 | RAID10 | RAID1E} -Drives <Int32[][]> -BootEnabled <Boolean[]> [-CapacityMB

<Int32[]>] [-VolumeName <String[]>] [<CommonParameters>]





DESCRIPTION

Add new volume for current RAID setting of the SP service.

This cmdlet only supports manage server with single "LSI3008" RAID card.

Note: Only the V5 servers with the version BIOS>=0.39, SP>=113, BMC>=3.20 support this function.





PARAMETERS

-Session <RedfishSession[]>

iBMC redfish session object which is created by Connect-iBMC cmdlet.

A session object identifies an iBMC server to which this cmdlet will be executed.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Location <String[]>

Indicates the location information of the RAID controller card. For example: mainboard.



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-DeviceName <String[]>

Indicates the Silkscreen of the RAID controller card. For example: RAIDStorage0.



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-CardModel

Indicates the RAID controller card mode.

Currently, Only 'LSI3008' is support.



Required? false

Position? named

Default value @([RAIDCardModel]::LSI3008)

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-RAIDLevel

Indicates the RAID level of volume.

Available Value Set: RAID0, RAID1, RAID10, RAID1E.



Notes:

- This parameter must be RAID0 or RAID1 when creating a CacheCade volume.

- You do not need to set this parameter when adding a volume to an existing drive group



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Drives <Int32[][]>

Indicates the member disk list.

example: $Drives = ,@(DriveID-1, DriveID-2, ..)



Notes:

- All the member disks must have the same type of interfaces and storage media.

- When adding a volume to an existing drive group, enter the ID of any drive of the drive group.

- The DriveID is represented by the Id properties of "Get-iBMCDrives" cmdlet's return value.



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-BootEnabled <Boolean[]>

Indicates whether the volume is the boot device.

Support values are powershell boolean value: $true(1), $false(0).



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-CapacityMB <Int32[]>

Indicates the Capacity size of volume. The size unit is MB.



Note: This parameter is redundant when creating a CacheCade volume.



Required? false

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-VolumeName <String[]>

Indicates the Volume name.

It is a string of up to 15 bytes.

Value range: ASCII code corresponding to 0x20 to 0x7E.



Required? false

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Null

Returns null if cmdlet executes successfully.

In case of an error or warning, exception will be returned.





-------------------------- EXAMPLE 1 --------------------------



PS C:\\>$credential = Get-Credential



PS C:\\> $Session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert

PS C:\\> $Drives = ,@(0, 1)

PS C:\\> $VolumeName = "Volume1"

PS C:\\> Add-iBMCSPRAIDVolume $session -Location mainboard -DeviceName RAIDCard1 `

-VolumeName $VolumeName -CapacityMB 1048576 -BootEnabled $true `

-RAIDLevel RAID1 -Drives $Drives

PS C:\\>

PS C:\\> Export-iBMCSPRAIDSetting -Session $Session

PS C:\\> Set-iBMCSPService -Session $Session -StartEnabled $true -SysRestartDelaySeconds 60

PS C:\\> Set-iBMCServerPower -Session $Session -ResetType ForceRestart



Host : 10.1.1.2

Id : mainboardRaidCard1

Name : SP RAID Current Configuration

CardModel : LSI3008

DeviceName : RAIDCard1

GlobalHotSpare : {5, 6}

Location : mainboard

DriveGroupList : {@{VolumeList=System.Object[]; VolumeRaidLevel=RAID1; Drives=System.Object[]}}



This example shows how to add a volume for SP-RAID.

It contains several steps:

1. Add a new volume

2. Export SP-RAID setting

3. Enable SP-Service

4. Restart Server (may take a long time, please be patience)



Step 1 will config a new volume (not effect), while step 2,3,4 will make it effect.











RELATED LINKS

https://github.com/Huawei/Huawei-iBMC-Cmdlets



Get-iBMCSPRAIDSetting

Export-iBMCSPRAIDSetting

Set-iBMCSPRAIDSetting

Clear-iBMCSPRAIDSetting

Connect-iBMC

Disconnect-iBMC