Hitachi Command Suite Virtual Appliance Installation Guide

MK-92HC236-00 © 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 copying and recording, or stored in a database or retrieval system for commercial purposes without the express written permission 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 no other manner; or (ii) used for archival purposes. Licensee may not make any other copies 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 notice and assumes no responsibility for its use. The Materials contain the most current information available at the time of publication. Some of the features described in the Materials 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://support.hds.com/en_us/contact-us.html. Notice: Hitachi products and services can be ordered only under the terms and conditions of the applicable Hitachi agreements. The use of Hitachi products is governed by the terms of your agreements with Hitachi Data Systems Corporation. By using this software, you agree that you are responsible for: 1. Acquiring the relevant consents as may be required under local privacy laws or otherwise from authorized employees and other individuals to access relevant data; and 2. Verifying that data continues to be held, retrieved, deleted, or otherwise processed in accordance with relevant laws.

Notice on Export Controls. The technical data and technology inherent in this Document may be subject to U.S. export control laws, including the U.S. Export Administration Act and its associated regulations, and may be subject to export or import regulations in other countries. Reader agrees to comply strictly with all such regulations and acknowledges that Reader has the responsibility to obtain licenses to export, re-export, or import the Document and any Compliant Products. Hitachi is a registered trademark of Hitachi, Ltd., in the United States and other countries. 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 or trademarks of International Business Machines Corporation. Active Directory, ActiveX, Bing, Excel, Hyper-V, Explorer, the Internet Explorer logo, , the Microsoft Corporate Logo, MS-DOS, Outlook, PowerPoint, SharePoint, Silverlight, SmartScreen, SQL Server, Visual Basic, Visual C++, Visual Studio, Windows, the Windows logo, Windows Azure, Windows PowerShell, Windows Server, the Windows start button, and Windows Vista are registered trademarks or trademarks of Microsoft Corporation. Microsoft product screen shots are reprinted with permission from Microsoft Corporation. All other trademarks, service marks, and company names in this document or website are properties of their respective owners.

2 Hitachi Command Suite Virtual Appliance Installation Guide Contents

Preface...... 5 Intended audience...... 6 Product Version...... 6 Accessing product documentation...... 6 Getting help...... 6 Comments...... 6

1 Installing Hitachi Command Suite products by using a virtual appliance ...... 7 Workflow for deploying and setting up the virtual appliance...... 8 System configuration of the Hitachi Command Suite virtual appliance...... 8 Default settings for a and the guest operating system...... 10 Deploying the Hitachi Command Suite virtual appliance...... 11 Specifying the network and time settings for the guest operating system...... 12 Configuring a pair management server...... 13 Notes on installing the operating system and Hitachi Command Suite products to the virtual machine after deployment...... 14

3 Hitachi Command Suite Virtual Appliance Installation Guide 4 Hitachi Command Suite Virtual Appliance Installation Guide Preface

This manual describes how to use the virtual appliance for Hitachi Command Suite.

□ Intended audience

□ Product Version

□ Accessing product documentation

□ Getting help

□ Comments

Preface 5 Hitachi Command Suite Virtual Appliance Installation Guide Intended audience This manual is intended for system administrators who manage and operate systems for Hitachi Command Suite products.

The system administrator must have the following skills: • VMware ESXi™ and VMware vSphere® operations, and the knowledge related to setting up these products • Basic knowledge of Oracle Linux • Basic knowledge of Storage Area Network (SAN)

Product Version

This document revision applies to Hitachi Command Suite version 8.4.1.

Accessing product documentation

Product user documentation is available on Hitachi Data Systems Support Connect: https://support.hds.com/en_us/documents.html. Check this site for the most current documentation, including important updates that may have been made after the release of the product.

Getting help

Hitachi Data Systems Support Connect is the destination for technical support of products and solutions sold by Hitachi Data Systems. To contact technical support, log on to Hitachi Data Systems Support Connect for contact information: https://support.hds.com/en_us/contact-us.html.

