CA Cloud Service Delivery Platform for the Monitoring Service Cartridge Implementation Guide Version 01.0.00
This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the Documentation ) is for your informational purposes only and is subject to change or withdrawal by CA at any time. This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosed by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and CA. Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy. The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the terms of this notice. The manufacturer of this Documentation is CA. Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors. Copyright 2013 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Contact CA Technologies Contact CA Support For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources: Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product Providing Feedback About Product Documentation If you have comments or questions about CA Technologies product documentation, you can send a message to techpubs@ca.com. To provide feedback about CA Technologies product documentation, complete our short customer survey which is available on the CA Support website at http://ca.com/docs.
CA Technologies Product References This documentation set references the following CA Technologies products: CA Service Catalog CA Business Intelligence CA Infrastructure Management CA Embedded Entitlements Manager (CA EEM) CA NetQos Performance Center (CA Performance Center) CA Process Automation CA Cloud Service Delivery Platform (CA CSDP) CA SiteMinder CA Service Operations Insight CA Spectrum CA Virtual Assurance for Infrastructure Managers (formerly known as CA Virtual Performance Management) CA Service Desk Manager (CA SDM)
Contents Chapter 1: Introduction 7 Monitoring Service Capabilities... 7 Download the Appliances... 8 Chapter 2: Deployment Lifecycle 9 Register a Service... 9 Estimate... 10 Instantiate... 10 Configure... 11 Activate... 11 Test... 12 Chapter 3: Installation 13 Planning your Implementation... 13 Software... 13 Infrastructure... 13 Prepare the Deployment Worksheet... 14 Deploy Appliances... 20 How to Deploy Monitoring Service Cartridge... 20 Automatic Deployment... 20 Manual Deployment... 22 Verify Implementation... 30 Synchronize Appliance Dates, Times, and Timezones... 35 Chapter 4: Add CA CSDP Servers 37 Stop CA Spectrum Connector... 38 Discover CA CSDP Components in CA Spectrum... 39 Create a Service in CA Spectrum... 40 Start the CA Spectrum Connector... 41 Appendix A: Server Access Credentials and Port List 43 Deploy the Monitoring Service Cartridge... 46 Register Services... 46 Deploy Monitoring Service - Central... 47 Deploy Monitoring Service - Regional... 48 Contents 5
Appendix B: Troubleshooting and Best Practices 53 Configuring a Tenant in CA Service Operations Insight... 53 Create a Tenant Group... 54 Create Queue Alerts... 55 Add Users to the Tenant Group... 56 Grant Access Service Privileges to a Tenant Group... 57 Create SLA for Tenant Monitoring Service... 58 Restart or Power Down CA Spectrum... 59 Add New Domains for Monitoring... 60 Add Permission for a User to View Reports... 61 Remove Permission to Reports... 61 6 Implementation Guide
Chapter 1: Introduction This guide is intended for system administrators to offer Monitoring-as-a-Service (MaaS) on CA CSDP. We assume that you are familiar with how your organization has deployed CA CSDP. The monitoring service cartridge is a packaged set of content that is used with the platform to deliver Monitoring-as-a-Service (MaaS). It includes the connectors, processes, forms, and scripts that are required for service fulfillment and delivery. Each service cartridge individually represents a service offering and is delivered as a singular unit to automate and deliver that service. Monitoring Service Capabilities Monitoring-as-a-Service (MaaS) extends the capabilities of the platform to monitor and assure availability and performance. The service can detect faults of services or resources that are offered to the customers. Monitoring service offers the following capabilities: Monitoring Assurance of Resources and Services Monitors and manages resources, services, service level agreements, and any faults that are associated with them. Data Collection and Metrics Billing Collects data to track and monitor the services, and resources, health, and utilization for reporting purposes. This data can be used to identify faults and so that you can take necessary corrective actions. Generates data that can be used for billing purposes. Chapter 1: Introduction 7
Download the Appliances Download the Appliances Virtual Appliances are preconfigured application stacks that are prebuilt to provide the monitoring service. The following appliances are comprised of virtual machines that are packaged as a unit and managed in Open Virtualization Format (OVF). OVF is an open standard for packaging and distributing the appliances. Important! Before you download, verify that the system to which you are downloading the service cartridge to has a minimum of 55 GB free disk space. Go to http://www.cloudcommons.com, download the following appliance ZIP files in any order, and extract them to a local drive in any order: MaaS-SOI3.0.zip Prioritizes and resolves problems. MaaS-Spectrum9.2.2.zip Automates fault management across infrastructures and tailoring the information views. MaaS-DSS.zip Enables the distribution of management for portions of a large-scale network, across multiple servers in a single physical location. Improves managing computing infrastructure by distributing the network load that is introduced by management traffic, and delegating management functions to remote workstations. MaaS-SRM5.7.1.zip Retrieves the responsiveness of a logical or physical service that runs on the local or on a remote system. MaaS-IM2.1.2-RHEL55.zip Monitors and manages physical servers for Windows, UNIX, and Linux operating system metrics including CPU, memory, disk, log files, and processes. MaaS-DC.zip Download and extract the appliances. Each extracted appliance contains Open Virtualization Format (OVF) files that are used while deploying the monitoring service cartridge. If you are deploying the monitoring service cartridge automatically, after you download and extract the appliances, specify the location of the virtual appliances in the CA Process Automation system. If you are deploying the monitoring service cartridge manually, after you download and extract the appliances, specify the location of the virtual appliances in the virtual environment. 8 Implementation Guide
Chapter 2: Deployment Lifecycle When you register for monitoring services and select the deployment from the service offerings, the request goes through an automated workflow. The request is processed and managed using service portal. You can deploy monitoring service cartridge using one of the following methods: Automatic Deployment (see page 20) for an administrator with access to the VMware environment at your organization. Manual Deployment (see page 22) for deployment without access to the VMware environment when help is needed deploying OVFs. The manual and automated deployment workflow includes the following operations: Estimate (see page 10) Instantiate (see page 10) Configure (see page 11) Activate (see page 11) Test (see page 12) This chapter describes the deployment workflow of the monitoring service cartridge. Register a Service You can register for the monitoring service from the service portal. This request form captures the required details for estimating the resource requirement for the monitoring service that is to be provisioned. Follow these steps: 1. Log in to the service portal with administrator credentials. The home page opens. 2. Click Requests. A new page opens with the list of services. 3. Click Register Services under Service Administration. A new page opens with the list of services to register. 4. Click Monitoring Service. Chapter 2: Deployment Lifecycle 9
Register a Service 5. Select Deploy Monitoring Service-Central. By default, the form opens with the Automatic Deployment option. Important! The Deploy Monitoring Service-Central is a one-time task. The system does not allow you to redeploy the service. 6. Complete the form and Submit to deploy the OVF templates automatically. 7. Clear the check box to deploy the OVF templates manually using the VMware vsphere Client and Submit. The predefined Manage Service Offerings (MSO) workflow starts automatically. The process instantiates, configures, activates, and tests the monitoring components and emails you the operation results. The system deploys the templates to the central location. You are notified that the monitoring service offering is available to be offered. Estimate This operation estimates the infrastructure requirement during the service registration for the monitoring service. Estimates are based on the lab setup and consolidation. You must provide details for estimating the resource requirement for the service to be provisioned. Note: Estimate is an automatic operation in the deployment workflow. Instantiate This operation implements the monitoring applications on the infrastructure. Monitoring service is instantiated by installing the virtual appliances to the appropriate resource. Note: Instantiate includes both manual and automatic operation in the deployment workflow. You can deploy the monitoring service cartridge using one of the following methods: Automatic Deployment (see page 20) for an administrator with access to the VMware environment at your organization. Manual Deployment (see page 22) for deployment without access to the VMware environment when help is needed deploying OVFs. 10 Implementation Guide
Register a Service Configure This operation configures the monitoring components to work together for the monitoring service. Note: For both manual deployment and automatic deployment, after you instantiate or deploy the OVF templates, start the CA SpectroSERVER to configure and ensure that the status is RUNNING. Follow these steps: 1. Log in to the SpectroSERVER with administrator credentials. 2. Click Start, All Programs, CA and then start SPECTRUM Control Panel-MaaS-Spectrum. The SPECTRUM Control Panel page opens. 3. Ensure the configure settings and the status is RUNNING. The configuration is complete. Activate This operation makes the monitoring applications accessible by the tenant administrators and users to their views. Chapter 2: Deployment Lifecycle 11
Register a Service Note: Activate is an automatic operation in the deployment workflow. Test This operation verifies the availability of the configured monitoring components. Note: Test is an automatic operation in the deployment workflow. 12 Implementation Guide
Chapter 3: Installation This section describes how to deploy and configure the monitoring service cartridge. As a system administrator you are responsible to plan the implementation, and then prepare a worksheet for reference throughout the implementation. Deploy the appliances, configure, and then verify the implementation. Planning your Implementation The topics in this section provide information about the system requirements for deploying the monitoring service cartridge components. Software If you are deploying the monitoring service cartridge automatically, install the OVF Tool 3.0.1 before you start the installation process. More Information: Install OVF Tool (see page 21) Infrastructure The solution requires VMware environment with VMware vcenter 4.0 or above with VMware ESX 4.1 or above servers for deploying virtual machines. Before you install the appliances, work with your administrator to ensure that the VMware ESX resources meet the following minimum requirements: Number of vcpus: 22 Total RAM: 80 GB Total Storage: 115 GB (thin) to 563 GB (thick) Number of Static IP addresses: 10 The following table lists the requirements for each appliance: Appliances vcpus RAM Storage Network MaaS-SOI3.0 2 x vcpus 8 GB 18 GB (thin) to 40 GB (thick) One IP address Chapter 3: Installation 13
Prepare the Deployment Worksheet Appliances vcpus RAM Storage Network MaaS-Spectru m9.2.2 4 x vcpus 12 GB 40 GB (thin) to 80 GB (thick) Two IP addresses MaaS-DSS 2 x vcpus 8 GB 43 GB (thick) One IP address MaaS-SRM5.7.1 2 x vcpus MaaS-IM2.1.2- RHEL55 4 GB 10 x vcpus 36 GB 15 GB (thin) to 40 GB (thick) 42 GB (thin) to 288 GB (thick) One IP address Four IP addresses MaaS-DC 2 x vcpus 12 GB 72 GB (thick) One IP address Prepare the Deployment Worksheet Before you deploy the appliances, gather the information in the following worksheet. After you complete the worksheet, use the details as you work through the installation prompts. Important! The solution has preconfigured host names, which can cause conflict if more than one instance is deployed on the same network environment. If more than one instance is deployed, the host names should be on separate networks. Note: The asterisk (*) in the following worksheet represents mandatory fields that you must enter while deploying the OVF templates using the VMware vsphere Client. Information needed Description Note the details here * Total memory in GB (minimum requirement) disk space * OVF location for automatic deployment The system to which you want to download the appliances. Location where the appliances are copied. Following is the CA Process Automation location: Example:<share_drive\(O VF template)> * OVF location for manual deployment Location where the appliances are copied. Following is the location: Example:<share_drive\(O VF template)> 14 Implementation Guide
Prepare the Deployment Worksheet Information needed Description Note the details here VMware Data Center Details * IP address / Host name of a VMware vcenter Server The IP address / Host name of the VMware vcenter server. * VMware ESX Server The server on which you want to deploy the platform. Appliance Properties of MaaS-Spectrum9.2.2 kms_server_port win2008r2_prod_key The Key Management Service port number. Microsoft Windows Server 2008 R2 Standard 64-bit product key. * public_network_subnet_mask The Inbound/outbound IP address subnet mask for the provisioned instance of CA Spectrum on the public network. * public_network_default_gateway The Inbound/outbound IP address gateway for the provisioned instance of CA Spectrum on the public network. *MaaS-Spectrum_public_network_ip *Maas-OneClick_public_network_ip EEM_cookie_domain The IP address for the provisioned instance of SpectroServer on the public network. The IP address for the provisioned instance of OneClick on the public network. Specifies the domain in which the OneClick server resides. Default: oss.ca * public_network_dns1 The DNS server for outbound IP addresses traffic for the provisioned instance of CA Spectrum on the public network. Chapter 3: Installation 15
Prepare the Deployment Worksheet Information needed Description Note the details here Appliance Properties of MaaS-DSS kms_server_port win2008r2_prod_key The Key Management Service port number. Microsoft Windows Server 2008 R2 Standard 64-bit product key. * public_network_subnet_mask The Inbound/outbound IP address subnet mask for the provisioned instance of CA Spectrum on the public network. * public_network_default_gateway The Inbound/outbound IP address gateway for the provisioned instance of CA Spectrum on the public network. * DSS_hostname Distributed SpectroServer hostname. * DSS_public_network_ip The IP address for the provisioned instance of Distributed SpectroServer on the public network. * DSS_lhandle Distributed SpectroServer Landscape Handle (must be unique, a multiple of 4, different than 12376, and in the 4 16376 range). * public_network_dns1 The DNS server for outbound IP addresses traffic for the provisioned instance of CA Spectrum on the public network. Appliance Properties of MaaS-IM2.1.2-RHEL55 * public_network_subnet_mask The Inbound/outbound IP address subnet mask for the provisioned instances of CA Infrastructure Management 2.1.2 on the public network. 16 Implementation Guide
Prepare the Deployment Worksheet Information needed Description Note the details here * public_network_default_gateway The Inbound/outbound IP address gateway for the provisioned instances of CA Infrastructure Management 2.1.2 on the public network. * MaaS-PerfCenter_public_network_ip The IP address for the provisioned instance of CA Performance Center on the public network. * MaaS-DataRepository_public_network_ ip * MaaS-DataCollector_public_network_ip * MaaS-DataAggregator_public_network _ip The IP address for the provisioned instance of Data Repository on the public network. The IP address for the provisioned instance of Data Collector on the public network. The IP address for the provisioned instance of Data Aggregator on the public network. * public_network_dns1 The DNS server for outbound IP address traffic for the provisioned instances of CA Infrastructure Management 2.1.2 on the public network. Appliance Properties of MaaS-DC * DC_public_network_subnet_mask The Inbound/outbound IP address subnet mask for the provisioned instances of Data Collector on the public network. Chapter 3: Installation 17
Prepare the Deployment Worksheet Information needed Description Note the details here * DC_public_network_default_gateway The Inbound/outbound IP address gateway for the provisioned instances of Data Collector on the public network. * DC_public_network_ip The IP address for the provisioned instance of Data Collector on the public network. * DC_hostname Data Collector hostname. DC_public_network_domainname Public network domain name. Default:oss.ca * DC_public_network_DNS1 The DNS server for outbound IP address traffic for the provisioned instances of Data Collector on the public network. Appliance Properties of MaaS-SOI3.0 kms_server_port win2008r2_prod_key The Key Management Services port number. Microsoft Windows Server 2008 R2 Standard 64-bit product key. * public_network_subnet_mask The Inbound/outbound IP address subnet mask for the provisioned instances of CA Service Operations Insight 3.0 on the public network. * public_network_default_gateway The Inbound/outbound IP address gateway for the provisioned instances of CA Service Operations Insight 3.0 on the public network. 18 Implementation Guide
Prepare the Deployment Worksheet Information needed Description Note the details here * MaaS-SOI_public_network_ip The IP address for the provisioned instance of CA Service Operations Insight 3.0 on the public network. * public_network_dns1 The DNS server for outbound IP address traffic for the provisioned instances of CA Service Operations Insight 3.0 on the public network. Appliance Properties of MaaS-SRM5.7.1 kms_server_port win2008r2_prod_key * public_network_subnet_mask * public_network_default_gateway * SRM_public_network_ip The Key Management Services port number. Microsoft Windows Server 2008 R2 Standard 64-bit product key. The Inbound / outbound IP address subnet mask for the provisioned instances of Service Response Monitoring (SRM) on the public network. The Inbound / outbound IP address gateway for the provisioned instances of Service Response Monitoring (SRM) on the public network. The IP address for the provisioned instance of Service Response Monitoring (SRM) on the public network. Chapter 3: Installation 19
Deploy Appliances Information needed Description Note the details here * public_network_dns1 The DNS server for outbound IP address traffic for the provisioned instances of Service Response Monitoring (SRM) on the public network. Deploy Appliances Deploying the appliances creates preconfigured virtual machines in your VMware ESX server. Use the OVF templates that are provided in each appliance to deploy the monitoring service cartridge. How to Deploy Monitoring Service Cartridge You can deploy the monitoring service cartridge using one of the following methods: Automatic Deployment Deploys the monitoring service cartridge automatically from CA CSDP, Deploy Monitoring Service-Central. Available if you have access to the VMware environment at your organization. Manual Deployment Deploys the monitoring service cartridge manually by deploying and configuring OVF templates using VMware vsphere Client. Required if you do not have access to the VMware environment at your organization. For more information, see Deploy the Monitoring Service Cartridge (see page 46). Automatic Deployment After you download the OVF templates and install OVF Tool, then you can deploy the templates through the service portal. You enter the virtual machine pool details and specify the virtual appliances location, in the Deploy monitoring Service-Central request form. The system automatically deploys the appliances, installs the monitoring service cartridge, and creates preconfigured virtual machines in your VMware ESX server you specified. 20 Implementation Guide
How to Deploy Monitoring Service Cartridge Perform the following procedures to complete the automatic deployment: 1. Install OVF Tool (see page 21) 2. Deploy OVF Templates (see page 21) Install OVF Tool Deploy OVF Templates Install the OVF Tool before you deploy the OVF templates automatically. For more information about the OVF Tool, go to www.vmware.com http://www.vmware.com.or see the VMware OVF Tool User Guide. This section describes how you install the OVF Tool to deploy OVF templates. Note: See the OVF Tool documentation for prerequisites and detailed installation procedure. Follow these steps: 1. Log in to the CA Process Automation system with administrator credentials. 2. Go to http://communities.vmware.com/community/vmtn/vsphere/automationtools/ovf www.vmware.com/vmtn/vsphere/automationtools/ovf 3. Click Download and extract the OVF Tool to the location where the appliances are copied. 4. Run the installer and complete the installation. 5. Restart the system. The OVF tool is installed. After you install the OVF Tool, complete the request form that captures the details for deploying the OVF templates for the monitoring service deployment. This section describes how you deploy the OVF templates. Follow these steps: 1. Log in to the service portal with administrator credentials. The home page opens. 2. Click Requests. A new page opens with the list of services. Chapter 3: Installation 21
How to Deploy Monitoring Service Cartridge 3. Click Register Services under Service Administration. A new page opens with the list of services to register. 4. Click Monitoring Service and click Deploy Monitoring Service-Central. By default, the form opens with the Automatic Deployment option. Important! The Deploy Monitoring Service-Central is a one-time task. The system does not allow you to redeploy the service. 5. Complete the details in the form and click Submit to deploy the OVF templates automatically. The predefined Manage Service Offerings (MSO) workflow starts automatically. The process instantiates, configures, activates, and tests the monitoring components and emails you the operation results. The system deploys the templates to the central location. You are notified that the monitoring service offering is available to be offered. The deployment of monitoring service cartridge is complete now. Manual Deployment Deploying the appliances creates preconfigured virtual machines on your VMware ESX Server. Use the OVF templates that are provided in each appliance to deploy the monitoring service cartridge. If your security policies or other considerations restrict share access to the ESX, select manual deployment through VMware vsphere Client. You can manually deploy monitoring service cartridge using VMware vsphere Client. You can deploy the templates using the VMware vsphere Client. Note: Use the worksheet to enter the specific values that are required during the deployment process. Follow these steps: 1. Log in to the VMware vcenter Server as an administrator using VMware vsphere Client. 2. Ignore the security warning and click Ignore to continue. 22 Implementation Guide
How to Deploy Monitoring Service Cartridge 3. Click File, Deploy OVF Template. The Deploy OVF Template window opens the Source option displays. Chapter 3: Installation 23
How to Deploy Monitoring Service Cartridge 4. Browse to the first template, and select the OVF template that you want to deploy and click Next. The OVF templates must be deployed in the following sequence: Important! Install the templates in the order specified in this guide because deployment and configuration are interdependent. We do not support any deviations from these deployment and configuration procedures. These procedures also assume that you have the required infrastructure and non-ca Technologies software installed. 1. MaaS-SOI3.0 2. MaaS-Spectrum9.2.2 3. MaaS-DSS 4. MaaS-SRM5.7.1 5. MaaS-IM2.1.2-RHEL55 6. MaaS-DC The OVF Template Details page opens and displays the details stored in the OVF template such as the download size, available disk size, and vendor name. 24 Implementation Guide
How to Deploy Monitoring Service Cartridge 5. Verify the template details and click Next. The Name and Inventory Location page opens and lets you add a name to identify the OVF and specify the datacenter where you want to provision the server. Chapter 3: Installation 25
How to Deploy Monitoring Service Cartridge 6. Enter the server name in the Name field, select the Inventory Location, and then click Next. Note: By default, the name that is specified in the OVF template displays in the Name field. Retain the default name for the template. The Resource Pool page opens. 26 Implementation Guide
How to Deploy Monitoring Service Cartridge 7. Select the resource pool on which you want to deploy the OVF templates. 8. Click Next. The Disk Format page opens. Chapter 3: Installation 27
How to Deploy Monitoring Service Cartridge 9. Select Thick Provision Lazy Zeroed. 10. Click Next. The Network Mapping page opens. 11. Select VM Network for all of the OVF templates. The Properties page opens to customize the software solution for this deployment. This page contains the Host settings. Note: The mandatory field descriptions are marked in red. 28 Implementation Guide
How to Deploy Monitoring Service Cartridge Chapter 3: Installation 29
How to Deploy Monitoring Service Cartridge 12. Enter the values for each field using the information that you gathered in the Deployment Worksheet and click Next. The Ready to Complete page opens and displays a summary of the details you entered in the previous pages. 13. Verify the entered details, select Power on after deployment, and then click Finish. 14. Repeat steps 1-13 to deploy the other templates and complete deployment of all OVF templates. The deployment of monitoring service cartridge is complete now. Verify Implementation After you deploy the appliances, verify that you can successfully log in to the virtual machines. Verify the following components: Verify CA Spectrum (see page 31) Verify CA Spectrum OneClick (see page 32) 30 Implementation Guide
How to Deploy Monitoring Service Cartridge Verify CA Performance Center (see page 32) Verify CA SystemEDGE (see page 33) Verify CA Spectrum Log in to the virtual machine where the SpectroSERVER is deployed to verify the deployment. Follow these steps: 1. Log in to the virtual machine with administrator credentials. Application: MaaS-Spectrum User Name: Administrator Password: 2. Click Start, All Programs, CA, and then start SPECTRUM Control Panel-MaaS-Spectrum. The CA Spectrum login page opens. 3. Log in to the system with administrator credentials. User Name: Chapter 3: Installation 31
How to Deploy Monitoring Service Cartridge Verify CA Spectrum OneClick 4. Ensure the SpectroSERVER status is RUNNING. If you can log in and access SpectroSERVER, the deployment was successful. Log in to the virtual machine where the CA Spectrum OneClick is deployed to verify the deployment. Follow these steps: 1. Log in to the virtual machine with administrator credentials. Application: MaaS-OneClick User Name: Administrator Password 2. Click Start, All Programs, CA, and then start CA Spectrum OneClick Console. The CA Spectrum OneClick login page opens. 3. Log in to the system with administrator credentials. Verify CA Performance Center The CA Spectrum OneClick home page opens. If you can log in and access CA Spectrum OneClick server, the deployment was successful. Log in to the virtual machine where the CA Performance Center is deployed to verify the deployment. 32 Implementation Guide
How to Deploy Monitoring Service Cartridge Follow these steps: 1. Log in to the virtual machine with administrator credentials. Application: MaaS-PerfCenter User Name: root Password 2. Click Start, All Programs, CA, and then start CA Performance Center. The CA Performance Center login page opens. 3. Log in to the system with administrator credentials. User Name: Password: Verify CA SystemEDGE The CA Performance Center home page opens. If you can log in and access CA Performance Center, the deployment was successful. Log in to the virtual machine where the CA SystemEDGE is deployed to verify the deployment. Follow these steps: 1. Log in to the virtual machine with administrator credentials. Chapter 3: Installation 33
How to Deploy Monitoring Service Cartridge 2. Click Start, All Programs, CA, and then start SystemEDGE Control Panel. The SystemEDGE Control Panel page opens. 3. Ensure the CA SystemEDGE status is Started. If you can log in and access CA SystemEDGE Control Panel, the deployment was successful. 34 Implementation Guide
How to Deploy Monitoring Service Cartridge Synchronize Appliance Dates, Times, and Timezones You must synchronize the dates, times, and timezones of your Windows and Linux appliances for proper CA CSDP functioning. For assistance synchronizing Windows appliances, see the instructions provided with your Windows appliances. The commands in this section assist with Linux synchronization only. The following command returns the date, time, and timezone: # date The timezone is controlled by the file /etc/localtime. You can use the remaining commands as an example to adjust your timezone. The following commands will delete the file: # cd /etc # rm localtime Note: U.S. time zones are located under the directory /usr/share/zoneinfo/us. The following commands demonstrate how to set the timezone to Eastern US time by linking the Eastern file to /etc/localtime: # cd /etc # ln -s /usr/share/zoneinfo/us/eastern localtime You can verify your changes by re-running the date command: # date Chapter 3: Installation 35
Chapter 4: Add CA CSDP Servers You must add CA CSDP servers for the Monitoring Service before offering the service to customers. Adding CA CSDP servers for the Monitoring Service requires the following tasks: Stopping the CA Spectrum connector in CA Service Operations Insight Discovering CA CSDP components in CA Spectrum Creating a service in CA Spectrum Starting the CA Spectrum connector in CA Service Operations Insight The following table contains the list of components for CA CSDP. You can reference the table when adding the servers to the Monitoring Service. Component Name Hostname SQL Active Directory Server CA SiteMinder CA EEM CA Service Catalog Server CA Service Desk Manager CA Process Automation CA Virtual Assurance for Infrastructure Managers CA Spectrum CA Service Operations Insight CA Performance Center CA Business Intelligence oss-sql1 oss-sql2 oss-dc oss-sso oss-eem1 oss-eem2 oss-sc1 oss-sc2 oss-sdm1 oss-pam1 oss-pam2 oss-vaim mass-spectrum mass-oneclick mass-soi mass-perfcenter mass-imda mass-imdc mass-imdr oss-sdm2 Chapter 4: Add CA CSDP Servers 37
Stop CA Spectrum Connector Stop CA Spectrum Connector Shutting down the CA Spectrum Connector is the first step in adding the CA CSDP servers. Follow these steps: 1. Log in to CA Service Operations Insight. 2. Click the Administration tab. 3. In the left tab, expand Administration, Connector Configuration, and the CA Service Operations Insight hostname link. 4. Click the name of the CA Spectrum Connector. 5. On the right side of the page, click stop, and wait for the Connector Status to display Offline. The CA Spectrum Connector stops and you can log off. 38 Implementation Guide
Discover CA CSDP Components in CA Spectrum Discover CA CSDP Components in CA Spectrum This procedure discovers and configures the CA CSDP server components in Spectrum. Follow these steps: 1. Log in to CA Spectrum OneClick console. 2. From the menu bar, click Tools, Utilities, and Discovery Console. The Discovery Console window opens. 3. Right-click Global Configurations. 4. Enter the name of the configuration, select the landscape, and click OK. 5. Expand Global Configurations, and select the new configuration. 6. Enter the hostname and IP address for each CA CSDP component, and click Add. 7. Set the SNMP Community String. 8. Click the Discover button. The CA CSDP components are discovered and display under the Modeling tab. 9. Close the Discovery Console window. The discovered hostnames and ip addresses display under the Universe Folder. 10. Perform the remaining steps for each discovered host. 11. Expand the Spectrum landscape, expand Universe, and click the Host IP Address. 12. From the right panel, click the Attributes tab. 13. Double-click the following attributes: USER_AssetID Model_Name zservice Security_String The attributes display in the right pane. 14. Select the Edit button above the selected attributes. A window opens for editing the attributes. 15. Un-check the No Change boxes, and enter the following values: USER_AssetID: SOI_IMPORT_CSDP Model_Name: Hostname zservice: CSDP.MonitoringService Security_String: ServiceProvider 16. Click OK. Chapter 4: Add CA CSDP Servers 39
Create a Service in CA Spectrum 17. From the Attribute Edit Results window, click the Close button. The CA CSDP components are configured in Spectrum. Create a Service in CA Spectrum You need to create a new service in Spectrum that associates the CA CSDP servers. Follow these steps: 1. Log on to CA Spectrum OneClick console. 2. From the menu bar, select Tools, Utilities, and Service Editor. The Service Editor window opens. 3. Click the Create button. 4. In the Create Service window, enter or select the following: Name: ServiceProvider.CSDP Criticality: High Security String: ServiceProvider Generate Service Alarms: Yes Description: SOI_IMPORT_CSDP 5. From the Create Service window, click the search button. The Locate Resources window opens. 6. Expand Devices, All Devices. 7. Select the CA CSDP components. 8. Click the button Add Selected to Monitored Resources. 9. Click the create button. 10. Click OK in the Add Service window. The Spectrum service is complete. 40 Implementation Guide
Start the CA Spectrum Connector Start the CA Spectrum Connector The final step of the process involves restarting the CA Spectrum connector in CA Service Operations Insight. Follow these steps: 1. Log in to CA Service Operations Insight. 2. Click the Administration tab. 3. In the left tab, expand Administration, Connector Configuration, and the CA Service Operations Insight hostname link. 4. Click the name of the CA Spectrum Connector. 5. On the right side of the page, click Start, and wait for the Connector Status to display Online. You have configured CA CSDP servers for Monitoring Service. Chapter 4: Add CA CSDP Servers 41
Appendix A: Server Access Credentials and Port List This worksheet provides server names and credentials to help you during the installation and verification of each product. During some product installations and configurations, you provide specific data from other products such as server names, administrator credentials. You can refer to this worksheet to complete the required fields easily. CA Spectrum Host Name Server Name Administrator User Name Administrator Password Application Name Application User Name MaaS-Spectrum Administrator Austin@123 Spectrum 9.2 SpectroServer Application Password Austin@123 EI Manager Port Default: 8083 CMS Port 6400 Tomcat Port 8080 CA Spectrum OneClick Server Host Name Server Name Administrator User Name Administrator Password Application Name Application User Name Application Password MaaS-OneClick Administrator Austin@123 Spectrum 9.2 OneClick Server Austin@123 Chapter 4: Add CA CSDP Servers 43
Start the CA Spectrum Connector OneClick Port Default: 80 CA Service Operations Insight Host Name Server Name Administrator User Name Administrator Password MaaS-SOI Administrator Austin@123 Application Name Service Operations Insight 3.1 Application User Name Application Password Austin@123 Tomcat Shutdown Port Default: 7095 Tomcat HTTP Port Default: 7090 Tomcat SSL Port Default: 7493 Logic Server UCF broker port Default: 8020 SOI SQL Server port 1433 User interface shutdown port 7005 User interface HTTP port 7070 User interface SSL port 7403 SOI ActiveMQ port 61616 CA Performance Center Host Name Server Name Administrator User Name Administrator Password Application Name Application User Name MaaS-PerfCenter root Austin@123 IM 2.1.2 Performance Center 44 Implementation Guide
Start the CA Spectrum Connector Application Password Austin@123 Port CA Infrastructure Management Data Repository Host Name Server Name Administrator User Name Administrator Password Application Name MaaS-IMDR root Austin@123 IM 2.1.2 Data Repository Application User Name Application Password Austin@123 Port CA Infrastructure Management Data Aggregator Host Name Server Name Administrator User Name Administrator Password MaaS-IMDA root Austin@123 Application Name IM 2.1.2 Application User Name Data Aggregator Application Password Austin@123 Port CA Infrastructure Management Data Collector Host Name Server Name MaaS-IMDC Chapter 4: Add CA CSDP Servers 45
Deploy the Monitoring Service Cartridge Administrator User Name Administrator Password root Austin@123 Application Name IM 2.1.2 Application User Name Data Collector Application Password Austin@123 Port Deploy the Monitoring Service Cartridge You deploy the Monitoring as a Service (MaaS) cartridge to make the services or cartridge available to customers after implementation. By default, only the service provider administrator has rights to deploy and maintain the cartridge. Register Services After you purchase and download the cartridge, customers can register for the service. The following deployment choices specify the size and scalability of monitoring components: Deploy Monitoring Service - Central Supports 2,500 devices and 100,000 interfaces by default. Important! The central deployment is a one-time task. The system does not allow you to redeploy the service. Deploy Monitoring Service - Regional Supports an extra 2,500 devices and 100,000 interfaces. Add regional deployment to add more devices and interfaces to the centrally deployed resources. 46 Implementation Guide
Deploy the Monitoring Service Cartridge Deploy Monitoring Service - Central You provide the deployment details for a central deployment using the service portal form to register the service. You must first select the central deployment option. After you deploy the service centrally select the regional deployment option to deploy the services in one of the regions. The service portal lets you deploy the monitoring services automatically or manually. Select the automatic deployment to deploy multiple components by providing minimal details. If you have any system limitations to the automatic deployment, select the manual deployment. Important! Do not abort the CA Process Automation flow while deploying the monitoring service or registering tenants. Follow these steps: 1. Log in to the service portal. 2. Click Requests, Register Services, Monitoring Service. The Monitoring Service page opens. 3. Click Deploy Monitoring Service - Central A form opens with the fields for defining vcenter and ESX information, along with the IP addresses of servers and data sources in the deployment. 4. Complete the form with the necessary information, and click Submit. You have now deployed the service. You receive an email that describes the type of deployment requested. The email contains a link that directs you to CA Process Automation to complete the task. Chapter 4: Add CA CSDP Servers 47
Deploy the Monitoring Service Cartridge Deploy Monitoring Service - Regional Add regional deployment to add more devices and interfaces to the centrally deployed resources. Follow these steps: 1. Log in to the service portal. 2. Click Requests, Register Services, Monitoring Service. The Monitoring Service page opens. 3. Click Deploy Monitoring Service - Regional A form opens with the following fields for defining credentials for deployment components. 4. In the Automatic Deployment field, select the check box to enable automatic deployment. Un-check the check box for manual deployment. 5. Complete the remaining form fields, and click Submit. You have now deployed the service. You receive an email that describes the type of deployment that is requested. The email contains a link that directs you to CA Process Automation to complete the task. Configure CA Spectrum Following a Regional Deployment After a regional deployment of the monitoring service, CA Spectrum and CA Service Operations Insight require specific configurations as outlined in the following sections: Load CA Spectrum Landscape Content (see page 49) Install the CA Spectrum IM Connector (see page 50) Set the Connector Controls (see page 51) 48 Implementation Guide
Deploy the Monitoring Service Cartridge Load CA Spectrum Landscape Content The first task of this process adds new model types to the CA Spectrum landscape. Follow these steps: 1. From the Windows start menu, start the CA Spectrum control panel as the initial Spectrum user. If prompted for a server, select the server you are executing this procedure on. 2. Click Stop SpectroSERVER. 3. In the confirmation dialog, select Yes. 4. After the status states INACTIVE, copy Model.Attribute.Extenstions.xml to SpectroSERVER. 5. In the Spectrum Content Directory, navigate to the ModelExtension directory. 6. Right-click the file Model.Attribute.Extensions.xml, and select Copy. 7. Navigate to SpectroSERVER. 8. Paste the file Model.Attribute.Extension.xml. 9. With the dbtool, import Model.Attribute.Extensions.xml. 10. Return to the Spectrum Control Panel, and click Start SpectroSERVER. 11. Verify the status states Running, which may take several minutes. You have successfully loaded the CA Spectrum landscape content. Chapter 4: Add CA CSDP Servers 49
Deploy the Monitoring Service Cartridge Install the CA Spectrum IM Connector This section details the process of installing the CA Spectrum IM Connector through the CA Service Operations Insight server. Follow these steps: 1. Log in to CA Service Operations Insight server as an administrator. 2. Run the Spectrum IM Connector executable. 3. Accept the license agreement, and click Next. 4. Check the box Configure Additional Instance, and click Next. 5. Enter the following values, and click Next: MDR Connector Hostname: mass-soi Spectrum Server Host: mass-dss1 6. Provide the OneClick credentials, and click Next. 7. Select the check box Start Services, and click Next. 8. Click Install. 9. From the pop-up, select No to All. 10. Click Done. 11. Log in to the CA Service Operations Insight application. You have installed the CA Spectrum IM Connector. 50 Implementation Guide
Deploy the Monitoring Service Cartridge Set the Connector Controls Setting the connector controls in CA Service Operations Insight is the final step of this configuration. This process involves starting and stopping services with the CA Service Operations Insight application. Follow these steps: 1. Log in to the CA Service Operations Insight application. 2. Select the Administration tab. 3. In the menu on the left, expand the Administration link. 4. Expand the Connector Configuration link. 5. Expand the SOI Host Name link. 6. Click the CA Spectrum Connector name. 7. On the right side of the page, check the following boxes: dns_resolution getcisatstartup getrelationshipsatstartup isremotable performdeltaprocessing usealertfilter useservicefilter 8. Click Save, and after the Connector Status states online, click Start. 9. Log in to the CA Service Operations Insight server. 10. Open the Services window. 11. Stop the following services: CA SAM Integration Services CA SAM Event Management 12. Start the following services: CA SAM Integration Services CA SAM Event Management You have successfully set the CA Service Operations Insight connector controls. Chapter 4: Add CA CSDP Servers 51
Appendix B: Troubleshooting and Best Practices Configuring a Tenant in CA Service Operations Insight For a tenant to successfully register for Monitoring Service, you must configure CA Service Operations Insight accordingly. Configurations are required for each tenant that is registering for Monitoring Service by the service provider administrator. Each tenant requires that you: Create a tenant group Create alert queues Add users to the tenant group Grant access permission to the group Create a Service Level Agreement (SLA) for the Monitoring Service of a Tenant Chapter 4: Add CA CSDP Servers 53
Configuring a Tenant in CA Service Operations Insight Create a Tenant Group Follow these steps: 1. Log in to CA Service Operations Insight with the following credentials: Username: samuser Password: Austin@123 2. From the navigation pane on the left, click Users. 3. Click New Groups. A dialog opens. 4. Enter the exact tenant name in the Name field. 5. Change the value of Privilege Set to the value Operator. 6. Expand the folders and subfolders located under Privileges, and enable the following privileges: Alert Management Acknowledge Alerts Clear Alerts Configuration Item Management Launch in Context Message Dashboard Policies Tabs Console Link Dashboard Tab Google Earth Link Report Link Component Details Information Tab General Information Alert Details Tab Alert History Tab Alerts Tab Root Cause Tab Service Impact Tab Contents Alerts Tab 54 Implementation Guide
Configuring a Tenant in CA Service Operations Insight CMDB View Tab List Tab Services Tab Topology Tab Navigation Alert Queues Tab Services Tab View Alerts View Configuration Items 7. Click OK. The tenant group is built. Create Queue Alerts Follow these steps: 1. Log in to CA Service Operations Insight with the following credentials: Username: samuser Password: Austin@123 2. From the navigation pane on the left, click Alert Queues. 3. Create six new alert queues for the tenant according the following table: Queue Name Queue Criteria Assign Escalation Polices tenant.application tenant.business tenant.database AND TenantID equal to "tenant name" User Attribute (1) Starts with "APP" AND TenantID equal to "tenant name" User Attribute (1) Starts with "BTM" AND TenantID equal to "tenant name" User Attribute (1) Starts with "DBA" Application.Database Business Application.Database tenant.device AND TenantID equal to "tenant name" Family equal to "Hardware" Devic e Chapter 4: Add CA CSDP Servers 55
Configuring a Tenant in CA Service Operations Insight Queue Name Queue Criteria Assign Escalation Polices tenant.service tenant.uncategorized AND Class Equal To "Service" Source Does Not Contain "SOI" Tenant ID Equal to "tenant name" AND TenantID Equal To "tenant name" User Attribute (1) Starts With "ESM" Service Device Add Users to the Tenant Group Follow these steps: 1. Log in to CA Service Operations Insight with the following credentials: Username: samuser Password: Austin@123 2. Log In to CA Service Operations Insight and select Console. 3. From the navigation pane on the left, click Users. 4. Under the Users tab, click the New Groups button. 5. Select the specific tenant group, hover the mouse over it, and select Add User. 6. From the pop-up, select All Users and click OK. A menu opens listing the servers defined in CA EEM and the LDAP. 7. Select the user from the list and click OK. The new user is added to the Tenant User Group with the appropriate CA Service Operations Insight privileges. 56 Implementation Guide
Configuring a Tenant in CA Service Operations Insight Grant Access Service Privileges to a Tenant Group Follow these steps: 1. Log in to CA Service Operations Insight with the following credentials: Username: samuser Password: Austin@123 2. Open the CA Service Operations Insight console, and click the Services tab in the navigation pane on the left. 3. Select and right click the service, and select Add User/Group Access. The Select Users/Groups window opens. 4. Select the tenant group. 5. Click OK. The CA Service Operations Insight configuration is complete, and the tenant can be registered for Monitoring Service. Chapter 4: Add CA CSDP Servers 57
Configuring a Tenant in CA Service Operations Insight Create SLA for Tenant Monitoring Service These section documents how to create an SLA for a tenant in CA Service Operations Insight. Follow these steps: 1. Log in to CA Service Operations Insight with the following credentials: Username: samuser Password: Austin@123 2. Open the CA Service Operations Insight console, and click the Services tab in the navigation pane on left. 3. Right-click on the Service and select Edit Service. The Service Modeler window opens. 4. Click the SLA tab. 5. Complete the following fields: Service Level Objective Name SLO Definition SLO Period (Click Select and choose "Every data at 12:00 AM starting <date>" and click OK.) Business Hours: 24/7 6. Click OK. The SLA is complete. 58 Implementation Guide
Restart or Power Down CA Spectrum Restart or Power Down CA Spectrum Before shutting down or restarting the CA Spectrum machine, you must always first stop SpectroSERVER services. If the services are not first shut down, an error is raised. In addition to the error, if SpectroSERVER is not shut down before powering off, you must manually start it again. Follow these steps: 1. Log into the virtual machine hosting CA Spectrum with administrator credentials. 2. Click Start, All Programs, CA, and start the Spectrum Control Panel. Select MaaS-Spectrum for the host if requested. 3. Select one of the following: Stop SpectroSERVER Start SpectroSERVER You can safely shut down, restart, or resume CA Spectrum. Chapter 4: Add CA CSDP Servers 59
Add New Domains for Monitoring Add New Domains for Monitoring If a tenant needs new domains added for monitoring, the service provider administrator must manually add the domains to the group in CA Infrastructure Management. Follow these steps: 1. Log in to the CA Infrastructure Management Performance center with administrator credentials at http://<performance-center_host>:8181/pc/desktop/page. 2. Click the Admin tab. 3. Select Groups. 4. Under All Groups, expand the tenant_name. 5. Click <tenant_name>, <support_department>, <region>.monitoringservice. 6. From the pane on the right, select the Rules tab. 7. Click Add Devices. 8. Click edit. A pop-up window opens. 9. In the second row, click the plus symbol. A new field displays below the existing field. 10. Enter the value of the new domain in the field. 11. Click OK, and click Save. The new domain is added to the existing group in CA Infrastructure Management. 60 Implementation Guide
Add Permission for a User to View Reports Add Permission for a User to View Reports If a user is not part of the SAM Reports group in CA Business Intelligence, they see a blank report. Add the user for them to access CA Service Operations Insight reports in CA Business Intelligence. Follow these steps: 1. Log in to CA Business Intelligence CMC with administrator credentials at http://ca Business Intelligence: 8080/CmcApp/logon.faces 2. Select Users and Groups from the drop-down list. 3. Expand the Group Heirarchy under Manage in the left pane. 4. Select SAM Reports. A list of users or groups who have access to SAM Reports appear in the right pane. 5. Click the Actions drop-down list and select Add Members to Group. The Add Members to Group window opens. 6. Select User List. A list of users appears in the Available Groups list. 7. Select the user and move it to the Selected Groups pane. 8. Click OK. The selected user now appears in the list of users who have access to SAM Reports. Remove Permission to Reports If you want to remove permission for a user to view CA Service Operations Insight reports, complete the following action. Follow these steps: 1. Log in to CA Business Intelligence CMC with administrator credentials at http://ca Business Intelligence: 8080/CmcApp/logon.faces 2. Select Users and Groups from the drop-down list. 3. Expand the Group Hierarchy under Manage in the left pane. 4. Select SAM Reports. A list of users or groups who have access to SAM Reports appear in the right pane. 5. Click the Actions drop-down list and select Remove. The selected user is now removed from the list of users with access to SAM Reports. Chapter 4: Add CA CSDP Servers 61