managementtools user guide - ibm.com user guide ... to submit any comments about this book or any...

IBM XIV Storage SystemVersion 11.2.x

Management Tools User Guide

SC27-4230-01

��

NoteBefore using this information and the product it supports, read the information in “Notices” on page 65.

This edition applies to Management Tools version 4, release 1, modification 0 of IBM XIV Storage System and to allsubsequent releases and modifications until otherwise indicated in new editions.

This edition replaces SC27-4230-00.

© Copyright IBM Corporation 2012, 2013.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Figures . . . . . . . . . . . . . . . v

About this guide . . . . . . . . . . viiWho should use this guide . . . . . . . . . viiConventions used in this guide . . . . . . . viiPublications and related information . . . . . . viiGetting information, help, and service . . . . . . xOrdering publications . . . . . . . . . . . xSending your comments . . . . . . . . . . x

Chapter 1. Introduction . . . . . . . . 1Definitions . . . . . . . . . . . . . . . 1Management Tools specifications . . . . . . . 3

Multi-System Manager specifications . . . . . 3GUI specifications . . . . . . . . . . . 3

Chapter 2. Installing the ManagementTools . . . . . . . . . . . . . . . . 7Installing the Multi-System Manager virtualappliance . . . . . . . . . . . . . . . 7Configuring the Multi-System Manager . . . . . 8

Step 1 . . . . . . . . . . . . . . . 8Step 2 . . . . . . . . . . . . . . . 9Step 3 . . . . . . . . . . . . . . . 9Step 4 . . . . . . . . . . . . . . . 13Step 5 . . . . . . . . . . . . . . . 14The installation is complete . . . . . . . . 16

Initializing the inventory . . . . . . . . . . 17Installing another IBM XIV Multi-System Manager 21

Chapter 3. Upgrading the Multi-SystemManager . . . . . . . . . . . . . . 23

Chapter 4. Backing up and restoringthe Multi-System Manager . . . . . . 27Backing up the Multi-System Manager . . . . . 27Restoring the Multi-System Manager . . . . . . 28

Chapter 5. Managing the XIV andMulti-System Manager certificates . . . 31GUI Certificate Management in Direct Mode . . . 31

Importing Certificates into the Local Trust Store 31Removing Certificates from the Local Trust Store 31Handling system certificate errors . . . . . . 32

GUI Certificate Management in Server Mode . . . 33Importing Certificates into the MSM Trust Store 33Removing Certificates from the MSM Trust Store 34Handling systems certificate errors in servermode . . . . . . . . . . . . . . . 34

Multi-System Manager Certificate Management . . 35Handling the Multi-System Manager certificate 35Replacing the Multi-System Manager certificate 36

Chapter 6. Operating the Multi-SystemManager . . . . . . . . . . . . . . 39Root user operations . . . . . . . . . . . 39

Selecting an operation from the root user menu 39Server configuration options. . . . . . . . 40Gathering the Multi-System Manager logs . . . 41Displaying the audit log . . . . . . . . . 41Displaying the upgrade logs. . . . . . . . 42Managing inventory options. . . . . . . . 43Managing the certificates . . . . . . . . . 47Backing up the server database . . . . . . . 50Changing the root password. . . . . . . . 53Changing the maintenance password . . . . . 53Changing the manager access code . . . . . 53Replacing the Multi-System Manager certificate 54Replacing the Multi-System Manager certificate 54Changing the communication ports . . . . . 55Upgrading the Multi-System Manager . . . . 56Rebooting the Multi-System Manager VM . . . 57Shutting down the VM . . . . . . . . . 57

Maintenance user operations . . . . . . . . 57Performing maintenance tasks . . . . . . . 57

Chapter 7. Multi system configuration 59Multi system configuration of user-relatedinformation . . . . . . . . . . . . . . 59

Adding a user on multiple systems . . . . . 59Editing, deleting or changing the password of auser . . . . . . . . . . . . . . . . 60

Mass copy-paste configuration . . . . . . . . 61

Notices . . . . . . . . . . . . . . 65Trademarks . . . . . . . . . . . . . . 67

Index . . . . . . . . . . . . . . . 69

© Copyright IBM Corp. 2012, 2013 iii

iv IBM XIV Storage System: Management Tools User Guide

Figures

1. IBM XIV Multi-System Manager . . . . . . 12. Multi-System ManagerPrimary Management

Server . . . . . . . . . . . . . . 183. The Certificate Details screen. . . . . . . 194. Multi-System Manager Access Code . . . . 195. The Remember Me checkbox. . . . . . . 206. Cross site high availability . . . . . . . 217. Importing Certificates into the Local Trust

Store . . . . . . . . . . . . . . . 31

8. Handling system certificate errors . . . . . 329. System certificate . . . . . . . . . . 33

10. Importing Certificates into the MSM TrustStore . . . . . . . . . . . . . . . 34

11. Handling system certificate errors . . . . . 3512. System certificate . . . . . . . . . . 3513. MSM certificate . . . . . . . . . . . 3614. Replacing the certificate . . . . . . . . 37

© Copyright IBM Corp. 2012, 2013 v

vi IBM XIV Storage System: Management Tools User Guide

About this guide

This document describes how to install and use the IBM XIV Management Tools4.0. The document describes the new component: IBM® XIV® Multi-SystemManager, and the relevant XIV GUI capabilities.

Who should use this guideThis document is for storage administrators that manage XIV Systems.

Conventions used in this guideThese notices are used to highlight key information.

Note: These notices provide important tips, guidance, or advice.

Important: These notices provide information or advice that might help you avoidinconvenient or difficult situations.

Attention: These notices indicate possible damage to programs, devices, or data.An attention notice appears before the instruction or situation in which damagecan occur.

Publications and related informationProduct manuals, other IBM publications, and websites contain information thatrelates to the IBM XIV Storage System.

To view a PDF file, you need Adobe Reader. You can download it at no chargefrom the Adobe website (get.adobe.com/reader/).

Information centers