Hitachi Data Systems Community is a global online community for HDS customers, partners, independent software vendors, employees, and prospects. It is the destination to get answers, discover insights, and make connections. Join the conversation today! Go to community.hds.com, register, and complete your profile.

Comments

Please send us your comments on this document to [email protected]. Include the document title and number, including the revision level (for example, -07), and refer to specific sections and paragraphs whenever possible. All comments become the property of Hitachi Data Systems Corporation.

Thank you!

6 Preface Hitachi Command Suite Virtual Appliance Installation Guide 1 Installing Hitachi Command Suite products by using a virtual appliance

By deploying the Open Virtualization Format (OVF) of Hitachi Command Suite to a virtualization server running VMware ESXi 5.5 or 6.0, you can create a virtual machine on which Hitachi Command Suite products are installed.

□ Workflow for deploying and setting up the virtual appliance

□ System configuration of the Hitachi Command Suite virtual appliance

□ Default settings for a virtual machine and the guest operating system

□ Deploying the Hitachi Command Suite virtual appliance

□ Specifying the network and time settings for the guest operating system

□ Configuring a pair management server

□ Notes on installing the operating system and Hitachi Command Suite products to the virtual machine after deployment

Installing Hitachi Command Suite products by using a virtual appliance 7 Hitachi Command Suite Virtual Appliance Installation Guide Workflow for deploying and setting up the virtual appliance The following figure shows the workflow of tasks for installing and setting up the virtual appliance:

Figure 1 Workflow for deploying and setting up the virtual appliance

For details on preparing the virtualization server, see the documentation for VMware. Each product after the deployment is in the same state as that of a new installation performed by using the installation media. For details about the required configuration tasks to be performed after a new installation, see the manual for each product.

System configuration of the Hitachi Command Suite virtual appliance The following figure shows the system configuration of a virtual machine to be created by using the Hitachi Command Suite virtual appliance.

8 Installing Hitachi Command Suite products by using a virtual appliance Hitachi Command Suite Virtual Appliance Installation Guide Figure 2 Configuration of a virtual machine to be created by the virtual appliance

Guest operating system Oracle Linux is installed as a guest operating system.

Installed products The following products, which are components of the management server, are installed. The installation directory is /opt/HiCommand. The database storage location is /var/opt/HiCommand. • Device Manager server • Tiered Storage Manager server • Replication Manager server • Host Data Collector • Hitachi Command Suite REST API server

In addition, the Device Manager agent and Command Control Interface must be installed. • Device Manager agent

Installing Hitachi Command Suite products by using a virtual appliance 9 Hitachi Command Suite Virtual Appliance Installation Guide Use the Device Manager agent when configuring a pair management server on a virtual machine. The installation directory is /opt/HDVM. The property settings required for the Device Manager agent to operate as a pair management server are complete. • Command Control Interface A prerequisite product for the Device Manager agent and the Hitachi Command Suite REST API. The installation directory is /opt/HiCommand/ ConfManager/HORCM.

Default settings for a virtual machine and the guest operating system A virtual machine and the guest operating system created by the Hitachi Command Suite virtual appliance have settings that are set by default that are required for operation of Hitachi Command Suite products.

When the virtual appliance is deployed, a virtual machine with the following default settings is created. Confirm whether the virtualization server has enough resources to create the virtual machine.

Table 1 Resource settings for the virtual machine

Item Settings

CPU 4 cores (the number of virtual sockets: 2, the number of cores per virtual socket: 2) Memory 6 GB Disk size 60 GB

The table below lists the items that are set by default for the guest operating system. To change the settings for Hitachi Command Suite products after the deployment, change the operating system settings as needed.

Table 2 Guest operating system settings

Item Settings

Operating system version Oracle Linux 7.2 (Architecture x86_64)

Unbreakable Enterprise Kernel Release 3

