Data Center Real User Monitoring

Transcription

1 Data Center Real User Monitoring Dynatrace Enterprise Portal Administration Guide Release 12.3

2 Please direct questions about DC RUM or comments on this document to: Customer Support Copyright 2014 Compuware Corporation. All rights reserved. Unpublished rights reserved under the Copyright Laws of the United States. U.S. GOVERNMENT RIGHTS-Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Compuware Corporation license agreement and as provided in DFARS (a) and (a) (1995), DFARS (c)(1)(ii) (OCT 1988), FAR (a) (1995), FAR , or FAR (ALT III), as applicable. Compuware Corporation. This product contains confidential information and trade secrets of Compuware Corporation. Disclosure is prohibited without the prior express written permission of Compuware Corporation. Use of this product is subject to the terms and conditions of the user's License Agreement with Compuware Corporation. Documentation may only be reproduced by Licensee for internal use. The content of this document may not be altered, modified or changed without the express written consent of Compuware Corporation. Compuware Corporation may change the content specified herein at any time, with or without notice. All current Compuware Corporation product documentation can be found at Compuware, FrontLine, Network Monitoring, Enterprise Synthetic, Server Monitoring, Dynatrace Network Analyzer, Dynatrace, VantageView, Dynatrace, Real-User Monitoring First Mile, and Dynatrace Performance Network are trademarks or registered trademarks of Compuware Corporation. Cisco is a trademark or registered trademark of Cisco Systems, Inc. Internet Explorer, Outlook, SQL Server, Windows, Windows Server, and Windows Vista are trademarks or registered trademarks of Microsoft Corporation. Firefox is a trademark or registered trademark of Mozilla Foundation. Red Hat and Red Hat Enterprise Linux are trademarks or registered trademarks of Red Hat, Inc. J2EE, Java, and JRE are trademarks or registered trademarks of Oracle Corporation. VMware is a trademark or registered trademark of VMware, Inc. SAP and SAP R/3 are trademarks or registered trademarks of SAP AG. Adobe Reader is a registered trademark of Adobe Systems Incorporated in the United States and/or other countries. All other company and product names are trademarks or registered trademarks of their respective owners. Build: December 8, 2014, 20:04

3 Contents Contents Introduction Who Should Read This Guide Organization of This Guide Related Publications Customer Support Information Information to Provide to Customer Support Documentation Conventions Chapter 1 Dynatrace Enterprise Portal Administration Overview Access the Dynatrace Enterprise Portal The Portal Interface Session Timeout Configuration Configure SSL for the Dynatrace Enterprise Portal Change the JVM Settings Assign Rights to Pages Localized Languages in the Portal Chapter 2 Report Server Management in the Portal Chapter 3 Portal Control Panel Add Dashboards and Pages Page Types and Type Settings Distribution Page Look and Feel Edit Page Settings Create a Page in the Control Panel Create a Page That Does Not Require a Login Create a Banner Import Dashboard Pages Export Dashboard Pages Manage Dashboards and Pages Portal Integrations - Server Client Settings User Management Features in the Dynatrace Enterprise Portal

4 Contents Add or Import Users Add a Local User Import LDAP Users Deactivate and Delete Users Reset a Locked-out User Create User Groups Import LDAP Groups Roles Overview Assign Roles to Users and User Groups Create New Roles Roles Page Actions Menu Portal Server Administration Chapter 4 Enterprise Synthetic in the Portal Configure Enterprise Synthetic in the Portal Enterprise Synthetic Agent Health Portlet Configuration Enterprise Synthetic Transaction Health Portlet Configuration Chapter 5 VantageView In the Portal Configure a VantageView Connection in the Portal Glossary Index

5 INTRODUCTION Who Should Read This Guide This manual is written for the system administrator, application manager, or any other individual who installs and administers Dynatrace Enterprise Portal. Organization of This Guide This guide provides a reference for using the dashboards and portlets for Dynatrace. It includes the following chapters: Dynatrace Enterprise Portal Administration Overview [p. 9] Describes Administration in the Portal. Report Server Management in the Portal [p. 17] Discusses connecting to servers. Portal Control Panel [p. 19] Describes using the Control Panel. Enterprise Synthetic in the Portal [p. 33] Describes how to configure Enterprise Syntheticfor integration. VantageView In the Portal [p. 37] Describes how to configure VantageView for integration. Related Publications Online help is accessible from the interface menu and by pressing [F1]. The following documents are provided in PDF format: Data Center Real User MonitoringSystem Administration Guide Contains the following information: Installation process for Data Center Real User Monitoring. System requirements and configuration. Report server integration, aggregation, and administration. 5

6 Introduction Backup and recovery. Data Center Real User Monitoring Central Analysis Server User Guide Contains the following information: Logging into the server and accessing reports. Configuring the server. Using data views. Business Service Management Release Notes This document contains information about the release: New feature descriptions List of supported platforms, databases, hardware, adaptors, and browsers Known issues Troubleshooting information APM Customer Support contact information Business Service Management Installation Guide Contains the following information: Preparation for Business Service Management installation, including requirements for databases Installation, upgrade, and maintenance procedures Post-installation procedures and checks It also includes notes on typical system configurations, which may helpful in assessing your setup and installation. Customer Support Information Dynatrace Community For product information, go to and click Support. You can review frequently asked questions, access the training resources in the APM University, and post a question or comment to the product forums. You must register and log in to access the Community. Corporate Website To access the corporate website, go to The Dynatrace site provides a variety of product and support information. Information to Provide to Customer Support Provide Customer Support with as much information as possible about your environment and the circumstances that led to the difficulty. Please be ready to provide: 6

7 Introduction Your client number. This number is assigned to you by Compuware and is recorded on your sales contract. The name, release (version), and build number of the product and its components. This information is displayed when you select the About command from your product's Help menu. The name and release are also on the covers of the product documentation. Environment information, such as the operating system and release (including service pack level) on which the product is installed, memory, hardware/network specifications, and the names and releases of other applications that were running. Problem description, including screen shots. Exact error messages, if any (screen shots recommended). Whether the problem is reproducible. If yes, sequence of steps to reproduce the problem. If not, a description of the actions taken before the problem occurred. A description of the actions that may have been taken to recover from the difficulty, and their results. Log file(s) from the component(s) affected by the problem. Compuware values your comments and suggestions about our products and documentation. Your feedback is very important to us. If you have questions or suggestions for improvement, let us know. Documentation Conventions The following font conventions are used throughout documentation: This font Bold Citation Documentation Conventions [p. 7] Fixed width Fixed width bold Fixed width italic Menu Item Screen Code block Indicates Terms, commands, and references to names of screen controls and user interface elements. Emphasized text, inline citations, titles of external books or articles. Links to Internet resources and linked references to titles in documentation. Cited contents of text files, inline examples of code, command line inputs or system outputs. Also file and path names. User input in console commands. Place holders for values of strings, for example as in the command: cd directory_name Menu items. Text screen shots. Blocks of code or fragments of text files. 7

8 Introduction 8

