Page 1
User Guide Seagate X8 Accelerator for VMware ESXi ® Powered by Virident ST2200FS0000 ST1100FS0000 ST1100FR0000 ST550FR0000 100728270 Rev. A June 2013...
Page 2
Publication number: 100728270, Rev. A June 2013 Seagate, Seagate Technology and the Wave logo are registered trademarks of Seagate Technology LLC in the United States and/or other countries. Seagate X8 Accelerator and SeaTools are either trademarks or registered trademarks of Seagate Technology LLC or one of its affiliated companies in the United States and/or other countries.
Third Party Services is subject to your agreement with the applicable third party service provider. Except as expressly stated herein, this EULA does not grant you any intellectual property rights in the Product. Seagate and its suppliers reserve all rights not expressly granted to you.
Page 6
EULA. If you receive an Update, you may continue to use the previous version(s) of the Software in your possession, custody or control. Seagate shall have no obligation to support the previous versions of the Software upon availability of an Update.
Page 7
(c)(1) and (2) of 48 CFR 52.227-19 (Commercial Computer Product- Restricted Rights), as applicable. The manufacturer is Seagate. You may not transfer or assign this EULA or any rights under this EULA, except that you may make a one-time, permanent transfer of this EULA and the Software to another end user, provided that (i) you do not retain any copies of the Software, the Hardware, the media and printed materials, Upgrades (if any), and this EULA, and (ii) prior to the transfer, the end user receiving this EULA and the Software agrees to all the EULA terms.
Seagate X8 Accelerator enables enterprises to tackle performance-intensive applications such as databases, business analytics, virtualization and high- performance computing applications. This document explains how to install, configure and manage Seagate X8 Accelerator devices with VMware software version 3.2 on ESXi 5.0/5.1 based systems.
ELECTION Seagate X8 Accelerator devices need to be installed in x8 or x16 PCIe Gen 2 slots. If no PCIe x8/x16 slots are available, x4 slots can be used. However, using an x4 slot may result in up to 50% reduction in performance.
BIOS S YSTEM ETTINGS After a system restart, prior to booting the operating system, enter the system BIOS setup to verify several important settings. Note that each BIOS often has its own nomenclature for these settings, so the exact wording of the configuration parameters may not match the examples.
Download the device driver offline bundle from Seagate Support website before proceeding. Ensure that the device is seen by the operating system. If this is a new setup and first time installation of the X8 Accelerator device, then the device is detected only as the Seagate Technology Memory controller.
~ # reboot 5.1.3 Install/Update Seagate Driver Using VMware vSphere Update Manager (VUM) Configure update manager and install the required plugin for vSphere client. Import the downloaded device driver bundle into the update manager Patch Repository as show below.
Page 13
Attach proper baseline to host or cluster and stage/remediate. X8 A EAGATE CCELERATOR FOR WARE UIDE...
IRMWARE PDATE In some cases your X8 Accelerator device may require firmware update. Use the vgc-monitor utility to check whether or not the firmware is up to date. If the firmware is up to date, the following is displayed: ~ # esxcli vgc monitor drive vgc-monitor: 3.2.55402.C7 Driver Uptime: 0:06 Card_Name...
5.3.1 X8 Accelerator Firmware Update Procedure Use the vgc-update.sh utility to upgrade X8 Accelerator Firmware as follows: This is a potentially destructive operation and Seagate recommends the back-up of data on the drive before proceeding. ~# cd /opt/vgc/bin/ /opt/vgc/bin # sh vgc-update.sh WARNING! This will update the drive firmware.
In the event of a necessity to roll back to the previous versions of the driver and firmware, follow the below procedure. The roll back to driver versions 3.0, 3.1 and 3.1.1 only is supported in this release. This is a potentially destructive operation and Seagate recommends the back-up of data on the drive before proceeding.
Now install the previous version of driver and utilities VIBs using the offline bundle downloaded from Seagate Support web site. ~ # esxcli software vib install -d /VSI-51450.C6.zip Installation Result Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective.
X8 A ONFIGURING CCELERATOR ATASTORE USING V PHERE LIENT Add the X8 Accelerator device as a VMware datastore using the vSphere client. Select Configuration-> Storage-> Add Storage… X8 A EAGATE CCELERATOR FOR WARE UIDE...
Accelerator devices. Esxcli vgc config Most administrative interactions with the Seagate X8 Accelerator device are handled by the esxcli vgc config command. This utility can show the current partitioning and write acceleration modes on an existing device. The usage information for esxcli vgc config is listed below. Users can set the number of physical partitions ("-n XX") and a write performance profile ("-m YYY") of the Seagate X8 Accelerator devices.
Page 24
esxcli vgc config drive Description: Configures the performance mode and number of partitions. Please check your X8 Accelerator device specifications for two partition support Syntax: esxcli vgc config drive [cmd options] Description: drive Configure the specified drive Cmd options: -d|--drive=<str> drive name vgc[a,b,c...].
The X8 Accelerator vgc monitor utility is the main tool for monitoring Seagate X8 Accelerator device status and health. When called without parameters, it lists all Seagate X8 Accelerator devices in the system with their configuration and health summary.
The following example shows detailed output for the device 'vgca'. The first section of the monitor output shows physical characteristics of the Seagate X8 Accelerator device such as raw device size, serial number, and overall device health, while the latter half shows the configured mode, total read/write bytes and remaining flash life.
UNDLE The vgc-diags utility saves support information, such as log files, system configuration, device configuration, and device metadata into a single tgz archive file. Seagate support team may ask you to provide this support file when troubleshooting technical issues. On ESXi 5.x systems, the <outputpath> specified must be on a Datastore, as other destination paths are ROMFS and non-persistent across reboots, with very limited space.
For example, the standards for magnetic disk media are different than what is required for flash memory. Seagate has a Secure Erase Utility that will perform this function for customers who need to securely erase data from a device.
Page 29
~ # /opt/vgc/bin/vgc-secure-erase -h vgc-secure-erase: 3.2.55402.C7 Utility to clear or purge Seagate X8 Accelerator drive partitions Usage : vgc-secure-erase [-c|--clear] [-y|--yes] <partition> vgc-secure-erase [-p|--purge] [-y|--yes] <partition> vgc-secure-erase -h|--help Options: -c | --clear : clear (Erase) the contents of the partition. This is the default option.
HROUGH Seagate X8 Accelerator devices can be used in pass-through mode on ESXi hosts. They can be added as a PCI device to a Linux or Windows Guest VM. In such cases, it is required that the Guest VM have the Guest OS (Windows or Linux) specific drivers installed.
Page 31
After adding 4 vmdks using VM "Edit Settings" will see VM properties hardware tab shows as below X8 A EAGATE CCELERATOR FOR WARE UIDE...
11.0 D YNAMIC HROTTLING Dynamic throttling prevents unplanned or abrupt device shutdowns by lowering the IO performance of devices if power consumption and/ or temperature of increases. Dynamic throttling is split into parts: thermal and power throttling. 11.1 HERMAL HROTTLING Thermal throttling reduces IO performance of X8 Accelerator devices if temperature goes above the default threshold (T[throttle], default: 78°C).
If this condition occurs a message similar to the following will be logged: kernel: INFO: task vgc_mtwa0:13866 blocked for more than 120 seconds. If this condition is encountered, run vgc-diags to collect debugging information for Seagate support personnel and then re- boot the system.
NBOARD IAGNOSTIC There are two onboard LEDS on the Seagate X8 Accelerator device. They are visible through the back bracket and always indicate the state of the system. The following table explains what each combination of these LEDs indicates: 14.0 C...
Page 35
Using vgc-secure-erase for Purging Data on the Drive 24 Hardware Installation 5 X8 Accelerator Firmware Downgrade Procedure 13 Install/Update Driver Using VUM 8 Install/Update Driver VIBs 7 Install/Update Seagate Driver Using VMware vSphere Update Manager (VUM) 8 Install/Update Seagate Driver VIBs Using Offline VIB Bundle 7 Introduction 4...
Page 36
Seagate Technology LLC 10200 South De Anza Boulevard, Cupertino, California 95014, United States, 408-658-1000 ASIA/PACIFIC Seagate Singapore International Headquarters Pte. Ltd. 7000 Ang Mo Kio Avenue 5, Singapore 569877, 65-6485-3888 EUROPE, MIDDLE EAST AND AFRICA Seagate Technology SAS 16-18 rue du Dôme, 92100 Boulogne-Billancourt, France, 33 1-4186 10 00 Publication Number: 100728270, Rev.