(kernel-uek-3.8.13-98.7.1.el7uek.x86_64) Installed libraries Prerequisite libraries required for operation of Hitachi Command Suite products are installed. Kernel parameters Settings included in the virtual appliance that are required for operation of Hitachi Command Suite products are set. Registering firewall exceptions In addition to the ports that are registered as exceptions by the operating system by default, the following ports are registered as exceptions: • http

10 Installing Hitachi Command Suite products by using a virtual appliance Hitachi Command Suite Virtual Appliance Installation Guide Item Settings

• https • 2001/tcp • 2443/tcp • 20352/tcp • 22015/tcp • 22016/tcp • 24500/tcp • 162/udp • 22098/tcp • 22099/tcp • 22100/tcp • 22104/tcp • 22105/tcp • 22106/tcp • 5983/tcp • 427/tcp • 5988/tcp • 5989/tcp • 24041/tcp • 24042/tcp • 23450/tcp • 23451/tcp

Deploying the Hitachi Command Suite virtual appliance This section describes how to deploy the Hitachi Command Suite virtual appliance.

Procedure

1. From a VMware vSphere client, log in to the VMware ESXi server. 2. Deploy the Hitachi Command Suite OVF from the Hitachi Command Suite Virtual Appliance installation media.

From the VMware vSphere client, select File > Deploy OVF Template, and then follow the on-screen instructions. 3. Change the settings so that the virtual machine does not connect to the network when started.

When deployment is complete, the following network settings will be set by default for the virtual machine. This operation is not required if you are sure that the IP addresses will not conflict. • IP address: 10.197.85.249 • Network mask: 255.255.255.0 • Default gateway: 10.197.85.1

a. Right-click the created virtual machine, and then select Edit Settings. b. In the Hardware tab, select Network adapter 1, and then clear the Connect at power on check .

Installing Hitachi Command Suite products by using a virtual appliance 11 Hitachi Command Suite Virtual Appliance Installation Guide 4. Start the virtual machine. 5. If you changed the settings in step 4 so that the virtual machine is not connected to the network at power on, select the Connect at power on check box by performing the same procedure in step 4.

Next steps From the guest operating system, run the setup tool to specify the network and time settings for the guest operating system.

Specifying the network and time settings for the guest operating system After the deployment of the virtual appliance is complete, run the setup tool (hvmasetup) to specify the network and time settings for the guest operating system.

You can use the setup tool to specify the following settings:

Network settings • Host name • IP address • Default gateway • Network mask • DNS server (up to two servers)

Time settings • Time zone • NTP server

Note: • You can run the setup tool only once. To change the settings after running the setup tool, use the operating system commands. • The setup tool specifies an IPv4 address. If you use an IPv6 environment, set the IP address by using operating system commands after running the setup tool. • Specify the time zone in the area/location format. If you do not know the specifiable values, use the following command in advance to check the time zone values that can be set. timedatectl list-timezones

Procedure

1. From the VMware vSphere client, log in to the guest operating system.

When you log in for the first time, use the following user ID and password:

12 Installing Hitachi Command Suite products by using a virtual appliance Hitachi Command Suite Virtual Appliance Installation Guide User ID: root

Password: manager

When you log in for the first time, you must change the root password. 2. Run the setup tool. Execute the hvmasetup command. 3. Specify the values as indicated in the displayed messages. 4. After the specification of all items is complete, a list of the settings is displayed. Check the contents, and then apply the settings.

After the settings are applied, the guest operating system restarts automatically. 5. If you changed the settings so that the virtual machine is not connected to the network when deployed, perform the following steps to enable the network adapter: a. Log in to the guest operating system, and then stop the virtual machine by using the shutdown command. b. Execute Power On the virtual machine from the VMware vSphere client.

Next steps

Each product is now in the same state as that of a new installation performed by using the installation media. See the manual for each product to perform the post-installation tasks.