9 CHAPTER 1 Dynatrace Enterprise Portal Administration Overview This chapter describes the administrative tasks for the Dynatrace Enterprise Portal. After you have installed and logged onto the Dynatrace Enterprise Portal (Access the Dynatrace Enterprise Portal [p. 10]) as an administrator you will complete the following administrative tasks to get up and running. Optional tasks are listed as well. Connect to the CAS You must configure the Portal to work with Central Analysis Server (CAS) which provides real-time access to information about performance and usage of key business applications. To use the Applications dashboard pages and Data Mining Interface Simple and Advance Charts and Table portlets, at least one CAS report server must be defined. Click Administration Manage Report Servers to easily connect to the CAS. Integrate With BSM This lets you integrate the Portal with Business Service Management (BSM). This optional connection provides an open, flexible framework for integrating performance, third-party, analytics, service desk, and business data. It enables you to use the Operations and Executive dashboard pages, and access to health reports and notifications. To configure a BSM connection, click Administration Control Panel Integrations BSM Server Lines. Click Administration Business Service Management to access BSM notification and reconciliation options, as well as diagnostic information to inform you about the health of your system. After you validate your connection with CAS, and BSM (if you chose to integrate with BSM), set up your users and security. Add Users and Set up Security The Central Security Server (CSS), added in release 12.0, provides a single point of access for user management and security for Data Center Real User Monitoring, Business Service 9

10 Chapter 1 Dynatrace Enterprise Portal Administration Overview Management the Dynatrace Enterprise Portal and optionally for Enterprise Synthetic. A new installation of DC RUM was integrated with the CSS during the installation process. Select an authentication method and add users and user groups in the CSS Console. Limited CSS functionality is available from the Portal. As a system administrator, you can manually add user accounts. You can also use LDAP authentication, where authentication takes place when users log into the system with their network ID and password. Optional Administration To use Enterprise Synthetic in the Portal to monitor, capture, report and pinpoint the cause of application performance problems, it must be installed and running on your machine and enabled in the Portal. To use VantageView within the Portal to view data from the suite of tools, real-time status and historical information of clients, servers, networks, and 3rd-party tools, it must be installed and running. After, you can configure it in the Portal. The Control Panel is used solely for advanced configuration and customization of the Portal. Click Administration Control Panel to access the Control Panel to configure web content, settings, monitoring, plugins, and server administration. To view business information output from the Service Model in the Portal click Administration Service Model. The Service Model functions as the engine that transforms events and messages coming to it into relevant business information that can be used to assess the impact on the quality of business services. Access the Dynatrace Enterprise Portal Access the Portal via a supported browser. Refer to the Release Notes for supported browsers. Prerequisites: The CSS is installed and running. The CAS server is configured and running to view or configure dashboard pages within the portal. Do one of the following: Use a web browser to go to the Dynatrace server. Enter the following URL in your browser s main address field: For a non-secure connection enter where <Portal_host> is the machine on which the Portal Service Model system is installed, and <server_port> (usually 8080) is the configured Web server port. For a secure connection, after you install the SSL certificate, enter where <Portal_host> is the machine on which the Service Model is installed, <DNS> is the domain name system (for example,.clients.nasa.cpwr.corp), and <server_port> (usually 443) is the configured Web server port. The SSL certificate is tied to the exact name. Configure SSL for the Dynatrace Enterprise Portal [p. 13] 10

11 Chapter 1 Dynatrace Enterprise Portal Administration Overview Log in to the Portal by providing the user name and password in response to the prompt. If you successfully log in, the menu options display. If you are not granted access, a message indicates that the authentication failed. If there is no activity within the web browser for 60 minutes, the session times out. You must log in again. The default screen following the login screen offers top-level menu choices. The multi-level menus provide accelerated access to the various views of the Portal. A common starting point is the Application Health Status page, which displays applications with performance problems, and the impact of these problems on business. The Portal Interface This topic discusses all of the options available from the main menu bar for easy reference. The CAS Application Health Status Report When you first open the Portal, the CAS Application Health Status report displays by default. The Application Health Status(AHS) report displays data from all user experience measurement sources like probes, browser instrumentation, and synthetic sources. This data combines to display a single integrated view of end-user experience for all monitored applications. For information click the CAS help link in the upper right. Dashboards Manage Pages Add a page to, or delete a page from, a dashboard. Applications The Application Health Status dashboards are available only if you migrate them from a Portal version earlier than The dashboards show critical application health, business impact, and fault domain information. Analysis Server Opens the Central Analysis Server (CAS). The CAS provides real-time information about performance and key business applications usage. It monitors user session, application, and server performance in different configurations to identify when and where problems occur, and how to address them. 11

12 Chapter 1 Dynatrace Enterprise Portal Administration Overview My Pages This is available on the toolbar only if you create public or private pages in the Control Panel. Tools Toggle Editing Edit and reposition portlets on a page. Add Content Provides a list of available portlets in the Content Library that can be inserted on a page. Print Generates a PDF document of the screen. Change Page Layout Opens the Manage Page Layout page. Edit Dynagrid Layout Opens the Dynagrid page. Use this to modify the page. This menu item is available only if the current page is using the Dynagrid Layout. My Profile Opens the profile page in the Control Panel, which contains information for the active user. Add personal information such as your organization, user groups, addresses, and custom fields. Set as Homepage Sets the current page as the home page of the currently logged-in user. Administration Control Panel Use this for advanced configuration and to customize the Portal. Manage Report Servers Opens the Report Server Management in the Portal [p. 17] 12

13 Session Timeout Configuration A warning displays when the current session is about to expire. A yellow message appears one minute before expiration, and a red message appears after the page expires. When you view pages in a dashboard a session is established. This allows the server to hold information such as login credentials, about the client currently accessing dashboard pages. If the session is inactive, it ends and the information is lost and the user must log in again. A timeout occurs so the server resources are not used up as multiple clients are connected. By default, the session timeout is 60 minutes. If necessary, configure the session timeout: 1. Go to C:\Program Files\Compuware\Vantage\tomcat\webapps\ROOT\WEB-INF\web.xml. 2. Look for the entry near the bottom of the file: <session-config> <session-timeout>60</session-timeout> </session-config> 3. Change the timeout value. This value is in minutes. 4. Restart the web server. Configure SSL for the Dynatrace Enterprise Portal To use HTTPS operations on the Dynatrace Enterprise Portal, you must generate unique SSL keys and certificates and configure the Portal application server. If you are using Business Service Management, you can also use these instructions to configure SSL for its server components. Generating Keys and Certificates 1. Stop the Dynatrace Enterprise Portal service. 2. Open a command prompt on the server where the Portal is installed. 3. Run the appropriate command for your system: Windows set PATH=Portal_Home\jre\bin;%PATH% UNIX export PATH=Portal_Home/jre/bin;$PATH 4. Create a private key within an existing or new keystore. Execute the following: keytool -genkeypair -keyalg rsa -keystore keystorename -storepass [keystorepassword] -alias [my_new_key] NOTE If you are using Java 1.6, use -genkeypair for -genkey. If your SSL certificate must be a certain size, add the following command to the keytool line of code: -keysize [size you need] Chapter 1 Dynatrace Enterprise Portal Administration Overview 13

