WIXLIB

Hitachi Storage Connector for CiscoUCS DirectorUser’s Guidev02.1.0FASTFIND LINKSSupported Storage SystemsDocument OrganizationGetting HelpContentsMK-92ADPTR089-03

2016 Hitachi, Ltd. All rights reserved.No part of this publication may be reproduced or transmitted in any form or by anymeans, electronic or mechanical, including copying and recording, or stored in adatabase or retrieval system for commercial purposes without the express writtenpermission of Hitachi, Ltd., or Hitachi Data Systems Corporation (collectively“Hitachi”). Licensee may make copies of the Materials provided that any such copy is: (i)created as an essential step in utilization of the Software as licensed and is used in noother manner; or (ii) used for archival purposes. Licensee may not make any othercopies of the Materials. “Materials” mean text, data, photographs, graphics, audio,video and documents.Hitachi reserves the right to make changes to this Material at any time without noticeand assumes no responsibility for its use. The Materials contain the most currentinformation available at the time of publication.Some of the features described in the Materials might not be currently available. Referto the most recent product announcement for information about feature and productavailability, or contact Hitachi Data Systems Corporation at https://portal.hds.com.Notice: Hitachi products and services can be ordered only under the terms andconditions of the applicable Hitachi agreements. The use of Hitachi products isgoverned by the terms of your agreements with Hitachi Data Systems Corporation.Hitachi is a registered trademark of Hitachi, Ltd., in the United States and othercountries.AIX, AS/400e, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, eServer,FICON, FlashCopy, IBM, Lotus, MVS, OS/390, PowerPC, RS/6000, S/390, System z9,System z10, Tivoli, z/OS, z9, z10, z13, z/VM, and z/VSE are registered trademarks ortrademarks of International Business Machines Corporation.Active Directory, ActiveX, Bing, Excel, Hyper-V, Internet Explorer, the Internet Explorerlogo, Microsoft, the Microsoft Corporate Logo, MS-DOS, Outlook, PowerPoint,SharePoint, Silverlight, SmartScreen, SQL Server, Visual Basic, Visual C , VisualStudio, Windows, the Windows logo, Windows Azure, Windows PowerShell, WindowsServer, the Windows start button, and Windows Vista are registered trademarks ortrademarks of Microsoft Corporation. Microsoft product screen shots are reprinted withpermission from Microsoft Corporation.All other trademarks, service marks, and company names in this document or websiteare properties of their respective owners.

ContentsPreface . 7Intended Audience. 8Software Version . 8Release Notes . 8Document Organization . 8Referenced Documents . 9Document Conventions . 9Conventions for Storage Capacity Values . 10Getting Help . 11Comments . 111 Introduction. 13Supported Storage Systems. 14Required Storage System Microcode . 14Supported Configurations . 14Storage System Inventory . 16Storage System Licenses . 16Supported Tasks . 16Custom Tasks . 19ContentsHitachi Storage Connector for Cisco UCS Director User’s Guide3

2 System Requirements and Installation . 21Summary of Steps . 22Architecture . 23Required Hardware and Software . 24Supported Storage Agent Configurations . 24Agent Configuration Diagram . 25Hitachi Storage Agent Requirements . 26Install the Hitachi Storage Agent v02.1.0 (Powered by Metro). 26Deploy a Virtual Appliance . 26Install the Hitachi Storage Connector . 28Prerequisites. 28Install and Deploy the Connector. 28Create a Pod in Cisco UCS Director . 29Add Hitachi Storage Accounts to the Pod . 29Firewall Considerations . 30Test Connection to the Hitachi Storage Account . 313 Global Active Device . 33Prerequisites. 34Setup Remote Connections . 34Create GAD Pair . 344 Tasks . 37General Tasks . 38Create LDEV . 38Delete LDEV . 38Set As Command Device . 38Create Host Group . 38Delete Host Group . 39Add Host to Host Group . 394ContentsHitachi Storage Connector for Cisco UCS Director User’s Guide

Remove Host from Host Group . 39Add LUN Path to Host Group . 39Remove LUN Path from Host Group . 39Set Host Mode for Host Group . 39Format LDEV . 39Associate LUN as Datastore . 40Create Dynamic Pool . 40Expand Pool . 40Shrink Pool . 40Edit Pool . 40Delete Datastore . 40Delete Dynamic Pool . 40Get Storage Port WWPN . 41Local Replication Tasks. 41Create ShadowImage Pair . 41Create Thin Image Pair . 41Resync Pair . 41Restore Pair . 42Split Pair . 42Delete Pair. 42Remote Replication . 42Create GAD Pair . 42Split GAD Pair . 42Resync GAD Pair . 42Delete GAD Pair . 425 Logging and Troubleshooting . 43Logging . 44View Logs . 44View Storage Agent Log . 44Troubleshooting . 44ContentsHitachi Storage Connector for Cisco UCS Director User’s Guide5

Storage Connector for Cisco UCS Director . 44Hitachi Storage Agent v02.1.0 . 45Forward Logs for Assistance . 456 Excerpt from the CCI Guide . 49Setting the Command Device . 506ContentsHitachi Storage Connector for Cisco UCS Director User’s Guide

PrefaceThis document describes how to use the Hitachi Storage Connector for CiscoUCS Director.This preface includes the following information:Intended AudienceSoftware VersionRelease NotesDocument OrganizationReferenced DocumentsDocument ConventionsConventions for Storage Capacity ValuesGetting HelpCommentsPrefaceHitachi Storage Connector for Cisco UCS Director User’s Guide7

