Goliath Performance Monitor Installation Guide

Transcription

Goliath Performance Monitor Installation Guide
Consolidated Monitoring, Analysis and Automated Remediation
For Hybrid IT Infrastructures
Goliath Performance Monitor Installation Guide
v11.6
(v11.6)
Document Date: October 2016
www.goliathtechnologies.com
1
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
Legal Notices
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies Inc. All rights reserved. www.goliathtechnologies.com
Goliath Technologies believes the information in this publication is accurate as of its publication date. The
information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” GOLIATH TECHNOLOGIES MAKES NO
REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS
PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR
A PARTICULAR PURPOSE.
Use, copying, and distribution of any Goliath Technologies software described in this publication requires an
applicable software license.
Linux is a registered trademark of Linus Torvalds.
Windows is a registered trademark of Microsoft Corporation.
VMware, ESX, ESXi, vCenter, and vSphere are either trademarks or registered trademarks of VMware
Corporation.
Citrix, Xen, XenServer, and XenCenter are either trademarks or registered trademarks of Citrix Systems Inc.
All other trademarks and copyrights referred to are the property of their respective owners.
Support, Sales, Renewals and Licensing
 For information on new sales, licensing and support renewals you can email
[email protected]
 For additional information about Goliath Technologies products and services, go to
http://www.goliathtechnologies.com
 For customers and partners with an active support agreement, you can use the support web
board or email [email protected] for information about software patches,
technical documentation, and support programs.
Note: A valid support agreement is necessary to receive new release and software updates.
2
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
Table of Contents
I.
Goliath Performance Monitor Installation Prerequisites .................................................................... 4
II. Deployment Architecture .................................................................................................................... 5
III. Goliath Performance Monitor Server Installation Steps ..................................................................... 6
IV. Configure VMware & XenServer Monitoring .................................................................................... 12
A. Configure VMware vSphere ESX/ESXi API Integration ................................................................ 13
B. Configure Citrix XenServer API Integration ................................................................................. 15
V. Configure Citrix XenApp Monitoring ................................................................................................. 17
A. Configure XenApp Server Monitoring ......................................................................................... 17
VI. Configure Citrix XenDesktop Monitoring .......................................................................................... 21
A. Configure XenDesktop DDC ........................................................................................................ 21
VII. Appendix:
......................................................................................................................... 26
A. Manual Windows Agent Install ................................................................................................... 26
i. Agent Installer ...................................................................................................................... 26
ii. Command Line ...................................................................................................................... 30
B. GPM Linux/Unix Agent Install ..................................................................................................... 31
C. Installing the Goliath Performance Monitor Plug-in for XenCenter ........................................... 32
D. Installing the Goliath Performance Monitor Plug-in for vCenter ............................................... 34
E. Connecting to a Remote SQL Server ........................................................................................... 35
F. Configuring the Inventory Filter .................................................................................................. 44
G. Configuring Citrix XenServer Storage and GPU Monitoring........................................................ 45
i. Enable Citrix XenServer Storage Monitoring ........................................................................ 45
ii. Enable Citrix XenServer NVIDIA Grid Monitoring ................................................................. 46
3
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
I.
Goliath Performance Monitor Installation Prerequisites
Note: On the Goliath Performance Monitor server, if it is running Windows Server 2012, .NET 3.5 needs to be installed
from the Features Wizard as .NET 4.5 is not backwards compatible. GPM can be accessed over the network or WAN to
your local computer.
International users: For installations in environments requiring foreign language versions of
Windows, Goliath requires that the base installation be performed with the English version of
Windows OS. Localization should be done using language packs only, no localized Windows OS
install.
Table 1 - Goliath Performance Monitor System Requirements
Component
Requirement
Goliath Performance
Monitor Server
Database
Firewall
Agent
Windows Mobile
Device/Tablet
NVIDIA GRID vGPU
VMware
ESX/ESXi 4.0 – 6.0
Citrix XenServer
Citrix XenApp
Versions 4.5 – 7.9
 Virtual Machine or Physical Server
 Minimum of 8 vCPU
 Windows Server 2008 R2 – 2016 64 bit
 Minimum of 12 GB RAM