14 Chapter 1 Dynatrace Enterprise Portal Administration Overview To protect the new private key by its own keypassword within the keystore, you have to add the keypass option. If you don't use the keypass option, the keystore password is used to protect the private key. To delete a key password (which is not possible with keytool), copy the keystore password to the key password. To use the key as a client certificate, use RSA as a key algorithm, instead of default DSA, because many servers only accept RSA client certificates. 5. Generate a CSR. keytool -certreq -alias my_new_key (from step 4) -keystore keystorename(from step 4) -storepass keystorepassword(from step 4) -file my_new.csr -validity[number of days] 6. Send you CSR to a certificate authority. 7. When you receive your files back from the CA, export files to Base64 X509 format, if your CA didn't provide it in that format. a. Right-click on the certificate chain file (for example, newcert.p7b) and select Open. The certificate should open in Window's Certificates tool. b. In the left pane, expand Certificates - Current User Certificates. You will see two certificates in the right pane, one above the other, first the root certificate and then the web server. c. Export each certificate into Base64 X509 by right-clicking on each certificate and selecting All Tasks Export. d. Click Next. e. Enter the name of the exported file, for example, root.cer for the root certificate. Click Finish. f. Repeat for the web server certificate (webserver.cer). 8. Open root.cer and webserver.cer in Notepad. Append all contents from each file (Control-A) and merge both into a new text file. Make sure to merge them in the same order they were opened: root followed by webserver. 9. Save the merged file as chain.txt. Import files 10. Import chain.txt into your keystore file. keytool -import -alias root keystore keystorename(from step 4) storepass keystorepassword (from step 4) -trustcacerts -file chain.txt 11. Import webserver.cer. keytool -import -alias tomcat keystore keystorename (from step 4) storepass keystorepassword (from step 4) -trustcacerts -file webserver.cer Configure Tomcat 12. Using a text editor, open server.xml, located in PORTAL_HOME\Dynatrace Enterprise Portal\Tomcat\Conf\. 13. Add the attribute keystorefile that specifies the full path to the keystore file created. Note that the values are case-sensitive. Uncomment the XML element. <Connector port="8443" protocol="http/1.1" SSLEnabled="true" maxthreads="150" scheme="https" secure="true" 14

15 Chapter 1 Dynatrace Enterprise Portal Administration Overview clientauth="false" sslprotocol="tls" emptysessionpath="true" keystorepass = [keystorepassword] (from step 4) keystorefile="[keystorename and location]"(from step 4) /> 14. Optional: To force the server to only accept strong ciphers, add the following attribute to the SSL connector: ciphers="ssl_rsa_with_rc4_128_md5,ssl_rsa_with_rc4_128_sha,tls_rsa_with_aes_128_cbc_sha, TLS_DHE_RSA_WITH_AES_128_CBC_SHA,TLS_DHE_DSS_WITH_AES_128_CBC_SHA, SSL_RSA_WITH_3DES_EDE_CBC_SHA,SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA, SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA" 15. Restart the Dynatrace Enterprise Portal service. To browse to the Portal site, use the fully qualified name (FQN) of the web server in the URL. When you created the keystore, you specified the FQN of the web server, so the SSL certificate is tied to that exact name. Change the JVM Settings These instructions describe adjusting the Java Virtual Machine (JVM) settings. The installer initially allocates 50% of the available memory for the portal, up to 4GB. If you must adjust this for your site follow these instructions. For Windows, edit the registry by going to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\TomcatWebserver120\Parameters\Java Double-click on the JvmMx property and set it to the preferred value. For Solaris or Linux, navigate to the /opt/compuware/enterprise_portal/tomcat/bin/setenv.sh file and find the JAVA_OPTS variable and make the following modifications: JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF8 -Djava.net.preferIPv4Stack =true -Xmx1024m:-XXMaxPermSize=256m-Dvantage.controller=liferay -DJSDT.SocketFactory=com.proxima.centauri.messaging.jsdt.HttpsSocketFactory -Dorg.ops4j.pax.logging.DefaultServiceLog.level=ERROR" Assign Rights to Pages If you have Administrator or Power User permission, you can assign rights to users to delete, update or view a page. 15

16 Chapter 1 Dynatrace Enterprise Portal Administration Overview The User Access and Security Overview provides a single point of access for user management and security. Use this to assign rights to users or user groups. 1. Click Dashboards Manage Pages. The Manage Dashboard Pages dialog box appears. 2. Select a dashboard from the list. 3. Select a page and right-click. 4. Select Assign Rights. You assign rights to a user so the user can do the following: Delete a page Update a page (make modifications) View a page without making modifications If you do not select a checkbox, rights are inherited from the assigned role or user group membership. 5. Click Save. Localized Languages in the Portal Pages in the Portal are localized in four languages: English Japanese Korean Chinese simplified Browser language settings are checked on login and retained. Changes committed after login do not affect the current session. English is the default If the browser uses an unsupported language. 16

17 CHAPTER 2 Report Server Management in the Portal Use the Report Server Manager to define and configure servers. Click Administration Manage Report Servers. You can add multiple report servers), however there must be one default server. Information for the default server is displayed when you open the Report Server Manager and includes the product and connection status information. Servers added in previous versions remain on the definitions list. The Portal 12.3 and later supports CAS release 12.3 and later. These must be installed on the same machine. To add a new report definition, click Add and type the new information into the fields provided. NOTE Fields in the Report Server Manager are case sensitive. Field name Server label Server name/ip address TCP port Authenticate with common Compuware Security Description Type a friendly name for the server. Type the server name and its IP address. Type the TCP port number for the session. Select this to automatically authenticate with common Compuware Security. This is recommended for use with CAS. Note that the CAS you are pointing to must be pointing to this as well. If you do not select this, you must be an Administrator and enter information for User login and Password. Default server Select this to make the selected server the default one. Product, Protocol and Status information display by default. To test the validity of the information, click Test Connection. You are connected to the server and the login information is verified. All information can be saved even if the test failed. 17

18 Chapter 2 Report Server Management in the Portal To delete a definition, select a server from the list and click Delete. Each time you add or delete a server and click OK, the dialog closes and is refreshed. When you click Apply the changes are applied but the dialog is not refreshed and does not close. If you modify an existing server and click OK, the dialog does not close. 18

19 CHAPTER 3 Portal Control Panel The Control Panel is used solely for advanced configuration and customization of the Portal. To access the Control Panel click Administration Control Panel. Use the Dashboard Page Management dialog box for managing pages and dashboards. Portal Admin The first section contains profile information for the active user. Add your personal information such as user groups, addresses, and custom fields. Use My Pages to create private pages that accessible only to you. These are accessed from My Pages on the main menu bar. Portal The options in the Portal section enable portal administrators to set up and maintain the portal. Settings displays the main configuration for the Portal like name and mail domain. Use Monitoring to view and/or kill live sessions. You cannot kill your own session. Click Plugins Configuration to see a list of Portlet Plugins and if they are active. Use Portal Integrations - Server Client Settings [p. 25] to configure servers, ports and settings, as well as VantageView and Enterprise Synthetic. User Management Add users, user groups and assign access roles. Server Portal Server Administration [p. 31] options allow you to administer and monitor the portal server. Add Dashboards and Pages We recommend you use Manage Dashboard Pages from the Dashboards menu to add dashboards and pages. 1. Click Tools Control Panel Dashboards. 19

