Академический Документы
Профессиональный Документы
Культура Документы
Desktop HealthAnalyzer.
You can download a PDF of this guide:
VMware consultants (only) can download the Desktop HealthAnalyzer and the documentation from
VM Vault. Search for Desktop HealthAnalyzer.
VMware partners who have a current Services Software Solutions subscription can download
Desktop HealthAnalyzer and the documentation from Partner Central.
You can also access this guide from the Help link on the Desktop HealthAnalyzer user interface. See the
VMware Desktop HealthAnalyzer User Guide for information about using Desktop HealthAnalyzer.
Intended Audience
This information is intended for use only by VMware Professional Services consultants, and VMware
partners who have a current Services Software Solutions subscription.
Document Feedback
If you have suggestions for improving Desktop HealthAnalyzer documentation, send your feedback to
services-software-support@vmware.com.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 6 of 19
1
1. VMware Desktop HealthAnalyzer
VMware Desktop HealthAnalyzer automates the collection and analysis of the VMware Horizon View
and VMware vSphere
3.x and later, VMware Workstation 6.x and later, VMware Fusion
3.x and
later, VMware Server 2.0 and later, and VMware Studio 1.0 and later. You can download it from
http://communities.vmware.com/community/vmtn/vsphere/automationtools/ovf. It is recommended that
you also download the documentation.
Download
installation
files and
power on
the virtual
appliance
Apply the
latest
patches to
the virtual
appliance
OS
Find or set
the virtual
appliance
IP address
Install
VMware
Tools, if a
later
version is
available
Change
appliance
or browser
proxy
settings, if
necessary
Display
the user
interface
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 13 of 19
To convert the OVF file to VMX
1. Download the Desktop HealthAnalyzer virtual appliance installation file.
2. Unzip the installation directory file.
3. Use the OVF Tool to convert the OVF file to a VMX file.
4. Change directory to DesktopHealthAnalyzer.
5. Use VMware Workstation 5.x or later (5.5.6 or later recommended), an equivalent generation of
VMware Player (Version 1 or later), or VMware Server (1.0.5) to power on
DesktopHealthAnalyzer.vmx.
If you plan to deploy the virtual appliance in a VMware Infrastructure environment, import it using VMware
Converter. Do not install VMware Tools if you import using VMware Converter.
2.3.1.3. Changing the Tomcat Process Memory
You can change the amount of memory allocated to the Tomcat process for Desktop HealthAnalyzer. You
might need to increase the amount of memory allocated if you are using Desktop HealthAnalyzer in a
large environment. The procedure differs depending on whether you are using the Desktop
HealthAnalyzer virtual appliance or the Java application.
To change the amount of Tomcat memory with a virtual appliance
1. Log in to the virtual appliance using the user root and password vmware.
2. Open the configuration file using vi or another text editor:
vi /usr/share/vha/tomcat/conf/vha-tomcat-memory
3. Locate the default value of 512 and change it to your desired value. This is the amount of memory
allocated to Tomcat in megabytes.
4. Restart the appliance with the following command:
shutdown r now
5. You can confirm that the memory value changed by issuing the following command and reviewing the
arguments Xms and Xmx.
ps ef | grep catalina
To change the amount of Tomcat memory using the Java application
1. Quit the Desktop HealthAnalyzer Java application.
2. Go to the directory where the Desktop HealthAnalyzer Java application was unzipped.
3. Open the configuration file using a text or XML editor:
<unzipped location>/launcher/resources/applicationContext.xml
4. Locate the util:map XML section that contains memory settings by searching for vha-start.
Change both Xms and Xmx values to the desired value. For example, to change the Tomcat
memory to 1024MB, change the XML as follows:
<util:map id="vha-start" map-class="java.util.LinkedHashMap">
<entry key="java" value="" />
<entry key="-Xms1024m" value="" />
<entry key="-Xmx1024m" value="" />
5. Save the file, and start the Desktop HealthAnalyzer Java application.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 14 of 19
2.3.2 Using the Virtual Appliance Web Console
The Desktop HealthAnalyzer virtual appliance provides a web console management user interface. This
is the standard web console for virtual appliances and vApps generated using VMware Studio. Instead of
using the command line, you can use the web console to perform tasks such as: reboot, shutdown,
setting the system time zone, finding or changing the appliance IP address, and changing network or
proxy settings.
2.3.3 Logging in to the Virtual Appliance
To log in to the virtual appliance web console
1. Open your browser and go to https://<virtual appliance IP address>:5480.
2. User name is root and Password is vmware.
If you cannot access the appliance web console, check proxy settings between the appliance and the
browser. See Changing Browser Proxy Settings on page 17.
To log in to the virtual appliance command-line interface
1. At the login prompt, type root and press Enter.
2. For password, type vmware and press Enter.
To maintain security, change the password immediately after logging in for the first time.
2.3.4 Patching the Virtual Appliance OS
The virtual appliance was built using CentOS 5.2. When you download the virtual appliance you should
get the latest OS patches to make sure that the OS is patched to the highest available level. You must
have a connection to the Internet.
To patch the OS
1. If a proxy server is required to reach the Internet, run the following command:
export http_proxy=http://<proxy-server>:<port>
2. Run the following command to update the OS:
yum update
2.3.5 Finding the Virtual Appliance IP Address
You need to know the virtual appliance IP address to display the Desktop HealthAnalyzer user interface
or the virtual appliance web console.
To display the virtual appliance IP address from the vSphere Client
1. Power On the virtual appliance.
2. Open the vSphere Client.
3. Click the Summary or Console tab. The IP address is displayed.
To display the virtual appliance IP address from Workstation
1. Power On the virtual appliance.
2. The IP address is displayed as the virtual appliance starts.
To display the virtual appliance IP address from the command-line
Type ifconfig at an appliance command-line prompt. Use the eth0 inet address.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 15 of 19
2.3.5.1. Configuring the Virtual Appliance to use a Static IP Address
By default, the virtual appliance is configured to use DHCP, but you can configure it to use a static IP
address.
To configure a static IP address from the web console
1. Open the Desktop HealthAnalyzer virtual appliance web console.
2. Click the Network tab, and click Address.
3. Select Use the following IP settings.
4. Enter the IP address and other network parameters (Netmask, Gateway, Preferred DNS Server,
Alternate DNS Server, Hostname) and click Save Settings.
To configure a static IP address from the command-line
1. Log in to the virtual appliance.
2. From the virtual appliance command-line interface, run the following command using your own
password:
sudo -s
3. Create a backup copy of /etc/network/interfaces.
4. Edit /etc/network/interfaces and change
iface eth0 inet dhcp
to
iface eth0 inet static
5. Add the following lines to /etc/network/interfaces and supply the new networking parameters:
address <ip address>
netmask <subnet mask>
network <network ip address>
broadcast <broadcast ip address>
gateway <gateway ip address>
6. Run the following command to restart the virtual appliance and make the changes effective:
sudo /etc/init.d/networking restart
2.3.6 Updating VMware Tools on the Virtual Appliance
VMware Tools is pre-installed on the Desktop HealthAnalyzer virtual appliance, but you should update it if
a later version of VMware Tools becomes available. In this case, you might see a message that VMware
Tools is outdated. Installing VMware Tools on the Desktop HealthAnalyzer virtual appliance improves
performance.
Note If you imported Desktop HealthAnalyzer using VMware Converter, do not install VMware Tools.
Desktop HealthAnalyzer uses the open source version of VMware Tools, which uses operating system
specific packages (OSPs) to package and distribute VMware Tools. See the VMware Tools Installation
Guide Operating System Specific Packages (http://www.vmware.com/pdf/osp_install_guide.pdf) for more
information.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 16 of 19
To install VMware Tools on the virtual appliance
1. Obtain and import the VMware Packaging Public GPG Key.
a. Using a web browser, copy the file from:
http://packages.vmware.com/tools/VMWARE-PACKAGING-GPG-KEY.pub
b. Save the file to the directory:
/usr/share/VMWARE-PACKAGING-GPG-KEY.pub
c. Run the following command to import the key:
rpm --import /usr/share/VMWARE-PACKAGING-GPG-KEY.pub
2. Edit /etc/yum.conf and set up the proxy server information. For example:
proxy=http://proxy.proxyprovider.com:3128
proxy_username=proxyuser
proxy_password=proxypass
3. Create and edit the VMware repository directory and file.
a. If it does not exist, create the directory and repository file on the virtual machine. You can choose
any name for this file, but it must use the .repo file extension. For example:
/etc/yum.repos.d/vmware-tools.repo
b. Edit the repository file and add the following:
[vmware-tools]
name=VMware Tools for Red Hat Enterprise Linux $releasever - $basearch
baseurl=http://packages.vmware.com/tools/esx/<esx-version>/rhel5/i686
enabled=1
gpgcheck=1
gpgkey=file:///usr/share/VMWARE-PACKAGING-GPG-KEY.pub
where <esx-version> is replaced with either 3.5u2, 3.5u3, 3.5u4, 3.5u5, 4.0, or 4.0u1,
depending on the ESX/ESXi version.
c. Save the file.
4. Run the following command to update the open-vm-tools:
yum update vmware-tools
Note It is not necessary to install VMware Tools for the Desktop HealthAnalyzer application, but it will
improve performance if you install VMware Tools in the virtual machine on which the Desktop
HealthAnalyzer application runs.
2.3.7 Changing Virtual Appliance Proxy Settings
If there is a proxy server set up between the virtual appliance and the Internet or vCenter, configure the
virtual appliance to use the proxy server.
To configure the proxy
1. Open the Desktop HealthAnalyzer virtual appliance web console.
2. Click the Network tab.
3. Click Proxy.
4. Select Use a Proxy Server.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 17 of 19
5. Enter the information about the proxy server:
Proxy Server Enter the IP address or fully qualified domain name of the proxy server.
Proxy Port Enter the port used by the proxy server.
6. Click Save Settings.
2.4 Changing Browser Proxy Settings
Your customer might use proxies as part of their corporate firewall. A proxy server acts as an intermediary
between a client computer and the Internet by intercepting requests and contacting the target server to
make the request on behalf of the client. Proxies offer fast access to cached content, filter content, and
hide computers from the Internet to improve security. But, a proxy server will also prevent the Desktop
HealthAnalyzer user interface from accessing the appliance because it does not recognize that the
appliance is running locally.
If you are running the Desktop HealthAnalyzer on a LAN that runs behind a proxy server you probably
need to change the proxy settings before you can display the Desktop HealthAnalyzer user interface. We
recommend that you bypass the proxy by adding in your browser proxy settings the Desktop
HealthAnalyzer virtual appliance to the list of addresses that do not use a proxy. If there is no proxy
server ignore these procedures.
To change proxy settings for Firefox
1. Start your Firefox browser.
2. Click Tools > Options.
3. Click the Network tab.
4. Click Settings.
5. Select Manual proxy configuration if it is not already selected.
6. In the No proxy for text box, type a comma delimiter followed by the appliance IP address.
7. Click OK in each dialog box until you have exited.
To change proxy settings for Internet Explorer
1. Start your Internet Explorer browser.
2. Click Tools > Internet Options.
3. Click the Connections tab.
4. Click LAN Settings.
5. Click Advanced.
6. In the text box labeled Do not use proxy server for addresses beginning with, type a semicolon
delimiter after any existing entries, followed by the appliance IP address.
7. Click OK in each dialog box until you have exited.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 18 of 19
2.5 Displaying the Desktop HealthAnalyzer User Interface
All project setup, data review, analysis and reporting is performed using the Desktop HealthAnalyzer user
interface. The first time you display the user interface you might be asked to agree to the EULA.
To display the Desktop HealthAnalyzer user interface using the Desktop HealthAnalyzer
application
1. Start your browser.
2. Enter the URL as http://localhost:8080.
If you cannot access the user interface, check the browser proxy settings. Also, verify that there is no port
conflict with another application.
To display the Desktop HealthAnalyzer user interface using the Desktop HealthAnalyzer virtual
appliance
1. Start your browser.
2. Enter the URL as http://<virtual appliance IP address>.
The Desktop HealthAnalyzer virtual appliance uses both port 80 and 8080. It is not necessary to specify
the port number with the URL. Port conflicts should not occur because all processes that run are known in
advance, but if you do not want to use default ports 80 or 8080, change the port numbers using the one of
the procedures given in the following sections.
2.5.1 Changing the Port Used for the Desktop HealthAnalyzer User Interface
If there is a port conflict or you do not want to use the default port, you can assign a different port number.
The virtual appliance user interface uses port 8080 by default.
2.5.1.1. Changing the Port Used by the Desktop HealthAnalyzer Application
To change the port used by the Desktop HealthAnalyzer application
1. Start the Desktop HealthAnalyzer Java application.
2. Click the disclosure triangle to the left of App Server or Database Server to reveal the port number.
3. Type the desired port number for Port.
4. Click Connect.
VMware Desktop HealthAnalyzer
Installation Guide
2013 VMware, Inc. All rights reserved.
Page 19 of 19
2.5.1.2. Changing the Port Used by the Virtual Appliance
To change the port used by the Desktop HealthAnalyzer virtual appliance
1. Log in to the virtual appliance.
2. From the virtual appliance command line interface, run the following command as root using your own
password.
sudo -s
3. Edit /usr/share/vha/tomcat/conf/Server.xml and change
Connector port="8080"
to
Connector port="x"
where x is the new port number.
4. Save and close the file.
5. Reboot the virtual appliance.
2.6 Shutting Down Desktop HealthAnalyzer
When you are finished working with Desktop HealthAnalyzer, close the browser and perform a graceful
shutdown. The procedure for shutting down depends on whether you are using the Desktop
HealthAnalyzer application or the virtual appliance.
2.6.1 Shutting Down the Desktop HealthAnalyzer Application
To shut down the Desktop HealthAnalyzer application
Click Quit, or close the Java application.
2.6.2 Shutting Down the Desktop HealthAnalyzer Virtual Appliance
To shut down the Desktop HealthAnalyzer virtual appliance from the web console
1. Open the Desktop HealthAnalyzer virtual appliance web console.
2. Click the System tab (this is default).
3. Click Information (this is default).
4. Click Shutdown.
To shut down the Desktop HealthAnalyzer virtual appliance from the command-line
1. Log in to the virtual appliance.
2. From the virtual appliance command line interface, if you are not already running as the root user, run
the following command as root using your own password:
sudo -s
3. Type shutdown -h now and press Enter.
2.7 Uninstalling Desktop HealthAnalyzer
If Desktop HealthAnalyzer is installed on a customer machine, you must uninstall it at the end of the
engagement. Do not leave it behind at the customer site.