Customized output from:
|
Document Release Date: June 2015 Software Release Date: June 2015 |
|
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
© Copyright 2015 Hewlett-Packard Development Company, L.P.
Adobe® is a trademark of Adobe Systems Incorporated.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
UNIX® is a registered trademark of The Open Group.
HP Virtualization Performance Viewer (HP vPV) is a web-based analysis and visualization tool that analyzes the capacity and performance trends of elements in virtualized environments. It enables virtualization monitoring by providing an overview of the environment, near-real-time and historical data analysis and triaging using an interactive dashboard. It also enables monitoring for cloud and hypervisor environments.
HP vPV helps you visualize performance data for elements in the context of each other to rapidly analyze bottlenecks. HP vPV provides capacity analysis, performance monitoring, graphing, and reporting in a single interface.
Select the task you would like to perform.
Select the installation type to install, upgrade or remove HP vPV.
HP vPV is available as a virtual appliance for easy deployment in the VMware vCenter. A Virtual Appliance is a pre-configured and ready-to-run virtual machine packaged with an operating system and software application. You can also install HP vPV using the Linux based installer.
Select the version to upgrade.
Select your installation preference.
Unattended installation is an automated installation technology with minimal user intervention whereas attended installation requires the user to act.
Select your installation preference.
Graphical interface employs graphics for users to navigate and interact.
Command line interface enables users to type commands in a terminal or console window to interact.
Select the configuration task you would like to perform.
Select the task you would like to perform.
You can view your customized document on the screen, or print it.
If you have a PDF print driver installed on your computer, click Print to create PDF documents that are customized according to your selections. PDF print drivers are available from several open source and third-party providers.
The following steps are customized according to your selections. Check that your selections are correct.
If any selections are not correct, click Change.
During installation, the installer performs the following tasks:
Note: HP vPV supports only x64-bit version of the Linux operating system.
The location of the following files used for HP Operations agent co-existence has been changed:
| File Name | Old Location | New Location |
|---|---|---|
| Viserver.properties | /var/opt/perf | /var/opt/OV/conf/PV |
| VILog4j.xml | /var/opt/perf | /var/opt/OV/conf/PV |
| pvcd.jar | /opt/perf/bin/java | /opt/OV/lbin/PV/java |
| log4j-1.2.17.jar | /opt/perf/bin/java | /opt/OV/lbin/PV/java |
Note: The common jars are moved to /opt/OV/lbin/PV/java. The jars specific to a technology are part of its SMEPack.
For Example: jars required by VMWARE collector are present in the java folder within the VMWARE SMEPack.
/opt/OV/newconfig/OVPM/smepack/VMWARE/java
HP vPV requires the following ports to be open on the firewall:
| Port | Protocol | Description |
|---|---|---|
| 8081 | HTTP | To make HP vPV accessible from the remote browser, if there is a firewall on the system where HP vPV is installed. |
| 8444 | HTTPS | To access HP vPV in Hypertext Transfer Protocol Secure mode. |
| 5480, 5488, and 5489 | HTTPS | To access the Virtual Appliance Management Interface (VAMI). |
| 383 | HTTPS | For HP vPV internal communication process. |
| 5433 | HTTPS | For HP vPV database requirements (HP Vertica). |
| 443 | HTTPS | To ensure data collection from VMware vSphere targets. |
| 5671 | HTTPS | To ensure data collection from HP OneView targets. |
| 135 | To ensure data collection from Hyper-V targets. Port between Windows proxy system and Hyper-V host should be open on Hyper-V host. | |
| 22 | SSH | To ensure data collection from KVM and Xen targets. |
| 35357 (Admin), 8774 (Nova) | HTTPS | To ensure data collection from OpenStack targets. |
HP vPV requires the following ports to be open on the firewall:
| Port | Protocol | Description |
|---|---|---|
| 8081 | HTTP | To make HP vPV accessible from the remote browser, if there is a firewall on the system where HP vPV is installed. |
| 8444 | HTTPS | To access HP vPV in Hypertext Transfer Protocol Secure mode. |
| 5480, 5488, and 5489 | HTTPS | To access the Virtual Appliance Management Interface (VAMI). |
| 383 | HTTPS | For HP vPV internal communication process. |
| 5433 | HTTPS | For HP vPV database requirements (HP Vertica). |
| 443 | HTTPS | To ensure data collection from VMware vSphere targets. |
| 5671 | HTTPS | To ensure data collection from HP OneView targets. |
| 135 | To ensure data collection from Hyper-V targets. Port between Windows proxy system and Hyper-V host should be open on Hyper-V host. | |
| 22 | SSH | To ensure data collection from KVM and Xen targets. |
| 35357 (Admin), 8774 (Nova) | HTTPS | To ensure data collection from OpenStack targets. |
You can download the HP vPV virtual appliance from: http://www.hp.com/go/vpv. You can install the HP vPV virtual appliance using the Deploy OVF Template functionality of the VMware vSphere client. To log on to the virtual appliance, the username is root and password is vperf*viewer. For more information, see the VMware documentation.
HP vPV is available as a Virtual Appliance for easy deployment in vCenter. You can use the VMware vSphere Client user interface to deploy the virtual appliance.
The supported VMware vCenter Server versions are 5.0, 5.1, 5.5, and 6.0.
To deploy the HP vPV virtual appliance, follow these steps:
Note: For more information, see the VMware documentation. The steps are subject to change based on VMware.
Logging in to the Virtual Appliance
You can log in to the HP vPV Virtual Appliance using the username as root. The default password is vperf*viewer and it is recommended to change the password after logging in.
Note: You can upgrade HP vPV only from version 2.01 and 2.10 to 2.20. Upgrading HP vPV takes a significant amount of time. You cannot upgrade HP vPV from versions 1.00, 1.10, 1.20, and 2.00 to version 2.20. Also, make sure that you take a snapshot of HP vPV 2.01 or 2.10 machine before upgrading to 2.20 as rollback is not supported.
If you already have HP vPV version 2.10 deployed on the virtual appliance and want to upgrade to version 2.20, you can do it in the following two ways:
Log on to the HP vPV virtual appliance as root.
Run the following commands:
cp /opt/vmware/etc/lighttpd/lighttpd.conf.vPV cp /opt/vmware/etc/lighttpd/lighttpd.conf
/etc/init.d/vami-lighttp restart
Note: You can upgrade HP vPV only from version 2.01 and 2.10 to 2.20. Upgrading HP vPV takes a significant amount of time. You cannot upgrade HP vPV from versions 1.00, 1.10, 1.20, and 2.00 to version 2.20. Also, make sure that you take a snapshot of HP vPV 2.01 or 2.10 machine before upgrading to 2.20 as rollback is not supported.
If you already have HP vPV version 2.01 deployed on the virtual appliance and want to upgrade to version 2.20, you can do it in the following two ways:
Log on to the HP vPV virtual appliance as root.
Run the following commands:
cp /opt/vmware/etc/lighttpd/lighttpd.conf.vPV cp /opt/vmware/etc/lighttpd/lighttpd.conf
/etc/init.d/vami-lighttp restart
Note: You can upgrade HP vPV only from version 2.01 and 2.10 to 2.20. Upgrading HP vPV takes a significant amount of time. You cannot upgrade HP vPV from versions 1.00, 1.10, 1.20, and 2.00 to version 2.20. Also, make sure that you take a snapshot of HP vPV 2.01 or 2.10 machine before upgrading to 2.20 as rollback is not supported.
If you already have HP vPV version 2.00 deployed on the virtual appliance and want to upgrade to version 2.20, you can do it in the following two ways:
To remove the HP vPV virtual appliance, power off the VM and delete the VM.
To perform unattended installation, follow these steps:
Download the .tar file. Extract the contents of the .tar file.
Go to the directory where the .tar file is extracted.
Type the following syntax at the command prompt:
./HPPV_2.20.xxx_setup.bin -i silent
Note: If the installer finds a working installation of HP vPV, it will uninstall HP vPV when you run the -i silent command. If not, it will install HP vPV.
You can view the HP vPV installer log file at /tmp/HPOvInstaller/HPPVInstallLog.txt
Installing HP vPV through Graphical Interface
To install HP vPV using X11 interface, perform the following tasks:
Download the .tar file. Extract the contents of the .tar file.
To start installation, if you want to use the X11 terminal window, export the DISPLAY variable to point to an X11 terminal type the following command:
export DISPLAY=<IP_Address/system_name>:0.0
where, <IP_Address/system_name> is the IP address or the system name of the X11 terminal.
Type the following:
<CD/DVD-ROM> HPPV_2.20.xxx_setup.bin
where, <CD/DVD-ROM> is the drive letter of the CD/DVD ROM.
The HP vPV Installation wizard appears. This window displays an introductory message.
Note: If you are installing HP vPV for the first-time on your Linux system, the ovinstallparams.ini file containing the installation parameters is created in the system’s temporary directory. During installation, HP Installer checks for the ovinstallparams.ini file. If HP Installer detects the ovinstallparams.ini file on your system, a message asking if you want to reuse the values in the file appears.
If HP Installer does not find the file, the system creates the ovinstallparams.ini file with default values in the temporary directory. To save the ovinstallparams.ini data, copy the file to an alternate location, before installing other HP products.
If you have configured the locale of the system to one of the following languages: English, Japanese, and Simplified Chinese, the installer prompts you to select the language at the beginning of the installation. You will have the option of choosing the language to which your system locale is set. If the system locale is set to any other language apart from these, the installer displays only ‘English’.
Click Next. The Pre-Install Summary screen appears. The screen displays the list of components that will be installed.
Note: If HP vPV version 2.01 or 2.10 is present on the system, you would be asked to do a forced re-installation of already installed component packages.
Click Install.
Note: If the installation fails, you can roll back or quit installation. The Roll Back option removes the components which are already installed.
Clicking Quit stops the installation, but does not uninstall the components installed till then.
When you start HP vPV installation next time, the Installer prompts you to confirm if you want to resume the installation or uninstall HP vPV.
Click Done to complete the installation.
Note: If the system needs to be restarted, the following message appears after installation is complete: ‘You may need to restart your system for the configuration changes made to the system to take effect. Would you like to quit this installation?’.
It is recommended that you restart your system after installation.
Note: Localization is not supported when installing HP vPV in console mode. As a result, some text may be illegible.
To install HP vPV through Command Line interface, follow these steps:
Download the .tar file. Extract the contents of the .tar file.
Run the following command:
If you are installing HP vPV on a stand-alone system:
<Directory where the tar file is extracted>/HPPV_2.20.xxx_setup.bin -i console
If you have configured the locale of the system to one of the following languages: English, Japanese, and Simplified Chinese, the installer prompts you to select the language at the beginning of the installation. You will have the option of choosing the language to which your system locale is set. If the system locale is set to any other language apart from these, the installer displays only ‘English’.
Click Enter to continue. The pre-installation summary appears.
Note: If HP vPV version 2.01 or 2.10 is present on the system, you would asked to do a forced re-installation of already installed component packages. Select Yes to continue.
Click Enter to continue.
When the installation is complete, you will receive a message which states that the installation was completed successfully.
Note: You can upgrade HP vPV only from version 2.01 and 2.10 to 2.20. Upgrading HP vPV takes a significant amount of time. You cannot upgrade HP vPV from versions 1.00, 1.10, 1.20, and 2.00 to version 2.20. Also, make sure that you take a snapshot of HP vPV 2.01 or 2.10 machine before upgrading to 2.20 as rollback is not supported.
If you already have HP vPV version 2.00 installed in your environment and want to upgrade to version 2.20, you can upgrade using .tar or .iso. Download the .tar or .iso on your local machine and install HP vPV on the VM.
Note: You can upgrade HP vPV only from version 2.01 and 2.10 to 2.20. Upgrading HP vPV takes a significant amount of time. You cannot upgrade HP vPV from versions 1.00, 1.10, 1.20, and 2.00 to version 2.20. Also, make sure that you take a snapshot of HP vPV 2.01 or 2.10 machine before upgrading to 2.20 as rollback is not supported.
If you already have HP vPV version 2.01 installed in your environment and want to upgrade to version 2.20, you can upgrade using .tar or .iso. Download the .tar or .iso on your local machine and install HP vPV on the VM.
Note: You can upgrade HP vPV only from version 2.01 and 2.10 to 2.20. Upgrading HP vPV takes a significant amount of time. You cannot upgrade HP vPV from versions 1.00, 1.10, 1.20, and 2.00 to version 2.20. Also, make sure that you take a snapshot of HP vPV 2.01 or 2.10 machine before upgrading to 2.20 as rollback is not supported.
If you already have HP vPV version 2.00 installed in your environment and want to upgrade to version 2.20, you can upgrade using .tar or .iso. Download the .tar or .iso on your local machine and install HP vPV on the VM.
To remove HP vPV from a Linux system:
/opt/OV/Uninstall/HPPV.Run the uninstall command:
To use an X11 interface, export the DISPLAY variable to point to an X11 terminal if necessary. Then run the command:
./setup.bin
To use a command line interface, run the command:
./setup.bin -i console
On successful installation:
For Linux: /tmp/HPPV_2.xx.xxx_HPPVInstaller.txt
/var/tmp/HPPVInstaller/PerfUtil-mm-dd-yyyy.log.0
In this instance, mm indicates the month, dd indicates the day, and yyyy indicates the year. The file name indicates the time stamp when the install was performed.
To configure HP vPV to communicate with a remote instance of HP Vertica, perform the following steps:
On the machine where a database instance of HP vPV is to be created:
To create a database instance login to HP Vertica system, run the following command:
su <dbadminuser> -c "/opt/vertica/bin/adminTools -t create_db -s <hostname> -d pv -c <Vertica_DB_Path>/catalog -D <Vertica_DB_Path>/data"
In this instance,
the dbadminuser is the database administrator user.
the hostname is the host name or IP address of HP Vertica system.
the Vertica_DB_Path is the database path of HP Vertica.
For example, su dbadmin -c "/opt/vertica/bin/adminTools -t create_db -s 10.20.10.1 -d pv -c /vertica_disk/catalog -D /vertica_disk/data"
Create HP Vertica user. Run the following commands in sequence to create HP Vertica user with access to public schema:
su <dbadminuser> /opt/vertica/bin/vsql –c “CREATE USER <UserName> IDENTIFIED BY '<Userpassword>'”
su <dbadminuser> /opt/vertica/bin/vsql –c “GRANT ALL ON SCHEMA PUBLIC to <UserName>”
In this instance,
the dbadminuser is the database administrator user.
the UserName is the user name for the database instance.
the Userpassword is the password for database instance.
On HP vPV system:
Run the following command to stop ovtomcatB and pvcd processes:
/opt/OV/bin/ovc -stop
Run the following command to stop the local HP Vertica instance:
/opt/OV/bin/pv_vertica stop
/var/opt/OV/conf/perf/Set hibernate.connection.url = jdbc:vertica://<IP Address>:<Port Number>/pv
In this instance,
the IP Address is the IP address of remote HP Vertica instance
the Port Number is the port number of remote HP Vertica instance.
Set hibernate.connection.username=<User Name>
In this instance,
the User Name is the user name of remote HP Vertica instance.
Set hibernate.connection.password=<Password>
In this instance,
the Password is the encrypted password of remote HP Vertica instance.
pvconfig -en <password>password is the decrypted password of remote HP Vertica instance.Run the following commands to update the user name, password, and connection string in the configuration database:
ovconfchg -ns pvcd.dml -set username "<User Name>"
In this instance,
the User Name is the user name of remote HP Vertica instance.
ovconfchg -ns pvcd.dml -set password "<Password>"
In this instance,
the Password is the encrypted password of remote HP Vertica instance.
pvconfig -en <password>password is the decrypted password of remote HP Vertica instance.ovconfchg -ns pvcd.dml -set ConnectionString "DSN=Vertica;SERVERNAME=<IP Address>;PORT=<Port Number>;"
In this instance,
the IP Address is the IP address of remote HP Vertica instance
the Port Number is the port number of remote HP Vertica instance.
Run the following commands in sequence to create database schema on HP vPV system:
/opt/OV/bin/pvsql -f /opt/OV/newconfig/OVPM/vertica/CreateTables_Vertica.sql/opt/OV/bin/pvsql -f /opt/OV/newconfig/OVPM/vertica/DummyData_Vertica.sql
/opt/OV/bin/pvsql -f /opt/OV/newconfig/DataDir/conf/PV/Model/DMLMetaMetaSchema/opt/OV/bin/pvsql -f /var/opt/perf/syspulse/scripts/createtable.sql/opt/OV/bin/pvsql -f /opt/OV/newconfig/OVPM/vertica/Create_Custom_Projections.sql
Run the following command to start HP vPV processes:
• /opt/OV/bin/pvconfig –um
• /opt/OV/bin/ovc –start
The HTTPS protocol is by default enabled for HP vPV. The default port number for HTTPS is 8444. To access HP vPV in the secure mode, use the following URL:
https://<systemname>:8444/PV
You can also change the default port settings for HTTPS communications.
Changing Port Settings:
The default HTTPS port number to access HP vPV is 8444. All client systems are authorized to connect to HP vPV server. To change the default port number for the HP vPV server, follow these steps:
Check for the availability of the port number you want to use, by running the following commands at the command prompt:
cd <bin_dir>
ovtomcatbctl -checkport <portnumber>
A message indicating if the port is available or in use appears. For example, if you are checking for the availability of the port number 8444, the message, “Port Number 8444 is not in use” appears, if the port number is available. If the Port Number 8444 is not available, a message indicating that the port number is used by another program or service appears.
Stop HP vPV by running the following command at the command prompt:
pv stop
To change https port numbers for HP vPV server, run the following command at the command prompt:
cd <bin_dir>
ovconfchg -ns NONOV.TomcatB -set HTTPPort <port number>
ovconfchg -ns NONOV.TomcatB -set HTTPSPort <port number>
Start the HP vPV server by running the following command at the command prompt:
pv start
Using SSL or HTTPS with the Tomcat Web Server
To use SSL or HTTPS protocols with the Tomcat web server, you need to obtain a server certificate for Tomcat after installing HP vPV. You can replace the certificate obtained after HP vPV installation in the following scenarios:
When you connect to HP vPV using HTTPS protocol, the certificate and name of the system are compared to ensure that the names match. If the names are not similar, most browsers alert the users so that they can decide to either continue or cancel the connection. If the name used by HTTPS users is different from the name used by the HP vPV installation, you must obtain a different certificate.
You may need to obtain a new certificate when you want to fill the fields in the certificate that are left blank during HP vPV installation. The certificate contains many fields to provide information, such as, the issuer of the certificate and other fields that warrant the safety provided by the certificate. The HP vPV installation certificate leaves most of these fields blank.
When you want to change the default certificate password to avoid unauthorized changes, you must replace the existing certificate.
To replace the Tomcat SSL certificate, perform the following steps:
Delete the existing certificate by running the following command at the command prompt.
keytool -delete -alias ovtomcatb -keystore /var/opt/OV/certificates/tomcat/b/tomcat.keystore
The keytool path on Linux is /opt/OV/nonOV/jre/b/bin
Restart HP vPV.
Create a new certificate. To create a new certificate, run Keytool by entering the following commands at the command prompt:
keytool -genkey -alias ovtomcatb -keyalg RSA -keystore /var/opt/OV/certificates/tomcat/b/tomcat.keystore
Restart HP vPV.
vCenter Server system requires port 443, for connections from the vSphere and Software Development Kit (SDK) clients. By default, vCenter collector of HP vPV 2.20 uses port 443 for data collection from vCenter server. If this default port 443 is re-configured in your environment due to any reason, it is recommended to use the iptables to route the traffic.
During the HP vPV 2.20 installation, run the iptables command and setup port forwarding rules for each of the target.
Follow the steps:
Log on as a root user.
Run the following command:
iptables -t nat -A OUTPUT -p tcp -m tcp -d <target vcenter(s) ip> --dport 443 - j DNAT --to-destination <target vcenter(s) ip>:<target port>
In this instance, <target vcenter(s) ip> is the ip address of the target vCenter and <target port> is the port number of the target.
After you install HP vPV, you can use the following commands to administer the HP vPV workspace through the command prompt.
<bin_dir>/pv <Options>
You can replace <Options> with any of the following variables:
status - To check the HP vPV status.
start - To start HP vPV.
All the applications that use OvTomcatB are started when you run pv start command.
stop - To stop HP vPV.
All the applications that use OvTomcatB are stopped when you run pv stop command.
restart - To stop and then start HP vPV.
trace on - To start generating detailed trace files.
trace off - To stop generating detailed trace files.
version - To display the version of HP vPV installed on your system.
After you install HP vPV, you can purchase the appropriate licenses based on your business requirements. These licenses enable you to access all the features of the product. To purchase the respective license, click You have Evaluation/Community license. Click to buy license link. The link navigates to the Buy License page. Enter your details in the Contact Me tab and click Submit. Make sure email client is configured in your browser.
To access the License option on the HP vPV user interface:
Click the Settings icon.
The Settings page appears.
In the Settings page, click the License option.
The License page appears.
The License page provides information about your HP vPV licenses. You can also use this tab to start using your Evaluation License as well as import a HP vPV license.
The RPMs packaged with the HP vPV Virtual Appliance are as follows:
audit-libs-2.2-2.el6.x86_64
libselinux-2.0.94-5.3.el6.x86_64
libgpg-error-1.7-4.el6.x86_64
net-tools-1.60-110.el6_2.x86_64
curl-7.19.7-35.el6.x86_64
ipw2100-firmware-1.3-11.el6.noarch
vmware-studio-vami-tools-2.6.0.0-631426.x86_64
vmware-studio-vami-service-system-2.6.0.0-0.x86_64
libgcc-4.4.7-3.el6.x86_64
filesystem-2.4.30-3.el6.x86_64
info-4.13a-8.el6.x86_64
file-libs-5.04-15.el6.x86_64
file-5.04-15.el6.x86_64
psmisc-22.6-15.el6_0.1.x86_64
nss-sysinit-3.14.0.0-12.el6.x86_64
ethtool-3.5-1.el6.x86_64
libevent-1.4.13-4.el6.x86_64
slang-2.2.1-1.el6.x86_64
fipscheck-1.2.0-7.el6.x86_64
iwl6000g2a-firmware-17.168.5.3-1.el6.noarch
man-1.6f-32.el6.x86_64
attr-2.4.44-7.el6.x86_64
You can verify the upgrade to HP vPV version 2.20 by performing either of the following:
pv version
Note: After the upgrade, it is recommended to check the status of HP vPV processes using the following command:
/opt/OV/bin/ovc
If any of the processes are not running, run the following command to restart the processes:
pv restart
© Copyright 2015 Hewlett-Packard Development Company, L.P.