Samsung Magician DC User Manual

Samsung SSD

Magician DC

User guide Ver. 1.0

Legal and additional information

About Samsung Electronics Co., Ltd.

Samsung Electronics Co., Ltd. is a global leader in technology, opening new possibilities for people everywhere. Through relentless innovation and discovery, we are transforming the worlds of TVs, smartphones, tablets, PCs, cameras, home appliances, printers, LTE systems, medical devices, semiconductors and LE D solutions. We employ 286,000 people across 80 countries with annual sales of US$216.7 billion. To discover more, please visit www.samsung.com.

For more information

For more information about the Samsung PM853T, visit www.samsung.com / business /ssd or www.samsungssd.com

Copyright © 2014 Samsung Electronics Co., Ltd. All rights reserved. Samsung is a registered trademark of Samsung Electronics Co., Ltd. Specifications and designs are subject to change without notice. Nonmetric weights and meas-urements are approximate. All data were deemed correct at time of creation. Samsung is not liable for errors or omissions. All brand, product, service names and logos are trademarks and/or registered trademarks of their respec-tive owners and are hereby recognized and acknowledged.

Microsoft is a registered trademark of Microsoft Corporation in the United States and /or other countries.

Samsung provides this white paper for information purposes only. All information included herein is subject to change without notice. Samsung Electronics is not re-sponsible for any direct or indirect damages, arising from or related to use of this white paper.

Samsung Electronics Co., Ltd. 416, Maetan 3-dong, Yeongtong-gu, Suwon-si, Gyeonggi-do 443-772,

Korea

www.samsung.com

2014-10

Revision

Description

Revision

Date

1.0

Initial Release

Sep,

2014

LEGALITIES

DISCLAIMER

SAMSUNG ELECTRONICS RESERVES THE RIGHT TO CHANGE PRODUCTS, INFORMATION AND SPECIFICATIONS WITHOUT NOTICE.

Products and specifications discussed herein are for reference purposes only. All information discussed herein may change without notice and is provided on an “AS IS” basis, without warranties of any kind. This document and all information discussed herein remain the sole and exclusive property of Samsung Electronics. No license of any patent, copyright, mask work, trademark or any other intellectual property right is granted by one party to the other party under this document, by implication, estoppels or otherwise. Samsung products are not intended for use in life support, critical care, medical, safety equipment, or similar applications where product failure could result in loss of life or personal or physical harm, or any military or defense application, or any governmental procurement to which special terms or provisions may apply. For updates or additional information about Samsung products, contact your nearest Samsung office.

This material is copyrighted by Samsung Electronics. Any unauthorized reproductions, use or disclosure of this material, or any part thereof, is strictly prohibited and is a violation under copyright law.

TRADEMARKS & SERVICE MARKS

The Samsung logo is a trademark of Samsung Electronics. All other company and product names may be trademarks of the respective companies with which they are associated

REVISION

HISTORY

SSD DC 4

Contents

Introduction 05

Cautions 05

System Requirements 06

- Hardware Requirements

- Software Requirements

- Known Issues

Features

Command Line Options

Supported Commands for LSI RAID 11

How to use Magician DC

- Starting Magician DC software

- L [--list ]

- d [--disk]

- I [--info]

- S [--smart]

- F [--firmware-update] 19

- E [--erase]

- T [--trim]

- O [--over-provision]

- M [--setmax]

- W [--writecache]

- X [--sctcachestate]

- H [--help]

- C [--command-history]

-- force

- license

06 06 07

08

09

12 12 13 14 15 16

20 21 22 25 26 28 29 30 31 32

Samsung Magician Software Agreement on End User License (EULA)

Abbrevations

33

35

SSD DC 5

Introduction

Samsung SSD Magician DC software is designed to help users with easy-to-use disk management and diagnostic features for server and data center usage. In addition to providing vital SSD status information, Magician DC software will assist users in updating firmware, measuring performance, initializing drives, and calculating drive lifetime, etc.

This document is intended as a guide for how to use Samsung SSD Magician DC software under the Linux-based server/data center environments. It provides a command line interface to interact with the Samsung SSD Drives.

