13
Care Systems Analytics for MEDITECH Installation and Configuration Guide VMware Care Systems Analytics for MEDITECH Management Pack for vRealize Operations Manager This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.

Care Systems Analytics for MEDITECH Installation and ...€¦ · VMware, Inc. 5 About This Book VMware Professional Services VMware Education Services courses offer extensive hands‐on

Embed Size (px)

Citation preview

Care Systems Analytics for MEDITECHInstallation and Configuration Guide

VMware Care Systems Analytics for MEDITECH Management Pack forvRealize Operations Manager

This document supports the version of each product listed andsupports all subsequent versions until the document is replacedby a new edition. To check for more recent editions of thisdocument, see http://www.vmware.com/support/pubs.

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

2 VMware, Inc.

Care Systems Analytics for MEDITECH Installation and Configuration Guide

You can find the most up-to-date technical documentation on the VMware Web site at:

http://www.vmware.com/support/

The VMware Web site also provides the latest product updates.

If you have comments about this documentation, submit your feedback to:

[email protected]

Copyright © 2015 VMware, Inc. All rights reserved. Copyright and trademark information

VMware, Inc. 3

Content

About This Book 4

Introduction to Care Systems Analytics for MEDITECH 6Installation and Configuration Requirements 6

Installation Component Overview 7

Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager 8

Prepare the MEDITECH Files 8

Install the Care Systems Analytics for MEDITECH Management Pack in vRealize Operations Manager 9

Configure a Care Systems Analytics for MEDITECH Adapter Instance in vRealize Operations Manager 9

Clone and Share Dashboards in vRealize Operations Manager 11

Configure User Group Permissions in vRealize Operations Manager 12

Upgrading vRealize Operations Manager 13

VMware, Inc. 4

The Care Systems Analytics for MEDITECH Installation and Configuration Guide describes how to install and 

configure the VMware® Care Systems Analytics for MEDITECH Management Pack on vRealize Operations 

Manager to monitor your MEDITECH® system.

Intended AudienceThis information is intended for anyone who needs to install or configure the Care Systems Analytics for 

MEDITECH Management Pack. 

This information assumes you are experienced with vRealize Operations Manager and MEDITECH. See 

VMware vRealize Operations Manager documentation at: http://www.vmware.com/support/. See your 

MEDITECH documentation, as needed.

VMware Technical Publications GlossaryVMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions 

of terms as they are used in VMware technical documentation go to http://www.vmware.com/support/pubs.

Document FeedbackVMware welcomes your suggestions for improving our documentation. If you have comments, send your 

feedback to [email protected].

Technical Support and Education ResourcesThe following sections describe the technical support resources available to you. To access the current version 

of this book and other books, go to http://www.vmware.com/support/pubs.

Online and Telephone Support

To use online support to submit technical support requests, view your product and contract information, and 

register your products, go to http://www.vmware.com/support.

Customers with appropriate support contracts should use telephone support for the fastest response on 

priority 1 issues. Go to http://www.vmware.com/support/phone_support.

Support Offerings

To find out how VMware support offerings can help meet your business needs, go to 

http://www.vmware.com/support/services.

About This Book

VMware, Inc. 5

About This Book

VMware Professional Services

VMware Education Services courses offer extensive hands‐on labs, case study examples, and course materials 

designed to be used as on‐the‐job reference tools. Courses are available onsite, in the classroom, and live 

online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides 

offerings to help you assess, plan, build, and manage your virtual environment. To access information about 

education classes, certification programs, and consulting services, go to http://www.vmware.com/services. 

VMware, Inc. 6

1

VMware® Care Systems Analytics for MEDITECH is an IT management solution designed for healthcare 

organizations that use the MEDITECH® platform. The solution extracts system information from the 

MEDITECH SIRT share path and integrates it with VMware vRealize Operations Manager to create a single 

view of system performance across the Electronic Health Record (EHR) platform and supporting 

infrastructure.

Care Systems Analytics for MEDITECH is a management pack for vRealize Operations Manager. This is an 

intelligent operations management solutions from VMware. The Care Systems Analytics for MEDITECH 

solution improves visibility into the overall performance of the MEDITECH system–from infrastructure to the 

point of care. It includes dashboards, widgets, and patented self‐learning techniques to visualize and analyze 

performance indicators from MEDITECH specific departmental metrics and related infrastructure (physical 

and virtual). 

Use this solution to help you increase collaboration across infrastructure, operations, and applications teams; 

reduce expensive and disruptive outages by providing insight into application, database, and infrastructure 