(English version of Windows required for Goliath server)
 Minimum of 25 GB Disk Available
 .NET 3.5 Framework
 Static IP address
 Microsoft SQL 2008 R2 – 2016, including SQL Express
 Microsoft SQL Express 2008 R2 is the embedded database option packaged with the product
Goliath Server
 TCP 80* opened inbound and outbound for web console connection
 TCP 8282* opened inbound for agent connection to agent location
Goliath Intelligent Agent
 TCP 8282* opened outbound for agent connection to the Goliath Server
Hypervisor
 HTTP 443 opened outbound for connection to VMware
 HTTP 80 opened outbound for connection to Citrix XenServer
 TCP 8282* opened outbound for connection to Microsoft Hyper-V
* Default ports listed and can be modified.
 Virtual machine or Physical Server
 ~ 30 MB RAM on Windows Server, Linux/Unix, Mac
 Windows NT SP6a-2016, Unix/Linux & Mac
 ~ 50 MB RAM on Citrix XenDesktop
 0.1% CPU of CPU core
 ~ 80 MB RAM on Citrix XenApp
 1.5 MB on Disk
 Windows 8 – 10
 1.5 MB on Disk
 0.1% CPU
 ~ 30 MB RAM
 NVIDIA GRID K1/GRID K2 card
 Supported on XenServer Hypervisor
 Service account with Read Only Admin Rights





Citrix XenServer Version 5.5 and newer
Root credentials needed
Service Account with Read Only Citrix Admin Rights required for Citrix 7.X Inventory & Metric Collection
Citrix Enterprise and Platinum license required for XenApp 6.5 ICA Channel collection
Windows Server 2008 R2 – 2012 R2 supported
(For foreign language support, ensure Windows installation is English version, then install foreign language pack on top.)
Citrix XenDesktop
XenDesktop 7.0 – 7.9
Microsoft Hyper-V
4



Powershell 2.0 required
Full Microsoft SQL suggested
Windows 7 – 10, 2008 R2 - 2012 R2
(For foreign language support, ensure Windows installation is English version, then install foreign language pack on top.)





