Intel® Cache Acceleration Software v3.8 for Linux* Administrator Guide December 2018 Document Number: 328496-029US Intel® Cache Acceleration Software for Linux* v3.8 Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined". Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. No computer system can provide absolute security. Requires an enabled Intel® processor, enabled chipset, firmware and/or software optimized to use the technologies. Consult your system manufacturer and/or software vendor for more information. Intel technologies’ features and benefits depend on system configuration and may require enabled hardware, software or service activation. Performance varies depending on system configuration. Check with your system manufacturer or retailer or learn more at intel.com. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. All products, computer systems, dates, and figures specified are preliminary based on current expectations, and are subject to change without notice. Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries. *Other names and brands may be claimed as the property of others. Copyright © 2018 Intel Corporation. All rights reserved. Administrator Guide December 2018 2 328496-029US Intel® Cache Acceleration Software for Linux* v3.8 Contents 1 Introduction ................................................................................................................................................................... 6 1.1 Intel® CAS Overview ................................................................................................................................................................ 6 1.2 New Features in this Release .............................................................................................................................................. 7 1.3 Documentation Conventions .............................................................................................................................................. 7 1.4 References ................................................................................................................................................................................... 7 1.5 Revision History ........................................................................................................................................................................ 7 2 Product Specifications and System Requirements ............................................................................................... 9 2.1 Supported Operating Systems........................................................................................................................................... 9 2.2 System Requirements ............................................................................................................................................................ 9 3 Installing Intel® CAS ................................................................................................................................................... 11 3.1 Disabling Sleep States ........................................................................................................................................................ 11 3.2 Configuring the Flash Device ........................................................................................................................................... 11 3.3 DKMS Installation .................................................................................................................................................................. 11 3.4 Local Server Installation ..................................................................................................................................................... 12 3.5 Upgrading Intel® CAS ........................................................................................................................................................... 13 3.6 Uninstalling the Software .................................................................................................................................................. 13 3.7 Advanced Installation Options ........................................................................................................................................ 14 3.8 Intelcas-Ansible Installation ............................................................................................................................................. 14 4 Configuring Intel® CAS ............................................................................................................................................... 17 4.1 Intel® CAS Configuration File - /etc/intelcas/intelcas.conf ................................................................................. 17 4.2 The Intel® CAS Configuration Utility - casadm ........................................................................................................ 19 4.3 Using the Configuration Utility ........................................................................................................................................ 19 4.4 Manual Configuration for Write-through Mode ...................................................................................................... 19 4.5 Manual Configuration for Write-back Mode ............................................................................................................. 20 4.6 Manual Configuration for Write-around Mode ........................................................................................................ 20 4.7 Manual Configuration for Pass-through Mode ........................................................................................................ 21 4.8 Switching Caching Modes.................................................................................................................................................. 21 4.9 Automatic Partition Mapping ........................................................................................................................................... 21 4.10 Mounting an Intel® CAS Device as a Data Volume ................................................................................................. 21 5 Running Intel® CAS ..................................................................................................................................................... 23 5.1 Initial configuration of Cache instances ...................................................................................................................... 23 5.2 Startup of Cache instances ............................................................................................................................................... 23 5.3 Rebooting, Power Cycling, and Intel® CAS Autostart ............................................................................................ 23 5.4 Stopping Cache Instances ................................................................................................................................................. 24 5.5 Disabling Intel® CAS ............................................................................................................................................................. 24 5.6 Handling an Unplanned Shutdown ............................................................................................................................... 24 5.7 Device IO Error Handling ................................................................................................................................................... 25 6 IO Classification .......................................................................................................................................................... 26 6.1 IO Class Configuration ........................................................................................................................................................ 26 7 Advanced Options ...................................................................................................................................................... 27 7.1 Many-to-one Option ............................................................................................................................................................ 27 7.2 Multi-Level Caching .............................................................................................................................................................. 28 7.3 Linux* LVM support .............................................................................................................................................................. 29 7.4 Trim Support ..........................................................................................................................................................................