20 Chapter 3 Portal Control Panel 2. Click Add. 3. Type a name for the dashboard. 4. Click Save on the panel to the right to save your changes. Add pages to the dashboard 5. Click Dashboards Actions Page Settings. 6. Type a name in the Name field. 7. Choose a Page Types and Type Settings [p. 20] to create. The default is Portlet. 8. Choose Hidden to be the only user to see the page. 9. Click Add Page. 10. Double click on the new page in the list on the left to Edit Page Settings [p. 22]. Page Types and Type Settings Choose a page type and setting. Portlet This is the default when you add a new page. Use this page type for typical portal behavior. Choose Panel for a simpler version. Panel A page that holds a number of applications and provides access among them through a menu. Embedded Displays an external website or application through an Iframe. Use this to efficiently integrate external applications.. Web Content A portlet that displays static web content which can be formatted, edited and maintained. Type an ID for the content so it can be accessed by other users. URL Displays a link to an external resource. This page does not display any content of its own. Add a link to an external resource to the website by typing the URL and a description. Link to Page This page type is a specialization of the URL page type. Table 1. Page Type Settings When you select a page type, the settings under the Refresh Interval setting change depending on the page type. The following table describes the settings according to each type you select in the Type menu. Type Portlet Panel Setting Copy Page Description Description Choose an existing page from the list and create a copy. Type a description for the panel that displays when you view the page Select applications for Select the applications that will be displayed on the page. You the panel can see these when you click View Pages 20

21 Chapter 3 Portal Control Panel Table 1. Page Type Settings (continued) Type Embedded URL Web Content Link To Page Setting URL Web Content ID Link to Page Description Type a description for the URL that displays when you view the page. Type an ID for the web page. Select a page from menu to which to link. These are all the pages within the organization. Distribution Use the Distribution option to distribute reports and pages to various users. Choose the format and a method to distribute the page or report. Specify who is to receive reports and how via the configuration option. NOTE To use the Distribution function, the 32-bit Adobe Flash Player must be installed on the Portal server. NOTE Before configuring the reports distribution function, you must configure the SMTP server. To do this, click Tools Control Panel Server Administration Mail Tab. Configure settings for the selected distribution method. The options requiring information will change depending on which distribution method you choose. To send the page or report via , click Enable and select from a list of recipients. To send the page or report via FTP or HTTP, type the necessary information. Additionally, you can type an optional filename override, or friendly name. Page Look and Feel Themes can transform the entire look and feel of your portal. To expose themes for pages and reports, click Control Panel Pages Look and Feel or Tools Page Settings Look and Feel. Themes are created and installed via Control Panel Plugin Installation Theme Plugins. Themes and Color Schemes are a collection of.css and image files that customize the overall look and feel of pages. Color Schemes are also specified in.css and image files, as well as some other property and.xsl files. The use of color schemes allows for different background colors and images, border colors, text colors, etc. within your theme. The Portal contains the following themes: Login Page to control the display of the dashboard login page, Default, Reporting and Classic. Click Themes to control all non-color and non-image visuals that make up the page. Click the CSS tab and copy and paste a unique stylesheet. Remember to save the stylesheet. 21

22 Chapter 3 Portal Control Panel You can create and add custom themes by inserting a custom.css file on the CSS tab in the Look and Feel section of a page. Edit Page Settings 1. In the Control Panel click Dashboards. 2. Click the Actions menu of the dashboard containing the page you want to edit, and click Page Settings. 3. Double click the page you want to edit in the list to the right. 4. The following fields are configurable: Default name Default HTML Title Localized language, name and title. Type Query string to be used when none exists. This will be the default parameter for the page. Target attribute for the page indicating how it should open. Refresh Interval in seconds. Hidden prevents the page from being displayed. 5. Click Permissions to assign rights to users. 6. Click Save to save your settings, or click Delete to delete the page. Create a Page in the Control Panel Typically, you add pages in the Manage Dashboard Pages dialog box. Add pages in the Control Panel if the page requires customizing. 1. Click Administration Control Panel Pages. 2. Type a name for the page. 3. Choose a template, if desired. 4. Choose a page type. For more information, see Page Types and Type Settings [p. 20]. 5. Click Add Page. The page appears in the list to the left. Create a Page That Does Not Require a Login Create a page that you can access without logging in to the Portal. 1. Create a public page. For more information, see Create a Page in the Control Panel [p. 22]. a. Copy the URL b. Log out of the Portal c. Type the URL in the address bar. The page will appear, but you must be logged on as an administrator to see the page menu. 22

23 Chapter 3 Portal Control Panel 2. Add third party content, DMI portlet content, or BSM portlet content. You may have to configure DMI data access to use DMI portlets on the public page. NOTE DMI data access requires Portal 12.3 SP1. a. Create a special user with guest only access within CSS. b. At the installation location, find the following path: <install>\tomcat\webapps\root\web-inf\classes\portal-customizations.properties c. Locate the following code: #Guest user to access the public pages #guest user cpwr.guest.user.password.encrypted=true cpwr.guest.username=guestuser cpwr.guest.user.password=zqmnvng8ws18wbpiy5ma0q== d. Set cpwr.guest.user.password.encrypted to false. e. Change the cpwr.guest.username to the special user you just created. f. Set cpwr.guest.user.password to the clear text password for that user. When the system restarts, the password is encrypted. g. Restart the Compuware Dynatrace Enterprise Portal service to apply this change. Create a Banner Add a banner to display at the top of your portal pages. 1. Locate tomcat\webapps\vantage-reporting-hook\meta-inf\ custom_jsps\html\portlet\dockbar\custom-banner-content.jsp 2. Follow the instructions in the file to activate the custom banner code by changing false to true on the specified line. 3. Find custom-banner-css.jsp in the same location and update the height property. Import Dashboard Pages We recommend you use the Manage Dashboards and Pages [p. 24] dialog box to import. NOTE The.lar files are version-dependent. You cannot export from an old version of Liferay and import to a newer version. If the following error message appears, ensure that the.lar file was created with, or migrated to, the same version as the Portal you are importing to. ERROR [ImportPagesAction:93] com.liferay.portal.layoutimportexception: LAR build number xxx does not match portal build number xxx 1. Click Tools Control Panel Dashboards. 23

24 Chapter 3 Portal Control Panel The View All tab is displayed by default and lists all the dashboards. 2. ClickActions Page Settings next to the desired dashboard. 3. Click Export / Import Import. 4. Choose the elements to be imported. 5. Click Browse... to navigate to the location of the.lar file that contains the information. The.lar file overwrites the information in the selected location. 6. Select the.lar file and click Open. 7. Click Import. The information from the.lar file is added to the selected location. Export Dashboard Pages We recommend you use the Manage Dashboards and Pages [p. 24] dialog box to export. 1. Click Tools Control Panel Dashboards. 2. Click Actions Page Settings next to a dashboard. 3. Click Export / Import Export. We recommend that you use the default settings. Optionally, you can type a unique name for the file. The File Download dialog box appears. 4. Click Save. The Save As dialog box appears. 5. Select a location and click Save. 6. When the Download complete message appears, click Close. Manage Dashboards and Pages Use the Manage Dashboard Pages dialog box to manage dashboards and pages. From this dialog box, you can add and delete pages, as well as add, delete, rename, copy, and move dashboards. Use the Manage Dashboard Pages to perform the related tasks 24