Service Account with Read Only Citrix Admin Rights required on Delivery Controller for Versions 7.X
o Please note, if you will also be implementing the Logon Simulator Full Citrix Admin Rights are
required
Powershell 2.0 required
Full Microsoft SQL suggested
Windows Server 2008 R2 – 2016
Administrator-level Credentials to access the Hyper-V Hosts/Servers
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
II.
Deployment Architecture
This diagram shows how the Goliath Performance Monitor fits into the environment.
5
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
III.
Goliath Performance Monitor Server Installation Steps
Before you install Goliath Performance Monitor:
In order to complete the installation of Goliath Performance Monitor (GPM), please ensure you have the
following items available and prepared.
1. Goliath Performance Monitor installation files
2. Your license key
3. Static IP applied to the server hosting Goliath Performance Monitor
4. .NET 3.5 Installed if using Windows Server 2012 R2 as this is not enabled by default
Use the correct version of the install program:
There are two versions of the install program: one for 32-bit versions of Windows
(gpmserver_setup32.exe) and one for 64-bit versions of Windows (gpmserver_setup64.exe)
Install Goliath Performance Monitor
The Setup program will install the Goliath Performance Monitor server on the system you want to be
designated as the Server computer.
1. Exit all programs
2. To install GPM, run the downloaded executable, either ‘gpmserver_setup32.exe’ or
‘gpmserver_setup64.exe’
3. The executable will start the install process and display a Welcome installer
4. Click ‘Next’ to view the End User License Agreement.
Note: It is strongly recommended that you exit all open Windows programs before continuing with
the installation
6
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
5. Read the agreement and if you agree with the terms, select ‘I agree to the terms of this license
agreement’ and click ‘Next’. If you do not agree or do not wish to continue, select ‘I do not agree to
the terms of this license agreement’ and click ‘Cancel’ to exit the installer.
6. Provide the appropriate information to register the product.
7. If you have downloaded Goliath Performance Monitor for an evaluation, enter ‘EVAL’ as the license
key to enable the full featured version for 30 days, or enter your Goliath Performance Monitor
license key provided by Goliath Technologies and select ‘Next’ to continue.
7
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
8. Please verify and or specify the ‘STATIC IP Address’ or ‘DNS Name’ for the Goliath Performance
Monitor Server and Web Interface ‘Console Port’. When finished select ‘Next’ to continue.
9. Once ‘Next’ is selected, the wizard will verify that the Console Port is available. If it is, Goliath
Performance Monitor will then connect to it.
8
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
10. The next step lets you select where to install the Goliath Performance Monitor program. When the
appropriate location is confirmed or entered, click ‘Next’ to continue.
a. On 32-bit versions of Windows, the default location is ‘C:\Program Files\ MonitorIT’.
b. On 64-bit versions of Windows, the default location is ‘C:\Program Files (x86)\MonitorIT’.
Note: It is recommended that you use the default location
11. If this is a full installation with an official license key you will see the following options for configuring
the database settings. If this is an evaluation are you are using the EVAL key, please move to the next
step as this is not applicable.
a. For “Manual Configuration” please see Appendix F for instructions.
9
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
12. Please verify that the following installation settings are correct, if so select ‘Next’ to proceed with the
installation or ‘Back’ to make the appropriate modifications.
13. During the installation process, a progress bar will show the progress of installing the Goliath
Performance Monitor, as seen in the figure below. You will also see the installation of the SQL
Express database installation take place if applicable.
Please Note: At some points during the installation your screen may go blank. This is a normal part of
the installation process.
10
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
14. Once Goliath Performance Monitor and SQL Express, if applicable, are successfully installed the
install program will display a message that the installation is complete. Click ‘Finish’ to exit the install
program.
15. You have successfully installed Goliath Performance Monitor and can now launch the application.
11
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
IV.
Configure VMware & XenServer Monitoring
This section will walk you through the discovery and configuration process for adding VMware vSphere
ESX/ESXi, Citrix XenServer and their subsequent virtualized guest machines and storage to your Goliath
Performance Monitor inventory.
For step-by-step instructions on configuring the Goliath Performance Monitor Plug-in for VMware vCenter
and Citrix XenServer please see Appendix C (XenCenter) and Appendix D (VMware)
Note: It is recommended to begin by configuring your virtual hosts (vSphere ESX/ESXi & XenServer, before
deploying Agents. This will populate your Goliath Performance Monitor inventory with all the relative guest
VMs and storage per host.
12
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
A. Configure VMware vSphere ESX/ESXi API Integration
1. From the ‘First Time Run Wizard’ , select the icon for ‘Virtual Server’
Note: If the ‘First Time Run Wizard’ does not appear, go to ‘Settings’. Under ‘Tools’ select ‘First Time
Run Wizard’
2. Check ‘VMware and then select the ‘Next’ button
NOTE: If you would like to filter in or filter out particular hosts, VMs and or Datastores, please see Appendix
F for instructions on how to use the ‘Inventory Filter’ button.
3. You will be prompted for the connection information on the ‘Provide Credentials’ page:
4. Select ‘Next’ once completed
13
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
5. Select the ‘Hosts’ that you wish to add for monitoring and select ‘Next’
6. Select the option ‘Finish’ and then ‘Next’. Then ‘Finish’ to return back to the ‘Monitor Dashboard’
screen
Note: At this point you may continue to add additional hosts by selecting ‘Repeat Virtual’ to repeat the
wizard steps to add additional servers.
14
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
B. Configure Citrix XenServer API Integration
1. From the ‘First Time Run Wizard’, select the icon for ‘Virtual Server’
2. Check ‘XenServer’ and then select the ‘Next’ button
NOTE: If you would like to filter in or filter out particular hosts, VMs and or Datastores, please see
Appendix F for instructions on how to use the ‘Inventory Filter’ button.
3. You will be prompted for the connection information on the ‘Provide Credentials’ page:
4. Select ‘Next’ once completed
15
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
5. Select the ‘Hosts’ that you wish to add for monitoring and select ‘Next’
6. Select the option ‘Finish’ and then ‘Next’. Then the button ‘Finish’ to return back to the ‘Monitor
Dashboard’ screen
Note: At this point you may continue to add additional hosts by selecting ‘Repeat Virtual’ to repeat
the wizard steps to add additional servers.
Please see Appendix G for configuring Storage and GPU Monitoring on your XenServer hosts.
16
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
V.
Configure Citrix XenApp Monitoring
These steps will take you through the configuration process to begin monitoring Citrix XenApp to automatically
collect XenApp Delivery Group/Farm Inventory, User Session Data, and enable monitoring.
Note: Windows 2003 and 2008 users will need to install the PowerShell feature.
A. Configure XenApp Server Monitoring
1. From the ‘First Time Run Wizard’ , select the icon for ‘XenApp & XenDesktop’
2. Check ‘Citrix XenApp and then select the ‘Next’ button
NOTE: If you would like to filter in or filter out particular delivery groups, folders or servers please see
Appendix F for instructions on how to use the ‘Inventory Filter’ button.
17
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
3. You will be prompted for the connection information on the ‘Configure XenApp Integration’ page.
 Please specify whether or not you are using Citrix XenApp 7.0-7.9. This is important
because we are collecting the Citrix metrics differently than XenApp 4.5-6.5
 Enter the Hostname and IP address for your ZDC/Broker/Delivery Controller
 Provide one-time local admin credentials for the ZDC/Broker/Delivery Controller in order
for the agent files to be copied to the machine and installed
 For XenApp 7.X versions, a Citrix Admin account is required for metric collection on an
ongoing basis. Please enter in the appropriate credentials or check the box if you would
like to use the same credentials as entered above.
4. The ‘Agents’ on the server will be deployed automatically, then click the ‘Next’ button
18
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
5. An ‘Add XenApp Role Servers’ page will appear. If you would like to add in your Role Servers select
‘Add’ and enter in the Role Server information and select ‘Apply’. Repeat this process for all Role
Servers, when finished select ‘Next’.
a. If you do not wish to add any role servers at this time please proceed to step 6.
19
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
While the role servers deploy you will see a loading screen. When they are finished you will see the status
of the deployments. If all were successful select ‘Next’. This will take you to the Finish page, see step 7 for
further instructions.
6. The Save and Finish screen will now appear. To add more items to your inventory select ‘Configure
More’ to repeat steps 1 – 7. Or select ‘Finish’ to return back to the ‘Monitor Dashboard’ screen
20
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
VI.
Configure Citrix XenDesktop Monitoring
These steps will take you through the configuration process to begin monitoring Citrix XenDesktop for the
automatic Broker inventory and user VDI data collection.
Note: Windows 2008 Enterprise users will need to install the PowerShell feature.
A. Configure XenDesktop DDC
1. From the ‘First Time Run Wizard’ , select the icon for ‘XenApp & XenDesktop’
2. Check ‘Citrix XenDesktop and then select the ‘Next’ button
NOTE: If you would like to filter in or filter out particular delivery groups or VDI please see Appendix F for
instructions on how to use the ‘Inventory Filter’ button.
21
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
3. You will be prompted for the connection information on the ‘Configure XenDesktop Integration’
page.
 Please specify whether or not you are using Citrix XenDesktop 7.0-7.9. This is important because
we are collecting the Citrix metrics differently than XenDesktop 5.5
 Enter the Hostname and IP address for your DDC/Delivery Controller
 Provide one-time local admin credentials for the DDC/Delivery Controller in order for the agent
files to be copied to the machine and installed
 For XenDesktop 7.X versions, a Citrix Admin account is required for metric collection on an
ongoing basis. Please enter in the appropriate credentials or check the box if you would like to
use the same credentials as entered above.
22
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
4.
23
The ‘Agent’ will be deployed automatically to the DDC/Delivery Controller defined. Once the
deployment is finished click the ‘Next’ button
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
5.
An ‘Add XenDesktop Role Servers’ page will appear.
 If you would like to add in your Role Servers select ‘Add’ and enter in the appropriate Role Server
information and select ‘Apply’. Repeat this process for all Role Servers, when finished select
‘Next’
 If you don’t want to add any Role Servers at this time you can select ‘Next’.
NOTE: A disclaimer may popup for not adding role servers, select ok to bypass it and continue
While the role servers deploy you will see a loading screen. When they are finished you will see the status
of the deployments. If all were successful select ‘Next’. This will take you to the Finish page, see step 6 for
further instructions.
24
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
6.
25
The Save and Finish screen will now appear. To add more items to your inventory select ‘Configure
More’ to repeat steps 1 – 5. Or select ‘Finish’ to return back to the ‘Monitor Dashboard’ screen
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
VII.
Appendix:
The supplement will guide you step-by-step through the process of manually deploying Windows Agents,
Linux/Unix Agents, configuring the plug-in for Citrix XenCenter & VMware vCenter, and how to connect to a
remote database.
For further documentation please visit our Resource Center
A. Manual Windows Agent Install
Note: This section will provide information on how to manually deploy agents. This process is done one of
two ways: through the ‘Command Line’ or by the ‘Agent Installer’.
i.
Agent Installer
1. Enter the URL: ‘http://GPMServerIPAddress/InstallAgent.exe’ (replacing ‘GPMServerIP Address’ with
the IP address for the Goliath Performance Monitor Server.)
i. Please note, if you are using a custom web port you’ll need to include the port with the
server IP address. For example, http://10.40.50.40:8080/installagent.exe
2. The download wizard will appear, once the download wizard is complete, the installation wizard will
appear
3. Click ‘Next’ and proceed through the wizard

