Hitachi Unified Compute Platform (UCP) Advisor Notes ... Hitachi Unified Compute Platform (UCP)...

MK-92UCP098-01

Hitachi Unified Compute Platform (UCP) Advisor Deployment Guide

v01.1.0

Document Organization

Getting Help

Contents

FASTFIND LINKS

© 2016 Hitachi, Ltd. All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or stored in a database or retrieval system for any purpose without the express written permission of Hitachi, Ltd.

Hitachi, Ltd., reserves the right to make changes to this document at any time without notice and assumes no responsibility for its use. This document contains the most current information available at the time of publication. When new or revised information becomes available, this entire document will be updated and distributed to all registered users.

Some of the features described in this document might not be currently available. Refer to the most recent product announcement for information about feature and product availability, or contact Hitachi Data Systems Corporation at https://portal.hds.com.

Notice: Hitachi, Ltd., products and services can be ordered only under the terms and conditions of the applicable Hitachi Data Systems Corporation agreements. The use of Hitachi, Ltd., products is governed by the terms of your agreements with Hitachi Data Systems Corporation.

Hitachi is a registered trademark of Hitachi, Ltd., in the United States and other countries. Hitachi Data Systems is a registered trademark and service mark of Hitachi, Ltd., in the United States and other countries.

Archivas, Essential NAS Platform, HiCommand, Hi-Track, ShadowImage, Tagmaserve, Tagmasoft, Tagmasolve, Tagmastore, TrueCopy, Universal Star Network, and Universal Storage Platform are registered trademarks of Hitachi Data Systems Corporation.

AIX, AS/400, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, ESCON, FICON, FlashCopy, IBM, Lotus, MVS, OS/390, RS6000, S/390, System z9, System z10, Tivoli, VM/ESA, z/OS, z9, z10, zSeries, z/VM, and z/VSE are registered trademarks or trademarks of International Business Machines Corporation.

All other trademarks, service marks, and company names in this document or website are properties of their respective owners.

Microsoft product screen shots are reprinted with permission from Microsoft Corporation.

https://portal.hds.com/

Contents 3


Contents

Preface ............................................................................ 7

Intended Audience ................................................................ 8

Related Products ................................................................... 8

Release Notes ....................................................................... 8

Document Organization .......................................................... 9

Reference Documents ............................................................ 9

Document Conventions ......................................................... 10

Convention for Storage Capacity Values .................................. 11

Getting Help ........................................................................ 11

1 Getting Started ............................................................... 13

About UCP Advisor ............................................................... 14

Task Checklist ..................................................................... 14

Prerequisites ....................................................................... 15

Software ........................................................................... 15

Supported Browsers for VMware vSphere Web Client 6.0 ......... 16

Memory and CPU Utilization ................................................. 16

Firewall Configuration Required by UCP Advisor ...................... 16

Support Matrix ................................................................... 17

4 Contents


Deploying UCP Advisor ......................................................... 18

Configuring Dependencies for UCP Advisor ............................ 18

Deploying the UCP Advisor Virtual Appliance .......................... 20

Using the ToolBox Deployment Tool ...................................... 22

Configuring UCP Advisor ..................................................... 24

Installing the V2I vCenter Plug-In ........................................ 25

Navigating to the UCP Advisor Plug-In .................................. 25

Performing an On Board Operation ......................................... 26

Pointing UCP Advisor Devices to the Same NTP Server ............ 27

Creating a Scheduled Backup .............................................. 27

Working with the Navigator ................................................. 28

2 Configuration and Management ......................................... 29

Managing UCP Advisor .......................................................... 30

Managing Multiple UCP Systems ........................................... 30

Managing Administration ..................................................... 30

Managing Virtual/Logical Resource ....................................... 31

Managing Storage Devices .................................................. 31

Managing Network Switch Devices ........................................ 32

Managing Compute Devices ................................................. 32

Managing VM Backup and Recovery ...................................... 32

Monitoring UCP Devices ...................................................... 33

Obtaining and Applying a Permanent License ......................... 33

Working with PowerShell Cmdlets in UCP Advisor ................... 33

Working with vRO .............................................................. 36

Working with vRLI .............................................................. 37

Adding Devices .................................................................. 38

Adding a Switch ................................................................. 38

Configuring SNMP for Adding a Switch .................................. 39

Uploading the Firmware Bundle .............................................. 40

Upgrading the Device Firmware ............................................. 41

Contents 5


3 Troubleshooting .............................................................. 43

Troubleshooting vRLI ............................................................ 44

Accepting the SSL certificate ............................................... 44

Configuring vRLI ................................................................ 44

Troubleshooting UCP Advisor Session Timeouts ........................ 45

Troubleshooting a System Error When Running ToolBox ............ 46

Troubleshooting UCP Advisor After Running the Installer ........... 47

Troubleshooting Slow Performance ......................................... 47

6 Contents


Getting Started 7


Preface

Intended Audience Related Products Release Notes Document Organization Reference Documents Document Conventions Convention for Storage Capacity Values Getting Help Comments

Note The use of Hitachi Unified Compute Platform (UCP) Advisor and

all other Hitachi Data Systems products is governed by the terms of your agreements with Hitachi Data Systems.

8 Getting Started


Hitachi Unified Compute Platform (UCP) Advisor is software that provides features to ease system deployment and management of Hitachi UCP. This document describes the main functions, system requirements, and troubleshooting procedures to be followed when installing and using UCP Advisor.

This document is not a User’s Guide. Only installation and deployment procedures are covered.

Intended Audience

This document is intended for those responsible for deploying UCP Advisor.

Administrators should have storage, networking, server, and virtualization experience. This document's content is restricted to UCP Advisor deployment and troubleshooting.

Related Products

VMware administrators and Hitachi Storage Administrators familiar with the supported Hitachi subsystems and servers, and VMware software, including the following:

Hitachi Storage Connector for VMware vRealize Orchestrator Hitachi Compute Connector for VMware vRealize Orchestrator Hitachi Storage Adapter for VMware vRealize Log Insight Hitachi Compute Adapter for vRealize Log Insight Hitachi Infrastructure Adapter for Microsoft Windows PowerShell Hitachi Virtual Infrastructure Integrator VMware vCenter VMware ESXi VMware vRealize Orchestrator VMware vRealize Log Insight

