simplify monitoring Consolidated Monitoring, Analysis and Automated Remediation For Hybrid IT Infrastructures

Transcription

1 simplify monitoring Consolidated Monitoring, Analysis and Automated Remediation For Hybrid IT Infrastructures Simplify Monitoring Installation Guide 11.4 (v11.4) Document Date: February

2 Legal Notices Simplify Monitoring s Configuration for Citrix XenApp Copyright 2013 Tricerat, Inc. All rights reserved. Tricerat 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. TRICERAT, INC. 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 Tricerat 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. Java is a registered trademark of Oracle Corporation. VMware, vcenter, and vsphere are either trademarks or registered trademarks of VMware Corporation. Citrix, NetScaler, Xen, XenServer, XenApp, XenDesktop 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. 2

3 Support, Sales, Renewals and Licensing Ø For information on new sales, licensing and support renewals you can Ø For additional information about Tricerat products and services, go to Ø To license and register this product, go to Ø For customers and partners with an active support agreement, you can use the support web board or for information about software patches, technical documentation, and support programs. Note: A valid support agreement is necessary to receive new release and software updates. 3

4 Table of Contents I. Deployment Architecture... 5 II. Simplify Monitoring Installation Prerequisites... Error! Bookmark not defined. III. Simplify Monitoring Server Installation Steps... 6 IV. Configure VMware & XenServer Monitoring... 9 A. Configure VMware vsphere ESX/ESXi API Integration B. Configure Citrix XenServer API Integration V. Configure Citrix XenApp Monitoring A. Configure XenApp Server VI. Configure Citrix XenDesktop Monitoring A. Configure XenDesktop DDC VII. Appendix: A. Manual Windows Agent Install Manual Agent Installer B. Command Line C. SM Linux/Unix Agent Install Install Steps D. Installing the Simplify Monitoring Plug- in for XenCenter E. Installing the Simplify Monitoring Plug- in for vcenter F. Connecting to a Remote SQL Server Create the Database DSNs

5 I. Deployment Architecture This diagram shows how the Simplify Monitoring fits into the environment. 5

6 II. Simplify Monitoring Installation Prerequisites Note: On Windows Server 2012,.NET 3.5 SP1 needs to be installed from the Features Wizard as.net 4.5 is not backwards compatible. SM can be accessed over the network or WAN to your local computer. Table 1 - Simplify Monitoring System Requirements Simplify Monitoring Server Platform: Virtual Machine or Physical Server OS: Windows Server 2008 R2 2012R2 32bit/64bit Network: Static IP Address vcpu: Minimum of 4 vcpus Memory: Minimum of 8 GB Memory Disk: 25 GB of Disk Space Dependencies:.NET 3.5 SP1 Firewall Database Agent VMware Citrix XenServer Citrix XenApp & XenDesktop Simplify Monitoring Server: TCP ports 80 & 82 both must be open inbound; and port 80 must be enabled outbound for remote access to the console. Systems with Agents Deployed: TCP port 82 must be open outbound Note: These ports can be changed from the default as needed Embedded: Microsoft SQL 2008 R2 Express Version: Microsoft SQL from , including SQL Express *Microsoft SQL 2008 R2 Express database is the embedded database included with Simplify Monitoring Note: Environments larger than 150 monitored devices require Microsoft SQL Server. Customers Evaluating with XenApp & XenDesktop should use full Microsoft SQL. Platform: Virtual Machine or Physical Server OS: Windows NT SP6a and Newer; Unix/Linux, and Mac Performance Specs: 0.1% CPU, 1.5 MB size on Disk, ~24 MB RAM/~50 MB RAM on XenApp API Integration: Service account with admin rights VMware ESX/ESXi Version: 4.0 to 5.5 API Integration: Root account needed XenServer Version: 5.5 and newer Citrix Versions: XenApp XenDesktop XenApp/XenDesktop 7.x:.Net 3.5 SP1 and Service Account with Citrix Admin Rights for the Simplify Monitoring Agent required on the broker XenApp: Powershell 2.0 needed. For XenApp 7.x.NET 3.5 needed on all Windows 2012 session hosts. XenDesktop VDI: Powershell 2.0 needs to be installed. For XenDesktop 7.x.NET 3.5 needed on all Windows 8 10 Virtual Desktops. Note: Full Microsoft SQL suggested for XenApp & XenDesktop deployments 6

