Samsung MagicianDC, User Manual

Page 1: ...SamsungSSD MagicianDC UserguideVer 1 0 2014 Samsung Electronics Co ...

Page 2: ... 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 recogniz...

Page 3: ... 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 Th...

Page 4: ...upported 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 ...

Page 5: ...e 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...

Page 6: ...rvell controller the Magician feature may not work properly after hot plugging Software Requirements Operating system OS Comments RHEL 5 7andlater Refer to theC600 chipset table below RHEL 6 1andlater Refer to theC600 chipset table below CentOS Follows thesame 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 ...

Page 7: ...ion ofsupport for C600chipsetshasbeen determinedby evaluationsandtests 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...

Page 8: ... information andlogtemperature of theconnected Samsung SSDdrive andestimate thelifetime of Samsung SSD SETMAX Setthemaximum address of theSamsung SSDto change its user capacity Write Cache Enable disable thewrite cache of theSamsung SSD SCT Cache Status GetSCTwrite cache state of thedisk Disk Info Display current overprovisioning value current setmaxvalue state of write cache etc of specified Sams...

Page 9: ...e NA Used to bypass theuser prompt erase firmware update d disk DiskNumber Used to input thephysical diskindex 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 sele...

Page 10: ...NA E erase d disk Used to erase all thedata onthedrive by issuing an ATAFormat Unitcommand NA I info d disk Used to display details of theselected disk NA O over provision d disk q query or s set or c clear Used to setthe disk s shrink expand sizeto the given value NA q query NA Queries current Over Provision status of Specified disk over provision s set arg NA Sets Over Provisioning onspecified d...

Page 11: ...ta from specified disk S smart Show S M A R T values of specified disk M setmax Perform SetMax related operations onspecified disk W writecache Enable Disable Write Cache on specified disk X sctcachestate GettheSCTwrite cache state forspecified disk C command history Show history of thepreviously executed commands I info Display thediskdetails to theuser license Show theEndUser License Agreement H...

Page 12: ...SSD DC 12 How touse Magician DC Starting Magician DC software Find a Magician file and execute ...

Page 13: ...th 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 IR2 4 IR 3 8 MegaRAID 2 Controller ID Identifier of HBA RAID controller numbering 3 Disk ID Identifier of SSD in one controller ID...

Page 14: ... 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 Argumentsprovidedaboveareonlyforillustrationpurpose ForSSDsdirectlyconnect...

Page 15: ...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 ...

Page 16: ...e home folder location magician disk 1 smart analyzer start Record thedata needed to estimate thelifetime of SSD magician disk 1 smart analyzer stop Analysis thelifetime of the SSDusing 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 thedata needed to estimate thelifetime of SSD magician d 1 S...

Page 17: ...SSD DC 17 SMART Information Temperature log ...

Page 18: ...SSD DC 18 SSD Lifetime Analyzer ...

Page 19: ...amsung will provide firmware update package separately Arguments fwpackage path This argument provides thepath to thedirectory containing firmware filesandit should be given justafter theswitch 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 u...

Page 20: ... not to continue the command force option must be used cautiously asit willnot prompt the userfortheconfirmation which mayresultinsevere 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 ...

Page 21: ...T trim Send LBA ranges information of invalid data such that the SSD can know that the corresponding data inside the SSD is invalid Arguments None Used with disk or d Usage magician disk 1 trim or magician d 1 T ...

Page 22: ...t 4GB magician disk 1 over provision set 10 magician disk 1 over provision set magician disk 1 over provision clear or magician d 1 O q magician d 1 O s 1024MB magician d 1 O s 4GB magician d 1 O s 10 magician d 1 O s magician d 1 O c Note If no argument is given for set option the application will perform Over Provisioning with default value 10 O short switch can also be used for over provision S...

Page 23: ...n user canonlymodify the reserved area of lastpartition using thisfeature sda1 100GB 5 sda2 100GB 5 10GB Recommended OP Capacity of recommended OP area 10 of device size 480GB 10 48GB Maximum OP Capacity of maximum OP area 50 of last partition and5 filesystem default of other partition sda2 100GB 50 sda1 100GB 5 55GB Over provision query ...

Page 24: ...SSD DC 24 Over provision set 10 Over provision clear ...

Page 25: ...y supported by the SSD Arguments s set Setthedisk s capacity by taking value in number of sectors in decimal r read native max Display thenative maxaddress of thediskin theform of LBA Used with disk or d Usage magician disk 1 setmax set 1234566 magician disk 1 setmax read native max or magician d 1 M s 1234566 magician d 1 M r Setmax set Setmax read native max ...

Page 26: ...ecified SSD Arguments s set Enables for set 1 or Disables for set 0 Write Cache on thespecified SSD Used with disk or d Usage magician disk 1 writecache set 1 magician disk 1 writecache set 0 or magician d 1 W s 1 magician d 1 W s 0 Writecache set 1 enable ...

Page 27: ...SSD DC 27 Writecache set 0 disable ...

Page 28: ...port write cache state of the specified SSD Arguments NA Used with disk or d Usage magician disk 1 sctcachestate or magician d 1 X Note If the disk does not supports sct write cache commands and then a message is displayed to notify the user sctcachestate ...

Page 29: ...SSD DC 29 H help Display the command line options which are supported by Magician application Arguments None Used with None Usage magician help or magician H ...

Page 30: ...30 C command history Display the list of CLI commands executed previously by the user Maximum of 500 command history will be displayed Arguments None Used with None Usage magician command history or magician C ...

Page 31: ...s This option must be used cautiously as it will not prompt the user for the confirmation which may result in severe data loss Arguments None Used with erase trim firmware update Usage magician disk 1 erase force magician disk 1 trim force magician disk 1 firmware update p fwpackage path force or magician d 1 E force magician d 1 T force magician d 1 F p fwpackage path force ...

Page 32: ...SSD DC 32 license Display the End User License Agreement The license agreement will show the ownership licensing dispute resolution and disclaimer Arguments None Used with None Usage magician license ...

Page 33: ...e public domain Component License hdparm BSD2 0 Json cpp public domain Below is the full license statement from hdparm BSD StyleOpen SourceLicense You may freely use modify andredistributethehdparm program aseither binary or source or both Theonly condition isthat thenameandcopyright noticeremain in thesourcecode as is MarkLord mlord pobox com Below is the full license statement from json cpp Thej...

Page 34: ...ts use or by Samsung if you fail to cure any breach of this Agreement within sixty 60 days written notice of breach by Samsung Upon termination the licenses granted to you shall terminate and you shall cease all use and distribution of and cease exercising any and all other rights granted under this Agreement with respect to the Software 7 GENERAL This Agreement constitutes the entire agreement be...

Page 35: ...iation Description ATA Advanced Technology Attachment HDD Hard DiskDrive CLI Command Line Interface IO Input Output PATA Parallel ATA SATA Serial ATA SSD Solid State Drive S M A R T Self Monitoring Analysis and Reporting Technology ...

Page 36: ...www samsung com ssd ...