v IBM XIV Storage System Information Center website (http://publib.boulder.ibm.com/infocenter/ibmxiv/r2/index.jsp)From the IBM XIV Storage System Information Center, you can browse allproduct documentation.

v IBM Storage Host Software Solutions Information Center website(http://pic.dhe.ibm.com/infocenter/strhosts/ic/index.jsp)From the Storage Host Software Solutions Information Center, you can browsedocumentation for platform and application integration software that issupported by IBM XIV Storage System.

Publications

Information that is available in the information center is also available in a set ofpublications, in PDF format. You can find the following PDFs in the informationcenter on the Publications and related information web page (http://publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/xiv_pubsrelatedinfoic.html).v IBM XIV Storage System Product Overview

© Copyright IBM Corp. 2012, 2013 vii

http://get.adobe.com/reader/

http://publib.boulder.ibm.com/infocenter/ibmxiv/r2/index.jsp

http://pic.dhe.ibm.com/infocenter/strhosts/ic/index.jsp

publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/xiv_pubsrelatedinfoic.html

This document contains an overview of the IBM XIV Storage System hardwareand software.

v IBM XIV Storage SystemGen3 Model 281x-11x and 281x-21x Planning Guide

This guide defines installation requirements for IBM XIV Gen3 Storage Systemmodel 281x-114, model 281x-214, and model 281x-215. It is important to ensurethat you meet all requirements to ensure a fast and reliable installation.

v IBM XIV Storage System Model 281x-A14 Planning Guide

This guide defines installation requirements for IBM XIV Storage System model281x-A14. It is important to ensure that you meet all requirements to ensure afast and reliable installation.

v IBM XIV Storage System Application Programming Interface Reference

This reference assists you in developing CIM-based applications by using theXIV Open API.

v IBM XIV Storage System Commands Reference

This reference describes the IBM XIV command-line interface (XCLI) system andutility commands that are used to manage and maintain the XIV system,including the command syntax, parameter descriptions, output descriptions, andexamples.

v IBM XIV Storage System XCLI User Manual

This guide describes how to use the IBM XIV command-line interface (XCLI) torun XIV system and utility commands.

v IBM XIV Management Tools User Guide.This user guide describes how to install and use the IBM XIV ManagementTools. The document describes the new component: IBM XIV Multi-SystemManager, and the relevant XIV GUI capabilities.

v IBM XIV Storage System Remote Support Proxy Installation and User's Guide

This guide describes how to install, configure, and use the IBM XIV StorageSystem Remote Support Proxy to connect an XIV system to the XIV RemoteSupport Center.

v IBM XIV Storage System Safety Notices

This document describes all standard IBM XIV Storage System safety notices.

IBM Redbooks publications and technical papers

Various IBM Redbooks® publications, Redpapers, and white papers are availablefor the IBM XIV Storage System. For more papers, see the IBM XIV Storage Systemwebsite (http://www.ibm.com/systems/storage/disk/xiv/).

Table 1. IBM XIV related publications

Title Description

IBM XIV Storage System:Architecture, Implementation, andUsage

This Redbooks publication describes the concepts,architecture, and implementation of the XIV system,which is a scalable enterprise storage system that isbased on a grid array of hardware components.

IBM XIV Storage System with theVirtual I/O Server and IBM i

This Redbooks publication describes how you canconnect the XIV system to the IBM i operating systemthrough the Virtual I/O Server (VIOS). A connectionthrough the VIOS is especially useful for IT centersthat have many small IBM i partitions. When you usethe VIOS, the Fibre Channel host adapters can beinstalled in the VIOS and shared by many IBM iclients by using virtual connectivity to the VIOS.

viii IBM XIV Storage System: Management Tools User Guide

http://www.ibm.com/systems/storage/disk/xiv/


http://www.redbooks.ibm.com/abstracts/sg247659.html



http://www.redbooks.ibm.com/redpieces/abstracts/redp4598.html

http://www.redbooks.ibm.com/redpieces/abstracts/redp4598.html

Table 1. IBM XIV related publications (continued)

Title Description

XIV Storage System: Host Attachmentand Interoperability

This Redbooks publication describes how to attach anXIV system to various hosting operating systems incombination with databases and otherstorage-oriented application software. It also providessolutions for combining the IBM XIV Storage Systemwith other storage systems, host servers, or gateways.

IBM XIV Storage System: CopyServices and Migration

This Redbooks publication describes IBM XIV StorageSystem copy and migration functions for various dataprotection scenarios to enhance your businesscontinuance, data migration, and online-backupsolutions. These include point-in-time copies (alsoknown as snapshots and full volume copies) andremote-copy capabilities in synchronous orasynchronous mode. This book also describes how tointegrate the snapshot function with the IBM Tivoli®

FlashCopy® Manager, built-in migration capability,and migration alternatives that are based on the IBMSAN Volume Controller.

Related websites

View these websites to get more information about the XIV system.

Table 2. IBM XIV related websites

Title Description

IBM website Find more information about IBM products andservices.

IBM Support Portal website Find support-related information such as downloads,documentation, troubleshooting, and service requestsand PMRs.

IBM Directory of WorldwideContacts website

Find contact information for general inquiries,technical support, and hardware and softwaresupport by country.

IBM XIV Storage System website(http://www.ibm.com/systems/storage/disk/xiv/)

Use this website to learn about the XIV system,including features and hardware summary. Thiswebsite also has links to white papers, Redbookspublications, and product documentation.

IBM Support Portal website(www.ibm.com/storage/support)

Use this website to obtain downloadable files, links tosubmit and track problems, and support phonenumbers and contacts.

IBM Systems Storage forum website(www.ibm.com/developerworks/forums/forum.jspa?forumID=846)

Use this forum to share ideas with knowledgeableexperts and discover how the latest IBM storagesolutions can address your business challenges.Forum topics include storage management, storagevirtualization, business continuity, infrastructuresimplification, disk storage systems, and storagesoftware products and solutions.

About this guide ix

http://www.redbooks.ibm.com/redpieces/abstracts/sg247904.html

http://www.redbooks.ibm.com/redpieces/abstracts/sg247904.html



http://ibm.com

http://www.ibm.com/storage/support

http://www.ibm.com/planetwide




http://www.ibm.com/developerworks/forums/forum.jspa?forumID=846

Getting information, help, and serviceIf you need help, service, technical assistance, or want more information about IBMproducts, you can find various sources to assist you. You can view the followingwebsites to get information about IBM products and services and to find the latesttechnical information and support.v IBM website (ibm.com®)v IBM Support Portal website (www.ibm.com/storage/support)v IBM Directory of Worldwide Contacts website (www.ibm.com/planetwide)

Ordering publicationsThe IBM Publications Center is a worldwide central repository for IBM productpublications and marketing material.

The IBM Publications Center website (www.ibm.com/shop/publications/order/)offers customized search functions to help you find the publications that you need.Some publications are available for you to view or download at no charge. You canalso order publications. The publications center displays prices in your localcurrency.

Sending your commentsYour feedback is important in helping to provide the most accurate and highestquality information.

Procedure

To submit any comments about this book or any other IBM XIV Storage Systemdocumentation:v Go to the feedback form (http://publib.boulder.ibm.com/infocenter/ibmxiv/r2/

topic/com.ibm.help.xiv.doc/icfeedback.htm) in the IBM XIV Storage Systeminformation center. You can use this form to enter and submit comments.

v Send your comments by email to [email protected]. Be sure to include thefollowing information:– Exact publication title and version– Publication form number (for example, GA32-0770-00)– Page, table, or illustration numbers that you are commenting on– A detailed description of any information that needs to be changed

x IBM XIV Storage System: Management Tools User Guide

http://www.ibm.com



http://www.ibm.com/shop/publications/order/

http://publib.boulder.ibm.com/infocenter/ibmxiv/r2/topic/com.ibm.help.xiv.doc/icfeedback.htm

mailto:[email protected]?subject=IBM XIV Storage System publications

Chapter 1. Introduction

IBM XIV Management Tools version 4.0 introduces the IBM XIV Multi-SystemManager that reduces operational complexity and enhances capacity planningthrough integrated management for large and multi-site XIV deployments. TheManagement Tools:v Shifts the paradigm to an integrated management of XIV Systems across the

enterprisev Provides powerful health monitoring by integrating events and alerts across the

managed XIV Systemsv Extends management scalability to smartphones and tablets

Diagram

The following diagram depicts the way the IBM XIV Multi-System Managerinteracts with the XIV GUI and XIV Systems.

DefinitionsThe following definitions are in wide use throughout this document:

xiv

10

41

2

Multi System Manager

GUI Client

Site A Site B Site C

Multi System Manager Multi System Manager

GUI ClientGUI Client

Datacenter BDatacenter A Datacenter C

Vmotion(optional)

Cross-site high availability

Figure 1. IBM XIV Multi-System Manager

© Copyright IBM Corp. 2012, 2013 1

Server Mode vs. Direct Mode from the login dialog of the GUIWith the introduction of the IBM XIV Multi-System Manager, there are twoways to use the IBM XIV Management Tools:

Server modeConnecting the GUI to work with the IBM XIV Multi-SystemManager.

Direct modeUsing the GUI without IBM XIV Multi-System Manager. In thismode, the GUI manages the XIV Systems directly.

The 'maintenance' accountA Multi-System Manager SFTP user that transfers files from and to theMulti-System Manager. The default password is xivmsMaintenance. You canchange this password through the root menu. See “Changing themaintenance password” on page 53.

System machine accountAn XIV user that monitors all XIV systems in the Multi-System Managerinventory. This user authenticates into all XIV systems in order to pollconfiguration data only.v This user does not change the configurationv This user's name is hardcoded: xiv_msms

v This user can be defined in LDAPv This user must have a storage administrator role (similarly to the admin

user)v This user must be defined with the same password on all XIV systems

in the Multi-System Manager inventoryv This user must be defined in the Multi-System Manager (through the

GUI or CLI)

Diagnose/Fix authentication problemA process in which the GUI tries to fix the System Machine Accountauthentication issues among all XIV systems in the inventory.v You need to supply admin credentials when launching this operationv These credentials will be used to add the System Machine Account

automatically to all your XIVs (if needed)v If some of the XIV systems use LDAP authentication, it will inform you

to manually add the System Machine Account to your LDAP directory

Discover new systemsA process in which the Multi-System Manager tries to authenticate aspecific user in front of all of the systems that the Multi-System Managerknows that the user is not authenticated to.v This button is located on the Systems > Preferences dialog.v Use this button only when it is known that the user was added to the

system's access list and you need to display this system on the GUIscreen. This is not done automatically, because of potential LDAPlocking issues, due to authentication errors.

v Upon a successful completion of the process, if the user was grantedwith an access to a system that was not previously seen in the GUI, itwill now be seen.

Manager Access CodeAny administrative action on the Multi-System Manager, that is performed

2 IBM XIV Storage System: Management Tools User Guide

from the GUI requires the Manager Access Code. This code can be changedfrom GUI and from the root menu. The default manager access code isadminadmin. See here: “Changing the manager access code” on page 53.

Management Tools specificationsThe Management Tools deployment contains specifications for:v The Multi-System Managerv IBM XIV GUI specifications for direct and server modes

Multi-System Manager specificationsThe Multi-System Manager deployment is running as a Virtual Appliance above anESX server (VMWare Hypervisor only). This deployment comes with 4GB memoryand dual vCPU by default.

Right after its deployment, revise the specifications depending on the amount ofXIV systems you will manage using the Multi-System Manager:

Up to 60 systemsMemory - 4 GB

vCPU - Dual

61-100 systemsMemory - 6 GB

vCPU - Quad

101-120 systemsMemory - 6 GB

vCPU - Six

121-144 systemsMemory - 8GB

vCPU - Six

Other specificationsv An ESX (VMware) Server that will host the Multi-System Manager, versions: 4,

i4, 4.1, i4.1, i5.v VM disk size - 76 GBv Ports that need to be opened:

– Outbound/Inbound: RMI - 1199-1209– Inbound only: SSH/SCP - 22– Outbound only: SMTP - 25

- Communication with XIV systems - 7778v Allowed latency between the Multi-System Manager and the XIV systems it

monitors: max of 200 msv Maximum number of concurrent GUIs connected to one Multi-System Manager-

15v Maximum XIV Systems administered by one Multi-System Manager- 144

GUI specificationsThe Management Tools run on either direct mode or server mode. Thespecifications for each are detailed below.

Chapter 1. Introduction 3

Direct mode

CPU Dual core

Memory

Up to 25 systems700MB

More than 25 systems1.1GB

Max number of XIV systems monitored by a single XIV GUI in direct mode is:81

Best practice: IBM XIV recommends to use the Multi-System Manager andan XIV GUI in server mode if you have more than 40 systems.

Server mode

CPU Dual core

Memory300MB

Allowed latency between a single XIV GUI and the Multi-System Manager:Max of 50ms

Supported OS for XIVGUI, XCLI, XIVTOP

Windows

v Windows 2000 x86-3v Windows XP x86-32v Windows XP x86-64v Windows Server 2003 x86-32v Windows Server 2003 x86-64v Windows Server 2008 x86-32v Windows Server 2008 x86-64v Windows 7 x86-32v Windows 7 x86-64v Windows Vista x86-32v Windows Vista x86-64

CPU: 32 bit Dual Core or equivalent, 64 bit.

Linux

v Linux Red Hat 5 x86-3v Linux Red Hat 5 x86-6

Mac OS: MAC OS X 10.6 or 10.7, with Java™ version 1.6.

CPU: 32 bit Dual Core or equivalent.

JAVA minimum requirements: JAVA version 6_build 29.

Additional supported OS for XCLI only

AIX® OS: AIX 5.3, AIX 6.1, AIX 7.1.

SolarisOS: Solaris 10.


CPU:SPARC, x64.

HPUX OS: HPUX 11i v3

CPU: IA64.

Chapter 1. Introduction 5

Chapter 2. Installing the Management Tools

With the introduction of the IBM XIV Multi-System Manager, there are two waysto use the IBM XIV Management Tools:

Server modeConnecting the GUI to work with the IBM XIV Multi-System Manager.

Direct modeUsing the GUI without IBM XIV Multi-System Manager. In this mode, theGUI manages the XIV Systems directly.

This chapter guides you how to work in Server mode.

The installation of the Multi-System Manager is composed of:1. Installing the Multi-System Manager virtual appliance2. Configuring the Multi-System Manager3. Initializing the Multi-System Manager inventory

Installation-related tasks guide you through upgrading the Multi-System Managerand backing it up:1. Chapter 3, “Upgrading the Multi-System Manager,” on page 232. Chapter 4, “Backing up and restoring the Multi-System Manager,” on page 27

Note: If you are already using the Multi-System Manager version 1.1, jumpdirectly to Chapter 3, “Upgrading the Multi-System Manager,” on page 23.

Installing the Multi-System Manager virtual applianceThe Multi-System Manager deployment is running as a Virtual Appliance above anESX server (VMWare Hypervisor only). Prior to the configuration of theMulti-System Manager, you need to install it as a VM using Deploy OVF Template inthe ESX vSphere Client.

Before you begin1. Get the file named: XIV_Multi-System-Manager_1.2.x.zip from from:

http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=Enterprise+Storage+Servers&product=ibm/Storage_Disk/XIV+Storage+System+(2810,+2812)&release=1.2&platform=All&function=all..

2. Unzip it to your local PC that has accessibility to VMWare vSphere client.

This will create a folder name: XIV_Multi-System-Manager. The folder contains 3files used by the *.ovf deployment process, a quick-start guide, and an additionalLICENSES folder with additional notes regarding the usage license.

About this task

The virtual machine installation deploys the ovf image of the Multi-SystemManager on your VMWare ESX.


http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=Enterprise+Storage+Servers&product=ibm/Storage_Disk/XIV+Storage+System+(2810,+2812)&release=1.2&platform=All&function=all.

http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=Enterprise+Storage+Servers&product=ibm/Storage_Disk/XIV+Storage+System+(2810,+2812)&release=1.2&platform=All&function=all.

http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=Enterprise+Storage+Servers&product=ibm/Storage_Disk/XIV+Storage+System+(2810,+2812)&release=1.2&platform=All&function=all

Procedure1. Deploy *.ovf on your VMWare ESX. Refer to instructions on how to do that in:

http://pubs.vmware.com/vsphere-4-esx-vcenter/index.jsp?topic=/com.vmware.vsphere.vmadmin.doc_41/vsp_vm_guide/working_with_ovf_templates/t_import_a_virtual_appliance.html.

2. Boot the VM.3. On the VMWare console, login with: user=root, password=xivmsRoot.4. The wizard opens on screen. Follow the steps on the next section.

Configuring the Multi-System ManagerThe purpose of this task is to configure the Multi-System Manager on the installedVM.

Procedure

The wizard welcome screen guides you through the steps of the installation.

---------------------------------------------------------------------------------- IBM XIV Multi-System Manager v1.2.0.x --------------------------------------------------------------------------------

Welcome to the IBM XIV Multi-System Manager installation procedure.

This setup will guide you through the installation process.

Required Steps--------------Step 1: License AgreementStep 2: Password ChangeStep 3: NetworkingStep 4: NTP & Regional SettingsStep 5: SMTP

Proceed? [Y/N] >

Click Y to proceed, or N to decline.

Step 1On step 1 of the installation you are required to approve the license agreement.


http://pubs.vmware.com/vsphere-4-esx-vcenter/index.jsp?topic=/com.vmware.vsphere.vmadmin.doc_41/vsp_vm_guide/working_with_ovf_templates/t_import_a_virtual_appliance.html



Procedure1. Click Enter to view the Multi-System Manager license agreement.


---> Step 1: License AgreementStep 2: Password ChangeStep 3: NetworkingStep 4: NTP & Regional SettingsStep 5: SMTP

Step 1 - License Agreement---------------------------

Hit [ENTER] to view license agreement for using IBM XIV Multi-System ManagerPress any key to continue

2. After reading the license agreement, click 1 to approve or 2 to decline it.

Note: You will not be allowed to proceed with the installation, or to use theMulti-System Manager if you do not approve the license agreement.

Step 2On step 2 of the installation you are required to change the root password.

Procedure

Enter a new password, then retype it.


Step 1: License Agreement---> Step 2: Password Change

Step 3: NetworkingStep 4: NTP & Regional SettingsStep 5: SMTP

Step 2 >> Password Change-------------------------

Please change root passwordPassword must be at 6 characters longType new password for root

Step 3On step 3 of the installation you are asked to configure the network.

Before you begin

Throughout the installation we present examples with values surrounded withbrackets. The value inside the brackets is the default. Clicking enter withoutinserting a value, will insert the default value.

Chapter 2. Installing the Management Tools 9

Procedure1. First, select between Static IP and DHCP.


Step 1: License AgreementStep 2: Password Change

---> Step 3: NetworkingStep 4: NTP & Regional SettingsStep 5: SMTP

Step 3 -Network Configuration------------------------------

#------------------------------------# Active Network configuration:#------------------------------------# IP mode# Hostname

1) Configure Static IP2) Configure DHCP3) Return (not supported, installation mode)Setup/Network/IP>

2. If Static IP was chosen, you need to enter the IP address and then the netmask,gateway and DNS parameters.a. Enter your IP address to continue.






Configure static IP address

Enter IP address []:

b. Enter the netmask, gateway and DNS parameters related to the static IP.Follow the questions on the screen.






#------------------------------------# Active Network configuration:#------------------------------------# IP mode OFF# Hostname# Domain search list# Domain name servers

#------------------------------------# New Network configuration:#------------------------------------# IP mode STATIC# Hostname# IP address 1.1.1.1# Netmask 1.1.1.1# Gateway 1.1.1.1# Domain search list ibm.com xiv.ibm.com# Domain name servers 1.1.1.1 2.2.2.2

Configure DNS addressess1) Add domain to search list2) Remove domain from search list3) Continue to hostname configurationSetup/Network/DNS>

