PowerEdge: Installing and Using the MVCLI MVSETUP BOSS-S1 Utility
Summary: This article explains how to install and use the MVCLI MVSETUP BOSS-S1 Utility.
This article applies to
This article does not apply to
This article is not tied to any specific product.
Not all product versions are identified in this article.
Instructions
The Marvell Command-Line Interface MVCLI and MVSETUP BOSS-S1 utility provides a method of obtaining information and manipulating the BOSS controller. This includes managing virtual disks, obtaining SMART status from hard drives, and more. This KB covers installation and general usage.
Minimum ESXi requirements:
- ESXi 6.0 U3 P06
- ESXi 6.5 U1
Supported Linux versions:
- Red Hat Enterprise Linux 6 (RHEL)
- RHEL 7.3
- SUSE Linux ES (SLES) 12
- Ubuntu 16.04
Supported Windows versions:
- Windows Server 2012 R2
- Windows Server 2016
Installation
ESXi:
1) Download latest MVCLI from https://dell.com/support
2) Transfer the ZIP using your preferred SCP application such as WinSCP to the /tmp directory on the ESXi host.
3) SSH into the ESXi host and install it with the following command:
esxcli software vib install -d /tmp/[FILE-NAME-OF-DOWNLOAD.zip]
Example installation command and output:
[root@localhost:~] esxcli software vib install -d /tmp/SAS-RAID_BOSS-S1_CLI_A00.zip
Installation Result
Message: Operation finished successfully.
Reboot Required: false
VIBs Installed: DellEMC_bootbank_SAS-RAID_BOSS-S1_CLI_A00_6-x
VIBs Removed:
VIBs Skipped:
Linux:
1) Download latest MVCLI from https://dell.com/support
2) Transfer the ZIP using your preferred SCP application (for example, WinSCP) to the /tmp directory on the linuxhost.
3) SSH into the linux host
4) Navigate to /tmp
[root@localhost ~]# cd /tmp
4) Unzip the archive (file name may be different based on version)
[root@localhost tmp]# unzip mvcli\ 4.1.13.31_A01.zip
5) Navigate to installation directory (directory name may be different vased on version) :
[root@localhost tmp]# cd /tmp/mvcli\ 4.1.13.31_A01/i386/cli
6) Apply executable permission (must be done using root or sudo) :
[root@localhost cli]# chmod +x install.sh mvcli
Windows:
1) Download and install the latest BOSS Management Driver DUP from https://dell.com/support
2) Download latest MVSetup from https://dell.com/support
3) right-click the ZIP file and extract it.
Usage
ESXi:
- Change the directory to the installation directory:
cd /opt/boss-s1
- Usage of mccli:
./mvcli ?
Example and output:
[root@localhost:/opt/boss-s1] ./mvcli ?
Legend:
[options] - the options within [] are optional.
<x|y|z> - choose one of the x, y or z.
[<x|y|z>] - choose none or one of the x, y or z.
Abbreviation:
VD - Virtual Disk, Array - Disk Array
PD - Physical Disk, BGA - BackGround Activity
Type '-output [filename]' to output to a file.
Type 'help' to display this page.
Type 'help command' to display the help page of 'command'.
Type 'command -h' to display help for 'command'.
Command name is not case sensitive and may be abbreviated if the
abbreviation is unique. Most commands support both short (-) and
long (--) options.Long option names may be abbreviated if the abbreviation
is unique. A long option may take a parameter of the form '--arg=param'
or '--arg param'. Option name is case sensitive, option parameter is not.
COMMAND BRIEF DESCRIPTION
-----------------------------------------------------------------
? :Get brief help for all commands.
help :Get brief help for all commands or detail help for one command.
assign :Assign a disk as spare drive.
cc :Start, stop, pause or resume VD Consistency Check.
rebuild :Start, stop, pause, resume rebuilding VD.
mp :Start, stop, pause or resume media patrol for a physical disk.
smart :Display the smart info of physical disk.
sat :Send SCSI command.
enc :Get enclosure, enclosure element or enclosure config information.
adapter :Default adapter the following CLI commands refers to.
rescan :Rescan the adapters
create :Create virtual disk.
delete :Delete virtual disk or spare drive.
event :Get the current events.
get :Get configuration information of VD, PD, Array, HBA or Driver.
info :Display adapter(hba), virtual disk(vd), disk array,
physical disk(pd), Port multiplexer(pm), expander(exp),
block disk(blk) or spare drive information.
set :Set configuration parameters of VD, PD or HBA.
import :Import a virtual disk.
locate :Locate the specified PD.
report :report a conflicted virtual disk to OS.
devmap :Map device ID to device magic number in the OS.
- Get help for a specific switch in this case, enc:
[root@localhost:/opt/boss-s1] ./mvcli help enc
Description:Get enclosure, enclosure element or enclosure config information.
enc -o <enc|ele|elecfg> -i <enclosure ID> -e <element ID>
-t <dev|arydev|pow|fan|tpr|dor|alm|dpl|vlt>
Options:
-o, --object <enc|ele|elecfg>
enc - enclosure info
ele - element info
elecfg - element config
-i, --id
enclosure ID
-t, --elementtype <dev|arydev|pow|fan|tpr|dor|alm|dpl|vlt>
dev- device
arydev- array device
pow- power
fan- cooling
tpr- temperature
dor- door
alm- alarm
dpl- display
vlt- voltage sensor
-e, --elementid
used only when -t is specified
- Example: Show smart info for hard drive 0:
[root@localhost:/opt/boss-s1] ./mvcli smart -p 0
SMART STATUS RETURN: OK.
Smart Info
ID Attribute Name Current Worst Threshhold RawValue
01 Read Error Rate 130 130 39 00000065D444
05 Reallocated Sectors 100 100 1 000000000000
09 Power-On Hours Count 100 100 0 000000000587
0C Power Cycle Count 100 100 0 000000000024
0D Soft read error rate 130 130 0 00000065D444
AA Grown Bad Blocks 100 100 10 000000000000
AE Unexpected Power Loss Count 100 100 0 00000000001C
B3 Used Reserved Blocks(Total) 100 100 10 000000000000
B4 Unused Reserved Block 100 100 0 000000001C67
B5 Program Fail Count (Total) 100 100 0 000000000000
B6 Erase Fail Count (Total) 100 100 0 000000000000
B8 End-to-End Data Errors Correcte 100 100 0 000000000000
C2 SSD Temperature 100 100 0 000000000018
C3 ECC Error Rate 100 100 0 000000000000
C5 Current Pending Sector Count 100 100 0 000000000000
C6 Uncorrectable Sector Count 100 100 0 000000000000
C7 CRC Error Count 100 100 0 000000000000
C9 Soft read error rate 100 100 10 003405C14984
CA Address Mark errors 100 100 0 000000000000
E1 Load/Unload cycle 100 100 0 00000000009B
E2 Load-in time 100 100 0 000000019000
E3 Torque amplification 100 100 0 000000000000
E4 Power-off retract 100 100 0 000015827BA3
E8 Available Reserved Space 100 100 10 000000000000
E9 NAND GB written 100 100 0 00000000009B
EA Vendor Specific 100 100 0 000000000000
F1 Total Host Written 100 100 0 00000000009B
F2 Total Host Read 100 100 0 000000003BA1
F5 Life Remaining 100 100 0 000000000064
- Example: Show events for the BOSS controller:
Ensure to save the output as it may clear the event data.
[root@localhost:/opt/boss-s1] ./mvcli event
Current AdapterID:0
Sequence: 24
Time: Mon Jul 9 21:14:06 2018
Level: [WARNING]
Description: Backup image succeeded
Sequence: 23
Time: Mon Jul 9 21:14:04 2018
Level: [WARNING]
Description: Backup image succeeded
Sequence: 22
Time: Mon Jul 9 21:14:02 2018
Level: [WARNING]
Description: Update image succeeded
Sequence: 21
Time: Mon Jul 9 21:13:25 2018
Level: [WARNING]
Description: Backup image succeeded
Linux:
- Usage of
MVCLI:
[root@localhost ~]# mvcli ?
SG driver version 3.5.36.
Legend:
[options] - the options within [] are optional.
<x|y|z> - choose one of the x, y or z.
[<x|y|z>] - choose none or one of the x, y or z.
Abbreviation:
VD - Virtual Disk, Array - Disk Array
PD - Physical Disk, BGA - BackGround Activity
Type '-output [filename]' to output to a file.
Type 'help' to display this page.
Type 'help command' to display the help page of 'command'.
Type 'command -h' to display help for 'command'.
Command name is not case sensitive and may be abbreviated if the
abbreviation is unique. Most commands support both short (-) and
long (--) options.Long option names may be abbreviated if the abbreviation
is unique. A long option may take a parameter of the form '--arg=param'
or '--arg param'. Option name is case sensitive, option parameter is not.
COMMAND BRIEF DESCRIPTION
-----------------------------------------------------------------
? :Get brief help for all commands.
help :Get brief help for all commands or detail help for one command.
assign :Assign a disk as spare drive.
cc :Start, stop, pause or resume VD Consistency Check.
rebuild :Start, stop, pause, resume rebuilding VD.
mp :Start, stop, pause or resume media patrol for a physical disk.
smart :Display the smart info of physical disk.
sat :Send SCSI command.
flash :Update, backup or erase flash image and erase hba or pd page.
enc :Get enclosure, enclosure element or enclosure config information.
adapter :Default adapter the following CLI commands refers to.
create :Create virtual disk.
delete :Delete virtual disk or spare drive.
event :Get the current events.
get :Get configuration information of VD, PD, Array, HBA or Driver.
info :Display adapter(hba), virtual disk(vd), disk array,
physical disk(pd), Port multiplexer(pm), expander(exp),
block disk(blk) or spare drive information.
set :Set configuration parameters of VD, PD or HBA.
import :Import a virtual disk.
locate :Locate the specified PD.
report :report a conflicted virtual disk to OS.
devmap :Map device ID to device magic number in the OS.
- Get help for a specific switch in this case, enc:
[root@localhost ~]# mvcli help enc
SG driver version 3.5.36.
Description:Get enclosure, enclosure element or enclosure config information.
enc -o <enc|ele|elecfg> -i <enclosure ID> -e <element ID>
-t <dev|arydev|pow|fan|tpr|dor|alm|dpl|vlt>
Options:
-o, --object <enc|ele|elecfg>
enc - enclosure info
ele - element info
elecfg - element config
-i, --id
enclosure ID
-t, --elementtype <dev|arydev|pow|fan|tpr|dor|alm|dpl|vlt>
dev- device
arydev- array device
pow- power
fan- cooling
tpr- temperature
dor- door
alm- alarm
dpl- display
vlt- voltage sensor
-e, --elementid
used only when -t is specified
- Example: Show smart info for hard drive 0:
[root@localhost ~]# mvcli smart -p 0
SG driver version 3.5.36.
SMART STATUS RETURN: OK.
Smart Info
ID Attribute Name Current Worst Threshhold RawValue Status
01 Read Error Rate 130 130 39 00000000ABA8 OK
05 Reallocated Sectors 100 100 1 000000000000 OK
09 Power-On Hours Count 100 100 0 00000000058A OK
0C Power Cycle Count 100 100 0 000000000024 OK
0D Soft read error rate 130 130 0 00000000ABA8 OK
AA Grown Bad Blocks 100 100 10 000000000000 OK
AE Unexpected Power Loss Count 100 100 0 00000000001C OK
B3 Used Reserved Blocks(Total) 100 100 10 000000000000 OK
B4 Unused Reserved Block 100 100 0 000000001C67 OK
B5 Program Fail Count (Total) 100 100 0 000000000000 OK
B6 Erase Fail Count (Total) 100 100 0 000000000000 OK
B8 End-to-End Data Errors Correcte 100 100 0 000000000000 OK
C2 SSD Temperature 100 100 0 000000000019 OK
C3 ECC Error Rate 100 100 0 000000000000 OK
C5 Current Pending Sector Count 100 100 0 000000000000 OK
C6 Uncorrectable Sector Count 100 100 0 000000000000 OK
C7 CRC Error Count 100 100 0 000000000000 OK
C9 Soft read error rate 100 100 10 000000004984 OK
CA Address Mark errors 100 100 0 000000000000 OK
E1 Load/Unload cycle 100 100 0 00000000009D OK
E2 Load-in time 100 100 0 000000009000 OK
E3 Torque amplification 100 100 0 000000000000 OK
E4 Power-off retract 100 100 0 000000007C52 OK
E8 Available Reserved Space 100 100 10 000000000000 OK
E9 NAND GB written 100 100 0 00000000009D OK
EA Vendor Specific 100 100 0 000000000000 OK
F1 Total Host Written 100 100 0 00000000009D OK
F2 Total Host Read 100 100 0 000000003BA6 OK
F5 Invalid 100 100 0 000000000064 OK
- Example: Show events for the BOSS controller:
Ensure to save the output as it may clear the event data.
[root@localhost ~]# mvcli event
SG driver version 3.5.36.
Current AdapterID:0
Sequence: 24
Time: Mon Jul 9 21:14:06 2018
Level: [WARNING]
Description: Backup image succeeded
Sequence: 23
Time: Mon Jul 9 21:14:04 2018
Level: [WARNING]
Description: Backup image succeeded
Sequence: 22
Time: Mon Jul 9 21:14:02 2018
Level: [WARNING]
Description: Update image succeeded
Sequence: 21
Time: Mon Jul 9 21:13:25 2018
Level: [WARNING]
Description: Backup image succeeded
Windows:
- Navigate down to the
mvsetup 4.1.13.30_A00\mvsetup 4.1.13.30\x64\clidirectory under the directory that to extractedMVsetup - Two methods:
- Shell mode: Double-click
mvsetup.exeand a command prompt window open
- Shell mode: Double-click
CLI Version: 4.1.13.30 RaidAPI Version: 5.0.13.1069
Welcome to RAID Command Line Interface.
>
Note: Not all the switches are compatible in "shell mode"
-
- Navigate to where the ZIP was extracted and run
mvsetup.exeusingCMD
- Navigate to where the ZIP was extracted and run
C:\mvcli\mvsetup 4.1.13.30_A00\mvsetup 4.1.13.30\i386\cli>mvsetup
Usage ofMVSETUPin shell mode:
CLI Version: 4.1.13.30 RaidAPI Version: 5.0.13.1069
Welcome to RAID Command Line Interface.
> ?
Legend:
[options] - the options within [] are optional.
<x|y|z> - choose one of the x, y or z.
[<x|y|z>] - choose none or one of the x, y or z.
Abbreviation:
VD - Virtual Disk, Array - Disk Array
PD - Physical Disk, BGA - BackGround Activity
Type '-output [filename]' to output to a file.
Type 'help' to display this page.
Type 'help command' to display the help page of 'command'.
Type 'command -h' to display help for 'command'.
Command name is not case sensitive and may be abbreviated if the
abbreviation is unique. Most commands support both short (-) and
long (--) options.Long option names may be abbreviated if the abbreviation
is unique. A long option may take a parameter of the form '--arg=param'
or '--arg param'. Option name is case sensitive, option parameter is not.
COMMAND BRIEF DESCRIPTION
-----------------------------------------------------------------
? :Get brief help for all commands.
help :Get brief help for all commands or detail help for one command.
assign :Assign a disk as spare drive.
cc :Start, stop, pause or resume VD Consistency Check.
rebuild :Start, stop, pause, resume rebuilding VD.
mp :Start, stop, pause or resume media patrol for a physical disk.
smart :Display the smart info of physical disk.
sat :Send SCSI command.
flash :Update, backup or erase flash image and erase hba or pd page.
enc :Get enclosure, enclosure element or enclosure config information.
adapter :Default adapter the following CLI commands refers to.
rescan :Rescan the adapters
create :Create virtual disk.
delete :Delete virtual disk or spare drive.
event :Get the current events.
get :Get configuration information of VD, PD, Array, HBA or Driver.
info :Display adapter(hba), virtual disk(vd), disk array,
physical disk(pd), Port multiplexer(pm), expander(exp),
block disk(blk) or spare drive information.
set :Set configuration parameters of VD, PD or HBA.
import :Import a virtual disk.
locate :Locate the specified PD.
report :report a conflicted virtual disk to OS.
devmap :Map device ID to device magic number in the OS.
- Get help for a specific switch in this case, enc using shell mode:
> help enc
Description:Get enclosure, enclosure element or enclosure config information.
enc -o <enc|ele|elecfg> -i <enclosure ID> -e <element ID>
-t <dev|arydev|pow|fan|tpr|dor|alm|dpl|vlt>
Options:
-o, --object <enc|ele|elecfg>
enc - enclosure info
ele - element info
elecfg - element config
-i, --id
enclosure ID
-t, --elementtype <dev|arydev|pow|fan|tpr|dor|alm|dpl|vlt>
dev- device
arydev- array device
pow- power
fan- cooling
tpr- temperature
dor- door
alm- alarm
dpl- display
vlt- voltage sensor
-e, --elementid
used only when -t is specified
- Example: Show smart info for hard drive 0 in shell mode:
> smart -p 0
SMART STATUS RETURN: OK.
Smart Info
ID Attribute Name Current Worst Threshhold RawValue Status
01 Read Error Rate 130 130 39 0000000050B7 OK
05 Reallocated Sectors 100 100 1 000000000000 OK
09 Power-On Hours Count 100 100 0 0000000000C8 OK
0C Power Cycle Count 100 100 0 000000000011 OK
0D Soft read error rate 130 130 0 0000000050B7 OK
AA Grown Bad Blocks 100 100 10 000000000000 OK
AE Unexpected Power Loss Count 100 100 0 000000000010 OK
B3 Used Reserved Blocks(Total) 100 100 10 000000000000 OK
B4 Unused Reserved Block 100 100 0 000000001C5C OK
B5 Program Fail Count (Total) 100 100 0 000000000000 OK
B6 Erase Fail Count (Total) 100 100 0 000000000000 OK
B8 End-to-End Data Errors Correcte 100 100 0 000000000000 OK
C2 SSD Temperature 100 100 0 000000000021 OK
C3 ECC Error Rate 100 100 0 000000000000 OK
C5 Current Pending Sector Count 100 100 0 000000000000 OK
C6 Uncorrectable Sector Count 100 100 0 000000000000 OK
C7 CRC Error Count 100 100 0 000000000000 OK
C9 Soft read error rate 100 100 10 000000004A74 OK
CA Address Mark errors 100 100 0 000000000000 OK
E1 Load/Unload cycle 100 100 0 000000000026 OK
E2 Load-in time 100 100 0 000000009000 OK
E3 Torque amplification 100 100 0 000000000000 OK
E4 Power-off retract 100 100 0 000000005F12 OK
E8 Available Reserved Space 100 100 10 000000000000 OK
E9 NAND GB written 100 100 0 000000000026 OK
EA Vendor Specific 100 100 0 000000000000 OK
F1 Total Host Written 100 100 0 000000000026 OK
F2 Total Host Read 100 100 0 000000001CCA OK
F5 Invalid 100 100 0 000000000064 OK.
- Example: Show events for the BOSS controller not available in shell mode:
Ensure to save the output as it may clear the event data.
C:\mvcli\mvsetup 4.1.13.30_A00\mvsetup 4.1.13.30\i386\cli>mvsetup event
Current AdapterID:0
Sequence: 6
Time: Wed Mar 07 03:09:22 2018
Level: [INFO]
Description: Fast initialization on Virtual Disk 0 completed
Sequence: 5
Time: Wed Mar 07 03:09:22 2018
Level: [INFO]
Description: Fast initialization on Virtual Disk 0 started
Sequence: 4
Time: Wed Mar 07 03:09:22 2018
Level: [INFO]
Description: Virtual Disk 0 is created
Sequence: 3
Time: Sat Dec 16 06:26:13 2017
Level: [INFO]
Description: Virtual Disk 0 is deleted
Sequence: 2
Time: Sat Dec 16 06:26:10 2017
Level: [INFO]
Description: Fast initialization on Virtual Disk 0 completed
Sequence: 1
Time: Sat Dec 16 06:26:10 2017
Level: [INFO]
Description: Fast initialization on Virtual Disk 0 started
Sequence: 0
Time: Sat Dec 16 06:26:10 2017
Level: [INFO]
Description: Virtual Disk 0 is created
Affected Products
Dell EMC XC Series XC640 Appliance, Dell EMC XC Series XC6420 Appliance, Dell EMC XC Series XC740xd Appliance, Dell EMC XC Series XC940 Appliance, PowerEdge FC640, PowerEdge M640, PowerEdge M640 (for PE VRTX), PowerEdge R640, PowerEdge R6415
, PowerEdge R740, PowerEdge R740XD, PowerEdge R7415, PowerEdge R7425, PowerEdge R840, PowerEdge R940, PowerEdge R940xa, PowerEdge T140, PowerEdge T340, PowerEdge T40, PowerEdge T440, PowerEdge T640, Dell EMC vSAN C6420 Ready Node, Dell EMC vSAN R440 Ready Node, Dell EMC vSAN R640 Ready Node, Dell EMC vSAN R6415 Ready Node, Dell EMC vSAN R740xd Ready Node
...
Article Properties
Article Number: 000120728
Article Type: How To
Last Modified: 06 Feb 2025
Version: 4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.