Dell Fluid Cache for DAS Quick Start Manual

Download

Page 1

Dell Fluid Cache For DAS Quick Start Guide

Page 2

Notes, Cautions, and Warnings

NOTE: A NOTE indicates important information that helps you make better use of your computer.

CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.

WARNING: A WARNING indicates a potential for property damage, personal injury, or death.

Trademarks used in this text: Dell™, the Dell logo, Dell Boomi™, Dell Precision™ , OptiPlex™, Latitude™, PowerEdge™, PowerVault™, PowerConnect™, OpenManage™, EqualLogic™, Compellent™, KACE™, FlexAddress™, Force10™ and Vostro™ are trademarks of Dell Inc. Intel®, Pentium®, Xeon®, Core® and Celeron® are registered trademarks of Intel Corporation in the U.S. and other countries. AMD is a registered trademark and AMD Opteron™, AMD Phenom™ and AMD Sempron™ are trademarks of Advanced Micro Devices, Inc. Microsoft®, Windows®, Windows Server®, Internet Explorer®, MS-DOS®, Windows Vista® and Active Directory® are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat® and Red Hat Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell® and SUSE® are registered trademarks of Novell Inc. in the United States and other countries. Oracle® is a registered trademark of Oracle Corporation and/or its affiliates. Citrix®, Xen®, XenServer® and XenMotion® are either registered trademarks or trademarks of Citrix Systems, Inc. in the United States and/or other countries. VMware trademarks of VMware, Inc. in the United States or other countries. Corporation.

2013 - 03

Virtual SMP

vMotion

is a registered trademark of International Business Machines

IBM

vCenter

and

vSphere

are registered trademarks or

Rev. A00

Page 3

Contents

Notes, Cautions, and Warnings...................................................................................................2

1 Getting Started With Dell Fluid Cache For DAS.....................................................................5

Hardware Prerequisites For Installing Fluid Cache For DAS....................................................................................5

Software And Firmware Prerequisites For Installing Fluid Cache............................................................................5

Licensing Information...............................................................................................................................................6

Downloading Fluid Cache For DAS...........................................................................................................................6

Installing Fluid Cache For DAS ................................................................................................................................7

Uninstalling Fluid Cache For DAS.............................................................................................................................8

Related Documentation............................................................................................................................................9

Contacting Dell.........................................................................................................................................................9

Documentation Feedback.........................................................................................................................................9

Page 4

Page 5

Getting Started With Dell Fluid Cache For DAS

Fluid Cache for DAS monitors your cache usage, protects your writes, programmatically moves data blocks in and out of the cache as needed, and does it all transparently to the application.

The following steps provide a broad summary to configure and run Fluid Cache for DAS:

1. Add up to four PCIe SSDs to the Dell PowerEdge system.

NOTE: Ensure that all the four PCIe SSDs are of the same capacity.

2. Configure the PCIe SSDs to create a cache pool.

3. Enable caching of back end PERC virtual disks or partitions.

4. Point your applications to the Fluid Cache block device(s) instead of the back end storage.

5. When workload requirements change, dynamically disable or enable caching on disks.

Hardware Prerequisites For Installing Fluid Cache For DAS

• Fluid Cache is supported only on Dell PowerEdge systems that support Dell PowerEdge Express Flash PCIe SSDs. These PowerEdge systems include PowerEdge R620, R720, R820, and T620.

• Supported PowerEdge RAID Controller (PERC) cards include PERC H810, H710P, and H710.

• A minimum of two PCIe SSDs are required for write-back support.

• For installing Fluid Cache for DAS, you need 100 MB of disk space.

• The supported PCIe SSD capacities are 175 GB and 350 GB.

NOTE: You cannot mix PCIe SSDs of different capacities to run Fluid Cache for DAS. You can add up to four PCIe SSDs of the same capacity to form the cache pool.

• The minimum memory required to run Fluid Cache for DAS is 16 GB. For optimum operation, it is recommended that you install 32 GB of RAM.

NOTE: PCIe SSDs in Write Protect mode cannot be used for the cache pool and are marked as invalid.

Software And Firmware Prerequisites For Installing Fluid Cache

The supported operating systems for Fluid Cache for DAS include:

• Red Hat Enterprise Linux 6.2, 2.6.32-220.el6.x86_64.