Following the configuration of the DNS, IP, gateway and netmask, you willbe asked to enter a fully-qualified hostname and then to approve theconfiguration.

c. Click Y to approve and proceed to the next step.







#------------------------------------# New Network configuration:#------------------------------------# IP mode DHCP# Domain search list ibm.com xiv.ibm.com# Domain name servers 1.1.1.1 2.2.2.2# Hostname

Is the configuration correct? [Y/N] :

Clicking N will take you back to the beginning of step 3 of the installationabove.

3. If you selected DHCP on step 1 above, enter the hostname and click Y toconfirm.





#------------------------------------# Active network configuration#------------------------------------# IP mode NONE# Hostname# Domain search list# Domain name servers

#------------------------------------# New network configuration#------------------------------------# IP mode DHCP# Hostname myHostname# Domain search list Automatically retrieved# Domain name servers Automatically retrieved



Step 4On this step you enter the NTP and regional settings. Select whether to enableNTP or configure static date&time. Additionally, you may need to define thetimezone.

Procedure1. Optional: click 2 to set the timezone.

1) Enable NTP2) Timezone3) Change Date&time4) ContinueSetup/Regional Settings>

Select a global region.

Please identify a location so that time zone rules can be set correctly.Please select a continent or ocean.1) Africa2) Americas3) Antarctica4) Arctic Ocean5) Asia6) Atlantic Ocean7) Australia8) Europe9) Indian Ocean10) Pacific Ocean11) none - I want to specify the time zone using the Posix TZ format.

Next, you are asked to select a country from within the global region.

Note: You may be asked to select a sub region.2. Optional: If you decide to configure NTP instead of static date&time, follow the

instructions on this step. If you don't, go to step 3 below. Click 1 to enable NTP.


Step 1: License AgreementStep 2: Password ChangeStep 3: Networking

---> Step 4: NTP & Regional SettingsStep 5: SMTP

Step 6 -NTP & Regional Configuration-------------------------------------

#------------------------------------# Active NTP/Regional configuration:# -----------------------------------# NTP status DISABLED# Date 12/31/2012 23:59:59# Timezone UTC

Configure NTP servers1) Add NTP server2) Remove NTP server3) Return to previous menuSetup/Regional Settings/NTP>


Add the NTP servers in your organization, one by one using the menu optionsabove. When finished, click 3 to return to NTP & Regional Settings main menu.

3. If you decided to configure static Date & Time instead of NTP settings, click 3to configure Date & Time.

Configure Date & TimeLocal date&time is: <current date and time> Please enter a new date in format:mm/dd/yyyy 24H:MM:SS >

Note: If you configured NTP, it is not mandatory to configure the Date & Time.Upon the next reboot, the NTP settings will take place.

4. Review the changes (in the NTP & Regional Settings main menu) and thenclick 4 to apply your changes. Alternately, you can repeat any of the previoussteps in order to update the configuration.

Step 5The next step is SMTP configuration.

About this task

SMTP configuration is utilized for enabling sending email addresses to anyrecipient you configure in case of a service failure. The available SMTP emailaddresses are:

Server is upSubject: [Watchdog Message] Service xivms is up and running properly.

Body: Component: Main process was started successfully and is up andrunning.

Server is downSubject: [Watchdog Message] Attention: service xivms stoppedfunctioning properly.

Body: Component: Main process stopped.

Server has low disk spaceSubject: [Watchdog Message] Attention: low disk space.

Body: Disk space passed the configured threshold max% and its usagenow is: used%.

System Machine Account is not authenticatedSubject: <hostname> System Machine Account alert.

Body: The System Machine Account (user: xiv_msms) is notauthenticated to work with the following systems:<system name>

Note: This step is not mandatory and by selecting option 3 in the menu, you skipit.


Procedure1. Click 1 to enable SMTP configuration.

---------------------------------------------------------------------------------- IBM XIV Multi System Manager v1.2.0.x -------------

-------------------------------------------------------------------

Step 1: License AgreementStep 2: Password ChangeStep 3: NetworkingStep 4: NTP & Regional Settings

---> Step 5: SMTP

Step 5 -SMTP Configuration--------------------------

#------------------------------------# Active SMTP configuration:# -----------------------------------# SMTP status DISABLED

1) Enable SMTP configuration2) Apply All3) Return without savingSetup/SMTP>

2. Enter the SMTP server address.

Enter address of SMTP server []:

3. Enter the SMTP server port.

Enter the SMTP server port [25]:

4. Approve the configuration.


---------------------------------------------------------------------------------- IBM XIV Multi System Manager v1.2.0.x -------------

-------------------------------------------------------------------

Step 1: License AgreementStep 2: Password ChangeStep 3: NetworkingStep 4: NTP & Regional Settings

---> Step 5: SMTP

Step 5 -SMTP Configuration--------------------------

#------------------------------------# Active SMTP configuration:# -----------------------------------# SMTP status DISABLED

#------------------------------------# New SMTP configuration#------------------------------------# SMTP status ACTIVE# SMTP server 9.9.9.9# SMTP port 25


The installation is completeThe installation is now complete.

About this task

The last screen of the installation contains information about the way theMulti-System Manager is connected (Static IP or DHCP).

For static IP connectivity

Congratulations!----------------You successfully installed IBM XIV Multi-System Manager v1.2You can now open any XIV GUI and point to the IP: 192.25.25.25or DNS: msms-amit from Systems-->Preferences dialog.The Manager Access Code that allows Multi-System Managerconfiguration from the XIV GUI is: adminadmin.Enjoy a world of multi system features!Finalizing installation, please wait.The system is going to reboot.Press any key to continue

For DHCP connectivity

Congratulations!----------------You successfully installed IBM XIV Multi-System Manager v1.2You can now open any XIV GUI and point to the DNS: msms-amit fromSystems-->Preferences dialog.The Manager Access Code that allows Multi-System Manager configurationfrom the XIV GUI is: adminadmin.Enjoy a world of multi system features!Finalizing installation, please wait.The system is going to reboot.Press any key to continue


Procedure

Press any key. The Multi-System Manager restarts.

What to do next

Proceed to the next section “Initializing the inventory.”

Initializing the inventoryInstall the XIV GUI and set it to work with the Multi-System Manager.

Before you beginv If you are using previous GUI versions: open the previous GUI and export

systems list (File > Export Systems File) to a file in your local file system (to beimported later to the Multi-System Manager).

v Obtain the GUI from http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=Enterprise+Storage+Servers&product=ibm/Storage_Disk/XIV+Storage+System+(2810,+2812)&release=4.1&platform=All&function=all.