metrics; and anticipate and prevent potential problems, by quickly troubleshooting issues to resolution. 

Installation and Configuration RequirementsBefore you install the Care Systems Analytics for MEDITECH management pack, verify that your system 

meets the listed requirements. See the Care Systems Analytics for MEDITECH Release Notes for the most current 

information. 

Introduction to Care Systems Analytics for MEDITECH 1

NOTE    For the purposes of this guide:

The terms Management Pack, Adapter, and Solution are used interchangeably and generally apply to Care 

Systems Analytics for MEDITECH.

VMware, Inc. 7

Chapter 1 Introduction to Care Systems Analytics for MEDITECH

Installation Component OverviewThe following two graphics illustrate the relationships between the Care Systems Analytics for MEDITECH 

Management Pack, the vRealize Operations Manager, and MEDITECH.

Figure 1-1. Care Systems Analytics for MEDITECH adapter integration with the vRealize Operations Manager

Figure 1-2. Flow of Care Systems Analytics for MEDITECH component data into vRealize Operations Manager

VMware, Inc. 8

2

This section describes how to install the Care Systems Analytics for MEDITECH management pack on the 

vRealize Operations Manager.

Installation of management packs in general is described in the documentation for vRealize Operations 

Manager. The procedures in this guide are specific to the Care Systems Analytics for MEDITECH management 

pack.

For additional information about vRealize Operations Manager, see the documentation at: 

http://www.vmware.com/support/pubs. From the Support Resources list, select vRealize Operations 

Manager. 

Prepare the MEDITECH FilesBefore you install Care Systems Analytics for MEDITECH, you must prepare the MEDITECH SIRT file. 

Procedure

1 On your vSphere network:

Setup a 1 GB SMB/CIFS share for the MEDITECH SIRT file.

Create a service user account with read/write permissions to that share. 

This share will be used by MEDITECH to send information to the MEDITECH adapter and by the Care 

Systems Analytics for MEDITECH adapter to retrieve the information. 

Both MEDITECH and the Care Systems Analytics for MEDITECH require the login credentials to the 

SIRT share. 

2 Contact your MEDITECH HCIS administrator and request they setup SIRT sharing for your version of the 

MEDITECH adapter. 

Provide the SMB/CIFS share details and the service account credentials you created in Step 1.

3 When SIRT sharing is setup from the MEDITECH side, check that .sirt files are periodically copied to SMB/CIFS share.

Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager 2

NOTE    The vRealize Operations Manager does not support uninstalling management packs. This includes the Care 

Systems Analytics for MEDITECH management pack. VMware recommends that you take a snapshot prior to 

installing the Care Systems Analytics for MEDITECH management pack.

VMware, Inc. 9

Chapter 2 Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager

Install the Care Systems Analytics for MEDITECH Management Pack in vRealize Operations Manager

You install the Care Systems Analytics for MEDITECH management pack on the vRealize Operations 

Manager using a PAK file.

The Care Systems Analytics for MEDITECH management pack is the part of the solution that you install. It 

contains the dashboards. 

Use the vRealize Operations Manager user interface to install the Care Systems Analytics for MEDITECH 

management pack. See the vRealize Operations Manager documentation for additional information.

Prerequisites

1 Download your Care Systems Analytics for MEDITECH from my.vmware.com. Your My VMware 

account login grants you access to the solutions you have purchased. The solution that you downloaded 

includes a PAK file. For example: 

vmware-<opsmgr>-<om_ver>-MeditechAdapter-<mca_ver>-<buildnumber>.pak.

2 Save that PAK file to a temporary folder on your local system.

Procedure

1 Use a supported browser to log in to the vRealize Operations Manager user interface with administrator 

privileges.

For a current list of supported browsers, see the vRealize Operations Manager release notes. 

2 In the left pane of vRealize Operations Manager, click the Administration icon and click Solutions.

3 On the Solutions tab, click the add (+) icon.

a Browse to locate the temporary folder and select the PAK file.

For example, vmware-vrops-6.0.0-MeditechAdapter-1.0-<buildnumber>.pak.

b Click Upload. After the file uploads, click Next.

c Read and accept the EULA and click Next.

Installation details appear in the window during the process. The installation might take several 

minutes.

d When the installation is finished, click Finish.

The management pack is listed as a solution.

What to do next

You must configure your Care Systems Analytics for MEDITECH Adapter instance. 

Configure a Care Systems Analytics for MEDITECH Adapter Instance in vRealize Operations Manager

To manage your Care Systems Analytics for MEDITECH instances in vRealize Operations Manager, you must 