25 Portal Integrations - Server Client Settings The Integrations option opens the Server/Client page and enables various ports, server lines, settings and dashboards. VantageView Enter information for Server Label, Host and Port in the fields. You can enable the integrated VantageView In the Portal [p. 37] and create an option from the main menu. Tomcat Ports Change the following ports that Tomcat is using: Tomcat port - The application runs on this port. This is accessed via the browser. Shutdown port - Listens for shutdown requests. Chapter 3 Portal Control Panel Database Settings Change the database that the portal is using. If you change this information to a blank database, the settings and dashboards will default to the original settings and dashboards. Enterprise Synthetic Integrates Enterprise Synthetic dashboards and functionality. Provide a server name/ip and port for the agent manager. The default port is After this is enabled the Enterprise Synthetic in the Portal [p. 33] dashboard option is available from the Administration menu. User Management Features in the Dynatrace Enterprise Portal Complete functionality to set up user management is included in the Central Security Server (CSS) interface, available from the Start menu on the server where the CSS is installed. In the Portal Control Panel, you can also add users, user groups and assign access roles. Add or Import Users System or Report Administrators can add users, or import them from LDAP. In the Portal, go to Administration Control Panel and under User Management, select Users. The Users page has the following icons at the top of the page: View All Shows all users. When an administrator uses the Actions menu corresponding to an existing user, they can edit the user's account; set permissions on who can edit the user's account; edit a user's page settings; impersonate the user; and deactivate the user. Add Search for users by entering search criteria in the Search field. For a more detailed search, including searching for active or deactivated users, click the Advanced link. Add "local" users to the system. 25

26 Chapter 3 Portal Control Panel Import LDAP Users If you have enabled and configured LDAP authentication, you can import LDAP users to access the system. Add a Local User If you are using local authentication, you can add users for DC RUM, BSM, Enterprise Synthetic and the Dynatrace Enterprise Portal. 1. From the Portal menu, select Administration Control Panel. Under User Management, select Users. 2. On the Users page, click Add. The Details form appears. 3. Complete the form and include a password that is allowed by the password policy configured. NOTE User names can only include alphanumeric characters, periods, dashes and underscores. No other special characters can be used. 4. By default, the Password Reset Required option is enabled. New users must reset their passwords when they log in for the first time, or when a password is reset by an administrator. Deselect this option if a password reset is not required. 5. Click Save. New users are assigned a Guest role and have limited access to product functionality. They are also added to the Everyone user group. You can assign them to other user groups, roles with additional product access, and custom dashboards. For example, if you want the new user to have full access to the Portal, dashboards and reports, you would assign them to a Report Administrator role or to a user group with that role. Import LDAP Users Before You Begin You must enable and configure LDAP authentication in the CSS console before importing LDAP users. You should also test in CSS that your LDAP searches yield the users you intend to import. 1. From the Portal menu, select Administration Control Panel. Under User Management, select Users. 2. Click Import LDAP Users. Four search fields will display. 3. Enter enough criteria to find the new user and click Search. By default, a maximum of 20 user names will be displayed. You can limit or extend the search by changing the value in the Max Results Returned field 4. Select the users needed and click Import The users will appear on the View All page. 26

27 Chapter 3 Portal Control Panel NOTE If an LDAP user account matches a locally-created user account, the local user account takes precedence over the LDAP account. New users are assigned a Guest role and have limited access to product functionality. They are also added to the Everyone user group. You can assign them to other user groups, roles with additional product access, and custom dashboards. For example, if you want the new user to have full access to the Portal, dashboards and reports, you would assign them to a Report Administrator role or to a user group with that role. Deactivate and Delete Users Deleting a user account is a two-step process: first an administrator deactivates the account, then deletes it. 1. From the Portal menu, select Administration Control Panel. Under User Management, select Users. 2. For the user you want to deactivate, click the Actions menu and select Deactivate. A confirmation request displays; click OK to proceed. At the top of the Users page, a message displays stating that the deactivation request processed successfully. The user account can no longer access the system. 3. At the top of the Users page, click the Advanced link under the Search field. Additional search fields display, including one to show Active users. 4. Change the Active value to No and click Search. The newly deactivated user account appears, along with any other deactivated accounts. At this stage, an administrator has three options: Leave the user account in a deactivated state. Delete the user account by selecting the check box next it, and clicking Delete. The user account is removed from the list. Re-activate the account by selecting the Actions menu for the account and selecting Activate. Reset a Locked-out User If a user locks themselves out of the system for some reason (failed login attempts, etc.), an administrator can change the password on the user's account to regain access. 1. From the Portal menu, select Administration Control Panel. Under User Management, select Users. 2. Select the Actions menu for the user that requires the reset, and select Edit. That user's information page is displayed. 3. Click the Password link at the right of the page. 4. Enter a new password. If you want the user to create a new password when they log in, select Password Reset Required. 27

28 Chapter 3 Portal Control Panel 5. Click Save. Create User Groups System or Report Administrators can create user groups to help streamline user management. Administrators can assign roles to user groups, in addition to individuals. All new groups are assigned to the Guest role, which has limited product access. You can add locally-created users or imported LDAP users to local user groups. 1. From the Portal menu, select Administration Control Panel. Under User Management, select User Groups. 2. On the User Groups page, click Add. 3. Enter a name and description. 4. Click Save. When you click View All, the new user group appears in the list. 5. To add members to the user group, click the group's Actions menu and select Assign Members. 6. Click Available to display all available users. 7. Select the users to include in the user group. 8. Click Update Associations. By selecting Default, all users subsequently added will be part of the group, in addition to the Everyone group. Import LDAP Groups If your organization has well-defined Active Directory groups that match your potential user base, we recommend importing LDAP groups rather than individual LDAP users. If the Active Directory groups do not match your user base (for example, the groups are too large), you should import individual LDAP users and manage them in local user groups. LDAP groups are different from locally-created user groups, in that an entire group is imported from LDAP, and users cannot be added or deleted in the CSS. User membership is controlled by the corporate group in Active Directory, so users can be added or deleted from the group by network administrators. Before trying to import an LDAP group, ensure that LDAP authentication is enabled, and initial configuration tests yielded groups with users that you needed. If you didn't see the groups and users needed during the test, you may need to adjust the LDAP attributes. 1. From the Portal menu, select Administration Control Panel. Under User Management, select User Groups. 2. Click Import LDAP Groups at the top of the page. A search field is displayed. 3. Enter a group name and click Search. Groups matching the search criteria will be displayed. Maximum results can be decreased or increased. 4. Select the necessary groups and click Import. The selected groups appear on the View All page. 28