About this task

This task guides you through:v Installing the XIV GUI and setting it to be managed by the Multi-System

Manager.v Initializing the systems inventory on the Multi-System Manager.

Procedure1. Install XIV GUI 4.1 and login in Direct mode.2. Connect the GUI to the Multi-System Manager.

a. Select Systems > Preferences from the menu. The User Preferences screenopens. Fill the Primary Management Server field and click OK.





b. The Certificate Details screen opens. The Multi-System Manager version 1.2is published using an XIV default that is not signed by a CA, certificate.You can either:v Trust Once - only for the current GUI session.v Trust Always - never being asked again about it.v Replace the Multi-System Manager certificate via the Multi-System

Manager root menu. See “Replacing the Multi-System Managercertificate” on page 54.

aaaaaaaaaaaaaaaaaaaaaaaa












aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa a a a a a a a a a a a a a a a a a a a a a a a































































aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa a a a a a a a a a a a


aaaaaaaaaaaaaaaaaaaaaaaaaaaaa a a a






















InfiniBand switch 2

InfiniBand switch 1Maintenance module

ModemInterface module 6

Data module 3

Interface module 5

Interface module 4

Data module 2

Data module 1

Uninterruptible power supply 3



Automatic transfer switch

Front Rear xiv

10417

Figure 2. Multi-System ManagerPrimary Management Server


c. Fill the access code on the Multi-System Manager Access Code screen. Incase the Manager Access code was not defined yet, the default isadminadmin. Read more about the Manager Access code on the “Definitions”on page 1 section.

d. The Credentials tab of the Manager Configuration screen opens.

xiv

10

50

7

Figure 3. The Certificate Details screen

xiv

10

51

9

Figure 4. Multi-System Manager Access Code


3. On the same screen, determine a new password for the Systems MachineAccount (This is a system user that will monitor it on the Multi-SystemManager. See “Definitions” on page 1.). Fill the Systems Machine Accountpassword and click OK.

4. On the Manager Configuration screen, open the Inventory tab. Perform thefollowing sub steps:a. If you have a previously exported systems file, Click Import systems from

file, browse to the XML file and import it. Else, jump to bullet b.

Systems are added to the screen.b. If you do not have a systems file, you can add systems manually. Click the

add system icon.c. If the added screens get an Authentication Error status, select the not

authenticated systems, right-click and select: Diagnose/Fix AuthenticationError from the context menu. Read more on the diagnose and fix process onthe “Definitions” on page 1 topic.

xiv

10

50

8

Figure 5. The Remember Me checkbox

xiv

10509


Installing another IBM XIV Multi-System ManagerThe number of Multi System Managers that you can install is limitless. Each ofthese Multi System Managers can monitor all XIV Systems in your organization.There is no redundancy or communication between the Multi System Managersthemselves.

The GUI can be connected to two Multi System Managers (Primary andSecondary) for the use of manual switch over in case one is not responding. Thisway, you can achieve high availability of Multi System Managers.

Using this architecture, you can gain high performance of the GUIs by connectingthem to a Multi System Manager located in their site, whereas other remotelylocated GUIs will connect to another Multi System Manager that is located on theirsite.

xiv

10411


GUI Client

Datacenter A

Site A Site B


GUI Client

Datacenter B

Cross-site high availability

Figure 6. Cross site high availability


Chapter 3. Upgrading the Multi-System Manager

Upgrading the Multi-System Manager

About this task

This section describes how to upgrade to the current version of the Multi-SystemManager. As part of the upgrade, this procedure backs up the followingconfigurations:v Multi-System Manager inventoryv Users workspaces - where information about users and the systems they work

on is savedv RMI portsv Trusted certificatev SMTP configuration

The backup process does not backup other configurations and data, such as:v Network and NTP (See “Step 3” on page 9 of the installation).v System Machine Account password (See “Changing the System Machine

Account password” on page 46).v Manager Access Code (See “Changing the manager access code” on page 53).v Multi-System Manager certificatev Multi-System Manager logs

In order to configure these not-to-be-saved configurations, please refer to therelevant sections on this user guide.

Procedure1. Back up the database:

a. Click 5 on the root menu. The Backup and Restore Menu is displayed onscreen.

Backup and Restore Menu-----------------------

1) Backup2) Restore3) Schedule Daily Backup4) Remove Scheduled Backup5) ExitYour Selection>

b. Click 1 to back up the database. The backup process takes place:

Your Selection>1Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file:backup/BACKUP_20120815_082926.tar.gzPress any key to continue

The backup file name is displayed on screen.c. Press any key to return to the Backup and Restore Menu.


2. Export the backup:a. Before you begin, ensure the following:

v You need maintenance credentials in order to perform the following tasks.v The initial password of the maintenance user is xivmsMaintenance.v Make sure the root user changes the password of the maintenance user

as soon as possible. See here: “Changing the maintenance password” onpage 53.

b. Export the backup.

sftp maintenance@msms-12-8-servPassword:Connecting to msms-12-8-serv.sftp> cd backupsftp> get <backup_file_name>

3. Upgrade the Multi-System Manager:a. Upload the upgrade file to the upload folder of the target Multi-System

Manager using SFTP and maintenance user credentials.b. Click 13 on the root menu.

Your Selection>13This utility will run the upgrade procedure of IBM XIV Multi-System ManagerThe backup database will run prior the upgrade.Press any key to continue

c. Next, provided that an upgrade file was uploaded as stated above, select afile from the list:

Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file:backup/BACKUP_20120815_105757.tar.gz

Please upload the upgrade file (*.tar.gz) using SFTP and user ’maintenance’to upload folder.Press any key to continue

Files in upload folder----------------------XIV_Multi_System_Manager_Upgrade.tar.gzXIV_Multi_System_Manager_Upgrade_1.2.tar.gzdd.tar.gz

Please enter the name of the upgrade file >

d. Enter the file name. You will be asked to confirm the upgrade.

IBM XIV Multi-System Manager will be upgraded to version 1.2.0.x.Please confirm stopping the Multi-System Manager serviceand upgrading now [Y/N] >

e. During the upgrade, you will be prompted to accept the new license. Enter1 to confirm. Upon confirmation, the upgrade takes place, resulting in thefollowing message:

The upgrade to IBM XIV Multi-System Manager version 1.2.0.x completed successfully.Your session is going to end in order for the changes to take effect.Following the upgrade, users that are logged into the Multi-System Manager rootmenu will have to re-login.Press any key to continue


4. The upgrade is complete. Open the XIV GUI.

If the upgrade fails

a. Delete the VM.b. Re-install the previous Multi-System Manager version. See

instructions here: Chapter 2, “Installing the Management Tools,” onpage 7.

c. Import the backup and restore it.d. Set the System Machine Account and the Manager Access Code. See

the definitions to both here: “Definitions” on page 1. You can do iteither from the GUI or on the CLI.

On the GUIFollow the instructions on step 4“Initializing the inventory”on page 17 of the Initializing the inventory section.

From the CLIGo to “Changing the System Machine Account password”on page 46 See “Changing the manager access code” onpage 53.

Chapter 3. Upgrading the Multi-System Manager 25

Chapter 4. Backing up and restoring the Multi-SystemManager

This chapter describes how to backup the Multi-System Manager and how torestore it.

Backing up the Multi-System ManagerBacking up the Multi-System Manager

About this task

This section describes how to backup the inventory configuration of theMulti-System Manager. All of the backup and restore options are accessible fromthe root menu. This section describes the best practice. The backup procedure backsup the following configurations:v Multi-System Manager inventoryv Users workspaces - where information about users and the systems they work


