CA Business Intelligence
for CA Service Desk
Manager
USE CASES AND BEST PRACTICES FOR INTEGRATING CA BUSINESS
LEGAL NOTICE
This publication is based on current information and resource allocations as of its date of publication and is
subject to change or withdrawal by CA at any time without notice. The information in this publication could
include typographical errors or technical inaccuracies. CA may make modifications to any CA product, software
program, method or procedure described in this publication at any time without notice.
Any reference in this publication to non-CA products and non-CA websites are provided for convenience only and
shall not serve as CAs endorsement of such products or websites. Your use of such products, websites, and any
information regarding such products or any materials provided with such products or at such websites shall be at
your own risk.
Notwithstanding anything in this publication to the contrary, this publication shall not (i) constitute product
documentation or specifications under any existing or future written license agreement or services agreement
relating to any CA software product, or be subject to any warranty set forth in any such written agreement; (ii)
serve to affect the rights and/or obligations of CA or its licensees under any existing or future written license
agreement or services agreement relating to any CA software product; or (iii) serve to amend any product
documentation or specifications for any CA software product. The development, release and timing of any
features or functionality described in this publication remain at CAs sole discretion.
The information in this publication is based upon CAs experiences with the referenced software products in a
variety of development and customer environments. Past performance of the software products in such
development and customer environments is not indicative of the future performance of such software products in
identical, similar or different environments. CA does not warrant that the software products will operate as
specifically set forth in this publication. CA will support only the referenced products in accordance with (i) the
documentation and specifications provided with the referenced product, and (ii) CAs then-current maintenance
and support policy for the referenced product.
Certain information in this publication may outline CAs general product direction. All information in this
publication is for your informational purposes only and may not be incorporated into any contract. CA assumes no
responsibility for the accuracy or completeness of the information. To the extent permitted by applicable law, CA
provides this document AS IS without warranty of any kind, including, without limitation, any implied warranties
of merchantability, fitness for a particular purpose, or non-infringement. In no event will CA be liable for any loss
or damage, direct or indirect, from the use of this document, including, without limitation, lost profits, lost
investment, business interruption, goodwill or lost data, even if CA is expressly advised of the possibility of such
damages.
ACKNOWLEDGEMENTS
Principal Authors
The following individuals are the principal authors for this guide:
Yobany Amaya
Amy Chenard
Paul Coccimiglio
Richard Lankester
Anders Magnusson
Ashfaquddin Mohammed
Raghu Rudraraju
Vinod Subburaj
Christophe Trinquet
The principal authors and CA Technologies would like to thank the following contributors:
Tunji Abiri
Patrick Maloney
David Messineo
Christopher Milazzo
Roya Montazeri
Richard Oubre
Lao Scotto Tan
Anita Taucher
Steven Troy
Paul Vidal
Shawn Walsh
CA Services
Development
Engineering Services
Marketing
QA
Support
Technical Sales
Technical Information
Third-Party Acknowledgments
Microsoft product shots reprinted with permission from Microsoft Corporation. Microsoft and
Windows are registered trademarks of Microsoft Corporation in the United States and other
countries.
BusinessObjects and the BusinessObjects logo, BusinessObjects, Crystal Reports, Crystal
Decisions, Web Intelligence, Xcelsius, and other BusinessObjects products and services
mentioned herein as well as their respective logos are trademarks or registered trademarks of
BusinessObjects Software Ltd. BusinessObjects is an SAP company.
Forward, Inc. Legal Notice
Forward, Inc. is a fictitious company name which is used strictly for instructional purposes only
and is not meant to reference an existing company.
CA Business Intelligence
FEEDBACK
Please email us at greenbooks@ca.com to share your feedback on this publication. Please
include the title of this publication in the subject of your email response. For technical assistance
with a CA Technologies product, please contact CA Support at http://ca.com/support. For
assistance with support specific to Japanese operating systems, please contact CA Technologies
at http://www.casupport.jp.
Contents
Chapter 1: Overview
13
Introduction ................................................................................................................................................ 13
About this Guide ......................................................................................................................................... 14
Integration Planning .................................................................................................................................... 14
17
Overview ..................................................................................................................................................... 17
Client Tools.................................................................................................................................................. 17
Job Roles and Client Tools ........................................................................................................................... 20
CA Business Intelligence Servers ................................................................................................................. 22
How BusinessObjects Enterprise Processes Information ............................................................................ 28
Logging in to BusinessObjects Enterprise ................................................................................................ 28
Viewing a Crystal Report On Demand ..................................................................................................... 30
Viewing a Web Intelligence Document On Demand ............................................................................... 32
Setting a Schedule for Crystal Reports .................................................................................................... 34
CA Business Intelligence and CA Service Desk Manager Communication ................................................... 35
Querying CA Service Desk Manager with BusinessObjects Enterprise .................................................... 36
CA Service Desk Manager and BusinessObjects Enterprise Authentication Integration Details ................. 37
39
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation
with One Server) ......................................................................................................................................... 39
CA Business Intelligence Hardware Requirements .................................................................................. 39
The Central Management Server (CMS) Database .................................................................................. 40
Install CA Business Intelligence (SQL Server) ........................................................................................... 44
Configure CA Business Intelligence ......................................................................................................... 50
Integrate CA Business Intelligence and CA Service Desk Manager .......................................................... 55
63
Overview ..................................................................................................................................................... 63
How CA Service Desk Manager Integrates with CA Business Intelligence ................................................... 63
Complex Reporting Scenario ....................................................................................................................... 64
Required Server Configurations .............................................................................................................. 65
How to Implement a Complex Reporting Infrastructure............................................................................. 66
Step 1 - Create the File Shares for CA Business Intelligence ................................................................... 67
Step 2 - Install the First Server in the Intelligence Tier of CA Business Intelligence ................................ 68
Step 3 - Install the CA Business Intelligence Web Application Tier Servers ............................................. 80
Step 4 - Install the Second Server in the Intelligence Tier of CA Business Intelligence ........................... 87
Step 5 - Install the CA Business Intelligence Processing Tier Servers ...................................................... 96
Step 6 - Configure the Input and Output File Repository Servers ......................................................... 102
Step 7 - Configure the CA Business Intelligence Tiers (Enable and Disable the Server Components) ... 105
Step 8 - Configure CA Business Intelligence .......................................................................................... 107
Summary ................................................................................................................................................... 108
111
Multi-Tenancy ............................................................................................................................................111
Implement Tenant Restrictions in CA Service Desk Manager ....................................................................111
Configure CA Business Intelligence for Multi-Tenancy ..............................................................................113
Configure CA Business Intelligence for Multi-Tenancy (LDAP Authentication)..........................................116
119
Overview ....................................................................................................................................................119
Configuration Planning ..............................................................................................................................120
Configuration Considerations ....................................................................................................................121
How to Configure CA Business Intelligence with a Replicated Reporting Database ..................................122
Install and Configure the Production Instance of CA Service Desk Manager .........................................123
Install a Reporting Database Server .......................................................................................................123
How to Install and Configure the Reporting Instance of CA Service Desk Manager ..............................123
Configure and Publish the Replication Snapshot of the Production Database ......................................129
Configure the Reporting Database to Subscribe to the Published Replication Data..............................146
Install and Configure CA Business Intelligence ......................................................................................156
Configure Reporting on the Production Instance of CA Service Desk Manager .....................................157
Considerations ...........................................................................................................................................157
Web Screen Painter ...............................................................................................................................157
Sharing the CA MDB with Other CA Technologies Solutions..................................................................164
Archiving ................................................................................................................................................165
Chapter 7: Upgrading
167
Overview ....................................................................................................................................................167
How to Upgrade to BusinessObjects XI Release 3.1 ..................................................................................167
Upgrade the BusinessObjects Installation .............................................................................................168
Configure the CA Business Intelligence Installation ...............................................................................173
Verify that CA Service Desk Manager Works Correctly ..........................................................................175
Verify that CA Business Intelligence Release 3 Works Correctly ............................................................175
Review the Installation Log Files ............................................................................................................178
179
Chapter 9: Auditing
199
Overview ....................................................................................................................................................199
Audit the Central Management Server ..................................................................................................199
Audit the Job Servers .............................................................................................................................201
205
8 Contents
229
275
341
Overview ....................................................................................................................................................341
The Crystal Reports Editor .........................................................................................................................341
How to Create a Report .............................................................................................................................342
The Data Direct ODBC Driver .....................................................................................................................343
Install the Data Direct ODBC Driver ...........................................................................................................344
Create a Crystal Report Using the Data Direct ODBC Driver ......................................................................349
Create a Crystal Report Using the CA Service Desk Manager Universe .....................................................357
365
373
385
Overview ....................................................................................................................................................385
How to Map CA Service Desk Manager Fields ...........................................................................................385
Step 1 - Decide What CA Service Desk Manager Fields to Analyze ........................................................386
Step 2 - Map the Fields to their Attribute Names ..................................................................................386
Step 3 - Map the Fields to their Object ..................................................................................................388
Step 4 - Look up Valid Values in the SREL Table .....................................................................................389
10 Contents
Index
391
Chapter 1: Overview
Introduction
Business Intelligence is an iterative user-centric process that includes accessing, exploring, and
analyzing information, developing insights, and gaining an in-depth understanding. This process
leads to improved and informed decision making.
An effective Business Intelligence architecture helps provide the following benefits:
Increase sales
Streamline operations
Reduce costs
Integration Planning
To help you plan for a successful CA Business Intelligence and CA Service Desk Manager
integration, use the following information to research and gather information.
Documentation. Read the documentation for CA Service Desk Manager (specifically, the
Release Notes, Implementation Guide, and Administration Guide) and the CA Business
Intelligence Implementation Guide. You can find this documentation on the CA Service
Desk Manager section of the CA Support website at http://ca.com/docs. This
documentation helps you understand the architecture, installation, configuration, and
creation of reports and dashboards in CA Business Intelligence.
14 Chapter 1: Overview
Integration Planning
Logical Data Model. Become familiar with the logical data model (previously named
Entity Relationship Diagram) for CA Service Desk Manager and CA Business Intelligence.
For each CA Service Desk Manager object, the data model presents an object mapping
between the object attributes in CA Service Desk Manager and the associated CA
Business Intelligence Universe label names, and the data type for each CA Service Desk
Manager attribute.
You can find a copy of the logical data model at the following locations:
The CA Service Desk Manager Technical Document Index on the CA Support website
at http://ca.com/support. On the CA Service Desk Manager Technical Document
Index, search for TEC480060 (CA Service Desk Manager Release 12) and TEC394113
(CA Service Desk Manager Release 11.x).
Note: The SAP Help Portal (http://help.sap.com) contains documentation and additional
resources that are related to many SAP solutions, including the Universe Designer and
Web Intelligence reports. Click the SAP BusinessObjects tab and click All Products on the
left. You can access solution portfolio knowledge center options and find the
appropriate product and solution documentation.
Integration Planning
Name Conflicts. Avoid potential name conflicts with Universes, user names, and groups
by making them truly common or unique.
Backup and Restore - CA Business Intelligence has specific backup and restore procedures
that you must follow. For more information about the backup and restore procedures for CA
Business Intelligence, navigate to the SAP Community Network at
http://www.sdn.sap.com/irj/boc/index and search for BusinessObjects Enterprise XI 3.1
Backup and Recovery Best Practices.
Environment Sizing - CA Business Intelligence has environment sizing guidelines that SAP
provides. For more information about the environment sizing guidelines for CA Business
Intelligence, navigate to the SAP Community Network at
http://www.sdn.sap.com/irj/boc/index and search for Enterprise XI R2 Sizing
Recommendations Guide.
16 Chapter 1: Overview
Client tools
This chapter discusses the individual roles of the BusinessObjects Enterprise components and
how they interact with each other and with the data sources.
Client Tools
The client tools are rich client applications that provide users with access to BusinessObjects
Enterprise Server functions. The client tools are only available for Windows-based operating
systems. However, the tools can connect to servers running on other operating systems. CA
Business Intelligence includes the following client tools:
Client Tools
Desktop Intelligence
While an unregistered version of Desktop Intelligence is provided with the CA Business
Intelligence installation, it is not supported for use with CA Service Desk Manager.
Import Wizard
The Import Wizard is a thick-client application that administrator can use to import users,
groups, objects, or folder content from other Crystal or BusinessObjects Enterprise
deployments.
Client Tools
Publishing Wizard
The Publishing Wizard is a thick-client application that administrators or data managers can
use to add files to the CA Business Intelligence repository as a batch process. As a result, any
CA Business Intelligence supported file (Crystal Reports, Microsoft Word documents, PDF
files) can be placed into the InfoView interface for access by end users.
Query Builder
The Query Builder is a web-based application that administrators can use to query the CA
Business Intelligence metadata in the CMS database.
Translation Manager
The Translation Manager is a thick-client application providing a framework for report
designers to support multilingual reports. A designer can create one report for a multilingual
audience instead of creating a report for each language. Using the Translation Manager, you
translate the Universe and report metadata. The translations are saved in the Universe and
report documents, and display in the language of the reader at query and reporting time.
Note: For information about how to create custom or derived Universes, see the CA Service
Desk Manager Implementation Guide.
Universe Builder
The Universe Builder is a thick-client application that administrators and data managers can
use to create Universes from XML metadata sources and Oracle Analytic Services.
Web Intelligence
Web Intelligence is a web-based application that provides business users with an interactive
and flexible interface to build reports and analyze the data in the organization.
Crystal Reports Designer (purchased separately from SAP) is an additional client tool that is not
included with CA Business Intelligence, but is often used to create and modify Crystal Reports.
Database experts and application developers can use Crystal Reports Designer to create and
integrate complex reports for users to view in InfoView.
Note: You can use InfoView to view Crystal Reports natively. However, the Crystal Reports
Designer component is required to modify or create Crystal Reports.
Business Users
InfoView
Web Intelligence
Administrators
InfoView
Designer
Diagnostic Tool
Import Wizard
Publishing Wizard
Query Builder
Universe Builder
Report Designers
InfoView
Publishing Wizard
Translation Manager
Web Intelligence
Data Manager
InfoView
Designer
Publishing Wizard
Universe Builder
Replication Service
Business Process BI Service. Receives report requests from the web application and
coordinates activities that are necessary to return the processed report in response.
Client Auditing Proxy Service. Collects auditing information from Rich Desktop and Web
Intelligence Clients.
Connection Server
The Connection Server is responsible for handling connection and interaction with data
sources. This server hosts the following service:
Crystal Reports Cache Service. Creates and maintains a cache of recently viewed reports.
Dashboard Server
The Dashboard Builder uses the Dashboard Server to create and manage dashboards. This
server hosts the following service:
Dashboard Service
Event Server
The Event Server monitors the system for file-based events that can act as a trigger to
execute a report. The Event Server notifies the CMS to help ensure that all configured jobs
are initiated as appropriate in response to the event. This server hosts the following service:
PM Metrics Server
The Dashboard and Analytics Server use the PM Metrics Server to populate the metrics that
are created using the Metric Engine. This server hosts the following service:
PM Repository Server
The Dashboard and Analytics Server use the PM Repository Server to read and store
performance information from the Dashboard and Analytics repository. This server hosts the
following service:
PM Rules Server
The Dashboard and Analytics Server use the PM Rules Server to create rules and alerts. The
rules and alerts can be used to automate the actions in response to specific events. This
server hosts the following service:
PM Rules Service
Replication Service
Replication Service
The following sample block diagram includes the complete list of all BusinessObjects client and
server components. This sample diagram is provided to help you understand how the various
components work together. Not all components in this diagram are delivered with CA Business
Intelligence.
2.
3.
4.
Step 1 - The request originates from a web client (for example, InfoView) as is passed using
the Web Server to the Web Application Server.
2.
Step 2 - The Web Application Server processes the login request where it determines that
the request is a login request. Based on the authentication type, the Web Application Server
sends the appropriate credentials to the CMS for authentication.
3.
Step 3 - The CMS validates the credentials using the appropriate authentication method and
confirms the access permissions for the user in the CMS System database. After successful
validation, the CMS creates a session for the user in its own memory.
4.
Step 4 - The CMS then sends a response to the Web Application Server indicating that the
validation was successful. The Web Application Server generates a login token for the user
session in its memory. For the rest of the session, the Web Application Server uses the login
token to validate the user.
5.
Step 5 - At this point, the Web Application Server generates the response to return to the
client, which is sent using the Web Server rendered in the Web Client.
Step 1 - The Web Client (for example, InfoView) sends the view on demand report request
using the Web Server to the Web Application Server.
2.
Step 2 - The Web Application Server accepts the values that are sent in the report request.
The Web Application Server determines that the request is to view the selected Crystal
Report object. The Web Application Server sends a request to the CMS to verify that the user
has the correct permissions to view the object.
3.
Step 3 - The CMS verifies the user permissions in the CMS System database.
4.
Step 4 - The CMS sends a response to the Web Application Server to confirm that the user
has sufficient permissions to view the object.
5.
Step 5 - The Web Application Server then sends a request to the Crystal Reports Cache
Server requesting the report object.
6.
Step 6 - The Crystal Reports Cache Server verifies if the report page already exists. Unless the
report meets the requirements for On Demand report sharing (within a set time of another
On Demand request, same rights, database login, parameters), the Crystal Reports Cache
Server sends a request to the Crystal Reports Page Server to generate a new instance of the
page. By default, the set time is zero. For example, if the same report was recently requested
by a user with the same access rights, login details, and parameters, the report generated by
this request is returned.
7.
Step 7 - The Crystal Reports Page Server requests the report object from the Input File
Repository Server. The Input File Repository Server sends a copy of the object back to the
Crystal Reports Page Server. The Crystal Reports Page Server opens the report in memory
and verifies if it contains data.
8.
Step 8 - If the report object does not contain data, the Crystal Reports Page Server connects
to the database to collect the report data. The database returns the data to the Crystal
Reports Page Server. The Crystal Reports Page Server processes the report and holds the
report in temporary files until it reaches a 60 minute idle time. After the idle time is reached,
the temporary files are deleted from memory.
9.
Step 9 - The Crystal Reports Page Server sends the report file to the Crystal Reports Cache
Server.
10. Step 10 - The Crystal Reports Cache Server stores a copy of the report file in its cache
directory. The Crystal Reports Cache Server sends the report file to the Web Application
Server.
11. Step 11 - The Web Application Server then forwards the report file to the Web Server, which
sends it to the users computer where it is rendered in the Web Client.
The following process describes how to view a Web Intelligence Document on demand:
1.
Step 1 - The Web Client sends the request to view a Web Intelligence Report through the
Web server to the Web Application Server.
2.
Step 2 - The Web Application Server interprets the request and determines that the request
is to view a Web Intelligence document. The Web Application Server sends a request to the
CMS to verify that the user has the correct permissions to view the object.
3.
Step 3 - The CMS checks the system database to verify the user permissions.
4.
Step 4 - The CMS sends a response to the Web Application Server to confirm that the user
has sufficient permissions to view the object.
5.
Step 5 - The Web Application Server sends a request to the Web Intelligence Report Server
requesting the report.
6.
Step 6 - The Web Intelligence Report Server requests the report and Universe file from the
Input File Repository Server. The Input File Repository Server sends a copy of the report to
the Web Intelligence Report Server. The Web Intelligence Report Engine opens the report in
memory and verifies if the Refresh on open property of the Web Intelligence document is
set. If is property is set to yes, it generates the SQL query that the report is based on. If the
property is not set, the report will use the latest available copy of the report.
7.
Step 7 - The Connection Server connects to the database to execute the SQL query. The
query data is returned through the Report Engine where the report is processed.
8.
Step 8 - The Web Intelligence Report Server sends the report page to the Web Application
Server.
9.
Step 9 - The Web Application Server sends the report page to the Web Server, which then
forwards the completed report to be rendered to the user's Web Client.
The following process describes how to set a schedule for Crystal Reports:
1.
Step 1 - The Web Client submits a schedule request using the Web Server to the Web
Application Server.
2.
Step 2 - The Web Application Server interprets the request and determines that it is a
schedule request. The Web Application Server then sends the following data to the CMS:
Destination
3.
Format
Parameter values
Schedule time
Step 3 - The CMS verifies that the user has the necessary permissions to schedule the object.
If the user has sufficient permissions, the CMS adds a new record to the CMS system
database. The CMS also adds the instance to its list of pending schedules.
The following process describes how to query CA Service Desk Manager with BusinessObjects
Enterprise:
1.
2.
The SQL query passes through the Data Direct ODBC client driver which is installed on the
BusinessObjects XI server. The ODBC client communicates with the Data Direct ODBC Server
that is installed on the CA Service Desk Manager server.
3.
The Data Direct ODBC server sends the query to the CA Service Desk Manager web engine.
4.
The query passes through the CA Service Desk Manager domsrvr and the native query is
executed on the DBMS.
5.
The process follows the same steps, in reverse order, to return the query results.
2.
3.
If the validation is successful, it constructs the report/InfoView URL with a logon token
appended to it.
The following diagram illustrates the integration flow from CA Service Desk Manager:
In the CA Service Desk Manager web interface, the browser sends a request to
retrieve a session token (BOPSID) value from the CA Service Desk Manager
webengine.
b.
c.
The browser constructs a URL with the session token (BOPSID) value appended and
sends this URL to the servlet.
d.
The servlet validates the session token (BOPSID) value with the boplgin component
and then executes the TPA authentication code to create a session with
BusinessObjects.
e.
f.
The browser appends the BusinessObjects logon token to the report URL and is sent
to the BusinessObjects server.
Verify that your environment meets the CA Business Intelligence hardware requirements
(see page 39).
2.
3.
Configure an ODBC connection to the CMS database (SQL Server) (see page 43).
4.
5.
6.
Integrate CA Business Intelligence and CA Service Desk Manager (see page 55).
Requirement
Processor
Memory
Minimum: 2 GB
Recommended: 4 GB
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Component
Requirement
0.2 GB - BusinessObjects Process Tracker
(Optional)
(Optional) If your server is operating on Windows 2003, complete the following steps to
download and install the Microsoft Windows 2003 Server operating environment patch
KB925336:
a.
Important! Multiple articles appear in the search results. Verify that you select the
correct article and that Article ID: 925336 appears at the top of the article.
d.
Complete the instructions that are documented in the article, which includes
downloading and installing the patch.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
2.
Create a database and login ID that is configured as an owner of the database with SQL
Server authentication. This login ID is used during the DSN setup portion of the installation.
3.
(Optional) If the default has been changed, configure your database client and server to use
Unicode character encoding (such as UTF-8).
4.
Create a 32-bit ODBC Data Source connection to the CMS and CMS Audit databases on the
BusinessObjects XI or CA Business Intelligence Application Server.
Note: CA Business Intelligence requires a 32-bit ODBC connection. If you are installing CA
Business Intelligence on a 64-bit operating environment, such as Windows 2008 R2, create
the ODBC DSN using ODBCAD32.exe located in the <WINDIR>/SYSWOW64 folder.
The default SQL Initial Size and Auto growth settings for the CMS database should be
appropriate. An exception is when you anticipate having many objects (reports, users, and so on)
in your implementation. To help you estimate, a system with 10,000 objects is projected to
require 33 MB of free disk space.
Configure a CMS Database (SQL Server 2008)
You can configure a CMS database on SQL Server 2008, assign an owner, and set it as the default
database.
To configure a CMS database (SQL Server 2008)
1.
Log in to SQL Server 2008 Management Studio using either Windows Authentication or SQL
Authentication. Use an account that has privileges to create SQL users and databases.
2.
3.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Password
Type and confirm the password for SQL Server 2008 in the Password and Confirm
password fields.
4.
Click OK.
The new login is saved.
5.
In Microsoft SQL Server Management Studio, right-click the Databases folder and select New
Database.
The New Database dialog appears.
6.
7.
Click OK.
The new database is created, as illustrated in the following example:
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
8.
Right-click the user name (for example, BO_User) under the Security folder and select
Properties.
The properties for the user that you previously created appear.
9.
Select the database that you previously created (for example, BO_CMS) from the default
database drop-down list.
2.
3.
If you use a 32-bit operating environment, use the Control Panel (Administrative Tools) to
open the ODBC Data Sources tool.
The 32-bit ODBC Configuration window opens.
4.
Click the System DSN tab on the ODBC Data Source Administrator dialog, and click Add.
The Create New Data Source dialog appears.
5.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
6.
7.
Click Next.
The login credentials verification dialog appears.
8.
9.
b.
Type the Login ID and Password that was previously used during the database
configuration, for example, BO_User and <bo_password>.
c.
Click Next.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
3.
Click the Product Installs tab and click the CA Business Intelligence Installation link.
4.
5.
6.
(Optional) Select the Yes option button to install the sample templates.
CA Business Intelligence installs the sample database and templates. The samples include
the eFashion and Island Resorts Marketing Universes and sample report templates that are
based on the two databases. Use the templates as an example to create different types of
reports.
7.
Click Next.
The Generate Response File dialog appears.
8.
Select No if you do not want to perform a silent installation. The CA Business Intelligence
installation allows you to create a response file for silent installations.
9.
Click Next.
The Review Settings dialog appears.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
13. Select the required language package. BusinessObjects provides a single installation for
multiple languages in addition to English.
14. Click Next.
The Install Type dialog appears.
15. Select the Install Type as New, as shown in the following example:
Note: The default installation location is C:\Program Files\CA\SC\CommonReporting3. You
can optionally change the installation location by clicking Browse.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
b.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
22. Enter information in the following fields, as shown in the following example:
Data Source Name
Select CMS_DSN as the data source name.
Login ID
Type the login ID for the BO_User.
Password
Type the password for the BO_User.
Consume DSN created under WOW64
(64-bit operating environment) Select this check box.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Deploys the default CA Service Desk Manager reports and the CA Service Desk Manager
Universe.
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
3.
Click the Product Installs tab and click the CA Business Intelligence Configuration link, as
shown in the following example:
4.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
5.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Click Finish.
The configuration is complete. A CA Service Desk Manager data source is available on the
System DSN tab of ODBC Data Sources.
Note: CA Business Intelligence requires a 32-bit ODBC connection. If you are installing CA
Business Intelligence on a 64-bit operating environment, such as Windows 2008 R2, create
the ODBC DSN using ODBCAD32.exe located in the <WINDIR>/SYSWOW64 folder.
7.
Double-click the ODBC connection and click Test Connect, as shown in the following
example:
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Type the Service Desk Privileged User Name and Password in the Data Source User Name
and Data Source Password fields.
9.
Click OK.
The Connection test was successful message appears.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
2.
3.
Click the Manage drop-down list and select New, New User as shown in the following
example:
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
5.
6.
7.
Right-click the ServiceDesk user and select Member Of, as shown in the following example:
Add Administrators and CA Universe Developer groups to the ServiceDesk user using the
arrows.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
9.
Click OK.
The selected groups are added to the ServiceDesk user.
14. Log in to the CA Service Desk Manager web interface as an administrator or as a user having
administrative permissions.
15. Navigate to the Administration tab and select the Options Manager, Web Report node.
16. Click the bo_server_auth option and complete the following steps:
a.
Click Edit.
b.
c.
Click Install.
d.
e.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
17. Click the bo_server_cms option and complete the following steps:
a.
Click Edit.
b.
Specify the CMS server and port number (CA Business Intelligence Server: 6400).
c.
Click Install.
d.
e.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
18. Click the bo_server_location option and complete the following steps:
a.
Click Edit.
b.
Note: This port number must match the Tomcat port number that you specified during
the CA Business Intelligence installation.
c.
Click Install.
d.
e.
19. Restart the CA Service Desk Manager Service using the Windows Services Control Panel.
20. Log in to the Central Management Console as the CA Business Intelligence Administrator.
21. Click the Authentication link and select Enterprise.
The Enterprise window appears, as shown in the following example:
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Shared secret
Type a value for the Shared secret password.
23. Click Update.
The Trusted Authentication option and Shared secret password are saved.
24. On the CA Service Desk Manager primary server, navigate to the
NX_ROOT\bopcfg\www\CATALINA_BASE\webapps\CAisd directory.
25. Using a text editor, open the TrustedPrincipal.conf file.
26. Change the Shared Secret value to match the value that you previously entered in the
Central Management Console.
27. Save and close the file.
The Shared Secret password is saved.
28. On the CA Business Intelligence server, navigate to the
\CommonReporting3\Tomcat55\webapps\OpenDocument\WEB-INF directory.
29. Using a text editor, open the WEB.XML file.
30. Edit the file based on the information in the following table:
Parameter Name
Opendoc.cms.default
Hostname:
port of your
CMS
Opendoc.siteminder.enabled
true
false
Opendoc.sso.enabled
false
true
Opendoc.trusted.auth.user.retr (blank)
ieval
REMOTE_USER
Sample:
<context-param>
<param-name> Opendoc
.trusted.auth.user.retrieval
</param-name>
<param-value>
REMOTE_USER </param-value>
</context-param>
Opendoc.trusted.auth.user.par (blank)
am
(blank)
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Parameter Name
Opendoc.trusted.auth.shared.s (blank)
ecret
(blank)
Use the Windows Services Control Panel to restart the CA Service Desk Manager
Service.
b.
33. Log in to the CA Service Desk Manager web interface as the ServiceDesk user.
How to Install and Integrate CA Business Intelligence and CA Service Desk Manager (Simple Installation with One
Server)
Simplifies the work that is associated with joining tables (a common task when building
reports on normalized data).
The following example illustrates how the various components of CA Service Desk Manager and
CA Business Intelligence are integrated:
This CA Business Intelligence configuration is in addition to the database server and the CA
Service Desk Manager server. Because this scenario is large enough and must also leverage an
offline reporting instance of the MDB and its associated CA Service Desk Manager instance, this
complex environment may involve 10 or more servers.
The following example illustrates how the various components integrate in this scenario. A
virtual server can also be used in this configuration.
Recommended Requirement
Processor
2 CPU cores
Memory
4 GB
Recommended Requirement
Processor
2 CPU cores
Memory
4 GB
50 GB DASD
Recommended Requirement
Processor
2 CPU cores
Memory
4 GB
50 GB DASD
(Oracle) If you use Oracle, install the Oracle client on the Intelligence and Processing Tier
Servers.
Step 1 - Create the file shares for CA Business Intelligence (see page 67).
2.
Step 2 - Install the first server in the intelligence tier of CA Business Intelligence (see page
68).
3.
Step 3 - Install the CA Business Intelligence web application tier servers (see page 80).
4.
Step 4 - Install the second server in the intelligence tier of CA Business Intelligence (see page
87).
5.
Step 5 - Install the CA Business Intelligence processing tier servers (see page 96).
6.
Step 6 - Configure the input and output file repository servers (see page 102).
7.
Step 7 - Configure the CA Business Intelligence tiers (enable and disable the server
components) (see page 105).
8.
Indexing Service
Each component requires a file share. As a best practice, host each file share on a high-available
storage area network (SAN). Later in this scenario, you configure CA Business Intelligence to use
the files shares.
To create the files shares for CA Business Intelligence
1.
In the directory to host the shared folders, create a folder named CABI_SHARE.
2.
3.
InputFiles
OutputFiles
Index
4.
5.
6.
7.
In the Permissions for Everyone section, click the Allow check box for the Change
permissions.
8.
Click OK.
9.
Step 2 - Install the First Server in the Intelligence Tier of CA Business Intelligence
In this step of the complex reporting scenario, you install the first server in the Intelligence Tier
of CA Business Intelligence. Complete these steps on the first server within the CA Business
Intelligence Tier, sometimes referred to as the Management Tier.
Before you begin, complete the following prerequisites and verify the following information:
1.
2.
Verify that both the CMS and CMS Audit databases (and associated users) for CA Business
Intelligence exist on the remote database server.
3.
(SQL Server) Create 32-bit ODBC data source connections to the CMS and CMS Audit
databases on the CA Business Intelligence application server.
Note: CA Business Intelligence requires a 32-bit ODBC connection. Therefore, if you are
installing CA Business Intelligence on a 64-bit operating system such as Windows 2008
Server R2, create the ODBC DSN using ODBCAD32.EXE located in the <WINDIR>/SYSWOW64
folder.
4.
(Oracle) Verify that the Oracle client is installed on the CA Business Intelligence server.
5.
(Windows 2003 Server) Download and install the Microsoft Windows 2003 Server operating
environment patch KB925336. For more information about how to download and install this
patch, see How to Configure SQL Server as the CMS Database (see page 40).
6.
7.
8.
Domain account user name and password. CA Business Intelligence uses this
information to access the file share, and so forth.
Password for the CA Business Intelligence user (a SQL Server user to access the CMS
database)
Password for the CABIAUDIT user (a SQL Server user to access the Audit database)
(Oracle) The Net Service Name that is configured during the Oracle client installation
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
3.
Click the Product Installs tab and click the CA Business Intelligence Installation link.
4.
5.
6.
(Optional) Select the Yes option button to install the sample templates.
CA Business Intelligence installs the sample database and templates. The samples include
the eFashion and Island Resorts Marketing Universes and sample report templates that are
based on the two databases. Use the templates as an example to create different types of
reports.
7.
Click Next.
The Generate Response File dialog appears.
8.
Select No if you do not want to perform a silent installation. The CA Business Intelligence
installation allows you to create a response file for silent installations.
9.
Click Next.
The Review Settings dialog appears.
15. Select the Install Type as Custom or Expanded Install, as shown in the following example:
Note: The default installation location is C:\Program Files\CA\SC\CommonReporting3. You
can optionally change the installation location by clicking Browse.
18. Clear all Web Tier Components, as shown in the following example:
19. Expand Server Components, Central Management Server and clear the MySQL option, as
shown in the following example:
20. Clear the Enable servers upon installation check box, as shown in the following example:
Click the Yes option button to indicate that this is the first CMS in your deployment.
b.
c.
d.
Click Next.
Username
Specifies the CABI user.
Password
Specifies the password for the CABI user.
Auditing Database
Select this check box and specify the following information:
Select existing Auditing database
Select Oracle as an existing auditing database.
Server
Specifies the Net Server Name that was previously configured during the Oracle Client
installation.
Username
Specifies the CABIAUDIT user.
Password
Specifies the password for the CABIAUDIT user.
25. (SQL Server) Complete the following steps for the CMS Database:
a.
b.
c.
d.
Specify the DNS to the CMS Database that was previously created.
e.
f.
g.
26. (SQL Server) Complete the following steps for the Auditing Database:
a.
b.
c.
d.
(64-bit operating environment) Select the Consume DSN created under WOW64
check box.
e.
Specify the DNS to the CMS Audit Database that was previously created.
f.
g.
h.
2.
Select the Server Intelligence Agent and click the stop icon.
The Server Intelligence Agent stops.
3.
4.
5.
Select the Configuration tab and complete the following steps, as shown in the following
example:
a.
b.
c.
Click OK.
Install and configure (see page 78) the first CA Business Intelligence Tier Server.
2.
(Windows 2003 Server) Download and install the Microsoft Windows 2003 Server operating
environment patch KB925336. For more information about how to download and install this
patch, see How to Configure SQL Server as the CMS Database (see page 40).
3.
4.
5.
CMS Server host name (the fully qualified host name for the first Intelligence Tier
Server).
Important! Complete the installation on both of the CA Business Intelligence Web Application
Tier Servers.
To install the CA Business Intelligence Web Application Tier Servers
1.
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
3.
Click the Product Installs tab and click the CA Business Intelligence Installation link.
4.
5.
6.
7.
Click Next.
The Generate Response File dialog appears.
8.
Select No if you do not want to perform a silent installation. The CA Business Intelligence
installation allows you to create a response file for silent installations.
9.
Click Next.
The Review Settings dialog appears.
15. Select the Install Type as Web Tier, as shown in the following example:
Note: The default installation location is C:\Program Files\CA\SC\CommonReporting3. You
can optionally change the installation location by clicking Browse.
Specify the fully qualified host name for the first Intelligence Tier Server.
b.
c.
b.
Click the Install Tomcat application server and deploy to it option button.
b.
c.
2.
3.
4.
5.
Step 4 - Install the Second Server in the Intelligence Tier of CA Business Intelligence
In this step of the complex reporting scenario, you install the second server in the Intelligence
Tier of CA Business Intelligence.
Before you begin, complete and verify the following information:
1.
Verify that the first CA Business Intelligence Tier Server is installed and configured (see page
68).
2.
(SQL Server) Create 32-bit ODBC data source connections to the CMS and CMS Audit
databases on the CA Business Intelligence application server.
Note: CA Business Intelligence requires a 32-bit ODBC connection. Therefore, if you are
installing CA Business Intelligence on a 64-bit operating system such as Windows 2008
Server R2, create the ODBC DSN using ODBCAD32.EXE located in the <WINDIR>/SYSWOW64
folder.
3.
(Oracle) Verify that the Oracle client is installed on the CA Business Intelligence server.
4.
(Windows 2003 Server) Download and install the Microsoft Windows 2003 Server operating
environment patch KB925336. For more information about how to download and install this
patch, see How to Configure SQL Server as the CMS Database (see page 40).
5.
6.
7.
Password for the CA Business Intelligence user (a SQL Server user to access the CMS
database)
Password for the CABIAUDIT user (a SQL Server user to access the Audit database)
(Oracle) The Net Service Name that is configured during the Oracle client installation
CMS Server Host Name (fully qualified host name for the first Intelligence Tier Server)
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
3.
Click the Product Installs tab and click the CA Business Intelligence Installation link.
4.
5.
6.
7.
Click Next.
The Generate Response File dialog appears.
8.
Select No if you do not want to perform a silent installation. The CA Business Intelligence
installation allows you to create a response file for silent installations.
9.
Click Next.
The Review Settings dialog appears.
15. Select the Install Type as Custom or Expanded Install, as shown in the following example:
Note: The default installation location is C:\Program Files\CA\SC\CommonReporting3. You
can optionally change the installation location by clicking Browse.
b.
c.
Expand Server Components, Central Management Server and clear the MySQL
option.
d.
Click the No option button to indicate that this CMS is not the first CMS in your
deployment.
b.
c.
Enter the fully qualified host name of the first Intelligence Tier Server.
d.
e.
f.
Click Next.
Username
Specifies the CABI user.
Password
Specifies the password for the CABI user.
Auditing Database
Select this check box and specify the following information:
Auditing Database
Select Oracle as an existing auditing database.
Server
Specifies the Net Server Name that was previously configured during the Oracle Client
installation.
Username
Specifies the CABIAUDIT user.
Password
Specifies the password for the CABIAUDIT user.
22. (SQL Server) Complete the following steps for the CMS Database:
a.
b.
c.
d.
Specify the DNS to the CMS Database that was previously created.
e.
f.
g.
23. (SQL Server) Complete the following steps for the Auditing Database:
a.
b.
c.
d.
e.
Specify the DNS to the CMS Audit Database that was previously created.
f.
g.
h.
Verify that the first CA Business Intelligence Tier Server is installed and configured (see page
68).
2.
(SQL Server) Create 32-bit ODBC data source connections to the CMS and CMS Audit
databases on the CA Business Intelligence application server.
Note: CA Business Intelligence requires a 32-bit ODBC connection. Therefore, if you are
installing CA Business Intelligence on a 64-bit operating system such as Windows 2008
Server R2, create the ODBC DSN using ODBCAD32.EXE located in the <WINDIR>/SYSWOW64
folder.
3.
(Oracle) Verify that the Oracle client is installed on the CA Business Intelligence server.
4.
(Windows 2003 Server) Download and install the Microsoft Windows 2003 Server operating
environment patch KB925336. For more information about how to download and install this
patch, see How to Configure SQL Server as the CMS Database (see page 40).
5.
6.
7.
CMS Server Host name (the fully qualified host name for the first Intelligence Tier
Server).
The Index Directory location (UNC path to the Index shared folder). The following
example path is provided for your reference:
\\HostnameOfFileShareServer\CABI_SHARE\Index
Important! Complete the installation on both of the CA Business Intelligence Processing Tier
Servers.
To install the CA Business Intelligence Processing Tier Servers
1.
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
3.
Click the Product Installs tab and click the CA Business Intelligence Installation link.
4.
5.
6.
7.
Click Next.
The Generate Response File dialog appears.
8.
Select No if you do not want to perform a silent installation. The CA Business Intelligence
installation allows you to create a response file for silent installations.
9.
Click Next.
The Review Settings dialog appears.
18. Expand BusinessObjects Enterprise, Server Components and clear the Central Management
Server, Desktop Intelligence Job Server, Desktop Intelligence Servers, Samples, and Help Files
options, as shown in the following example:
19. Clear the Enable servers upon installation check box and click Next.
The CMS Clustering dialog appears.
Enter the fully qualified host name of the first Intelligence Tier Server.
b.
c.
d.
Click Next.
The Input Index Directory for the Search Service Clustering dialog appears.
21. Specify the Index Location of \\HostnameOfFileShareServer\CABI_SHARE\Index, as shown in
the following example:
Verify that all CA Business Intelligence servers are installed and configured.
2.
Domain account user name and password. CA Business Intelligence uses this
information to access the file share, and so forth.
Filestore Directory location for the Input File Repository Servers (IFRS). This location is
the UNC path to the InputFiles shared location (for example,
\\HostnameOfFileShareServer\CABI_SHARE\InputFiles).
Filestore Directory location for the Output File Repository Servers (OFRS). This location
is the UNC path to the OutputFiles shared location (for example,
\\HostnameOfFileShareServer\CABI_SHARE\OutputFiles).
Select one of the following methods to start the Central Management Console:
a.
b.
(Remote location) Open a web browser and enter the following URL:
http://<web_app_tier_server>:8080/CmcApp/App/home.faces?
2.
In the upper left part of the page, select Servers in the drop-down list.
3.
For each node in the cluster with an InputFileRepository Server, complete the following
steps:
a.
4.
b.
c.
d.
For each node in the cluster with an OutputFileRepository Server, complete the following
steps:
a.
5.
c.
d.
For each node that executes servers that require access to the file shares, complete the
following steps:
a.
b.
c.
d.
Edit the Server Intelligence Agent properties by completing the following steps:
a.
b.
c.
d.
Click OK.
e.
Note: Repeat this step for the other Intelligence Tier Server and the two Processing Tier
Servers.
Step 7 - Configure the CA Business Intelligence Tiers (Enable and Disable the Server
Components)
In this step of the complex reporting scenario, you configure the CA Business Intelligence tiers by
enabling and disabling components. Before you begin, complete and verify the following
information:
1.
Verify that all CA Business Intelligence servers are installed and configured.
2.
CA Business Intelligence Tier components for configuration. Use the following table for
reference during the configuration:
Processing Servers
Adaptive
Processing Server
Central
Management
Server
Connection Server
Crystal Reports
Cache Server
X
X
Crystal Reports
Processing Server
Dashboard
Analytics Server
Dashboard Server
Destination Job
Server
Event Server
Input File
Repository
Web Application
Servers
Processing Servers
Multi Dimensional
Analysis Services
Server
Output File
Repository
Web Application
Servers
PM Metrics Server
PM Repository
Server
PM Rules Server
Predictive Analysis
Server
Process Analysis
Server
Publication Job
Server
Report Application
Server
Web Intelligence
Processing Server
Web Application
Server
Web Application
Container Server
Six servers are utilized. Two servers execute as Intelligence and Management Servers, two
servers execute as Processing Servers, and two servers execute as Web Application Servers.
To accomplish this goal, you disable the server components on the nodes where they should not
execute.
b.
c.
2.
In the upper left part of the page, select Servers in the drop-down list.
3.
4.
Right-click a server in the list and select Enable Server or Disable Server.
Note: When a server is disabled, the server does not process jobs, even when it is executing.
You do not have to prevent the server from executing. To prevent a server from starting
even when it is disabled, right-click the server and select Properties. Then, clear the
Automatically start this server check box. Changes take effect the next time the server starts.
Insert the installation media for CA Service Desk Manager into the drive on the first CA
Business Intelligence server.
When Autoplay is enabled, the configuration starts automatically. When Autoplay is
disabled, double-click the setup.exe file from the root directory of the installation media to
start the configuration.
2.
Select the language for the configuration and click Select Language.
Summary
3.
Click the Product Installs tab and click the CA Business Intelligence Configuration link.
The CA Service Desk Manager Component Installation Wizard appears, as shown in the
following example:
4.
Enter the appropriate information and follow the on-screen instructions to complete the
configuration.
Note: In the BI Admin User Name field, enter the CA Business Intelligence Administrator user
name (the default is Administrator).
Summary
At this point in the complex reporting scenario, the complex CA Business Intelligence reporting
environment is configured and executing. You can add users and adjust permissions to the
reporting functionality and content.
The typical integration steps with CA Service Desk Manager must be completed after you
complete the Options Manager options and configure the shared secret functionality (for pass
through authentication). For your reference, the following table provides the CA Business
Intelligence Options Manager options and their suggested values.
Options Manager Option
Suggested Value
bo_server_auth
secEnterprise
Summary
Suggested Value
bo_server_cms
bo_server_location
If you change a value, recycle the CA Service Desk Manager services for the change to take effect.
Chapter 5: Configuring CA
Business Intelligence Reports for
Multi-Tenancy
Multi-Tenancy
Multi-tenancy is the ability for multiple independent tenants (and their users) to share a single
implementation of CA Service Desk Manager. Tenants cannot see or update data belonging to
other tenants, and each tenant views the CA Service Desk Manager implementation as their own.
Multi-tenancy allows tenants to share hardware and application support resources. This sharing
significantly reduces the cost of both, while retaining most of the benefits of an independent
implementation.
The following tables define and organize tenants:
ca_tenant
ca_tenant_group
ca_tenant_group_member
All other tables that may contain tenant-specific data include a tenant column that references
a row in the ca_tenant table. A NULL value in this column indicates global data.
When multi-tenancy is active, you can grant users access to view the data of all tenants or
restrict them to view data for a single tenant. The default behavior specifies that users can see
the data of all configured tenants.
2.
Click Administration, Security and Role Management, Role Management, Role List.
The Role List dialog appears.
3.
Select a user role, such as the Change Manager role, and click Next.
The Manager Role Detail dialog appears.
4.
5.
Click Save.
The settings are saved and the Manager Role detail dialog closes.
6.
Log out of CA Service Desk Manager and log back in as a tenant user for the settings to take
effect.
7.
Test the multi-tenancy settings by reviewing the number of incidents. When tenant
restrictions are implemented correctly, you can only view the data for your tenant.
2.
3.
Select CA Service Desk from the Available Universes list, and click OK.
4.
Click Edit.
The Edit CA Service Desk Connection dialog appears.
6.
Enter the login information for the connection to CA Service Desk Manager, such as the
ServiceDesk user, and click Test Connection.
7.
8.
Select Use BusinessObjects Credential mapping in the Authentication Mode drop-down list.
9.
Password
Defines the CA Business Intelligence account password.
Authentication
Specifies the type of authentication to use.
14. Click Log In.
The Central Management Console dialog appears.
15. Select Users and Groups from the drop-down list in the upper left corner, then click User List
in the left pane.
A list of configured user and group accounts appears in the right pane, as shown in the
following example:
Account Name
Defines the account user name.
Password
Defines the account password.
Confirm Password
Confirms the account password.
18. Click Save.
19. Complete the following steps:
a.
Log in to InfoView using the user account that you modified in the previous step.
b.
c.
Verify that only tenant data to which this account has access appears.
2.
User Name
Defines the CA Business Intelligence account user name.
Password
Defines the CA Business Intelligence account password.
Authentication
Specifies the type of authentication to use.
3.
4.
Select Users and Groups from the drop-down list in the upper left corner, then click LDAP in
the Authentication list.
The LDAP dialog appears, as shown in the following example:
5.
Select the Enable and Update users Data Source Credentials at logon time check box.
When you select this check box, the Account Name and Password fields are automatically
populated on the user properties after the first-time you log in to InfoView.
6.
Click Update.
The authentication changes are saved.
Chapter 6: Configuring CA
Business Intelligence with a
Replicated Reporting Database
Overview
The possibility exists that reporting activities can cause performance issues on an active instance
of CA Service Desk Manager. To help minimize this risk, we recommend that you have all
reporting activity execute on a replicated instance of the database. CA Service Desk Manager
includes CA Business Intelligence for reporting, so the risk increases. The risk increase because CA
Business Intelligence leverages the CA Service Desk Manager server object manager component
for reporting instead of using direct ODBC to the database to access the data. The data is
accessed this way to help ensure that the access permissions for a user from a reporting
perspective match the user permissions within the application. Furthermore, the replicated
instance of the database must have a unique active CA Service Desk Manager server
implementation to provide access to the report data.
By accessing the data in this way, the replication process is more complicated. The replication
process is more complicated because of the need to verify that the database replication process
does not lock the database tables that CA Service Desk Manager uses. CA Service Desk Manager
expects to have complete access to all of its tables. When CA Service Desk Manager encounters a
locked table, it remains in a hung state that can only be cleared by recycling the CA Service Desk
Manager services.
Configuration Planning
The following example illustrates how a replicated reporting implementation should appear at a
high level. Each product component appears as an individual server. However, you can configure
the individual components to have multiple servers, with each server hosting individual parts of
the components. Alternatively, a single server can host multiple components.
To help assist in addressing this complexity, some basic configuration steps are provided in the
samples\reporting directory. You can find the samples at the root of the CA Service Desk
Manager installation directory. This chapter extends the information in the samples and provides
additional details and suggestions to implement a replicated instance of CA Service Desk
Manager for reporting.
Configuration Planning
To help you plan for a successful CA Business Intelligence configuration with a replicated
reporting database, use the following information to research and gather information.
Verify that you have installed and configured a CA Service Desk Manager instance.
Verify that you have a CA MDB database operating on either SQL Server or Oracle.
Configuration Considerations
Verify that you have at least one server dedicated for the CA Business Intelligence
functionality.
Verify that you have a server dedicated for CA Service Desk Manager reporting.
Configuration Considerations
Consider the following information when configuring CA Business Intelligence with a replicated
reporting database:
Operating Systems and Databases - The steps provided in this chapter are valid for SQL
Server 2005 and 2008, and Oracle 10G Release 2 on Windows.
Sample Configuration Only - This information is provided as a sample configuration only and
does not completely discuss all supported configurations. This information is not intended to
serve as a detailed or comprehensive guide to replicating a database. However, the steps are
applicable to most configurations. For complete details about configuring a replicated
database, see your DBMS documentation.
Merge Based Replication - Merge based replication is used for this solution. Therefore, it is
important to prevent the reporting instance of CA Service Desk Manager from updating the
replicated database. If the replicated database is updated, the results from the update
depend on the replication strategy of the DBMS vendor. If the update is not overwritten by
the replication procedure, you may need to truncate the table so it properly synchronizes
with the source database.
Important! Merge based replication is used for this solution because it does not lock the CA
MDB tables. Therefore, the replication does not interfere with the proper operation of CA
Service Desk Manager. Other forms of replication being used have resulted in CA Service
Desk Manager not working due to the database tables being locking during the replication
process.
Install and configure the production instance of CA Service Desk Manager (see page 123).
2.
3.
How to install and configure the reporting instance of CA Service Desk Manager (see page
123). This reporting instance of CA Service Desk Manager is additionally configured to avoid
writing updates to the replicated database, which includes starting only a subset of the CA
Service Desk Manager components. This reporting instance is enabled with a process set
named OFFLINE_REPORTING.
4.
Configure and publish the replication snapshot of the production database (see page 129).
5.
Configure the reporting database to subscribe to the published replication data (see page
146).
6.
Install and configure CA Business Intelligence (see page 156). You can install CA Business
Intelligence before or after the reporting instance of CA Service Desk Manager.
7.
Configure reporting on the production instance of CA Service Desk Manager (see page 157).
How to Install and Configure the Reporting Instance of CA Service Desk Manager
When the reporting database is installed and configured, you install and configure the reporting
instance of CA Service Desk Manager with any customized changes from the production instance
of CA Service Desk Manager. To install and configure the reporting instance of CA Service Desk
Manager, complete the following steps:
1.
Install and configure the reporting instance of CA Service Desk Manager (see page 124).
2.
Gather files and data from the production instance of CA Service Desk Manager (see page
125).
3.
Set up the reporting instance of CA Service Desk Manager (see page 126).
Install a primary server to act as the Reporting CA Service Desk Manager server.
Note: Do not configure the server.
2.
Use the following sample code to verify that auditing is commented out:
b.
@NX_EVENT_LOG_EXCLUDE=ALL
@NX_SESSION_LOG_EXCLUDE=ALL
3.
Execute the CA Service Desk Manager Server Configuration process. During the
configuration, reference the Reporting Database Server.
4.
5.
Edit the file by changing the line [ default procset MAIN_PROCSET ] to [ default procset
OFFLINE_REPORTING ].
6.
Identify the entry [ procset OFFLINE_REPORTING ] and modify the content as follows:
[ procset OFFLINE_REPORTING ]
DBADMIN
sw_ver_ctl
bpnotify_nxd
confirm_db
nx_user
license_nxd
kt_daemon
rpc_srvr
spel_srvr
domsrvr
bpvirtdb_srvr
bop_login
webengine
wsp_domsrvr
wsp_webengine
pdm_tomcat
7.
8.
Repeat the previous steps to edit the pmd_startup file for the
NX_ROOT\pdmconf\pdm_startup.tpl file.
Repeating these steps helps ensure that future executions of the CA Service Desk Manager
Server Configuration Utility do not change these changes back to the default settings.
9.
Gather Files and Data from the Production Instance of CA Service Desk Manager
Use the following steps to gather files and data from the Production Instance of CA Service Desk
Manager.
1.
Log in to the primary server of the Production Instance of CA Service Desk Manager.
2.
3.
4.
b.
Copy the C:\Program Files\CA\Service Desk\site\mods directory and all files within the
directory to a temporary directory on the Reporting Instance of CA Service Desk Manager.
Note: Use a file compression product to help reduce the disk space requirement on the
Reporting Instance of CA Service Desk Manager. Do not copy the files to a temporary
directory immediately under the CA Service Desk Manager installation directory.
The files and data are successfully gathered from the Production Instance of CA Service Desk
Manager.
Log in to the primary server of the Reporting Instance of CA Service Desk Manager.
2.
3.
Execute the cd <directory name> command to navigate to the temporary directory that you
previously created on the Reporting Instance of CA Service Desk Manager where the
wsptbl.txt and wspcol.txt files are located (see page 125).
4.
pdm_load f wsptbl.txt
b.
pdm_load f wspcol.txt
5.
6.
When prompted, enter your CA Service Desk Manager credentials to log in to the Web
Screen Painter.
The Web Screen Painter opens.
7.
8.
On the left side of the page, select any table in the tree.
9.
On the right side of the page, type desc in Description field for the table.
21. Edit the file by changing the line [ default procset MAIN_PROCSET ] to [ default procset
OFFLINE_REPORTING ].
22. Identify the entry [ procset OFFLINE_REPORTING ] and comment out the following entries by
preceding each entry with a semicolon ( ; ). After you edit the entries, they appear as
follows:
;wsp_domsrvr
;wsp_webengine
;pdm_tomcat
2.
Drop the CA_CONTACT and USP_CONTACT tables from the MDBADMIN schema by executing
the following SQL *Plus commands:
3.
Set up Oracle Stream replication from the production server to the replicated server, which
detects the dropped tables and creates and loads the contact data on the replicated
database.
A domain account for replication, which is also added as a login to SQL Server on the
production database server. Provide this login db_owner rights to the distribution (created
when the replication distributor is configured) and MDB databases. In addition, add this
login to the Publication Access List.
Provide a network file share location for the replication snapshot file. This file must be
accessible from both the production database server and the reporting database server. In
addition, the domain account for replication previously created must have read/write access
to the file share location.
Steps specific to CA Service Desk Manager include clearing certain tables from replication and
updating the permissions on the replicated tables. The permissions update can be completed
with a script provided in the /samples/reporting directory of the CA Service Desk Manager
installation.
Note: You do not have to complete the permissions script step for SQL Server when configuring
SQL replication with the Copy permissions parameter set to true.
Start Microsoft SQL Server Management Studio and connect to the production database
server.
Microsoft SQL Server Management Studio opens.
2.
In the tree on the left, expand the Replication node, right-click Local Publications, and select
New Publication.
The New Publication Wizard appears.
3.
4.
(Optional) If you are configuring replication on the server for the first-time, the Distributor
page appears, as shown in the following example:
5.
Specify the Production Database Server to act as its own Distributor and click Next.
6.
(Optional) If prompted, specify that the SQL Server Agent should start automatically and click
Next.
The Snapshot Folder page appears, as shown in the following example:
7.
Specify the snapshot network file share location (if known), or accept the default snapshot
location and click Next.
The Publication Database page appears, as shown in the following example:
8.
9.
10. Select the SQL Server 2005 check box and click Next.
Note: This step also applies to SQL Server 2008.
The Articles page appears, as shown in the following example:
11. Select the check box to the left of the Tables node and expand the tree.
12. Scroll in the list to the dlgtsrv and options tables, as shown in the following example:
13. Clear the check boxes for both the dlgtsrv and options tables.
14. Clear the check boxes for the ebr_fulltext, ebr_fulltext_adm, and ebr_synonyms tables.
Replication interferes with the functioning of Knowledge indexing utility (pdm_k_reindex).
15. Clear the check boxes for the ci_twa_ci table.
Important! This step is necessary due to a limitation of SQL Server replication for tables with
more than 240 columns.
16. Collapse and select the Tables node, select the Article Properties drop-down on the right,
and select the Set Properties for All Table Articles option, as shown in the following example:
The Properties for All Table Articles dialog appears, as shown in the following example:
17. Click the Properties tab, scroll to the Copy Objects and Settings to Subscriber section, and
complete the following steps:
Copy user triggers
Help ensure that SQL triggers take no additional actions on the reporting database. Set
this property to False.
Copy collation
Required to integrate with CA Service Catalog. Set this property to False.
Copy permissions
Prevent the requirement for the SQL script to correct table permissions on the
replicated CA MDB that is in the samples\reporting directory of the CA Service Desk
Manager server installation. Set this property to True.
18. Scroll to the Destination Object section of the page, as shown in the following example:
19. Select the Synchronization direction property and change the value to Download-only to
Subscriber, allow Subscriber changes.
Note: This property setting helps ensure that data from the reporting database is not applied
to the production database. The allow Subscriber changes option helps reduce the chance of
failure for any applications on the reporting database server that may have to update a
specific replicated table.
20. Click OK.
21. Click Next in the wizard.
The Article Issues page appears, as shown in the following example:
22. Click Next to allow the publication process to add a unique identifier column to each table.
The Filter Table Rows page appears, as shown in the following example:
23. Accept the default values on the page and click Next.
The Snapshot Agent page appears, as shown in the following example:
24. Select the Create a snapshot immediately check box and click Next.
Note: If you must update the snapshot properties, clear both check boxes on this page and
click Next. Scheduling the snapshot agent to execute on a regular basis should not be
required.
The Agent Security page appears, as shown in the following example:
26. Select the Run under the following Windows account option, specify the domain user
account details that must access the snapshot file location, and click OK.
Note: Although it is not a best practice, for testing purposes you can use a local
administrator account that has access to the replication snapshot shared folder. Do not
change the Connect to the Publisher option and accept the default value to impersonate the
process account.
The Agent Security page appears, as shown in the following example:
28. Accept the default values on the page and click Next.
The Complete the Wizard page appears, as shown in the following example:
31. Open Microsoft SQL Server Management Studio, expand the Replication node, and view the
created publication under the Local Publications node, as shown in the following example:
To update a publication
1.
Start Microsoft SQL Server Management Studio and connect to the production database
server.
Microsoft SQL Server Management Studio opens.
2.
In the tree on the left, expand the Replication, Local Publications nodes, right-click the
publication that you created, and select Properties.
Note: If you change a property that requires the regeneration of the snapshot, you are
prompted to regenerate the snapshot.
The Publication Properties Wizard appears, as shown in the following example:
3.
b.
c.
d.
Specify the path to the file share, or click Browse to navigate to the My Network
Places folder structure to locate the shared folder.
4.
When you select or specify the file share location, you return to the Snapshot Details page.
This page displays the selected UNC path location for the snapshot files.
5.
6.
Click Add.
The replication domain account is added.
7.
Click OK.
The Publication Properties dialog appears, as shown in the following example:
8.
Click Yes.
The property changes are saved and the snapshot is regenerated.
Start Microsoft SQL Server Management Studio and connect to the reporting database
server.
Microsoft SQL Server Management Studio opens.
2.
In the tree on the left, expand the Replication node, right-click Local Subscription, and select
New Subscriptions.
The New Subscription Wizard appears.
3.
4.
5.
Specify the production database server name, provide the appropriate login credentials, and
click Connect.
The Publication page appears and displays all available publications on the database server,
as shown in the following example:
6.
Select the publication that was previously configured and click Next.
The Merge Agent Location page appears, as shown in the following example:
7.
Verify that the Run each agent as its Subscriber (pull subscriptions) option is selected and
click Next.
The Subscribers page appears, as shown in the following example:
8.
Verify that the mdb is selected as the subscription database and click Next.
The Merge Agent Security page appears, as shown in the following example:
9.
10. Specify the security credentials for the Merge Agent and click OK. This step includes
specifying the replication domain account to use to execute the merge job.
The Merge Agent Security page appears.
11. Click Next to continue.
The Synchronization Schedule page appears, as shown in the following example:
b.
c.
Note: If you need real-time data in your reports, select Run continuously. Use caution when
selecting this option, as system performance may be negatively impacted.
13. Click Next.
The Initialize Subscriptions page appears, as shown in the following example:
14. Accept the default values on the page and click Next.
The Subscription Type page appears, as shown in the following example:
15. In the Subscription Type column, select Client from the drop-down list and click Next.
The Wizard Actions page appears, as shown in the following example:
16. Verify that the Create the subscription(s) check box is selected and click Next.
The Complete the Wizard page appears, as shown in the following example:
2.
Log in using an account that has Microsoft SQL Server administration permissions.
3.
4.
5.
6.
7.
8.
Verify that the call_req table appears in the Securables list and permissions are granted on
the Explicit tab.
You do not have to execute the SQL script. The replicated SQL Server database is configured
to receive replicated data from the production CA MDB database.
Considerations
On the production instance of CA Service Desk Manager, log in to CA Service Desk Manager.
2.
3.
4.
Update all three options for web reporting, verifying that the offline CA Business Intelligence
Reporting Server is used where appropriate.
Considerations
Consider the following information when working with replicated databases:
Sharing the CA MDB with Other CA Technologies Solutions (see page 164)
Any schema or Majic changes made to the production instance of CA Service Desk Manager
must also be applied to the reporting instance of CA Service Desk Manager.
The Web Screen Painter Schema Designer utility fails with a database error when attempting
to extend the schema to accommodate new columns in existing tables and when adding new
tables.
Considerations
2.
Log in with an account that has Microsoft SQL Server administration rights.
3.
4.
5.
Wait until the agent completes and click the Start button.
Update the Schema and Add New Columns for Existing Tables
After updating the schema to add new columns to existing tables and before you execute the CA
Service Desk Manager pdm_publish utility, verify that the command line screen buffer is
increased so that all error messages are captured.
Considerations
2.
3.
4.
5.
Click OK.
The new schema modifications can be published to the CA Service Desk Manager schema
using the pdm_publish process. For information about how to use the pdm_publish process,
see the CA Service Desk Manager Administration Guide.
Considerations
The errors occur because SQL Server attempts unsuccessfully to add the columns to the
replicated articles. To troubleshoot SQL Server errors, complete the following steps:
1.
2.
3.
Start the Microsoft SQL Server Management Studio and connect to the reporting database.
2.
Log in with an account that has Microsoft SQL Server administration rights.
Considerations
3.
4.
5.
6.
Scroll in the list to the name of the table that you attempted to update.
Note: Refer to the error messages viewed previously for the complete list of tables and
columns to update.
Considerations
7.
8.
Click OK.
The Reinitialize Subscriptions dialog appears, as shown in the following example:
9.
b.
c.
Start the Microsoft SQL Server Management Studio and connect to the reporting database.
2.
Log in with an account that has Microsoft SQL Server administration rights.
Considerations
3.
4.
5.
Start the Microsoft SQL Server Management Studio and connect to the reporting database.
2.
Log in with an account that has Microsoft SQL Server administration rights.
Considerations
3.
4.
5.
A patch for CA Service Desk Manager to help ensure that the MDB installation and upgrade
process works properly on an MDB having Merge Replication configured is available on the
CA Support website at http://ca.com/support.
Exclude all tables from the replication process that begin with tng and wv. Tables beginning
with tng and wv result in errors with the replication snapshot process.
Considerations
Exclude the usd_class_versions table from the snapshot articles when the MDB are shared
with other CA Technologies solutions. When the CA MDB is shared, including the
usd_class_versions table in the snapshot articles results in errors.
When you include a table in snapshot articles and you receive an error that is related to that
table when generating the snapshot, the first step to troubleshoot is to exclude the table
from replication.
(CA Service Catalog Integration) CA Service Catalog requires that the Copy Collation
parameter is set to true for all snapshot articles.
All tables specific to CA IT Client Manager must be excluded from replication. The tables that
are shared with CA Service Desk Manager may be included in the replication configuration.
However, this means that you must configure the removal of these shared tables from the
CA IT Client Manager internal replication mechanism. For more information about the
internal replication functionality, see your CA IT Client Manager documentation.
Additional replication configuration details when sharing the MDB with other CA
Technologies solutions are available on the CA Support website at http://ca.com/support.
Archiving
When archiving, you typically want to verify that the performance of your production server is as
optimal as possible. To help increase performance, you can implement an archive policy. The
policy can gather and put aside closed records from the production database that are older than
a certain amount of time. However, you may have requirements to report on records over a
longer time period, beyond the records that remain in the production database.
Implement an Archive Policy to Ignore Data Delete Requests
When archiving, you can use a previous feature and have the replication process ignore data
delete requests. When you use this feature, you can allow the production database to be cleared
and optimized, while still permitting reporting to continue over a more complete set of records.
To implement an archive policy that ignores data delete requests
1.
2.
Considerations
3.
On the left, search for Specify that Deletes should not be tracked for merge articles.
The search results appear.
4.
5.
When you do not want to implement this feature, perform some replication programming using
the DeleteHandler method as part of the Business Logic Handler functionality. Complete the
previous steps and search for Implement a Business Logic Handler for a Merge Article. Verify that
the article title appears as How to: Implement a Business Logic Handler for a Merge Article
(Replication Programming). Complete the instructions that are documented in the article.
Chapter 7: Upgrading
Overview
You can upgrade the Business Intelligence content and system data from BusinessObjects
Enterprise XI Release 2 to BusinessObjects Enterprise XI 3.1. Before you begin, understand the
difference between upgrading and other software update options, such as migration and
importing.
Upgrading means replacing components and files from the existing BusinessObjects
Enterprise XI Release 2 installation with components and files from BusinessObjects
Enterprise XI 3.1.
Importing means copying reports, report instances, users, groups, Universes, Universe
connections, and other objects from one BusinessObjects Enterprise deployment to another.
Migration means moving the complete CA Business Intelligence infrastructure to new clean
system.
Your available upgrade options depend on your current deployment and your preferred method
of updating.
2.
3.
Verify that CA Service Desk Manager works correctly (see page 175).
4.
Verify that CA Business Intelligence Release 3 works correctly (see page 175).
5.
6.
Uninstall the previous version of CA Business Intelligence. For more information about how
to uninstall CA Business Intelligence, see the CA Business Intelligence Implementation Guide.
Insert the installation media for CA Business Intelligence into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the cabiinstall.exe file from the root directory of the installation media to start
the installation.
2.
Select English as the language for the upgrade and click Next.
The License Agreement dialog appears.
3.
4.
Select the Yes option button to install the sample database and templates, and optionally
change the location to where the response file is installed. The default installation location
for the response file is C:\Program Files\CA\SC\CommonReporting3\cabiresponse.ine.
5.
Click Next.
The Generate Response File dialog appears.
6.
Select Yes if you want to save the CA Business Intelligence response file, otherwise select No.
7.
8.
(Optional) If you select Yes in the previous step, enter the response file name and the
directory where the response file is created. The following information provides the default
response file locations:
Click Next.
The Review Settings dialog appears.
9.
Click Install.
The CA Business Intelligence Setup Introduction dialog appears.
12. Select the language packs that you want to install, and click Next.
The BusinessObjects Enterprise Upgrade dialog appears.
13. Select Yes, perform an upgrade installation, and click Next.
The Select Existing Database dialog appears.
14. Select the database type, and based on your selected database, enter the database
information.
15. (Optional) If you want to copy data from an existing SQL Server database, select SQL Server
(ODBC) and click Browse, as shown in the following example:
b.
c.
d.
Click OK.
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
The CA Service Desk Manager Installation Menu dialog appears.
2.
Click the Product Installs tab and click the CA Business Intelligence Configuration link.
The CA Service Desk Manager Component Installer Wizard dialog appears.
3.
4.
Click Finish.
The installation begins.
5.
Verify the Customer login from the CA Service Desk Manager Self Service Interface (see page
175)
2.
3.
Start InfoView.
The Log On to InfoView dialog appears.
2.
Enter your user name and password, and click Log In.
The Folders dialog appears, as shown in the following example:
3.
4.
Verify that the CA Service Desk folder exists in the CA Reports folder.
5.
6.
Verify that the MSP Reports and Support automation folders exist in the CA Service Desk
folder.
7.
8.
9.
2.
Click Next.
The Edit CA Service Desk Connection Login Parameters dialog appears.
3.
4.
Click OK.
2.
Click Continue.
The Export Universe dialog appears.
3.
Select the domain CA Universes and groups to assign to the exported Universe, and click OK
The Universe is exported.
Chapter 8: Managing
Authentication and Security
CA Business Intelligence Security
CA Business Intelligence security involves both the authentication and authorization of users. The
CA Business Intelligence and CA Service Desk Manager integration supports different
authentication methods. Authentication is the process of verifying the identity of a user who
attempts to log in to the system.
Authentication Methods
The following table lists the authentication methods that are supported in CA Business
Intelligence, the Central Management Console, and InfoView:
CA Business Intelligence
Enterprise Authentication
Windows NT authentication
Windows AD authentication
Trusted Authentication
LDAP authentication
Enterprise Authentication
Trusted Authentication
Note: A user can configure Windows NT authentication for CA BusinessObjects Enterprise, and
custom applications through the Central Management Console. However, the Central
Management Console and InfoView do not support Windows NT authentication. The Central
Management Console and InfoView do not support Windows Active Directory authentication
with NT LAN Manager.
The default authentication method that is used for the CA Service Desk Manager integration is
Trusted Authentication. With this authentication method, BusinessObjects XI trusts CA Service
Desk Manager and authenticates the users. After you log in to CA Service Desk Manager,
BusinessObjects XI will not ask you to reenter your authentication details. Instead, your user
name is verified against the Central Management Console database.
The BusinessObjects XI authentication process uses the security plug-ins that are installed with
the product. These plug-ins expand and customize the ways in which BusinessObjects Enterprise
authenticates users. Security plug-ins simplify account creation and management, by allowing
you to map user accounts and groups from third-party products into BusinessObjects Enterprise.
Each security plug-in acts as an authentication provider that verifies the user credentials against
the appropriate user database.
The following dynamic-link libraries are associated with the individual security plug-ins:
Enterprise: secEnterprise.dll
LDAP: secLDAP.dll
You can use the following authentication methods to integrate CA Business Intelligence with CA
Service Desk Manager:
LDAP authentication
2.
3.
4.
Select Users and Groups from the drop-down list in the upper left corner, click User List in
the left pane, and click Manage, New, New User on top of the left pane.
The New User dialog appears.
5.
6.
Click Save.
Important! BusinessObjects XI does not authenticate users after Trusted Principal
Authentication is enabled. However, if you will log in to InfoView directly, the password
must match the password that CA Service Desk Manager uses.
7.
Click User List in the left pane, select ServiceDesk in the right pane, and click the Member Of
tab.
The Member Of dialog appears, as shown in the following example:
8.
9.
In the list of available groups, click Administrators, press and hold the Ctrl key while clicking
CA Universe developer, click the > button to the right of the group list, and click OK.
The ServiceDesk account is added to the Administrators and CA Universe Developer groups.
10. Click Start, All Programs, BusinessObjects XI 31, BusinessObjects Enterprise, InfoView.
The Log On to InfoView dialog appears.
11. Enter information into the following fields:
User Name
Defines the CA Business Intelligence account user name. Log in as ServiceDesk.
Password
Defines the CA Business Intelligence account password. Enter the password for the
Enterprise ServiceDesk account.
Opendoc.cms.default
Hostname:
port of your
CMS
Opendoc.siteminder.enabled
true
false
Opendoc.sso.enabled
false
true
Opendoc.trusted.auth.user.retr (blank)
ieval
REMOTE_USER
Sample:
<context-param>
<param-name> Opendoc
.trusted.auth.user.retrieval
</param-name>
<param-value>
REMOTE_USER </param-value>
</context-param>
Opendoc.trusted.auth.user.par (blank)
am
(blank)
Opendoc.trusted.auth.shared.s (blank)
ecret
(blank)
28. Use the Central Configuration Manager (Start, Programs, BusinessObjects XI 3.1,
BusinessObjects Enterprise) to restart the CA Business Intelligence Tomcat server (for
example, Apache Tomcat 5.5.20).
29. On the CA Business Intelligence server, navigate to the
NX_ROOT\bopcfg\www\CATALINA_BASE\webapps\CAisd directory.
30. Using a text editor, open the TrustedPrincipal.conf file.
31. Add the line SharedSecret=xxxxx (Where xxxxx is the shared secret as entered in the CMC).
32. Save and close the file.
33. Use the Windows Services Control Panel to restart the CA Service Desk Manager Service.
Configure LDAP Authentication
CA Business Intelligence can integrate with the following LDAP servers to import user
information.
Active Directory
Novell eDirectory
In addition to the standard LDAP servers, you can use the custom option to define custom
attributes and integrate with any LDAP server.
Important! Set the user id/System Login to CA Service Desk Manager contacts to match the
Account Name of BusinessObjects XI users. Otherwise, the integration will not work.
2.
3.
4.
Select Authentication from the drop-down list in the upper left corner.
5.
Click LDAP.
The LDAP dialog appears.
6.
7.
In the Add LDAP host field, enter the host name and LDAP port number separated by a
colon, and click Next.
The next page of the LDAP Configuration Wizard appears.
8.
In the LDAP server Type drop-down list, select Microsoft Active Directory Application Server,
and click Show Attribute Mappings to display the LDAP server attributes.
The LDAP Server Attributes Mappings page of the wizard appears, as shown in the following
example:
9.
11. In the Base LDAP Distinguished Name field, enter the search base and click Next.
The next page of the LDAP Configuration Wizard appears, as shown in the following
example:
12. Enter the CN or DN of a user with administrator rights on the LDAP, and click Next.
Note: LDAP Referral Credentials are required only if referrals are configured in the active
directory.
The next page of the LDAP Configuration Wizard appears.
13. Select Basic (No SSL) for Type of SSL authentication, and click Next.
The next page of the LDAP Configuration Wizard appears.
14. Select Basic (no SSO) for LDAP authentication, and click Next.
The next page of the LDAP Configuration Wizard appears, as shown in the following
example:
15. Under the Alias Updates Options section, select the Create new aliases when the Alias
update occurs option, and click Finish.
The LDAP Configuration Details page appears, as shown in the following example:
16. (Optional) If the Universe connection is configured to use the Database Credentials that are
associated with a specific user, as opposed to a generic user such as ServiceDesk, select the
Enable and update users Data Source Credentials at logon time option.
Note: When you select this option, the Active Directory credentials for the user are
populated after the first-time the user logs in to InfoView.
17. Add the cn or dn of the Active Directory group to map and click Add.
Note: You can add multiple Active Directory groups. However, we recommend that you have
a single group mapped to prevent performance issues while authenticating.
The next page of the LDAP Configuration Details dialog appears, as shown in the following
example:
Select the Give LDAP attribute binding priority over AD attribute binding option,
and click Update.
All the users from the mapped groups are imported into the Central Management
Console. After you import the users, add them to the default BusinessObjects XI groups
to activate additional reports rights.
b.
Select Users and Groups from the drop-down list in the upper left corner and click
User List in the left pane. Then, right-click a user and select Member of.
19. In the list of available groups. click CA Reports Admin, press and hold the Ctrl key while
clicking CA Reports Author and CA Reports Viewer, click the > button to the right of the
group list, and click OK.
You can use the new account to log in to InfoView using LDAP authentication and view
reports.
20. In CA Service Desk Manager, change the BO_Server_Auth to secLDAP and restart the
services.
Security Recommendations
Consider the following recommendations to help secure BusinessObjects:
Guest Account. Disable the guest account. The guest account allows anonymous access to
the operating environment. Disable this account to help ensure that all users log in using a
named account. By following this recommendation, you also help ensure that auditing
functions effectively.
Everyone Group. Remove rights from the Everyone group. By default, members of this group
have rights to view many objects in the system. To implement a shared secured
environment, do not provide this group with rights by default; but rather through a group
membership. Complete the following steps:
a.
In the Central Management Console, click Settings, Rights at a global level for
content objects.
Default rights are set to No Access for all objects in the system.
b.
Assign the Everyone group the Inherited Rights role for groups, users, server
groups, servers, categories, calendars and events.
The Everyone group does not appear in the rights list. The group effectively has no
rights by inheritance.
c.
Assign the Everyone group the No Access role for Universes and Universe
connections.
d.
Set the Everyone group to have Not Specified for all advanced rights that are denied
to regular users for applications such as the Central Management Console,
Designer, or InfoView.
Password Settings in the Central Management Console. Define Password settings in the
Central Management Console, Authentication dialog. The password policy covers certain
properties, such as password expiration rules and force password length.
Note: The operating environment does not differentiate uppercase and lowercase for user
and group names. For more information about setting rights and managing users and
groups, see the CA Business Intelligence Implementation Guide.
Rights
Rights are the base units to control user access to the objects, users, applications, servers, and
other features in BusinessObjects Enterprise. Rights have an important role to secure the system
by specifying the individual actions that users can perform on objects. In addition to allowing you
to control access to your BusinessObjects Enterprise content, rights allow you to delegate user
and group management to different departments. You can also provide users with administrative
access to servers and server groups.
You set rights on objects such as reports and folders rather than on the principals (the users and
groups) who access them. To allow a manager access to a particular folder, for example, you add
the manager to the access control list (the list of principals who have access to an object) for the
folder (Folders area). You cannot provide the manager access by configuring the rights for the
manager (Users and Groups area). The rights for the manager in the Users and Groups area are
used to grant other principals (such as delegated administrators) access to the manager as an
object in the system. In this way, principals are similar to objects for others with greater rights to
manage.
Each right on an object can be granted, denied, or unspecified. The BusinessObjects Enterprise
security model is designed so that if a right is not specified, the right is denied. In addition, if the
permissions for a right result in a right being both granted and denied to a user or group, the
right is denied. This denial-based design helps ensure that users and groups do not automatically
acquire rights that are not explicitly granted. An important exception applies to this rule. If a right
is explicitly set on a child object that contradicts the rights that are inherited from the parent
object, the right set on the child object overrides the inherited rights. This exception also applies
to users who are members of groups. If a user is explicitly granted a right that the group to which
the user belongs is denied, the rights set on the user override the inherited rights.
Important! As a best practice, we recommend that you associate all rights with groups. It is
easier to maintain rights with groups, rather than with individual users.
Setting Rights, Data Partition Security, and Universe Class Rights
When you configure CA Business Intelligence, default rights are assigned. Groups and users are
created, and rights are divided and separated to the groups and users, and the appropriate
folders. The rights are leveraged to make the groups role-based based on the CA Technologies
application areas. Areas for a solution such as CA Service Desk Manager can be a Change
Manager or a Problem Manager. Permissions are also set on objects such as the Universe and the
Universe Connection. The folder structure that is used to organize reports also has rights. By
applying these rights, you can deny or allow the right to view, schedule, and execute a report. A
folder named Change Orders, for example, exists that contains reports on change orders and
related objects. This folder had full control assigned to the Change Manager Group, but the
Problem Manager group has no permissions. These rights are used to create role-based group for
CA Service Desk Manager and other CA Technologies products.
Note: For more information about rights, security, authorization, and applying data partition
security to reports, see the chapter "Managing CA Business Intelligence Reports" in the CA
Service Desk Manager Administration Guide and the chapter "Set Rights" in the CA Business
Intelligence Implementation Guide (located on the installation media). For more information
about assigning rights to objects in the CA Service Desk Manager Universe, log in to
http://ca.com/support and search for the technical document TEC492117 with the article title
How to restrict few users or groups from using specific objects in CA ServiceDesk Universe.
Chapter 9: Auditing
Overview
In CA Business Intelligence, you can use the Central Management Console to enable auditing for
the following components:
You can use a second database to enable auditing. BusinessObjects Enterprise can also use the
same database for both the Central Management Server and auditing. BusinessObjects
Enterprise requires a connection to the database in your organization to act as source material
against which to run reports.
CA Business Intelligence provides default reports based on auditing information. You can execute
the reports using InfoView, as shown in the following example:
Overview
An object is created.
An object is deleted.
An object is modified.
The information is stored in the log file. The directory for the audit log file can be specified in the
Audit Log File directory section.
To audit the Central Management Server
1.
2.
Log in as an Administrator.
Overview
3.
Select Servers from the drop-down list in the upper left corner of the page.
4.
Right-click the Central Management Server named Server_Name.cms and select Audit
Events.
The Audit Events page for the selected Central Management Server appears, as shown in the
following example:
5.
6.
In the Select Events to Audit part of the page, select the check box for each event that you
want to audit.
The auditing changes for the selected Central Management Server are saved.
Scheduling succeeded.
Scheduling failed.
Overview
2.
Log in as an Administrator.
3.
Select Servers from the drop-down list in the upper left corner of the page.
4.
Overview
The Server Details page for the selected Job Server appears, as shown in the following
example:
5.
6.
7.
In the Select Events to Audit part of the page, select the check box for each event that you
want to audit.
8.
Click Update.
The auditing changes for the selected Job Server are saved.
SQL structures named objects, that map to SQL structures, such as columns, tables, and
database functions, in the database. Objects are grouped in classes. Both objects and classes
are visible to Web Intelligence users.
A schema of tables and joins that are used in the CA MDB. Objects are built from database
structures that are included in the CA Service Desk Manager schema. The schema is only
available to Designer users, and is not visible to Web Intelligence or Desktop Intelligence
users.
The CA Service Desk Manager Universe provides an interface, enabling nontechnical Web
Intelligence users to execute queries against an MDB to create reports and perform data analysis.
The CA Service Desk Manager Universe contains the following:
Classes. A class is a logical grouping of objects within a Universe and represents a category of
objects. The name of a class should indicate the category of the objects that the class
contains. A class can be divided hierarchically into subclasses.
Objects. An object is a named component that maps to data or a source of data in the
database.
In the Designer, objects are qualified as one of the following three types:
Type
Description
Example
Dimension
Work with the CA Service Desk Manager Universe Using the Designer
Type
Description
Example
Detail
Provide a description of a
Phone Number
dimension, but are not the focus
for analysis.
Measure
Sales Revenue
To connect back to the CA Service Desk Manager Object Manager, the CA Service Desk Manager
Universe uses the connection by the Data Direct ODBC driver as Universe connection.
Work with the CA Service Desk Manager Universe Using the Designer
The BusinessObjects Designer is a product that allows you to create and modify Universes for
Web Intelligence and Desktop Intelligence Users. You can use the Designer to work with the CA
Service Desk Manager Universe.
Web Intelligence requires a Universe for data access. The success of Web Intelligence depends
on the ability of the Universe design to hide the complexities of the CA Service Desk Manager
database tables and objects from the CA Service Desk Manager user. The Universe allows you to
provide a business representation of the data that is contained within the CA Service Desk
Manager database, together with predefined data relationships, selection criteria, hierarchical
aggregations, measures, and calculations.
To work with the CA Service Desk Manager Universe using the Designer
1.
On the CA Business Intelligence server, click Start, All Programs, Business Object XI 3.1,
Business Objects Enterprise, Designer.
The Designer Login dialog appears.
2.
Enter your user name, password, select the authentication type, and click OK.
The Quick Design Wizard dialog appears.
Work with the CA Service Desk Manager Universe Using the Designer
3.
Click Cancel.
The Quick Design Wizard dialog closes.
4.
Click File, Import and select Browse. The CA Service Desk Manager Universe information
exists in the CMS database and must be imported to your local computer to change the
information.
The Select a Universe Folder dialog appears, as shown in the following example:
5.
6.
Click Browse to specify a new location or click OK to accept the default location.
Note: The default location for importing Universes is C:\Documents and
Settings\LoggedIn_User\Application Data\Business Objects\Business Objects 12.0\Universes.
Work with the CA Service Desk Manager Universe Using the Designer
7.
(Optional) CA Service Desk Manager uses the data direct ODBC driver to connect to CA
Service Desk Manager. To verify or change the connection settings, click File, Parameters.
8.
9.
Click Yes.
The Edit CA Service Desk connection dialog appears, as shown in the following example:
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
Username
Defines the account user name.
Value: ServiceDesk
Password
Defines the account password.
Value: Password for the CA Service Desk Manager privileged user.
Data Source Name
Defines the name of the data source to use.
Value: data direct ODBC
11. Click Test Connection to verify the connection.
Note: If the data direct ODBC driver is not Generic ODBC 3, some actions in the CA Service
Desk Manager Universe may cause problems. To select the Generic ODBC 3 data source,
click Back in the preceding page and select Generic ODBC 3 as the data source.
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
In any multiple derived Universe environment, verify that you complete the following tasks:
Maintain the z_ naming convention for the Universe file name on all Universes.
Use the CA Service Desk Manager Connection and maintain the Universe in the CA Customer
Universe folder.
Do not delete the link to the default CA Service Desk Manager Universe.
On the CA Business Intelligence server, click Start, All Programs, Business Object XI 3.1,
Business Objects Enterprise, Designer.
The Designer Login dialog appears.
2.
3.
4.
Click the Definition tab and enter information for the following fields:
Name
Defines the name for the derived Universe.
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
Description
(Optional) Defines a description for the derived Universe.
Connection
Defines the connection for the derived Universe. Select CA Service Desk in the
drop-down list.
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
5.
6.
7.
Navigate to the CA Universes folder on your computer and select the CA Service Desk
Universe.
8.
Click OK.
The Universe to Link dialog closes. The Designer saves the link, creates the derived Universe,
and opens the derived Universe in the Designer, as shown in the following example:
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
9.
10. Click the Parameter tab and enter information for the following fields:
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
Parameter Name
Defines the parameter name for the derived Universe. Select the parameter ANSI92.
Property Value
Defines the property value for the derived Universe. Enter Yes.
11. Click the Replace button.
12. Click the Controls tab.
The Controls panel of the Universe Parameters dialog appears, as shown in the following
example:
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
16. In the Default Hierarchies (dimension objects) part of the page, select any custom hierarchy
and click Add. The hierarchy is moved to the Custom Hierarchies part of the page. If you do
not see any custom hierarchies, accept the default settings.
Create a Derived Universe to Import CA Service Desk Manager Schema Changes into CA Business Intelligence
On the CA Business Intelligence server, click Start, All Programs, Business Object XI 3.1,
Business Objects Enterprise, Designer.
The Designer Login dialog appears.
2.
3.
4.
Select the custom tables and the tables that have custom columns, and add them to the left
section of the Universe.
The custom tables are added to the object list, as shown in the following example:
5.
6.
Log in to InfoView.
7.
8.
9.
10. Create the report using the custom attributes and tables that are available in the derived
Universe, as shown in the following example:
2.
3.
Right-click the user to provide access to the CA Universe Developer group and select Join
Group.
4.
Select CA Universe Developer from the list of available groups and move the group to the
Destinations Group section.
5.
Click OK.
The user can log in to the Designer and modify the default Universe.
2.
3.
4.
Click OK.
The Universe is imported.
5.
6.
Click New.
The Edit Restrictions window appears.
7.
8.
9.
Click Add.
The New Restricted Object dialog appears.
11. Select the object or attributes that you want to restrict and click OK.
12. Click OK.
The Edit Restrictions window closes and you return to the Manage Access Restrictions
dialog, as shown in the following example:
13. In the Available groups and users section of the dialog, click Add user or group.
The Select Users and Groups dialog appears, as shown in the following example:
14. In the Available groups and users list, select the user or group to restrict and move the user
or group to the Selected groups and users list.
Designer Tips
The following tips are provided to help you use the Designer more efficiently:
Drag-and-drop. You can use the Designer to drag-and-drop objects from the Universe. When
a table is highlighted, the entire table is dragged. Therefore, if you only want one column in
the hierarchy, do not select the table when you drag-and-drop.
Hiding fields. You can use the Designer to hide fields that will be available for reporting.
Reporting Administrators can determine which objects can be viewed for a particular class
by highlighting the object and clicking the appropriate toolbar icon. When an object is
hidden, it appears in italics. In the following example, Assignee UUID is not available for any
report and query using this Universe.
Discussion
Encyclopedia
Publisher
Voyager
Process Tracker
CA Business Intelligence InfoView Release 3 provides the following additional features and
enhancements:
A new InfoView home page with Document List, Favorites, and Preferences.
You can double-click an object title to access the default action for the object.
You can right-click on an object to display all actions that you can perform on the object.
Menus are context-sensitive and display the appropriate actions that are applicable for the
current object.
Log In to InfoView
Log In to InfoView
After InfoView has been installed, you can start the web interface to verify that InfoView is ready
to use.
To start the web interface and log in to InfoView
1.
230 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Log In to InfoView
2.
3.
2.
3.
<!-- Choose whether to let the user change the authentication type -->
<!-- If it isn't shown the default authentication type from above will be used -->
<context-param>
<param-name>authentication.visible</param-name>
<param-value>false</param-value>
</context-param>
4.
5.
6.
232 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
7.
View a Report
Start InfoView.
2.
3.
Select the type of object to appear. To see all object types, select All Types from the list.
4.
Click OK.
Objects for the selected types appear on the Details page.
View a Report
You can use InfoView to view reports from SAP Crystal Reports, Web Intelligence, Desktop
Intelligence, and so forth. The permissions and default settings that your administrator selects
determines the data that you see on the report.
234 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Schedule a Report
Start InfoView.
2.
3.
To view an older instance, select the object on the Details page, click Actions, and select
History on the InfoView Workspace toolbar. Then, double-click the instance that you
want to view.
Schedule a Report
Schedule a Report
You can use InfoView to schedule reports to execute automatically at specified times. When a
scheduled object executes successfully, an instance is created. An instance is a version of the
object that contains data from the time that the object was executed.
To schedule a report
1.
Start InfoView.
2.
Navigate to the folder that contains the object that you want to schedule.
3.
4.
236 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Schedule a Report
5.
Add an Object
Print Settings
Specifies print settings to print an SAP Crystal Reports or Desktop Intelligence Report
after an instance is generated.
Events
Specifies events for the instance. CA Business Intelligence can be configured so that
reports are executed only after a specified event occurs. You can create and configure
events in the Central Management Console.
6.
Click Schedule.
An instance of the report is created and appears.
7.
(Optional) Complete any of the following actions, as shown in the following example:
To pause the schedule, select the instance on the Instance History page and select
Actions, Pause.
To resume the schedule, select the instance on the Instance History page and select
Actions, Resume.
Add an Object
You can use InfoView to add a new object (for example, new SAP Crystal Reports) and make the
object available to users for reporting.
To add an object in InfoView
1.
Start InfoView.
2.
Navigate to the folder where you want to add the new object.
238 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Add an Object
3.
On the InfoView Workspace page, click Add as shown in the following example:
Note: For an SAP Crystal Reports object, select the Crystal Reports option or select Local
Document.
4.
5.
Click Browse, navigate to the location of the object to add, and select the object, as shown in
the following example:
6.
Click OK.
The object is added and available to users in InfoView.
2.
3.
4.
240 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
5.
In the Destination drop-down list, select Email and click Add, as shown in the following
example:
6.
Password
Specifies the password for the user name for authentication.
From
Specifies the email address that is used to send email notifications from the CA Business
Intelligence server.
To
Specifies the email address to receive email notifications from the Job Server.
Cc
Specifies the email address to receive email notifications from the Job Server.
Subject and Message
Specifies the default subject and message for the email notifications. You can specify the
default subject and message manually, or select placeholders. The placeholders are
replaced with the appropriate values from the report.
Deliver Document As
Specifies if the report is sent as an attachment to the email notification. Select this
option to send the report instance as an object. You can specify a file name or use an
automatically generated name.
7.
Click Save.
8.
Click Close.
9.
Repeat the previous steps for the Destination Job Server using the Central Management
Console.
242 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Customize InfoView using the Central Management Console (see page 245)
Some important personal preferences include the locale setting for Web Intelligence documents,
the password, and whether to log off automatically when the browser closes. These settings are
shown in the following example:
244 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
2.
Click Applications.
3.
Select InfoView to view the appropriate settings, as shown in the following example:
4.
Specify the options to customize the header and style, display options, the default
navigation view, and default viewing actions on a listing page.
5.
6.
7.
Select the Groups or Users option buttons, and click Find Now.
A list of groups or users appear.
Note: If you know the user or group name, enter the name in the Look for field and click Find
Now.
8.
Select a user or group and click the Add and Assign Security button.
The Assign Security page appears, as shown in the following example:
246 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
9.
In the Available Access Levels part of the page, select the appropriate access level for the
user or group.
10. Click the arrow to move the access level to the Assigned Access Levels part of the page.
Some access levels that you can select include: Folder Access, Full Control, Schedule, View,
and View On Demand.
11. Click Apply.
The access level settings are saved. The settings are applied the next time the user or group
logs in to InfoView.
Default Reports
CA Service Desk Manager provides many default CA Business Intelligence reports. CA Business
Intelligence is the server-based reporting solution that allows you to create, manage, and deliver
interactive, web-based reports and build your own on demand reports. You can use InfoView and
Web Intelligence to view the default CA Service Desk Manager and CA Service Desk Manager
Knowledge Tools reports.
Note: Crystal Reports are delivered as the primary component of CA Business Intelligence.
However, the Crystal Reports software is not delivered with CA Service Desk Manager. Crystal
Reports requires a separate license that you can purchase from BusinessObjects, and use with CA
Business Intelligence.
Default Reports
248 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
These reports are organized and categorized in a tree and folder structure, as shown in the
following example:
Aggregate Reports
The Overall Summary Report provides the following information:
Number of requests and change orders that have been created and closed, between the
start and end dates provided.
The average time taken to close the requests and change orders.
Asset Reports
The Asset List Report provides the following information about assets:
Default Reports
Aging Reports
The following default Aging Reports are provided with CA Business Intelligence:
Report
Description
250 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
Compliance Reports
The following default Compliance Reports are provided with CA Business Intelligence:
Report
Description
Default Reports
Report
Description
Forecast Reports
The following default Forecast Reports are provided with CA Business Intelligence:
Report
Description
Resource Reports
The following default Resource Reports are provided with CA Business Intelligence:
Report
Description
252 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
in specific groups, or in all groups.
Trend Reports
The Trend Report By Group provides historical data of the percent of change orders for each
closure code, grouped by change group for a specified change group.
Volume Reports
The following default Volume Reports are provided with CA Business Intelligence:
Report
Description
Default Reports
Report
Description
Property Reports
The following default Property Reports are provided with CA Business Intelligence:
Report
Description
CA CMDB Reports
The CI Maintenance Window Report provides the Configuration Items (CIs) that are linked to
multiple services and have multiple maintenance windows.
254 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Count Reports
The Volume and Trend Report provides annual trends of opened and closed requests, based on a
user-defined annual trending parameter. For performance reasons, we recommend that you
schedule this report.
Effectiveness Reports
The Mean Time to Acknowledge & Mean Time to Resolve Report provides the annual trend of
mean time to acknowledge requests (MTTA) and mean time to resolve requests (MTTR) against
the current month and the previous three months. For performance reasons, we recommend
that you schedule this report.
SLA Reports
The SLA Violation Report provides annual trends on the percent of service level agreement (SLA)
violations against the opened request volume. For performance reasons, we recommend that
you schedule this report.
Traceability Matrix Reports
The following default Traceability Matrix Reports are provided with CA Business Intelligence:
Report
Description
Issue Reports
The default Issue Reports that are provided with CA Business Intelligence include the following
reports:
Default Reports
Aging Reports
The following default Aging Reports are provided with CA Business Intelligence:
Report
Description
Resource Reports
The following default Resource Reports are provided with CA Business Intelligence:
Report
Description
256 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
Volume Reports
The following default Volume Reports are provided with CA Business Intelligence:
Report
Description
Issue Totals
Default Reports
Property Reports
The following default Property Reports are provided with CA Business Intelligence:
Report
Description
Description
258 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Description
Comments by Contact
Searches by Contact
Default Reports
Description
Comments by Document
Document Ratings
Knowledge Feedback
Poor Votes
Description
Documents by Status
260 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
owner.
Documents Published
Expired Documents
Submitted Knowledge
Unpublished Documents
Description
Contact Information
Default Reports
Report
Description
Description
Noise Words
Special Terms
Synonyms
Description
Issues Avoided
Requests Avoided
Searches
262 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Description
System Reports
The Knowledge Management Metrics Report provides knowledge management metrics about
searches, knowledge lifecycle management, and so forth.
Default Reports
MSP Reports
The following default MSP Reports are provided with CA Business Intelligence:
Report
Description
Incident Resolution
Incident Source
Incidents by Category
Re-Categorized Incidents
264 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
Dashboards
The following default Dashboards are provided with CA Business Intelligence:
Incident Resolution
Incidents by Category
Re-Categorized Incidents
Reassigned Incidents
Detail Reports
The following default detail reports are provided with CA Business Intelligence:
Detailed Incident
Default Reports
Incident Reports
The following Incident Reports are provided with CA Business Intelligence:
266 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Issue Reports
The following Issue Reports are provided with CA Business Intelligence:
Problem Reports
The following Problem Reports are provided with CA Business Intelligence:
Request Reports
The following Request Reports are provided with CA Business Intelligence:
Default Reports
Request Reports
The default Request Reports that are provided with CA Business Intelligence include the
following reports:
Aging Reports
The following default Aging Reports are provided with CA Business Intelligence:
Report
Description
268 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
Count Reports
The Volume and Trend Report provides an annual trend of opened and closed requests based on
the selected annual trending parameter. For performance reasons, we recommend that you
schedule this report.
Effectiveness Reports
The Mean Time To Acknowledge & Mean Time To Resolve Report provides an annual trend of
mean time to acknowledge requests (MTTA) and mean time to resolve requests (MTTR) against
the current month, and previous three months. For performance reasons, we recommend that
you schedule this report.
Resource Reports
The following default Resource Reports are provided with CA Business Intelligence:
Report
Description
Analyst Summary
Default Reports
Report
Description
SLA Reports
The SLA Violation Report provides an annual trend on the percent of service level agreement
(SLA) violations, against the opened requests volume. For performance reasons, we recommend
that you schedule this report.
Volume Reports
The following default Volume Reports are provided with CA Business Intelligence:
Report
Description
Activity of Requests
270 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
Request List
List of requests.
Description
Property Reports
The following default Request Property Reports are provided with CA Business Intelligence:
Report
Description
Default Reports
Description
Active Analysts
Analyst Logins
Analyst Metrics
Assistance Sessions
Queue Entries
Survey Reports
The following default Survey Reports are provided with CA Business Intelligence:
Report
Description
Survey Details
272 Chapter 11: Managing CA Service Desk Manager Reports Using InfoView
Default Reports
Report
Description
customer selections and comments.
Survey Summary
2.
Under the Personalize heading, click the Preferences link, and then click Web Intelligence
Preferences.
3.
Customize the Web Intelligence settings. The following fields require explanation:
Note: All settings under the Web Intelligence heading only apply to Web Intelligence
documents.
Select a default view format
Sets the default method to view a Web Intelligence document. The following options
are available:
Web
Views and prints documents, responds to prompts, and performs drill analysis. If you
have the correct permissions, you can also track data changes in the Web viewer.
Interactive
Views and prints documents, applies filters to the documents, performs sorts and
calculations, modifies the format of the data in tables and charts, responds to prompts,
and performs drill analysis.
PDF
Responds to prompts, and views and prints documents directly in PDF format.
Click OK.
The customized Web Intelligence settings are saved.
Classes and Subclasses. Objects are grouped into folders named classes. Each class can
contain one or more subclasses. A class organizes the objects into logical groups. When you
create queries on the Universe, classes help you find the objects that represent the
information that you want to use in a query.
Dimension Object. A dimension object represents data that provides the basis for analysis in
a report. The following example illustrates how a dimension object appears in the Web
Intelligence query panel:
Detail Object. A detail object provides descriptive data about a dimension. A detail is always
attached to the dimension for which it provides additional information. The following
example illustrates how a detail object appears in the Web Intelligence query panel:
Measure Object. A measure object retrieves numeric data that is the result of calculations
on data in the database. An example measure object is Average KPI value in Designer. The
following example illustrates how a measure object appears in the Web Intelligence query
panel:
2.
3.
4.
5.
Drag-and-drop the required attribute from the list of objects on the left part of the
page to the Result Objects part of the page.
b.
In the list of objects on the left part of the page, expand Request Filters. In the list
of predefined filters, drag-and-drop a filter to the Query Filters part of the page.
c.
Note: For more information about creating Web Intelligence documents, see your Web
Intelligence documentation.
You want to work with Web Intelligence documents without installing a CMS or application
server.
Complete the following steps to work with the Web Intelligence Rich Client:
1.
2.
Understand the Web Intelligence Rich Client working modes (see page 284).
3.
Create a basic report using the Web Intelligence Rich Client (Connected Mode) (see page
285).
4.
Edit a report using the Web Intelligence Rich Client (Offline Mode) (see page 290).
5.
Add a report to the CA Service Desk Manager Reports tab (see page 291).
2.
Under the Personalize heading, click the Preferences link, and then click Web Intelligence
Preferences.
The Preference page appears.
3.
Under the Select a default creation/editing tool heading, select the Desktop (Web
Intelligence Rich Client required) option button and click Install Now.
The Web Intelligence Rich Client starts to install and a websetup.exe prompt appears.
4.
Click Run.
5.
6.
Click Next.
7.
8.
9.
Accept the default installation features and click Next, as shown in the following example:
Connected Mode. In this mode (the default login method), the Web Intelligence Rich Client
is connected to the CMS. Therefore, the CMS applies the security permissions of the user
account. When operating in this mode, the security permissions in the CMS are downloaded
to the local computer. The permissions are later applied when connected in Offline
(Standalone) mode.
Note: Before working in Offline mode with a specific CMS, you must have connected to the
CMS at least once in Connected mode. By connecting to the CMS at least once in Connected
mode, the Web Intelligence Rich Client can download the security permissions from the
CMS.
Offline (Standalone) Mode. In this mode, there is no connection to the CMS. As a result, no
security is enforced and you can only work on local documents.
Create a Basic Report Using the Web Intelligence Rich Client (Connected Mode)
You can create a basic report using the Web Intelligence Rich Client in Connected mode.
To create a basic report using the Web Intelligence Rich Client
1.
2.
3.
b.
c.
Verify that the Use in Offline Mode check box is not selected.
4.
5.
6.
In the list of available Universes, select CA Service Desk and click OK.
The Create Query window appears, as shown in the following example:
7.
Drag-and-drop the required attributes for the report from the left part of the page to the
Result Objects part of the page.
8.
9.
10. Select the folder in which to export the report and click Export.
The report is exported.
11. Select File, Save As.
The Save Document dialog appears, as shown in the following example:
b.
The report is saved and can be opened for editing when you are connected in Offline mode.
Edit a Report Using the Web Intelligence Rich Client (Offline Mode)
When the Web Intelligence Rich Client is connected using Offline mode, you can complete the
following tasks:
Edit a document.
2.
3.
b.
c.
4.
5.
6.
7.
2.
Select Administration, Security and Role Management, Role Management, Web Forms.
3.
4.
Complete information in the following fields. The following fields require explanation:
Web Form Name
Enter a web form name; for example, KPI Report.
CODE
Enter a code; for example, KPIREP.
Type
Select Report.
Resource
Copy the following code:
$BOServerURL?sPath=[Home],[Public+Folders],[CA+Reports],[CA+Service+Desk],[Key+Perfor
mance+Indicator]&sDocName=Service+Desk+SQL+and+Stored+Query+KPI+Values&sViewer=html
Note: In this code, the variable $BOServerURL is provided from the Options Manager. For all
reports, the resource is the same until
$BOServerURL?sPath=[Home],[Public+Folders],[CA+Reports],[CA+Service+Desk]. After, you
add the folder in which the report is present. Separate each word with a plus sign (+). After
the folder name, specify the document name, separated by the plus sign (+). At the end of
the code, the viewer to use to display the report, by default, is html.
5.
Click Save.
6.
Select Roles, Administrator, Report Web Forms tab, Update Report Web Forms.
7.
Select the KPI Report web form previously created and add the web form to the list.
8.
Click OK.
9.
2.
3.
Add service objects to the CA Service Desk Manager Universe (see page 295).
4.
2.
3.
Expand Service Desk, Application Data, Codes and browse to the Attribute Alias node.
4.
5.
(Optional) If the attribute aliases do not exists, click Create New to add them.
Object Name
Alias Name
Alias Value
in
affected_service_name
affected_service.name
pr
affected_service_name
affected_service.name
alg
request_configuration_item_UU call_req_id.affected_resource
ID
alg
request_affected_service_UUID call_req_id.affected_service
alg
request_affected_service_name call_req_id.affected_service.na
me
Note: For more information about object aliases, see the CA Service Desk Manager Technical
Reference Guide.
Select Start, Programs, Business Objects XI 3.1, Business Objects Enterprise, Designer.
The CA Business Intelligence Designer starts.
2.
3.
(Optional) Click View on the menu bar and select List Mode to access the table definition and
its columns. You can also click the view List Mode icon on the menu bar.
4.
Select View, Refresh Structure to see the objects that correspond with the attribute aliases
previously added. For example, the affected service name appears in the Universe window
for the in object.
5.
6.
7.
8.
Name
Type
Select
Affected Resource
Character
PdmString(in.affected_resource)
Affected Service
Character
PdmString(in.affected_service)
Character
in.affected_service_name
Note: The Affected Service Name has been defined in the previous step as the alias attribute
of affected service.name, which at a database level represents a join between the call_req
table and the ca_owned_asset table in the CA MDB.
9.
Type
Select
Request Configuration
Item UUID
Character
PdmString(alg.request_configur
ation_item_UUID)
Character
alg.request_affected_service
_name
13. Verify that three new objects are created in the Incident Detail Class, as shown in the
following example. Preexisting objects are dimmed because you are currently working on a
derived Universe. All dimmed objects and classes belong to the original Universe.
Type
Select
Affected Resource
Character
PdmString(pr.affected_resource
)
Affected Service
Character
PdmString(pr.affected_service)
Character
pr.affected_service_name
Type
Select
Request Configuration
Item UUID
Character
PdmString(alg.request_configur
ation_item_UUID)
Character
alg.request_affected_service_na
me
Type
Select
Character
PdmString(cialg.ci_id)
Type
Select
Character
PdmString(ci_window.nr)
Type
Select
Request Configuration
Item UUID
Character
PdmString(alg.request_configur
ation_item_UUID)
Type
Select
ID
Number
lrel_asset_chgnr.id
Change ID
Number
lrel_asset_chgnr.chg
Character
PdmString(lrel_asset_chgnr.nr)
Last Mod Dt
Date
lrel_asset_chgnr.last_mod_dt
2.
3.
4.
Click the Add button to add the derived Universe to the export list.
(Optional) Drill-down into the default folder that is displayed to access the CA Universes
folder and select the z_ServiceDesk.unv file.
The Export Universe message appears.
5.
Click OK.
The Universe is exported.
2.
From the New Document link, select to browse for additional data sources.
3.
4.
Select the derived Universe from the Available Universes list. In this example, select
z_ServiceDesk.
The Create Query page appears.
5.
Drag-and-drop objects from the left side of the page to the right side under Result Objects.
Drag-and-drop the following objects under Incident, Incident Activity to the right side of the
page:
a.
b.
Id
c.
Type Symbol
d.
Type Description
e.
Action Desc
f.
Time Stamp
g.
Last Mod Dt
h.
Time Spent
i.
j.
2.
Add a query filter to display a specific Request Reference Number, or filter on status. In this
example, you take only activities that are associated with a request in which the affected
Service field value is not null or when the incident with a configuration item that belongs to
a class Service.
3.
Drag-and-drop the Request Affected Service Name and Request Configuration Item Class
Type fields from the left pane into the Query Filters pane, as shown in the following
example. All available filtering operators appear in the following example.
4.
Select the CI with classes that is related to the service, as shown in the following example:
5.
By creating a query using objects under the Incident Detail folder, you can report on Service and
Configuration Item outages. The objects used appear in the following example.
After the first run of the query, all columns without exceptions appear on the report. You can
modify the query to insert new columns in the query and create new variables using the Variable
Editor. In these situations, drag-and-drop the new data objects to the report. After you build the
query, you can manage the report by completing the following tasks:
Displaying data
Analyzing data
Performing calculations
CI Changes Report
Reporting on changes made to Configuration Items helps show how maintainable a particular CI
is. You can review the activity log for a CI to see what has changed, and link the changes to
services. By linking the changes to services, you can see how the service is impacted. If a CI is
linked to a service, the service is affectively changed too.
For this example report, use objects under the Resources, CMDB, CI Activity Log folder in the
query; for example, CI name, CI UUID, CI status, type, and priority.
Modifying Reports
CI Window Report
Use the CI Window Report to report on maintenance windows that are associated with
Configuration Items. You can merge this report with other reports on Maintenance Windows. By
merging the reports, you can identify incident activities, CI changes, or outages of a particular CI
which are linked to a service.
The following example illustrates a sample CI Window Report:
Modifying Reports
You can modify service-driven reports in many ways. This section describes the ways that you can
modify reports, including report filtering and prompting, data tracking, variables, and so forth.
Modifying Reports
After you drag-and-drop a column name in the Report Filter pane, the Filter Editor appears. Use
the Filter Editor to input values (constant, or from a list using operators), as shown in the
following example:
Report results immediately refresh and the applied filter continues to appear in the Report Filter
pane, as shown in the following example:
Modifying Reports
You can apply several filters for the same report, as shown in the following example:
Modifying Reports
As long as the column is highlighted, Quick Filter is enabled using the menu bar for the
highlighted column, as shown in the following example:
Modifying Reports
Modifying Reports
From the Data tab, drag-and-drop columns you want to filter in the Filter pane, as shown in the
following example:
Modifying Reports
Data Tracking
Using Web Intelligence, you can track changes between report instances and display the changes
differently, based on the Activate Data Tracking options. You activate Data Tracking using the
Track button on the toolbar. When you click the Track button, the Activate Data Tracking dialog
appears, as shown in the following example:
You select a particular data set as a reference point for future changes. This data is known as the
reference data. When you activate data tracking, two additional options are available:
Hide data tracking
Hides the highlighted data changes when data tracking is activated. This option appears to
the right of the Data tracking button.
Data tracking options
Opens the Data Tracking Options dialog where you can define the formatting that is used to
highlight data changes. This option appears to the right of the Hide data tracking option.
Note: Your ability to activate data tracking and to change the formatting for data changes when
data tracking is activated depends on the rights assigned to you by your administrator.
Modifying Reports
2.
3.
(Optional) Click Refresh Now to refresh the data when the Activate Data Tracking dialog
closes.
4.
Click OK.
The following example illustrates data tracking activated with new activities compared to the
latest report instance (displayed in blue color) and numeric field increased (displayed in green
color). This example also illustrates how to set display and format for a change in a report.
Modifying Reports
Variables
You can use the Variable Editor to create new variables. A variable is the result from a formula
using a BusinessObjects function, columns retrieved by the query, and built-in operators. You can
create a variable using the icon on the toolbar or by selecting Data, Variables on the menu, as
shown in the following example:
After you create a variable, you can update it using any of the following steps:
As shown in the following example, you can also right-click a variable to duplicate or delete it.
Modifying Reports
Before a variable is available, the variable formula must be validated by clicking the checkmark
icon to the right of the formula field, as shown in the following example:
After you create a variable, it is available similar to any column that the query retrieves.
Modifying Reports
Sections
After you have the necessary data, you may want to organize the data by section. To create a
section, right-click a column (select the column value and not the column caption value) and
select Set as Section, as shown in the following example. You can also create a section from the
menu bar by selecting Reporting, Set as Section.
The Set as Section feature generates a list that is organized by section. In this example, the list is
organized by Affected Service. The column used for the section has been automatically removed
from the table and placed as a header for the section, as shown in the following example:
Modifying Reports
Using the same way to define a section, you can define subsections inside a section. You can
define an unlimited number of section layers.
Modifying Reports
Report Structure
For a view and to understand a report, you may want to display and work on the report structure
rather than the report result. To display the structure of a report, complete one of these steps:
Click the View Structure icon (last icon on the right from the reporting toolbar).
The following example represents the structure of a report with a section by Request Affected
Service name and a subsection by Request configuration name:
Similar to the Result mode, you can format a report to add and edit columns.
Modifying Reports
Modifying Reports
Calculations
Built-in calculations can be inserted automatically at the end of a table for each section break.
Depending on the data type (numeric compared to characters) of the column selected, the
available calculations are different.
Numeric Columns
For numeric columns, the available calculations are the following:
Sum
Average
Minimum
Maximum
Percentage
Text Columns
For text columns, the available calculations are the following:
Minimum
Maximum
As shown in the following example, you can use a built-in calculation for several columns:
Modifying Reports
You can also insert variables (measures) at a section break to generate a calculation at the
section level and not at the record level. To insert a variable at a section level, drag-and-drop the
variable from the Data tab in a report to the section area. Do not drag-and-drop the variable in
the table.
Note: When your report contains too much data, you may want to switch to Structure mode
instead of View Result.
Modifying Reports
2.
Click the ellipse to determine the condition, as shown in the following example.
Modifying Reports
In this example, you want to have a different display for the service name when the count of
activity for that service name is greater than 300.
4.
After you determine the condition, specify the display format for fields that are associated
with the alerter, as shown in the following example:
Modifying Reports
5.
After you define the alerter, select the column that you want to associate with the alerter.
6.
Select the alerter and select the check box for the alerter to which you want to associate.
As shown in the following example, the affected service appears differently due to the
defined alerter.
Modifying Reports
Note: You can define multiple alerters for the same report.
Ranking
You can use ranking to display the top n or bottom n values based on measures (numeric) values.
Ranking is associated with the calculation mode being either a count percentage Cumulative Sum
or Cumulative Percentage, as shown in the following example:
Modifying Reports
Modifying Reports
Report Templates
Web Intelligence has several report templates that you can apply to a report. Previous examples
in this guide use a vertical template, and you use drag-and-drop to transform a report in a
horizontal template. The following example illustrates all available templates for drag-and-drop
operations to transform reports into a horizontal table.
Modifying Reports
In the Web Intelligence Rich Client, right-click the Report tab and select Insert Report as
shown in the following example:
Modifying Reports
2.
Drag-and-drop Request Affected Service from the Data tab on the left to the report area on
the right.
Modifying Reports
3.
Right-click the report, select Turn To in the drop-down menu, and select the graph that you
want to display as shown in the following example:
Modifying Reports
Modifying Reports
5.
Expand the graph frame horizontally and vertically, as shown in the following example:
6.
Modifying Reports
The Properties tab contains all display parameters for the graph.
Note: You can construct graphs directly from the Templates tab.
7.
From the Template tab, drag-and-drop a template for the report that you want to create.
In this example, drag-and-drop the Vertical Bar and Line template.
Modifying Reports
8.
From the Data tab, drag-and-drop Request Affected Service Name to the graph and release it
over Place dimension objects here, as shown in the following example. Repeat this step for
the measures fields (Count_Activities and count_ref_num) and release them over Place
measure objects here.
9.
For more information about launching CA Service Desk Manager in context, see the CA Service
Desk Manager Implementation Guide.
By creating a query using objects under the Incident Detail folder, you can report on Service and
Configuration Item outages. The objects used appear in the following example. To calculate the
duration, a new column is created in the Universe. This new column represents the difference
between outage stop and outage start. In the Universe, create an object under the Incident
Folder and name it Outage_Duration as shown in the following example:
This new object should be a number and should contain the following in the Select field:
Case
When in.outage_end_time=0 then (PdmToday() -in.outage_start_time)/(3600) else
(in.outage_end_time - in.outage_start_time)/(3600)
END
Click the Properties tab and verify that the object is a measure and a sum executes when
aggregated, as shown in the following example:
Downtime Calculation
Some additional useful information when working with service outages is the ability to calculate
downtime according to a workshift. Typically, a customer wants to differentiate downtime in
business hours and non-business hours.
In this example, use the Universe Designer to create two numeric fields in the Incident, Incident
Analysis, Incident Measures folder. One field calculates the outage during business hours, and
another during non-business hours. The following table contains the object name and select
clause you define to calculate the outages:
Object Name
Select Clause
Object Name
Select Clause
Downtime fields previously created are calculated in seconds. To improve the reading, you can
transform them into hours. By dividing them by 3600, create the following two variables:
Hours_Outage_Downtime_Business_Hours
Hours_Outage_Downtime_NON_Business_Hours
Create a Crystal Report using the Data Direct ODBC driver (see page 349).
Create a Crystal Report using the CA Service Desk Manager Universe (see page 357), which is
installed during the CA Business Intelligence configuration.
Body
Defines the body of the report. This area is printed one time for each record. The majority of
the report data typically appears in this area.
Report Footer
Defines the information that you want to appear only once at the end of the report (such as
grand totals). You can also use this area for charts and cross-tabs that include data for the
entire report.
Page Footer
Contains the page number and any additional information you want to appear on the
bottom of each page on the report.
The following example illustrates the areas of the Crystal Reports Editor:
2.
Add tables.
3.
4.
5.
6.
7.
8.
9.
These steps are described in the procedures to create a report using the Data Direct ODBC Driver
(see page 349) or the CA Service Desk Manager Universe (see page 357).
The default port number for Data Direct ODBC version 6 is 19987. However, you can change the
port number during the CA Business Intelligence configuration.
The following example illustrates the architecture of the Data Direct ODBC driver:
Insert the installation media for CA Service Desk Manager into the drive on the computer.
When Autoplay is enabled, the installation starts automatically. When Autoplay is disabled,
double-click the setup.exe file from the root directory of the installation media to start the
installation.
2.
Select the language for the installation and click Select Language.
3.
Click the Product Installs tab and click the CA Business Intelligence Configuration link, as
shown in the following example:
4.
5.
Click Finish.
The configuration is complete. A CA Service Desk Manager data source is available on the
System DSN tab of ODBC Data Sources.
Note: CA Business Intelligence requires a 32-bit ODBC connection. If you are installing CA
Business Intelligence on a 64-bit operating environment, such as Windows 2008 R2, create
the ODBC DSN using ODBCAD32.exe located in the <WINDIR>/SYSWOW64 folder.
7.
Double-click the ODBC connection and click Test Connect, as shown in the following
example:
Type the Service Desk Privileged User Name and Password in the Data Source User Name
and Data Source Password fields.
9.
Click OK.
The Connection test was successful message appears.
2.
3.
In the Available Data Sources list, expand the Create New Connection folder.
4.
5.
6.
Enter the user name for the user to connect to the CA Service Desk Manager server, and the
password for the user.
7.
Click Finish.
The Database Expert dialog displays the new connection and the CA MDB database, as
shown in the following example:
8.
In the Available Data Sources list, expand the CA MDB database, select the required objects
for the report, and click the right arrow button to move the objects to the Selected Tables
list.
The objects appear in the Selected Tables list, as shown in the following example:
9.
Click OK.
13. After you add the required fields, click Report, Refresh Report Data.
A report preview appears, as shown in the following example:
14. Select File, Save As and save the report locally, or to the Enterprise.
15. (Optional) To save the report to an Enterprise location, select Enterprise in the Save As
dialog.
The Log On to BusinessObjects Enterprise dialog appears, as shown in the following example:
16. Enter the user name and password to log on to BusinessObjects Enterprise and click OK.
The Save As dialog appears, as shown in the following example:
17. Select a folder location for the report, specify a file name, and click Save.
The report is saved.
2.
3.
In the Available Data Sources list, expand the Create New Connection folder.
4.
5.
Expand the CA Universe folder, select the CA Service Desk Universe, and click Open.
The BusinessObjects Query Panel appears, as shown in the following example:
6.
Drag-and-drop the required report attributes from the CA Service Desk Universe to the
Results Objects section of the page.
7.
Click OK.
The Database Expert dialog appears with the CA ServiceDesk_Query, as shown in the
following example:
8.
In the Available Data Sources list, select the CA Service Desk_Query in the Universes folder.
9.
Click the right arrow to move the selection to the Selected Tables list.
14. After you add the required fields, click Report, Refresh Report Data.
A report preview appears, as shown in the following example:
15. Select File, Save As and save the report locally, or to the Enterprise.
16. (Optional) To save the report to an Enterprise location, select Enterprise in the Save As
dialog.
The Log On to BusinessObjects Enterprise dialog appears, as shown in the following example:
17. Enter the user name and password to log on to BusinessObjects Enterprise and click OK.
The Save As dialog appears, as shown in the following example:
18. Select a folder location for the report, specify a file name, and click Save.
The report is saved.
2.
3.
4.
5.
6.
In the Connector section of the file, change the Tomcat port based on your requirements.
The following sample code illustrates the updated port:
<Connector URIEncoding="UTF-8" acceptCount="100" ConnectionTimeout="20000" debug="0"
disableUploadTimeout="true" enableLookups="false" maxSpareThreads="75" maxThreads="150"
minSpareThreads="25" port="PORT #" redirectPort="8443"/>
7.
8.
Update the shortcuts to the InfoView and Central Management Console to indicate the new
Tomcat port. The following sample URLs indicate the new Tomcat port:
9.
Start the Central Configuration Manager by selecting Start, All Programs, BusinessObjects XI
3.1, BusinessObjects Enterprise, Central Configuration Manager.
The Central Configuration Manager appears, as shown in the following example:
13. Update the bo_server_location value to indicate the new CA Business Intelligence Tomcat
port, as shown in the following example:
14. On the CA Service Desk Manager server, restart the ServiceDesk service.
The Tomcat port is changed.
On the CA Business Intelligence server, start the Central Configuration Manager by selecting
Start, All Programs, BusinessObjects XI 3.1, BusinessObjects Enterprise, Central Configuration
Manager.
The Central Configuration Manager appears.
2.
3.
4.
On the CA Business Intelligence server, use Windows Explorer to rename the existing Tomcat
installation directory.
Use the links on the page to find and download Apache Tomcat 5.5.30.
Extract the content of the downloaded Apache Tomcat 5.5.30 file into the following
directory:
7.
8.
9.
Use the links on the page to find and download the Apache Tomcat compatibility
package.
Extract the content of the downloaded Apache Tomcat compatibility package into the
updated Apache Tomcat installation directory:
13. (Optional - if you changed the default CA Business Intelligence ports) Copy the server.xml file
from the C:\Program Files\CA\SC\CommonReporting3\Tomcat55_Original\conf\server.xml
location to the appropriate location:
14. (Optional - if you changed the default CA Business Intelligence web.xml file) Copy the
web.xml file from the C:\Program
Files\CA\SC\CommonReporting3\Tomcat55_Original\conf\web.xml location to the
appropriate location:
15. Start the Central Configuration Manager by selecting Start, All Programs, BusinessObjects XI
3.1, BusinessObjects Enterprise, Central Configuration Manager.
16. Restart the Apache Tomcat 5.5.30 service.
Note: The Central Configuration Manager incorrectly indicates on the page that the service is
Apache Tomcat 5.5.20. The underlying service is Apache Tomcat 5.5.30.
17. Log in to CA Service Desk Manager as an Administrator.
18. Navigate to Administration, Options Manager, Web Report.
19. Update the bo_server_location value to indicate the new CA Business Intelligence Tomcat
port, as shown in the following example:
20. On the CA Service Desk Manager server, restart the ServiceDesk service.
The Tomcat release number is changed.
21. Log in to either CA Business Intelligence or CA Service Desk Manager and verify that the CA
Business Intelligence reports are executing correctly.
The desired result is that a scheduled report uses a common business date range that
automatically calculates the appropriate date when you execute the report. For example, "Year
To Date" automatically sets 01/01/10 - 04/12/10 and "Last Month" indicates the date range
03/01/10 03/31/10.
2.
3.
Connect to a CA Service Desk Manager primary or secondary server that contains the
reporting data by executing the following command:
connect user*"password"@casd_MYSERVER
In this command, casd_MYSERVER is the ODBC connection that is defined for your server.
The following is a sample command:
pdm_isql connect ServiceDesk*"ServiceDeskPW@casd_MYSERVER
5.
6.
7.
After you are comfortable using pdm_isql to test date ranges, execute the following sample
commands as a possible approach for common date ranges:
SELECT ref_num,
PdmToday(-1,-1) AS Yesterday_Start,
PdmToday(-1,1) AS MonthToDate_Start,
PdmToday(-1,1,-1) AS PreviousMonth_Start,
PdmToday(-1,1,1) AS FirstQuarter_Start,
PdmToday(-1,1,4,-1) AS LastYrSecondQuarter_Start
FROM in;
/* Sample end date ranges for testing in pdm_isql */
select ref_num,
PdmToday(1,-1) AS Yesterday_End,
PdmToday() AS MonthToDate_End,
PdmToday(1,31,-1) AS PreviousMonth_End,
PdmToday(1,31,3) AS FirstQuarter_End,
PdmToday(1,31,6,-1) AS LastYrSecondQuarter_End
FROM in;
2.
3.
4.
At the bottom of the Universe panel, click the yellow Filter icon.
5.
Expand the list to a filter (for example, Incident Filters), right-click the filter, and select
Condition as shown in the following example:
6.
Specify a name for the filter; for example, "Open Ranges" to filter on incident open dates.
7.
In the where clause for the filter, leverage the @Select() function in the Universe with the
@Prompt() function to create a prompt when a specific data value is selected.
8.
Start InfoView.
2.
3.
4.
Drag-and-drop the custom filter to the Query Filters section of the Edit Query page.
5.
6.
7.
Rename the report to indicate the date range being used, as shown in the following
example:
8.
Expand the Incident Filters list to Incident, Incident Detail. Drag-and-drop Ref Num, Open
Date, and Description to the Result Objects.
9.
Expand the Incident Filters list to Incident, Incident Filters. Drag-and-drop Open Ranges to
the Query Filters.
Prompt has Yesterday, Month To Date, Previous Month, First Quarter, and so forth.
10. Select an option and use the arrows to move the option to the Select a predefined time
frame area of the page.
PDM Functions
Verify that the incidents returned only show the incidents within the selected date
range.
Verify the report output at specific intervals to help ensure that the dates remain
accurate.
PDM Functions
The following PDM functions are provided for your reference.
Function
Description
PdmAddDays([date,] count)
PdmAddMonths([date,] count)
PDM Functions
Function
Description
PdmDay([date])
PdmDownTime( slaName, workshift, startDate, Calculates the downtime between two dates
endDate )
within the specified service level agreement
(SLA) and workshift. This function can only be
used in the selection list.
PdmMonth([date])
PdmMonthName([date])
PDM Functions
Function
Description
PdmDay([date])
PdmSeconds(date)
PdmString(column)
PdmToday()
PdmYear([date])
Step 1 - Decide what CA Service Desk Manager fields to analyze (see page 386).
2.
Step 2 - Map the fields to their attribute names (see page 386).
3.
4.
Step 4 - Look up valid values in the SREL table (see page 389).
5.
Map Fields Using the Web Screen Painter (see page 387)
A common name
If this statement is not included, the object is treated according to default specifications.
Incidents: in
Requests: cr
Problems: pr
Issues: iss
Use the bop_sinfo a <factory> command to show all of the attributes for that object. For
example, to see all of the attributes for incidents, use the bop_sinfo a in command.
Map Fields Using the Web Screen Painter
You can use the Web Screen Painter to find attributes for an object. This method may be easier
because you can review the fields on the form and see the attribute name. For more information
about using the Web Screen Painter, see the CA Service Desk Manager Administration Guide.
To visually find the attributes for an object
1.
2.
Open the Ticket Detail window. For example, for incidents, open detail_cr.htmpl.
The detail forms for other ticket types are the following:
3.
Request: detail_cr.htmpl
Incident: detail_in.htmp
Problem: detail_pr.htmpl
Issue: detail_iss.htmpl
Review the attribute names for the fields in the related boxes.
a.
b.
Database Field
Data Type
description
description
STRING
category
category
STRING
prob_ctg (pcat)
You now have all of the information that you need for description. You know the attribute name,
you have found that its value is a STRING, and it does not have a Relationship table (SREL).
However, further investigation is needed for Request Area (category) because it has a SREL
associate with it.
Note: The other types of main CA Service Desk Manager objects can be found in the following
sections in the CA Service Desk Manager Technical Reference Guide.
1.
Request - cr Object
2.
Incident - cr Object
3.
Problem - cr Object
4.
5.
The persid column shows the valid string values for the Incident Area (category), and the sym
column includes the corresponding display name.
You can also use the command line to extract the information. On the CA Service Desk Manager
primary or secondary server, use the following command: pdm_extract Prob_Category. The
Prob_Category is the schema name for the pcat factory. You can see this information using the
bop_sinfo command with the fq options. For example, use the bop_sinfo fq pcat command.
Attribute/Field
Name
Valid Values
Description
description
Any String
Incident Area
category
pcat:5100
Software
pcat:5101
Hardware
pcat:5102
Networks
pcat:5103
Applications
pcat:5104
Software.Environment
pcat:5105
Software.Environment.DOS
pcat:5106
Software.Environment.OS2
pcat:5107
Software.Environment.Windows
pcat:5108
Printer
pcat:5109
Values Referencing To
Index
A
About this Guide 14
ACKNOWLEDGEMENTS iii
Add a Filter to the Universe 377
Add a Report to the CA Service Desk
Manager Reports Tab 282, 291
Add a User to the CA Universe Developer
Group 221
Add an Object 238
Add Service Objects to the CA Service Desk
Manager Universe 293, 295
Administering Tomcat 365
Aggregate Reports 248, 249
Aging Reports 250, 255, 256, 268
Alerters and Conditional Display 322
Archiving 157, 165
Asset Reports 248, 249
Audit the Central Management Server 199
Audit the Job Servers 199, 201
Auditing 199
Authentication Methods 179
C
CA Business Intelligence and CA Service
Desk Manager Communication 35
CA Business Intelligence Hardware
Requirements 39
CA Business Intelligence Security 179
CA Business Intelligence Servers 22
CA Business Intelligence Universe and
Designer 205
CA CMDB Reports 248, 254
CA Service Desk Manager and
BusinessObjects Enterprise Authentication
Integration Details 37
CA Service Desk Manager Integration
Reports 259, 263
CA Service Desk Manager Universe Mapping
with CA MDB Data 279
CA Service Desk Manager Universe Security
220
CA TECHNOLOGIES PRODUCT REFERENCES
v
Calculations 320
D
Dashboards 264, 265
Data Tracking 312
Default Reports 247
Designer and Universe Fundamentals 205
Designer Tips 227
Detail Reports 264, 265
Display Filter Criteria 306, 310
Downtime Calculation 339
Drill Down Function 306, 311
E
Edit a Report Using the Web Intelligence
Rich Client (Offline Mode) 282, 290
Effectiveness Reports 254, 255, 268, 269
Example
Service Reports to Generate Metrics
299
Export the Universe 175, 178, 293, 298
392 Index
F
FEEDBACK v
Forecast Reports 250, 252
Formatting the Report 326
G
Gather Files and Data from the Production
Instance of CA Service Desk Manager 123,
125, 126
H
How BusinessObjects Enterprise Processes
Information 28
How CA Service Desk Manager Integrates
with CA Business Intelligence 63
How to Configure CA Business Intelligence
with a Replicated Reporting Database 122
How to Configure SQL Server as the CMS
Database 39, 40, 68, 80, 87, 96, 167
How to Create a Report 342
How to Create Service View Reports 293
How to Customize InfoView 243
How to Implement a Complex Reporting
Infrastructure 66
How to Install and Configure the Reporting
Instance of CA Service Desk Manager 122,
123
How to Install and Integrate CA Business
Intelligence and CA Service Desk Manager
(Simple Installation with One Server) 39
How to Map CA Service Desk Manager
Fields 385
How to Troubleshoot SQL Server Errors
160
How to Upgrade to BusinessObjects XI
Release 3.1 167
How to Work with the Web Intelligence
Rich Client 282
I
Implement an Archive Policy to Ignore Data
Delete Requests 165
Implement Tenant Restrictions in CA Service
Desk Manager 111
Incident and Problem Management Reports
248, 254
J
Job Roles and Client Tools 20
K
Key Performance Indicator Reports 248,
258
Knowledge Document Effectiveness Reports
259, 260
Knowledge Document Status Reports 259,
260
Knowledge Management Reports 248,
259
Knowledge Team Productivity Reports
259, 261
L
LEGAL NOTICE ii
Log In to InfoView 230, 275, 280, 282
Logging in to BusinessObjects Enterprise
28
M
Make a Specific Type of Object Appear
233
Make the Authentication Drop-Down List
Appear 232
Managed Service Provider (MSP) Reports
248, 264
Managing Authentication and Security
179
Managing CA Service Desk Manager Reports
Using InfoView 229
Managing Web Intelligence Reports 275
Map Fields Using the Command Line 386
Map Fields Using the Web Screen Painter
386, 387
Mapping CA Service Desk Manager Fields
385
Modifying Reports 306
MSP Reports 264
Multi-Tenancy 111
O
Operational Dashboard Reports 248, 266
Oracle Considerations 128
Overview 13, 17, 63, 119, 167, 199, 229,
275, 341, 385
P
PDM Functions 381
Problem Reports 266, 267
Property Reports 250, 254, 256, 258, 268,
271
Q
Querying CA Service Desk Manager with
BusinessObjects Enterprise 36
R
Ranking 325
Reinitialize the Subscriber 160, 162
Reinitialize the Subscriptions 160
Report Filtering and Prompting 306
Report Structure 318
Report Templates 327
Request Reports 248, 266, 267, 268
S
Schedule a Report 236, 240
Search Administration Reports 259, 262
Search Effectiveness and Usage Reports
259, 262
Sections 316
Security Recommendations 195
Service Outage Report 303, 337
Set Up the Reporting Instance of CA Service
Desk Manager 123, 126
Setting a Schedule for Crystal Reports 28,
34
Setting Rights, Data Partition Security, and
Universe Class Rights 197
Sharing the CA MDB with Other CA
Technologies Solutions 157, 164
SLA Reports 254, 255, 268, 270
Step 1 - Create the File Shares for CA
Business Intelligence 66, 67
Step 1 - Decide What CA Service Desk
Manager Fields to Analyze 385, 386
Step 2 - Install the First Server in the
Intelligence Tier of CA Business Intelligence
66, 68, 87, 96
Step 2 - Map the Fields to their Attribute
Names 385, 386
Step 3 - Install the CA Business Intelligence
Web Application Tier Servers 66, 80
Step 3 - Map the Fields to their Object
386, 388
Step 4 - Install the Second Server in the
Intelligence Tier of CA Business Intelligence
66, 87
Step 4 - Look up Valid Values in the SREL
Table 386, 389
Step 5 - Install the CA Business Intelligence
Processing Tier Servers 66, 96
Step 5 - Use the Collected Information
386, 390
Step 6 - Configure the Input and Output File
Repository Servers 66, 102
394 Index
T
Test a Filter Using the pdm_isql Command
375
Test the Connection to CA Service Desk
Manager 175, 177
The BusinessObjects Enterprise
Architecture 17, 63, 80, 96
The Central Management Server (CMS)
Database 40
The Crystal Reports Editor 341
The Data Direct ODBC Driver 343
The PdmToday Function 374, 383
The Quick Filter 306, 309
The Reporting Menu Bar 306, 307
Traceability Matrix Reports 254, 255
Trend Reports 250, 253
Troubleshoot Table Permissions in the
Replicated Database 155
Troubleshooting 373
U
Update a Publication 143
Update the Schema and Add a New Table
158
Update the Schema and Add New Columns
for Existing Tables 158
Upgrade the BusinessObjects Installation
167, 168
Upgrade the Tomcat Release Number 367
Upgrading 167
Use the Report in InfoView 335
V
Variables 314
Verify that CA Business Intelligence Release
3 Works Correctly 167, 175
W
Web Intelligence Reports and Date Ranges
373
Web Intelligence Rich Client Working
Modes 282, 284
Web Screen Painter 157
Work with the CA Service Desk Manager
Universe Using the Designer 206