Cautions

1. Samsung SSD Magician DC software is only for Samsung SSD products and is not recommended for use with other products.

2. Samsung Electronics is not liable for any data loss or other damages that occur while using the software.

3. Samsung is not able to provide any data restoration service in the event of data loss.

For more information, please refer to Samsung Magician Software Agreement on End User License (EULA) at the end of this document.

SSD DC 6

OS

Comments

RHEL

5.7 and later

Refer

to the

C600 chipset table

below

RHEL

6.1 and later

Refer

to the

C600 chipset table

below

CentOS

Follows

the

same limitations

as

RHEL

above

Ubuntu 12.04

LTS

-

System

Hardware Requirements

1. SSD

„ The following Samsung SSDs are supported: (* : Limited support ‟ Cannot update FW)

- Samsung SSD 845DC PRO

- Samsung SSD 845DC EVO

- Samsung SSD 850 PRO

- Samsung SSD 840 PRO

- Samsung SSD PM853T *

- Samsung SSD SM843T *

- Samsung SSD SV843 *

2. Others

„ On Marvell controller, the Magician feature may not work properly after hot plugging.

Software Requirements

Operating system

Requirements

„ Limited support for the Intel C600 chipset families due to the well-known ISCI (Intel SAS Driver) driver issue.

(https://github.com/Xilinx/linux-xlnx/commits/master/drivers/scsi/isci?page=1)

SSD DC 7

OS Feature

support

Comments

RHEL

5.7 and later

Limited support

for

some

ATA

commands including

Secure Erase,

Set Max

Address,

and FW Update

RHEL

6.1 and 6.2

Limited support

for

some

ATA commands

including

Secure Erase,

Set

Max Address,

and

FW Update

RHEL

6.3

Limited support

for

some

ATA commands

including Secure Erase,

Set

Max Address,

and

FW

Update.

But it can be fully

supported

when

patched

with ISCI 1.4 for

RHEL

6.3

(refer

to

comments

on the right)

http://sourceforge.net/ projects/intel-sas/files/ RHEL6.3%20Driver%20 Update%20v1.4.1/

RHEL

6.4 and later

Full support

* Limitation of support for C600 chipsets has been determined by evaluations and tests.

„ On Marvell controller, Magician feature may not work properly after hot plugging. „ On Linux systems, the tool must run with root privilege. This can be done through either sudo or su commands.

Known Issues

„ TRIM command supports only ext4 file system. „ Set Max Address and Secure Erase require a power cycle of SSD. „ Set Max Address may not work on some Ubuntu distributions due to libATA restrictions. „ Over-Provision only adjusts the last partition for a disk with multiple partitions. „ The following operations are supported for SSDs when connected through the LSI HBA cards:

o List, Firmware Update, Secure Erase, SMART, Set Max, Write Cache, SCT Cache State, Disk Information, Command History, and Help. features.

SSD DC 8

Feature

Comments

List

Detect

list of

attached Samsung

SSD

Drives

in the system

Firmware

Update

the old

firmware

of the SSD to the new version

Erase

Erase data

on the SSD by

issuing

an ATA

Format

Unit command

Overprovision

Resize

the

user capacity

of the SSD

TRIM

Issue

trim

command

to the SSD

S.M.A.R.T

Display smart information

and log

temperature

of the connected

Samsung

SSD

drive,

and

estimate

the

lifetime

of

Samsung

SSD

SET MAX

Set the

maximum address

of the

Samsung

SSD to

change

its

user

capacity

Write

Cache

Enable/disable

the

write cache

of the

Samsung

SSD

SCT Cache Status

Get SCT

write cache state

of the disk.

Disk

Info

Display current overprovisioning value, current

set max

value, state

of

write cache

etc. of

specified Samsung

SSD

Command

History

Display history

of the

previously executed

commands

Help

Display

the

command

line options

Features

This user guide describes the commands necessary to interact with Samsung SSD drives. The functionality includes:

※

In LSI RAID Configuration, some features may not be executed.

The details are described in “Supported Commands for LSI RAID” table.

SSD DC 9

Option

Arguments

Description

Used

With

-H [--help]

NA

Used

to

display

the

command

line options

NA

-C [ –command

-history]

NA

Used

to

display

the

history

of the previously

executed

commands.

NA

[--force]

NA

Used

to

bypass

the

user

prompt.

--erase,

--firmware-update

-d [--disk]

Disk Number.

Used

to

input

the

physical

disk

index listed

in the

--list

command.

Note:

For

--firmware-update,

to

select

all disks

-d

[--disk] option should

be

followed

by

keyword

“A”

--erase,

--firmware-update,

--trim,

--smart,

--overprovision,

--writecache,

--sctcachestate,

--info

-L [--list]

NA

Used

to

display

a list of

attached Samsung

SSD

Drives.

NA

-S [--smart]

-d [

--disk

]

Used

to

select a specific drive connected

to the

system

and get the

SMART

Value.

NA

-t [--temperature]

Optional

file path

or no argument.

Logs

the

temperature

of the SSD in the file path

provided.

If no

argument

is

there, then

temperature

will be

logged

into file in the

default

folder.

--smart

-a [ --analyzer]

--start

--stop

“--start” records

the

data needed

to estimate

lifetime

of the SSD.

“--stop” calculates

the

lifetime

of the SSD

from

the

recorded

data.

--smart

Command Line

Options

The Samsung SSD Magician DC uses Command Line Interface (CLI) and has two variants: Admin version and Client version.

The table given below briefly explains the available command line options. The detailed description of each feature is provided in the next sections of this chapter. For the purpose of illustration, the name of the tool for all examples will be “Magician” to simplify documentation.

SSD DC 10

-M [ --setmax]

-d [

--disk

],

-s [ --set ]

Performs SETMAX related operations

on specified

SSD.

NA

-W [--writecache]

-d [

--disk

]

Used

to

enable/disable Write Cache

on specified

SSD.

NA

-s [

--set

]

1 [

Enable

] or

0 [

Disable

]

Sets

the

status

for

write

cache.

--writecache

-X[--sctcachestate]

-d [

--disk

]

Used

is to get SCT

write cache state

of the disk.

NA

-T [--trim]

-d [

--disk

]

Used

to

increase

the

performance

of the selected

disk.

NA

-F

[--firmware-

update]

-d [

--disk

]

Used

to

update

the

firmware

of the

selected

disk

connected

to

HOST

system.

NA

-E [--erase]

-d [

--disk

]

Used

to

erase

all the

data

on the

drive

by

issuing

an

ATA

Format

Unit command.

NA

-I [--info]

-d [

--disk

]

Used

to

display details

of the

selected

disk.

NA

-O [--over-

provision]

-d [--disk],

-q

[--query]

or

-s [

--set

] or

-c [

--clear

]

Used

to set the

-disk's shrink/expand

size to the

given

value

NA

-q [

--query

]

NA

Queries current Over-Provision status

of Specified

disk.

--over-provision

-s [

--set

], arg

NA

Sets Over-Provisioning

on

specified disk.

'arg' is

amount

of

over provisioning

to be set in format

[XXGB

or

XXMB

or

XX%]. Percentage

is with respect

to the disk

size.

If no

value

is

present,

it will default

to the

recommended

OP amount.

--over-provision

-c [

--clear

]

NA

Clears Over-Provisioning from specified

disk.

--over-provision

SSD DC 11

Feature

Comments

-L [--list]

Show a disk(s) attached

to the system

-F [--firmware-update]

Update firmware

to

specified

disk

-E [--erase]

Securely Erase

all

data from specified

disk

-S [--smart]

Show S.M.A.R.T values

of

specified

disk

-M [--setmax]

Perform SetMax related operations

on

specified

disk

-W [--writecache]

Enable/Disable Write Cache

on

specified

disk

-X [--sctcachestate]

Get the SCT

write cache state

for

specified

disk

-C [--command-history]

Show history

of the

previously executed

commands

-I [--info]

Display

the disk

details

to the user

-license

Show

the End

User License

Agreement

-H [--help]

Show detailed

Help

Supported Commands

Below commands are supported for LSI RAID:

for LSI RAID