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