configure an adapter instance for each Care Systems Analytics for MEDITECH instance. 

When you configure the adapter, you must use one of the following URL formats:

IP address

FQDN (fully qualified domain name)

Prerequisites

Verify that you know the MEDITECH SIRT share path details and login credentials to connect and collect 

data. 

VMware, Inc. 10

Chapter 2 Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager

Download and install the Care Systems Analytics for MEDITECH management pack. See “Install the Care 

Systems Analytics for MEDITECH Management Pack in vRealize Operations Manager” on page 9.

Procedure

1 In the left pane of vRealize Operations Manager, click the Administration icon and click Solutions.

2 Select the MEDITECH adapter and click the Configure (double‐gear) icon.

3 If you are adding an additional adapter instance, click the add (+) icon on the Instance Name toolbar.

4 Enter a Display name and Description for the adapter configuration.

5 In the Basic Settings area, enter the FQDN or IP address of the MEDITECH SIRT share path to which you 

are connecting.

Enter the path to the SIRT share. Enter the URL to the share path in the form

smb://<FQDN>/sharepath

The MEDITECH SIRT share path FQDN or IP address must be reachable from all nodes in the vRealize 

Operations Manager cluster.

Depending on your network configuration, you may:

Be able to just use the Hostname of the MEDITECH SIRT share path.

Have to update firewall rules to enable communication for the vRealize Operations Manager virtual 

machine with the MEDITECH SIRT share path over ports 80 and 443.

6 Add login credentials for the MEDITECH SIRT share path.

The MEDITECH adapter requires the SIRT share path and the credentials to access the share over the 

network. You configure the Care Systems Analytics for MEDITECH adapter through the vRealize 

Operations Manager interface.

Enter the MEDITECH SIRT share path credentials, including the user name, password, and domain 

details.

7 Select true or false from the Auto Discovery drop‐down menu to enable or disable auto‐discovery. 

If you enable auto‐discovery, the data collection process discovers new resources and creates the resources 

for you. If you disable auto‐discovery, you must use manual discovery to create resources. Manual 

discovery is useful for restricting the resources that the management pack adds. You typically enable 

auto‐discovery for the Care Systems Analytics for MEDITECH management pack.

8 Click Test Connection to validate the connection with your MEDITECH SIRT share path.

A dialog box appears with the test result, click OK to close it.

9 Expand the Advanced Settings list and select a Collector from the list.

The collector you select determines which vRealize Operations Manager collector is used to manage the 

adapter processes. 

10 In the Basic Settings area, select true or false from the Auto Discovery drop‐down menu to enable or 

disable auto‐discovery.

If you enable auto‐discovery, the data collection process discovers new resources and creates the resources 

for you. If you disable auto‐discovery, you must use manual discovery to create resources. Manual 

discovery is useful for restricting the resources that the management pack adds. You typically enable 

auto‐discovery for the Care Systems Analytics for MEDITECH management pack.

11 Click Save Settings to save the management pack instance.

12 Click OK in the Adapter instance successfully saved message box.

13 Click Close in the Manage Solution box.

The adapter instance is added to the list. 

VMware, Inc. 11

Chapter 2 Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager

14 Click the home icon to return to the home screen and view your dashboards. Verify that the MEDITECH 

dashboards appear and display resources and metrics.

It will take about 10 minutes to display the MEDITECH adapter metrics.

vRealize Operations Manager begins collecting data from the MEDITECH SIRT share path. Depending on the 

number of managed objects, the initial collection can take more than one collection cycle. A standard collection 

cycle begins every five minutes.

What to do next

Clone and share your Care Systems Analytics for MEDITECH adapter dashboards. 

Clone and Share Dashboards in vRealize Operations Manager

There are selected activities you can perform on entire dashboards. Depending on your access rights, you can 

add, delete, and arrange widgets on your dashboards, clone and create new dashboards, import or export 

dashboards from other instances, edit widget configuration options, and configure widget interactions. 

After you install the MEDITECH management pack for the first time, clone the dashboards and share them 

with appropriate users. Cloning the dashboards ensures that you do not override user‐applied dashboard 

settings when you update to a new management pack. In other words, all changes to settings made by users 

to their cloned dashboards are preserved.

Procedure

1 In the left pane of vRealize Operations Manager, click the Content icon and click Dashboards.

2 Clone each Care Systems Analytics for MEDITECH adapter dashboard.

a Select a Care Systems Analytics for MEDITECH dashboard.

b Click the clone icon. 

c Enter a new name for the cloned dashboard and click OK.