Configuring a pair management server Virtual appliance includes the software to be used as a component of a Hitachi Command Suite management server, the Device Manager agent to be used as a component of a pair management server, and Command Control Interface.

To configure a pair management server, the following tasks must be completed: • Setting the Device Manager agent • Setting the command device of each storage system to be recognized by the virtualization server and the guest operating system.

The Device Manager agent configuration has been completed at the point when the virtual appliance is deployed. Settings to be performed here are as follows: • Registration of the Device Manager server to which information is to be reported • Changing of the property setting to implement a batch (centralized) management configuration (the

Installing Hitachi Command Suite products by using a virtual appliance 13 Hitachi Command Suite Virtual Appliance Installation Guide server.agent.rm.centralizePairConfiguration property in the server.properties file) • Changing of the property setting required to install the Device Manager agent on a virtual machine (the server.agent.rm.ignorePairStatus property in the server.properties file) • Setting of the Command Control Interface installation directory (the server.agent.rm.location property in the server.properties file)

Complete the following steps to assign the command device of each storage system to the virtualization server and to the guest operating system, so that they are recognized.

Before you begin • A storage system to be managed must be registered in Device Manager. • A command device must be created in the storage system.

Procedure

1. From a VMware vSphere client, log in to the virtualization server. 2. Create a virtual WWN on the guest operating system. 3. Log in to the Device Manager GUI. 4. Register the virtualization server as a host to be managed by Device Manager. 5. Allocate a command device of each storage system to the virtualization server and to the guest operating system. You must specify settings to ensure that the command device will be accessed via the same port by both the physical WWN of the HBA installed on the virtualization server and the virtual WWN created on the guest operating system. 6. Specify settings for zoning on the Fibre Channel switch if necessary. 7. From a VMware vSphere client, set the command device to be recognized by the virtualization server. 8. Allocate the command device recognized by the virtualization server to the guest operating system by using raw device mapping. 9. Restart the guest operating system so that the command device is recognized.

Notes on installing the operating system and Hitachi Command Suite products to the virtual machine after deployment The following table shows how to install an operating system patch or Hitachi Command Suite products in an environment to which the virtual appliance is deployed:

14 Installing Hitachi Command Suite products by using a virtual appliance Hitachi Command Suite Virtual Appliance Installation Guide Table 3 Installation operations to be performed on the operating system and on Hitachi Command Suite products after deployment

Operation Implementation method

Apply operating system Perform the operation as necessary. patches Update the operating system Uninstall the installed Hitachi Command Suite products, and then install them again after upgrading the operating system. To install Hitachi Command Suite again, use the installation media.

When Hitachi Command Suite products are uninstalled, the database and user information are deleted. For details on how to migrate databases, see the Hitachi Command Suite Administrator Guide. Upgrade Hitachi Command The virtual appliance can be used only for a new installation. For an Suite products upgrade installation or overwrite installation, use the installation media. Install additional Hitachi To install other Hitachi Command Suite products that are not Command Suite products installed on a virtual machine to which the virtual appliance is deployed, install the target products by using the installation media. Confirm the system requirements of the target products, and install prerequisite packages and reconfigure kernel parameters as necessary. For details on the system requirements for the target products, see Hitachi Command Suite System Requirements.

Installing Hitachi Command Suite products by using a virtual appliance 15 Hitachi Command Suite Virtual Appliance Installation Guide 16 Installing Hitachi Command Suite products by using a virtual appliance Hitachi Command Suite Virtual Appliance Installation Guide Hitachi Command Suite Virtual Appliance Installation Guide Hitachi Data Systems

Corporate Headquarters 2845 Lafayette Street Santa Clara, California 95050-2639 U.S.A. www.hds.com

Regional Contact Information

Americas +1 408 970 1000 [email protected]

Europe, Middle East, and Africa +44 (0) 1753 618000 [email protected]

Asia Pacific +852 3189 7900 [email protected]

MK-92HC236-00