NoteThe use of Hitachi Storage Connector for Cisco UCS Directorand all other Hitachi Data Systems products is governed by theterms of your agreements with Hitachi Data Systems.Intended AudienceThis user guide addresses users of the Hitachi Storage Connector for CiscoUCS Director. This user guide is designed for experienced users of Cisco UCSDirector.We assume that the Administrator installing the Connector is well versed inadministration of Hitachi Storage subsystems, including creating accounts,licensing hardware, and configuring software and storage. Content related tothe administration of Hitachi storage is not duplicated in this document.Software VersionThis document revision applies to Hitachi Storage Connector for Cisco UCSDirector software version v02.1.0 and Cisco UCS Director version 5.4.0.0 and5.5.0.1.Release NotesRelease notes can be found on the documentation CD. Release notes containrequirements and more recent product information that may not be fullydescribed in this manual. Be sure to review the release notes before installation.Document OrganizationThe following table provides an overview of the contents and organization ofthis document. Click the chapter title in the left column to go to that chapter.The first page of each chapter provides links to the sections in that chapter.Chapter8DescriptionIntroductionDescription of supported storage systems, tasks,and workflowsSystem Requirementsand InstallationOverview of installation process, required hardwareand software, and installation of the Hitachi StorageAgent (REST-based web service) and the Connectorfor Cisco UCS DirectorWorkflows and TasksImport workflows, set task inputs, and validateworkflowsLogging andTroubleshootingLog name, location, and forwarding instructions.Troubleshooting information for Hitachi StorageAgent and the Connector for Cisco UCS DirectorPrefaceHitachi Storage Connector for Cisco UCS Director User’s Guide

Referenced Documents#NameDescription1Global-Active Device UserGuide MK-92RD8072Describes and provides instructions for usingthe global-active device (GAD) feature of theHitachi Virtual Storage Platform G1000 (VSPG1000) and Hitachi Virtual Storage PlatformG200, G400, G600, G800 (VSP G200, G400,G600, G800) storage systems.2Metro REST APISpecification Version 3.2.0,SDK-95REST001-03Specification for the REST API which is thefoundation of the Storage Agent.Document ConventionsThis document uses the following typographic conventions:ConventionDescriptionBoldIndicates text on a window, other than the window title,including menus, menu options, buttons, fields, and labels.Example: Click OK.ItalicIndicates a variable, which is a placeholder for actual textprovided by the user or system. Example: copy source-filetarget-fileNote: Angled brackets ( ) also indicate variables.screen/codeIndicates text on the screen or that you enter.Example: # pairdisplay -g oradb angledbracketsIndicates a variable, which is a placeholder for actual textprovided by the user or system. Example: # pairdisplay -g group Note: Italic font also indicates variables.[ ] squarebracketsOptional values. Example: [a b] indicates that you can selecta, b, or nothing.{ } bracesRequired or expected values. Example: { a b } indicates thatyou must select either a or b. vertical barA choice between two or more options or arguments.Examples:[a b] indicates that you can select a, b, or nothing.{ a b } indicates that you must select either a or b.PrefaceHitachi Storage Connector for Cisco UCS Director User’s Guide9

This document uses the following icons to draw attention to information:IconLabelDescriptionNoteCalls attention to important and/or additionalinformation.TipProvides helpful information, guidelines, or suggestionsfor performing tasks more effectively.CautionWarns the user of adverse conditions and/orconsequences (for example, disruptive operations).WARNINGWarns the user of severe conditions and/orconsequences (for example, destructive operations).Conventions for Storage Capacity ValuesPhysical storage capacity values (for example, disk drive capacity) arecalculated based on the following values:Physical Capacity UnitValue1 KB1,000 bytes1 MB1,0002 bytes1 GB1,0003 bytes1 TB1,0004 bytes1 PB1,0005 bytes1 EB1,0006 bytesLogical storage capacity values (for example, logical device capacity) arecalculated based on the following values:Logical Capacity Unit1 KB1,024 (210) bytes1 MB1,024 KB or 1,0242 bytes1 GB1,024 MB or 1,0243 bytes1 TB1,024 GB or 1,0244 bytes1 PB1,024 TB or 1,0245 bytes1 EB1,024 PB or 1,0246 bytes1 BLOCK10Value512 bytesPrefaceHitachi Storage Connector for Cisco UCS Director User’s Guide

Getting HelpThe Hitachi Data Systems Support Center staff is available 24 hours a day,seven days a week. Provisions for patches and fixes are restricted to normalbusiness hours, 8 a.m. to 5 p.m. PST.To reach us, visit the support website for current telephone numbers and othercontact information: http://www.hds.com/services/support/.Before calling the Hitachi Data Systems Support Center, provide as muchinformation about the problem as possible, including:The circumstances surrounding the error or failure.The exact content of any error messages displayed on the host systems.Logging information as detailed in the Logging and Troubleshooting sectionof this document.CommentsPlease send us your comments on this document: doc.comments@hds.com.Include the document title, number, and revision, and refer to specific section(s)and paragraph(s) whenever possible. Thank you!(All comments become the property of Hitachi Data Systems Corporation.)PrefaceHitachi Storage Connector for Cisco UCS Director User’s Guide11

12PrefaceHitachi Storage Connector for Cisco UCS Director User’s Guide

IntroductionThe Hitachi Storage Connector for Cisco UCS Director supports tasks that youcan use for inventory, for orchestration, and in workflows. To aid in storagemanagement and troubleshooting, the Storage Connector for Cisco UCSDirector provides system logging options and troubleshooting support.This chapter contains the following sections:Supported Storage SystemsSupported TasksIntroductionHitachi Storage Connector for Cisco UCS Director User’s Guide13