Release Notes

Release notes are on the documentation CD. Release notes contain requirements and more recent product information that may not be fully described in this manual. Be sure to review the release notes before installation.

Getting Started 9


Document Organization

The following table provides an overview of the contents and organization of this document. Click the chapter name in the left column to go to that chapter. The first page of each chapter provides links to the sections in that chapter.

Chapter Description

Getting Started Provides procedures on how to run the UCP Advisor ToolBox, perform UCP Advisor Batch Configuration (ABC), add devices, and perform other tasks involved in a basic UCP Advisor configuration

Configuration and Management

Provides descriptions of UCP Advisor features

Troubleshooting Provides troubleshooting information for UCP Advisor, addressing common issues that arise when running the product

Reference Documents

Hitachi Compute Connector for VMware vRealize Orchestrator Server User’s Guide, MK-92ADPTR078-04

Hitachi Storage Connector for VMware vRealize Orchestrator Storage User’s Guide, MK-92ADPTR076-04

Hitachi Infrastructure Adapter for Microsoft Windows PowerShell User’s Guide – MK-92ADPTRXXX-00

Hitachi Virtual Infrastructure Integrator Quick Start Guide, MK-92ADPTR132-00

Hitachi Storage Content Pack for VMware vRealize Log Insight User’s Guide, MK-92ADPTR100-03

Hitachi Compute Content Pack for VMware vRealize Log Insight User’s Guide, MK-92ADPTR098-03

Provisioning Guide for Hitachi Virtual Storage Platform Gx00 and Fx00 Models, MK-94HM8014-04

10 Getting Started


Document Conventions

This document uses the following typographic conventions:

Convention Description

Bold Indicates text on a window, other than the window title, including menus, menu options, buttons, fields, and labels. Example: Click OK.

Italic Indicates a variable, which is a placeholder for actual text provided by you or the system. Example: copy source-file target-file

screen/code Indicates text on screen or that you enter Example: # pairdisplay -g oradb

< > angled brackets

Indicates a variable, which is a placeholder for actual text provided by you or the system. Example: # pairdisplay -g <group>

[ ] square brackets

Indicates optional values. Example: [ a | b ] indicates that you can choose a, b, or nothing.

{ } braces Indicates required or expected values. Example: { a | b } indicates that you must choose either a or b.

| vertical bar Indicates that you have a choice between two or more options or arguments. Examples: [ a | b ] indicates that you can choose a, b, or nothing. { a | b } indicates that you must choose either a or b.

This document uses the following icons to draw attention to information:

Icon Label Description

Note Calls attention to important and/or additional information

Tip Provides helpful information, guidelines, or suggestions for performing tasks more effectively

Caution Warns you about adverse conditions and/or consequences (for example, disruptive operations)

WARNING Warns about severe conditions and/or consequences (for example, destructive operations)

Getting Started 11


Convention for Storage Capacity Values

We calculate physical storage capacity values (for example, disk drive capacity) based on the following values:

Physical Capacity Unit Value

1 KB 1,000 bytes 1 MB 1,0002 bytes 1 GB 1,0003 bytes 1 TB 1,0004 bytes 1 PB 1,0005 bytes 1 EB 1,0006 bytes

We calculate logical storage capacity values (logical device capacity) based on the following values:

Logical Capacity Unit Value

1 KB 1,024 (210) bytes 1 MB 1,024 KB or 1,0242 bytes 1 GB 1,024 MB or 1,0243 bytes 1 TB 1,024 GB or 1,0244 bytes 1 PB 1,024 TB or 1,0245 bytes 1 EB 1,024 PB or 1,0246 bytes 1 block 512 bytes

Getting Help

The Hitachi Data Systems Support Center staff is available 24 hours a day, seven days a week. Provisions for patches and fixes are restricted to normal business hours, 8 a.m. to 5 p.m. PST.

To reach us, visit the support website for current telephone numbers and other contact information: http://www.hds.com/services/support/. If you purchased this product from an authorized HDS reseller, contact that reseller for support.

Before calling the Hitachi Data Systems Support Center, provide as much information about the problem as possible, including the following:

The circumstances surrounding the error or failure. The exact content of any error messages displayed on the host systems.

http://www.hds.com/services/support/

12 Getting Started


Comments

Please send us your comments on this document: [email protected]. Include the document title, number, and revision, and refer to specific sections and paragraphs whenever possible.

Thank you! (All comments become the property of Hitachi Data Systems Corporation.)

mailto:[email protected]

Getting Started 13


Getting Started

About UCP Advisor Task Checklist Prerequisites Deploying UCP Advisor Performing an On Board Configuration

14 Getting Started


About UCP Advisor UCP Advisor is software that provides features to ease UCP system deployment and management, including the following:

UCP Advisor On Board Configuration (ABC): the ability to import existing configuration settings for UCP devices with values read from a .csv file.

Facilitates configuration of VMware software to function with UCP Compute server, Storage array, and Network switch devices, including vCenter, ESXi, vRealize Orchestrator, and vRealize Log Insight.

A vCenter plug-in that provides monitoring and configuration interfaces for UCP devices in the vSphere Web Client.

UCP Advisor is distributed as an OVA format VM template named UCP Advisor Virtual Appliance.

Task Checklist This section provides a high-level overview of how to install and configure UCP Advisor.

1. Obtain the location of the UCP Advisor OVA file from your Hitachi field engineer.

2. Ensure the ESXi 6.0.x hypervisor is installed and configured to deploy the UCP Advisor OVA appliance.

3. Ensure that you have installed and configured the required dependency product: vRO, vRLI and Hitachi Virtual Infrastructure Integrator (V2I).

a) Ensure your system complies with all requirements specified in the Prerequisites section.

b) Follow the steps required for configuring dependencies for UCP Advisor, as explained in Configuring Dependencies for UCP Advisor

4. Make sure that you have acquired a Microsoft Windows Server 2012 R2 Standard license. This license is required during deployment of the UCP Advisor Virtual Appliance..

