38
IBM Storage Provider for VMware VASA Version 1.1.5 User Guide GC14-7500-04

IBM Storage Provider for VMware VASA · – Publication form number (for example: GA00-1111-22) – Page, table, or illustration numbers that you are commenting on – A detailed

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

  • IBM Storage Provider for VMware VASAVersion 1.1.5

    User Guide

    GC14-7500-04

    ���

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

    Edition notice

    Publication number: GC14-7500-04. This publication applies to version 1.1.5 of the IBM Storage Provider forVMware VASA and to all subsequent releases and modifications until otherwise indicated in a newer publication.

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

  • Contents

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

    Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

    About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixWho should use this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixConventions used in this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixRelated information and publications . . . . . . . . . . . . . . . . . . . . . . . . . . . ixGetting information, help, and service . . . . . . . . . . . . . . . . . . . . . . . . . . ixOrdering publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixSending your comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

    Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Concept diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Compatibility and requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Download site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Before you proceed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

    Chapter 2. Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Extracting and installing the software package . . . . . . . . . . . . . . . . . . . . . . . . 5Checking and controlling the IBM Storage Provider service . . . . . . . . . . . . . . . . . . . . 5

    Chapter 3. Configuration and management. . . . . . . . . . . . . . . . . . . . . 7Switching to IBM Storage Provider user mode . . . . . . . . . . . . . . . . . . . . . . . . 7Setting, removing, and listing XIV access credentials . . . . . . . . . . . . . . . . . . . . . . 8Adding, removing, and listing IBM Storage Integration Server users . . . . . . . . . . . . . . . . . 9Adding, removing, and listing connected XIV storage systems . . . . . . . . . . . . . . . . . . 10Defining storage capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Listing the available storage volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Assigning storage capabilities to volumes . . . . . . . . . . . . . . . . . . . . . . . . . 13Backing up and restoring IBM Storage Provider configurations . . . . . . . . . . . . . . . . . . 14Registering the IBM VASA Provider in VMware vCenter Server . . . . . . . . . . . . . . . . . . 15

    Chapter 4. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Checking the log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Checking and modifying the main configuration file. . . . . . . . . . . . . . . . . . . . . . 19

    Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

    Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

    © Copyright IBM Corp. 2011, 2013 iii

  • iv IBM Storage Provider for VMware VASA

  • Figures

    1. Concept diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22. vSphere Client – Storage Providers list . . . . . . . . . . . . . . . . . . . . . . . . 163. Add Vendor Provider dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . 174. vCenter certificate thumbprint dialog box . . . . . . . . . . . . . . . . . . . . . . . 175. Supported Vendor list displaying the IBM VASA Provider . . . . . . . . . . . . . . . . . . 18

    © Copyright IBM Corp. 2011, 2013 v

  • vi IBM Storage Provider for VMware VASA

  • Tables

    1. Required configuration tasks in sequential order . . . . . . . . . . . . . . . . . . . . . 72. Optional configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73. Arguments for ibmvp_storage_credentials . . . . . . . . . . . . . . . . . . . . . . . 84. Arguments for ibmvp_admin_commands . . . . . . . . . . . . . . . . . . . . . . . . . 95. Arguments for ibmvp_storage_array . . . . . . . . . . . . . . . . . . . . . . . . . 116. Arguments for ibmvp_capabilities . . . . . . . . . . . . . . . . . . . . . . . . . 127. Arguments for ibmvp_volume capability. . . . . . . . . . . . . . . . . . . . . . . . 148. Arguments for ibmvp_configuration . . . . . . . . . . . . . . . . . . . . . . . . . 14

    © Copyright IBM Corp. 2011, 2013 vii

  • viii IBM Storage Provider for VMware VASA

  • About this guide

    This guide describes how to install, configure, and use the IBM® Storage Providerfor VMware VASA.

    Who should use this guideThis guide is intended for system administrators who are familiar with theVMware vCenter and vSphere environments, as well as with the IBM XIV® StorageSystem.

    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.

    Related information and publicationsYou can find additional information and publications related to the IBM StorageProvider for VMware VASA on the following websites.v IBM Storage Host Software Solutions Information Center

    (publib.boulder.ibm.com/infocenter/strhosts/ic)v IBM XIV Storage System Information Center (publib.boulder.ibm.com/

    infocenter/ibmxiv/r2)v VMware Technical Documentation website (www.vmware.com/support/pubs )

    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.

    © Copyright IBM Corp. 2011, 2013 ix

    http://publib.boulder.ibm.com/infocenter/strhosts/ichttp://publib.boulder.ibm.com/infocenter/ibmxiv/r2http://www.vmware.com/support/pubshttp://www.ibm.comhttp://www.ibm.com/storage/supporthttp://www.ibm.com/planetwide

  • 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 guide or any other IBM Storage Host Softwaredocumentation:v Go to the online feedback form (http://pic.dhe.ibm.com/infocenter/strhosts/ic/

    topic/com.ibm.help.strghosts.doc/icfeedback.htm). You can use this form toenter and submit comments.

    v You can send your comments by email to [email protected]. Be sure toinclude the following information:– Exact publication title and version– Publication form number (for example: GA00-1111-22)– Page, table, or illustration numbers that you are commenting on– A detailed description of any information that should be changed

    Note: When you send information to IBM, you grant IBM a nonexclusive rightto use or distribute the information in any way it believes appropriate withoutincurring any obligation to you.

    x IBM Storage Provider for VMware VASA

    http://www.ibm.com/shop/publications/order/http://pic.dhe.ibm.com/infocenter/strhosts/ic/topic/com.ibm.help.strghosts.doc/icfeedback.htmmailto:[email protected]?subject=IBM Storage Host Software Solutions publications

  • Chapter 1. Introduction

    For IBM XIV and VMware vSphere users, the IBM Storage Provider for VMwareVASA improves the ability to monitor and automate storage-related operations onVMware platforms.

    The IBM Storage Provider is installed on an IBM Storage Integration Server (aLinux server) that monitors one or more IBM XIV storage systems. From thatserver, the IBM Storage Provider provides a standard interface for any connectedVMware vCenter Server using VMware APIs for Storage Awareness (VASA),delivering information about storage topology, capabilities and state, as well asstorage events and alerts to vCenter Server in real time.

    VMware administrators can view this information on the vSphere Clientmanagement station, and can configure storage-related operations accordingly.

    In addition, a range of CLI management utilities for server configuration isincluded in the software package.

    © Copyright IBM Corp. 2011, 2013 1

  • Concept diagramThe following figure shows the IBM Storage Provider for VMware VASA installedon an IBM Storage Integration Server (a Linux server) that is connected to both theVMware vCenter server and the IBM XIV Storage System.

    Compatibility and requirementsFor the complete and up-to-date information about the compatibility andrequirements of the IBM Storage Provider for VMware VASA, refer to the latestrelease notes.

    You can find the latest release notes on the IBM Storage Host Software SolutionsInformation Center (publib.boulder.ibm.com/infocenter/strhosts/ic) or on the IBMFix Central (www.ibm.com/support/fixcentral).

    Note: Refer to the relevant VMware documentation for information about how toinstall the compatible versions of vCenter Server and vSphere Client. You shouldalso refer to the latest installation and configuration instructions for ESXi servers.

    Download siteThe IBM Storage Provider for VMware VASA is available as a free softwaresolution.

    Figure 1. Concept diagram

    2 IBM Storage Provider for VMware VASA

    http://publib.boulder.ibm.com/infocenter/strhosts/ichttp://publib.boulder.ibm.com/infocenter/strhosts/ichttp://www.ibm.com/support/fixcentralhttp://www.ibm.com/support/fixcentral

  • You can download the latest version at any time from the IBM Fix Central(www.ibm.com/support/fixcentral).

    Before you proceedBefore you proceed to the installation and configuration, make sure that you haveaccess to a workstation on which your preferred IBM XIV Storage Systemmanagement software is locally installed or accessible via a remote connection.

    You can manage the IBM XIV Storage System using the XIV GUI (graphical userinterface) or XIV CLI (command-line interface; also referred to as XCLI).

    For additional assistance and more information on how to obtain, install, and usethe IBM XIV Storage System management software, refer to the IBM XIV StorageSystem Information Center (publib.boulder.ibm.com/infocenter/ibmxiv/r2).

    Chapter 1. Introduction 3

    http://www.ibm.com/support/fixcentralhttp://publib.boulder.ibm.com/infocenter/ibmxiv/r2http://publib.boulder.ibm.com/infocenter/ibmxiv/r2

  • 4 IBM Storage Provider for VMware VASA

  • Chapter 2. Installation

    This chapter describes how to install and verify the functionality of the IBMStorage Provider for VMware VASA on an IBM Storage Integration Server.

    Extracting and installing the software packageYou can install the IBM Storage Provider for VMware VASA on a compatibleversion of Red Hat Enterprise Linux (for more information, refer to the releasenotes).

    Procedure

    Perform the following procedure to install the IBM Storage Provider for VMwareVASA.1. Copy the installation package file to a local folder on the Linux server that will

    be used as the IBM Storage Integration Server.2. Extract the installation package file ('* ' represents for the build number) :

    # tar xvf ibm_vasa_provider-1.1.5-*.tar.gz

    The following RPM files are extracted:v nginx-1.2.6-1.el6.ngx.x86_64.rpmv postgresql92-9.2.2-1PGDG.rhel6.x86_64.rpmv postgresql92-contrib-9.2.2-1PGDG.rhel6.x86_64.rpmv postgresql92-libs-9.2.2-1PGDG.rhel6.x86_64.rpmv postgresql92-server-9.2.2-1PGDG.rhel6.x86_64.rpmv uuid-1.6.1-10.el6.x86_64.rpmv ibm_vasa_provider-1.1.5*-x86_64.rpm (product RPM)

    3. Go to the extracted directory and then use the rpm -vi *.* command to runand install all the complementary RPM files and product RPM file.

    Important: If you choose to install each package separately without using the *.*option, do not install the ibm_vasa_provider-1.1.5*-x86_64.rpm file before all thecomplementary RPM files have been installed.

    The IBM Storage Provider service starts automatically after the installation, anda new Linux user named ibmvp is created so that you can use it formanagement operations.

    Checking and controlling the IBM Storage Provider serviceAfter the IBM Storage Provider for VMware VASA is installed, you can checkwhether its service runs properly in the background. You can also stop and thenstart the service if needed.

    © Copyright IBM Corp. 2011, 2013 5

  • Procedure1. Log in to the Linux command prompt environment as a root user.

    Important: Only root users can perform service operations.

    2. Enter the following command: service ibm_vasa_provider status. The statusof the Celery and Django services is displayed.

    [root@ibm-vasa-provider]# service ibm_vasa_provider statusCelery services are running...Django service is running...

    What to do next

    If you want to stop the IBM Storage Provider service, use the stop command:

    [root@ibm-vasa-provider]# service ibm_vasa_provider stopStopping Django service: [ OK ]Stopping celery services: [ OK ]

    To start the service again, use the start command:

    [root@ibm-vasa-provider]# service ibm_vasa_provider startStarting celery services: [ OK ]Starting Django service: [ OK ]

    6 IBM Storage Provider for VMware VASA

  • Chapter 3. Configuration and management

    After the IBM Storage Provider for VMware VASA is installed on the IBM StorageIntegration Server, you can start configuring and managing the server with the CLIutilities that are included in the IBM Storage Provider software package.

    Refer to the following tables for information about the required and optionalconfiguration and management tasks.

    Table 1. Required configuration tasks in sequential order

    Step Required task Refer to

    1. Set a password for 'ibmvp' ifnecessary (a root user action; seecross-reference for details), and thenswitch to the 'ibmvp' user.

    “Switching to IBM Storage Provider usermode”

    2. Add XIV access credentials. “Setting, removing, and listing XIV accesscredentials” on page 8

    3. Add at least one server user toallow access by vCenter Server.

    “Adding, removing, and listing IBM StorageIntegration Server users” on page 9

    4. Add XIV storage systems to bemonitored.

    “Adding, removing, and listing connected XIVstorage systems” on page 10

    5. Register the server in vCenterServer.

    “Registering the IBM VASA Provider inVMware vCenter Server” on page 15

    Table 2. Optional configuration tasks

    Optional task Refer to

    Define storage capabilities (storagepurpose definitions)

    “Defining storage capabilities” on page 11

    List all detected XIV storage volumes “Listing the available storage volumes” onpage 12

    Assign storage capabilities to volumes “Assigning storage capabilities to volumes” onpage 13

    Back up or restore a configuration “Backing up and restoring IBM StorageProvider configurations” on page 14

    Switching to IBM Storage Provider user modeTo start configuring the IBM Storage Provider for VMware VASA, you must belogged in as the ibmvp user in the Linux command prompt environment.

    About this task

    ibmvp is a user account that is automatically created after the installation, allowingyou to carry out the IBM Storage Provider CLI-based configuration andmanagement operations.

    If needed, you can set the password for accessing the ibmvp user account externally(for example, from a remote computer over SSH), as described in the followingprocedure.

    © Copyright IBM Corp. 2011, 2013 7

  • Procedure

    To set a password for the ibmvp user:1. Log in to the Linux command prompt environment as a root user.2. Enter passwd ibmvp and then enter the password for the user account:

    [root]# passwd ibmvpChanging password for user ibmvp.New password: **********Retype new password: **********passwd: all authentication tokens updated successfully.[root]#

    What to do next

    To switch to the IBM Storage Provider user, enter the su ibmvp command:

    [root]# su ibmvp

    Setting, removing, and listing XIV access credentialsThe first task after the installation is to set the user account that will be used toconnect to the IBM XIV storage system or systems, which your VMware platformsuse for storage provisioning.

    Important:

    v The same user account (with the same username and password) must already bepredefined on all the XIV systems that you intend to use. The IBM StorageProvider cannot use more than a single XIV management account. For moreinformation about how to define a user account on the XIV storage system, referto the XIV management tools documentation.

    v XIV storage systems can be added (see “Adding, removing, and listingconnected XIV storage systems” on page 10) only after the storage credentialsare set on the server upon which the IBM Storage Provider is installed.

    Use the ibmvp_storage_credentials CLI command to set, remove, or display theXIV access credentials for the server upon which the IBM Storage Provider isinstalled. Use the required argument after the command, as specified in thefollowing table.

    Note: All command arguments are case-sensitive.

    Table 3. Arguments for ibmvp_storage_credentials

    Argument Use after ibmvp_storage_credentials to:

    set -u -p

    or:

    set --user --password

    Set the username and password for accessing all the relevantXIV storage systems.

    For example:

    ibmvp_storage_credentials set -u johnxiv -p ***********

    8 IBM Storage Provider for VMware VASA

  • Table 3. Arguments for ibmvp_storage_credentials (continued)

    Argument Use after ibmvp_storage_credentials to:

    remove Delete the existing XIV user account definition from the server.

    For example:

    ibmvp_storage_credentials remove

    Attention: If you already added XIV systems to the server(see “Adding, removing, and listing connected XIV storagesystems” on page 10), deleting the XIV user accountdisconnects all these XIV storage systems.

    list Display the username of the existing XIV user accountdefinition.

    For example:

    ibmvp_storage_credentials listjohnxiv

    -h

    or --help

    Display help information that is relevant toibmvp_storage_credentials.

    You can also display help for the set argument if it is typed onthe command line as well.

    Adding, removing, and listing IBM Storage Integration Server usersAll user accounts that vCenter Server will use to access the IBM StorageIntegration Server must be individually defined.

    You can either define (add) a single user account to be used by all the VMwarevCenter servers that connect to and utilize the IBM Storage Integration Server (see“Registering the IBM VASA Provider in VMware vCenter Server” on page 15), ordefine multiple user accounts to be used separately.

    Use the ibmvp_admin_commands CLI command to add, remove, or display these useraccounts. Use the required argument after the command, as specified in thefollowing table.

    Note: All command arguments are case-sensitive.

    Table 4. Arguments for ibmvp_admin_commands

    Argument Use after ibmvp_admin_commands to:

    add_user -n -e -p

    or:

    add_user --user_name --user_email --user_password

    Add the username, email address, and password of a user thatmay access the IBM Storage Integration Server from thevCenter server. You can add more than one user.

    For example:

    ibmvp_admin_commands add_user -n johnvc -e [email protected] ********

    Chapter 3. Configuration and management 9

  • Table 4. Arguments for ibmvp_admin_commands (continued)

    Argument Use after ibmvp_admin_commands to:

    change_password -n -p

    or:

    change_password --user_name --user_password

    Change the password of a user account that was alreadyadded. The password that you type for the specified usernameis set as the new password.

    For example:

    ibmvp_admin_commands change_password -n johnvc -p **********

    delete_user -n

    or:

    delete_user --user_name

    Delete a user account from the server.

    For example:

    ibmvp_admin_commands delete_user -n johnvc

    list_users Display the names of currently defined user accounts.

    For example:

    ibmvp_admin_commands list_usersjohnvczivkalvcpolavc

    -h

    or --help

    Display help information that is relevant toibmvp_admin_commands.

    You can also display help for the add_user, change_password, ordelete_user argument if it is typed on the command line aswell.

    Adding, removing, and listing connected XIV storage systemsAll IBM XIV storage systems that provide storage resources to your VMwareplatforms must be defined on the IBM Storage Integration Server on which theIBM Storage Provider is installed.

    Use the ibmvp_storage_array CLI command to add, remove, or list these XIVstorage systems (referred to in the prompts as XIV arrays). Use the requiredargument after the command, as specified in the following table.

    Note: All command arguments are case-sensitive.

    10 IBM Storage Provider for VMware VASA

  • Table 5. Arguments for ibmvp_storage_array

    Argument Use after ibmvp_storage_array to:

    add -i

    or

    add --mgmt_ips

    Add an XIV storage system specified by an IP address or DNS.

    For example:

    ibmvp_storage_array add -i 10.100.155.200

    Optional: you can define an alias name for the added XIVsystem, by adding -a or --alias tothe command.

    For example:

    ibmvp_storage_array add -i 10.100.155.200 -a mystorage1

    Note: If you choose not to define an alias, the alias name thatis already defined (if one was defined) on the XIV system sideis automatically assigned as the alias name.

    remove -a

    or

    remove --alias

    Remove an XIV storage system specified by its alias name(alias that was given by you or was automatically assigned).

    For example:

    ibmvp_storage_array remove -a mystorage1

    list List the names of all the XIV systems that are currently defined(systems that were added and not removed).

    For example:

    ibmvp_storage_array listmystorage1mystorage2

    -h

    or --help

    Display help information that is relevant toibmvp_storage_array.

    You can also display help for the add or remove argument if it istyped on the command line as well.

    Defining storage capabilitiesBased on your virtual environment requirements, you can define custom namesand descriptions, referred to as storage capabilities, which you can later assign todifferent storage volumes that are used for different purposes.

    This allows virtual entities that are using these volumes to inherit the customnames and descriptions.

    Use the ibmvp_capabilities CLI command to define, update, delete, or list thesecustom names and descriptions. Use the required argument after the command, asspecified in the following table.

    Note: All command arguments are case-sensitive.

    Chapter 3. Configuration and management 11

  • Table 6. Arguments for ibmvp_capabilities

    Argument Use after ibmvp_capabilities to:

    define -c -d

    or:

    define --capability --description

    Define the name and description of a storage capability thatcan be assigned to volumes.

    For example:

    ibmvp_capabilities define -c Mars -d Mars application volumes

    update -c -d

    or:

    update --capability --description

    Update the description of an already defined storage capabilitythat can be assigned to volumes.

    For example:

    ibmvp_capabilities update -c Mars -d Mars mission volumes

    delete -c

    or:

    delete --capability

    Delete a storage capability.

    For example:

    ibmvp_capabilities delete -c Mars

    list Display the names of all currently defines storage capabilities.

    For example:

    ibmvp_capabilities listMars1Mars2Mars3

    -h

    or --help

    Display help information that is relevant toibmvp_capabilities.

    You can also display help for the define, update, or deleteargument if it is typed on the command line as well.

    Listing the available storage volumesYou can display a list of all the volumes that are available on the XIV storagesystems that were added to the IBM Storage Integration Server.

    Use the ibmvp_volume list CLI command to display a list that includes thefollowing details for each storage volume:v Volume name – Name of the volume.v Pool name – Name of the storage pool that contains the volume.v Array alias – Alias name of the XIV system (array) on which the volume resides.v Array identifier – Model and serial number of the XIV system on which the

    volume resides.v Management IP Addresses – IP address or IP addresses that are used to access

    and manage the XIV system on which the volume resides. A domain namespacemight appear instead of an IP address.

    v Storage capability – Name of the storage capability that was assigned to thevolume. Displayed only if a storage capability (see “Defining storagecapabilities” on page 11) was assigned to the volume (see “Assigning storagecapabilities to volumes” on page 13).

    12 IBM Storage Provider for VMware VASA

  • For example:

    ibmvp_volume list

    Volume Name Pool Name Array Alias Array Identifier Managememt IP Addresses Storage Capability----------- --------- ----------- ---------------- ----------------------- ------------------vmdata Pool_A xiv_north 2810-A14-MN00010 10.100.155.200 Mars1vmdatabackup Pool_B xiv_north 2810-A14-MN00010 10.100.155.200 Mars1vmcontroldata Pool_B xiv_north 2810-A14-MN00010 10.100.155.200vmdata Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2vmdatabackup Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2

    If you want to display only the volumes that belong to a certain storage pool, add-p or --pool to the command. For example:

    ibmvp_volume list -p Pool_A

    Volume Name Pool Name Array Alias Array Identifier Managememt IP Addresses Storage Capability----------- --------- ----------- ---------------- ----------------------- ------------------vmdata Pool_A xiv_north 2810-A14-MN00010 10.100.155.200 Mars1vmdata Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2vmdatabackup Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2

    If you want to display only the volumes that reside on a certain XIV array, add -a or --alias to the command. For example:

    ibmvp_volume list -a xiv_north

    Volume Name Pool Name Array Alias Array Identifier Managememt IP Addresses Storage Capability----------- --------- ----------- ---------------- ----------------------- ------------------vmdata Pool_A xiv_north 2810-A14-MN00010 10.100.155.200 Mars1vmdatabackup Pool_B xiv_north 2810-A14-MN00010 10.100.155.200 Mars1vmcontroldata Pool_B xiv_north 2810-A14-MN00010 10.100.155.200

    If you want to display only the volumes that were associated with a certain storagecapability, add -c or --capability to thecommand. For example:

    ibmvp_volume list -c Mars2

    Volume Name Pool Name Array Alias Array Identifier Managememt IP Addresses Storage Capability----------- --------- ----------- ---------------- ----------------------- ------------------vmdata Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2vmdatabackup Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2

    Assigning storage capabilities to volumesAfter you have defined custom storage capabilities, you can assign thesecapabilities to different storage volumes that are used for different purposes.

    You can assign any defined storage capability (see “Defining storage capabilities”on page 11) to any available volume (“Listing the available storage volumes” onpage 12) to which no capability is currently assigned.

    Use the ibmvp_volume capability CLI command to assign or unassign a storagecapability. Use the required argument after the command, as specified in thefollowing table.

    Note: All command arguments are case-sensitive.

    Chapter 3. Configuration and management 13

  • Table 7. Arguments for ibmvp_volume capability

    Argument Use after ibmvp_volume to:

    add -c -a -v

    or:

    add --capability --array --volume

    Assign the specified storage capability to the specified volumein the specified array.

    For example:

    ibmvp_volume capability add -c Mars1 -a xiv_north-v vmcontroldata

    remove -c -a -v

    or:

    remove --capability --array --volume

    Unassign the specified storage capability from the specifiedvolume in the specified array.

    For example:

    ibmvp_volume capability remove -c Mars1 -a xiv_north-v vmcontroldata

    -h

    or --help

    Display help information that is relevant to ibmvp_volumecapability.

    You can also display help for the add or remove argument if it istyped on the command line as well.

    Backing up and restoring IBM Storage Provider configurationsAt any point, you can back up the current IBM Storage Provider configuration andsave it to a file, or load a saved configuration from a file.

    Use the ibmvp_configuration CLI command to save the existing configuration, orload a saved configuration that will replace the existing one. Use the requiredargument after the command, as specified in the following table.

    Note: All command arguments are case-sensitive.

    Attention:

    v Before using the restore option, the IBM Storage Provider service must bestopped as explained in “Checking and controlling the IBM Storage Providerservice” on page 5. Start the service again after the configuration has beenloaded.

    v The restore should be used only with a freshly installed IBM Storage Providerthat has not yet been configured.

    Table 8. Arguments for ibmvp_configuration

    Argument Use after ibmvp_configuration to:

    backup -f

    or:

    backup --file

    Save the current IBM Storage Provider configuration to thespecified file.

    For example:

    backup -f configbackup

    14 IBM Storage Provider for VMware VASA

  • Table 8. Arguments for ibmvp_configuration (continued)

    Argument Use after ibmvp_configuration to:

    restore -f

    or:

    restore --file

    Load a configuration from the specified file.

    Attention: See the notes above this table.

    For example:

    restore -f configbackup

    -h

    or --help

    Display help information that is relevant to ibmvp_volumecapability.

    You can also display help for the backup or restore argument ifit is typed on the command line as well.

    Registering the IBM VASA Provider in VMware vCenter ServerAfter the IBM Storage Provider for VMware VASA is installed and configured, youneed to register the IBM Storage Integration Server as the IBM VASA Providerserver in VMware vCenter Server.

    Procedure

    To register the IBM VASA Provider server in VMware vCenter Server, complete thefollowing steps.1. In vSphere Client, go to Administration > Storage Providers.2. Click Add.

    Chapter 3. Configuration and management 15

  • The Add Vendor Provider dialog box is displayed.

    Note: In the following figure, "ibm-vasa-provider" stands for the IP address ordomain namespace of the IBM Storage Integration Server (the Linux server uponwhich the IBM Storage Provider for VMware VASA is installed).

    Figure 2. vSphere Client – Storage Providers list

    16 IBM Storage Provider for VMware VASA

  • 3. Enter the name, URL (web address), and pre-configured username andpassword for accessing the IBM Storage Integration Server (upon which theIBM Storage Provider for VMware VASA is installed). The web address shouldbe entered in the ip:port format, specifying the relevant IP address and portnumber of the IBM Storage Integration Server: https://[ibm-vasa-provider IPaddress]:8443/services/vasa1

    4. Click OK. A security alert dialog box is displayed.

    5. Click Yes to accept the certificate. The IBM Storage Integration Server is addedto vCenter Server.

    Note: The certificate provides improved security by adding server authentication.

    Figure 3. Add Vendor Provider dialog box

    Figure 4. vCenter certificate thumbprint dialog box

    Chapter 3. Configuration and management 17

  • Figure 5. Supported Vendor list displaying the IBM VASA Provider

    18 IBM Storage Provider for VMware VASA

  • Chapter 4. Troubleshooting

    This chapter can help you detect and solve problems that you might encounterwhen using the IBM Storage Provider for VMware VASA.

    Note: For up-to-date information about known issues and possible workarounds,refer to the latest release notes.

    Checking the log filesThe IBM Storage Provider for VMware VASA maintains two log files that recordmonitoring information.

    You can find the following log files in the opt/ibm/ibm_vasa_provider/log/directory:v hsgsvr.log – Records events regarding the collection of information from the

    monitored XIV systems.v vasa1.log – Records events regarding the communication between the IBM

    Storage Integration Server (upon which the IBM Storage Provider is running)and the connected vCenter servers.

    Checking and modifying the main configuration fileThe vasa_config.ini configuration file stores configuration settings that you canchange manually if needed.

    The file is located in the opt/ibm/ibm_vasa_provider/conf.d/ directory and youcan view or edit its contents with any standard text editor.

    Important: After modifying the vasa_config.ini configuration file, you mustrestart (stop and then start) the IBM Storage Provider service (see “Checking andcontrolling the IBM Storage Provider service” on page 5).

    The vasa_config.ini configuration file contains the following parameters:v populate_arrays_and_events – The time interval in minutes between each

    update of information (changes and events) received from each monitored XIVsystem. The default value is 15.

    v populate_vasa_events_and_alarms – The time interval in minutes between eachoperation of filtering relevant events for each connected vCenter server. Thedefault value is 2.

    v Debug – Controls the debugging mode. By default, this mode is disabled (set to'False'). Do not change the value of this parameter unless you are specificallyrequested to do so by IBM Support. If you are requested to activate this mode,change the parameter value to 'True', but use this mode only for up to 24 hours.

    © Copyright IBM Corp. 2011, 2013 19

  • 20 IBM Storage Provider for VMware VASA

  • Notices

    These legal notices pertain to IBM Storage Host Software Solutions productdocumentation.

    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.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 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.

    © Copyright IBM Corp. 2011, 2013 21

  • 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 CorporationAttn: Office of Legal Counsel650 Harry RoadSan 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.

    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.

    22 IBM Storage Provider for VMware VASA

  • TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks of theInternational 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 Copyright and trademarkinformation website (www.ibm.com/legal/us/en/copytrade.shtml).

    Linux is a trademark of Linus Torvalds in the United States, other countries, orboth.

    VMware, the VMware logo, ESX, ESXi, vSphere, vCenter, and vStorage aretrademarks or registered trademarks of VMware Corporation in the United States,other countries, or both.

    Other product and service names might be trademarks of IBM or other companies.

    Notices 23

    http://www.ibm.com/legal/us/en/copytrade.shtmlhttp://www.ibm.com/legal/us/en/copytrade.shtml

  • 24 IBM Storage Provider for VMware VASA

  • Index

    Aaccess to XIV 8add storage provider 15add user 9add XIV array 10admin commands 9array alias 12assign capability 13

    Bbackup 14

    Ccheck service 6compatibility 2concept diagram 2config.ini 19configuration 7configuration backup 14custom capabilities 11

    Ddebug mode 19define capability 11delete capability 11detect problems 19display storage credentials 8download site 3

    FFix Central 3

    Hhsgsvr.log 19

    Iinstall on server 5installation package 5interval 19

    Llist capabilities 11list users 9list volumes 12list XIV arrays 10log files 19

    Mmanagement 7manual configuration 19

    Ooptional tasks 7overview 1

    Rrelease notes 2remove storage credentials 8remove user 9remove XIV array 10required tasks 7requirements 2resolve issues 19restore 14rpm package 5

    Ssave configuration 14server users 9service status 6set storage credentials 8start service 6stop service 6storage array commands 10storage credentials 8storage integration server 2storage pool 12

    Ttar.gz file 5time interval 19troubleshoot 19

    Uunassign capability 13update capability 11users 9

    VVASA Provider server 15VASA server 2vasa1.log 19vCenter Server 15vendor providers 15volume name 12vSphere Client 15

    Wwhat to do first 7

    XXIV credentials 8XIV systems 10

    © Copyright IBM Corp. 2011, 2013 25

  • 26 IBM Storage Provider for VMware VASA

  • ����

    Printed in USA

    GC14-7500-04

    IBM Storage Provider for VMware VASAContentsFiguresTables

    About this guideWho should use this guideConventions used in this guideRelated information and publicationsGetting information, help, and serviceOrdering publicationsSending your comments

    Chapter 1. IntroductionConcept diagramCompatibility and requirementsDownload siteBefore you proceed

    Chapter 2. InstallationExtracting and installing the software packageChecking and controlling the IBM Storage Provider service

    Chapter 3. Configuration and managementSwitching to IBM Storage Provider user modeSetting, removing, and listing XIV access credentialsAdding, removing, and listing IBM Storage Integration Server usersAdding, removing, and listing connected XIV storage systemsDefining storage capabilitiesListing the available storage volumesAssigning storage capabilities to volumesBacking up and restoring IBM Storage Provider configurationsRegistering the IBM VASA Provider in VMware vCenter Server

    Chapter 4. TroubleshootingChecking the log filesChecking and modifying the main configuration file

    NoticesTrademarks

    IndexABCDFHILMORSTUVWX