7 III. Simplify Monitoring Server Installation Steps Before you install Simplify Monitoring: In order to complete the installation of Simplify Monitoring (SM), please ensure you have the following items available and prepared. 1. Simplify Monitoring installation files 2. Your license key 3. Static IP applied to the server hosting Simplify Monitoring Use the correct version of the install program: There are two versions of the install program: one for 32- bit versions of Windows (SM_setup32.exe) and one for 64- bit versions of Windows (SM_setup64.exe) Install Simplify Monitoring The Setup program will install the Simplify Monitoring server on the system you want to be designated as the Server computer. 1. Exit all programs 2. To install SM, run the downloaded executable, either SM_setup32.exe or SM_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 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. You are then prompted to provide your information to register the product. 7. Enter your Simplify Monitoring license key provided by Tricerat, or if you have downloaded Simplify Monitoring for evaluation, enter EVAL as the license key to enable the full featured version for 30 days and select Next to continue. Note: If you enter a valid license key, you will be given several options to configure your database. (Please refer to Appendix E to configure an external or remote SQL database) If you are performing an evaluation of the product, it automatically connects to the embedded SQL Express 2008 R2 database. 8. Please verify the STATIC IP Address or DNS Name for the Simplify Monitoring Server and Console Port select Next to continue. 9. Once Next is selected, the wizard will verify that the Console Port is available. It is, Simplify Monitoring will then connect to it. 7

8 10. The next step lets you select where to install the Simplify Monitoring program. On 32- bit versions of Windows, the default location is C:\Program Files\ Simplify Monitoring. On 64- bit versions of Windows, the default location is C:\Program Files (x86)\simplify Monitoring. When the location is entered, click Next to continue. Note: It is recommended that you use the default location. 11. Now please verify that the following installation settings are correct, if so select the Next to proceed with the installation. 12. During the first part of the installation process, a progress bar will show the progress of installing the Simplify Monitoring, as seen in the figure below. 13. Once Simplify Monitoring is successfully installed, the remaining database components will be installed and configured. At some points during these additional installations, your screen may go blank. This is a normal part of the installation process. Finally, the install program will display a message that the installation is complete. Click Finish to exit the install program 14. You have successfully installed Simplify Monitoring and can now launch the application. 8

9 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 Simplify Monitoring inventory. For step- by- step instructions on configuring the Simplify Monitoring 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 Simplify Monitoring inventory with all the relative guest VMs and storage per host. 9

10 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 3. You will be prompted for the connection information on the Provide Credentials page: 4. Select Next once completed 10

11 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. 11

12 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 3. You will be prompted for the connection information on the Provide Credentials page: 4. Select Next once completed 12

13 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. 13

14 V. Configure Citrix XenApp Monitoring These steps will take you through the configuration process to begin monitoring Citrix XenApp to automatically collect XenApp Farm Inventory, User Session Data, and enable Health Check Monitoring. Note: Windows 2003 and 2008 users will need to install the PowerShell feature. A. Configure XenApp Server 1. From the First Time Run Wizard, select the icon for XenApp & XenDesktop 2. Check Citrix XenApp and then select the Next button 3. You will be prompted for the connection information on the Configure XenApp Integration page: 14

15 4. The Agents on the server will be deployed automatically, then click the Next button 15

16 5. A Configure XenApp Session Host Monitoring page will appear, select No for the Provisioning Server then the Next button 6. Click the Next button, the credentials for the XenApp will be saved from earlier 7. Select the Servers that you wish to add for monitoring and select Next 8. Click the Next button once the Servers are finished installing 9. Select the option Finish to return back to the Monitor Dashboard screen 16

17 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. For XenDesktop 7.x, if the DDC is running Windows server 2012 enable.net 3.5 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 3. You will be prompted for the connection information on the Configure XenDesktop Integration page: 17

18 4. The Agents on the server will be deployed, then click the Next button 5. A Configure XenDesktop Session Host Monitoring page will appear, select No for the Provisioning Server or persistent images then the Next button 6. Click the Next button, the credentials for the XenDesktop will be saved from earlier 18

19 7. Select the Servers that you wish to add for monitoring and select Next 8. Click the Next button once the Servers are finished installing 9. Select the option Finish to return back to the Monitor Dashboard screen 19

20 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. 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. Manual Agent Installer 1. Enter the URL: (replacing SMServerIP Address with the IP address for the Simplify Monitoring Server) 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 If prompted, Click Continue on the UAC to continue with install Enter the Simplify Monitoring Server IP Address, leave Simplify Monitoring server Port as 82 if using defaults. You can also specify a name the Agent should use for this server (This is Optional) Confirm Install directory and Click Next to continue with the installation Review the install information and Click Next to Continue with Install A loading screen will appear while it is installing Click Finish to complete Installation There is no need to reboot the server. The SM Agent will automatically attempt connection to the SM Server after about a 30 second delay. Once the SM Agent connects, it will automatically register. B. Command Line 1. Open command prompt (use RunAsAdmin on Windows 2008), and perform the following commands: 20 cd C:\Program Files\Simplify Monitoring : Then AgentService.exe i arg1 82 C:\Program Files\Simplify Monitoring\RpmAgent.exe arg2 Arg1: Simplify Monitoring Server IP address (e.g ) so the Agent knows where to connect; 82: This is the default port on which Simplify Monitoring listens for Agents. Note: If you have changed the port Simplify Monitoring uses by default, then make sure that