5. Deploy the UCP Advisor Virtual Appliance, as explained in Deploying the UCP Advisor Virtual Appliance .

6. Apply the current operating system security patches to the UCP Advisor Virtual Appliance.

7. Launch the ToolBox from the UCP Advisor Virtual Appliance desktop, as explained in Using the ToolBox Deployment Tool.

Getting Started 15


8. Perform basic UCP Advisor configuration tasks, as explained in Configuring UCP Advisor.

9. Navigate to the UCP Advisor vSphere Web Client Plug-In, as explained in Navigating to the UCP Advisor Plugin.

10. Run the UCP Advisor On Board operation, as explained in Performing an On Board Configuration.

11. Use the UCP Advisor Dashboard to navigate to areas of the application where you want to perform tasks, as explained in Working with the Navigator.

12. Upgrade your 60-day demonstration license to a permanent license. See Obtaining and Applying a Permanent License for more information.

13. Install and configure the vCenter Update Manager (VUM) in another Windows machine for patch management of your vCenter and ESXi host.

Note • Review all operations performed for installation and

configuration of UCP Advisor, making sure that you completed them and that they ran successfully.

• Troubleshoot issues in the application, as explained in Troubleshooting.

• Ensure the VMware vCenter, VMware vRealize Orchestrator, VMware Log Insight, and UCP Advisor Windows appliances are configured with a trusted Network Time Protocol (NTP) server.

Prerequisites

Software

The following is software required for UCP Advisor. Prior to deploying UCP Advisor, ensure the required software is installed and configured.

VMware software Version

VMware vCenter Server Appliance 6.0.0 U2 (Build # 3620759) VMware vRealize Orchestrator 7.0.1.3533702 VMware vRealize Log Insight 3.3.2-3951163 VMware Update Manager 6.0.0.29963 VMware ESXi 6.0.0 U2 (Build # 3634788)

The following (optional) software is recommended for UCP Advisor.

16 Getting Started


VMware software Version

Hitachi Virtual Infrastructure Integrator (V2I)

3.1.44

Note V2I is not required for UCP Advisor to function. If V2I is not

installed, selecting Data Management Services from UCP Advisor's vSphere Web client screen will yield an error message. In addition, the functions provided by V2I, including VM backups and restores, will not be available.

Supported Browsers for VMware vSphere Web Client 6.0 Operating System Browser Vendor Browser Version

Windows Microsoft Internet Explorer

10.0.19 and later

Windows Mozilla Firefox 34 and later Windows Google Chrome 39 and later Mac OS Mozilla Firefox 34 and later Mac OS Google Chrome 39 and later

Note While UCP Advisor supports the VMware vSphere Web Client,

it does not support the VMware vSphere Client Windows C# application.

Memory and CPU Utilization CPU: four CPU cores RAM: 8 GB minimum; 16 GB recommended Disk space: 100 GB

Firewall Configuration Required by UCP Advisor

Though UCP Advisor depends on these open ports, they are pre-configured in the UCP Advisor Virtual Appliance. Manually opening them is not necessary.

Requirement for Port No. Type

UCP Advisor/vCenter 23011 TCP vRO/Converged 23021 TCP HiTrack 443 TCP

Syslog Agent for server 2055 TCP VI Service (for UCP-A vCenter Plug-In hot deployment) 23031 TCP

Getting Started 17


Requirement for Port No. Type

Log Bundle download 31001 TCP Solarwind TFTP 69 UDP Solarwind SFTP/SCP 22 TCP IPMI 623 UDP SNMP 161, 162 UDP SMASH 22 TCP SSH 22 TCP Telnet 23 TCP

Support Matrix

This section provides prerequisites required for installing and configuring.

Supported Appliance Model Version

Hitachi Unified Compute Platform 2000 (UCP), single rack configuration only

3.0

Hitachi Unified Compute Platform HC (Hyper Converged), single rack configuration only

1.0

Supported Devices

Compute

Model BMC Firmware

Rack Optimized Server for Solutions, 2U Four Node 3.42.00

Storage

Model Firmware

Hitachi Unified Storage VM 73-03-50-00/00 or newer Virtual Storage Platform 70-06-43-00/00 or newer Virtual Storage Platform G1000 80-05-00-00/01 or newer Virtual Storage Platform Gx00 83-03-24-20/00 or newer Virtual Storage Platform Fx00 83-03-01-20/00 or newer Virtual Storage Platform Gx00 Unified 83-04-01-40/00 or newer Virtual Storage Platform Fx00 SAN Connect 83-03-01-24-20/00 or newer Virtual Storage Platform Fx00 Unified Performance 83-03-01-24-20/00 or newer

Virtual Storage Platform G1500 80-05-01-00/00 or newer

18 Getting Started


Network

Model Firmware

Brocade 7450 08.0.30G Brocade 6740 Network OS 7.0.0a Brocade 6505 v7.4.1d Brocade 6510 v7.4.1d

Deploying UCP Advisor Configuring dependencies for UCP Advisor Deploying the UCP Advisor Virtual Appliance Using the ToolBox Deployment Tool Configuring UCP Advisor Installing the V2I vCenter Plug-In Navigating to the UCP Advisor Plug-n

Note Before beginning to deploy UCP Advisor, ensure that all the

Storage, Compute, and Network hardware meets the requirements specified in the support matrix.

Configuring Dependencies for UCP Advisor

UCP Advisor requires the following VMware products. Ensure that these products are installed and configured, prior to installing UCP Advisor.

Setting up a vCenter Appliance Setting up VMware vRealize Orchestrator Setting up vCenter Appliance and vRealize Orchestrator Integration Setting up VMware vRealize Log Insight Setting up Hitachi Virtual Infrastructure Integrator

Setting up a vCenter Appliance

See the Deploying the vCenter Server Appliance section in the VMware vSphere ESXi and vCenter Server 6.0 Documentation online document for information on deploying vRO, found on the VMware Web site:

http://www.vmware.com/


Getting Started 19


Setting up VMware vRealize Orchestrator

See the Download and Deploy the Orchestrator Appliance section in the Installing and Configuring VMware vRealize Orchestrator online document for information on setting up VMware vRealize Orchestrator, found on the VMware Web site:


Note Automatic log file collection depends on incoming ssh access to

VMware products. To use this feature, configure these VMware products to allow incoming ssh connections.

Setting up vCenter Appliance and vRealize Orchestrator Integration

You must register VMware vRealize Orchestrator (vRO) server with the following:

vCenter Single Sign-On entry portal vRO as an extension with a vCenter Server

To register vRO as an extension with vCenter Server, perform the following steps:

1. Log into the vRO client as an administrator.

2. Click Workflows to display the Workflows view.

3. In the workflows list, select the following path:

Library > vCenter > Configuration

4. Right-click Register vCenter Orchestrator as a vCenter Server extension workflow, and then click Start workflow.

5. Click the vCenter Server instance to register vRO with vCenter Server.

6. Enter the service URL of the vRO server.

7. Click Submit.

Setting up VMware vRealize Log Insight

After configuring UCP Advisor with vRLI, import the UCP Advisor Content Pack to the vRLI. The Content Pack file can be found in the following location in the UCP Advisor appliance:


20 Getting Started


C:\Program Files\Hitachi\UCP Advisor\HiLogInsightConverged\Content Packs\UCP Advisor Converged v01.0.0.vlcp

Also, import both the Microsoft Windows and the Brocade SAN & IP Networks content packs for Log Insight to vRLI and configure the content pack to monitor the UCP Advisor Windows appliance. To perform an import, you first need to download the content pack on the Login Site Content Pack Marketplace.

See the VMware vCenter Log Insight Installation and Administration Guide to set up VMware vRealize Log Insight (vRLI), found on the VMware Web site:


Setting up Hitachi Virtual Infrastructure Integrator

The V2I plug-in must be configured to complete the deployment. This requires a VM running Windows Server 2012 R2 Standard edition. See Hitachi Virtual Infrastructure Integrator Administration Guide (MK-92HNAS003-07) for instructions on installing and configuring V2I.

Deploying the UCP Advisor Virtual Appliance

1. Download the UCP Advisor OVA appliance file.

2. Log into the vSphere client.

3. In the Navigator, click Hosts and Clusters. The Hosts and Clusters datacenter list displays and expands.

4. Right-click the vCenter IP address at the top of the Navigator. The vSphere client displays a popup menu.

5. Click the option Deploy OVF Template.

The vSphere Web Client displays the Deploy OVF Template window.


Getting Started 21


6. Check the Local file radio button.

7. Click Browse. The vSphere Web Client displays a directory of OVA files (with .ova extensions).

8. Select the following filename

Hitachi-Unified-Compute-Platform-Advisor-Appliance-01.1.0.ova

9. Click Next. A screen displays with fields for the VM name and Datastore location.

10. Enter the VM name and Datastore location.

11. Provide the VM name, and then select the inventory location (Datacenter).

12. Click the ESXi host or cluster, and then select the Datastore for the UCP Advisor VM.

13. Select the Disk Format that is most conventional in the deployment environment.

14. Enter a hostname, an IP address, and credentials, and then click Finish in the Ready to Complete window.

15. Power on the UCP Advisor appliance VM.

16. Open the UCP Advisor appliance VM console.

a) Configure the time zone.

