Samsung MagicianDC User manual

Samsung SSD
Magician DC
User guide Ver. 1.0
© 2014 Samsung Electronics Co.

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 LED 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

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.
COPYRIGHT © 2014
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
Revision
Description
Revision Date
1.0
Initial Release
Sep, 2014

SSD DC 4
Contents
Introduction 05
Cautions 05
System Requirements 06
- Hardware Requirements 06
- Software Requirements 06
- Known Issues 07
Features 08
Command Line Options 09
Supported Commands for LSI RAID 11
How to use Magician DC 12
- Starting Magician DC software 12
- L [--list ] 13
- d [--disk] 14
- I [--info] 15
- S [--smart] 16
- F [--firmware-update] 19
- E [--erase] 20
- T [--trim] 21
- O [--over-provision] 22
- M [--setmax] 25
- W [--writecache] 26
- X [--sctcachestate] 28
- H [--help] 29
- C [--command-history] 30
-- force 31
- license 32
Samsung Magician Software Agreement on End User License (EULA) 33
Abbrevations 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 SSDproducts 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
System Requirements
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
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
-
„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 ISCI1.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
Features
This user guide describes the commands necessary to interact with Samsung SSD drives. The functionality includes:
Feature
Comments
List
Detect list of attached Samsung SSD Drives in the system
Firmware Update
Update the old firmware of the SSDto the new version
Erase
Erase data on the SSDby issuing an ATA Format Unitcommand
Overprovision
Resize the user capacity of the SSD
TRIM
Issue trim command to the SSD
S.M.A.R.T
Display smart information andlog temperature of the connected
Samsung SSD drive, and estimate the lifetime of Samsung SSD
SET MAX
Set the maximum address of the Samsung SSDto 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
※In LSI RAID Configuration, some features may not be executed.
The details are described in “Supported Commands for LSI RAID”table.

SSD DC 9
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.
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]
DiskNumber.
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

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 Unitcommand.
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 withrespect
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