IBM Storage Provider for VMware VASA Version 1.1.5 User Guide GC14-7500-04
Note Before 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 for VMware 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 Contract with IBM Corp.
Contents Figures.................................... v Tables.................................... vii About this guide................................ ix Who should use this guide.............................. ix Conventions used in this guide............................. ix Related information and publications........................... ix Getting information, help, and service.......................... ix Ordering publications................................ ix Sending your comments............................... x Chapter 1. Introduction............................. 1 Concept diagram.................................. 2 Compatibility and requirements............................. 2 Download site................................... 2 Before you proceed................................. 3 Chapter 2. Installation.............................. 5 Extracting and installing the software package........................ 5 Checking and controlling the IBM Storage Provider service.................... 5 Chapter 3. Configuration and management..................... 7 Switching to IBM Storage Provider user mode........................ 7 Setting, removing, and listing XIV access credentials...................... 8 Adding, removing, and listing IBM Storage Integration Server users................. 9 Adding, removing, and listing connected XIV storage systems.................. 10 Defining storage capabilities.............................. 11 Listing the available storage volumes........................... 12 Assigning storage capabilities to volumes......................... 13 Backing up and restoring IBM Storage Provider configurations.................. 14 Registering the IBM VASA Provider in VMware vcenter Server.................. 15 Chapter 4. Troubleshooting........................... 19 Checking the log files................................ 19 Checking and modifying the main configuration file...................... 19 Notices................................... 21 Trademarks................................... 23 Index.................................... 25 Copyright IBM Corp. 2011, 2013 iii
iv IBM Storage Provider for VMware VASA
Figures 1. Concept diagram................................ 2 2. vsphere Client Storage Providers list........................ 16 3. Add Vendor Provider dialog box.......................... 17 4. vcenter certificate thumbprint dialog box....................... 17 5. 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..................... 7 2. Optional configuration tasks............................ 7 3. Arguments for ibmvp_storage_credentials....................... 8 4. Arguments for ibmvp_admin_commands......................... 9 5. Arguments for ibmvp_storage_array......................... 11 6. Arguments for ibmvp_capabilities......................... 12 7. Arguments for ibmvp_volume capability........................ 14 8. Arguments for ibmvp_configuration......................... 14 Copyright IBM Corp. 2011, 2013 vii
viii IBM Storage Provider for VMware VASA
About this guide Who should use this guide This guide describes how to install, configure, and use the IBM Storage Provider for VMware VASA. This guide is intended for system administrators who are familiar with the VMware vcenter and vsphere environments, as well as with the IBM XIV Storage System. Conventions used in this guide These 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 avoid inconvenient 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 damage can occur. Related information and publications You can find additional information and publications related to the IBM Storage Provider 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 service Ordering publications If you need help, service, technical assistance, or want more information about IBM products, you can find various sources to assist you. You can view the following websites to get information about IBM products and services and to find the latest technical 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) The IBM Publications Center is a worldwide central repository for IBM product publications and marketing material. Copyright IBM Corp. 2011, 2013 ix
Sending your comments 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 can also order publications. The publications center displays prices in your local currency. Your feedback is important in helping to provide the most accurate and highest quality information. Procedure To submit any comments about this guide or any other IBM Storage Host Software documentation: v 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 to enter and submit comments. You can send your comments by email to starpubs@us.ibm.com. Be sure to include 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 right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. x IBM Storage Provider for VMware VASA
Chapter 1. Introduction For IBM XIV and VMware vsphere users, the IBM Storage Provider for VMware VASA improves the ability to monitor and automate storage-related operations on VMware platforms. The IBM Storage Provider is installed on an IBM Storage Integration Server (a Linux server) that monitors one or more IBM XIV storage systems. From that server, the IBM Storage Provider provides a standard interface for any connected VMware vcenter Server using VMware APIs for Storage Awareness (VASA), delivering information about storage topology, capabilities and state, as well as storage events and alerts to vcenter Server in real time. VMware administrators can view this information on the vsphere Client management station, and can configure storage-related operations accordingly. In addition, a range of CLI management utilities for server configuration is included in the software package. Copyright IBM Corp. 2011, 2013 1
Concept diagram The following figure shows the IBM Storage Provider for VMware VASA installed on an IBM Storage Integration Server (a Linux server) that is connected to both the VMware vcenter server and the IBM XIV Storage System. Figure 1. Concept diagram Compatibility and requirements For the complete and up-to-date information about the compatibility and requirements of the IBM Storage Provider for VMware VASA, refer to the latest release notes. You can find the latest release notes on the IBM Storage Host Software Solutions Information Center (publib.boulder.ibm.com/infocenter/strhosts/ic) or on the IBM Fix Central (www.ibm.com/support/fixcentral). Note: Refer to the relevant VMware documentation for information about how to install the compatible versions of vcenter Server and vsphere Client. You should also refer to the latest installation and configuration instructions for ESXi servers. Download site The IBM Storage Provider for VMware VASA is available as a free software solution. 2 IBM Storage Provider for VMware VASA
Before you proceed You can download the latest version at any time from the IBM Fix Central (www.ibm.com/support/fixcentral). Before you proceed to the installation and configuration, make sure that you have access to a workstation on which your preferred IBM XIV Storage System management software is locally installed or accessible via a remote connection. You can manage the IBM XIV Storage System using the XIV GUI (graphical user interface) or XIV CLI (command-line interface; also referred to as XCLI). For additional assistance and more information on how to obtain, install, and use the IBM XIV Storage System management software, refer to the IBM XIV Storage System Information Center (publib.boulder.ibm.com/infocenter/ibmxiv/r2). Chapter 1. Introduction 3
4 IBM Storage Provider for VMware VASA
Chapter 2. Installation This chapter describes how to install and verify the functionality of the IBM Storage Provider for VMware VASA on an IBM Storage Integration Server. Extracting and installing the software package You can install the IBM Storage Provider for VMware VASA on a compatible version of Red Hat Enterprise Linux (for more information, refer to the release notes). Procedure Perform the following procedure to install the IBM Storage Provider for VMware VASA. 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.rpm v postgresql92-9.2.2-1pgdg.rhel6.x86_64.rpm v postgresql92-contrib-9.2.2-1pgdg.rhel6.x86_64.rpm v postgresql92-libs-9.2.2-1pgdg.rhel6.x86_64.rpm v postgresql92-server-9.2.2-1pgdg.rhel6.x86_64.rpm v uuid-1.6.1-10.el6.x86_64.rpm v 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 run and 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 the complementary RPM files have been installed. The IBM Storage Provider service starts automatically after the installation, and a new Linux user named ibmvp is created so that you can use it for management operations. Checking and controlling the IBM Storage Provider service After the IBM Storage Provider for VMware VASA is installed, you can check whether its service runs properly in the background. You can also stop and then start the service if needed. Copyright IBM Corp. 2011, 2013 5
Procedure 1. 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 status of the Celery and Django services is displayed. [root@ibm-vasa-provider]# service ibm_vasa_provider status Celery 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 stop Stopping Django service: [ OK ] Stopping celery services: [ OK ] To start the service again, use the start command: [root@ibm-vasa-provider]# service ibm_vasa_provider start Starting 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 Storage Integration Server, you can start configuring and managing the server with the CLI utilities that are included in the IBM Storage Provider software package. Refer to the following tables for information about the required and optional configuration and management tasks. Table 1. Required configuration tasks in sequential order Step Required task Refer to 1. Set a password for 'ibmvp' if necessary (a root user action; see cross-reference for details), and then switch to the 'ibmvp' user. Switching to IBM Storage Provider user mode 2. Add XIV access credentials. Setting, removing, and listing XIV access credentials on page 8 3. Add at least one server user to allow access by vcenter Server. 4. Add XIV storage systems to be monitored. 5. Register the server in vcenter Server. Adding, removing, and listing IBM Storage Integration Server users on page 9 Adding, removing, and listing connected XIV storage systems on page 10 Registering the IBM VASA Provider in VMware vcenter Server on page 15 Table 2. Optional configuration tasks Optional task Define storage capabilities (storage purpose definitions) List all detected XIV storage volumes Assign storage capabilities to volumes Back up or restore a configuration Refer to Defining storage capabilities on page 11 Listing the available storage volumes on page 12 Assigning storage capabilities to volumes on page 13 Backing up and restoring IBM Storage Provider configurations on page 14 Switching to IBM Storage Provider user mode To start configuring the IBM Storage Provider for VMware VASA, you must be logged 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, allowing you to carry out the IBM Storage Provider CLI-based configuration and management 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 following procedure. 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 ibmvp Changing 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 credentials The first task after the installation is to set the user account that will be used to connect to the IBM XIV storage system or systems, which your VMware platforms use for storage provisioning. Important: v The same user account (with the same username and password) must already be predefined on all the XIV systems that you intend to use. The IBM Storage Provider cannot use more than a single XIV management account. For more information about how to define a user account on the XIV storage system, refer to the XIV management tools documentation. v XIV storage systems can be added (see Adding, removing, and listing connected XIV storage systems on page 10) only after the storage credentials are set on the server upon which the IBM Storage Provider is installed. Use the ibmvp_storage_credentials CLI command to set, remove, or display the XIV access credentials for the server upon which the IBM Storage Provider is installed. Use the required argument after the command, as specified in the following table. Note: All command arguments are case-sensitive. Table 3. Arguments for ibmvp_storage_credentials Argument set -u <XIV username> -p <XIV password> or: set --user <XIV username> --password <XIV password> Use after ibmvp_storage_credentials to: Set the username and password for accessing all the relevant XIV 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 list Attention: If you already added XIV systems to the server (see Adding, removing, and listing connected XIV storage systems on page 10), deleting the XIV user account disconnects all these XIV storage systems. Display the username of the existing XIV user account definition. For example: ibmvp_storage_credentials list johnxiv -h or --help Display help information that is relevant to ibmvp_storage_credentials. You can also display help for the set argument if it is typed on the command line as well. Adding, removing, and listing IBM Storage Integration Server users All user accounts that vcenter Server will use to access the IBM Storage Integration Server must be individually defined. You can either define (add) a single user account to be used by all the VMware vcenter servers that connect to and utilize the IBM Storage Integration Server (see Registering the IBM VASA Provider in VMware vcenter Server on page 15), or define multiple user accounts to be used separately. Use the ibmvp_admin_commands CLI command to add, remove, or display these user accounts. Use the required argument after the command, as specified in the following table. Note: All command arguments are case-sensitive. Table 4. Arguments for ibmvp_admin_commands Argument add_user -n <username> -e <email address> -p <password> or: add_user --user_name <username> --user_email <email address> --user_password <password> Use after ibmvp_admin_commands to: Add the username, email address, and password of a user that may access the IBM Storage Integration Server from the vcenter server. You can add more than one user. For example: ibmvp_admin_commands add_user -n johnvc -e john@gmail.com -p ******** Chapter 3. Configuration and management 9
Table 4. Arguments for ibmvp_admin_commands (continued) Argument Use after ibmvp_admin_commands to: change_password -n <username> -p <new password> or: change_password --user_name <username> --user_password <password> Change the password of a user account that was already added. The password that you type for the specified username is set as the new password. For example: ibmvp_admin_commands change_password -n johnvc -p ********** delete_user -n <username> or: delete_user --user_name <username> 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_users johnvc zivkalvc polavc -h or --help Display help information that is relevant to ibmvp_admin_commands. You can also display help for the add_user, change_password, or delete_user argument if it is typed on the command line as well. Adding, removing, and listing connected XIV storage systems All IBM XIV storage systems that provide storage resources to your VMware platforms must be defined on the IBM Storage Integration Server on which the IBM Storage Provider is installed. Use the ibmvp_storage_array CLI command to add, remove, or list these XIV storage systems (referred to in the prompts as XIV arrays). Use the required argument 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 add -i <management IP address> or add --mgmt_ips <management IP address> Use after ibmvp_storage_array to: 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 XIV system, by adding -a <alias name> or --alias <alias name> to the command. For example: ibmvp_storage_array add -i 10.100.155.200 -a mystorage1 remove -a <system alias name> or remove --alias <system alias name> Note: If you choose not to define an alias, the alias name that is already defined (if one was defined) on the XIV system side is automatically assigned as the alias name. 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 list mystorage1 mystorage2 -h or --help Display help information that is relevant to ibmvp_storage_array. You can also display help for the add or remove argument if it is typed on the command line as well. Defining storage capabilities Based on your virtual environment requirements, you can define custom names and descriptions, referred to as storage capabilities, which you can later assign to different storage volumes that are used for different purposes. This allows virtual entities that are using these volumes to inherit the custom names and descriptions. Use the ibmvp_capabilities CLI command to define, update, delete, or list these custom names and descriptions. Use the required argument after the command, as specified in the following table. Note: All command arguments are case-sensitive. Chapter 3. Configuration and management 11
Table 6. Arguments for ibmvp_capabilities Argument define -c <capability name> -d <capability description> or: define --capability <capability name> --description <capability description> update -c <capability name> -d <capability description> or: update --capability <capability name> --description <capability description> delete -c <capability name> or: delete --capability <capability name> Use after ibmvp_capabilities to: Define the name and description of a storage capability that can be assigned to volumes. For example: ibmvp_capabilities define -c Mars -d Mars application volumes Update the description of an already defined storage capability that can be assigned to volumes. For example: ibmvp_capabilities update -c Mars -d Mars mission volumes 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 list Mars1 Mars2 Mars3 -h or --help Display help information that is relevant to ibmvp_capabilities. You can also display help for the define, update, or delete argument if it is typed on the command line as well. Listing the available storage volumes 12 IBM Storage Provider for VMware VASA You can display a list of all the volumes that are available on the XIV storage systems that were added to the IBM Storage Integration Server. Use the ibmvp_volume list CLI command to display a list that includes the following 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 v v Array identifier Model and serial number of the XIV system on which the volume resides. 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 namespace might appear instead of an IP address. Storage capability Name of the storage capability that was assigned to the volume. Displayed only if a storage capability (see Defining storage capabilities on page 11) was assigned to the volume (see Assigning storage capabilities to volumes on page 13).
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 Mars1 vmdatabackup Pool_B xiv_north 2810-A14-MN00010 10.100.155.200 Mars1 vmcontroldata Pool_B xiv_north 2810-A14-MN00010 10.100.155.200 vmdata Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2 vmdatabackup Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2 ibmvp_volume list -p Pool_A If you want to display only the volumes that belong to a certain storage pool, add -p <pool name> or --pool <pool name> to the command. For example: 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 Mars1 vmdata Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2 vmdatabackup Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2 ibmvp_volume list -a xiv_north If you want to display only the volumes that reside on a certain XIV array, add -a <alias name> or --alias <alias name> to the command. For example: 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 Mars1 vmdatabackup Pool_B xiv_north 2810-A14-MN00010 10.100.155.200 Mars1 vmcontroldata Pool_B xiv_north 2810-A14-MN00010 10.100.155.200 ibmvp_volume list -c Mars2 If you want to display only the volumes that were associated with a certain storage capability, add -c <capability name> or --capability <capability name> to the command. For example: 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 Mars2 vmdatabackup Pool_A xiv_south 2810-A14-MN00011 10.100.155.202 Mars2 Assigning storage capabilities to volumes After you have defined custom storage capabilities, you can assign these capabilities 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 on page 12) to which no capability is currently assigned. Use the ibmvp_volume capability CLI command to assign or unassign a storage capability. Use the required argument after the command, as specified in the following table. Note: All command arguments are case-sensitive. Chapter 3. Configuration and management 13
Table 7. Arguments for ibmvp_volume capability Argument add -c <capability name> -a <XIV array name> -v <volume name> or: add --capability <capability name> --array <XIV array name> --volume <volume name> Use after ibmvp_volume to: Assign the specified storage capability to the specified volume in the specified array. For example: ibmvp_volume capability add -c Mars1 -a xiv_north -v vmcontroldata remove -c <capability name> -a <XIV array name> -v <volume name> or: remove --capability <capability name> --array <XIV array name> --volume <volume name> Unassign the specified storage capability from the specified volume 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_volume capability. You can also display help for the add or remove argument if it is typed on the command line as well. Backing up and restoring IBM Storage Provider configurations At any point, you can back up the current IBM Storage Provider configuration and save it to a file, or load a saved configuration from a file. Use the ibmvp_configuration CLI command to save the existing configuration, or load a saved configuration that will replace the existing one. Use the required argument 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 be stopped as explained in Checking and controlling the IBM Storage Provider service on page 5. Start the service again after the configuration has been loaded. v The restore should be used only with a freshly installed IBM Storage Provider that has not yet been configured. Table 8. Arguments for ibmvp_configuration Argument backup -f <file name> or: backup --file <file name> Use after ibmvp_configuration to: Save the current IBM Storage Provider configuration to the specified file. For example: backup -f configbackup 14 IBM Storage Provider for VMware VASA
Table 8. Arguments for ibmvp_configuration (continued) Argument restore -f <file name> Use after ibmvp_configuration to: Load a configuration from the specified file. or: Attention: See the notes above this table. restore --file <file name> For example: restore -f configbackup -h or --help Display help information that is relevant to ibmvp_volume capability. You can also display help for the backup or restore argument if it is typed on the command line as well. Registering the IBM VASA Provider in VMware vcenter Server After the IBM Storage Provider for VMware VASA is installed and configured, you need to register the IBM Storage Integration Server as the IBM VASA Provider server in VMware vcenter Server. Procedure To register the IBM VASA Provider server in VMware vcenter Server, complete the following steps. 1. In vsphere Client, go to Administration > Storage Providers. 2. Click Add. Chapter 3. Configuration and management 15
Figure 2. vsphere Client Storage Providers list The Add Vendor Provider dialog box is displayed. Note: In the following figure, "ibm-vasa-provider" stands for the IP address or domain namespace of the IBM Storage Integration Server (the Linux server upon which the IBM Storage Provider for VMware VASA is installed). 16 IBM Storage Provider for VMware VASA
Figure 3. Add Vendor Provider dialog box 3. Enter the name, URL (web address), and pre-configured username and password for accessing the IBM Storage Integration Server (upon which the IBM Storage Provider for VMware VASA is installed). The web address should be entered in the ip:port format, specifying the relevant IP address and port number of the IBM Storage Integration Server: https://[ibm-vasa-provider IP address]:8443/services/vasa1 4. Click OK. A security alert dialog box is displayed. Figure 4. vcenter certificate thumbprint dialog box 5. Click Yes to accept the certificate. The IBM Storage Integration Server is added to vcenter Server. Note: The certificate provides improved security by adding server authentication. 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 encounter when 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 files The IBM Storage Provider for VMware VASA maintains two log files that record monitoring information. You can find the following log files in the opt/ibm/ibm_vasa_provider/log/ directory: v v hsgsvr.log Records events regarding the collection of information from the monitored XIV systems. 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 file The vasa_config.ini configuration file stores configuration settings that you can change manually if needed. The file is located in the opt/ibm/ibm_vasa_provider/conf.d/ directory and you can view or edit its contents with any standard text editor. Important: After modifying the vasa_config.ini configuration file, you must restart (stop and then start) the IBM Storage Provider service (see Checking and controlling 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 XIV system. The default value is 15. v populate_vasa_events_and_alarms The time interval in minutes between each operation of filtering relevant events for each connected vcenter server. The default 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 specifically requested 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 product documentation. 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 in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Copyright IBM Corp. 2011, 2013 21
Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product 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 it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Attn: Office of Legal Counsel 650 Harry Road San Jose, CA 95120-6099 U.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 material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. 22 IBM Storage Provider for VMware VASA
Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of the International 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 trademark information website (www.ibm.com/legal/us/en/copytrade.shtml). Linux is a trademark of Linus Torvalds in the United States, other countries, or both. VMware, the VMware logo, ESX, ESXi, vsphere, vcenter, and vstorage are trademarks 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
24 IBM Storage Provider for VMware VASA
Index A access to XIV 8 add storage provider 15 add user 9 add XIV array 10 admin commands 9 array alias 12 assign capability 13 B backup 14 C check service 6 compatibility 2 concept diagram 2 config.ini 19 configuration 7 configuration backup 14 custom capabilities 11 D debug mode 19 define capability 11 delete capability 11 detect problems 19 display storage credentials 8 download site 3 F Fix Central 3 H hsgsvr.log 19 I install on server 5 installation package 5 interval 19 L list capabilities 11 list users 9 list volumes 12 list XIV arrays 10 log files 19 M management 7 manual configuration 19 O optional tasks 7 overview 1 R release notes 2 remove storage credentials 8 remove user 9 remove XIV array 10 required tasks 7 requirements 2 resolve issues 19 restore 14 rpm package 5 S save configuration 14 server users 9 service status 6 set storage credentials 8 start service 6 stop service 6 storage array commands 10 storage credentials 8 storage integration server 2 storage pool 12 T tar.gz file 5 time interval 19 troubleshoot 19 U unassign capability 13 update capability 11 users 9 V VASA Provider server 15 VASA server 2 vasa1.log 19 vcenter Server 15 vendor providers 15 volume name 12 vsphere Client 15 W what to do first 7 X XIV credentials 8 XIV systems 10 Copyright IBM Corp. 2011, 2013 25
26 IBM Storage Provider for VMware VASA
Printed in USA GC14-7500-04