b) Apply the Microsoft Windows server 2012 R2 standard license.

22 Getting Started


c) Configure the administrator password.

d) Log in with administrator credentials.

PowerShell script launches to configure provided hostname, IP address and reboots UCP Advisor VM

e) Log in to the VM with administrator credentials.

The PowerShell script launches again to create a self-signed certificate and bind all UCP Advisor HTTPS ports.

Note If the PowerShell script fails to configure the hostname and IP

address provided during OVA deployment, configure it manually and run the InitializeUcpAdvisorRunningEnvironment.bat file located under the UCP Advisor support directory to create a self-signed certificate and bind all necessary HTTPS ports.

Using the ToolBox Deployment Tool

ToolBox is accessible from the UCP Advisor Virtual Appliance desktop, which assists with UCP Advisor configuration.

ToolBox performs the following primary operations: Configures UCP Advisor plugin with vCenter connection information. Adds a UCP System. Configures UCP Advisor vRO plugin and adds vRO connection

information. Configures UCP Advisor with vRLI connection information. Creates a storage array command device and presents it to the UCP

Advisor Virtual Appliance.

Locate the UCP Advisor ToolBox deployment tool icon on the UCP Advisor Virtual Appliance Windows desktop, and then double-click it.

The UCP Advisor Management Deployment Toolbox screen displays as shown in the following figure.

Getting Started 23


The ToolBox includes five input areas. By populating every ToolBox area, it is possible to perform a deployment in one session. The five input areas are as follows:

UCP Advisor vCenter Plugin UCP System vRealize Orchestrator vRealize Log Insight Create Storage Array Command Device

You can use ToolBox to perform the following operations: Deploy the vCenter Plug-In. Create a storage array command device. Deploy the vCenter Plug-In and create a storage array command

device.

24 Getting Started


Configuring UCP Advisor

1. In the vCenter Plugin input area: Enter the vCenter appliance management IP address in the VSCA IP

field. Enter a password for the user root in the Root Password field. Enter a username for vCenter in the SSO Username field. Enter a password for vCenter in the SSO Password field.

2. In the UCP input area, enter the UCP Advisor system name.

3. In the vRealize Orchestrator input area, enter the following: IP address Port number (8283 is the VMware default.) Username Password

4. In the vRealize Log Insight input area, enter the following: IP Address Username Password

To complete vRLI integration with UCP Advisor, please see the section, Setting up VMware vRealize Log Insight.

5. In the Auto Create Command Device input area, enter information used to automatically create and present a command device (for in-band array management).

Enter SVP (GUM) IP address in the Storage IP field, if available. For Gx00 storage systems, enter the controller IP.

Enter the storage array username in the Username field. Enter the storage array password in the Password field. Enter the ESX management IP address in the ESX IP field. Enter the ESX management username in the ESX Username field. Enter the ESX management password in the ESX Password field. Enter the name of the UCP Advisor Virtual Appliance in the VM Name

field. Enter the target port in the Storage Port field (for example, CL1-A). Enter the pool ID within which the command device should reside (for

example, 1, 2, 10) in the Pool ID field. Optionally enter a hostgroup name in the Host Group field. If none is