The backup process does not backup other configurations and data, such as:v Network and NTP (See “Step 3” on page 9 of the installation).v System Machine Account password (See “Changing the System Machine


In order to configure these not-to-be-saved configurations, please refer to therelevant sections on this user guide.

Procedure1. Back up:

a. Click 5 on the root menu. The Backup and Restore Menu is displayed onscreen.



b. Click 1 to back up the database. The backup process takes place:


Your Selection>1Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file:backup/BACKUP_20120815_082926.tar.gzPress any key to continue

The backup file name is displayed on screen.c. Press any key to return to the Backup and Restore Menu.

2. Export the backup:a. Before you begin, ensure the following:

v You need maintenance credentials in order to perform the following tasks.v The initial password of the maintenance user is xivmsMaintenance.v Make sure the root user changes the password of the maintenance user

as soon as possible. See here: “Changing the maintenance password” onpage 53.

b. Export the backup. SFTP to the server using the maintenance account andexport the backup file outside the Multi-System Manager

sftp maintenance@msms-12-8-servPassword:Connecting to msms-12-8-serv.sftp> cd backupsftp> get <backup_file_name>

Restoring the Multi-System ManagerRestoring the Multi-System Manager

About this task

This section describes how to restore the inventory configuration of theMulti-System Manager from a backup. All of the backup and restore options areaccessible from the root menu. This section describes the best practice. The restoreprocedure restores the following configurations:v Multi-System Manager inventoryv Users workspaces - where information about users and the systems they work


The restore process does not restore other configurations and data, such as:v Network and NTP (See “Step 3” on page 9 of the installation).v System Machine Account password (See “Changing the System Machine


In order to configure these not-restored configurations, please refer to the relevantsections on this user guide.


Procedure1. Restore the Multi-System Manager database to the target Manager.

a. SFTP to the target Multi-System Manager using the maintenance account.Put the backup file in the backup folder.

sftp maintenance@msms-12-8-igorgPassword:Connected to msms-12-8-igorg.sftp> put BACKUP_20121101_131435.tar.gz uploadUploading BACKUP_20121101_131435.tar.gz to/upload/BACKUP_20121101_131435.tar.gzBACKUP_20121101_131435.tar.gz

b. In the target Multi-System Manager, click 5 on the root menu. The Backupand Restore Menu is displayed on screen.


c. Click 2 to restore the Multi-System Manager.d. Select a file to restore from:

Your Selection>2Backup files to restore:------------------------BACKUP_20120815_085300.tar.gzBACKUP_20120814_085000.tar.gz

Please select a backup file to restore >BACKUP_20120815_085300.tar.gz

e. Click Y to confirm.f. Confirm again:

Are you sure you want to restore BACKUP_20120815_085300.tar.gz? [Y/N] : y

Restore DB is going to override your current configuration.It is recommended to run a backup prior restoring.Do you want to run backup of the current configuration before restoring? [Y/N] :

g. The restore takes place:

Chapter 4. Backing up and restoring the Multi-System Manager 29

Backup files to restore:------------------------BACKUP_20120827_112834.tar.gzBACKUP_20120827_112511.tar.gzBACKUP_20120814_122049.tar.gz



Restore DB is going to override your current configuration.It is recommended to run a backup prior to restoring.Do you want to run backup of the current configuration before restoring? [Y/N] : y

Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file:backup/BACKUP_20120827_112904.tar.gzxivms v1.2.0.x is stopped

Restoring BACKUP_20120814_122049.tar.gz...Restore completed successfully

Note: The following configurations were not restored(the pre-restore configurations were kept):System Machine Account passwordManager Access CodeManager CertificateIf you wish to set them, please refer to the user guide for further explanations.

xivms v1.2.0.x is starting...

h. Press any key to return to the Backup and Restore menu.2. Once the restore is complete, you need to redefine:

v The System Machine Accountv The Manager Access Code

See a definitions to both here: “Definitions” on page 1. You can do it eitherfrom the GUI or on the CLI.

On the GUIFollow the instructions on step 4“Initializing the inventory” on page 17of the Initializing the inventory section.

From the CLIGo to “Changing the System Machine Account password” on page 46.See “Changing the manager access code” on page 53.


Chapter 5. Managing the XIV and Multi-System Managercertificates

Management Tools 4.1 provides the ability to manage the XIV and Multi-SystemManager certificates.

When the XIV GUI connects to a Multi-System Manager or to an XIV systemdirectly, or when a Multi-System Manager connects to an XIV system, they areattempting to identify the certificate of the XIV/Multi-System Manager.

This chapter describes the methods of handling certificates in the GUI. ForHandling certificates from the Multi-System Manager menu, please see “Managingthe certificates” on page 47.

GUI Certificate Management in Direct Mode

Importing Certificates into the Local Trust StoreImport Certificates into the Local Trust Store.

Procedure

To import a new Certificate or Certificate Authority, open Tools > Management >Certificates (Tab), and click the Import certificate icon.

Note: After importing a new certificate into the trust store and exiting theManagement window, all XIV systems with certificate errors are reloaded.

Removing Certificates from the Local Trust StoreRemove a certificate from the Local Trust Store.

Procedure1. To remove a Certificate from the Local Trust Store, open Tools > Management

> Certificates (Tab)

xiv

10512

Figure 7. Importing Certificates into the Local Trust Store


2. Select the certificate to remove, and click the Remove certificate icon.

Note: After removing a certificate from the trust store and exiting theManagement window, all XIV systems are reloaded.

Handling system certificate errorsHandle system certificate errors.

Procedure1. Right-click the XIV Storage System with Certificate Error status and choose

Manage Certificate from the pop-up menu.

2. Review the presented certificate to ensure that it can be trusted and choose oneof the following:v Trust Once - to confirm that the certificate of this system can be trusted only

during this GUI session.v Trust Always - to confirm that this certificate can be trusted. Certificate will

be added to the Local Trust Store.

Note: After confirmation, all XIV Storage Systems in the Certificate Error statusthat are using the same certificate will be automatically reloaded and validated.

xiv

10513

Figure 8. Handling system certificate errors


GUI Certificate Management in Server ModeIn server mode, the GUI does not directly connect to the XIV Storage systems, soin order to validate the XIV system's certificate, the Multi-System Managermaintains the trust store and the GUI provides the ability to manage it.

Note: Multi-System Manager Certificates can also be managed via Server Scripts.

Importing Certificates into the MSM Trust StoreImport Certificates into the MSM Trust Store.

Procedure1. To import a new certificate or Certificate Authority, open Systems > Manager

Configuration > XIV Certificates (Tab).2. Click the Import certificate icon.

Note: After importing a new certificate into the MSM trust store and exitingthe Manager window or switching to another tab, all XIV systems withCertificate Error status are reloaded.

xiv

10514

Figure 9. System certificate

Chapter 5. Managing the XIV and Multi-System Manager certificates 33

Removing Certificates from the MSM Trust StoreRemove a certificate from the MSM Trust Store.

Procedure1. To remove a Certificate from the MSM Trust Store, open Systems > Manager

Configuration > XIV Certificates (Tab).2. Select the certificate to remove, and click the Remove certificate icon.

Note: After removing a certificate from the trust store and exiting theManagement window or switching to another tab, all XIV systems are reloaded.

Handling systems certificate errors in server modeHandle system certificate errors in server mode.

Procedure1. Open Systems > Manager Configuration > Inventory (Tab)

2. Right-click the system with the Certificate Error status, and choose ManageCertificate from the pop-up menu.

xiv

10

51

6

Figure 10. Importing Certificates into the MSM Trust Store


3. Review the presented certificate to ensure that it can be trusted and click theTrust Always button. The certificate will be imported into MSM Trust Store.

Note: After confirmation, all XIV systems with the Certificate Error status thatare using the same certificate are automatically reloaded and validated.

Multi-System Manager Certificate Management

Handling the Multi-System Manager certificateMandling the Multi-System Manager certificate

xiv

10517

Figure 11. Handling system certificate errors

xiv

10518

Figure 12. System certificate


About this task

In order to validate the MSM certificate GUI uses the local trust store.

Procedure

When switching from the Direct Mode to the Server Mode, or switching from oneserver to another, the MSM certificate will be validated. If the Certificate cannot bevalidated the Certificate Details window will be displayed. To start working withthe server the Certificate should be confirmed in one of the following ways:1. Trust Once - the certificate will be treated as trusted only in this GUI session.2. Trust Always - the certificate is confirmed as trusted and will be imported into

the Local Trust Store.

Replacing the Multi-System Manager certificateThe Multi-System Manager version 1.2 is published using an XIV default that isnot signed by a CA certificate. You can replace it with another certificate.

Procedure1. In the GUI, go to Systems>Manager Configuration>Administration (tab).

xiv

10

51

5

Figure 13. MSM certificate


2. In Multi-System Manager certificate, to view the certificate, click ShowCertificate.

3. In Multi-System Manager certificate, to replace the certificate, click ReplaceCertificate. Enter a certificate file in PKCS#12 format, and enter the passwordfor it. This will replace the existing certificate in the manager to the one youselect.

xiv

10520

Figure 14. Replacing the certificate


Chapter 6. Operating the Multi-System Manager

The Multi-System Manager allows access and distributes tasks among thefollowing users:

Root userThe Root user is an OS super user that carries out administrative tasks.

Maintenance userThe Maintenance user carries out Multi-System Manager configurationtasks. The Maintenance user can perform Multi-System Manageroperations using SFTP protocol (i.e gather logs, copying the upgrade file,getting the backup file, etc.).

In addition, pay attention to the following:

No Shell accessThe Multi-System Manager provides no Shell access whatsoever to any ofthe user types.

IBM technician accessibilityThe technician user type does not have access to the GUI in server mode.The GUI is accessible in direct mode.

Root user operations

Selecting an operation from the root user menu

Before you beginv You need root credentials in order to access this menu.

About this task

The Multi-System Manager root menu provides access to Multi-System Managermanagement operations.


Procedure

Login with root credentials. The following menu opens on screen:

-------------------------------------------------------------------------------- IBM XIV Multi-System Manager v1.2.0.x ----------------------------------------------------------------------------------

Super user Menu---------------IBM XIV Multi-System Manager is running

1) Server Configuration Options2) Gather Multi-System Manager Logs3) Show Audit Log4) Show upgrade Logs5) Manage Inventory Options6) Backup/Restore Options7) Change ’root’ Password8) Change ’maintenance’ Password9) Change Manager Access Code10) Start/Stop Multi-System Manager Service11) Replace Multi-System Manager Certificate12) Change XIV GUI Communication Ports13) Upgrade XIV Multi-System Manager14) Reboot15) Shutdown16) ExitYour Selection>

What to do next

The following sections explain how to carry out root user operations.

Server configuration optionsThe server configuration options allow to go back to the various configurationsteps you are already familiar with from the Multi-System Manager installation.Using these scripts you can change the Multi-System Manager configuration afterits installation.

About this task

This task allows you to change the server configuration.

Note: Changing the server configuration is not mandatory.

Procedure1. Click 1 on the root menu. The Server configuration Menu opens on screen.

-------------------------------------------------------------------------------- IBM XIV Multi-System Manager v1.2.0.x ----------------------------------------------------------------------------------

Server Configuration Menu-------------------------1) Network2) NTP & Regional Settings3) SMTP4) ExitYour Selection>


2. Select from the following options: Detailed information regarding the way toconfigure the server are available on the“Configuring the Multi-SystemManager” on page 8 in this document.

1 Network

2 NTP & Regional Settings

3 SMTP - in addition to the Server address and port that where definedduring the installation (see the relevant section on the Installationchapter: “Step 5” on page 14, from this menu you can do the following:v Define the sender email address - the address that will be displayed on

the from field of the emails.v Add a destination - email addresses that you can send emails to.v Test the SMTP configuration - by sending a confirmation email.

Relevant menu options:

1) Add destination2) Remove destination3) Remove all destinations4) Send confirmation emails5) Continue6) Return to the previous menu

4 Exit - return to the Super user menu.

Gathering the Multi-System Manager logsThe Gather Multi-System Manager Logs menu option allows you to gather logs ofthe Multi-System Manager activity.

About this task

This task allows you to gather the Multi-System Manager logs. The logs can belater collected by the Maintenance user (See here “Performing maintenance tasks”on page 57).

Procedure1. Click 2 on the root menu. A log is collected and the file name is displayed on

screen.

Your Selection>2Gathering IBM XIV Multi-System Manager logs...Gather logs completed successfullySFTP using ’maintenance’ account and get the file:logs/msms_logs_20120815_081641.tar.gzPress any key to continue

2. Pressing any key returns you to the super user menu.

What to do next

SFTP using the maintenance user credentials to collect the log from the logs folder.

Displaying the audit logThis menu option displays a log of Multi-System Manager administrationactivities.

Chapter 6. Operating the Multi-System Manager 41

About this task

The audit log displays the following Multi-System Manager administrationactivities:v Adding a system to the inventoryv Modifying the system addressv Removing a system from the inventoryv Suspending the monitoring of a systemv Suspending the monitoring of all of the systemsv Resuming the monitoring of a systemv Resume the monitoring of all of the systemsv Removing all of the systems from the inventoryv Setting the System Machine Account credentialsv Invalidating the user authenticationv Adding a System Machine Account user to a specific systemv Importing the system certificatev Accepting the system certificatev Removing the system certificate

The audit log is stored into a file that can be collected. See “Gathering theMulti-System Manager logs” on page 41.

Procedure1. Click 3 on the root menu. A log is collected and is displayed on screen.

Your Selection>318:05:13,924 admin Remove all systems from the inventory. [Success]11:32:38,964 admin Remove system 9.151.133.239 from the inventory [Success]11:32:48,423 admin Add system [mn00010:7778] to the inventory [Success]11:33:07,202 admin Robot user credentials change

[Failed: Password was not changed]11:34:39,320 admin Robot user credentials change [Success]

2. Pressing any key returns you to the Super User menu.

Displaying the upgrade logsThis menu option displays the upgrade logs.