29 Chapter 3 Portal Control Panel After the group is imported, it has a default role of Guest, which has limited product access. To provide additional access, you can assign a different role and dashboard(s) to the group. When a user from the group logs in with their network ID and password, a user account is created automatically. Once that user account is created, you can assign that user a role, local user group (that has a different role) or dashboard. NOTE If an LDAP user account matches a locally-created user account, the local user account takes precedence over the LDAP account. Roles Overview Roles define access for the product components integrated with the CSS (DC RUM, BSM, Enterprise Synthetic, and Dynatrace Enterprise Portal). A system administrator can assign users and user groups to roles. All new users, by default, are assigned to the Guest role. There are seven default user roles with different levels of product access: System Administrator Has complete access to system functionality, including user management, LDAP and database configuration; and can create and view all reports and dashboards. A system administrator must install the product and set up a user authentication method. Only a system administrator can access the RUM Console to configure DC RUM monitoring. A system administrator is automatically added to the System Administrator user group on the CAS. NOTE CAS user groups cannot be configured in the CSS. Reporting Administrator Has access to all functionality needed to configure Dynatrace Enterprise Portal reporting. Can access the CSS to add local users and assign roles and user groups. Has the same CAS access as a Reporting Power User, with the additional privileges to use all DMI features. Has full access to BSM functionality. Reporting Power User On the CAS, this user can create, save, import, and export reports. Can assign users to Portal dashboards. In BSM, this user can set up adaptor connections and navigate the Service Model. Synthetic Console User Can log in to the Enterprise Synthetic Console and access all available Console features. Packet Capture User Has access to the packet data-mining tool on the CAS. Also has the same access as a Reporting User. Reporting User Can use the Data Mining Interface in CAS to create personal reports. Can use the Charting Portlet in the Portal to create personal reports. In BSM, can navigate in the client, but cannot change any component or feature. 29

30 Chapter 3 Portal Control Panel Mobile Application User Has access to assigned reports in the MobileAPM app. In the CAS, has the same access rights as a Guest. Guest On the CAS, this user can view reports assigned to this user. Has view access to the default Dynatrace Enterprise Portal Executive and Operations dashboards, but cannot make changes to any component or feature. Will have view access to custom dashboards and to any drill-down reports assigned to this user. Assign Roles to Users and User Groups To assign a user or user group to a role: 1. From the Portal menu, select Administration Control Panel. Under User Management, select Roles. The View All page for Roles appears, displaying an Actions menu for each role. 2. Click Actions on the role to be assigned and select Assign Members. The role's page displays, with Assign Members, Users and Current highlighted. This view shows the users currently assigned to the role. 3. To assign users to the role, select Available. A list of all users appears. Alternatively, you can select User Groups and Available to display a list of user groups to assign. 4. Select the user(s) by clicking the box next to their names and click Update Associations. You will receive a message that your request processed successfully. Create New Roles The five default roles should provide you the flexibility you need to assign users and groups securely. You can also create new roles, but those roles would only impact Portal features and will not affect product access. Roles Page Actions Menu Configure options for a role by clicking Roles in the Control Panel. Click the Actions menu next to a Role. Edit Type changes in the Name and Description fields. You should not edit default roles provided with the system. Define Permissions Choose from Portal Permissions or Portlet Permissions. Portal Permissions cover portal-wide (dashboard-wide) activities that are in several categories. Portlet Permissions cover permissions that are defined within various portlets (portlets). Click Portlet Permissions to browse the names of the portlets that are currently installed in your dashboards. After you choose a portlet, define the actions within this portlet that the Role will have permission to perform. 30

31 Chapter 3 Portal Control Panel Assign Members Search and select users in the portal to be assigned to a Role. These users inherit any permissions given to the role. View Users View the users who are assigned the applicable role. Portal Server Administration Server Administration lets you check system resources and run other administration functions. Resources Contains the JVM resources graph and server-wide actions executable by an administrator. Run garbage collector Requests that the JVM begin the garbage collection task. Clear caches Requests that the JVM clear a single VM cache, cluster cache, or database cache. Reindex Sends in a request to regenerate all search indexes. Generate thread dump If you are performance testing, you can generate a thread dump which can be examined later to determine if there are any deadlocks and where they might be. Log Levels Dynamically modifies the log levels for any class hierarchy in the portal. If you have custom code that you have deployed which is not in the list, click Add Category to add it. If you change the log level near the top of the class hierarchy, all the classes under that hierarchy have their log levels changed. Be specific when you change log levels. By modifying them too high in the hierarchy, you will generate many log messages. Properties System Properties Lists the system properties for the JVM, as well as many Liferay system properties used for debugging purposes or to check the configuration of the currently running portal. Portal Properties Lists the customizable portal properties. You can check the current value of a property without shutting down the portal or opening any properties files. Captcha Thwarts bots from registering for accounts on sites powered by Liferay. Simply Liferay Portal will use recaptcha instead of simple captcha. Data Migration Migrates data from one database to another by entering in the JDBC information for the new database. You must first create a new schema in your new database. File Uploads Configures file upload settings including determined allowed extensions and maximum file sizes. 31

32 Chapter 3 Portal Control Panel Mail NOTE This feature works in a Microsoft Windows environment only. Configure the mail server settings and manually specify additional JavaMail properties to override the configuration. For page and report distribution, configure the following: 1. Enter an Outgoing SMTP server. 2. Set the Outgoing Port to Select to use a secure network connection. This is optional. 4. Type a user name and password, if required. OpenOffice Converts content from its original format to another using OpenOffice.org. In server mode. OpenOffice.org runs on port 8100 by default. Click the Enabled box, or change the port number. Script Uses scripts for user maintenance operations, bulk manipulations using the Liferay API to ensure consistency, or even system level operation. Shutdown Informs users who are logged in of an impending shutdown. You can define the number of minutes until the shutdown and a custom message to be displayed. Users will see your message at the top of their portal pages for the duration of time you specified. When the time expires, all portal pages will display a message saying the portal has been shut down. At this point, the server must be restarted to restore access. 32

33 CHAPTER 4 Enterprise Synthetic in the Portal Enterprise Synthetic measures the availability and response times of critical business applications against established thresholds using geographically-dispersed agent workstations also known as robots. To generate measurable data, Synthetic Monitoring agents are programmed to simulate the way users interact with your applications and websites. In the Portal, you can view Enterprise Synthetic data in the Application Health Status page provided that both products are configured to integrate with the same CAS. The Application Health Status page displays the status of a monitored Enterprise Synthetic application over the last 24 hours with navigation to more detailed CAS reports for fault domain isolation and deep-dive analysis. In addition, you can view Enterprise Synthetic agent and transaction health in the Portal after you Configure Enterprise Synthetic in the Portal [p. 35]. Enterprise Synthetic health data is available from the Administration menu as a page containing the following two portlets: Agent Health This portlet provides health information about the agents associated with the selected Agent Manager. You can Enterprise Synthetic Agent Health Portlet Configuration [p. 35] to expand each agent to show the health for each associated script. The columns describe the applications/transactions, the assigned location, agent, and other relevant information about the application/transaction. NOTE To successfully connect to an Agent Manager, ensure your Agent Manager has a database. The Portal gets data from an Agent Manager using cgi scripts, which are only available for Agent Managers that have a database. Table 2. Agent Manager Column Agent Manager Name Description The name or IP address of the Agent Manager to which the agent is assigned. 33

34 Chapter 4 Enterprise Synthetic in the Portal Table 2. Agent Manager (continued) Column Location Last Update Time Last Error Time Current Health Description The location to which the Agent Manager is assigned. When the database was last updated. The last error, if any, that occurred on the Agent Manager. Current health of the Agent Manager: No Errors An error has occurred or the service has stopped running on the Agent Manager machine. A warning has occurred. Status is unknown. Table 3. Agents Column Agent Name Location Last Update Time Available Current Health Last Error Time Script Status Description The name or IP address of the agent. The location to which the Active Agent is assigned. When the database was last updated. The available agents. Current health of the agents and their tasks. The time of the last error that occurred on the agent. The current status of the script. Valid values are: Good Running without errors Critical Errors have occurred since the last successful run Warning Errors have occurred prior to the last successful run Transaction Health This portlet displays the health and state of all transactions. When you select a script or agent from the Agent Health portlet, the Transaction Health portlet filters by that script or agent after you Enterprise Synthetic Transaction Health Portlet Configuration [p. 36]. Table 4. Transactions Column Application Transaction Status Description The application in which the transaction is assigned. The name of the transaction. The status of the transaction. Valid values are: Good Running without errors. 34