supplied, one is generated automatically.

Getting Started 25


Note After ToolBox creates the command device LU, the array serial number and LUN are printed. If an MPIO configuration is desired, take note of these values. Once UCP Advisor is fully configured, the Present LUN operation can be used to add additional SAN paths to the command device.

6. If the storage array command device is not detected, reboot the ESXi host as per instruction from the ToolBox. After rebooting, add the command device to the UCP Advisor Virtual Appliance as an RDM.

Note When a hostname or a domain of the UCP Advisor Virtual Appliance changes, you need to rerun the script that generates the SSL Certificate and performs port binding: C:\Program Files\Hitachi\UCP Advisor\Support\InitializeUcpAdvisorRunningEnvironment.bat

Installing the V2I vCenter Plug-In

The Virtual Infrastructure Integrator (V2I) plug-in must be installed on the vCenter appliance. See the Hitachi Virtual Infrastructure Integrator Administration Guide (MK-92HNAS003-07) for instructions.

Navigating to the UCP Advisor Plug-In

1. Enter the vCenter IP address in a supported browser.

2. Click UCP Advisor. This brings you to the UCP System screen where you can add, edit, and delete a UCP system.

26 Getting Started


3. Click the desired UCP system.

Performing an On Board Operation UCP Advisor can be automatically configured to access UCP devices using the ABC feature. involves manually entering UCP device connection information in to a spreadsheet, saving it as a .csv file, and importing this file in to UCP Advisor.

1. The sample ABC spreadsheet UCPAdvisorOnBoardSheet.csv is located in the c:\Program Files\Hitachi\UCP Advisor\Documentation folder on the UCP Advisor Virtual Appliance.

2. The Hitachi Storage system, Hitachi Compute system, and VDX/ICX/FC switch connection information must be added to the ABC spreadsheet.

Note • The spreadsheet contains sample UCP device IP addresses. Enter your IP addresses into the spreadsheet in place of the samples.

• You must have SNMP enabled in read-only mode, and the community string value must be public for each of these switches.

3. In the Navigator, click Administration.

4. Click the On Board tab.

Getting Started 27


5. Click Select Worksheet to browse available .csv files which correspond to your devices.

6. Click the desired .csv file.

7. Click Upload to upload it to the Devices to be Imported area. Review the information displayed in the Devices to be Imported area to ensure that it is correct.

8. Click Import. UCP Advisor connects to UCP devices using the imported connection information.

Pointing UCP Advisor Devices to the Same NTP Server

Ensure that all UCP Advisor devices, including Network switch, Compute server, and Storage array point to the same Network Time Protocol (NTP) server.

Creating a Scheduled Backup

1. In the Navigator, click Administration.

2. Click the Backup tab.

3. In the Backup Schedule area, select the checkbox of the desired day to set a scheduled backup.

4. Select desired time from the drop down.

5. You have two options to run a backup. Click Backup Now to create a backup immediately. Click Submit to schedule the backup operation at a designated time.

28 Getting Started


Working with the Navigator

The Navigator provides access to the main features of UCP Advisor.

The Navigator has the following areas:

Navigator Item Description

Compute Provides access to Compute device management and configuration features

Storage Provides access to Storage device management and configuration features

Network Provides access to Network device management and configuration features

Administration Provides access to UCP Advisor management and configuration features

Applications Provides navigation to the following three integrated applications: • VMware vRealize Orchestrator: Converged

orchestrator workflows to allow automated repetitive actions or integrations into higher data center workflow for configuring and managing Hitachi Storage and Compute devices

• VMware vRealize Log Insight: Analyzes the Hitachi Storage and Compute system and Network devices syslog to provide operational health and security visibility

• Data Management Server: Provides VM level snapshot data protection and recovery

Configuration and Management 29


Configuration and Management

Managing UCP Advisor Uploading Firmware

30 Configuration and Management


Managing UCP Advisor

Managing Multiple UCP Systems Feature Description

Multi UCP system management

Supports management of multiple UCP systems

Managing Administration

Feature Description

UCP device On Boarding Involves manually entering UCP device connection information in to a spreadsheet, saving it as a .csv file, and importing this file in to UCP Advisor

Uploading firmware Allows new firmware bundles to be uploaded into UCP Advisor

Firmware upgrade using firmware bundle

Applies firmware bundles to UCP servers and switches

Log Bundle management Collects logs related to UCP Advisor for troubleshooting purposes

License management Supports setting up a license with Hitachi. The initial demo license allows usage of UCP Advisor for 60 days with no restrictions. UCP Advisor displays a warning message a week prior to expiration indicating that the System ID must be sent to the Hitachi licensing department. After receiving the System ID and the number of UCP Compute nodes, Hitachi issues you a license key.

Scheduled switch configuration backup

Supports backing up switch configurations at specified times

Adding and removing Compute devices

Allows Compute devices to be added and removed from UCP Advisor

Adding and removing network switch devices

Allows network switch devices to be added, edited, and removed from UCP Advisor

Adding and removing Hitachi Storage arrays

Allows Hitachi Storage arrays to be added, edited, and removed from UCP Advisor Note: Prior to adding a Hitachi storage array: The UCP Advisor ToolBox must be used to create a

command device. The storage array must be configured to forward

audit logs to the integrated vRLI server.



Feature Description

Configuration UCP System – Allows a UCP system to be configured.

vRealize Orchestrator – Allows integration of vRealize Orchestrator.

vRealize Log Insight – Allows integration of vRLI. SCP – Allows UCP Advisor to transfer files to and

from UCP switch devices.

Managing Virtual/Logical Resource

Feature Description

VMFS and NFS Datastore on cluster

Allows datastores to be created, expanded, mounted, unmounted, and deleted. When a datastore is created, UCP Advisor automatically creates an LU/NFS Export for the datastore.

VLAN Synchronization Supports copying a VLAN range from a VMware distributed virtual switch to a UCP switch device. Provides an API set to perform the synchronization.

ESXi Management Supports the following ESXi operations: o Deploys ESXi host to ESXi cluster o Deploys ESXi host to Datacenter o Replaces ESXi host