About this task

Upgrade logs can be displayed on screen and exported via SFTP.


Procedure1. Click 4 on the root menu. The upgrade logs are displayed on screen.


Super User Menu-------------------------------1) Server Configuration Options2) Gather Server Logs3) Show Audit Logs4) Show Upgrade Logs5) Manager Inventory Options6) Backup/Restore Options7) Change ’root’ Password8) Change ’maintenance’ Password9) Change Manager Access code10) Start/Stop Multi-System Manager Service11) Replace Multi-System Manager Certificate12) Change XIV GUI Communication Ports13) Upgrade XIV Multi-System Manager14) Reboot15) Shutdown16) Exit

Your Selection>4

Upgrade log files:------------------upgrade_2013-01-15_12-00-00_23352.logupgrade_2013-01-16_14-00-00_30813.log

Please select the log flie you wish to see >

2. Once a log is selected, the upgrade starts

Created at: 15-01-2013 12/00/00This utility will run the upgrade procedure of theIBM XIV Multi-System Manager.Backup database will run prior to the upgrade.Backing up...Backup completed successfully.SFTP using ’maintenance’ user and get the file:backup/BACKUP_20130115_121000.tar.gz

File in the Upload folder-------------------------MultiSystemManagerUpgradeKit1.2.0-3.tar.gz

Extracting /files/upload/MultiSystemManagerUpgradeKit1.2.0-3.tar.gz

3. You may export the file via SFTP using the 'maintenance' user. See here:“Performing maintenance tasks” on page 57.

Managing inventory optionsThe inventory options allow for adding, modifying, and removing XIV systemsfrom being managed by the Multi-System Manager as well as managing theircertificates in the Multi-System Manager and the System Machine Account.

About this task

This menu lists all inventory management options.


Procedure

Click 5 on the root menu. The Manager Inventory Configuration menu is displayedon screen.

--------------- IBM XIV Multi-System Manager v1.2.0.x --------------------------------------------------------------------------------

Manager Inventory Configuration-------------------------------IBM XIV Multi-System Manager is running

1) System Inventory List2) Add System3) Modify System4) Remove System5) System Monitoring Suspend6) System Monitoring Resume7) Re-authenticate All Users8) Change System Machine Account9) Manage System Certificates10) ExitYour Selection>

What to do next

The following sections explain how to carry out root user operations.

System inventory listThe system inventory list displays the XIV Systems monitored by Multi-SystemManager and their status.

About this task

This task allows you to view the inventory list.

Procedure1. Click 1 on the Manager Inventory Configuration menu. The System Inventory

List opens on screen. For each system, the list displays its name, address,status and ID.

Your Selection>1---------------------------------------------------------------Name Addresses Status Id

---------------------------------------------------------------Gen3p1-04 Gen3p1-04 Authentication Failure Gen3p1-04::null:nullqa16 qa16 Authentication Failure qa16::nu

Copy of the systems list:logs/systems_list_201208161555.log by SFTP with ’maintenance’ account.Press any key to continue

The list also displays the file on which it is stored and a reminder that the filecan be pulled by the Maintenance user.

2. Press any key to return to the Manager Inventory Configuration menu.

Adding a system to the inventoryThis menu option adds an XIV System to the inventory.


Procedure1. Click 2 on the Manager Inventory Configuration menu. You are asked to enter

the new system.

Your Selection>2Enter new system addresses in the following format: address1 [address2] [address3]>

2. Enter the address of the new system.

Results

The system is added to the inventory and can be viewed from the systeminventory list.

Modifying a system in the inventoryThis menu option modifies an XIV System to the inventory.

Procedure1. Click 3 on the Server Administrator menu. The following message is displayed

on screen:

Your Selection>3Enter system address/ID to modify >

2. Enter the system's address or ID and then enter the new system addresses:

Your Selection>3Enter system address/ID to modify >qa16Enter new addresses in format: address1 [address2] [address3] >

The system is now modified.

Removing a system from the inventoryThis menu option removes an XIV System from the inventory.

Procedure1. Click 4 on the Server Administrator menu. A message is displayed on screen:

Your Selection>4Enter system address/ID to remove (--all for all systems) >

2. Enter an address or ID in order to remove a single system. Alternately, enter--all in order to remove all of the systems.

Suspending a system from monitoringThis menu option suspends an XIV System from being monitored by theMulti-System Manager.

Procedure1. Click 5 on the Manager Inventory Configuration menu. A message is displayed

on screen:

Your Selection>5Enter a system address/ID to suspend (--all for all systems) >

2. Enter an address or ID in order to suspend a single system. Alternately, enter--all in order to suspend all of the systems.


Resuming the monitoring of a suspended XIV SystemThis menu option resumes the monitoring of a suspended XIV System.


on screen:

Your Selection>6Enter a system address/ID to resume (--all for all systems) >

2. Enter an address or ID in order to resume a single suspended system.Alternately, enter --all in order to resume all of the suspended systems.

Re-authenticating usersThis menu option re-authenticates the users across all of the XIV systems that aremanaged by the Multi-System Manager.


on screen:

Your Selection>7This option will force re-authentication of all logged-in users. Are you sure? [Y/N] >

2. Press Y to continue. A message is displayed on screen:

Are you sure? [Y/N] >yInvalidating all authentication records.Logged in users will be re-authenticated automatically.Press any key to continue

3. Press any key to perform the user authentication.

Changing the System Machine Account passwordThis menu option changes the System Machine Account password.

About this task

See a definition of the System Machine Account here: “Definitions” on page 1.

The password can be changed either from the Manager Inventory Configurationmenu or via the GUI.

In addition, the password needs to be changed on all systems.

Procedure

Select whether to use the Manager Inventory Configuration menu or the GUI:

On the Manager Inventory Configuration menuSee here: “Managing inventory options” on page 43.

On the GUI

1. Login to the GUI using the manager access code (see here: “Initializingthe inventory” on page 17).

2. Go to menu: Systems > Manager Configuration > Credentials. Fill inthe System Machine Account (see a definition here: “Definitions” onpage 1) password and click Update.


3. Re-authenticate the systems according to the new password: openSystems > Manager Configuration> Inventory. Wait until the systemsarrive to the status of Authentication Error, select all those systems(using the CTRL or SHIFT keys), right-click and select Diagnose/FixAuthentication error from the context menu. Read more on thediagnose and fix process on the “Definitions” on page 1 topic.

Managing the certificatesStarting with this release, users can install their own certificates in addition to thebuilt-in certificate that comes with the XIV system.

About this task

Every Management Tool component, connected to an XIV directly or to aMulti-System Manager, can validate the certificate installed in theXIV/Multi-System Manager and if not valid, will be asked to trust it (once oralways).

Procedure

Click 9 on the Manager Inventory Configuration menu. The Manage SystemsCertificates menu is displayed on screen.

--------------- IBM XIV Multi-System Manager v1.2.0.x --------------------------------------------------------------------------------

Manage Systems Certificates---------------------------1) Show Trusted Certificates2) Import Certificate to Trust3) Remove Trusted Certificate4) Show All Systems With Certificate Problem5) Trust System Certificate with Certificate Problem6) ExitYour Selection>

What to do next

The following sections explain how to carry certificate management operations.

Displaying trusted certificatesThis menu option displays a list of certificates that are trusted by the Multi-SystemManager along with their expiration dates.

About this task

This menu option displays a list of trusted certificates, and let you select whetherto display global certificates as well.

Procedure1. Click 1 on the Manage Systems Certificates menu.2. Click Y in order to display also global certificates. The list of trusted certificates

are displayed on screen.


Your selection>1Do you want to display the global certificates as well? [Y/N]:True Sonera Class2 CA Sonera Class2 CA 06-04-2001 06-04-2021True Entrust Root Ce...on Auth Entrust Root Ce...on Auth 27-11-2006 27-11-2026True Sonera Class1 CA Sonera Class1 CA 06-04-2001 06-04-2021

Importing certificates to trustThis menu option imports certificate files in PEM format to the Multi-SystemManager.

About this task

In case the XIV system certificate was replaced, you can add the new certificate tothe Multi-System Manager so that the system will be trusted automatically uponconnecting to it.

Procedure1. Arrange for the new certificates:

v Make sure you have the certificate files.v Make sure all are in PEM format. If not, you can convert your format to PEM

using standard tools.v SFTP these files to the upload folder using maintenance credentials, see here

“Performing maintenance tasks” on page 572. Click 2 on the Manage Systems Certificates menu.

Your Selection> Upload the certificate files (*.pem) in PEM format using SFTPand user ’maintenance’ to the Upload folder and press any key...

3. The certificate files will be displayed.

Enter the certificate file to import

What to do next

You can verify that that certificate files are imported correctly by displaying the listof certificates on screen. See here “Displaying trusted certificates” on page 47.

Removing certificatesThis menu option removes certificate files from the Multi-System Manager.

About this task

This task displays the list of trusted certificates and asks you to select which ofthem to remove.

Procedure

Click 3 on the Manage Systems Certificates menu. A list of all certificates isdisplayed on screen, and each certificate has an index number.


Your Selection> 3

Index Is Global Issue To Issue By----------------------------------------------------------------------------------1 True Security Communications RootCA2 Security Communications RootCA22 True UTN - DATACorp SGC UTN - DATACorp SGC

Select the index of the certificate you want to remove.

Displaying XIV systems with certificate problemsThis menu option displays XIV systems that have certificate problems.

About this task

The certificates with problems are displayed with an indication of their problems.

Procedure

Click 4 on the Manage Systems Certificates menu.

Your Selection> 4Addresses Problem Issued To Issued By Valid From Valid To-------------------------------------------------------------------------------GEN3P1-01C Not Trusted Admin01 Admin 16-01-2013 16-01-2014

Press any key to continue

Handling XIV systems with certificate problemsThis menu option allows you to query for systems with certificate problems andtrust their certificates.

About this task

This menu option allows you to query for systems with certificate problems andhave them trust these certificates.

Procedure1. Click 5 on the Manage Systems Certificates menu.

Do you want to see the systems with certificate problem? [Y/N] >yPlease wait...

Addresses Problem Issued To Issued By Valid From Valid To------------------------------------------------------------------------------------mn52 Not Trusted XIV XIV 01-05-2011 30-04-2014

Enter the system DNS address >

2. Enter an XIV system that is on the list.