26
If prompted, Click ‘Continue’ on the UAC to continue with install
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016

27
Enter the Goliath Performance Monitor Server IP Address, leave Goliath Performance Monitor
server Port as 8282 if you are using the default port settings. Otherwise, if you have customized
your agent port, please enter the appropriate port number.
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
28

Confirm Install directory and Click ‘Next’ to continue with the installation

Review the install information and Click ‘Next’ to Continue with Install
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016

During the installation you will see a progress bar.

When the installation is complete click ‘Finish’ to complete installation.

29
There is no need to reboot the server. The GPM Agent will automatically attempt connection
to the Goliath Server after about a 30 second delay. Once the GPM Agent connects, it will
automatically register.
 Please Note, if you do not see the agent appear in the Goliath console within 2 minutes
confirm that the Windows firewall is allowing outbound communication for the agent
port.
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
1.
2.
3.
4.
5.
ii. Command Line
Sign into the machine where you would like to install the agent.
Open Windows File Explorer and Navigate to ‘C:\Program Files’
Create a folder called ‘MonitorIT’
Gather the following files from the Goliath Server and copy them into the ‘MonitorIT’ folder. These files
are saved in the install directory of Goliath at …\MonitorIT\Agent\Windows
 AgentEvents.dll
 AgentService.exe
 MISNMP.dll
 RpmAgent.exe