35 Chapter 4 Enterprise Synthetic in the Portal Table 4. Transactions (continued) Column Description Critical Errors have occurred since the last successful run. Warning Errors have occurred prior to the last successful run. Last Error Time Last Start Time Last Elapsed Time Agent Script The time that the last error occurred and was updated in the database. The last time the transaction started and was updated in the database. The number of seconds that has elapsed since the transaction started. The agent assigned to the transaction. The name of the script. Configure Enterprise Synthetic in the Portal To view Enterprise Synthetic agent and transaction health data in the Portal, you must configure a connection to a Enterprise Synthetic Agent Manager. The following task describes how to configure a connection to a Enterprise Synthetic Agent Manager: 1. Click Administration Control Panel Integrations Enterprise Synthetic. 2. Click Enable Enterprise Synthetic. 3. Click Apply. You must type an Agent Manager label and name, and then specify the port to establish the connection. After it is enabled, Enterprise Synthetic agent and transaction health data is available from the Administration menu. Enterprise Synthetic Agent Health Portlet Configuration Edit the Agent Manager and display settings for this portlet. Agent Manager Selection Choose the machine on which the Agent Manager is installed. These are the Agent Managers you added in the Integrations section of the Control Panel. Display Settings Type a unique title for the portlet in the field and select from the following: Show tooltips - Select this to have tooltips available when you hover over the column headings. 35

36 Chapter 4 Enterprise Synthetic in the Portal Enable drilldown to Agents - Select this to expand the table to see detailed information about the agents. Your browser must have network access to Agents on port Enterprise Synthetic Transaction Health Portlet Configuration Edit the Agent Manager and display settings for this portlet. Agent Manager Selection Choose the machine on which the Agent Manager is installed. These are the Agent Managers you added in the Integrations section of the Control Panel. Display Settings Type a unique title for the portlet in the field. 36

37 CHAPTER 5 VantageView In the Portal VantageView is a Web interface for viewing and publishing Dynatrace information. It provides access information from the suite of tools, real-time status and historical information of clients, servers, networks, and 3rd-party tools. The Portal integrates with VantageView via portlets. You must have VantageView installed and running before you configure it in the Portal to Configure a VantageView Connection in the Portal [p. 37]. For more information see the VantageView Online Help. NOTE VantageView only supports Internet Explorer. Configure a VantageView Connection in the Portal To use VantageView in the Portal, it must be installed and running on your machine. The following task describes how to configure a connection to VantageView: 1. Click Administration Control Panel Integrations VantageView. 2. Click Enable VantageView and type the URL for the installation location of VantageView. 3. Click Test to test the connection. Click Save to save the connection. VantageView is now available as an item on the main menu. From here you can access the Business Definition, Management, and Administration options. NOTE VantageView only supports Internet Explorer. After it is enabled, VantageView is available from the main menu. For more information see the VantageView Online Help. 37

38 Chapter 5 VantageView In the Portal 38

39 Glossary Glossary application An application is a universal container that can accommodate transactions. Each application can contain one or more transactions and those transactions can originate form different sources. Applications organize the data that travels through your network into logical units or logical categorizations of tasks that are performed over the network. Application Health Status dashboard Dashboard that enables you to analyze the health of an application via fault domain isolation and root cause analysis. browser time zone The server and browser may reside in different time zones. The Portal displays the time of the browser location. component In the Service Model, a logical service's components (Components service property) are the child services that are essential to the function of the logical service. A simple example of a component relationship is a logical service representing a database with component physical services representing resources and functions that the database cannot operate without, such as file space availability and database query response. connection A connection is the definition of a specific usage of an adaptor. Each connection consists of a set of adaptor configuration settings and a connection ID. control panel Administrators typically use the Control Panel to access the portal administration tools and modify various settings. These tools are organized into categories and accessible through a link on the Control Panel. To access the Control Panel, click Administration Control Panel. 39

40 Glossary dashboard A user interface which organizes and presents performance information from multiple applications into a unified readable and interactive display. Each dashboard contains pages and portlets to display application performance, availability, usage and infrastructure health. data center analysis Page that facilitates a targeted application performance and transactional analysis to find out what tiers are underperforming and what is contributing to this. Data Mining Interface (DMI) Data Mining Interface (DMI) is a Web-based, interactive, dynamic report-building module. DMI reports have immediate access to currently available data and can refresh automatically when new data becomes available. Trending and baseline data is also available for customized reports. Trending data is transparently used when needed, while baseline data can be mixed with current data on the same screen. DMI reports have variable time-range settings, variable resolution settings, and dynamic sorting and filtering mechanisms. Tabular reports and extensive chart generation capabilities are also available, with the ability to mix multiple report sections on the same page. Custom-built reports can have a hierarchical structure, with contextual drilldown, sibling, and parent reports. data view Sets of dimensions and metrics related to specific issues or topics. This data can be presented in tables, charts, and gauges. data view group That entity housing the data views for which data is collected. dynagrid layout Layout that lets you edit add lines and merge cells in a simplified layout editor dialog until the desired effect is achieved. event Any occurrence in a system, database, or server. Executive dashboard Provides a view of problems in the organization, their impact, and the trends and current statuses for a service or group of services. The Executive dashboard contains Summary, Improve and Scoreboard pages. Fault Domain Analysis (FDA) Portlet Portlet which supports the Applications dashboards allowing for deeper, more detailed fault analysis targeting users, applications, software modules, locations, and operations. LAR file LAR (Liferay Archive) files are zipped files used in the Liferay framework. Dynatrace Enterprise Portal is built on the Liferay enterprise web platform. look and feel Exposes the themes for pages and reports, which can transform the entire look of a portal. 40

