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

SSD DC 11
Supported Commands forLSIRAID
Below commands are supported for LSI RAID:
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

SSD DC 12
How to use Magician DC
Starting Magician DC software
Find a Magician file and execute.

SSD DC 13
-L [--list ]
The ‟L or --list option will display a list of Samsung SSDs which shows the Model Name, Firmware version, Capacity, Disk Heath, TBW,
etc.
Arguments:
None
Used with:
None
Usage:
magician --list
[or]
magician ‟L
※Note: in case of OS disk DiskNumber is preceded with '*'
※Note: For normal SSDs connected directly to the system, the “Disk Number”is displayed as a single natural number (0 or 1 or
2 etc.), but under RAID configuration, the “Disk Number”will be shown in Library type : Controller ID : Disk ID format(eg- 2:0:1).
1) LSI Library Type : 1 (IR 1), 2 (IR 2), 4 (IR 3), 8 (MegaRAID)
2) Controller ID : Identifier of HBA/RAID controller (numbering)
3) Disk ID : Identifier of SSD in one controller ID
※“-d 0”for only Samsung SSD and “-d 2:0:1”for RAID configuration.

SSD DC 14
-d [--disk]
-d or --disk is used to input the physical disk index listed in the ‟L or --list command.
Arguments:
None
Used with:
--erase, --firmware-update, --trim, --overprovision, --smart, --benchmark, --info,
--sctcachestate
Usage:
magician --disk 1 --erase
magician --disk 1 --firmware-update --path <fwpackage-path>
magician --disk 1 --trim
magician --disk 1 --over-provision --set 25%
magician --disk 1 --smart
magician --disk 1 --setmax --set 123456
magician --disk 1 --writecache --set 1
magician --disk 1 --sctcachestate
magician --disk 1 --info
[or]
magician -d 1 ‟E
magician -d 1 -F -p <fwpackage-path>
magician -d 1 -T
magician -d 1 -O -s 25%
magician -d 1 -S
magician -d 1 -M -s 123456
magician -d 1 -W -s 1
magician -d 1 -X
magician -d 1 ‟I
※Note:Arguments providedabove are onlyfor illustrationpurpose.
ForSSDs directly connectedtothesystem,thedisknumbershouldbe inputtedas“-d0”andforRAIDconfiguration“-d 2:0:1”,where
2-Librarytype,0-Controller number,and 1 -disknumber.

SSD DC 15
-I [--info]
Display the details of the selected Samsung SSD.
Arguments:
None
Used with:
--disk [or] -d
Usage:
magician --disk 1 --info
[or]
magician -d 1 -I

SSD DC 16
-S [--smart]
Select a specific drive connected to the system and get the S.M.A.R.T information.
For example, if --disk X is specified, where X is the physical disk index, it lists down the SMART attributes of the disk X connected to
HOST system.
Also it is used to log temperature of the disk and estimate its life time.
Arguments:
-t [--temperature] Enables the user to log the temperature of the disk.
-a [--analyzer] Displays the lifetime estimation of the disk by SMART value.
--analyzer should be followed by either --start or --stop subcommands.
Used with:
--disk [or] -d
Usage:
magician --disk 1 --smart
magician --disk 1 --smart --temperature [Use default folder location]
magician --disk 1 --smart --temperature /home/ [Use /home/ folder
location] magician --disk 1 --smart --analyzer --start [Record the data
needed to
estimate the lifetime of SSD.]
magician --disk 1 --smart --analyzer --stop [Analysis the lifetime of the
SSD using recorded data.]
[or]
magician -d 1 -S
magician -d 1 -S -t [Use default folder location]
magician -d 1 -S -t /home/ [Use /home/ folder location]
magician -d 1 -S -a --start [Record the data needed to
estimate the lifetime of SSD.]
magician -d 1 -S -a --stop [Analysis the lifetime of the
SSD using recorded data.]
※Note: Default folderlocation is /usr/local/Magician/SMARTFiles/. Temperature will be logged into a file “Log_Temperature.
txt”in default location if no valid file path is provided.
To estimate the lifetime of the SSD, first --analyzer should be run with --start and then with --stop subcommand. If “Wear
Leveling Count”of the SSD is the same when executing “--start”and “--stop”subcommands, then the lifetime will be
displayed as infinite.

SSD DC 17
[SMART Information]
[Temperature log]

SSD DC 18
[SSD Lifetime Analyzer]

SSD DC 19
-F [--firmware-update]
Update the firmware of the selected Samsung SSD connected to the Host system.
If --force is not used then the user will be prompted whether or not to continue the command.
Firmware update package includes firmware update policy file - DSRD.enc and new firmware. Samsung will provide firmware update
package separately.
Arguments:
<fwpackage-path> [This argument provides the path to the directory containing
firmware files andit should be given just after the switch]
Used with:
--disk [or] -d
Usage:
magician --disk 1 --firmware-update -p < fwpackage-path >
magician --disk A --firmware-update -p < fwpackage-path >
[or]
magician -d 1 -F -p < fwpackage-path >
magician -d A -F -p < fwpackage-path >
※Note: Firmware update is available for limited Samsung SSD models:
845DC PRO, 845DC EVO. 850 PRO, 840 PRO

SSD DC 20
-E [--erase]
Erase all the data on the drive by using an ATA Format Unit command.
If --force is not used then the user will be prompted whether or not to continue the command. --force option must be used cautiously
as it will not prompt the userfor the confirmation, which may result in severe data loss.
Arguments:
None
Used with:
--disk [or] -d
Usage:
magician --disk 1 --erase
[or]
magician -d 1 -E
※Note: When the disk is in frozen state, the user has to unplug and plug-in the power cable and restart the erase operation.