Open command prompt (use RunAsAdmin), and perform the following commands:
cd “C:\Program Files\MonitorIT”
Then AgentService.exe –i arg1 arg2 “C:\Program
Files\MonitorIT\RpmAgent.exe”
Where arg1 is the Goliath Server IP address/FQDN and arg2 is the agent port which allows
communication to Goliath
For example:
AgentService.exe –i 192.168.1.100 8282 “C:\Program
Files\MonitorIT\RpmAgent.exe”
6. Start the Goliath Performance Monitor Agent Service. From the command prompt:
AgentService.exe –s
There is no need to reboot the server. The GPM Agent will automatically attempt connection to the
GPM Server after about a 30 second delay. Once the GPM Agent connects, it will automatically register.
30
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
B. GPM Linux/Unix Agent Install
The Linux/Unix Agent is platform agnostic across all Linux/Unix variations including Solaris, HP-UX, IBM
and AIX.
For Fedora Core, run the following command: yum install java
For Debian Core, run the following command: sudo apt-get install openjdk-6-jre
1. In the ‘GPM Server Install Path > GPM\Bin’ folder, find and copy the two files, 'MITAgent.jar' and
‘MonitorITAgentStart.jar’ to a folder of your choice on the Linux/Unix Server, for example
‘/opt/GPM
2. Open the command prompt from the directory where you copied the files:
nohup /FullyQualifiedPathToTheInstalledJava/bin/java -cp
MonitorITAgentStart.jar AgentStart -s GPMIPAddress -p 82 &
For example, to connect back to GPM server at 192.168.1.100 when the java program is located at
‘/usr/bin’ the installation command would be:
nohup /usr/bin/java -cp MonitorITAgentStart.jar AgentStart -s
192.168.1.100 -p 82 &
3. Put the command in your ‘rc.local’ file or equivalent so the Agent will run on start-up.
4. If your ‘rc.local’ file is located in ‘/etc’ you would perform the following commands from the
console command prompt:
5. Open the ‘rc.local’ file to edit:
vi /etc/rc.local
6. Find the last line in the file and append the install command used earlier by using the ‘vi’ insert
command:
i
7. Using the example from earlier, where the agent files are located at ‘/opt/GPM’ and the GPM
server is located at 192.168.1.100, you would enter:
nohup /usr/bin/java -cp /opt/GPM/MonitorITAgentStart.jar
AgentStart -s 192.168.1.100 -p 82 &
8. Click the Esc key to exit insert mode, and enter the command to save and close:
wq!
31
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
9. Once the Agent is installed, you will be able to subsequently update it remotely from the central
GPM Server display called 'Manage Agents' available in ‘Configure > Servers/Agents & Devices’
C. Installing the Goliath Performance Monitor Plug-in for XenCenter
The Goliath Performance Monitor Plug-in for XenCenter allows you to access Goliath Performance
Monitor from a tab within the Citrix XenCenter client application.
1. Go to the ‘Setup’ page under the ‘Configure’ Tab.
2. Launch the ‘VMware, XenServer, or Hyper-V Environment’ wizard by clicking on the icon
3. Select ‘Citrix XenServer’ under Step 1
4. Select ‘Launch Wizard’
5. Select ‘Next’ past the ‘Add Inventory Page’ and the ‘Licensing Page’ to the last page.
6. Select ‘Install Plug-In to XenCenter’
7.
8.
9.
10.
32
Click ‘save’ to download the ‘xencenter_plugin.zip’ file prompt
You will need to extract the ‘Installer Package’ and run to launch the Setup Wizard
Click ‘Next’ and the End User License agreement opens
Review the agreement and accept the terms to continue. Then click ‘Next’ and the Goliath
Performance Monitor Server page opens.
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
11. Before entering the URL and continuing, open Internet Explorer and load the Goliath Performance
Monitor client web page.
12. Copy the URL from the address bar in IE into the edit field in the Goliath Performance Monitor Plug-in
install screen. We recommend you select the URL with the ‘top.html’ in IE, copy it, and then paste the
URL into the install screen. Make sure the two URLs match.
13. When the two URLs are a correct match, click ‘Next’ and the ‘Ready to Install Goliath Performance
Monitor Plug-in’ page opens.
14. Click ‘Install’ to install the XenCenter Plug-in.
15. When the installation completes, click ‘Finish’ to close the wizard.
Launch XenCenter and you will see a new tab labeled ‘MonitorIT’ which displays the full Goliath
Performance Monitor client within XenCenter.
33
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
D. Installing the Goliath Performance Monitor Plug-in for vCenter
The Goliath Performance Monitor Plug-in for VMware vCenter allows you to access Goliath Performance
Monitor from a tab within the VMware vCenter interface. The plug-in is located within the configuration
wizard for VMware monitoring, but can be performed at any time.
1. Go to the ‘Setup’ page under the ‘Configure’ Tab.
2. Launch the ‘VMware, XenServer, or Hyper-V Environment’ wizard by clicking on the icon
3. Select ‘VMware vSphere’ under Step 1
4. Select ‘Launch Wizard’
5. Select ‘Next’ past the ‘Add Inventory Page’ and the ‘Licensing Page’ to the last page.
6. Select ‘Install Plug-In to vCenter’
7. Confirm the credentials Goliath Performance Monitor will use to install the plug-in to vCenter and then
select ‘Install’
Note: A pop-up box will display any success or failure messages. You can only install the plug-in once
to a particular vCenter and trying to install subsequent times will cause vCenter to return an error.
8. Once the install is completed, a Success dialog will be presented and you can exit the wizard.
Now launch the vSphere Client and connect to vCenter to see the new tab labeled ‘MonitorIT’ which
displays the full Goliath Performance Monitor Client. You can optionally go back to the Home screen and
launch Goliath Performance Monitor in full screen from the Administration section.
34
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
E. Connecting to a Remote SQL Server
In this section, we will review the procedure for connecting to a Remote SQL Server Instance from the
Installer. See below a link to download the Goliath Performance Monitor database file;
https://s3.amazonaws.com/goliathpm/Consulting/Database.zip
Prepare the Database Files
Prior to setting up the new server you will need to ensure that the original Goliath Performance
Monitor SQL Database file is ready to be moved and the new SQL Server is up and running.
1. Stop the MonitorIT service
2. Detach the database and copy it from its current location, to the new SQL Server directory
3. Management Studio is available to connect to the new SQL Server to facilitate setting up the
database.
Stopping the MonitorIT Service
In this section you will learn how to stop the MonitorIT service.
1. Log into the server running SQL Express
2. Open Windows Services by going to ‘Control Panel > System and Security > Administrative
Tools’ and double clicking ‘Services’
35
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
3. The ‘Services’ window will appear, locate and select ‘MonitorIT Server Service’ from the list
4. Click ‘Stop the service’ to the right
NOTE: A ‘Service Control’ window with a progress bar with appear displaying the progress of the service being
stopped. Once finished it will disappear.
36
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
Backing up the old database
Now that the service is stopped we can bring the old SQL Express database to the new SQL Server
1. Open SQL Server Management Studio and Navigate to the ‘MonitorIT’ database
2. Right click the database, and go to ‘Tasks’ and then click ‘Backup’
3. A ‘Backup Database’ window will appear, click the ‘Add’ button at the bottom to choose the backup
destination
37
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
4. A pop up will appear to choose the file name location, once finished select ‘OK’
5. Then selection ‘OK’ on the ‘Backup Database’ window and the database will begin to back up. Note: The
backup process can take anywhere from 5 to 20 minutes to back up depending on the size of the
database.
Configure the new SQL Server
In this section we will cover the steps necessary to attach your Goliath Performance Monitor SQL
Express Database to the new SQL Server Database.
Attach the new database
1. Open SQL Server Management Studio on the new SQL Server
2. Right click on Databases and choose ‘Restore Database..’
38
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
3. The ‘Restore Database’ window will appear, use the drop down menus to select the database
you backed up.
4. Once the database is selected click the ‘Verify Backup Media Button’
5. Select OK to complete attaching the database.
39
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
Connect Goliath Performance Monitor to your SQL Database
In this section we will cover the steps necessary to complete the final steps in the migration process by creating
the necessary DSNs and appropriately modifying the windows service.
NOTE: If Goliath Performance Monitor will be located on a different server, check the security properties
for this database. There should be a Windows User with DBO rights to the database. This information will
be needed for this section if applicable.
Create the Database DSNs
This section will cover the process for creating a connection to the database you have just attached to SQL.
1. Log into your Goliath Performance Monitor Server
2. Open the Run window and type ‘C:\Windows\SysWOW64\odbcad32’
3. Once open, go to the System DSN tab:
Note: If you have an existing DSN for ‘BreakoutRPM’ name, select ‘configure’ and rename it to
‘BreakoutRPM.Old’
40
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
4. Next click ‘Add’ and scroll through the list to select the driver type:
a. For local SQL Server instances: choose ‘SQL Server Native Client’
b. For remote SQL Server instances: choose ‘SQL Server’
5. Name the connection with the information listed below, when finished click ‘Next’
a. Define the Name as ‘BreakoutRPM’
b. Define Description as ‘Primary GPM Database’
c. For ‘Server’ use the dropdown menu to pick the appropriate server name
Note: For the SQL Server, be sure to pick the choice with the name in the correct format of the
server name/instance name of the new database from the dropdown menu.
41
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
6. Keep the default settings to use the Integrated Windows authentication to connect to the
database and select ‘Next’
7. Check the box next to ‘Change the default database to’ and select ‘MonitorIT’ from the
dropdown menu. Click ‘Next’
8. Keep the defaults for the additional options and click ‘Finish
9. Select the ‘Test Data Source’ button to validate the connection. Click ‘OK’ to close all windows
a. If your SQL Server is local, go to Windows Services and restart the MonitorIT Server Service
(Steps to do this are in Section III) and then once it is finished, restart MonitorIT server.
b. If your SQL Server is remote go on to the next section for one last step
Configure the MonitorIT Windows Service for Remote SQL Databases
When connecting to a remote SQL Server, it is necessary to modify the MonitorIT Server Windows
Service with the appropriate logon rights to access the database.
1. Open Windows Services by going to Run and typing ‘Services.msc’
2. Find the ‘MonitorIT Server Service’ in the list, right mouse click, and choose ‘Properties’
3. Go to the ‘Log on’ tab
42
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
4. Specify a Windows account that has DBO rights to the MonitorIT database you attached on the
SQL Server (we recommend using the ‘Browse’ function to ensure the account gets validated).
5. Click ‘Apply’ and then ‘OK’ to close the window
6. Select ‘Start Service’ and then ‘Restart the Service’.
7. Once that is done, restart the Monitor IT Server
8. When the server is back up and running you have completed the configuration!
43
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
F. Configuring the Inventory Filter
This feature of Goliath allows one to filter in or out particular elements from their VMware, XenServer and Citrix
environment. With our API integrations, Goliath is able to populate the entire inventory, but due to the size of your
environment, you may not want to see and monitor all components. In this section, I will explain how to use the
inventory filter.
Inventory Filtering from the ‘First Time Run Wizard’
The INCLUDE section: Select a Server or Group TYPE from the dropdown list. Then type a comma-delimited
list of Server or Group names you want included in Inventory. All other Servers or Groups not listed for the selected
TYPE are ignored. Start each Inventory specification on a new line. Multiple entries of the same or different TYPE
allowed. The wild-card, asterisk character, '*', is accepted as the first or last character in a name.
The EXCLUDE section: Select a Server or Group TYPE from the dropdown list. Then type a comma-delimited
list of Server or Group names you want excluded from Inventory. All other Servers or Groups not listed for the
selected TYPE are included in inventory. Start each Inventory specification on a new line. Multiple entries of the
same or different TYPE allowed. The wild-card, asterisk character, '*', is accepted as the first or last character in a
name.
44
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
Inventory Filtering from the ‘Inventory’ Screen
The INCLUDE section: Select a Server or Group TYPE from the dropdown list. Then type a comma-delimited
list of Server or Group names you want included in Inventory. All other Servers or Groups not listed for the selected
TYPE are ignored. Start each Inventory specification on a new line. Multiple entries of the same or different TYPE
allowed. The wild-card, asterisk character, '*', is accepted as the first or last character in a name.
The EXCLUDE section: Select a Server or Group TYPE from the dropdown list. Then type a comma-delimited
list of Server or Group names you want excluded from Inventory. All other Servers or Groups not listed for the
selected TYPE are included in inventory. Start each Inventory specification on a new line. Multiple entries of the
same or different TYPE allowed. The wild-card, asterisk character, '*', is accepted as the first or last character in a
name.


