Professional Documents
Culture Documents
BMC Impact Solutions 7.3 - Getting Started Guide PDF
BMC Impact Solutions 7.3 - Getting Started Guide PDF
Supporting
BMC Impact Manager 7.3
BMC Impact Event Adapters 7.3
BMC Impact Administration Server 7.3
BMC Impact Explorer 7.3
BMC Impact Publishing Server 7.3
BMC Impact Service Model Editor 7.3
BMC Impact Portal 7.3
February 2009
www.bmc.com
Telephone
Fax
Fax
Customer support
You can obtain technical support by using the BMC Software Customer Support website or by contacting Customer
Support by telephone or e-mail. To expedite your inquiry, see Before contacting BMC.
Support website
You can obtain technical support from BMC 24 hours a day, 7 days a week at http://www.bmc.com/support_home.
From this website, you can
s
s
s
s
s
s
s
s
read overviews about support services and programs that BMC offers
find the most current information about BMC products
search a database for issues similar to yours and possible solutions
order or download product documentation
download products and maintenance
report an issue or ask a question
subscribe to receive proactive e-mail alerts when new product notices are released
find worldwide BMC support center locations and contact information, including e-mail addresses, fax numbers, and
telephone numbers
product information
product name
product version (release number)
license number and password (trial or permanent)
machine type
operating system type, version, and service pack or other maintenance level such as PUT or PTF
system hardware configuration
serial numbers
related software (database, application, and communication) including type, version, and service pack or
maintenance level
messages received (and the time and date that you received them)
Contents
Chapter 1
Infrastructure configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Basic deployment configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Standard deployment configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Atrium deployment configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring BMC Impact Manager cells in internationalized environments . . . . . .
Configuring user accounts, roles, groups, and passwords . . . . . . . . . . . . . . . . . . . . . .
Obtaining user accounts for BMC Impact Explorer in the BMC Impact
Administration Server (IAS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create new account and user for BMC Impact Portal . . . . . . . . . . . . . . . . . . . . . . .
Synchronizing user accounts created in BMC Impact Portal with IAS . . . . . . . . .
Changing your BMC Impact Explorer password . . . . . . . . . . . . . . . . . . . . . . . . . . .
Resetting the Oracle password used during installation. . . . . . . . . . . . . . . . . . . . .
Configuring Impact Administration server for failover. . . . . . . . . . . . . . . . . . . . . . . . .
Defining primary and secondary BMC Impact Administration servers. . . . . . . .
Defining a failover configuration for the Impact Administration cell. . . . . . . . . .
Creating additional cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cell naming conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating a new cell and its associated Knowledge Base . . . . . . . . . . . . . . . . . . . . .
Creating cell-specific configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registering an additional cell with the BMC Impact Administration server (IAS) . .
Configuring cells to communicate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring cells on the same computer to communicate . . . . . . . . . . . . . . . . . . .
Configuring cells on different computers to communicate with other cells or
components, such as BMC Impact Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring high availability cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting up BMC Impact Event Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Post-installation tasks for the SNMP Adapter Configuration Manager . . . . . . . .
Enabling and disabling BMC Impact Event Adapters . . . . . . . . . . . . . . . . . . . . . . .
Starting and stopping the BMC Impact Event Adapters . . . . . . . . . . . . . . . . . . . . .
Stopping the BMC Impact Event Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting the BMC Impact Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registering cells in BMC Impact Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting BMC IX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring cell connection properties to BMC Impact Explorer . . . . . . . . . . . . . . . .
Specifying ports in cell connection properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connecting and disconnecting a cell or group of cells from BMC Impact Explorer .
Adding and configuring additional Impact Administration servers in BMC IX . . . .
Setting BMC IAS connection properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
13
14
14
16
18
20
20
21
22
22
22
23
23
23
24
25
25
26
26
27
28
29
29
30
34
34
37
39
41
42
42
43
45
47
47
50
51
61
79
95
105
106
107
107
107
109
Index
111
Contents
Figures
Basic event management infrastructure configuration workflow . . . . . . . . . . . . . . . . 15
Standard event management infrastructure configuration workflow . . . . . . . . . . . . 17
Atrium service impact management infrastructure configuration workflow . . . . . . 19
Disconnected cells and cell groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Available Impact Managers list for a user account with administrator permissions 59
Location of elements in the Events view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Events view navigation pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
How event operations affect event state . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Event Sources selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
List of event management policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
History tab showing executed dynamic data enrichment policy . . . . . . . . . . . . . . . . 77
Service modeling workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Creating an alias association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Location of elements in the Services View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Edit Configuration Services View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Edit Configuration Graph Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
BMC Impact Explorer Services View - Impact/Cause View . . . . . . . . . . . . . . . . . . . 101
Services View navigation pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Service component with associated events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Related components cause search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Related components - providers search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Figures
10
Tables
Basic deployment infrastructure configuration procedures . . . . . . . . . . . . . . . . . . . . . 15
Standard event management infrastructure configuration procedures . . . . . . . . . . . 17
Atrium service impact management infrastructure configuration procedures . . . . . 19
mcell.dir entries for failover pair of Impact Administration cells . . . . . . . . . . . . . . . . 24
mcxa command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Cell connection properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
BMC IAS Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Description of elements in the Events view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Description of elements in the Events view navigation pane . . . . . . . . . . . . . . . . . . . 64
Event relations icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Event states resulting from event operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Current operator information in event list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Event status icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Event severity levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Event priority icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Out-of-the-box policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Icons in Objects-to-be-Published pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Description of elements in the Services view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Edit Configuration - Services View display settings . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Edit Configuration - Graph Views display settings . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Description of elements in the Services View navigation pane . . . . . . . . . . . . . . . . . 103
Services View service component information subtabs . . . . . . . . . . . . . . . . . . . . . . . 105
Tables
11
12
Chapter
This chapter provides the information you need to configure the basic infrastructure
required to manage events or services.
This chapter presents the following topics:
Infrastructure configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring BMC Impact Manager cells in internationalized environments. . . . . . .
Configuring user accounts, roles, groups, and passwords . . . . . . . . . . . . . . . . . . . . . .
Configuring Impact Administration server for failover. . . . . . . . . . . . . . . . . . . . . . . . .
Creating additional cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registering an additional cell with the BMC Impact Administration server (IAS) . .
Configuring cells to communicate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring high availability cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting up BMC Impact Event Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting the BMC Impact Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registering cells in BMC Impact Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting BMC IX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring cell connection properties to BMC Impact Explorer . . . . . . . . . . . . . . . .
Connecting and disconnecting a cell or group of cells from BMC Impact Explorer .
Adding and configuring additional Impact Administration servers in BMC IX . . . .
Viewing cell information from BMC Impact Explorer . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting or stopping the cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating and managing cell groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
14
20
20
23
25
27
28
30
34
42
42
43
45
47
50
53
53
57
13
Infrastructure configuration
Infrastructure configuration
There are several ways to configure the BMC Impact Solutions infrastructure
components depending on whether you want to manage events or manage services
and which products you want to use with BMC Impact Solutions. Your configuration
tasks depend on which deployment option you selected to installbasic, standard, or
Atrium. (For details on these deployment options, see the BMC Impact Solutions
Planning and Implementation Guide.)
s
s
s
s
These components provide the basis for event and service monitoring and
management.
Figure 1 on page 15 provides a workflow of the tasks needed to set up these basic
infrastructure components so that you can start monitoring and managing events.
14
Figure 1
Table 1
Procedure
See
Notes
page 20
page 20
Recommended
page 23
Optional
page 25
Optional
page 26
Optional
page 28
page 30
Optional
page 34
page 43
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
15
Table 1
Procedure
See
Notes
page 45
page 47
page 50
Required if additional
IASs are added
page 53
page 53
page 57
16
Figure 2
Table 2
Procedure
See
Notes
BMC Impact
Solutions
Installation
Guide
Optional
2. Install Reporting for BMC Service Assurance and BMC Event and BMC Event
Impact Reporting templates.
and Impact
Reporting
Installation,
Configuration,
and User
Guide
3. Configure cells for international environments.
page 20
page 20
page 23
Optional
page 25
Optional
page 26
Optional
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
17
Table 2
Procedure
See
Notes
Required if additional
cells are created
page 28
Required if additional
cells are created
and/or Impact Portal
is used.
page 30
Optional
page 34
page 42
page 42
14. Start BMC Impact Explorer through the BMC Impact Portal.
page 43
page 45
Required if additional
cells are created
page 47
Required if additional
cells are created
page 50
Required if additional
IASs are added
page 53
page 53
page 57
18
Figure 3
Table 3
Procedure
See
Notes
BMC Impact
Solutions
Installation
Guide
2. Install Reporting for BMC Service Assurance and BMC Event and
Impact Reporting templates.
page 20
page 23
Optional
page 30
Optional
page 20
page 42
page 42
page 43
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
19
Table 3
Procedure
See
page 53
page 53
Notes
page 57
These files must be encoded before they are used by the cell. All the other files must
be encoded in the native encoding as set for the environment.
20
Obtaining user accounts for BMC Impact Explorer in the BMC Impact Administration Server (IAS)
To obtain a user account for BMC Impact Explorer in the Impact Administration
server
1 From a command line, enter the following command to request a user account in
the IAS:
iadmin -aru
loginId=UserName:password=PassWord:usergroups=UserGroupName1,
UserGroupName2, ...[:description=string]
If you define a user account in the BMC Impact Portal, you can select the
Synchronize Users with IAS function from the Superadmin->Portal tab to synchronize
the Portal users and groups with those of the BMC IAS.
Users are added to the BMC IAS with the default password user.
loginId=bhave:password=bp0wers:usergroups=Service Administrators
For information about requesting a user account in the BMC IAS, see BMC Impact
Solutions Infrastructure Administration Guide.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
21
NOTE
If you forget your password, your administrator must clear the encrypted form of your password from the configuration file. The next time that you log on, you will enter a new password, and you will be prompted to confirm it. This operation sets your new password.
In a setup where LDAP authentication is used, administrators must change password from
the LDAP server and not within BMC IX.
22
NOTE
If you define a standalone Master IAS as a failover pair, you must also define its
accompanying Impact Administration cell as a failover pair.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
23
When you define primary and secondary servers, you also define the synchronization
properties for both. The synchronization process updates IAS records and files, such
as the following files:
s
s
s
s
s
user_definitions.xml
group_roles.xml
role_permissions.xml
cmdb.properties
cell_info.list
During synchronization of failover pairs, data is carried from the primary to the
secondary IAS and from the secondary to the primary. Each server of a failover pair
has its own ias.properties and logging configuration files. These files are not
synchronized.
NOTE
To enable synchronization between servers, they must be installed on the same platform:
either all on MS Windows or all on the same UNIX operating system (for example, Solaris to
Solaris, Linux to Linux).
When you execute the iadmin command on a primary or secondary IAS, the change is
reflected on the corresponding secondary or primary IAS after the synchronization
process is complete. To synchronize the servers immediately, use the iadmin -reinit
fullsync | -sync command. See the BMC Impact Solutions Infrastructure Administration
Guide for more information about setting up IAS synchronization properties.
24
Admin mc
IAC
mc
cell
cell
Admin mc
IAC
mc
host1:1827 host2:1827
host1:1827 host2:1827
Remember that the primary Impact Administration cell resides on the same host as
the primary Master IAS and the secondary Impact Administration cell resides on the
same host as the secondary Master IAS.
After you define the entries in the mcell.dir files, you must modify the respective
mcell.conf files as you would any normal cell that you are configuring for high
availability. Refer to the BMC Impact Solutions Infrastructure Administration Guide for
more information.
WARNING
Cells with identical cell names on different computers within your enterprise will cause
unexpected results.
The cell name cannot contain spaces or special characters. You can use any
alphanumeric string and underscores (_) in a cell name, such as the following:
s
s
s
my_cell
spike12
oracle
Do not give a cell the same name as any item in the MCELL_HOME\etc directory, such
as the KB directory or the mcell.conf, mcell.dir, or mcell.trace files.
Using the mcrtcell command to add cells ensures that the cell names are unique.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
25
TIP
When naming cells, adopt a naming convention for test and production cells that clearly
identifies its purpose. For example, you could assign test cells names that use test as a prefix
or suffix. A clear naming convention is important because in BMC Impact Explorer views
there is no way to distinguish test and production cells other than by the cell name.
Description
-aa
-ae
-as
-p PortNumber
NewcellName
Specifying either the -ae or -as option creates a unified Knowledge Base, which
contains the default BEM and SIM KBs (see BMC Impact Solutions Concepts for
information about the unified KB). If you do not specify the -ae, -as, or -aa option,
you create an empty BEM cell.
For a full discussion of the mcrtcell CLI command and all its options, see the BMC
Impact Solutions Infrastructure Administration Guide.
26
Registering an additional cell with the BMC Impact Administration server (IAS)
2 Using a text editor, edit the configuration file and customize it for that cell and
save it.
You can copy and edit any configuration file located in the MCELL_HOME\etc
directory.
3 Either reload the cell configuration or stop and start the cell so that the changes
take affect.
When a cell starts, it searches for configuration files in the
MCELL_HOME\etc\cellName directory. If no configuration file is found, the cell
uses the configuration file in the MCELL_HOME\etc directory. For example, if you
copy the mcell.conf file into the MCELL_HOME\etc\cellName directory and modify
it, the cell reads that mcell.conf file and all other files in the MCELL_HOME\etc
directory. For instructions on how to stop and start a cell, see Starting or stopping
the cell on page 53.
To register an additional cell with the Impact Administration server and the
Impact Administration cell
Access the IMPACT_SOLUTIONS_HOME/server/bin directory and execute the
following command:
iadmin -ac
name=CellName:key=EncryptionKey:primaryHost=PrimaryHostName:primaryPort=
PrimaryPortNumber:failoverHost=FailoverHostName:failoverPort=FailoverPortNumber:
environment=Production|Test:usergroups=*|usergroupname1, usergroupname2...
The primary and failover port numbers should fall in the 1000-65535 range.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
27
For example:
iadmin -ac
name=sparkles_cell:key=mc:primaryHost=moondog:primaryPort=2008:
failoverHost=suncat:failoverPort=2008:environment=Production:
usergroups=*
moondog_10
mc
Admin
mc
sparkles_cell mc
moondog.bmc.com:1828
moondog.bmc.com:1827
moondog.bmc.com:2008 suncat.bmc.com:2008
In the Event view, you see that the cell you have registered sends a registration event
to the Admin cell.
The cell information is added to the cell_info.list. It is also added to the BMC Atrium
CMDB if the cell is synchronized with BMC Atrium CMDB as defined in the
cmdb.properties.
To ensure that the cell is registered with the IAS, be sure that its mcell.dir file contains
the IAC entry, as in the following example:
cell
IAC
mc
myComputer.adprod.bmc.com:1827
The IAC entry enables event propagation between the cell and the Admin cell that is
part of IAS.
28
WARNING
You must maintain each cells mcell.dir file to ensure event propagation between cells and the
ability to connect to the BMC Impact Portal. Ensure that each directory entry is correct and
that every cell has an up-to-date directory file. An error in the mcell.dir file prevents cells
from connecting to each other and to other components, such as the BMC Impact Portal.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
29
Description
Name
Name is an abstract name for the cell or gateway.portal. These names are not case-sensitive
and may be any alphanumeric string, including underscores (_).
A Portal name is, by convention, the fully qualified host name of the Portal host, prefixed
with bip.
String to be used as part of the key for the encryption of the communication between a cell
and the cell or other component. Default value is 0 (zero).
EncryptionKey
Note: If the string has an odd number of characters, the last character is ignored.
IPAddress/Port
Host name or IP address and port number on which the cell or component is listening.
Default port number for a cell is 1828 and for a Portal is 3783.
5 If you are configuring cells to communicate with other cells, repeat the procedure
to add the original cells information to the new cells mcell.dir file.
30
However, if you want to set up a failover pair on different machines, but did not
select the Primary and Secondary Cell Server options during installation, you must
use the mcrtcell command to create an identical cell on each computer. For example,
if you ran the installation on host1 and installed a primary cell server on that
computer, you must create an additional, identical cell on host2 using the mcrtcell
command.
The highest possible availability for a cell occurs when two server machines are close
to each other with a highly reliable network connection. When the two server
machines are on remote sites, the high availability cell functions more like a Disaster
Recovery system.
WARNING
The primary and secondary servers of a high availability pair must run on two different
logical OS images of the same type. Primary and secondary servers of a high availability pair
running on the same system or running on different operating systems is not supported.
WARNING
Although it is technically possible to activate both servers, this is not supported. If both
servers are activated, incompatible server states can occur. If the server states are
incompatible, manual intervention is required to resynchronize the primary and secondary
servers. If this situation occurs, see the BMC Impact Solutions Infrastructure Administration
Guide.
It is highly recommended that you disable automatic failover and enable manual failover
when the connection between the primary and secondary server is unreliable. Otherwise,
there is a risk that both primary and secondary servers would be active at the same time when
they cannot communicate with each other. This situation is not supported. If this situation
occurs, see BMC Impact Solutions Infrastructure Administration Guide.
To get the same behavior for the primary and for the secondary cell servers, both
should be installed and configured similarly. It is highly recommended that the
Knowledge Bases for both servers are identical. Configuration parameters also
should be set to the same values for both servers, except for the CellDuplicateMode
parameter that indicates whether the server is a primary or a secondary server.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
31
To configure a high availability cell, you must complete the following tasks:
1. Specify the primary and secondary server locations for the cell. For instructions,
see To specify the primary and secondary server locations for the cell on page 32.
2. Configure high availability options. For instructions, see To configure high
availability options on page 32.
3. Configure the primary server. For instructions, see To configure the primary
server on page 33.
4. Configure the secondary server. For instructions, see To configure the secondary
server on page 33.
To specify the primary and secondary server locations for the cell
1 On both servers, open the mcell.dir file in a text editor.
cell
CellName
emaNlleC
mc
with:
host1:port1
host2:port2
CellName is the name of the cell created on both servers. host1:port1 is the host
name and port number of the primary server, and host2:port2 is the host name
32
NOTE
Failover and switchback can be configured independently. It is not required to
configure both as manual or both as automatic. For example, you could configure
high availability so that failover is manual, but switchback is automatic.
3 If you have opted for automatic failover, failover timeout values can also be
configured. For more information, see the BMC Impact Solutions Infrastructure
Administration Guide.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
33
NOTE
This documentation only discusses the BMC Impact Event Adapters, which are included with
BMC Impact Solutions. If you are using an integration product, see the documentation for that
integration product for configuration and usage instructions.
5 Under Java (Sun), select Use JRE 1.6.x_xx for <applet> (requires restart).
NOTE
If Java (Sun) is not visible, the Java plug-in is not installed on the computer. In that case, install
the Java SE Development Kit (JDK) 6 from http://java.sun.com/javase/6/.
34
WARNING
You have to restart the Tomcat server each time you modify a configuration file related to the
SNMP Adapter Configuration Manager. Until you restart the Tomcat server, the changes
made to the configuration files are not reflected in the SNMP Adapter Configuration
Manager.
2 In the startup.bat file that is located in the Catalina_Home\bin directory, set the
JAVA_HOME variable by adding the following line at the beginning of the file:
SET JAVA_HOME=JDK_Home
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
35
B Ensure that the following java.security.policy system property has been set:.
-Djava.security.policy="%SECURITY_POLICY_FILE%"
EXAMPLE
%_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS%
-Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%"
-Djava.util.logging.config.file=%LOG_PROPERTIES%
-DMCELL_HOME="C:\\Program Files\\BMC Software\\MasterCell\\server\\"
-classpath "%CLASSPATH%"
-Djava.security.manager
-Djava.security.policy="%SECURITY_POLICY_FILE%"
-Dcatalina.base="%CATALINA_BASE%"
-Dcatalina.home="%CATALINA_HOME%"
-Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS%
%ACTION%
6 In the server.xml file that is located in the Catalina_Home\conf directory, specify the
Connector port and the Server port.
Ensure that the ports you have specified are not being used by any other
application.
36
EXAMPLE
<Server port="8005" shutdown="SHUTDOWN" debug="0">
<Connector port="8080"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
debug="0" connectionTimeout="20000" maxPostSize="0"
disableUploadTimeout="true" />
7 In the server.xml file that is located in the Catalina_Home\conf directory, set the
value of maxPostSize to 0.
EXAMPLE
<Connector port="8080"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
debug="0" connectionTimeout="20000" maxPostSize="0"
disableUploadTimeout="true" />
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
37
Windows: MCELL_HOME\etc\
UNIX: MCELL_HOME/etc/
2 In the mcxa.conf file, navigate to the definition of the Adapter instance that you
want to enable.
3 Remove or comment out the word DISABLE from the Adapter definition.
4 Repeat step 3 for each Adapter instance that you want to enable.
5 Save and close the file.
Adapter statuses will change within a minute or two.
Windows: MCELL_HOME\etc\
UNIX: MCELL_HOME/etc/
2 In the mcxa.conf file, navigate to the definition of the Adapter instance that you
want to disable.
3 Add the word DISABLE to the Adapter definition or if DISABLE was commented
out, remove the comment character (# ).
38
The Adapters that use the engine manager (LogFile Adapter, SNMP Adapter, and
Perl Eventlog Adapter for Windows) can be started as follows:
On Microsoft Windows computers, you start the engine manager (mxca
process) from the command line or from the Services window.
On UNIX computers, you start the engine manager (mxca) process from the
command line.
For instructions, see Starting the engine manager process from the command
line and Starting the Adapter processes as services on page 41.
The IP Adapters (on Windows and UNIX) can be started and stopped individually
after the primary engine manager process is running. For more information, see
the BMC Impact Solutions Event Adapter User Guide. When running on Microsoft
Windows computers, all Adapters that use the engine manager can be started from
the command line or from the Services window.
Option Description
-c
-d
-h
help
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
39
Table 5
Option Description
-n
-t
Use a single colon (:) in the command to send output to the default trace file,
MCELL_HOME\tmp\Adapters\mcxa.trace.
Example:
mcxa.cmd -t:6
s
s
Use a double colon (::) in the command to display output on-screen (stdout).
Use a single colon (:) in the command to send output to the specified trace file.
Example:
mcxa.cmd -t \tmp\mytracefile.txt:6
will start the engine manager at trace level 6 and use tmp\mytracefile.txt trace
file.
-z
40
NOTE
Command line interface options take priority over options in the mcxa.conf file.
On Windows, stop the BMC Impact Event Adapters service from the Services
window.
This method sends an MC_ADAPTER_STOP event before the Adapters stop.
On UNIX, stop the Adapters by using either the kill command or a shell script,
such as the mcxa script located in etc/init.d.
This method sends an MC_ADAPTER_STOP event before the Adapters stop.
NOTE
Do not use the kill -9 command to stop the Adapters unless they are in an infinite loop. Use
the regular kill command, instead.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
41
If you used the -c option with the mcxa.sh command or mcxa.cmd command to
specify a configuration file other than mcxa.conf, the stop file must have the same
primary name as that configuration file, using the .stop extension. For example, if
your Adapters configuration file is adap.conf, name the stop file adap.stop.
NOTE
If you stop and start the BMC Impact Event Adapters service in quick succession, or use the
restart option in the service manager, you might see the following error messages in the BMC
IX console:
Couldn't be an UDP server on port 16
MA: EngineMgr: Couldnt be an UDP server on port 162
If you see these messages, wait a short time until the expected stop messages appear before
restarting the Adapters. For example, with an SNMP Adapter enabled, wait until the
messages BMC Impact Event Adapter stopped and Adapter Snmp (Engine:
MA:ESnmpTrap) stopped by mcxa appear before restarting the BMC Impact Event
Adapters service.
42
Starting BMC IX
For BMC IM to recognize the Portal installation, you must restart the cell and then reregister cells with the Portal using the administration page of the BMC Impact Portal.
In the following situations, you must manually add the bip.hostName entry to the
cells mcell.dir file to subscribe the BMC IM to the BMC Impact Portal, restart the cell,
and register the cells with the BMC Impact Portal:
s
s
s
For instructions on registering cells in the BMC Impact Portal, see the BMC Portal
Getting Started.
Starting BMC IX
Before you can use BMC IX to view and manage events and/or services, you must
access it in one of the following ways:
s
User authentication and security are managed centrally by the BMC Impact
Administration server. To launch BMC Impact Explorer you must connect to the
BMC Impact Administration server. The BMC Impact Manager cells to which you
will connect are configured in the BMC Impact Administration server by the system
administrator.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
43
Starting BMC IX
the name of the production or test cell where the events and/or services are
defined
the host name and port number for each IAS to which you will connect
NOTE
BMC Software recommends that you have only one BMC Portal account for BMC IX and that
all BMC IX users are members of that account.
The BMC Impact Explorer splash screen is displayed, and then the Logon dialog
box is displayed.
NOTE
If the BMC IAS that you select from the Servers list is down and that BMC IAS is
configured for failover capability, BMC IX automatically logs you on to the secondary
server configured for this BMC IAS.
5 Click OK to close the Logon dialog box and start BMC IX.
44
Property
Description
Name
displays the name of the cell whose properties you are changing
Primary Host
displays the name of the primary host computer where the cell is installed
Port
displays the port number the cell uses to connect to the primary host computer
Secondary Host
displays the name of the secondary host computer if one has been installed and
configured to provide failover capabilities for the primary host
Port
displays the port number the cell uses to connect to the secondary host computer
Timeout
specifies the length of time the console waits to receive data from the cell; default is 30
seconds
BMC IX saves any negative Timeout values that you type as positive values.
Refresh Freq
sets the time interval between polls of the cell; default is 60 seconds
BMC IX saves any negative Refresh Freq values that you type as positive values.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
45
Table 6
Property
Description
Attempts
sets the number of times the console attempts to connect to a cell; default is 10
BMC IX saves any negative Attempts values that you type as positive values.
Connect Freq
Encrypted Mode enables and disables encryption of data between the console and the cell; default is
enabled (selected)
Auto Connect
enables and disables automatic connection to the cell at logon; default is disabled (cleared)
Auto Switch
enables and disables automatic and continuous switching of the connection from the
backup cell to the primary cell after failover, using the value set in Connect Freq as the
interval; default is disabled
enables and disables using a specified range of local ports (on the console) for establishing
a connection between the console and a cell.
Designating a port range is useful if the console must communicate to a cell through a
firewall with only specific ports available for communication. The console scans through
the specified port range until a port is connected to the cell or the connection fails because
the port range is exhausted.
s
For using port range, once you select the Use Port Range check box, BMC IX
automatically changes the Min Port No. and Max Port No. values to 1.
If you type a value of zero in Min Port No., BMC IX clears the Use Port Range check
box.
If you type a value of zero in Max Port No., BMC IX replaces it with the value of Min
Port No.
If the value of Max Port No. is less than the value of Min Port No., BMC IX changes
the value of Max Port No. to that of Min Port No.
Auto Bind
enables and disables the automatic connection attempt of the console to the first network
card it encounters. Clear this option to bind to a specific IP address.
If only one network card exists, ensure that Auto Bind is selected. See Specifying ports in
cell connection properties on page 47 for additional information.
IP Address
46
specifies the IP address assigned to the local network card to which the console connects;
available only if Auto Bind is cleared
the presence of a network interface card (NIC) between the console and the cell
the presence of a firewall between the console and the cell
using a multi-homed computer for the console
In these circumstances, you must select Use Port Range and specify the limits of the
port range and then select either Auto Bind or a particular IP address.
The Auto Bind option configures the console to connect to an NIC before it can
connect to a cell. If you specify no particular NIC, the console automatically attempts
to connect to the first NIC it encounters.
On a multi-homed computer, you can specify the NIC by selecting the IP address that
the card is using from the IP Address drop-down list box. If Auto Bind is not enabled,
you must specify a port range for the network card to which the console binds.
NOTE
If the console is running on a computer that is acting as a gateway between multiple subnets,
the network card that you bind to must be on the same subnet as the cell to which the console
connects.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
47
Connecting and disconnecting a cell or group of cells from BMC Impact Explorer
Figure 4
NOTE
If you enable the Manager Group Status option on the Global tab of the Edit Configuration
dialog box, the cell group icon will indicate that at least one cell is disconnected by showing a
red X on its lower left portion, which makes the icon look the same as if the entire cell group is
disconnected (as shown in the Infrastructure Management group in Figure 4).
A cell may appear to be disconnected from the console for many reasons, including
the following:
s
s
s
s
s
You may want to disconnect a cell if you no longer want to receive data from that cell.
48
Connecting and disconnecting a cell or group of cells from BMC Impact Explorer
view is reflected in the Events and Services views and the result of your action in
the Events view is reflected in the Administration and Services views.
The red X disappears from the cell icon when you connect to the cell.
NOTE
If Auto Connect is enabled for a cell, the next time you start the console a connection to the
cell is automatically reestablished. For additional information about Auto Connect, see Configuring cell connection properties to BMC Impact Explorer on page 45.
NOTE
If you enable the Manager Group Status option on the Global tab of the Edit Configuration
dialog box, the icon for the disconnected cell group will look the same as the icon for a cell
group in which only some of the cells are disconnected.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
49
50
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
51
4 Modify any of the BMC IAS configuration parameters listed in Table 7, as needed:
Table 7
Field
Description
Heartbeat Rate
Enable Port Range specifies the maximum and minimum port number for the console to
use in establishing a connection to a BMC IAS
Designating a port range is useful if the console must communicate to a
cell through a firewall with only specific ports available for communication. The console scans through the ports in the specified range until
a port, local to the console, is connected to the cell or fails because the
port range is exhausted.
Auto Reconnect
5 Click Apply to save the changes, or click OK to save and exit the dialog box.
To reorder the BMC Impact Administration server list
1 From the menu bar, choose Edit => Configuration.
The Edit Configuration dialog box appears.
52
3 To refresh the information in the Metrics tab of this dialog box, click Refresh in the
top right corner of the tab.
External actions run as the user ID that started the process. Those actions are
defined in %MCELL_HOME%\etc\CellName\kb\bin on Windows platforms and in
$MCELL_HOME/etc/CellName/kb/bin on UNIX platforms.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
53
Actions are defined in .mrl files located in the kb/bin directory and listed in .load in
that directory. The action programs or scripts can be located in the kb/bin/A or
kb/bin/Arch directory. They can also be located anywhere else on the system.
s
The user who starts the cell must be able to write to log and trace files in the
directories specified through configuration parameters SystemLogDirName and
SystemTmpDirName. Default values for these are the log and tmp subdirectories of
MCELL_HOME.
It is possible to start a cell without specifying a cell name. If you start a cell without
any options, the command attempts to start a cell with the same name as the host.
You must set the MCELL_HOME environment variable to point to the directory in
which the cell is installed. The home directory also can be indicated using the option
-l followed by the path to the home, instead of defining it in the environment. To
learn more about using the mcell command, see the BMC Impact Solutions
Infrastructure Administration Guide.
NOTE
You can change all configurable cell parameters by making changes in the configuration file,
mcell.conf. When you start the cell, the cell looks for the configuration file in the default
location, MCELL_HOME\etc\cellName\mcell.conf. Use the -c option with the mcell
command to have the cell look for the configuration file in a specified location.
54
Windows Services
the net stop command
the mkill command
On Windows computers, you can start a cell by using one of the following options:
s
s
Windows Services
the net start command from a command prompt window
2 Select mcell_cellName.
3 Click Stop Service.
To stop a cell on Windows platforms by using the net stop command
1 Select Start => Programs => Command Prompt.
2 Enter net stop mcell_cellName.
To stop a cell on Windows platforms by using the mkill command
1 Select Start => Programs => Command Prompt.
2 Enter mkill -n cellName.
NOTE
If you do not use the -n option when stopping a cell, the default cell, named hostName, is
stopped.
2 Select mcell_cellName.
3 Click Start Services.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
55
NOTE
When used without the -d option, mcell contacts the Service Control Manager to start itself as
a service. It uses mcell_%N as a service name. %N is the cell name as specified by the -n option.
Without the -n option, the default cell name is the hostname.
WARNING
s
If the primary server is started and terminates before the secondary server is started, the
state of primary and secondary servers may become unsynchronized. If this occurs, you
must manually synchronize the servers before restarting either of them.
Do not start a high availability cell using any of the mcell -i initialization options (for
example, -ia, -id or other variants). This could cause the primary and secondary servers
to become unsynchronized.
If the servers become unsynchronized for either of these reasons, see the BMC Impact Solutions
Infrastructure Administration Guide for instructions on how to manually synchronize the
servers.
56
5 Click OK.
The new cell group is displayed in the navigation pane.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
57
58
Available Impact Managers lists all BMC Impact Managers (cells) to which you are
3 From Available Impact Managers, select the cell that you want to add to the console.
4 From Selected Impact Managers, select the group to which you want to add the cell.
TIP
You can select multiple cells at one time, as follows:
s
To select adjacent cells, select the first cell, hold down the Shift key, and select the last
cell.
To select nonadjacent cells, select a cell, hold down the Ctrl key, and select each of the
other cells.
5 Click the right arrow to move the selected Impact Manager to the selected Impact
Manager group.
TIP
You can also select a cell from Available Impact Managers and drag it to the appropriate
cell group in Selected Impact Managers.
6 Click OK.
The cell that you added is displayed in its cell group in the navigation pane.
Chapter 1 Configure and start using the BMC Impact Solutions infrastructure
59
60
Chapter
Chapter 2
62
65
66
68
69
70
70
71
72
72
73
74
75
77
61
1
2
4
5
6
Table 8
Name
Description
Information Display
Selection tabs
provide access to the available categories of event information such as cells, cell
groups, collectors, MetaCollectors, and event groups
62
Table 8
Name
Description
navigation pane
provides access to the default filters, which provide variations of the event list:
s
limit the event list to active, new, closed, or blackout events in the following
categories:
Basic Information: displays the default slots of the class EVENT
Supervisor Information: displays the same slots as Basic Information,
except that action count is replaced by current owner
SMC Information: displays information from the collector
MC_SMC_EVENT that collects all events in which the mc_smc_id slot
contains information
For more information, see the BMC Impact Solutions Event Management Guide.
5
Slots
columns that display the status, priority, severity, action count (Occurrences),
event relation, receipt date (Occurred), and message for events
event list
displays the contents of a cell or collector as a list of events with slot information
and filters.
Each line of the list represents one event.
details pane
Using the navigation pane on the Events tab, you can view cells, cell groups,
collectors, and MetaCollectors in a hierarchical tree, as shown in Figure 7 on page 64
and described in Table 9 on page 64.
Chapter 2
63
Figure 7
3
2
5
6
7
8
10
Table 9
Name
Icon
Description
View Selection
tabs
none
Collectors
subtab
displays the cells, cell groups, and collectors available for viewing
MetaCollectors
subtab
Event Groups
subtab
cell icon
identifies a cell
hierarchy
indicator
64
Table 9
Name
Icon
Description
collector icon
identifies a collector
severity level
indicator
identifies by color the highest severity level of the events contained in the
collector (for the configured statuses).
For more information about the severity levels for events, see Table 14 on
page 69.
For more information, see the BMC Impact Solutions Event Management Guide.
10 event count
none
displays the number of events contained in the collector and the number of
events that you selected to count.
For more information, see the BMC Impact Solutions Event Management Guide.
The event list displays selected event details, including operational status. Each row
in the table shows information for one event. The columns are determined by the type
of information that you select in Event Sources and the slots (event attributes) selected
for display. For example, if you select All Events and Basic Information from the Event
Sources list, the default event list displays the following columns:
s
s
s
s
s
s
s
status
priority
severity
action count (number of remote actions applied to the event)
event relations
receipt date of the event
message associated with the event
Chapter 2
65
The set of slots (columns) presented in the event list is called the slot order. Depending
on your role and access privileges, you can select different slots to see other event
information (and therefore other columns in the event list). When you change the
slots presented, either by adding or removing slots or by rearranging them, you are
changing the slot order. To use a new slot order, you must associate it with a filter.
For instructions, see the BMC Impact Solutions Event Management Guide.
You can click a column heading in the event list to switch between ascending and
descending sort order according to that column. For example, you could display the
events sorted by date, either earliest to latest (ascending order) or newest to oldest
(descending order). You could also display the events sorted by their messages,
which would display them in alphabetical order (ascending order) or reverse
alphabetical order (descending order).
If the event has related events, one of the icons shown in Table 10 on page 66 is
displayed in the event relations column.
Table 10
Icon
You can also customize the display of the event list, as described in the BMC Impact
Solutions Event Management Guide.
severity, reflected in the severity icon and color of the event line
priority, reflected in the priority icon
the last event operation performed on the event, reflected in the status icon
When you perform an event operation on an event, the state of the event changes
according to Table 11.
66
Table 11
Resulting state
Acknowledge Event
Acknowledged
Take Ownership
Assigned
Decline Ownership
Acknowledged
Assign To
Assigned
Close Event
Closed
Reopen Event
Open
Black Out
Blacked Out
Figure 8 on page 67 shows how an event in any state is affected by the operations that
are valid for that current state. The circles represent the event states. Each arrow
represents an action, with the direction of the arrow indicating the flow of the action.
For example, if the event is currently in the Acknowledged Event state, you can
perform a Reopen Event, Close Event, Take Ownership, or Assign To action.
Conversely, for that event to be in the Acknowledged Event state, an Acknowledge
Event or Decline Ownership action must have been taken against it.
Figure 8
A user with a supervisory role (Full Access is the only default supervisory role) can
select Supervisor Information from the secondary menu of the Event Sources list to see
current operator information based on the last event operation applied. This
information is displayed in the mc_owner column in the event list, according to
Table 12.
Chapter 2
67
Table 12
Assign To
Decline Ownership
none
Close
none
Acknowledge
none
Reopen
Set Priority
Other factors can also affect the information displayed, such as whether an event has
been propagated, abstracted, correlated, or recycled.
The color of the status icon is always the same. However, if you have configured the
Events View to use the severity color for the event line, the color of the icons
background varies with the severity of the event.
68
If you selected Line Color Severity in the configuration, the line shows the color
associated with the severity level of the event.
For events that have no severity (statuses Closed and Blackout have no severity
level associated with them), the line has no color (is displayed as white).
If you did not select Line Color Severity, the line has no color (is displayed as
white).
Table 14 lists the default severity levels and colors for the events that appear in the
navigation pane and event list and shows the icons used in the event list.
Table 14
Color
Severity level
red
CRITICAL
dark orange
MAJOR
light orange
MINOR
yellow
WARNING
blue
INFO
green
OK
gray
UNKNOWN
The event with the highest severity level in an event group on the Event Group tab
determines the severity indicator that you see for the event group in the navigation
tree. For example, if one event has a severity of Critical, the event group is displayed
in the navigation tree with a Critical (red) severity indicator.
Chapter 2
69
70
2 Expand the hierarchy to locate the MetaCollector whose events you want to
display.
2 Expand the hierarchy to locate the event group whose events you want to display.
3 Click the event group.
For more information about filtering, see BMC Impact Solutions Event Management
Guide.
Chapter 2
71
NOTE
If you move the cursor over an event relations icon, a summary of the number of related
events by category is displayed briefly.
72
Chapter 2
is active.
73
If Auto Refresh is not enabled and active when an event is modified externally from
the console, the event is not updated until you manually refresh the event list.
NOTE
If the cell is extremely busy, the event list may not be refreshed until the cell completes the
current event processing load.
The auto refresh activity stops. The list updates only when you click Auto Refresh
or Refresh
again.
Policy type
Policy name
Description
Enabled?
Closure
PATROL_Portal_Closure
Yes
Adapter_Start_Stop_Closure
Yes
Client_Stop_Closes_Start
Yes
Sample_Component_Based_
Enrichment_Policy
No
Component Based
Enrichment
74
Table 16
Policy type
Policy name
Description
Dynamic Blackout
Dynamic_Blackout
Enabled?
Service_Contact_Enrichment
No
No
No
PATROL_Message_Translation replaces the text of existing PATROL
event messages with messages that can
be more easily understood by operators
in your enterprise.
Intelligent Incident
Service
Sample_Intelligent_Incident_
Service_Policy
No
Notification
BASIC_EMAIL
Propagation
Recurrence
Apache_Login_Failed_Repeats
Patrol_Portal_DeDup_Policy
Yes
Suppression
Blackout_Suppression
No
Timeout
PATROL_Portal_Timeout
Yes
For instructions on using these out-of-the-box policies, see the BMC Impact Solutions
Event Management Guide.
Chapter 2
75
2 Under the By Policy Type folder, select the policy type for the out-of-the-box
standard event policy that you want to enable.
Out-of-the-box standard event policies are included under the following policy
types:
s
s
s
s
Closure Policy
Recurrence Policy
Suppression Policy
Timeout Policy
A list of out-of-the-box standard event management policies of that policy type are
displayed in the right pane of the Administration view as shown in Figure 10.
Figure 10
3 From the list of event management policies, select the policy that you want to
enable.
The Details tab for that policy is displayed in the details pane of the Administration
view.
4 On the BMC Impact Manager toolbar, click the Update Policy button
to enable
5 Enable or disable the policy by selecting or deselecting the Enabled check box.
6 Click OK.
BMC Impact Explorer saves the defined event management policy, and it is
displayed in the list of event policies for the selected event selector.
76
Chapter 2
77
78
Chapter
Chapter 3
80
80
81
81
83
85
86
87
90
91
91
92
92
94
79
3 On the Configure tab, in the navigation pane on left side, under Tasks, click BMC
Impact Service Model Editor.
80
2 In the Create Component dialog box, on the General tab, scroll in the Component
Type pane and select the appropriate component type for the instance that you are
creating.
NOTE
The service component types are listed in hierarchical order, not in alphabetical order.
Chapter 3
81
B In the Cell box, accept the default, unassigned, or select the cell that will receive
events for the component instance.
BMC Impact Service Model Editor retrieves the list of cell names from the BMC
Atrium CMDB. If the cell that you need is not listed, see the BMC Portal Getting
Started guide for information about adding a cell.
NOTE
When you open BMC Impact Service Model Editor, a new sandbox View opens
automatically if you have no saved Views. You can also open a new sandbox View at any
time by clicking
on the toolbar.
If you have saved Views, you can open the appropriate View from the Views panel.
2 Drag the component type from the Templates window to the View-Sandbox
window.
When placing objects in the sandbox View window, place consumer instances
above provider instances for a hierarchical layout.
3 In the View-Sandbox window, right-click the new component icon and select Edit
Component Properties.
On the General tab, in the Component Type pane, the component type you chose is
selected by default.
If you chose the wrong component type, click Cancel and start again with step 2.
82
B In the Cell box, accept the default, unassigned, or select the cell that will receive
events for the component instance.
BMC Impact Service Model Editor retrieves the list of cell names from the BMC
Atrium CMDB. If the cell that you need is not listed, see the BMC Portal Getting
Started guide for information about adding a cell.
WARNING
s
BMC Impact Service Model Editor verifies that the cell name chosen is present in the
BMC Impact Portal, but if the component instance is created outside of BMC Impact
Service Model Editor or if the cell is deleted from BMC Impact Portal after it has been
created but before it is published, data integrity errors may result.
5 If desired, specify other, optional, component properties in the General, Status and
Alias, Permissions, Schedule, and Other tabs.
For instructions on defining these component properties, see the BMC Impact
Solutions Service Modeling and Publishing Guide.
Chapter 3
83
NOTE
To display a list of all component instances, leave the Component Name box blank and
click Find.
You can enter a partial name by using the % sign as a wildcard before the partial name,
after it, or both (for example, %Sales%, Sales%, or %Sales).
3 (optional) Save the search statement by clicking Add to Saved Finds and reuse it by
clicking Open Saved Finds.
4 (optional) In the Look in area, accept the default, Sandbox and Production, or filter
the list of component instances in the results pane by choosing Production Only or
Test Only.
5 (optional) To define the attributes that are displayed in the results table and their
order, right-click in any column heading and select Configure table columns.
The attributes shown in the Available Attributes pane are
s
s
In the Configure Find Results dialog box, select the appropriate attributes.
s
To change the order of the columns in the final results display, use the up and
down arrow buttons.
To move the attributes that you want to display into the Attributes to Show pane,
use the left and right arrow buttons.
84
The default sort order is by component name, if component name is one of the
columns you choose to display. If component name is not chosen for display, the
default sort order is creation date and time.
To sort the values in any column, click the column heading. To change the order of
the columns from left to right, drag the column headings.
For each user, the last-used settings are saved and reapplied at the next logon
session.
8 (optional) In the results pane, select one of the instances and take any of the
following actions:
s
s
9 (optional) To start another search, click Reset to clear all the selection criteria
options on the Find tab to the default values (blank component name field, All
Components, no results in table).
For instructions on using the Advanced and Conditional Find capabilities, see the
BMC Impact Solutions Service Modeling and Publishing Guide.
Chapter 3
85
The General tab of the Edit Component Properties dialog box displays the
corresponding component type in the component type hierarchy. The component
instance name is displayed in the Component Name box.
If you chose more than one component instance, the Edit Multiple Component
Properties dialog box is displayed.
2 In the Edit Component Properties dialog box (or Edit Multiple Component
Properties dialog box), in the Cell box, select the cell to which you want to publish
the components.
3 To assign other related components to a different cell, select them in the View
window, and repeat steps 1 and 2.
After you have created relationships, test them to verify that they function in the way
that you intended.
86
2 Draw a relationship line from provider to consumer by clicking at the top of the
provider component and moving to the bottom of the consumer component, and
then click again.
TIP
To delete a graphic line that you have started and do not want to complete, press Esc.
drew.
For more information and other methods to create relationships, see the BMC Impact
Solutions Service Modeling and Publishing Guide.
WARNING
s
Only one promotion can be processed at a time. If you submit a promotion while a
previous promotion is being processed, the second promotion will not start until the
second one is complete.
Event class definitions must be the same in all SIM cells. If you add custom event classes,
you must manually modify the KB of each cell, recompile the KB, and then restart each
cell.
Chapter 3
87
3 In the Edit Event Alias Associations dialog box (show in Figure 13), in the Name
box, enter a name for the event association.
Figure 13
4 In the Event Match Criteria area, from the Event Class drop list, select an event class.
BMC Impact Service Model Editor looks at the first available cell and uses its event
classes in the list.
When an event comes in, its event class has to match the event class or a subclass of
the event class before the alias formula is even considered.
88
5 (optional) In the Match Attributes box, choose attributes and enter values to refine
which events (within the event class) will generate aliases. For details, see the BMC
Impact Solutions Service Modeling and Publishing Guide.
6 In the Alias Formula area, use the Attribute, Text, and Function buttons in any order
and as many times as needed to build the formula:
A To insert an attribute in the formula, click the Attribute button. The attributes
shown are those that belong to the event class you selected in the Event
Definition area.
When an attribute is selected, the control shows the attribute name, and the
preview area is updated to show the syntax of the formula as it currently exists.
TIP
If your formula for a component instance (CI) contains the mc_host slot with a host name
value, then the mc_host slot of the matching event definition should also contain the host
name value, not the IP address, of the CI. For example, if you assign the mc_host slot in
your formula the value mycomputer.abc.com, then the mc_host slot of the incoming event
should contain mycomputer.abc.com, not the IP address.
Ask your system administrator for the correct Domain Name System (DNS) resolution if
the object represented by the component instance experiences host name resolution errors.
B To insert literal text (for example, a period, semi-colon, the word Oracle), click
on the Text button. In the text box, type the literal text that you want in the alias
formula.
Literal text appears in the first part of the alias formula with data type
definitions.
C To insert a function that defines the data type and an expression in the formula,
click on the Function button. Type the function and choose the data type.
For a list of functions you can use, see BMC Impact Solutions: Knowledge Base
Development.
Chapter 3
89
Schedule information is stored in the BMC Atrium CMDB and can be viewed in BMC
Impact Portal and BMC IX. If a schedule is not selected for a component, the
component will have a default schedule of 24 x 7 x 365 (always in schedule).
After service schedules are created, you can assign components to schedules.
Full Access, Service Administrators, and Service Managers user groups have access to
the schedule editor.
4 Click OK.
90
Note that a successful promotion does not guarantee that the automated publication
will also be successful. For more details about automated publishing, see the BMC
Impact Solutions Service Modeling and Publishing Guide.
During the publishing of a service model, new or modified service model
components and their relationships are selected from the BMC.ASSET dataset in the
BMC Atrium CMDB and copied to respective BMC Impact Manager cells. The objects
in BMC.ASSET are compared to any previously published instance in
BMC.IMPACT.PROD and the changes between them are sent to the cell.
BMC.IMPACT.PROD is then updated with the changes.
After events that affect service component instances are received by the cell, you can
monitor status changes using BMC Impact Explorer or BMC Portal for the published
component instances.
Chapter 3
91
all target cells that are registered in the BMC Impact Portal are running and have a
live connection with the BMC Impact Publishing Server
the BMC Impact Publishing Server is running in automated mode by using the CLI
command psstat. This command should return Started - Automated mode.
your user account belongs to one of these user groups: Service Administrator,
Service Manager, or Service Manager - Senior (these are the default user group
assignments; you may change them)
the SIM class definitions are in sync. The BMC Impact Publishing Server validates
the class definitions and establishes a live connection with BMC Impact Portal, the
BMC Atrium CMDB, and the cells before submitting the publication.
Submitting a promotion
When you submit a promotion, the Promotion Preview dialog box offers the
opportunity to compare your unpromoted sandbox service model component
instances and relationships with those that have already been promoted so that you
can verify the work done in the current editing session. When you click Begin
Promotion, service model objects (component instances, impact relationships, and
management data) shown in the preview are promoted (and subsequently
automatically published).
Submitting a promotion
The component instances and relationships to be promoted are listed in the left
pane.
Column heading
Icon
Action
Description
object was deleted
object was added
object was modified
Type
component
relationship
timeframe or service schedule
4 In the Comparison of Sandbox and Promoted Property Values area, for the Show
options, select Changed Properties or All Properties for the component instances you
selected in the Objects to be Promoted pane.
5 Select one or more objects in the left pane and, in the right pane, compare the new
and previously published property values to verify that the new data is correct
before you publish it.
7 (optional) To stop the promotion, in the Promotion in Progress dialog box, click
Stop.
Chapter 3
93
Closing the dialog box does not stop the promotion; the promotion continues in
the background.
8 (optional) To exit BMC Impact Service Model Editor, click Exit SME, then click the
appropriate selection on the confirmation dialog box.
94
Chapter
95
NOTE
The BMC Software product must be registered in the BMC Atrium CMDB. The class
BMC_FederatedProduct in the BMC.CORE.CONFIG namespace holds the unique registry
value for products.
see the Service View impact graph for the service model components.
96
see whether a service model component consumes the services of another service
model component (consumer) or whether it provides service to another
component (provider). The status of the provider component impacts the status of
the consumer component via the service relationship.
to monitor business services and determine the root cause of a problem or the
impact that a service model component has on a business service.
Figure 14
Table 18 describes the elements in the Services View, Figure 14 on page 97.
Table 18
No. Name
Description
menu bar
navigation pane
Find Service
Components box
enables you to search for specific components that you want to display in
the Impact/Cause view
Impact/Cause view
shows the service component instances and the provider and consumer
impact relationships between them
97
Table 18
No. Name
Description
Orientation toggle
10
11
selects and displays in the Impact/Cause View only the components of the
selected status and above
12
13
service component
information tabs
14
98
Figure 15
Setting
Selections
Description
Priority Icon for Component Select this check box to show the priority icon.
SLAs - Status of Worst
Targeted SLA
99
Figure 16
Setting
Selections
Description
Horizontal
Vertical
Name
Short Description
6 Click Apply to save the changes, or click OK to save and exit the dialog box.
Figure 14 on page 97 and Table 18 on page 97 identify and describe the main areas of
the Services view.
100
Consumer component
Provider components
Chapter 4
101
From the navigation pane, select a service component instance. See Viewing
service component instances through the navigation pane on page 102.
Click and drag the service component instance from the Results list to an empty
area of the Impact/Cause View. See Finding service component instances to
view on page 104.
Right-click a service component instance and choose View Service Impact Graph.
NOTE
If the navigation pane tree does not reflect published changes, log out and log back in to BMC
Impact Explorer.
The navigation pane tree contains service component instances associated with a
production cell. To view service component instances associated with a test cell, use
the Find tool. For instructions, see Finding service component instances to view on
page 104.
102
Name
Description
My Services group
subgroup icons
Business group
the top-level node for the navigation tree defined by the service manager in the
BMC Impact Service Model Editor (not pictured)
Chapter 4
103
Table 21
Name
Description
Find Service
Components box
specifies the BMC Impact Manager cell to the search for components
Propagates Priority check select this check box to show the Priority Propagator service component instances
box
that pass their priority to a causal component when it is impacted
These components are considered the important components for your business.
For further information, see the BMC Impact Solutions Service Impact Management
Guide.
In SLM Agreement check select to show the service components that are associated with a Service Level
box
Agreement
Note: This feature requires the BMC Service Level Management product to be
installed.
Results list
for all types are returned. For a list of component types, see the BMC Impact
Solutions Service Impact Management Guide.
104
5 To find only those components that propagate their priority to causal components,
select Priority Propagators.
6 Click Find.
All components matching the search criteria appear in Results.
Tab
Purpose
General
shows the value of slots that contain basic information about a service component
Status
shows the value of slots that contain status information about a service component
shows the value of slots that contain priority and impact information about a service
component
Related Components
SLM
shows information about the service level agreement associated with the component
Note: This tab is visible only when BMC Service Level Management is installed.
Chapter 4
105
Table 22
Tab
Purpose
Schedule
Other
These classes and attributes are defined by the BMC Atrium CMDB Common Data
Model (CDM). For information about the CDM structure and for details about
classes and their attributes, see the Common Data Model Diagram and the Common
Data Model Help, both available in CMDB_Installation_Folder\sdk\doc\cdm.
Advanced
shows the value of slots that contain creation and security information about a
service component
106
2 From the status list, select a status and only objects with that status and above will
be shown. For information about service component status, see the BMC Impact
Solutions Service Impact Management Guide.
The selected status level is applied to the Impact/Cause View and the service
component instances are filtered accordingly.
3 To toggle between the filtered view and the original view, click the left portion of
the Status Quick Filter
Chapter 4
107
To view
Provides - All
Providers - Direct
Consumers - All
Consumers - Direct
4 To search for related components of a specific type, select a Component type from
the drop-down list. To view all related components regardless of type, leave the
Component type set to Base Element. For a list of component types, see the BMC
Impact Solutions Service Impact Management Guide
5 Click Search.
Components matching the search criteria are displayed in the Components list, as
shown in Figure 20.
Figure 20
For details about the list, see the BMC Impact Solutions Service Impact Management
Guide.
6 To view a component in the Components list, select the component, right-click, and
then select View => Service Impact Graph.
108
To view
Providers - All
Providers - Direct
Consumers - All
Consumers - Direct
4 Select a Component type from the drop-down list. To view all related components
regardless of type, leave the Component type set to Base Element. For a list of
component types, see the BMC Impact Solutions Service Impact Management Guide.
5 Click Search.
Components matching the search criteria are displayed in the Components list, as
shown in Figure 21.
Figure 21
Chapter 4
109
For details about the related components subtab, see the BMC Impact Solutions
Service Impact Management Guide.
6 To view a component in the Components list, select the component, right-click, and
then select View=>Service Impact Graph.
110
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Index
A
Acknowledged (ACK) event status icon 68
active relationship
defined 86
adapters
starting 39
stopping 41
Add to Saved Finds button 84
additional cells
creating on Windows 25
Advanced subtab 106
alias formulas
creating 88
functions in 89
Assigned event status icon 68
Auto Bind cell connection property 47
automatic refresh 73
B
Blackout
event status icon 68
blackout policy, creating 76
BMC Impact Administration server
defining high availability for Impact Administration
cell 24
defining primary and secondary servers 23
defining standalone servers 23
high availability 23
Master server 23
Standard server 23
BMC Impact Explorer
consoles, types of 43
obtaining a user account on UNIX 21
starting 43
using to monitor business services 101
BMC Impact Explorer console
Java Web Start, described 43
BMC Impact Explorer Server (BMC IXS)
changing your password 22
deleting a connection 51
editing a connection 50
rearrange BMC IXS list 52
removing 51
BMC Impact Manager
C
causal components
searching for 107
cell
defining high availability for Impact Administration
24
field 82, 83
Impact Administration 24
list of cell names 82, 83
unassigned 82, 83
cell configuration
creating files for specific cells 26
cell groups
adding 58
adding cells 58
creating 57
disconnecting from 47
editing name 58
icon 64
Infrastructure Management 57
MyProduction 57
MyTest 57
removing 58
cells
adding to cell group 58
connecting to 47
creating on Windows 25
icon 64
naming, mcrtcell command 25
permissions required to start on UNIX 54
Index
111
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
registering on Windows 42
starting and stopping 53
starting and stopping on UNIX 53
starting and stopping on Windows 54
starting or stopping on Windows 54
starting with services 55
stopping with mkill 55
stopping with services 55
view information 53
viewing event list 70
changing your BMC IXS password 22
Closed event status icon 68
CMDB
product registration 96
collectors
icon 65
viewing event list 70
Collectors tab (Events View navigation) 64
color
affected by event severity 69
event status icon 68
commands
kill 41
mcell 54
mkill 54, 55
net start 56
net stop 55
component instances
creating 81
Component Label display setting 100
configuration
BMC IXS 51
configuration files
cell-specific, creating 26
mcell.conf 27, 54
configuring
display settings for Services View 98
setting cell-specific configurations up 26
connecting
BMC IX to BMC Impact Portal 50
connecting to a cell or cell group 47
connections
cell or cell group 47
deleting, BMC IXS 51
editing, BMC IXS 50
console
adding cell groups 58
BMC Impact Explorer, types of 43
editing cell group names 58
rearrange BMC IXS list 52
removing BMC IXS 51
removing cell groups 58
consoles
cross-launching 96
Services View 100
consumer components
searching for 109
112
creating
a cell group 57
additional cells on Windows 25
alias formulas 88
configuration files
cell-specific 26
cross-launching to other consoles 96
customer support 3
D
datasets
BMC.ASSET 91
BMC.IMPACT.PROD 91
default filters
in Event Sources list 63
Default Levels to Show Opened display settings 99
Default SMC Orientation display setting 100
deleting
BMC IXS connection 51
details pane (Events View) 63
disconnecting from a cell or cell group 47
display settings, configuring for Services View 98
dockable windows
Template 82
E
Edit Configuration dialog box
Global tab 48
Impact Managers subtab 73
Edit Configuration Services View 99
Edit Configuration Services View tab, illustrated 99
editing
BMC IXS connection 50
cell group names 58
event alias associations
creating 88
event count
in Events View navigation 65
Event Details window 72
event groups
viewing event list 71
Event Groups tab 64
event management policies
enabling and disabling 75
event priority
icons 70
understanding 70
event relations
icons 66
event severity
icons 69
levels 69
Event Sources list
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
effect on event list 65
location in Events View 63
using 71
event state 66
See also event status
event status
icons 68
understanding 68
events
associated with a component 106
associated with service component indicator 106
event details 72
viewing details 72
viewing impact or history 109, 110
events list
current operator information 68
default columns 65
elements 65
location in Events View 63
refreshing 73, 74
selecting the type to view 71
viewing 70
Events View
described 62
illustrated 62
location of elements 62
navigation pane 64
F
files
mcell.conf 27, 54
filtering
service component instances by status 107
filters
default 63
Find command
configuring results pane 84
filtering the results 84
Find Service Components box 104
finding
relationships 83
finding service components to view 104
functions
in alias formulas 89
H
history events, viewing 109, 110
I
icons
cell 64
cell group 64
collector 65
Collectors tab 64
displaying indicators 99
Event Groups tab 64
event priority 70
event relations 66
event severity 69
event status 68
MetaCollectors tab 64
severity level indicator 65
impact events, viewing 109, 110
Impact/Cause View
display settings 99, 100
filtering service components by status 107
illustrated 101
locating events affecting component status 106
opening 102
impacted components
searching for 107
In Impact Manager list box 104
inactive relationship, defined 86
Indicator Icons to Show Under a Component display
settings 99
indicators
for events associated with a service component 106
showing icons 99
Information Display Selection tabs (Events View) 62
Infrastructure Management cell group 57
installing
creating additional cells 26
postinstallation tasks for SNMP Adapter
Configuration Manager on Windows computers 34
J
Java Web Start application, BMC Impact Explorer 43
G
General subtab 105
General tab 82
Global Services
group 103
Global tab (Edit Configuration dialog box) 48
Go to Component button 85
K
kill command 41
L
Launch button 96
Line Color Severity check box 69
Index
113
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
M
manually refresh event list 73
Match Attributes box for event alias association 89
mcell command 54
mcrtcell command
options 26
MetaCollectors
viewing event list 71
MetaCollectors tab (Events View navigation) 64
mkill command 54, 55
monitoring
business services in BMC Impact Explorer 101
My Services group 103
MyProduction cell group 57
MyTest cell group 57
save
N
navigation pane
illustrated 103
using to view service components 102
114
a search statement 84
Schedule subtab 106
searching
for provider or consumer components 109
for related service components 107
for service components to view 104
selecting
relationships 87
service components
accessing through navigation pane 102
associated events indicator 106
event associated with 106
filtering by status 107
filtering by status in Impact/Cause View 107
finding relations 107
finding to view 104
searching for providers 109
viewing information about 105
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
services
starting cells with 55
stopping cells with 54
Services Group tab 103
Services View
configuring display settings 98
console 100
described 96
illustrated 97
Impact/Cause View display settings 99, 100
navigation pane, illustrated 103
setting
cell-specific configuration up 26
severity
effect on event status icon 68
level indicator (Events View navigation) 65, 69
SLM subtab (Services View details) 105
slot orders
described 66
SNMP Adapter Configuration Manager
postinstallation tasks for Windows installation 34
starting
adapters 39
starting cells
UNIX platforms 53, 54
using mcell 53
Windows 54
with net start 56
with services 55
status
event icons 68
searching for cause or impact 107
showing indicator icon 99
Status Quick Filter 107
Status subtabs (BMC Impact Explorer)
described 105
stopping adapters 41
stopping cells
on Windows 54
UNIX platforms 54
using the mkill command 55
with mkill 53
with net stop 55
with services 55
subtab
Status (BMC Impact Explorer) 105
subtabs
Advanced 106
General 105
Other 106
Priority and Cost 105
Related Components 105, 107
Schedule 106
support, customer 3
SystemLogDirName parameter
used to specify log and trace file directories 54
SystemTmpDirName parameter
T
technical support 3
U
UNIX
permissions required to start cells 54
root user permissions 53
starting cells 53, 54
stopping cells 54
user accounts
obtaining on UNIX 21
V
verifying promotion status 94
View Selection tabs
Events View 62
Events View navigation 64
viewing
cause or impact 107
event details 72
event list 70, 71
events associated with a component 106
history or impact events 109, 110
service component information 105
service components with find 104
types of event lists 71
W
Web Start application, BMC Impact Explorer 43
Whose name contains text box 104
wildcards
using with Find command 84
Windows
starting a cell with services 55
starting cells 54
starting cells with net start 56
stopping a cell with mkill command 55
stopping a cell with services 55
stopping cells 54
stopping cells with net stop 55
stopping with mkill 55
Index
115
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
116
Notes
*97716*
*61779*
*61779*
*61779*
*61779*