41 Glossary metric A measurement taken for a particular entity at a particular time or for a particular period. Each metric has a unique name. For example, the total count of bytes transferred by specific clients during a given length of time is referred to as Client bytes. Note that there are different metrics for different data views. notification A message sent from the Service Model via , paging, or SMS. Operations dashboard Designed for use by operations staff and provides a detailed view of the status of services within an organization. The Operations dashboard contains Summary, Details, Transactions Summary and Events pages. page A subsection of a dashboard which contains portlets. Pages are used to organize the dashboard into distinct sections depending on the information being displayed by the portlets and the intended purpose and audience. portal admin Section of the Control Panel used to configure and control users, dashboards, user groups, roles, settings and monitoring. portlet A predefined unit of data which may include graphs, geographic views, other visual elements, or tabular data for services mapped from the Service Model. portlet type Organizational categorization for BSM default portlets dependant on their purpose, intent, and display information. Types include: Availability: Availability portlets display the "up" or "down" status of a service over time. Downtime: Downtime portlets display how long a service is down or how many users are affected. Events: Events portlets include alerts, status changes, and notifications pertinent to the services. Integration: Integration portlets bring data from a non-gomez product or service. Performance: Performance portlets display the quality of one or more services. Reconciliation: Reconciliation portlets include information and utilities used to track outages. Service Model: The Service Model portlets display configuration elements (as opposed to data) of the Service Model, such as tools or schedules. Utilities: Utilities portlets add functionality such as navigation, labels, or controls. service A service is the most basic object in the Service Model. Each service in the model calculates and maintains current status properties (for example, service quality, availability, performance 41

42 Glossary metrics, user impact or affected user counts), as well as historical status information based on these properties; all of which are analyzed by the Service Model statistics engine. Services fall into two categories: Physical Services representing physical objects that are necessary for the business to function. Simple examples would be disk drive space or a connection device. In the Service Model, a physical service receives events and data directly from the Service Model system's data adaptors (that is, events and messages from your business enterprise). Logical Services representing business functions. An example would be a complete billing system that consists of a combination of various system components. A logical service receives and acts upon data from other services. The Service Model works with services by: Specifying, for each physical service, rules or tests that are used to assess relevant incoming data. Setting status properties of the service concerned on the basis of the results of those tests. Deriving the status settings for higher-level, logical services from their child physical services using rules or methods set for the logical service. Here, methods used for setting status properties range from simple functions such as determining best, worst or average of child services, to more complex expression-based logic. service group In the Service Model, a service group (Service Groups Service Model property) is a definition of user-defined search criteria that are applied to the Service Model to determine the services that are included in the group. Several default service groups are provided with the Service Model. A usage example is to apply, in a single action, attributes (for example, a statistics profile) to all services in a group. Another example is to apply a service group to focus the Service Model display on services that match group's search criteria. service quality In the Service Model, service quality indicates a service's current condition, based on criteria such as evaluator results, availability status, or the condition of another service. Service quality status is assigned from a user-customizable defined set of quality rankings; for example Excellent, Good, Normal, Bad, and Critical. Assignment of service quality status from a range of rankings, and basing the assignment on evaluation criteria is a key concept in modeling a business enterprise. You are able to define the different levels of quality that can be represented in the Service Model, ranging from IT event type severities to levels that highlight potential business impacts. You can then set different thresholds to determine what service quality rankings indicate that a service is acceptable, unavailable, or in failure. statistics In the Service Model, statistical analysis can be enabled and configured to convert the Service Model's response to incoming messages into data patterns that show how business services are performing over time. The Service Model processes these main types of performance data for its current set of services: 42

43 Glossary Data that is based solely on the results of the application of service evaluators (logic and ranking data) and generally represents multi-state information (service quality and availability). Metric data derived from connection event value properties, some of which may have been processed by expressions configured in the Metrics property of the involved service. When processed, both types of data are tagged with details of whether they fall within various service time tables, peak times, etc. The tagged data can be fed into the Service Model's statistics engine for detailed analysis and assessment of performance compliance. They can also be supplemented by reference to various types of user count data derived from service availability patterns. The Service Model is provided with a pre-defined set of statistics type definitions that identify reporting periods: StatisticsHourly, StatisticsDaily, StatisticsWeekly, StatisticsMonthly, and StatisticsYearly. Statistics types that can be selected individually or in combination. For each statistics type, there is a pre-defined set of statistics calculation types, each of which outputs a set group of statistics: Availability, Metrics, Six Sigma, Service Quality, and User Impact. Statistics calculation types also can be selected individually or in combination. The Statistics Service Model property enables selection of statistical reporting periods, schedules for data polling and statistics calculation, which statistic to calculate, the services from which to collect the supporting data, and publishing (output destination) options. themes Deployable plugins which can transform the look and feel of the portal. You can create a theme plugin which can then be installed, allowing for a new look and feel. tier Logical application layer, a representation of a fragment of your monitored environment. The front-end tier in a user-defined configuration is the layer that is closest to the end user. Each application is defined as a set of transactions and can be divided into logical layers (tiers), such as Web servers, middleware, or a database. Each transaction can be a collection of data gathered across various tiers. transaction A transaction is defined as a unit of interaction between the server and the client, such as a user requesting a URL. A transaction is one of the following: A simple transaction consisting of a single operation such as a Web page load. A more complex transaction consisting of sequences of operations. A collection of non-sequenced operations. user In the Central Security Server users are added either locally or via LDAP by a system administrator so they can access Business Service Management, the Dynatrace Enterprise Portal and Data Center Real User Monitoring. 43

44 Glossary user role In the Central Security Server, five default roles are provided to define product access to users. For example, a user with a system administrator role would have complete access to all product functionality, while a user with a guest role would only have view-access to some default dashboards and other components. user group In the Central Security Server, a user group can be created by a system administrator so similar groupings of people can be assigned access roles, domains or dashboards in the Dynatrace Enterprise Portal. 44

45 Index Index A access page without logging in 22 access the Portal 10 add 28 user groups 28 add roles 30 add user 26 Adding user groups 25 in the Dynatrace Enterprise Portal 25 adding users 25 Adding users 25 in the Dynatrace Enterprise Portal 25 administration overview 9 Alerting 25 assign page rights 15 assign user roles 30 Assigning roles 25 in the Dynatrace Enterprise Portal 25 B banner 23 C configure VantageView 37 Console User 29 role 29 contact information 6 Control Panel adding dashboards 19 adding pages 19 creating a page 22 customized page 22 Control Panel (continued) exporting 24 importing 23 Look and Feel 21 page distribution 21 page settings 22 page type 20 Portal administration 19 Customer Support 6 information to provide 6 D database settings 25 define permissions 30 Dynatrace Enterprise Portal interface 11 E enabling VantageView from the portal 37 Enterprise Synthetic 25, 33, Agent Health portlet 33 configuring connection 35 edit Agent Health portlet 35 edit Agent Health Transaction Health portlet 36 Transaction Health portlet 33 G getting started 9 Guest 29 role 29 H HTTPS configuration 13 45

46 Index I Import LDAP groups 28 Importing LDAP users 25 interface 11 introduction 5 audience 5 organization of guide 5 related publications 5 J JVM settings 15 L languages 16 LDAP groups 28 importing 28 LDAP users importing localized languages 16 log into the Portal 10 M main menu 11 manage dashboard pages 24 manage report servers 17 manage roles 30 O online support site 6 P Packet Capture User 29 role 29 page 15, accessing without login 22 assigning rights 15 banner 23 creating in Control Panel 22 look and feel 21 settings 22 page expiration 13 pages 24 R Report Server Manager 17 Report User 29 Report User (continued) role 29 Reporting Administrator 29 role 29 Reporting Power User 29 role 29 resetting locked-out user 27 Role 30 assign to users and groups 30 roles Action menu 30 add 30 Console User 29 default 29 Guest 29 Packet Capture User 29 Report User 29 Reporting Administrator 29 Reporting Power User 29 System Administrator 29 roles overview 29 S server administration 31 data migration 31 file uploads 31 log levels 31 mail 31 OpenOffice 31 properties 31 shutdown 31 system resources 31 session timeout 13 SSL 13 configuration 13 System Administrator 29 role 29 T Tomcat ports 25 U user groups 28 adding 28 users 26 add 26 Users page 26 46

47 Index Users page (continued) importing LDAP users 26 V VantageView 25, 37 configure connection 37 47

48 Index 48