Enter the system DNS address >mn52Please wait...[[Version: V1Subject: EMAILADDRESS=storage at ibm dot com, CN=XIV, OU=XIV, O=IBM, L=Tel Aviv,ST=some-state, C=ILSignature Algorithm: SHA1withRSA, OID = 1.2.840.113549.1.1.5

Key: IBMJCA RSA Public Key:modulus:10305904552676934126298894635935691207610305904552676934126298894635935691200010305904552676934126298894635935691207310305904552676934126298894635935691207810305904552676934126298894635935691207public component:65537

Validity: [From: Thu May 19 08:35:42 UTC 2011,To: Sun May 18 08:35:42 UTC 2014]

Issuer: EMAILADDRESS=storage at ibm dot com, CN=XIV, OU=XIV, O=IBM, L=Tel Aviv,ST=some-state, C=ILSerialNumber: [12091787267339116468]]Algorithm: [SHA1withRSA]Signature:0000: 88 d7 6c 82 5c ac 4e 19 75 e2 06 fa a5 47 07 e3 ..1..N.u...G..

]Are you sure you want to import this certificate? [Y/N] >

3. Click Y to import the certificate.

Are you sure you want to import this certificate? [Y/N]yCertificate was imported successfullyCertificate was imported successfully - do you want to reload it? [Y/N]

4. Click Y again.

Certificate was imported successfully - do you want to reload it? [Y/N]yPress any key to continue

What to do next

You can run Trust System Certificate with Certificate Problem (step 1 above)again, and verify that the XIV system no longer appears on the list.

Backing up the server databaseThe Backup/Restore menu options allow you to backup the server database and torestore this database from a backup.

About this task

The information stored on the Multi-System Manager database can be backed upand restored from this menu. This database contains the inventory configuration.Backing it up helps you to recover from a disaster in order to maintain servicecontinuity by restoring the inventory. It can also be used for copying the inventoryconfiguration from one Multi-System Manager to another.


Procedure

Click 5 on the root menu. The Backup and Restore Menu is displayed on screen.



What to do next

See the next sections for detailed instructions about each menu option.

BackupThe Backup menu item allows you to backup the database.

About this task

A default scheduled backup is already configured at 23:30 daily. In addition tothat, you can back up the database using this task.

Procedure1. Click 1 to back up the database. The backup process takes place:

Your Selection>1Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file: backup/BACKUP_20120815_082926.tar.gzPress any key to continue

The backup file name is displayed on screen.2. Press any key to return to the Backup and Restore Menu.

What to do next

You can SFTP using 'maintenance' account and get the file from 'backup' folder.

RestoreThe Restore menu item allows you to restore the database from a backup.

Procedure1. Click 2 to restore the database. The available backup files, that are stored on the

backup folder that is accessible by the maintenance user, are displayed onscreen:

Your Selection>2Backup files to restore:------------------------BACKUP_20120815_085300.tar.gzBACKUP_20120814_085000.tar.gz

Please select a backup file to restore >

2. Select a file to restore from:



3. Click Y to confirm.4. Confirm again:


Restore DB is going to override your current configuration.It is recommended to run a backup prior restoring.Do you want to run backup of the current configuration before restoring? [Y/N] :

5. The restore takes place:

Backup files to restore:------------------------BACKUP_20120827_112834.tar.gzBACKUP_20120827_112511.tar.gzBACKUP_20120814_122049.tar.gz



Restore DB is going to override your current configuration.It is recommended to run a backup prior to restoring.Do you want to run backup of the current configuration before restoring? [Y/N] : y

Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file: backup/BACKUP_20120827_112904.tar.gzxivms v1.2.0.x is stopped

Restoring BACKUP_20120814_122049.tar.gz...Restore completed successfully

Note: Systems Machine Account Password was not restored.

xivms v1.2.0.x is starting...

6. Press any key to return to the Backup and Restore menu.

What to do next

Once the restore is complete, you need to redefine:v The System Machine Accountv The Manager Access Code

See a definitions to both here: “Definitions” on page 1. You can do it either fromthe GUI or on the CLI.

On the GUIFollow the instructions on step 4“Initializing the inventory” on page 17 ofthe Initializing the inventory section.

From the CLIGo to “Changing the System Machine Account password” on page 46. See“Changing the manager access code” on page 53

Scheduling a daily backupThe Schedule Daily Backup menu item allows you to schedule a daily backup job.The default daily backup runs at 23:30.


Procedure1. Click 3 to schedule a back up. The current daily backup schedule is also

displayed on screen:

Your Selection>3Select time (HH:MM) to run backup every day [23:30]? >

2. Select a new backup time in an HH:MM format.

Your Selection>3Select time (HH:MM) to run backup every day [23:30]? >14:00Scheduled daily backup at 14:00Scheduled daily backup folder cleaner at 14:50Press any key to continue

Note: A backup folder cleaner job runs daily and cleans all of the files but the30 newest.

3. Press any key to return to the Backup and Restore menu.

Removing a scheduled backupThe Remove Scheduled Backup menu item allows you to clear the daily backup job.

Procedure1. Click 4 to remove a schedule.

Your Selection>4Removed scheduled backupPress any key to continue

The schedule is cleared.2. Press any key to return to the Backup and Restore menu.

Changing the root passwordThis menu option allows you to change the password of the root user.

Procedure1. Click 7 on the root menu.2. Enter a new password.

Changing the maintenance passwordThis menu option allows you to change the password of the maintenance user.

Procedure1. Click 8 on the root menu.2. Enter a new password.

Changing the manager access codeThis section describes how to change the manager access code.

Procedure1. Click 9 on the root menu.2. Enter a new access code.


Replacing the Multi-System Manager certificateThis task guides you through replacing the default Multi-System Managercertificate with your organization’s certificate.

Before you beginv Prepare a certificate file in PKCS12 format.v SFTP the file using 'maintenance' account to 'upload' folder.

About this task

The Multi-System Manager is shipped with a default certificate. This task guidesyou through replacing the default certificate with your organization’s certificate.

Procedure1. Click 11 on the root menu.

Your Selection>11

This script installs a new certificate.You need to prepare a certificate file in PKCS#12 format.You need to SFTP the files using ’maintenance’ account to ’upload’ folder.

2. The available certificates that are on the upload folder will be displayed onscreen. Enter a certificate file name and the key password.

Awaiting screen capture

Results

The server certificate is now replaced.

What to do next

The next time the GUI connects to the server, it will have to approve (trust) thenew certificate.

Replacing the Multi-System Manager certificateThis task guides you through replacing the default Multi-System Managercertificate with your organization’s certificate.

Before you beginv Prepare a certificate file in PKCS12 format.v SFTP the file using 'maintenance' account to 'upload' folder.

About this task

The Multi-System Manager is shipped with a default certificate. This task guidesyou through replacing the default certificate with your organization’s certificate.


Procedure1. Click 11 on the root menu.

Your Selection>11

This script installs a new certificate.You need to prepare a certificate file in PKCS#12 format.You need to SFTP the files using ’maintenance’ account to ’upload’ folder.

2. The available certificates that are on the upload folder will be displayed onscreen. Enter a certificate file name and the key password.

Certificate files found under the ’upload’ folder:------------------------------------------------------replace_manager_certificate.sh.p12RichardTestCertMSMS.p12

Please enter a certificate file name [RichardTestCertMSMS.p12]Enter the certificate key password>The new certificate is successfully installed.The Multi-System Manager service needs to be restarted so the changes will take effect.Restart now? [Y/N] >

In order for the certificate replacement to take effect, the Multi-System Managerservice needs to be restarted.

Results

The server certificate is now replaced.

What to do next

The next time the GUI connects to the server, it will have to approve (trust) thenew certificate.

Changing the communication portsThis task allows you to change the ports through which the Multi-System Managerconnects with the IBM XIV Storage Management GUI.

About this task

The Multi-System Manager connects to the XIV GUI via 6 reserved, consecutiveports, starting with port 1199.

Procedure1. Click 12 on the root menu. The number of the first port among the consecutive

six is displayed on screen. In the following screenshot, this number is 1199.

Your Selection>12

The communication between XIV GUI and the Multi-System Manageris done via 6 consecutive, reserved ports.

Please enter a new starting port number higher than 1024 [1199] >

2. Enter a new port number that is higher than 1024. In this example, the enteredport number is 1340.

Please enter a new starting port number [1199] >1340


The new sequence of six port numbers, 1340 to 1345, is also displayed onscreen.

You are going to change the reserved ports from 1199-1205to 1340-1346. Are you sure? [Y/N] >y

3. Click Y to approve the replacement. You are asked to restart the service.

You need to restart Multi-System Manager service in order for the changesto take effect.Do you want to restart service now? [Y/N] >

4. Click Y to restart the Multi-System Manager service. Upon success, thefollowing message is displayed on screen:

Change was completed successfully.Point XIV GUI to connect to the new starting communication port.

If you select not to restart the service right now, the following notification willbe displayed on screen:

Change was not completed yet. Remember to restart the Multi-System Manager service.

Results

As the service is up again, the ports have changed.

What to do next

Change the communication ports that connect the GUI to the Multi-SystemManager through the System > Preferences menu.

Upgrading the Multi-System ManagerThis menu option allows you to upgrade the Multi-System Manager.

Procedure1. Upload the upgrade file to the upload folder using SFTP and maintenance user

credentials.2. Click 13 on the root menu.

Your Selection>13This utility will run the upgrade procedure of IBM XIV Multi-System ManagerThe backup database will run prior the upgrade.Press any key to continue

3. Next, provided that an upgrade file was uploaded as stated above, select a filefrom the list:

xiv

10

41

0


Backing up...Backup completed successfullySFTP using ’maintenance’ account and get the file: backup/BACKUP_20120815_105757.tar.gz

Please upload the upgrade file (*.tar.gz) using SFTP and user ’maintenance’to upload folder.Press any key to continue

Files in upload folder----------------------XIV_Multi_System_Manager_Upgrade.tar.gzXIV_Multi_System_Manager_Upgrade_1.2.tar.gzdd.tar.gz

Please enter the name of the upgrade file >

4. Enter the file name. You will be asked to confirm the upgrade.

IBM XIV Multi-System Manager will be upgraded to version 1.2.0.x.Please confirm stopping the Multi-System Manager serviceand upgrading now [Y/N] >

5. During the upgrade, you will be prompted to accept the new license. Enter 1 toconfirm. Upon confirmation, the upgrade takes place, resulting in the followingmessage:

The upgrade to IBM XIV Multi-System Manager version 1.2.0.x completed successfully.Your session is going to end in order for the changes to take effect.Following the upgrade, users that are logged into the Multi-System Manager root menuwill have to re-login.Press any key to continue.

Results

The Multi-System Manager version is upgraded.

Rebooting the Multi-System Manager VMThis menu option allows you to reboot the Multi-System Manager VM.

Procedure

Click 14 on the root menu. Confirm the reboot.

Shutting down the VMThis menu option shuts down the VM.

Maintenance user operations

Performing maintenance tasks

Before you beginv You need maintenance credentials in order to perform the following tasks.v The initial password of the maintenance user is xivmsMaintenance.v SFTP is the only protocol available for this user in order to interact with the

Multi-System Manager.


v Make sure the root user changes the password of the maintenance user as soonas possible. See here: “Changing the maintenance password” on page 53.