21 is reflected here. Arg2, OPTIONAL: The name that the Agent uses for this server/workstation when it connects and registers with the SM Server. For example, AgentService.exe i C:\Program Files\ Simplify Monitoring\RpmAgent.exe 2. Start the Simplify Monitoring Agent Service. From the command prompt: AgentService.exe s There is no need to reboot the server. The SM Agent will automatically attempt connection to the SM Server after about a 30 second delay. Once the SM Agent connects, it will automatically register. Note: If you have multiple farms, you will need to deploy an agent to each collector C. SM 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 21

22 Install Steps 1. In the SM Server Install Path > SM\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/sm 2. Open the command prompt from the directory where you copied the files: nohup /FullyQualifiedPathToTheInstalledJava/bin/java -cp MonitorITAgentStart.jar AgentStart -s SMIPAddress -p 82 & For example, to connect back to SM server at when the java program is located at /usr/bin the installation command would be: nohup /usr/bin/java -cp MonitorITAgentStart.jar AgentStart -s 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/sm and the SM server is located at , you would enter: nohup /usr/bin/java -cp /opt/sm/monitoritagentstart.jar AgentStart -s p 82 & 8. Click the Esc key to exit insert mode, and enter the command to save and close: wq! 9. Once the Agent is installed, you will be able to subsequently update it remotely from the central SM Server display called 'Manage Agents' available in Configure > Servers/Agents & Devices D. Installing the Simplify Monitoring Plug- in for XenCenter 22

23 The Simplify Monitoring Plug- in for XenCenter allows you to access Simplify Monitoring 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. Click save to download the xencenter_plugin.zip file prompt 8. You will need to extract the Installer Package and run to launch the Setup Wizard 9. Click Next and the End User License agreement opens 10. Review the agreement and accept the terms to continue. Then click Next and the Simplify Monitoring Server page opens. 11. Before entering the URL and continuing, open Internet Explorer and load the Simplify Monitoring client web page. 12. Copy the URL from the address bar in IE into the edit field in the Simplify Monitoring 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. 23

24 13. When the two URLs are a correct match, click Next and the Ready to Install Simplify Monitoring 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 Simplify Monitoring client within XenCenter. E. Installing the Simplify Monitoring Plug- in for vcenter The Simplify Monitoring Plug- in for VMware vcenter allows you to access Simplify Monitoring 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 Simplify Monitoring 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 Simplify Monitoring which displays the full Simplify Monitoring Client. You can optionally go back to the Home screen and launch Simplify Monitoring in full screen from the Administration section. F. 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 Simplify Monitoring database file; A. Attach the database 24

25 1. Move the MonitorIT.mdf file to the SQL Server Data repository. 2. Run SQL Server Management Studio as Administrator 3. Right click on Databases and choose Attach 4. Choose Add on the Attach Database window 25

26 5. Locate MonitorIT.mdf in the file tree and select OK 6. In the Bottom Box labeled MonitorIT Database Details, just below where the MonitorIT.mdf file has just been listed, select the log file MonitorIT_log.LDF, and click the Remove button at 26

27 the bottom right. Note: We are removing this log file because we want SQL to create a new one. 7. Select OK to complete attaching the database. B. Connect Simplify Monitoring to your SQL Database In this section we will cover the steps necessary to complete the final steps in the migration process by creating 27

28 the necessary DSNs and appropriately modifying the windows service. NOTE: If Simplify Monitoring 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 Simplify Monitoring Server 2. Go to Control Panel\System and Security\Administrative Tools and double click Data Sources (ODBC)(32- bit) 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 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 28

29 5. Name the connection with the information listed below, when finished click Next a. Define the Name as BreakoutRPM b. Define Description as Primary SM 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. 6. Keep the default settings to use the Integrated Windows authentication to connect to the database and select Next 29

30 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 C. Configure the Simplify Monitoring Windows Service for Remote SQL Databases 30

31 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: Control Panel > System and Security > Administrative Tools > Services 2. Find the MonitorIT Server Service in the list, right mouse click, and choose Properties 3. Go to the Log on tab 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! 31