Managing Storage Devices

Feature Description

Logical Unit Provisioning

Allows LUs to be provisioned, expanded, deleted, and presented to VMware ESXi hosts

Storage Pools Allows pools to be added, expanded, and deleted Resource Group Display Resource Groups information Parity Groups Allows parity groups to be created and deleted Ports Displays storage array ports and status Host Group Allows hostgroups to be created, edited, and deleted iSCSI Management Allows iSCSI targets to be added, edited, and deleted Replication Management

Allows you to manage HTI Snapshot, ShadowImage, TrueCopy, and HUR replication

Datastore Allows you to create, expand, delete, mount, and unmount a VMware Datastore



Managing Network Switch Devices

Feature Description

FC Switch Management Supports managing aliases, zones and zone configurations

VDX/ICX switch management

Supports configuring ports and VLAN settings for VDX switches. Displays configuration information for ICX switches

Switch firmware upgrade Supports FC and VDX/ICX switch firmware upgrades Switch configuration backup and restore

Supports incremental backups and selective restores of switch configurations

Connected Features Shows Compute devices connected to FC and Ethernet switches

Synchronize VLAN range from virtual switch to Brocade VDX switch

Copies the VLAN range from a VMware DVS switch's uplink port to the physical VDX switch port attached to the ESXi host

Managing Compute Devices

Feature Description

Power management Supports viewing and changing Compute power states LID management Supports viewing and changing Compute LID states Firmware upgrade Supports UCP Compute device firmware upgrades Compute and chassis labeling

Enables labeling of Compute servers and chassis

Set boot options Allows Compute device boot order settings to be configured

Replace Compute device Replaces an existing ESXi host in a VMware cluster with a new one, and updates storage array settings to present the previous host's LUs to the new host

Compute device information

Displays FRU, voltage, temperature, fan, CPU, and memory information

ESXi deployments Supports the following ESXi operations: o Deploys ESXi host to ESXi cluster o Deploys ESXi host to Datacenter o Replaces ESXi host

Managing VM Backup and Recovery

Feature Description

Hitachi V2I Supports Hitachi V2I integration with vCenter, which provides data management services including managed snapshot backups, snapshot restores, and snapshot backup scheduling



Monitoring UCP Devices

Feature Description

vCenter related events and alarms

Supports the generation of vCenter alarms corresponding with UCP device events on vCenter

UCP device alerts and events

Displays UCP device-specific events and alerts in the device summary screen

vRLI integration Provides UCP device log analysis

Obtaining and Applying a Permanent License

UCP Advisor ships with a 60-day demonstration license. If you want to permanently UCP Advisor, you need to obtain and apply a permanent license.

1. From the Navigator, click Administration.

2. Provide the System ID and node count values to your HDS Sales representative to receive a permanent license.

3. Enter the license key that you receive from Hitachi.

4. Click Apply.

Note When a permanent UCP Advisor license has not been

installed, a 60-day demo license is automatically applied.

Working with PowerShell Cmdlets in UCP Advisor

1. Click UCP Advisor PowerShell Console in the Windows Start menu, and then click Hitachi UCP Advisor in the Start menu.

2. Execute the following PowerShell cmdlet in the UCP Advisor PowerShell console to connect to UCP Advisor:

Connect-UCPSystem



The following table provides descriptions of the available cmdlets in UCP.

Cmdlet Description

Create-VMFSDatastore Creates a VMFS Datastore on an ESXi host based on input attributes provided

Create-NFSDatastore Creates an NFS Datastore on an ESXi host based on input attributes provided

Mount-VMFSDatastore Mounts a VMFS Datastore on an ESXi host based on input attributes provided

Unmount-VMFSDatastore Unmounts a VMFS Datastore from ESXi hosts as per the input provided

Expand-VMFSDatastore Expands the size of the VMFS Datastore by a value provided

Delete-VMFSDatastore Deletes a selected VMFS Datastore OnBoard-UCPSystem Registers UCP devices with connection settings

from the .csv file. Synchronize-VLANRange Copies the VLAN range from a VMware DVS

switch's uplink port to the physical VDX switch port attached to the ESXi host

Deploy-ESXiHost Deploys a host to an ESXi cluster or a vCenter Datacenter

Replace-ESXiHost Replaces a vCenter ESXi host with a new ESXi host

Upgrade-SwitchFirmware Uses the firmware bundle for upgrading the switch firmware. The firmware bundle should be uploaded before initiating this operation.

Upgrade-ServerFirmware Uses the firmware bundle for upgrading the server firmware. The firmware bundle should be uploaded before initiating this operation.

Connect-UCPSystem Establishes a connection to UCP Advisor Web service

Additional Cmdlets for Network Devices

The following table lists cmdlets for Network devices:

* Supported - Not supported

Cmdlets FC-65XX ICX-7450 VDX-6740

Add-AliasMember * - -

Add-EthernetSwitch - * *

Add-FCSwitch * - -




Add-VLanPort - * *

Add-ZoneConfigurationMember * - -

Add-ZoneMember * - -

Clear-ZoneConfiguration * - -

Create-Alias * - -

Create-EthernetVLan - * *

Create-Zone * - -

Create-ZoneConfiguration * - -

Delete-Alias * - -

Delete-EthernetVLan - * *

Delete-Zone * - -

Delete-ZoneConfiguration * - -

Disable-FCPort * - -

Disable-FCSwitch * - -

Disable-ZoneConfiguration * - -

Enable-FCPort * - -

Enable-FCSwitch * - -

Enable-ZoneConfiguration * - -

Get-Alias * - -

Get-ConnectedDevice - * *

Get-DeviceSyslogConfig * * *

Get-DownloadFirmwareStatus * - -

Get-EthernetPort - * *

Get-EthernetSwitch - * *

Get-EthernetVLan - * *

Get-FanReading * * *

Get-FCPort * - -

Get-FCSwitch * - -

Get-NetworkEvents * * *




Get-PowerSupplyReading * * *

Get-SwitchFirmware * * *

Get-TemperatureReading * * *

Get-Zone * - -

Get-ZoneConfiguration * - -

Refresh-ZoneConfiguration * - -