About this task

The Multi-System Manager allows for inbound and outbound file delivery viaSFTP. Such files delivery is required for the following tasks:

Gathering server logsThe logs are available for collection from the logs folder.

Viewing the log of system listThe log of the system list operation can be collected from the logs folder.

Backing up the databaseThe backup file can be collected and stored anywhere outside theMulti-System Manager.

Restoring the databaseThis operation looks for a backup file. In some cases, the backup file has tobe sent to the Multi-System Manager.

Replacing the security certificateThe security certificate has to be sent to the Multi-System Manger.

Upgrading the Multi-System ManagerThe upgrade file has to be sent to the Multi-System Manager.

Procedure

For each of the above operations, make sure that the relevant file is sent to - orcollected from the following directories:

logs The Multi-System Manager stores the logs in this directory.

backupsBackup files are written into here, and the restore operation looks for a filein here as well.

uploadsCertificates and upgrade files need to be stored here.


Chapter 7. Multi system configuration

Multi system configuration allows to change the configuration on multiple XIVsystems with a single click.

Before you begin

Multi system configuration is available for:v LDAP configurationv Support parametersv Pool alert thresholdsv Adding and editing a userv Changing the password for a user

About this taskv Multi system configuration can be run on GUI in Server mode as well as in

Direct mode.v Multi system configuration requires access rights to the involved GUI systems.

Procedure

Launch multi system configuration in either of the following ways:v Change the user configuration on selected systems. This applies for all users

operations (add, edit, change password).v Copy LDAP / support / pool alert thresholds configuration and paste the

configuration from one system to specifically selected systems.

What to do next

Proceed with either of the following tasks:v “Multi system configuration of user-related information”

– “Adding a user on multiple systems”– “Editing, deleting or changing the password of a user” on page 60

v “Mass copy-paste configuration” on page 61

Multi system configuration of user-related informationYou may configure user-related information on multiple XIV systems at once.

About this task

This task describes how to configure user-related information on multiple XIVsystems at once.

Adding a user on multiple systemsYou may add a user on multiple XIV systems at once.


Procedure1. Select the systems you would like to configure and click Add User. The Add

User screen opens.2. Enter the user's name, password and other details as displayed on the screen.

Click Add.The new user is added to the selected systems.

3. A progress bar is displayed on screen. Clicking Cancel at this stage will cancelthe mass configuration. When the Add operation is complete, a summary of theresults is displayed on screen. Clicking the Show Results button opens adetailed report on screen.

Results

Following this task, the user was added to the selected systems.

Note: Mass Configuration does not stop on error, means it tries to configure allsystems although some may fail.

Note: Closing the GUI amidst the paste operation terminates the massconfiguration in an unknown state. In such a case, it is advised to go over thesystems and see what has already been properly configured and what still needs tobe configured.

Editing, deleting or changing the password of a userYou may edit or delete a user, as well as change the password on multiple XIVsystems at once.

Procedure1. On the GUI, mouse-over the Access icon and click on Users. The Users view

opens on screen.2. Select the systems that will be displayed on this view.3. Use the CTRL key to multiple select the users to be edited.

Note: Mass editing of users can be applied only to users with the same username.

xiv

10

40

3


4. Right-click the users selection and select Edit, Delete or Change password.

v Delete – will display a progress of the deletion.v Edit or Change Password – will display a dialog. Edit the details or

password and click Update.– A progress bar is displayed on screen. Clicking Cancel at this stage will

cancel the mass configuration. When the operation is done, a summary ofthe results is displayed on screen. Clicking the Show Results button opensa detailed report on screen.

Note: The availability of the edit, delete and change password configurationoptions is subject to your access rights.

Results

Following this task, the user was edited to the selected systems.



Mass copy-paste configurationYou may copy system configuration from one system and paste it onto multipleXIV systems.

Procedure1. On the XIV GUI, right-click a system and select Copy System Configuration

from the pop-up menu.

xiv

10

40

4

Chapter 7. Multi system configuration 61

This system configuration is now copied to the memory and the pop-up menucloses.

2. Select systems to copy the configuration to. Right-click a system, or severalsystems, and select Paste ... Configuration from the pop-up menu. In thisexample, Paste Support Configuration is selected.

The Mass Support Configuration screen opens.

xiv

10405

xiv

10

40

6


Note: Whenever a paste option is grayed-out, meaning that it is not available,mouse-over the option to display a tooltip that explains the reason. In thisexample, the Paste LDAP Configuration is grayed-out and the tooltip says thatthe target system's version is not compatible with the source system.

3. Click Start.

A progress bar is displayed on screen. Clicking Cancel at this stage will cancelthe mass configuration. When the copy operation is done, a summary of theresults is displayed on screen. Clicking the Show Results button opens adetailed report on screen.

xiv

10

40

7

xiv

10

40

8xiv

10

40

9

Chapter 7. Multi system configuration 63

Results

Following this task, the configuration of one system was deployed on othersystems.




Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte character set (DBCS) information,contact the IBM Intellectual Property Department in your country or sendinquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan, Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore, this statement may not applyto you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.


IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM CorporationAlmaden Research650 Harry RoadBldg 80, D3-304, Department 277San Jose, CA 95120-6099U.S.A.

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subjectto change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:


This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. The sampleprograms are provided "AS IS", without warranty of any kind. IBM shall not beliable for any damages arising out of your use of the sample programs.

If you are viewing this information softcopy, the photographs and colorillustrations may not appear.

TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the web at Copyright andtrademark information at www.ibm.com/legal/copytrade.shtml.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registeredtrademarks or trademarks of Adobe Systems Incorporated in the United States,and/or other countries.

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the UnitedStates, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registeredtrademarks of Oracle and/or its affiliates.

Notices 67

http://www.ibm.com/legal/copytrade.shtml

Index

Aabout this document

sending comments xaccess code 53access control 39Active Network configuration 8adding a system to the inventory 45adding a user 60audit logs 42authentication 8

BBacking up the Multi-System

Manager 27backup 27, 50, 51, 53Backup and Restore Menu 50, 53Backup/Restore Options 39backups directory 57, 59

Ccertificate

of the Multi-System Manager 54certificates 31

displaying 47import 48

changingthe access code 53

changing the System Machine Accountpassword 46

changing the user's password 60comments, sending xcommunication ports 55configuration

of multiple xiv systems 59, 60, 61configuration options 40configuration tasks 39copy and paste configuration 61credentials 39cron job 50, 53

Ddatabase 50, 51, 53definitions 1deleting a user 60DHCP 9Diagnose/Fix authentication problem 1Disable LDAP Authentication 8Displaying the audit log 42Displaying the upgrade logs 42, 43DNS parameters 9documentation

improvement xDomain name servers 8Domain search list 8dual core 3

Eediting a user 60Enable LDAP Authentication 8ESX 7ESX Server 3expiration dates of certificates 47

Fforums vii

Ggateway 9Gateway 8Gather Server Logs 39Gather Server Logs menu option 41GUI 3, 7, 17GUI 4.0 56

HHandling the Multi-System Manager

certificate 36Hostname 8

IIBM

internal user 39personnel 39

IBM XIV Management Tools version4.0 1

IBM XIV Multi System Manager vii, 7IBM XIV Multi-System Manager 1IBM XIV support 7IBM XIV Support 7Importing a new certificate 31, 33incoming files 57, 59installation 7, 16installation procedure 8, 9installation required steps 8installation wizard 8, 9, 13, 14inventory 1

adding a system to 45modifying a system 45of XIV Systems 44re-authenticating all of the users 47,

48, 49re-authenticating users 46removing a system 45resuming the monitoring of a

suspended system 46suspending a system from

monitoring 45inventory configuration tasks 39IP address 8IP mode 8

Llatency

allowed (as a prerequisite) 3prerequisites 3

LDAP 17, 39, 56LDAP Authentication 8LDAP directory 1LDAP server type 8LDAP user 17, 21, 56Linux super user 39log

of Server Admin activities 42logs

audit 42gathering 41upgrade 42, 43

logs directory 57, 59

Mmaintenance user 57Maintenance user 39Management Tools 1, 7managing

certificates 31mandatory parameter

for restoring the database 50, 53mass configuration 59, 61Microsoft Active Directory 8mode

server 21modifying a system to the inventory 45multi-site XIV deployments 1Multi-System Manager certificate 54Multi-System Manager database 50, 53Multi-System Manager installation

individual steps 40Multi-System Manager VM 57

Nnetmask 9Netmask 8network

configuration option 40non-LDAP user 17, 21, 56notices

legal 65NTP 8, 13NTP & regional settings

configuration option 40

OOpen-LDAP Server 8OS 39outgoing files 57, 59ovf file 3, 7


Ppassword

changing the user's password 60of the System Machine Account 46

PDFs viiPEM format

maintenance user 48SFTP 48

ports 55prerequisites 3publications vii

Qquad core 3

Rre-authenticating all of the users 47, 48,

49re-authenticating users 46reader feedback, sending xreboot 57regional settings

configuration option 40related information viiRemoving a certificate 31, 34removing a system from the

inventory 45required steps

installation 8restore 27, 50, 51, 53restoring the database 51, 53Restoring the Multi-System Manager 28Resuming the monitoring of a suspended

XIV System 46Root 39root credentials 7, 39root user 7, 8, 9

SSCP port 3sending

comments xServer 7Server Admin 39server admin account

configuration option 40server configuration options 40Server Configuration Options 39server configuration tasks 39Server has low disk space 14Server is down 14Server is up 14server logs 41server mode 21service xivms start 50, 53service xivms stop 50, 53SFTP 57SFTP protocol 39shell access

none whatsoever 39shutdown 57six core 3

SMTP 8configuration option 40

SMTP configuration 14specifications 3

Management Tools 3SSH port 3Static IP 9Step 1: License Agreement 9Step 2: Password Change 9Step 3: Networking 9Step 4: NTP & Regional Settings 13Step 5: SMTP 14Storage admin 46storage administrator 1Sun Directory 8suspending a system from

monitoring 45system certificate 36system certificate errors 32, 34system inventory list 44System machine account 1System Machine Account 39System Machine Account password 46system.xml 17, 56systems management tasks 39

Ttasks 39

maintenance usewr 57time zone 8, 13trademarks 67trusted certificates 47

Uupgrade logs 42, 43Upgrading the Multi-System

Manager 23uploads directory 57, 59user-related information

configuration of 60user's tasks 39users

re-authentication 46users types 39

Vvirtual appliance 7VM 3, 7, 57

Wwizard 8, 9

XXIV support 7xiv systems

configuration 59, 61XIV Systems 44, 45, 46, 47, 48, 49

re-authenticating users 46xiv_msms 1xivms service 14


��

Printed in USA

SC27-4230-01

managementtools user guide - ibm.com user guide ... to submit any comments about this book or any...

Documents