• Red Hat Enterprise Linux 6.3, 2.6.32-279.el6.x86_64.

• SUSE Linux Enterprise Server 11 SP2, 3.0.13-0.27 (default).

Other software and firmware prerequisites include:

• Dell OpenManage Storage Administrator version 7.1.2 only.

• Latest updated PCIe SSD driver downloaded and installed from dell.com/support.

NOTE: For information on managing PCIe SSDs using Dell OpenManage Server Administrator, see the

PowerEdge Express Flash PCIe SSD User’s Guide

• Latest firmware for PERC H810, H710P, and H710 cards. Supported firmware is A03 21.1.0-0007 or higher.

Ensure the following opensource component packages are available in your system before you install Fluid Cache. See the operating system distribution media for the supported version of each package.

at dell.com/support/manuals.

Dell

Page 6

Table 1. Operating System Packages

Operating System Package Name Package Version

Red Hat Enterprise Linux 6.2 and 6.3 perl-XML-LibXML 1.70 – 5.el6

perl-XML-NamespaceSupport 1.10 – 3.el6

perl-XML-SAX 0.96 – 7.el6

rrdtool 1.3.8 – 6.el6

sg3_utils 1.28 – 4.el6

libxslt 1.1.26 – 2.el6

libuuid 2.17.2 – 12.el6

SUSE Linux Enterprise Server 11 SP2 perl-XML-LibXML 1.66 – 1.14

perl-XML-NamespaceSupport 1.09 – 1.22

perl-XML-SAX 0.96 – 2.7

rrdtool 1.3.4 – 2.8

sg3_utils 1.31 – 1.11.14

libxslt 1.1.24 – 19.15

libuuid1 2.19.1 – 6.29.3

Licensing Information

Dell Fluid Cache for DAS is only functional when a valid license is installed. A license for Fluid Cache for DAS is only available through Dell Sales. For customers located in the United States of America, call 1-800-WWW-DELL. For other countries, login to dell.com and change your country from the bottom of the web page to get the sales number.

The following licenses are available:

• A 90-day evaluation license which offers full functionality for 90 days. You cannot extend the evaluation period or make changes to Fluid Cache after the 90 days have expired.

• A perpetual license that must be installed on each node.

You can view your Fluid Cache license in OpenManage Server Administrator.

NOTE: After the order is processed, you are provided with the license for Fluid Cache for DAS in an e-mail. To install a license, at the prompt, run the command: fldc --apply --license (include the path to the license_file). If a previous license exists, the new license overwrites it.

Downloading Fluid Cache For DAS

To download Dell Fluid Cache for DAS software:

1. Go to dell.com/support.

2. You may be asked to select your line of business. Select Support for Enterprise IT.

3. Enter your Dell PowerEdge Service Tag and click Submit.

4. Navigate to the Drivers & Downloads section.

5. Select your operating system.

Page 7

6. Click Caching Solutions to expand the menu.

Fluid Cache for DAS software is listed. Click the link to download the software.

Installing Fluid Cache For DAS

You can install Fluid Cache for DAS using the Fluid Cache setup.sh shell script. When you run the installation script, it uses the options you provide. If the installation script encounters missing dependencies or discovers other issues with your installation, it stops and an error message is displayed. Follow the on-screen prompts and system messages to correct any issues. Rerun the setup.sh shell script to restart the installation. After the installation completes, configure your Fluid Cache for DAS environment.

1. Go to dell.com/support.

2. Download and extract the Fluid Cache tar.gz package into a directory of your choice.

See the topic “Downloading Fluid Cache For DAS” in the support/manuals.

3. Change (cd) to the root of that directory:

a) Locate the

example: /tmp/fluidcache_node_license.xml

To obtain the license, see the topic “Licensing Information” in the dell.com/support/manuals.

b) From the prompt, run the command: ./setup.sh

The End User License Agreement (EULA) is displayed.

<name>_license.xml

file and write down the fully qualified path to the license file, for

Dell Fluid Cache For DAS User's Guide

at dell.com/

4. Read the EULA.

At the bottom of the EULA page, the following message is displayed: Do you agree to the above

license terms? ('y' for yes | press 'Enter' to exit):

5. To accept the EULA, type y and press <Enter>.

At the prompt, the following options are displayed:

Type i to install Fluid Cache Type q to quit

6. Type i to install the product.

7. At the prompt, type a Fluid Cache Identifier of your choice and press <Enter> or accept the default FQDN and press <Enter>.

The install wizard prompts you to confirm that you have entered the correct information with the following message:

Do you want to continue with these settings? ('y' for yes | 'r' to reconfigure | 'q' to quit install):

NOTE: By default, the Fluid Cache Identifier is the hostname of the system on which you are installing Fluid Cache. The installation script allows you to enter a customized name for the Fluid Cache installation that helps you identify the cache subsystem. After entry, the name is repeated in various future system messages.

8. To accept the settings for Fluid Cache for DAS, type y and press <Enter>.

9. At the prompt, enter a fully qualified path to a valid license file and press <Enter>.

The license file is the XML file you received as an attachment in your Dell order e-mail and copied to a temporary directory on the target server.

NOTE: When you enter your license file name, be sure to include the path. For example: /tmp/

fluidcache_node_license.xml

Page 8

The installation script provides a summary of all the installation variables you have chosen up to this point. You must confirm that the information is correct before continuing. Then, at the prompt, the script asks whether you want to start the Fluid Cache service with the message: Would you like to start Fluid Cache

now? ('y' for yes | 'n' for no and exit install):

10. To start the Fluid Cache service, type y and press <Enter>.

11. To ensure that the product has started successfully, run the command: /opt/dell/fluidcache/bin/fldc

--status

This command returns a set of information similar to the following:

Fluid Cache Service

Cache size: 0 GiB

Status: ok

SSDs in Cache: 0

Disk being cached: 0

Write Back: unavailable

Cache ID: <any node>.example.com

License: node – limited to 4 nodes

License Status: valid

SSDs in cache No SSDs are configured in the cache

pool

Disks being cached No Disks are being cached

Fluid Cache for DAS is successfully installed. You must now configure Fluid Cache for DAS. See the topic “Configuring And Managing Fluid Cache For DAS” in the support/manuals. If the installation was not successful, the following error message is displayed: bash: /opt/

dell/fluidcache/bin/fldc: No such file or directory

“Fluid Cache Installation Fails” in the

Dell Fluid Cache For DAS User's Guide

. To resolve the issue, see the topic

at dell.com/support/manuals.

at dell.com/

Uninstalling Fluid Cache For DAS

Use Dell OpenManage Server Administrator or the fldc tool to disable caching on the back end disks.

1. To disable using fldc, at the prompt, run the command: fldc --disable --disk=<disk_name>

NOTE: Run this command for each configured disk.

2. Remove all cache devices from the cache pool. To remove a PCIe SSD, run the command: fldc --remove --

ssd=<ssd_name>

NOTE: Run this command for each configured disk.

3. Run the command: rpm -qa | grep DAS to get the Fluid Cache for DAS package name.

4. Use the rpm -e command to remove the Fluid Cache for DAS package from the server. For example, run the command:

5. Optionally, you can remove the /opt/dell/fluidcache directory to remove all components of Fluid Cache for DAS from your installation. At the prompt, run the command: rm -rf /opt/dell/fluidcache

rpm –e <extract_package_name>

Page 9

NOTE: If you attempt to reinstall Fluid Cache, you may see a warning message that advises that you have had a previous configuration. You cannot clear that warning and install FluidCache unless you remove the FluidCache directory. Remove the FluidCache directory after you are sure that all data previously managed by Fluid Cache is secure.

Fluid Cache for DAS is now uninstalled.

Contacting Dell

NOTE: Dell provides several online and telephone-based support and service options. If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog. Availability varies by country and product, and some services may not be available in your area.

To contact Dell for sales, technical support, or customer-service issues:

1. Go to dell.com/contactdell.

2. Select your country or region from the interactive world map.

When you select a region, the countries for that region are displayed.

3. Select the appropriate language under the country of your choice.

4. Select your business segment.

The main support page for the selected business segment is displayed.

5. Select the appropriate option depending on your requirement.

NOTE: If you have purchased a Dell system, you may be asked for the Service Tag.

Documentation Feedback

If you have feedback for this document, write to documentation_feedback@dell.com. Alternatively, you can click on the Feedback link in any of the Dell documentation pages, fill up the form, and click Submit to send your feedback.