d Repeat for each MEDITECH dashboard.

Meditech Health Overview

Meditech App Analysis

Meditech Database Analysis

Meditech Server Top‐N

Meditech Server Analysis

3 Share the Care Systems Analytics for MEDITECH dashboards.

a Click the gear icon menu and select Share Dashboards.

b From the list of Shared Dashboards, drag the Care Systems Analytics for MEDITECH dashboards to 

the MEDITECH group listed under Accounts Group on the left side. 

See “Configure User Group Permissions in vRealize Operations Manager” on page 12.

c Click Save.

NOTE    It is highly recommended that you, the vRealize Operations Manager administrator, clone and share the 

default dashboards with the MEDITECH application team and other individuals involved in the monitoring 

and management of the MEDITECH application. 

Do this immediately after completing the Care Systems Analytics for MEDITECH management pack 

installation. 

This ensures that any changes to the configuration of the default dashboards for your environment are not 

overwritten by updated default dashboards that might be downloaded as part of an update to either the 

vRealize Operations Manager or the Care Systems Analytics for MEDITECH management pack.

VMware, Inc. 12

Chapter 2 Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager

What to do next

See the Care Systems Analytics for MEDITECH Users Guide for additional information on monitoring your 

MEDITECH software.

Configure User Group Permissions in vRealize Operations ManagerYou must have privileges to access specific features in the vRealize Operations Manager user interface. The 

roles associated with your user account determine the features you can access and the actions you can perform.

Each predefined role includes a set of privileges for users to perform create, read, update, or delete actions on 

components such as dashboards, reports, administration, capacity, policies, problems, symptoms, alerts, user 

account management, and adapters. The vRealize Operations Manager enforces which objects a user can see, 

and the operations that they can perform on those objects, based on the access privileges and roles assigned to 

the user by the administrator.

vRealize Operations Manager provides several predefined roles to assign privileges to users. You can also 

create your own roles. The default Care Systems Analytics for MEDITECH adapter user role is:

Administrator ‐ Includes privileges to all features, objects, and actions in vRealize Operations Manager.

A dashboard can be shared with any group but the dashboard is still owned by the user that shared the 

dashboard, for example, the Administrator user. Other users cannot modify the shared dashboard. To 

determine if you have permission to modify a dashboard, check for the key icon on the dashboard tab. 

Prerequisites

Verify that you are logged in to the vRealize Operations Manager as an system administrator.

Procedure

1 In the left pane of vRealize Operations Manager, Home panel, click the Administration > Access Control, 

and click the User Groups tab.

2 Import user groups.

You import user groups from an LDAP database on another machine so that you can use those groups in 

vRealize Operations Manager. When you import user groups, vRealize Operations Manager creates user 

records and assigns them to user groups.

a Click the Import Group icon on the User Groups toolbar. 

b In the Import User Groups workspace, click the add (+) icon and provide the details to import the 

user group. This includes: 

Import from Source Type, open LDAP host machine

Host, Port, User Name, and Password

Find user groups

Advanced import settings

c Provide details to import the user groups. This includes:

Members user names of each user

Role names assigned to users

Objects view associated with group

d Test the import source. Click Test.

3 Edit a user group roles and objects. This is available after the group is imported.

a Click the add (+) icon in the User Groups toolbar. 

b Select members, roles, and objects for the new user group.

VMware, Inc. 13

Chapter 2 Installing the Care Systems Analytics for MEDITECH Management Pack on vRealize Operations Manager

4 Edit a user group. 

a Click the edit (pencil) icon in the User Groups toolbar.

b After you add a user group, to change the role, user account, or objects associated with the user 

group, you select a user group in the summary grid, and click the edit (pencil) icon in the panes of 

the Details grid.

5 Share the dashboards with the groups.

What to do next

Create additional user accounts and assign users to the groups, as needed. See the vRealize Operations 

Manager documentation for additional information on configuring and managing users.

Upgrading vRealize Operations ManagerIf you upgrade from an earlier version of vRealize Operations Manager, the previous Care Systems Analytics 

for MEDITECH management pack files are copied to the/usr/lib/vmware-vrops/user/plugins/.backup file in a folder with a with a date and time as the folder name. 

Before migrating your data to your new vRealize Operations Manager instance:

Install any new adapters. 

Clone any out of the box dashboards that you modified. 

After migration, none of your adapter customizations are included in the migration, and you must reconfigure 

them. All modifications done to the dashboards are removed after the vRealize Operations Manager upgrade. 

Cloned dashboards are not overwritten.