Remove-AliasMember * - -

Remove-DeviceSyslogConfig * - *

Remove-VLanPort - * *

Remove-ZoneConfigurationMember

* - -

Remove-ZoneMember * - -

Restore-SwitchConfig * * *

Save-SwitchConfig * * *

Set-DeviceSyslogConfig * * *

Update-SwitchFirmware * * * Note • To learn more about the description and syntax of

PowerShell cmdlets use get-help <cmdlet name> -detailed.

• To obtain a sample of PowerShell cmdlets use get-help <cmdlet name> -examples.

• There are 200+ cmdlets for managing Hitachi storage arrays and Compute devices, see the Hitachi Infrastructure Adapter for Microsoft Windows PowerShell User's Guide.

• To access UCP Advisor PowerShell cmdlets remotely, configure remote PowerShell access on the UCP Advisor Virtual Appliance.

Working with vRO


2. Click the vRealize Orchestrator section.



3. Enter the vRO connection information in the vRO section in the Configuration tab.

4. Navigate to the vRO section under Applications.

5. Select the desired workflow.

Note Similar to PowerShell, there are 200+ Hitachi Storage management and Compute management workflows from which you can choose. See the Hitachi Storage Connector for VMware vRealize Orchestrator user’s guide and the Hitachi Compute Connector for VMware vRealize Orchestrator user’s guide for more information.

Working with vRLI

Note Prior to accessing the vRLI screen for the first time, it is necessary to manually accept an SSL certificate. The Web browser should prompt for this when an initial attempt is made to access the vRLI screen.

1. Retrieve the UCP Advisor vRLI content pack from the C:\Program Files\Hitachi\UCP Advisor\HiLogInsightConverged\Content Packs folder located on the UCP Advisor Virtual Appliance.

2. Log into the vRLI administration screen, and then import the UCP Advisor Converged v01.0.0.vlcp content pack.


4. Enter the vRLI connection information in the vRLI section of the configuration panel.

5. Accept the SSL certificate.

6. From the Navigator, click vRealize Log Insight.

7. Provide the necessary login credentials and port details.

8. Navigate to vRO section under Applications.

9. Select the desired Hitachi widgets.



Adding Devices

Once you have completed UCP Advisor Batch Configuration, you may want to manually add additional devices.

Adding a storage array

Tip

Prior to adding a Hitachi storage array: • The UCP Advisor ToolBox must be used to create an array

command device. • The storage array must be configured to forward audit

logs to the integrated vRLI server.


2. Click the Storage tab.

3. Click the plus icon.

4. Enter the serial number.

5. Enter the SVP IP address or GUM IP address in the Management IP Address field.

6. Enter the username.

7. Enter the password.

8. Click Submit.

Note To run Hitachi Compute servers with an ESXi host, you need to enable SSH.

Adding a Switch

Note SNMP must be enabled on the switch before it can be added to UCP Advisor. Use read-only community string public.


2. Click Network.

3. Click the plus icon.

4. Enter the hostname or IP address.



5. Select the desired switch type from the drop down.

6. Enter the username.

7. Enter the password.

8. Click Submit.

Configuring SNMP for Adding a Switch

SNMP must be configured prior to adding and configuring a switch with UCP Advisor. The following sections explain how to configure SNMP for the three types of switches recognized by UCP Advisor.

Configuring SNMP for an ICX Switch Configuring SNMP for a VDX Switch Configuring SNMP for an FC Switch

Note The following are SNMP configuration examples for illustration

purposes only.

Configuring SNMP for an ICX Switch

1. Log in to the switch using ssh.

2. Enable commands. ICX7450-24 Switch# enable

3. Enter configuration mode. ICX7450-24 Switch# configure t

4. Initiate the SNMP environment. ICX7450-24 Switch(config)# enable SNMP

5. Assign the SNMP community name “public.” ICX7450-24 Switch(config)# snmp-server community public

6. Enable Link Layer Discovery Protocol. ICX7450-24 Switch(config)# lldp enable

7. Save the SNMP configuration. ICX7450-24 Switch(config)# copy running-config startup- config

Configuring SNMP for a VDX Switch




2. Create a group name using the following command line:

VDXSwitch-x(config)# snmp-server community public groupname public

3. Create, view, and assign the authentication type using the following command line:

VDXSwitch-x (config)# snmp-server group public v2c auth read publicview

4. Associate the root of the MIB to be on view using the following command line:

VDXSwitch-x(config)# snmp-server view publicview 1.3.6.1 included

Configuring SNMP for an FC Switch


2. Initiate the SNMP environment. snmpconfig --enable snmpv1

When used with the snmpv1 operand, this command restores access to SNMPv1/v2c.

Uploading the Firmware Bundle The UCP Advisor Firmware Bundle contains firmware for the Compute devices and for both the Fibre Channel, ICX, and Ethernet switches. The firmware bundle name takes the following syntax:

UCPAdvisorFirmwareBundle-<bundle_date>-<version>

A sample firmware bundle filename is

UCPAdvisorFirmwareBundle-11172016-v01.1.0.zip

Once you receive this bundle, upload it to the UCP Advisor environment. Go to the next section to upgrade device firmware.

Note UCP Advisor retains only the previous two firmware bundles.



Upgrading the Device Firmware 1. From the Navigator, click Administration in the Navigator.

2. Click the Upgrade Firmware tab. The Upgrade Firmware tab displays.

3. From the Upgrade Firmware screen, click Select Bundle.

4. Navigate to the location of the firmware file.

5. Click Upload.

6. Click Upgrade UCP Firmware.

7. From the Select Bundle list, select the firmware version to which you want to upgrade.

8. Click Next.

9. If not already selected, select the checkbox for the desired servers.

10. Click Next.

11. Select the checkbox for the desired switches.

12. Click Next.

13. Click Finish to initiate the firmware upgrade process. Check the vCenter task for its status.

Troubleshooting 43


Troubleshooting

Troubleshooting vRLI Troubleshooting UCP Advisor Session Timeouts Troubleshooting a System Error When Running ToolBox Troubleshooting UCP Advisor After Running the Installer Troubleshooting Slow Performance

44 Troubleshooting


