Hitachi Command Suite 8.6 Virtual Appliance Installation Guide This manual explains how to use the virtual appliance for Hitachi Command. MK-92HC236-02 May 2018
2016, 2018 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 Vantara 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 Vantara Corporation at https://support.hitachivantara.com/en_us/contactus.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 Vantara 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; and 2. Verifying that your 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, Internet Explorer, the Internet Explorer logo, Microsoft, 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. Hitachi Command Suite Virtual Appliance Installation Guide ii
Contents Preface... 4 Intended audience... 4 Product Version...4 Accessing product documentation...4 Getting help...4 Comments...5 Chapter 1: Installing Hitachi Command Suite products by using a virtual appliance...6 Workflow for deploying and setting up the virtual appliance...6 System configuration of the Hitachi Command Suite virtual appliance... 7 Default settings for a virtual machine and the guest operating system... 8 Deploying the Hitachi Command Suite virtual appliance... 10 Running the setup tool (hvmasetup)... 11 Configuring a pair management server... 13 Notes on installing the operating system and Hitachi Command Suite products on the virtual machine after deployment... 14 Running the system requirements configuration tool (hvmachgreq)... 15 Contents Hitachi Command Suite Virtual Appliance Installation Guide 3
Preface This manual describes how to use the virtual appliance for Hitachi Command Suite. 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.6. Accessing product documentation Product user documentation is available on Hitachi Vantara Support Connect: https:// knowledge.hitachivantara.com/documents. 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 Vantara Support Connect is the destination for technical support of products and solutions sold by Hitachi Vantara. To contact technical support, log on to Hitachi Vantara Support Connect for contact information: https://support.hitachivantara.com/en_us/ contact-us.html. Hitachi Vantara Community is a global online community for Hitachi Vantara 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.hitachivantara.com, register, and complete your profile. Preface Hitachi Command Suite Virtual Appliance Installation Guide 4
Comments Comments Please send us your comments on this document to doc.comments@hitachivantara.com. 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 Vantara Corporation. Thank you! Preface Hitachi Command Suite Virtual Appliance Installation Guide 5
Chapter 1: Installing Hitachi Command Suite products by using a virtual appliance By deploying the Open Virtualization Format Archive (OVA) file of Hitachi Command Suite to a virtualization server running VMware ESXi, you can create a virtual machine on which Hitachi Command Suite products are installed. 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. Hitachi Command Suite Virtual Appliance Installation Guide 6
System configuration of the Hitachi Command Suite virtual appliance System configuration of the Hitachi Command Suite virtual appliance This section describes the system configuration of a virtual machine to be created by using the Hitachi Command Suite 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 Tuning Manager server Compute Systems Manager server Automation Director server Host Data Collector Configuration Manager REST API server In addition, the following programs must be installed: Device Manager agent 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 program for the Device Manager agent and the Configuration Manager REST API. The installation directory is /opt/hicommand/confmanager/horcm. Tuning Manager Agent for RAID and Tuning Manager Agent for NAS A program that collects and manages information used for monitoring the performance of storage systems and NAS systems. The installation directory is /opt/ jp1pc. Hitachi Command Suite Virtual Appliance Installation Guide 7
Default settings for a virtual machine and the guest operating system 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 to use 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 Memory Disk size 4 cores (the number of virtual sockets: 1, the number of cores per virtual socket: 4) 16 GB If Tuning Manager is not used, at least 10 GB of memory is required. If Tuning Manager is not used and you want to reduce the memory capacity from the default setting, after deployment use vsphere Client to change the configuration. 350 GB The default setting is 350 GB. However, the actually required disk capacity varies depending on the products used. If Tuning Manager in not used, at least 200 GB of disk capacity is required. To deploy by using thick provisioning, make sure that there is at least 350 GB of free capacity for the data store before deployment. To deploy by using thin provisioning, make sure that there is at least 200 GB of free capacity for the data store. The default setting assumes that Tuning Manager is used and five storage systems that have 3000 volumes each are monitored by Tuning Manager Agent for RAID. For a larger scale system, change the settings for memory, the disk size, or virtual memory; increase the number of virtual appliances; or prepare a host for Tuning Manager Agent for RAID separately from the virtual appliance. For details on how to estimate the required virtual memory, see the Hitachi Command Suite System Requirements. For details about VMware ESXi version requirements, see the Hitachi Command Suite System Requirements. 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. Hitachi Command Suite Virtual Appliance Installation Guide 8
Default settings for a virtual machine and the guest operating system Table 2 Guest operating system settings Item Operating system version Installed libraries Kernel parameters Registering firewall exceptions Settings Oracle Linux 7.4 (Architecture x86_64) Unbreakable Enterprise Kernel Release 4 update 4 (kernel-uek-4.1.12-94.3.9.el7uek.x86_64) For details about the latest operating system version, see the Hitachi Command Suite System Requirements. Prerequisite libraries required for operation of the Hitachi Command Suite products included in the virtual appliance The values required for operation of the Hitachi Command Suite products included in the virtual appliance In addition to the ports that are registered as exceptions by the operating system, the following ports are registered as exceptions: Ports used for Hitachi Command Suite Common Component http https 22015/tcp 22016/tcp Ports used for Device Manager 162/udp 427/tcp 2001/tcp 2443/tcp 5983/tcp 5988/tcp 5989/tcp Ports used for Tiered Storage Manager 20352/tcp 24500/tcp Ports used for Host Data Collector 22098/tcp 22099/tcp Hitachi Command Suite Virtual Appliance Installation Guide 9
Deploying the Hitachi Command Suite virtual appliance Item 22100/tcp 22104/tcp 22105/tcp 22106/tcp Settings Ports used for the Device Manager agent 24041/tcp 24042/tcp Ports used for the REST API 23450/tcp 23451/tcp 23454/tcp Ports used for Compute Systems Manager 22601/udp 22610/tcp 22611/tcp Ports used for Automation Director 22/tcp 23/tcp 25/tcp 135/tcp 139/tcp 445/tcp 23031/tcp Ports used for Tuning Manager Agent for RAID 24221/tcp 24222/tcp Deploying the Hitachi Command Suite virtual appliance This section describes how to deploy the Hitachi Command Suite virtual appliance. Hitachi Command Suite Virtual Appliance Installation Guide 10
Running the setup tool (hvmasetup) Procedure 1. From a VMware vsphere client, log in to the VMware ESXi server. 2. Deploy the Hitachi Command Suite OVA (HCSVM_version.ova) from the Hitachi Command Suite Virtual Appliance installation media. From the VMware vsphere client, select File > Deploy OVF Template, and then follow the prompts. 3. To avoid IP address conflicts when the virtual machine starts, change the settings so that, when it starts, it does not connect to the network. This operation is not required if you are sure that the IP addresses will not conflict. When deployment is complete, the following network settings will be set by default for the virtual machine: 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 box. 4. Start the virtual machine. 5. If you changed the settings in step 3 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. Next steps From the guest operating system, run the setup tool (hvmasetup) to specify the network and time settings for the guest operating system. Running the setup tool (hvmasetup) 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. Hitachi Command Suite Virtual Appliance Installation Guide 11
Running the setup tool (hvmasetup) 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, before running the setup tool, use the following command 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: User ID: root Password: manager When you log in for the first time, you must change the root password. 2. Run the setup tool: hvmasetup. 3. Specify the values as indicated in the displayed messages. After the specification of all items is complete, a list of the settings is displayed. 4. Check the settings, enter y, 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. From the VMware vsphere client, click Power On the virtual machine. Hitachi Command Suite Virtual Appliance Installation Guide 12
Configuring a pair management server 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 complete the post-installation tasks. Configuring a pair management server The 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. Usually, you need to configure the following settings to configure a pair management server: 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. However, you do not need to configure settings of the Device Manager agent, because they are complete at the time when the virtual appliance is deployed. Settings to be performed 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 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. Tip: The operating procedure is for an example configuration in which the virtualization server is connected to the storage systems via Fibre Channel. If VMware Fault Tolerance is enabled on the virtual machine, Fibre Channel cannot be used. In such a situation, check the conditions for using VMware Fault Tolerance, and either connect the storage system via iscsi and then assign a command device, or configure a copy pair by using a virtual command device. 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. Hitachi Command Suite Virtual Appliance Installation Guide 13
Notes on installing the operating system and Hitachi Command Suite products on the virtual machine after deployment 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 by 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 on the virtual machine after deployment The following table outlines the installation tasks for an operating system patch or for Hitachi Command Suite products in an environment in which the virtual appliance is deployed. Table 3 Installation tasks to be performed on the operating system and on Hitachi Command Suite products after deployment Task Implementation method Apply operating system patches Update the operating system Upgrade Hitachi Command Suite products Apply as needed. Uninstall the installed Hitachi Command Suite products, and then install them again after upgrading the operating system. To install Hitachi Command Suite products 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. The virtual appliance can be used only for a new installation. For an upgrade installation or overwrite installation, use the installation media. Hitachi Command Suite Virtual Appliance Installation Guide 14
Running the system requirements configuration tool (hvmachgreq) Task Install additional Hitachi Command Suite products Implementation method During an upgrade installation, you might need to change the OS settings to expand the disk capacity or to change the kernel parameters. You can make necessary changes by using the system requirements configuration tool (hvmachgreq). To install other Hitachi Command Suite products that are not 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. Running the system requirements configuration tool (hvmachgreq) In an environment in which a virtual appliance has been deployed, if you want to perform an upgrade installation of a Hitachi Command Suite product or to install additional Hitachi Command Suite products, you might need to change the OS settings to meet the system requirements. You can make necessary changes by using the system requirements configuration tool (hvmachgreq). You can use the system requirements configuration tool to check whether the following items meet the system requirements, and to change the settings: Disk capacity Virtual memory capacity Prerequisite libraries Kernel parameters and shell limits Firewall exception registration The system requirements configuration tool is supported for products that are installed by virtual appliances. Regarding the system requirements for Hitachi Command Suite products or other software programs that cannot be installed by virtual appliances, if necessary, change the settings after running the tool. Before you begin The environment is one in which a virtual appliance has been deployed. You are logged in as the root user. Hitachi Command Suite Virtual Appliance Installation Guide 15
Running the system requirements configuration tool (hvmachgreq) Procedure 1. Back up the virtual machine. 2. From the installation media, run the system requirements configuration tool, which is stored in the following location: mount-directory-of-the-installation-media/tool/appliance/ hvmachgreq/hvmachgreq When you run this tool, the following message appears: The following products are available: Currently selected product is marked with [X] below. [X] 1 Hitachi Command Suite [ ] 2 Hitachi Tuning Manager [ ] 3 Hitachi Compute Systems Manager [ ] 4 Hitachi Automation Director [X] 5 Device Manager Agent [ ] 6 Tuning Manager Agent for RAID [ ] 7 Tuning Manager Agent for NAS Enter y to continue or n to cancel (or input the number to change the state of selection [1,2,3,4,5,6,7]). The X mark is displayed for products selected as targets of the system requirements configuration tool. Already installed products are always selected. For a product that is installed later, you can enter the number on the left side of the product name, and then select the product. After the products are selected, enter y to start the processing. If you do not have all of the prerequisite libraries installed or if the disk capacity cannot be expanded by using the tool, a message will be displayed. Configure the settings according to the information in the displayed message. 3. If you install prerequisite libraries or expand the disk capacity (according to the information in the displayed message), run the system requirements configuration tool again. 4. If necessary, reconfigure the kernel parameters and shell limits. The system requirements configuration tool changes the values of settings so that the system requirements of already installed Hitachi Command Suite products and the system requirements of the Hitachi Command Suite products specified while the tool is running are met. If other software programs are installed on the virtual machine, reconfigure the kernel parameters and shell limits so that those programs can be used. 5. Use the installation media to upgrade Hitachi Command Suite products or to install additional Hitachi Command Suite products. Hitachi Command Suite Virtual Appliance Installation Guide 16
Hitachi Vantara Corporation Corporate Headquarters Regional Contact Information 2845 Lafayette Street Americas: +1 866 374 5822 or info@hitachivantara.com Santa Clara, CA 95050-2639 USA Europe, Middle East, and Africa: +44 (0) 1753 618000 or info@emea@hitachivantara.com www.hitachivantara.com community.hitachivantara.com Asia Pacific: + 852 3189 7900 or info.marketing.apac@hitachivantara.com