Once the list of items you’d like to include/exclude are complete, select ok
Find the items in inventory that you’ve chosen to exclude or are items that you haven’t chosen
to include and delete them from inventory
G. Configuring Citrix XenServer Storage and GPU Monitoring
i.
Enable Citrix XenServer Storage Monitoring
In order to start collecting information on your host and VM storage, please make sure the following is
enabled.
1. Log into Citrix XenCenter
2. Select a host where you want to enable/confirm storage metric collection
3. Click the ‘Performance’ tab
4. Select ‘Actions’ and then ‘New Graph’
5. Name the graph ‘Storage Performance’, sort the list by type (Z->A), and select all datasources with
a type of ‘Storage’
6. When finished, select ‘Save’
45
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016
7. Repeat these steps for all of the hosts that you will be monitoring in Goliath Performance Monitor
ii.
Enable Citrix XenServer NVIDIA Grid Monitoring
In order to start collecting information on your host and VM storage, please make sure the following is
enabled.
1. Log into Citrix XenCenter
2. Select a host where you want to enable/confirm NVIDIA Grid metric collection
3. Click the ‘Performance’ tab
4. Select ‘Actions’ and then ‘New Graph’
5. Name the graph ‘NVIDIA Performance’, sort the list by type (A->Z), and select all datasources with
a type of ‘GPU’
6. When finished, select ‘Save’
7. Repeat these steps for all of the hosts that you will be monitoring in Goliath Performance Monitor
46
Goliath Performance Monitor v11.6 Installation Guide
Copyright © 2016 Goliath Technologies
Version 11.6 – October 2016