Troubleshooting vRLI

Accepting the SSL certificate

Condition: When the vRLI is clicked on in the Navigator, UCP Advisor displays an error message instead of displaying the vRLI login screen.

What it Means: This indicates that the SSL certificate has not been accepted for vRLI for this particular domain.

Corrective Action: The certificate must be accepted.

To accept the SSL certificate, follow these steps:

1. Open another tab on the vRLI login page.

2. Enter the same vRLI IP address in the URL field (for example, https://<IP>/).

3. If the Web browser does not automatically accept the SSL certificate, you may have to manually accept it.

Configuring vRLI

Condition: The vRLI configuration does not work.

What it Means: Incorrect vRLI IP address and credentials may have been entered.

Action: The credentials must be correct when deploying vRLI.

To configure vRLI, follow these steps:

1. From the Navigator, click Administration in the Navigator.

2. Click the Configuration tab.

3. From the vRealize Log Insight area, click the plus icon .

4. Enter a hostname or IP address.

5. Enter a vRLI account and password.

6. Click OK.

Troubleshooting 45


Troubleshooting UCP Advisor Session Timeouts Condition: The UCP Advisor session suddenly stops because it has been idle for too long. An error message similar to the following figure may display.

What it Means: This indicates that UCP Advisor plug-in cannot access the Web service.

Corrective Action: Restart the UCP Advisor Web service.

To restart the UCP Advisor Web service, follow these steps:

1. From the taskbar, click Services.

2. Right-click the Hitachi UCP Advisor Services entry, and then click Restart.

If this symptom persists after you restart the UCP Advisor Web service, confirm that the Self-Signed Certificate used for HTTPS access exists. The certificate (UCPAdvisor.cer) should be located in <C:\Program Files\Hitachi\UCP Advisor\Cert>.

If the certificate does not exist in the folder, perform the following steps:

1. Run the following PowerShell command:

New-SelfSignedCertificate -CertStoreLocation cert:\localmachine\<My_DNS_hostname>

2. Run the following PowerShell command:

Export-Certificate –Cert (Get-ChildItem –Path cert:\LocalMachine\<My_DNS_hostname>\B6FA9B3A0FEB81E77BC0708

46 Troubleshooting


55) -FilePath "C:\Program Files\Hitachi\UCP Advisor\Cert\UCPAdvisor.cer"

3. Restart the Web service.

If the symptom persists even after you create the certificate, clean up the SSL certificate for port 23011 by performing these additional steps:

1. Run this command to identify the SSL certificate:

netsh http show sslcert ipport=0.0.0.0:23011

2. Run this command to remove the SSL certificate from port 23011:

netsh http delete sslcert ipport=0.0.0.0:23011

3. Optionally, delete the SSL certificate from the certificate store. Locate the SSL certificate with the thumbprint that matches the output Certificate Hash the certificate store called Local Computer in the Certificates MMC Snap-in. Then delete the SSL certificate.

4. Delete all files in C:\Program Files\Hitachi\UCP Advisor\Cert

Also, create and export a new Self Signed SSL Certificate by performing these steps:

1. To create a new Self-Signed SSL Certificate, run New-SelfSignedCertificate. The cmdlet outputs the new certificate thumbprint.

2. In the PowerShell console Window, run the following cmdlet:

New-SelfSignedCertificate -dnsname <host name> - CertStoreLocation cert:\LocalMachine\<My_DNS_hostname>

3. To export the new Self Signed SSL Certificate as a .cer file from the certificate store, run the following command:

Export-Certificate –Cert cert: \LocalMachine\<My_DNS_hostname>\ <New-SelfSignedCertificate_Thumbprint> -FilePath "C:\Program Files\Hitachi\UCP Advisor\ Cert\UcpAdvisor.cer"

4. Restart the UCP Advisor Web service.

Troubleshooting a System Error When Running ToolBox Condition: The installer stalls due to a non-specific UCP system request error as shown in the following figure.

What it Means: This indicates that UCP Web services have not started yet.

Troubleshooting 47


Corrective Action: Run the Restart-Service HiUcpServices command.This is a PowerShell command.

Troubleshooting UCP Advisor After Running the Installer Condition: After a successful UCP Advisor installation, it is not possible to access the Dashboard or launch a UCP Advisor instance.

What it Means: This may happen when one or more services required by UCP Advisor are not running.

Corrective Action: Make sure that the required UCP Advisor services are all running. If not, start any stopped services.

1. From the taskbar, click Services.

Verify that all of the following services are running: Hitachi UCP Advisor Services Hitachi vRO Converge Web Service Hitachi UCP Advisor HiTrack Web Service Redis Hitachi UCP VI Service Hitachi syslog agent for vRLI HiWatchdocServiceForUCPAdvisor

2. If one of the services is not running, right-click on the service.

3. Click Restart.

Troubleshooting Slow Performance Condition: You have successfully installed UCP Advisor, but performance for navigation and adding devices is slow.

What it Means: Frequently, this means that several UCP Advisor resources may be overloaded.

Corrective Action: Make sure that UCP Advisor resources are not overloaded. See the Memory and CPU Utilization requirements for more information.

1. Ensure that the hypervisor is not overloaded. If the hypervisor is heavily loaded, consider moving the appliance to a host that is not as busy.

2. Ensure that ample free disk space remains.

48 Troubleshooting


MK-92UCP098-01

Hitachi Data Systems

Corporate Headquarters 2845 Lafayette Street Santa Clara, California 95050-2627 U.S.A. Phone: 1 408 970 1000 www.hds.com [email protected]

Asia Pacific and Americas 2845 Lafayette Street Santa Clara, California 95050-2627 U.S.A. Phone: 1 408 970 1000 [email protected]

Europe Headquarters Sefton Park Stoke Poges Buckinghamshire SL2 4HD United Kingdom Phone: + 44 (0)1753 618000 [email protected]

http://www.hds.com/




Hitachi Unified Compute Platform (UCP) Advisor Notes ... Hitachi Unified Compute Platform (UCP)...

Documents

Transcript of Hitachi Unified Compute Platform (UCP) Advisor Notes ... Hitachi Unified Compute Platform (UCP)...