Академический Документы
Профессиональный Документы
Культура Документы
Supporting
BMC Impact Service Model Editor 7.3 BMC Impact Publishing Server 7.3
February 2009
www.bmc.com
Copyright 2009 BMC Software, Inc. BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners. Oracle is a registered trademark of Oracle Corporation. All other trademarks belong to their respective companies. BMC Software considers information included in this documentation to be proprietary and confidential. Your use of this information is subject to the terms and conditions of the applicable End User License Agreement for the product and the proprietary and restricted rights notices included in this documentation.
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)
operating system and environment information 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
s s s
sequence of events leading to the issue commands and options that you used messages received (and the time and date that you received them) product error messages messages from the operating system, such as file system full messages from related software
iii
iv
Contents
Chapter 1 Designing a service model 1 Service model design process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Defining business goals for the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Decomposing a business service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Defining the service catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Defining the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Defining a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Defining a new component class for a component type . . . . . . . . . . . . . . . . . . . . . . 8 Analyzing a components critical failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Determining a components relationship and dependencies . . . . . . . . . . . . . . . . . 10 Determining the organization of the modeled relationships . . . . . . . . . . . . . . . . . 10 Identifying a components critical events and their sources . . . . . . . . . . . . . . . . . . 11 Displaying business key performance indicators (KPIs) . . . . . . . . . . . . . . . . . . . . . 13 Service model design considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Determining cell topology for the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Component property updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Chapter 2 Understanding a service model 17 18 20 20 21 21 22 22 23 23 24 25 26 33 33 35 35 36 37 38 39 39
v
Sources of objects in a service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rules for service model data modification and deletion . . . . . . . . . . . . . . . . . . . . . Using the BMC Atrium CMDB as a source of service model data. . . . . . . . . . . . . Using BMC Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Direct Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Precedences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component classes and types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component status and substatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component status computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service model component types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service consumers and providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status propagation in relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship states. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic status mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bringing events from the resource into the cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
Event alias associations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Timeframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service schedules example with exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 3
40 42 43 43
Role of the BMC Atrium CMDB in service modeling. . . . . . . . . . . . . . . . . . . . . . . . . . . Service model and the Common Data Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sandboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service model publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service model execution on cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . In-model and not-in-model component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Business Time Segments from BMC Remedy AR System . . . . . . . . . . . . . Chapter 4 Building a service model in BMC Impact Service Model Editor
Service model creation process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Launching BMC Impact Service Model Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Working with service component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Creating service component instances in BMC Impact Service Model Editor . . . 60 Switching sandbox View modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Viewing properties for a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Editing component instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Performing actions on multiple objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Copying component instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Hiding a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Deleting a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Finding component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Defining relationships between component instances . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Creating a component relationship in BMC Impact Service Model Editor . . . . . 79 Assigning related component instances to cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Updating relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Deleting relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Associating events with a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Working with timeframes and service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Icons used in the service schedule and timeframes editors . . . . . . . . . . . . . . . . . . 92 Working with timeframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Working with service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Assigning components to service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Granting access to service model objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Granting permissions to individual service model objects . . . . . . . . . . . . . . . . . . . . . 100 Testing the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Testing component relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Testing event associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Promoting the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Contents vi
About the publishing process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Before you promote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Submitting a promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verifying promotion status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with publication logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modifying and deleting service model data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Organizing service component instances for monitoring . . . . . . . . . . . . . . . . . . . . . . Working with BMC Impact Service Model Editor Views . . . . . . . . . . . . . . . . . . . . . . Saving, opening, renaming, and deleting Views . . . . . . . . . . . . . . . . . . . . . . . . . . Understanding visual cues in a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Repositioning objects in a View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Controlling what you see in a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exploring consumer and provider paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Refreshing the View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Repositioning the dockable windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Showing topology views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting and importing service model data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting class definitions from the BMC Atrium CMDB to a cells . . . . . . . . . . . . . Chapter 5 Component and relationship status propagation
103 104 104 107 108 110 110 114 115 117 118 118 120 121 122 122 123 124 125 125 126 126 127 128 128 129 129 130 132 132 133 133 135 135 136 137 146 147 149 149 151 152 156 157 157 159
vii
About component and relationship status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How component status computation works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status computation functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status computation algorithms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How status computation algorithms work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About status computation models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Anatomy of a status computation model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The internal status NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quorum algorithm examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship status propagation concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How status propagation works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status propagation models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default status propagation models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What is a valid status propagation model? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Important service components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic prioritization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Self priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Impacts priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Determination of final priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How cost impact is calculated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How SLA impact is calculated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 6 Managing BMC Impact Service Model Editor
Setting BMC Impact Service Model Editor options . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the topology view in BMC Impact Service Model Editor . . . . . . . . . . . Adding new classes to the BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Making your changes visible to applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a new service model component class in the BMC Atrium CMDB . . .
Contents
Associating a custom icon with a service model component . . . . . . . . . . . . . . . . 159 Documenting your extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 smeserver properties file and parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Chapter 7 Creating a service model by importing HP OVO data 167
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Atrium and non-Atrium environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Installing the integration with HP OVO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Importing HP OVO data to create a service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 High-level data flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 Steps to import HP OVO data to create a service model . . . . . . . . . . . . . . . . . . . . 172 Scheduling a fetch to import HP OVO data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Chapter 8 Managing BMC Impact Publishing Server 175
Working with publication logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Viewing publication history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Viewing publication history details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Sharing a single log directory between two Publishing Servers . . . . . . . . . . . . . . . . . 179 Specifying a port for Service Model Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 High availability and BMC Impact Publishing Server . . . . . . . . . . . . . . . . . . . . . . . . . 180 Monitoring BMC Impact Publishing Server with BMC Impact Manager events . . . 181 Modifying the generation of events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 Understanding classes and slots for BMC Impact Publishing Server events . . . 183 About SIM management data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 Understanding publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 About publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 About home cell, home cell alias, and cell alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Publishing to a BEM cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 Publishing from the BMC Atrium CMDB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 Enabling AtriumCMDB Publish publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Using BMC Impact Service Model Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Creating advanced publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 Examples of advanced environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Defining BMC Atrium CMDB classes for SIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 Defining BMC Atrium CMDB attributes for SIM . . . . . . . . . . . . . . . . . . . . . . . . . . 202 ServiceModelSet attribute for components and management data . . . . . . . . . . . 203 ServiceModelSet attribute for impact relationships . . . . . . . . . . . . . . . . . . . . . . . . 204 Initializing the BMC Atrium CMDB with SIM data . . . . . . . . . . . . . . . . . . . . . . . . 205 Initializing a cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Examplecreating SIM data in BMC Atrium CMDB from BAROC files . . . . . . 211 Purging and deleting service model objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 Publishing in automated or manual mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 Publishing from a Direct Publish source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 About home cell and cell alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 About class and slot data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 Enabling Direct Publish publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
viii BMC Impact Solutions Service Modeling and Publishing Guide
Creating an environment for component instances and relationships . . . . . . . . Modifying home cell and cell aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Initializing a cell from a Direct Publish environment . . . . . . . . . . . . . . . . . . . . . . Examplesusing cell aliases for Direct Publish publishing . . . . . . . . . . . . . . . . . Securing publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . pserver.conf file and parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the Notify ARDBC plug-in. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the Notify plug-in for AR server groups . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 9 BMC Impact Publishing Server CLIs
Configuring BMC Impact Publishing Server CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Configuration file and parameters for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Changing the time-out values for all the CLI commands . . . . . . . . . . . . . . . . . . . 240 Setting the configuration for a specific CLI command . . . . . . . . . . . . . . . . . . . . . 241 Configuring trace for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Understanding common command options for CLIs. . . . . . . . . . . . . . . . . . . . . . . . . . 241 Understanding return codes for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 Return codes for pserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 Using CLI commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Summary of CLI commands for BMC Impact Publishing Server . . . . . . . . . . . . 247 pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 penvManaging publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 pinitInitializing a cell with service model data . . . . . . . . . . . . . . . . . . . . . . . . . . 261 plogObtaining the XML log for a request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 plogdisplayConverting the XML log for a request to text format . . . . . . . . . . 266 pposterSending service model objects to a cell . . . . . . . . . . . . . . . . . . . . . . . . . . 268 pscontrolSending a command to BMC Impact Publishing Server. . . . . . . . . . 278 pserverStarting the BMC Impact Publishing Server service . . . . . . . . . . . . . . . 280 pshowlogObtaining the XML log in user-friendly format . . . . . . . . . . . . . . . . 281 psstatDisplaying status of BMC Impact Publishing Server . . . . . . . . . . . . . . . 282 publishPublishing a service model or viewing instances to be published . . . 283 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Appendix A Troubleshooting 287 288 288 292 292 293 293 293 293 295 296 296 297 297
ix
BMC Impact Service Model Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the BMC Impact Service Model Editor log. . . . . . . . . . . . . . . . . . . . . . . . . . Other BMC Impact Service Model Editor Troubleshooting Options . . . . . . . . . BMC Impact Publishing Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verifying that BMC Impact Publishing Server is running . . . . . . . . . . . . . . . . . . Using trace files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Stopping BMC Impact Publishing Server when JMS is not running . . . . . . . . . . Publishing large service models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Publishing failures and reattempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BMC Impact Publishing Server service or daemon fails to start . . . . . . . . . . . . . No publication after successful promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reconciliation jobs hang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BMC Impact Publishing Server does not reply to requests. . . . . . . . . . . . . . . . . .
Contents
Diagnosing publication failures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 Another publish request is ongoing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 Using dynamic ports with the ARDBC Notify plug-in . . . . . . . . . . . . . . . . . . . . . 303 BMC Impact Service Model Integration with HP OVO . . . . . . . . . . . . . . . . . . . . . . . . 303 Avoiding duplicate CIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 Automated publication after reconciling reconciliation failure . . . . . . . . . . . . . . 304 Limiting HP OVO fetcher trace file growth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 Appendix B Default service model data classes 305
Service model data structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 Service model data class overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 Service model data class files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 Service model component data classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 BMC_BaseElement data class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 BMC_Impact data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 BMC_DOWNTIME_STATUS_CONFIG data class. . . . . . . . . . . . . . . . . . . . . . . . . 316 BMC_STATUS_COMPUTATION data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 BMC_STATUS_PROPAGATION data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 BMC_PROPAGATION_MAP data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 SIM data class descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 BMC_SEVERITY_TO_STATUS data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 BMC_SIM_MATCH_TABLE data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 BMC_SIM_ALIAS data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 BMC_SLOT_FORMULAS data class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 BMC_TIME_SCHEDULE data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 BMC_TIME_FRAME_TO_SCHEDULE data class . . . . . . . . . . . . . . . . . . . . . . . . . 325 BMC_SELF_PRIORITY_MAPPING data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 BMC_SERVICE_SCHEDULE_CONFIG data class . . . . . . . . . . . . . . . . . . . . . . . . . 326 BMC_STATUS_TO_SEVERITY data class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 SIM_TIME_FRAME class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 SIM_CellAlias class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 SIM_CellInformation class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 BMC_PROMOTION_LOG class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 Service model event classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 CORE_EVENT base class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 Root event class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 History event class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 Impact event class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 Index 333
Figures
Example of a service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Inserting KPI data into the business_slot with an action . . . . . . . . . . . . . . . . . . . . . . . 13 Updating KPI data with a rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Impact (status) propagation in relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Parts of a simple alias formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Find Component dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Advanced Find dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Using Conditional Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Create Relationship dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Drawing relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Creating an alias association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Defining the events to be processed by the alias formula . . . . . . . . . . . . . . . . . . . . . . . 88 Example of match attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Timeframe Edit dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Schedule Edit dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Schedules Editor section of Edit Component Properties dialog box . . . . . . . . . . . . . . 99 Changing access for an individual component instance . . . . . . . . . . . . . . . . . . . . . . . 101 Propagation paths between root cause and important components . . . . . . . . . . . . . 136 Self priority determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Cost priority method of priority determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Worst SLA method of priority determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Impacts priority determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Final priority determination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Default value for com.bmc.sms.sme.topoviews parameter . . . . . . . . . . . . . . . . . . . . 156 Graph definition format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 Example of a graph definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 BMC_BaseElement default icon image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Adapter cell group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 pscontrol stop example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 pscontrol automated example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 pscontrol automated -u example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 pscontrol manual example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 BMC Impact Service Model Editor log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 BMC_BaseElement definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 MC_SM_COMPONENT definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 MC_SM_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 CORE_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 BMC_Impact definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 MC_SM_RELATIONSHIP definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 MC_SM_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Figures xi
CORE_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 BMC_DOWNTIME_STATUS_CONFIG definition . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 BMC_SIM_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 BMC_STATUS_COMPUTATION definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 BMC_SIM_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 BMC_STATUS_PROPAGATION definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 BMC_SIM_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 BMC_PROPAGATION_MAP definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 BMC_SIM_DATA definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 SEVERITY_TO_STATUS definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 BMC_SIM_MATCH_TABLE definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 BMC_SIM_ALIAS definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 BMC_SLOT_FORMULAS definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 BMC_TIME_SCHEDULE definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 BMC_TIME_FRAME_TO_SCHEDULE definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 BMC_SELF_PRIORITY_MAPPING definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 BMC_SERVICE_SCHEDULE_CONFIG definition . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 BMC_STATUS_TO_SEVERITY definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 SIM_TIME_FRAME definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 Partial CORE_EVENT definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 MC_SMC_ROOT definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 SMC_STATE_CHANGE definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 MC_SMC_EVENT definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
xii
Tables
Example business service model spreadsheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 BMC Impact Service Model Editor values for IT service Sales Logix . . . . . . . . . . . . . . 6 Severity level index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Occurrence level index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 How service model objects get to a SIM cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Advantages and disadvantages of different object sources . . . . . . . . . . . . . . . . . . . . . 19 Service component status definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Service model component types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Main relationship classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 How an event alias association works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Global and Local timeframe differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 SIM-qualified subclasses of BMC_Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 SIM-qualified subclasses of BMC_LogicalEntity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 SIM-qualified subclasses of BMC_System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 SIM-qualified subclasses of BMC_SystemComponent . . . . . . . . . . . . . . . . . . . . . . . . . 48 SIM-qualified subclasses of BMC_Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 SIM-qualified subclass of BMC_SystemService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 SIM-qualified attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 View mode switch icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Default component properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Description of additional search criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Definition of relational operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Description of conditional operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Service schedule and timeframes editors icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Timeframe Edit field descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Schedule Edit field descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Default user groups and rights for BMC Impact Service Model Editor . . . . . . . . . . 100 Icons in Objects-to-be-Published pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Topics covered in this section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Visual cues in a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Adjusting the graphical view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Understanding expansion handles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Status computation functions and computed component statuses . . . . . . . . . . . . . . 127 What a function returns when using an available algorithm . . . . . . . . . . . . . . . . . . . 128 Description of predefined status computation models . . . . . . . . . . . . . . . . . . . . . . . . 129 How status propagation models work in relationships . . . . . . . . . . . . . . . . . . . . . . . 134 smeserver.properties file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Integration with HP OVO configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 BMC Impact Publishing Server event generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Common Event Model (CEM) slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Tables xiii
IPS_START slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 IPS_STOP slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 IPS_CONFIG slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 IPS_CONNECT slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 IPS_IM_CONNECT slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 IPS_REQUEST slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 IPS_PUBLISH slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 IPS_CLASSINFO slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 IPS_ERROR slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 IPS_ENV slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 Basic steps to create advanced test environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 ServiceModelSet attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 Determination of ServiceModelSet value for an impact relationship . . . . . . . . . . . . 204 Parameters in the pclient.conf file for initializing the BMC Atrium CMDB . . . . . . . 206 InitEffectivelyMgmtData parameter values and results . . . . . . . . . . . . . . . . . . . . . . . 207 InitEffectivelyServiceModel parameter settings and results . . . . . . . . . . . . . . . . . . . . 208 Basic process of publishing from a Direct Publish source . . . . . . . . . . . . . . . . . . . . . . 215 Valid parameters for a Direct Publish environment . . . . . . . . . . . . . . . . . . . . . . . . . . 216 pserver.conf file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 ar.cfg file parameter descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 pclient.conf parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 BMC Impact Publishing Server CLI common command options . . . . . . . . . . . . . . . 242 BMC Impact Publishing Server CLI error exit codes . . . . . . . . . . . . . . . . . . . . . . . . . . 243 pserver error exit codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 BMC Impact Publishing Server CLI command descriptions . . . . . . . . . . . . . . . . . . . 248 pclassinfo options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 penv options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Actions commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Valid parameters for a BMC Atrium CMDB publish environment . . . . . . . . . . . . . . 256 Valid parameters for a Direct Publish environment . . . . . . . . . . . . . . . . . . . . . . . . . . 258 pinit options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 plog options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 plogdisplay options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 plogdisplay return codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 pposter options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 pposter return codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 pscontrol command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 pserver command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 pshowlog options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 psstat command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 publish command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 BMC Impact Publishing Server request failure messages . . . . . . . . . . . . . . . . . . . . . . 298 Service management data class files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Slots that define component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 BMC_Impact slot definitions in alphabetical order . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 BMC_DOWNTIME_STATUS_CONFIG slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 BMC_STATUS_COMPUTATION slots in alphabetical order . . . . . . . . . . . . . . . . . . 319 Status propagation slots in alphabetical order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 BMC_PROPAGATION_MAP slot definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
xiv
Chapter
Chapter 1
business consumers
service layer
IT infrastructure
The following factors determine how a service impact management solution should be designed and implemented:
s s
s s s
the diversity of IT resources and how they are monitored the location of resources and how the management responsibilities for them are distributed within and among IT or information services (IS) groups the relative importance of various resources in the delivery of business services the need for change management the maintainability of the service model over time
identifying sources of event information gaining familiarity with the structure and content of events identifying core competencies within the organization identifying critical business processes identifying IT services and their components finding relationships and dependencies between IT services building the necessary database of information (asset inventory, service catalog, and so on) building the service model
TIP
For basic, conceptual information regarding service models and publishing, see the BMC Impact Solutions Concepts Guide.
Chapter 1
operational efficiencyThis type of implementation is run by and for the IT or IS group. It consists of a thin layer of logical groups on top of a large number of IT resources, ranging from applications and systems to hard disks and other hardware components. Services are just logical groupings that provide a convenient way of classifying the technical resources. business-focused operational efficiencyThis type of implementation is likely to involve various populations and centers of management in the enterprise. It consists of a balanced representation of the operational environment, encompassing the IT components, such as systems and applications, and the logical components, such as services, user groups, and other business objects. business continuity and service availabilityThis type of implementation is driven from the top and ensures that IT or IS is delivering their services as agreed. It consists of a business-centric model in which business processes, services, and SLAs rely on a small number of vital IT components that measure the pulse of the underlying environment.
The process involves interviewing the managers and identifying the following information:
s
Product Planning, Response Management, or Case Management. There can be multiple levels of business processes, starting with higher level core competencies and business functions, to specific sub-business processes. functional applicationsIdentify the business applications that support the business processes. Map the business processes to the functional apps.
Map the functional applications to IT service components to create the business service models.
2 Identify IT services.
Sources of information include IT managers and staff. Disaster recovery plans, help desk documents, and purchase orders might be useful in identifying IT components and the business processes that they support. The process involves identifying the list of IT assets (components). Interview the IT management and staff, or utilize an asset/configuration management database as resources:
s
s s
Create a list of IT services (service catalog); discover what IT services are offered to business units through use of IT assets. Examples of IT services include customer support and customer call monitoring. For each IT service, identify the IT assets that support the service. Identify the interdependencies among the IT components and formulate a topology map. Consider the relationships and dependencies between IT components.
3 Build a business service model, and link the business processes to the IT services
you have identified. Table 1 Example business service model spreadsheet
Business functions Marketing Business processes Market research
IT services
IT component
Research product and planning development Manager customer relations Front office sales Customer support Response management Support service requests FTP Server: FTP
Chapter 1
Table 1
Core competencies
IT component Server: Walrus Database: SALLOG Applications: Sales Logix User group: Tech Support dept Servers: Antelope
BMC Impact Service Model Editor values for IT service Sales Logix
Provider instances Consumer Status computati Relationsh that instances impact on model ip Policy depending on direct Tech Support Analysts Sales Logix v6.01 Support service requests Tech Support Analysts
Component description
In/out model in
user Tech Techs communit Support supporting y Analysts service requests applicatio Sales n Logix v6.01 applicatio Sales n server Logix server
bogart
in
standard
direct
in
standard
in
standard
increasing Sales Sales Logix Logix DB v6.01 software Tech Support Analysts
Table 2
Compon ent name
BMC Impact Service Model Editor values for IT service Sales Logix
Provider instances Consumer Status computati Relationsh that instances impact on model ip Policy depending on standard direct SALLOG Sales Logix application Tech Support Analysts Sales Logix db software Tech Support Analysts
Component description
In/out model in
Sales Logic Sales database Logix software v6.0 DB software SALLOG Sales Logix database server
database server
bogart
in
standard
direct
You use this information later in the design phase and when creating service model components. The first step in developing a service model is to design its logical architecture. To do this, you must analyze the IT environment to
s s s
identify the resources that make up the service model identify the event sources for the resources and their characteristics determine the functional relationships and dependencies between various resources that can affect services
Chapter 1
Component instances are created as a single instance of a class type that is defined in the BMC Atrium CMDB. Classes may identify such physical components as servers or databases, and such logical components as user groups. Component instances are created through BMC Impact Service Model Editor. The order in which you create related physical components is unimportant. You can create an IT system component before or after an application component that runs on it.
s s s
identify the cause of failures and degraded performances for the service component categorize the failures into availability, performance, capacity identify the effects of the failures assign a severity level to each failure Severity level values are listed in Table 3.
Table 3
severe significant moderate minor slight minimal
Severity level
Occurrence level
s s s s s
ComponentMessage Transfer Agent (MTA) Functionroutes and convert messages Point of failurequeue length size growing Issue typeperformance Cause of failurenetwork connection failure, receiving MTA failure, problem on sending or receiving machine Effect of failureremote recipients will not receive e-mail while MTA down Severitysignificant Occurrenceslight Preventionmonitoring of the system, network, and exchange services DetectionPATROL NT and Exchange parameters related to the issue
Chapter 1
consider relationships and dependencies within the IT service; for example, within email service, or call supports dependency on email consider dependencies on other services; for example, web services and email services consider how the same IT components might support more than one service; for example, one server hosting multiple applications consider the dependencies of several business processes on the same service; for example, email used by all consider the relationship between IT services and business processes (the link called business service)
Map business processes to each system. The grouping of IT systems becomes the IT services, so that only one IT service would exist for each business process. Identify the relationships and dependencies among the IT components and the logical components to one another. The direction of the relationship is important. If a system component is to be linked to a hardware component, the hardware component must be the provider and the system component the consumer. Examine how the various resources combine to deliver a service on a particular host. Define the resources that are providers and the resources that consume their services in the service delivery stream.
The IT resource management strategy is to create a thin layer of logical groupings on top of a large number of IT resources, ranging from applications and systems to hard disks and other hardware components. This type of implementation is run by and for the IT or IS group. Services are just logical groupings that provide convenient way of classifying the technical resources. The driving force behind this model is operational efficiency.
10
The business-focused operational efficiency strategy is to create a balanced representation of the operational environment, encompassing the IT components, such as systems and applications, and the logical components, such as services, user groups, and other business objects. This type of implementation is likely to involve various populations and loci of management in the enterprise. The driving force is operational efficiency, but with a balanced business perspective. The business continuity and service availability strategy is to implement a business-centric model in which business processes and services rely on a small number of vital IT components to give a status overview of the underlying environment. This type of implementation is driven from the top, ensuring that IT or IS is delivering their services as agreed. The driving force is business continuity and availability. This strategy is similar to BMC Softwares BSM Strategy that is called a Business Service Impact Model.
Although these strategies are only briefly outlined here, they are helpful in understanding that each implementation probably has a different focus, favoring some types of components and having more or less granularity in some branches of the component hierarchy. The strategy that you choose also affects the amount of time and effort required for its development and implementation.
identify the event classes that will be associated with the component establish a naming convention for the logical ID (a key value) so that the same identification string can be derived from each event class to be associated with the component
You perform event analysis to achieve these goals. Assuming that there is enough event data consistently available to understand the state of IT resources, perform the following actions:
1 Analyze the event flow of each real IT resource or group of resources that are
instrumented in the same way to identify:
s
Chapter 1
11
Not all events received by a cell provide valuable information to the service model. Identify the events that are of no value and should be ignored, either by not sending them to a cell or by filtering them out when they reach the first cell.
s
events that provide valuable information about the service environment and must be retained by the cell, such as: events that must be changed or adapted either at the source or in the event adapter that collects them to be usable by the model events that must be enriched by the cell so that they contain the required information; events can be enriched using Refine and New rules events that must be processed (using a Regulate rule) so that only the appropriate occurrences reach the service model events that should be combined through abstraction, correlation, or through New rule updates before entering the service model This includes events that are best represented by a single higher-order event that represents their net effect or represented by event pairs, such as UP/DOWN.
missing events or events that cannot be processed Some situations that you may want to include in your model are not traced by events in the real environment, or the events produced cannot be associated with the IT resource.
2 For each significant event, determine whether the event should be associated only
with a component or whether it should also participate in the status computation. For example, a cause event E1 is associated with the component C1, and a consequence event E2 is associated with the component C2. While it may appear reasonable to elect E1 so that its severity value contributes to the status of C1, electing E2 may be of no use if a relationship propagates the impact of event E1 from component C1 to component C2.
3 Consider how the monitoring tool, such as an agent, adapter, or script, reports the
state of the services IT resources.
s
Does the monitoring tool send alerts only when something goes wrong? If so, does it close the alerts automatically? If the monitoring tool does not close alerts automatically, you may need to automate their closure through rules containing the appropriate cycle and conditions.
12
Does the monitoring tool send status-type events, such as ok or not ok, at regular intervals? Does the monitoring tool handle component availability with some form of heartbeat? When does the IT component representing the resource transition from AVAILABLE to UNKNOWN or from AVAILABLE to UNAVAILABLE, and back again? What is the reliability of the event flow? Even the most complete service model is of little value if a consistent flow of events into the model cannot be maintained. When creating new event propagation paths, you should take care to consider whether you can improve or, at least, not affect event flow.
action sim_operations.set_business_data: { [Service Administrators,Service Operators - Senior,Service Operators] } [business_data: STRING($business_data)] : MC_SM_COMPONENT ($A) { $A.business_class=$business_data; } END
To update the business_data slot, you create a rule or a policy. Figure 3 shows an example rule (in the mc_smc_associate.mrl file).
Chapter 1
13
Figure 3
new associate_kpi: <EVENT_CLASS_NAME ($EV) where [$EV.mc_smc_id != ] using {MC_SM_COMPONENT ($COMP) where [$COMP.mc_udid == $EV.mc_smc_id]} triggers { $COMP.business_data = <an expression that builds kpi from $EV>; # uncomment the following if you want to drop these events # if ($EV.mc_sm_impact = != 1) then # { # drop_new; # } } END
The centralized (default implementation) approach is to implement the service model on one cell, with all the service management objects created and maintained in that cell. Then, use distributed cells to collect and process the raw events of interest before they enter the model. The domain-based approach separates the service model into two or more parts that correspond to clearly established entities or domains in the organization. Each part is run on a different cell, and users connect to the cells on which the components that they manage reside. Lines of business and independently operated sites are good candidates for this approach. With this approach, you can represent some resources in more than one cell, provided that the event flow is directed or propagated correctly. The layered approach separates the service model into two or more stratified management layers, such as IT components and logical components. Each layer is contained in a different cell, or possibly distributed among several cells if geography is a factor.
14
If you are assigning different components of the same service model across multiple cells, first determine which components are related. Then assign related components to appropriate cells until you assign all components of the service model.
Chapter 1
15
16
Chapter
s s s
s s
data classes that describe the various types of physical and logical IT resources that make up an enterprises business corresponding data classes in the SIM KB of cells event classes associated with specific resources component instances that represent the unique physical and the logical configuration items that deliver business services impact relationships management data instances
This chapter presents the following topics: Sources of objects in a service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rules for service model data modification and deletion . . . . . . . . . . . . . . . . . . . . . Using the BMC Atrium CMDB as a source of service model data. . . . . . . . . . . . . Using BMC Performance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Direct Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Precedences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component classes and types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component status and substatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component status computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service model component types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Component relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service consumers and providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship states. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status propagation in relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic status mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bringing events from the resource into the cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event alias associations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 20 20 21 21 22 22 23 23 24 25 26 33 33 35 35 36 37 38 39 40
Chapter 2
17
BMC Atrium CMDB BMC Impact Explorer CLI commands pposter and mposter Master Rule Language (MRL) third-party repository
The source of the service model data determines the method of delivery into the cell, as described in Table 5. Table 5 How service model objects get to a SIM cell
How objects are delivered to a cell Delivery method name Atrium Publish Feed objects are discovered using discovery tools or you create them in the BMC Impact Service Model Editor component; they are reconciled by the BMC Atrium CMDB Reconciliation Engine, and then automatically published to the cell using BMC Impact Publishing Server you create a BAROC source file of object data and Direct Publish Feed send it to the cell using the CLI command pposter, which publishes the data to the cell using BMC Impact Publishing Server you create a BAROC source file of object data and source Direct Feed send it to the cell using the CLI command mposter
18
Table 5
Table 6 describes some of the advantages and disadvantages of the different sources for service model data. Table 6 Advantages and disadvantages of different object sources
Advantages
s s s
Disadvantages
s s
s s
handles large, complex service models accepts objects from discovery tools sophisticated features, such as BMC Impact Service Model Editor GUI to create, edit, and delete objects, and dynamic prioritization data is protected from uncontrolled edits customizable permissions are available easy to set up a simple service model quickly managed by BMC Impact Publishing Server, so data is protected from uncontrolled edits user interface to create and edit components and relationships you can add data to complement other sources
complex to implement time factor to discover or create, reconcile, and publish objects
s s
s s s
useful only for small, simple models BAROC file must be created to exact standards requires knowledge of CLIs may not build complete model not as protected from uncontrolled edits no primary copy in external datastore
s s s
Chapter 2
19
Table 6
MRL rule
Object source
Disadvantages
s s s
only practical for special circumstances may not build complete model no primary copy in external datastore
validation of the service model is off-loaded from the cell, preventing cell processing performance degradation
20
In the BMC Impact Service Model Editor, you build and maintain a service model with component objects, and manage your service model environment In the BMC Impact Publishing Server, you publish service model data to the cells and manage publish environments. Your service model can come solely from BMC Atrium CMDB or you can add objects to it from other sources. For more information about creating service models using BMC Atrium CMDB, see Chapter 3, Understanding a service model created in BMC Impact Service Model Editor and Chapter 4, Building a service model in BMC Impact Service Model Editor.
Chapter 2
21
Precedences
Management data that comes from DirectFeed cannot be referred to by a service model that is published. Publication will fail if the referred management data is not published.
Precedences
Data published from BMC Atrium CMDB automatically overwrites Direct Publish data and Direct Feed data. Between Direct Publish and Direct Feed data, Direct Publish data has a higher precedence and hence overwrites Direct Feed data. Events that are attached to lower precedence CIs are automatically reattached to overwriting CIs of higher precedence. Data overrides other data with a lower precedence if
s s
it has the same key slots or in the case of a MC_SM_COMPONENT, when it has the same alias
Different system sources like BMC Impact Explorer, pposter, BMC Performance Manager, and BMC Atrium CMDB must not create data with the same mc_udid.
Overriding rules
When data X, for example, has precedence pX with key slot values that collide with existing data Y with precedence pY, such that pY < pX, then Y is deleted; otherwise the addition of X fails. These key slot collision rules apply to SIM data and relationships (the keys of a relationships are the provider_id and consumer_id). Do not modify key slots. Data modification or deletion is allowed only when the publish environment ID of the requester matches the publish_env_id of the data. In addition to these rules, extra operations are performed when overriding, modifying, or deleting CIs to ensure the uniqueness of each alias and to avoid (local) relationships with dangling ends.
Service components
This section contains overview information about components classes and types, types of service component instances, and component statuses.
22
Chapter 2
23
Meaning
UNKNOWN
20
UNKNOWN
OK
green
30
OK
INFORMATION WARNING
40 50
INFO WARNING
60 70 80
NOTE
Do not confuse the MC_SM_COMPONENT_STATUS enumeration with the STATUS enumeration that defines event status values, such as OPEN or ACK.
24
a new event is received that has a direct impact on the component the severity of an event impacting a component changes another components status change is propagated to the component
Whether the status of a component is influenced directly by events, by other components status changes, or both, depends on the components type and its relative position in a particular service infrastructure. For example, the status of an IT component usually reflects the associated resource events that directly impact its status. In contrast, logical components such as applications or business groups rely on their relationships to IT components to provide their current status. The cell computes a components status using a status computation model that you assign to the component instance in the StatusModel attribute. Based on the specific status computation model, the cell uses an algorithm to calculate the
s s s
status values propagated by inbound relationships severities of direct events associated with the service component instance impact status and service component self-status
The predefined status computation models available are Standard, Cluster, Weighted Cluster, and Self-Preferred. The Weighted Cluster status computation model uses the Status Weight attribute of the BMC_Impact object. Status Weight is used in impact relationships to determine how much importance (numerically weighted) to give to each provider relationship that impacts a consumer instance. The higher the number, the greater the importance. You select the status computation model for each component instance in the Create (or Edit) Component dialog box, on the Status and Alias tab, in the Status Computation box. BMC Impact Service Model Editor ensures that each component instance is associated with a valid status computation model. See Creating service component instances in BMC Impact Service Model Editor on page 60. For more information about component status computation and status computation models, see Chapter 5, Component and relationship status propagation on page 17.
NOTE
Whether and how the status of a provider component is propagated through a relationship is controlled by the relationship policy assigned to the component instance. For more information about selecting a relationship policy for a component, see Chapter 4, Building a service model in BMC Impact Service Model Editor on page 17.
Chapter 2
25
Activity Decision
BMC_Activity ActivityType=ActivityDecision BMC_Activity ActivityType=ActivityEnd BMC_Activity ActivityType=ActivityInteraction BMC_Activity ActivityType=ActivityManual BMC_Activity ActivityType=ActivityStart BMC_BusinessProcess
Activity End
Activity Interaction
Activity Manual
Activity Start
Business Process
Business Service
BMC_BusinessService
Database
BMC_DataBase
26
Table 8
Component superclass Collection
Connectivity Collection
BMC_ConnectivityCollection
IP Connectivity Subnet
BMC_IPConnectivitySubnet
BMC_IPXConnectivityNetwork
BMC_LNsCollection
BMC_LNsCollection
LAN Network
BMC_LAN
WAN Network
BMC_WAN
Organization
BMC_Organization
Application
Application Infrastructure
BMC_ApplicationInfrastructure
Application System
BMC_ApplicationSystem
Cluster
BMC_Cluster
Chapter 2
27
Table 8
Component superclass System
Computer System
BMC_SoftwareServer SoftwareServerType=ConfigMgmtAgent
Database Server
BMC_SoftwareServer SoftwareServerType=DataBaseServer BMC_SoftwareServer SoftwareServerType=DNSServer BMC_ComputerSystem PrimaryCapability=File Server BMC_ComputerSystem PrimaryCapability=Firewall BMC_SoftwareServer SoftwareServerType=FTPServer BMC_ComputerSystem PrimaryCapability=Gateway BMC_ComputerSystem PrimaryCapability=Hub BMC_ComputerSystem PrimaryCapability BMC_ComputerSystem PrimaryCapability=JBOD BMC_ComputerSystem PrimaryCapability=Layer 3 Switch
DNS Server
File Server
Firewall
FTP Server
Gateway
Hub
Input/Output Device
Layer 3 Switch
28
Table 8
Component superclass System
Load Balancer
Mail Server
Mainframe
Message Server
BMC_Monitor
Print Server
BMC_ComputerSystem PrimaryCapability=Print BMC_SoftwareServer SoftwareServerType=PrintServer BMC_ComputerSystem PrimaryCapability=RAIDStorageDevice BMC_SoftwareServer SoftwareServerType=ResourceServer BMC_ComputerSystem PrimaryCapability=Router BMC_ComputerSystem PrimaryCapability=SANBridge
Print Server
Resource Server
Router
SAN Bridge
Chapter 2
29
Table 8
Component superclass System
SAN Hub
SAN Router
SAN Switch
Security Server
Server
Software Server
Storage
BMC_ComputerSystem PrimaryCapability=Storage BMC_ComputerSystem PrimaryCapability=Switch BMC_ComputerSystem PrimaryCapability=TapeLibrary BMC_SoftwareServer SoftwareServerType=TelnetServer BMC_SoftwareServer SoftwareServerType=TransactionServer
Switch
Tape Library
Telnet Server
Transaction Server
UDDI Server
BMC_SoftwareServer SoftwareServerType=UDDIServer
30
Table 8
Component superclass System
Web Cache
Web Server
System Service
System Component
Media
BMC_Media
CD ROM Drive
BMC_CDROMDrive
Disk Drive
BMC_DiskDrive
Floppy Drive
BMC_FloppyDrive
Tape Drive
BMC_TapeDrive
Chapter 2
31
Table 8
Component superclass
System Component
File System
BMC_FileSystem
Database Storage
BMC_DataBaseStorage
BMC_LocalFileSystem
BMC_RemoteFileSystem
Disk Partition
BMC_DiskPartition
Software
BMC_Software
System Software
BMC_SystemSoftware
Operating System
BMC_OperatingSystem
BMC_VirtualSystemEnabler
VMware
System Resource
32
Component relationships
Component relationships
Service management relationships are impact relationships.
NOTE
Only BMC_Impact relationships are considered, or used, by SIM.
Table 9 lists the main relationship classes derived from BMC_BaseRelationship, of which only BMC_Impact defines impact relationships for a service model. Table 9
Class name BMC_Impact
BMC_Dependency
BMC_Component
BMC_MemberOfCollection
BMC_ElementLocation
Chapter 2
33
The concepts of provider and consumer are relative to the relationship being considered. In Figure 4, Component B is a provider in one relationship and a consumer in another. Figure 4 Impact (status) propagation in relationships
The service model enables a component instance to be related to another component instance by defining the relationship in the BMC_Impact class. Such a relationship states that a component instance is impacted if something happens to the component instances to which it is related. For example, a group of people responsible for accounting will be impacted when the accounting database server is down. Service model relationships are organized in a hierarchy of data classes in which each class represents a relationship type. The parent class for component relationships is BMC_Relationship. All service model relationship classes are defined in the BMC Atrium CMDB as a subclass of BMC_Relationship.
Important components
Some components can be considered important components and can be set to propagate their priority back to their provider. For more information about priority propagators, see Impacts priority on page 146.
34
the components status changes the state of an outbound impact relationship changes, altering the status propagation from the provider component
This status can then be propagated to subsequent components within the service model. The service model ensures that each impact relationship instance is associated to a valid status propagation model. For more information about status propagation and status propagation models, see Chapter 5, Component and relationship status propagation on page 125.
Relationship states
Just as a component is characterized by its status, a relationship is characterized by its state. Relationship state values are defined internally in the cell as the enumeration MC_SM_RELATIONSHIP_STATE. A relationship can be either active or inactive, as shown in the following table:
Relationship state value ACTIVE INACTIVE
Meaning The consumer component depends on its provider. An impact relationship exists. The consumer does not have a dependency, or the dependency is unimportant. No impact relationship exists.
In status propagation models, the state of a relationship determines whether the providers status or a modification of it is passed to the consumer service component.
Chapter 2
35
Relationship control
the current state of the relationship (active or inactive) the current value of the providers status
Status propagation models are used only by impact relationships. The role of the BMC_STATUS_PROPAGATION class instance is to restrict the use of a propagation model to consumer and provider relationships. Status propagation models serve these purposes:
s
relationship controlPropagation models enforce logical rules in new component relationships so that only valid relationships are created.
dynamic status mappingPropagation models translate the computed status of the provider component into a propagated status for input into the impact_function slot of the related consumer component.
Relationship control
Relationship control is the enforcement of logical rules in creating new service model relationships. The BMC_STATUS_PROPAGATION table defines the valid pairs of component types whose instances can participate in a specific type of relationship. Each time an impact relationship instance is submitted for creation, the cell seeks an BMC_STATUS_PROPAGATION instance that matches
s s s
the name of the propagation model used by the component relationship the component type of the provider in the relationship the component type of the consumer in the relationship
During this process, the cell uses the components class hierarchy to interpret the component types in the BMC_STATUS_PROPAGATION instances. If there is a matching BMC_STATUS_PROPAGATION instance, the relationship is valid. Otherwise, the creation process is blocked.
36
s s
Events can be manually obtained directly through adapters and the msend and mposter commands. Cells also provide events through propagation rules. Other sources include third-party products that can be integrated with BMC IM.
2. associating those events with the service model component instance that represents the resource You can associate events from a resource with the component instance that represents it by using the alias key. The actual association is done using a slot-mapping data table, which stores all the slot-mapping formulas for event classes. The arrival of an event invokes a unique predefined rule that generates a value for the events mc_smc_alias slot and searches for the matching service component in the alias table. With this process in place, incoming events can alter the status of the component directly in real time. For example, an event with a severity of CRITICAL could turn the status of the associated component to UNAVAILABLE by using a severity-tostatus mapping table. The BMC_PROPAGATION_MAP table defines the status-mapping instances for the relationships. A group of BMC_PROPAGATION_MAP instances sharing the same name form a propagation map that is uniquely bound to the status propagation model with the same name. When two components participate in an impact relationship and the status of the provider changes, the new status must be propagated to a consumer component. First, the cell seeks the BMC_PROPAGATION_MAP instance in which the following value matches occur:
Chapter 2
37
Event associations
BMC_PROPAGATION_MAP instance slot value Matching class instance name relationship_state provider_status relationship relationship provider component
Matching value propagation_model slot value state slot value status slot value
Then, the cell obtains the appropriate propagated_status value to propagate, depending on the current state of the relationship (ACTIVE or INACTIVE). The cell propagates this value to the consumer component for input to the consumers status computation. For example, consider an impact relationship with service component named
XService that is a consumer of an IT component, DBsoftware. The relationship is active
and the propagation model assigned to it is INCREASING. When the cell needs to propagate DBsoftwares current status (IMPACTED) to its consumer component, XService, it searches the INCREASING propagation map to find the instance corresponding to a provider status of IMPACTED. To obtain the appropriate propagated_status value, it matches the corresponding relationship state (ACTIVE), which is a value of UNAVAILABLE in this instance. Finally, the cell propagates the appropriate changed status to the consumer component. Propagation maps affect only the way in which the main status of the provider is propagated in the relationship. They do not affect how the substatus is propagated from the provider to the consumer.
Event associations
A production service model requires that the incoming events that contain information about the state of a IT asset be associated with the appropriate service model component instance. This event association provides the mechanism for keeping a component instances status up-to-date, so that it reflects the real-time health of the actual resource that it represents. Event association uses the aliases that you assign to service components and event alias associations that you create in BMC Impact Service Model Editor. To set up an event association, you must
s
38
associate the events with the service model component instance that represents the resource enter an alias in the Alias attribute of the component instance create an appropriate event alias association for the component instance
Component aliases
You designate a component instance as participating in alias activity by entering a value in the Alias attribute when you create or edit a component instance in BMC Impact Service Model Editor. An alias identifies a specific component instance. When an event arrives at the cell, the cell constructs an alias using data in the events slots plus any other elements specified in the alias formula. An alias formula defines the content and format of the alias. A service component instance can have several different aliases so that different event types can be easily associated with it. Service component aliases are stored in the BMC Atrium CMDB and are associated with the relevant service component by the components universal data identifier (udid). An alias formula is an object published to the cell; it is not associated with any object in the service model; it is management data supporting the service model. For information about entering component aliases in a component instance, see Creating service component instances in BMC Impact Service Model Editor on page 60.
Chapter 2
39
The event class identifies which incoming events may affect the status of the component instance. For example, for an application component instance, you want events of a particular category, such as SYSTEM_EVENT, APPLICATION_EVENT, DATABASE_EVENT, to be considered by the cell. After the cell has constructed the events alias, it searches each component instance to see if the value in its ComponentAlias attribute matches the alias constructed from values in the event. If it matches, the event is associated with the component instance in the BMC_SIM_ALIAS class and can change the component instances status, depending on the component instances status propagation model. The alias formula must have a syntax that can be read by the cell. It consists of sprintf format specifications (which specify the format for the output) followed by expressions that specify event slots and functions involved in the construction of the alias. An example of a simple alias formula is
EXAMPLE
[sprintf("%s/%s", [$1.mc_object,$1.mc_host])']
The order of the sprintf format specifications corresponds to the order of the expressions, as shown in Figure 5. Figure 5 Parts of a simple alias formula
sprintf format specifications expressions
['sprintf("%s/%s",[$1.mc_object/$1.mc_host])']
40
In Figure 5, %s/%s is the data type of the output and $1.mc_object $1.mc_host are variable expressions. The first format specification, %s (a string), corresponds to the first variable expression $1.mc_object (which is the value in the mc_object slot of the event, with $1 representing the event ID). The second format specification %s (a string), corresponds to the second variable expression, $1.mc_host. Table 10 shows the event data, the alias formula, the alias that was computed from the data in the event and the alias formula, and the alias stored in the component instance, which in this example matches the computed alias from the event data. Table 10
Event
DATABASE DOWN; mc_host='dcsrv02.s tore.com'; mc_object_class='C entral Database'; mc_object='SALES'; msg='Database is down'; END
When the cell finds a match, an entry is created in the BMC_SIM_ALIAS class, as shown in this example:
EXAMPLE
BMC_SIM_ALIAS; ComponentAlias='SALES/dcsrv02.megastore.com'; ComponentID='1234'; END
The alias links the event DATABASE DOWN to the component instance with the component ID 1234.
NOTE
The BMC_SIM_ALIAS object is part of the SIM management data. It is not visible in BMC Impact Service Model Editor.
Chapter 2
41
Service schedules
EXAMPLE
[sprintf(%s,strextract($1.mc_object,1,6))] [sprintf(Mail@robot%s,strextract($1.mc_object,(len($1.mc_object)),1)] ['sprintf("%s%s%s",[$1.date,$1.mc_ueid,$1.adapter_host])']
a match for element nth has precedence over a match for element (nth + 1) for matches on the same element, precedence is based on the conditional operator in the formula, in the following order: equals, has_prefix, has_suffix, contains, any
for multiple has_prefix matches on the same element, the longest prefix wins for multiple has_suffix matches on the same element, the longest suffix wins for multiple contains matches on the same element, the longest contains wins for multiple contains matches on the same element and with the same length, the contains that has its match closer to the beginning of the string wins
Service schedules
Service schedules are a combination of a defined schedule with a specific service model component that indicates when the component must meet availability or performance goals. Each component is assigned a service schedule (but it can be a schedule shared with other components).
s
Periods when a component instance is in high demand, or when it must meet its availability and performance goals, are called During Schedule.
42
Timeframes
Periods when a component instance is in low demand, or when the components s availability and performance are less important, are called Off Schedule. Also, any undefined time is considered Off Schedule. Periods within During Schedule in which a component is considered to be Off Schedule are called Exceptions Within During Schedule.
Component attributes such as cost or base priority might have different values depending on whether the component is in high demand (a During Schedule period) or in low demand (an Off Schedule period). These priority changes are discussed in more detail in Dynamic prioritization on page 136.
Timeframes
Service schedules are built of timeframes. Timeframes are blocks of time that specify the times that are During Schedule or Exceptions Within During Schedule. Two types of timeframes exist: Global and Local.
s
Global timeframes are created in the BMC Impact Service Model Editor, stored in the BMC Atrium CMDB and are available to all cells within an environment. You create global timeframes and use them in both BMC Impact Service Model Editor and the BMC Impact Explorer. Local timeframes are stored in a single cell and are only available to the event management policies within that cell. You create local timeframes and use them only in the BMC Impact Explorer schedules editor.
Table 11 illustrates the differences between Global timeframes and Local timeframes. Table 11
Global Local
Timeframe type
Chapter 2
43
Within the During Schedule period, if the component is scheduled to be taken offline every day from noon to 1 P.M., instead of creating two different During Schedule timeframes (one for 8 A.M. to noon, and another from 1 P.M. to 5 P.M.), you could create an Exceptions Within During Schedule timeframe.
44
Chapter
This chapter presents the following topics: Role of the BMC Atrium CMDB in service modeling. . . . . . . . . . . . . . . . . . . . . . . . . . . Service model and the Common Data Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sandboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service model publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service model execution on cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . In-model and not-in-model component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing Business Time Segments from BMC Remedy AR System . . . . . . . . . . . . . 46 46 51 52 52 52 53 54 54 55
Chapter 3
45
SIM classes
BMC Impact Solutions extends the BMC Atrium CMDB CDM with a predefined set of SIM-enabled classes. The asset information you use to define the service model is a subset of all of the configuration data in the CDM. The BMC SIM CMDB Extensions also define attributes that are used only for SIM, such as StatusModel and ImpactCostPerSec.
46
All components in the data model derive from a single subclass, BMC_BaseElement and all relationships derive from the BMC_BaseRelationship subclass. All impact relationships are instances of BMC_Impact. The BMC_Impact subclass of BMC_BaseRelationship comes of the box as part of the core CDM classes for version 7.5 of the BMC Atrium CMDB CDM. The following tables list the main data subclasses to BMC_BaseElement that are associated with service impact management. For a graphical representation of the hierarchy of the Common Data Model, see the Common Data Model Diagram included with BMC Atrium CMDB documentation. Table 12 lists the SIM-qualified subclasses for BMC_Collection, which provides mechanisms for grouping components together into logical elements, including business processes and services. Table 12 SIM-qualified subclasses of BMC_Collection
Third Level BMC_ConnectivitySegment BMC_IPConnectivitySubnet BMC_IPXConnectivityNetwork BMC_LNsCollection BMC_Organization BMC_UserCommunity BMC_LAN BMC_WAN Fourth Level
Table 13 lists the SIM-qualified classes for BMC_LogicalEntity, which tracks other logical elements of a system, including people, physical plants, and location information. Table 13 SIM-qualified subclasses of BMC_LogicalEntity
Third Level BMC_BusinessProcess
Table 14 lists the SIM_qualified classes for BMC_System, which contains the definition of computer systems, mainframes, application systems, and virtual systems.
Chapter 3
47
Table 14
BMC_Cluster BMC_ComputerSystem
Table 15 lists the SIM-qualified classes for BMC_SystemComponent, which stores information on the components that comprise the system. This includes physical components like disk drives and monitors; applications like Microsoft Word; and other soft elements like network drives and file shares. The attributes for BMC_SystemComponent are SystemClassId and SystemName. Table 15 SIM-qualified subclasses of BMC_SystemComponent
Third Level BMC_ Software BMC_DiskPartition BMC_SystemResource BMC_FileSystem BMC_DataBaseStorage BMC_LocalFileSystem BMC_RemoteFileSystem BMC_CDROMDrive BMC_DiskDrive BMC_FloppyDrive BMC_TapeDrive Fourth Level BMC_SystemSoftware
HardwareSystemComponent
BMC_UPS BMC_Media
Table 16 lists the SIM-qualified classes for BMC_SystemSoftware, a continuation of the BMC_SystemSoftware entry in Table 15. Table 16
Fifth Level BMC_SystemSoftware
48
Table 17 lists the SIM-qualified class for BMC_SystemService, which tracks the services used by systems. The most common services are those used by J2EE application systems, such as J2EE modules. The data model also provides a set of classes for defining relationships among configuration items. The attributes for BMC_SystemService are SystemClassId and SystemName. Table 17 SIM-qualified subclass of BMC_SystemService
Second Level BMC_ApplicationService
Chapter 3
49
SIM attributes
SIM qualifiers have been added to the attributes listed in Table 18. Table 18
Class BMC_BaseElement
SIM-qualified attributes
Namespace BMC.CORE Attributes AccountID [SIM] Category [SIM, SME_Read, SME_ReadWrite] ClassId [SME_Read, SME_ReadWrite] CMDBRowLevelSecurity [SME_Read, SME_ReadWrite] CMDBWriteSecurity [SME_Read, SME_ReadWrite] DatasetId [SIM, SME_Read, SME_ReadWrite] Description [SIM, SME_Read, SME_ReadWrite] InstanceId [SIM, SME_Read, SME_ReadWrite] Item [SIM, SME_Read, SME_ReadWrite] ManufacturerName [SIM, SME_Read, SME_ReadWrite] MarkAsDeleted [SME_Read, SME_ReadWrite] Model [SIM, SME_Read, SME_ReadWrite] Name [SIM, SME_Read, SME_ReadWrite] Notes [SIM, SME_Read, SME_ReadWrite] OwnerContact [SIM, SME_Read, SME_ReadWrite] OwnerName [SIM, SME_Read, SME_ReadWrite] Priority [SIM, SME_Read, SME_ReadWrite] ReconciliationIdentity [SME_Read, SME_ReadWrite] ShortDescription [SIM, SME_Read, SME_ReadWrite] Type [SIM, SME_Read, SME_ReadWrite] VersionNumber [SIM, SME_Read, SME_ReadWrite] Site [SIM, SME_ReadWrite] Company [SIM, SME_ReadWrite] Department [SIM, SME_ReadWrite] Floor [SIM, SME_ReadWrite] Region [SIM, SME_ReadWrite] Room [SIM, SME_ReadWrite] SiteGroup [SIM, SME_ReadWrite] ReadSecurity [SIM] WriteSecurity [SIM] ComponentAliases [SIM, SME_ReadWrite] ImpactCostPerSec [SIM, SME_ReadWrite] ImpactCostUnit [SIM, SME_ReadWrite] ImpactCostPerSecOut [SIM, SME_ReadWrite] HomeCellAlias [SME_ReadWrite] PriorityWatchdog [SIM, SME_ReadWrite] PriorityOut [SIM, SME_ReadWrite] ScheduleId [SIM, SME_ReadWrite] StatusModel [SIM, SME_ReadWrite] ClusterType [SIM, SME_Read, SME_ReadWrite] Interconnect [SIM, SME_Read, SME_ReadWrite] InterconnectAddress [SIM, SME_Read, SME_ReadWrite] MaxNumberOfNodes [SIM, SME_Read, SME_ReadWrite] Types [SIM, SME_Read, SME_ReadWrite]
BMC.AM
BMC.SIM
BMC_Cluster
BMC.CORE
50
Sandboxes
Table 18
Class
SIM-qualified attributes
Namespace Attributes ConnectivityType [SIM, SME_Read, SME_ReadWrite] OSType [SIM, SME_Read, SME_ReadWrite] VirtualSystemType [SIM, SME_Read, SME_ReadWrite] WANType [SIM, SME_Read, SME_ReadWrite] CapabilityList [SIM, SME_Read, SME_ReadWrite] DomainName [SIM, SME_Read, SME_ReadWrite] Hostname [SIM, SME_Read, SME_ReadWrite] PrimaryCapability [SIM, SME_Read, SME_ReadWrite] SystemType [SIM, SME_Read, SME_ReadWrite] SystemClassId [SIM, SME_Read, SME_ReadWrite] SystemName [SIM, SME_Read, SME_ReadWrite] MaxMediaSize [SIM, SME_Read, SME_ReadWrite] MediaType [SIM, SME_Read, SME_ReadWrite] SystemClassId [SIM, SME_Read, SME_ReadWrite] SystemName [SIM, SME_Read, SME_ReadWrite]
BMC_ConnectivitySegm BMC.CORE ent BMC_OperatingSystem BMC_VirtualSystem BMC_WAN BMC_ComputerSystem BMC.CORE BMC.CORE BMC.CORE BMC.CORE
Sandboxes
A sandbox is a personal work area for designing and developing a service model. You can make changes to objects and their relationships, and save these changes between work sessions, without affecting the production environment until you are ready to move the changes into the production dataset. BMC Impact Service Model Editor users each have their own unique, dedicated sandbox, and sandboxes persist between user sessions, allowing you to make multiple edits to the sandbox model until you promote the changes the production dataset. Each user has one sandbox associated with the user account. Changes to your sandbox do not affect sandboxes of other users if those changes are not promoted.
NOTE
No two users should have the same data (components, impact relationships, or management data instances) in their sandbox because only the values from the sandbox that was promoted last will be in the production dataset.
Chapter 3
51
Datasets
Datasets
The production dataset is the reference dataset, or logical partition of data in the BMC Atrium CMDB, shared by SIM and ITSM applications. Objects contained in the production dataset are components, relationships, and management data. The production dataset is not limited to objects that are in-model. Many of these objects can be out-of-model (they are not yet in BMC Impact Manager cells). When working with objects in a sandbox, users are making changes to an overlay dataset, a dataset which is related to and masks the production dataset. The overlay dataset provides a view of the underlying production dataset masked by changes made by the user in the overlay dataset. Another type of dataset is the test dataset. The test dataset relays objects from a sandbox view to a test BMC Impact Manager instance.
Testing
Before moving sandbox changes into production, you can send the changes to a defined test cell and explore service model behavior in the context of various events. For example, you could send test data to a test cell, then view the generated events in BMC Impact Explorer to determine if the desired result occurs. You must have sufficient permissions to send data to a test cell. If you have promote permissions, you also have access to a test cell.
Promotion
You move changes that you make in a sandbox (on the overlay dataset) to the production dataset in a controlled process called promotion. When a promotion completes successfully, changes in the sandbox are merged with changes from other users and processes in the BMC Atrium CMDB and, if automated publishing is enabled, in-model data is sent to BMC Impact Manager cells in the environment. As soon as you successfully promote changes to a production dataset, the sandboxes of all other users are updated to reflect the new data. BMC Impact Service Model Editor limits promotion to 3000 component instances at a time.
52
After making changes in a sandbox View, you start the promotion process from the BMC Impact Service Model Editor interface. BMC Impact Service Model Editor initiates a reconciliation job. After the actual promotion process begins, you cannot work in BMC Impact Service Model Editor until the process finishes; however, you can stop the promotion or exit the BMC Impact Service Model Editor interface.
Promotion log objects are created in the BMC Atrium CMDB. The objects contain the name of the user, a short, user-specified description of the promotion, the ID of the reconciliation job, start and end dates, and a list of objects selected for promotion. BMC Impact Service Model Editor regularly checks the progress of the reconciliation job. When the process is completed, BMC Impact Service Model Editor updates the objects and indicates that the promotion is complete. When the promotion has ended, if automated publishing is enabled, the BMC Impact Publishing Server initiates a publish from the production dataset to the BMC Impact Manager cells in the environment. If other publish operations are underway at that time, the request is queued. After the changes have been published to BMC Impact Manager instances, an execution log is generated. You can view it from the BMC Impact Service Model Editor Promote and Publish History dialog box.
Chapter 3
53
The BMC.IMPACT.PROD dataset is updated and maintained only by the BMC Impact Publishing Server. It mirrors the last successful publish to the cells. Publishing can be initiated automatically by using BMC Impact Service Model Editor or manually by using the BMC Impact Publishing Server CLI publish. When the component instances and relationships are published, you can monitor the component instances by using BMC Impact Explorer and BMC Portal.
54
A component instance that is in model can be monitored in BMC Impact Explorer and BMC Impact Portal. A component instance that is not in the model cannot be monitored in BMC Impact Explorer or BMC Impact Portal.
NOTE
By default, all components are assigned to DefaultCell (the cell name provided during installation) and are set to In Model.
Chapter 3
55
56
Chapter
This chapter provides detailed procedures on how to build the service model in BMC Impact Service Model Editor. This chapter covers the following topics: Service model creation process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Launching BMC Impact Service Model Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Working with service component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Creating service component instances in BMC Impact Service Model Editor . . . 60 Switching sandbox View modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Viewing properties for a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Editing component instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Performing actions on multiple objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Copying component instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Hiding a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Deleting a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Finding component instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Defining relationships between component instances . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Creating a component relationship in BMC Impact Service Model Editor . . . . . 79 Assigning related component instances to cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Updating relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Deleting relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Associating events with a component instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Working with timeframes and service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Icons used in the service schedule and timeframes editors . . . . . . . . . . . . . . . . . . 92 Working with timeframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Working with service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Assigning components to service schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Granting access to service model objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Granting permissions to individual service model objects . . . . . . . . . . . . . . . . . . . . . 100 Testing the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Testing component relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Testing event associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Chapter 4 Building a service model in BMC Impact Service Model Editor 57
Promoting the service model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 About the publishing process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Before you promote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Submitting a promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Verifying promotion status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Modifying and deleting service model data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Organizing service component instances for monitoring . . . . . . . . . . . . . . . . . . . . . . 110 Working with BMC Impact Service Model Editor Views. . . . . . . . . . . . . . . . . . . . . . . 114 Saving, opening, renaming, and deleting Views. . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Understanding visual cues in a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Repositioning objects in a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Controlling what you see in a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Exploring consumer and provider paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Refreshing the View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Repositioning the dockable windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Showing topology views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Exporting and importing service model data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Exporting class definitions from the BMC Atrium CMDB to a cells . . . . . . . . . . . . . 124
58
find or create component instances in the BMC Atrium CMDB assign component instances to a BMC Impact Manager cell define component instance relationships associate events with component instances assign schedules to component instances promote the service model and publish objects to cells
To log on to BMC Impact Service Model Editor from BMC Portal 1 Open a browser. 2 In the Address box, enter the URL in the format https://serverName.
serverName represents the name of the server on which BMC Portal is installed.
4 On the Configure tab, in the navigation pane on left side, under Tasks, click BMC
Impact Service Model Editor. Before you can launch BMC Impact Service Model Editor to view and manage services, you must install it in one of the following ways:
s
as a stand-alone console from the BMC Portal product installation disk As a stand-alone console, BMC Impact Service Model Editor can reside on the same host computer as the BMC Portal or it can reside on another host computer. However, all user validation and security is managed by the BMC Portal server.
59
As a Java Web Start application, after BMC Impact Service Model Editor is deployed on your local desktop, you can launch it from the local desktop icon a local startup menu the Java Web Start Application Manager on your local host computer from the BMC Portal Configure tab as a task User authentication and security is managed centrally by the BMC Portal server. To launch BMC Impact Service Model Editor, you must connect to the BMC Portal.
NOTE
BMC Software recommends creating a maximum of 20,000 service model component instances for each BMC Impact Manager cell.
60
TIP
s
To free more desktop area for the View, you can hide the dockable windows by clicking the left-pointing quick-expansion arrow located along the right side of the dockable windows. You can also undock and move the Templates, Pan and Zoom, Find, Properties, Views, and Console Navigation Bar windows. See Repositioning the dockable windows on page 122.
To create a service component instance by using the menu command 1 With a sandbox View open, from the menu bar, choose Edit => Create Component.
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 In the Create Component dialog box, on the General tab, scroll in the Component
Type pane until you find the appropriate component type for the instance that you are creating.
The service component types are listed in hierarchical order, not in alphabetical order.
61
To create a service component instance by using the Template window 1 With a sandbox View open, find the appropriate service component type (class) for
the instance that you are creating in the Templates window. 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. You can change the way the list of components are presented in the Templates window by clicking the appropriate icon for List, Large Icon, and Tree layouts. The List and Large Icon layouts are sorted alphabetically (you can reverse the sort) and the Tree layout is in SIM class hierarchy order.
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. Create multiple copies of the component type at one time by holding down a number key while dragging the component icon to the View window. For example, to create eight copies of a component, hold the number 8 key while dragging the component icon. Holding down the 0 key while dragging creates ten copies. Note that holding down the 1 key while dragging creates eleven copies of the component type.
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.
62
To specify component instance attributes 1 On the General tab, perform the following steps: A In the Component Name box, replace the default name with a specific component
instance name that is meaningful to your enterprise and that you want to use as the components label in a View.
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
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.
D (optional) In the Owner section, in the Name box, enter the name of the individual
who is responsible for the component, and in the Contact box, enter a contact method, such as a phone number or email address, for the individual.
To include a component instance in the service model, select In Model; it can be published to the cell. To not include a component instance in the service model at the present time, select Not In Model; it cannot be published to the cell.
For more information about in-model and not-in-model, see In-model and notin-model component instances on page 54.
2 On the Status and Alias tab, perform the following steps: A In the Status Computation list, select a status computation model.
The default selection is Standard, which is acceptable for most component instance definitions. For more information about status computation models, see Chapter 5, Component and relationship status propagation.
63
3 On the Permissions tab, assign the proper permissions for this component instance
to each of the roles listed.
4 On the Schedule tab, perform the following steps: A Assign the appropriate service schedules information to the components.
For more information, see Assigning components to service schedules on page 99.
Yes to have the selected components propagate their self priority to their
causal components
s
5 (optional) On the Other tab, enter relevant information about the component in the
fields listed.
6 To save the component instance in the BMC Atrium CMDB (or save changes if you
used the Templates window), click OK.
64
Component Table
s s
In a View window, right-click a component instance and select Properties. Select the Properties dockable window, and in a View window, select a component instance or select a component instance and then click Properties on the Properties dockable window. On the toolbar, click the Display the properties window icon. Select a component instance and from the menu bar and choose Windows => Properties. Switch to Component Table mode . You can select columns (for this session only) by right-clicking any column heading and selecting Configure table columns.
Chapter 4 Building a service model in BMC Impact Service Model Editor 65
By default, the properties shown for a component in Component Table mode include Table 20
Type Type Name Scope Cell Owner Name Company Status Model Priority - During Schedule Priority - Off Schedule Description Reconciliation Identity
You can configure which component properties are displayed for a component in Component Table mode by right-clicking a table column heading and selecting Configure Table Columns. The default sort order is by Name. You can also change the values for a property from the Properties dockable window by clicking the appropriate Edit button. (Each section of data has its own Edit button.) For more information about changing properties of a component instance, see Editing component instances.
66
in the active View window, select the component instance to edit, or in a Table of Components view, select the component property to edit.
Right-click the component instance or property and choose Edit Component Properties from the context menu. From the menu bar, choose Edit => Edit Component Properties.
3 Make the appropriate changes. For more information about the properties of
components, see To specify component instance attributes on page 63.
4 Click OK.
2 With the mouse pointer, click and drag to draw a box around all the objects that 3 Right-click and select the action that you want to perform. To change in-model or not-in-model setting quickly
In an active View window, select the component instances, or component instances and relationships, and do use of the following methods:
s s
On the toolbar, click the add-to-model or remove-from-model Right-click and choose Add to Model or Remove from Model.
icon.
Only the object type specific to a particular action is affected and the other type is ignored. For example, selected relationships are ignored when you assign multiple objects to a cell.
67
1 In an active View window, select the component instances. 2 Right-click and choose Assign Component to Cell.
If all the component instances have the same cell, the cell name is displayed. If even one cell name is different, the Cell box is blank.
To edit multiple component instances 1 Select the appropriate component instances. See To select multiple objects on
page 67.
Right-click the component instances and choose Edit Component Properties. From the menu bar, choose Edit => Edit Component Properties.
3 In the Edit Multiple Component Properties dialog box, make the necessary
changes. The objects you selected appear in the Component List box. Changes you make will apply to every component instance in the list. If even one component instance has a different value for a property, the field is blank.
4 When you have finished making changes, take on of the following actions:
s s s
to save and exit, click OK. to save and keep the dialog box open, click Apply. to discard the changes and exit, click Cancel.
68
To copy component instances 1 Select one or more component instances that you want to copy. 2 Right-click and choose Copy. 3 Right-click and choose Paste. 4 If you are copying more than one component, in the Paste Multiple Components
dialog box, add a prefix or suffix to the original component name as needed and click OK. The default prefix is Copy of, but you can specify a prefix by entering a new value in this box.
Output Preview displays the name of one of the newly pasted component instances.
When more than one component instance is selected for copying, the name of only one of the selected component instances displays. You can replace the default prefix or suffix by changing it in the Options settings. To prevent the Paste Components dialog box from prompting you at each paste, select Do not show this dialog again. When this check box is selected, the current option is used until you change it in the Options settings. See To set copy/paste and miscellaneous options on page 154.
69
To hide a component instance 1 Select the component instances to hide. 2 To hide the component instances in the active View, take one of the following
actions:
s s
Right-click and choose Hide in This View. Choose Edit => Hide in This View.
The selected component instances are removed from the active View, but are still visible in other Views in which they have been saved. If they are part of the service model, they remain in the service model.
3 To hide the component instances in all Views, take one of the following actions:
s s
Right-click and choose Hide in All Views. Choose Edit => Hide in All Views.
The selected component instances are removed from all Views and from the service model. Data in the component instance is not modified in any way; the component instance just does not appear in any of the current Views.
Components in the BMC.ASSET (in the BMC Atrium CMDB) that are marked as deleted (MarkAsDeleted) are not visible in BMC Impact Service Model Editor. Components in your sandbox that are marked as deleted appear in BMC Impact Service Model Editor with an X icon. Components that are new in the sandbox (that have no copy in BMC.ASSET yet) are hard-deleted from the sandbox.
NOTE
If you want only to remove a component instance from your Views without deleting it permanently, use the Hide in All Views command as described in Hiding a component instance on page 69.
70
To delete a component instance 1 In a View window, select the component instances you want to delete and take one
of the following actions:
s s
Right-click the component instance and choose Delete from CMDB. from the menu bar, choose Edit => Delete from CMDB.
2 Verify that you want to delete the component instances and click Yes. 3 Choose File => Promote All Sandbox Changes. 4 Review the Objects to be Promoted area to ensure that the component instances that
you want to delete are listed.
71
Figure 6
You cannot search for relationships with the Find command, but when related component instances are found and placed in a View, their relationships are also placed in the View.
To find existing component instances 1 Launch the Find command by taking one of the following actions:
s s s
On the toolbar, click Find. From the dockable windows, click Find. From the menu bar, choose Window => Find.
2 On the Find tab, in the Component Name box, enter the name of the component
instance that you want to find. 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.
72
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 results-table 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.
8 (optional) In the results pane, select one of the instances and take any of the
following actions:
s s
To place objects in a new View window, click Open in New View. To place objects in the active View window, drag the instances into the View window or select them and click Place in Selected View.
73
When you move one instance into a View, if the object already exists in that View window, the Duplicate Component dialog box opens. To shift the View focus so that you can see the existing object, click Go to Component. If you select more than one component instance to move into view, the Go to
Component button is not available.
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).
74
Table 21 describes the additional search criteria available in Advanced Find. Table 21
Look in
Search criteria
Production Only
Test Only Component Type All list of component types (classes) Cell All Specific cell names Date Last Edited Date
User
Last Editor
Creator
75
Figure 8
In the Query Builder area, you define the attributes and specific values on which you want to base the search.
NOTE
When you search on the Aliases attribute, you must use LIKE as the relational operator, because if the component instance has more than one alias, the values are stored as a string, (for example: [dcsrvstore2.cvom, dcsrvstore3.com]).
76
To build selection criteria phrases 1 (optional) If needed, in the first list box in Query Builder, select the beginning
parenthesis. If the statement requires multiple selection criteria phrases, you might need the beginning and ending parentheses to define precedence. For example, you need the parentheses for a statement like
(phrase1 OR phrase2) AND phrase3
3 In the relational operator list box, select one from those defined in Table 22.
Table 22
= != < > <= >= LIKE
Relational operators
4 In the text box, enter the specific value that must be contained in the attribute.
The relational operator describes the relationship between the value in the attribute from step 2 and the value you specify in step 4.
And means both conditions must be met. Or means either condition must be met for the component instance to be selected.
6 (optional) If needed, in the last list box for any selection criteria phrase, select the
ending parenthesis.
77
7 (optional) To delete lines, click the Delete Line button that is directly under the line
you want to delete.
In Model (any view) Out of Model (any view) New (sandbox view) Edited (sandbox view) Production Components (sandbox view) Components With No Cell (any view) Components With Cell but Out of Model (any view)
To use smart select 1 With a View open, choose Edit=>Select. 2 Click on the appropriate attributes to select.
The component instances which match the specified attributes are selected.
78
Whenever the status of the provider instance changes, it is propagated to the connected consumer component instance. For each component instance for which you are creating relationships, you must know
s s s
whether it is a consumer or a provider for the related component its relationship state value (active or inactive) its status propagation model value (relationship policy)
After you have created relationships, test them to verify that they function in the way that you intended. See Associating events with a component instance on page 86.
drawing lines between components in the View window using the Create Relationship command
TIP
When you place components in a View, place them such that provider components are below consumer components.
To create a relationship by using draw mode 1 In the View window, on the toolbar, click
.
The default relationship direction is from provider to consumer. If necessary, you can change it to consumer to provider by clicking on the arrow next to the tool. In draw mode, the cursor changes to .
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.
79
To create relationships by using menu commands 1 In a View with component instances that need relationships defined, take one of
the following actions:
s s s
On the toolbar, click Create a new Relationship . From the menu bar, choose Edit => Create Relationship. In a View window, right-click on a component, and choose Create Relationship.
2 In the Create Relationship Properties dialog box, in the Consumer List area, click
Add.
80
Figure 9
3 In the Find window, locate the component instances that function as the consumer
in an impact relationship. For information about the Find command, see Finding component instances on page 71. You can add more than one component instance (using basic Windows selection) to either the Consumer List box or the Provider List box.
4 In the Provider List area, click Add. 5 In the Find window, locate and choose the component instance that functions as
the provider in the impact relationship. If there are multiple component instances in the Consumer List, you can add only one provider component instance; the one that is the provider for each of the component instances in the consumer list.
81
WARNING
Avoid creating circular relationships in which an component instance can propagate events to itself. For example: instance 1 > instance 2 > instance 1 again. Publishing will fail if loops (circular relationships) are created within the service model.
6 (optional) To switch the contents of the two lists (make the consumer the provider
and vice versa), click Swap List Contents.
2 Choose Edit Relationship Properties. 3 In the Edit Relationship Properties dialog box, for the Activity options, select Active
or Inactive.
s
consumer component instance. Inactivethe status of the provider component instance is not propagated to the consumer component instance.
4 In the Relationship Policy list, select one of the pre-defined status propagation
models:
s
of its provider component instance, depending on the events directly affecting the consumers status, which is also taken into account. Decreasingthe status of the consumer component instance is less critical than that of the provider component instance by one level. For example, if the provider status is WARNING, the consumer status is INFO. Increasingthe status of the consumer component instance becomes more critical than that of its provider component instance by one level. For example, if the provider status is WARNING, the consumer status is MINOR.
NOTE
BMC Impact Service Model Editor verifies that the impact relationship is associated with a valid status propagation model.
82
5 In the Status Weight box, accept the default value or enter a number for the
consumer object. (Status weight is used in the WEIGHTED_CLUSTER status computation model.)
Figure 10 shows an example sandbox View after some relationships were created. Figure 10 Drawing relationships
83
Updating relationships
First, identify the target cells that share component relationships. Next, in the cells that share relationships, make entries in each mcell.dir file to identify the other related cells. For example, you intend to publish different component instances of your model across five different cells (1, 2, 3, 4, and 5), but only three cells (1, 3, 5) share a relationship. The mcell.dir file of cell 1 should have entries identifying cells 3 and 5; the mcell.dir file of cell 3 should have entries identifying cells 1 and 5; and the mcell.dir file of cell should have entries identifying cells 1 and 3.
To assign related component instances to cells 1 In an active View window, select one or more of the component instances and do
one of the following:
s s
Right-click and choose Edit Component Properties. From the menu bar, choose Edit => Edit Component Properties.
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.
Updating relationships
You can change the properties for an existing relationship, but you cannot add or delete the consumer or provider instances, nor can you swap the consumer and provider nodes.
84
Deleting relationships
To edit one or more impact relationships 1 In the View window, do one of the following:
s
Select one or more relationship graph lines, right-click and choose Edit Relationship Properties. Select one or more relationship graph lines and from the menu bar, choose Edit => Edit Relationship Properties from the menu bar. Select one or more the relationship graph lines, set the focus on the Properties window, and click Edit.
If more than one relationship is selected, all are listed in the Edit Multiple
Relationship Properties window.
2 Enter a new value in the Activity, Relationship Policy, Status Weight, and/or
Description boxes.
for each of the boxes, values are filled in if they are the same for all relationships listed; if even one relationship has a different value in a property box, the box is blank the changes you make are applied to all relationships listed in the Edit Multiple Relationship Properties dialog box
For more information about the properties, see To specify other impact relationship attributes on page 82.
TIP
You can select multiple components and multiple relationships and then open the Edit Relationship Properties dialog box.
Deleting relationships
When you delete a relationship, the component instances remain in the service model. The relationship is recorded as to be deleted in the user sandbox and it is immediately removed from the SME View. However, prior to promoting the change, if you activate the Show/Hide Deleted Components toggle button in the toolbar, the deleted relationship can be seen in the View if you re-expand the graph. Relationships that are to be deleted are, by default, rendered in red, though this option can be changed in the Personal Options dialog.
85
When a component is deleted, all relationships referencing the component (provider and consumer) are automatically deleted to maintain the consistency of the service model.
To delete a relationship 1 In the View window, select the relationship line that you want to delete and do one
of the following:
s s
Right-click and choose Delete from CMDB. From the menu bar, choose Edit => Delete from CMDB.
2 In the confirmation window, verify that you are deleting the intended object, and
click OK.
3 Select File=>Promote All Sandbox Changes to remove the relationship from the
production model.
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.
To create an event alias association 1 From the menu bar, choose Tools =>Alias Formulas. 2 In the Event Alias Associations dialog box, click Add.
The list of existing alias event associations displays. To sort either column, click in the column heading.
86
3 In the Edit Event Alias Associations dialog box, in the Name box, enter a name for
the event association. Figure 11 Creating an alias association
4 In the Event Match Criteria area, in the Event Class box, select an event class from the
list. 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.
5 (optional) In the Match Attributes box, choose attributes and enter values to refine
which events (within the event class) will generate aliases.
87
Figure 12
For each attribute you choose, select one of the conditional operators, as described in Table 23, and enter a value in the text box to further define the events that are used to generate aliases using this formula. Table 23
Conditional operators anything
the characters you enter in the text box occur someplace in the value the value starts with the characters you enter in the text box the value ends with the characters you enter in the text box the value exactly matches the characters you enter in the text box
If you use more than one attribute, each condition must test true (the Boolean operator between the selection criteria phrases is AND) before the alias formula process is performed. For example, in Figure 13 on page 89, the search phrase would read: Hostname contains SALLOG and IP address equals 555.22.19.105. Both conditions must be true for the event to be selected for alias processing.
88
Figure 13
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 the same host name value, not the IP address. You can check with 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 Reference Guide.
89
D (optional) To change the order of the elements in the alias formula, select the part
of the formula you want to move and click the Move arrow button as appropriate.
E (optional) To delete one of the elements in the alias formula, select the part of the
formula you want to delete and click the Delete button.
7 When the alias formula is complete, click Save. Where to go from here
To continue with the creation of a service model, see Promoting the service model on page 103. To learn about editing and deleting an event alias association, and adding an alias to a component instance, continue with the next section.
To edit an event alias formula 1 Choose Tools => Alias Formulas. 2 In the Event Alias Associations dialog box, select an existing alias computing
formula.
3 Click Edit. 4 In the Edit Event Alias Association dialog box, make changes as needed.
For details about each field, see To create an event alias association starting with step 4 on page 87.
5 When your changes are complete, click OK. To delete an event alias formula 1 Choose Tools =>Alias Formulas. 2 In the Event Alias Associations dialog box, select an existing alias computing
formula.
3 Click Delete.
90
To add an alias to a component instance 1 In an active View window, select a component instance and either
s s
right-click the component instance and choose Edit Component Properties choose Edit => Edit Component Properties from the menu bar.
2 On the Status and Alias tab, click Add Alias. 3 In the Input box, enter the alias name and click OK.
Each alias you enter is listed in the Aliases box.
4 (optional) Enter additional aliases (one for each event that can potentially affect the
status of the component instance).
5 (optional) To edit an alias name, in the Aliases box, select the alias and click Edit. 6 (optional) To delete an alias, in the Aliases box, select the alias and click Delete. 7 Click OK.
Edits on this tab are not saved to the BMC Atrium CMDB until you click OK.
TIP
To search for the component instances that use a specific alias, use the Conditional Find tab in the Find dockable window. One of the attributes available in the Select list box is Aliases. You must use LIKE as the relational operator.
After service schedules are created, you can assign components to schedules in the Edit Component Properties dialog box as described in Assigning components to service schedules on page 99. Full Access, Service Administrators, and Service Managers user groups have access to the schedule editor.
Show Usages of components assigned to the selected service schedule or timeframe. Opens the Timeframe - Components and Schedule dialog box, which lists the components and schedules currently associated with the timeframe. If you are creating a new timeframe, these lists will not contain any components or schedules. Delete the selected service schedule or timeframe
92
Figure 14
Table 25 provides descriptions of the fields in the Timeframe Edit dialog box. Table 25
Name Description Usages (button)
93
Table 25
Recurrence pattern
Range of recurrence
Defines the starting and ending date range for the recurrence. Optionally, instead of choosing an end date, you can enter the number of recurrences for the timeframe.
To create or edit a timeframe 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Timeframes tab, click the New icon to
create a new timeframe or click the Edit icon to edit an existing timeframe.
3 In the Timeframe Edit dialog box, enter or modify the appropriate information in
the fields available in the Timeframe Edit dialog box. For more information about the Timeframe Edit dialog box, see Table 25, Timeframe Edit field descriptions, on page 93.
4 Click Save to save the timeframe and make it available for use in the Schedules
Editor.
To copy a timeframe 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Timeframes tab, select a timeframe to
copy.
3 Click the Copy icon. 4 In the Timeframe Edit dialog box, modify the fields for the copied timeframe as
appropriate. The copied timeframe name is appended with the prefix Copy of. For more information about the Timeframe Edit dialog box, see Table 25, Timeframe Edit field descriptions, on page 93.
5 Click Save.
94
To list the service schedules and components that are associated with a timeframe 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Timeframes tab, select a timeframe. 3 Click the Show Usages icon.
In the Timeframe - Components and Schedule dialog box is a list of the components and schedules currently associated with the timeframe. To view components associated with the selected timeframe, click the Components tab. To view service schedules containing the selected component, click the Schedules tab.
4 Click Close. To delete a timeframe 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, select one or more timeframes from the list of
timeframes.
4 Click Delete.
95
Figure 15
To create or edit a service schedule 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Schedules tab, click the New icon to
create a new service schedule or click the Edit icon to edit an existing service schedule.
3 In the Schedules Edit dialog box, enter or modify the appropriate information in
the fields, as shown in Table 26. Table 26 Schedule Edit field descriptions
Name of the service schedule being created or edited Description of the service schedule Opens the Schedules - Components Assigned to this Schedule dialog box, which lists the components and component descriptions currently associated with the selected schedule.
96
Table 26
Timeframe details
Opens the Timeframe Details dialog box listing the times, dates, and recurrence periods of the selected timeframe.
4 Click Save. To copy a service schedule 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Schedules tab, select a service schedule
from the list.
3 Click the Copy icon. 4 In the Schedule Edit dialog box, modify the fields for the copied service schedule
as appropriate. For more information about the Timeframe Edit dialog box, see Table 26, Schedule Edit field descriptions, on page 96.
5 Click Save.
97
To display the component instances that are associated with a service schedule 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Schedules tab, select a service schedule
from the list.
4 Click Close. To delete a service schedule 1 From the menu bar, choose Tools => Edit Schedules. 2 In the Schedules Editor dialog box, on the Schedules tab, select one or more service
schedules from the list.
98
To assign components to service schedules 1 Select one or more components in the active View to which you want to assign to a
service schedule.
2 Choose Edit=>Edit Component Properties. 3 On the Schedule tab, in the Schedule pane, click Select.
The Select a Schedule dialog box contains the During Schedule and Exceptions Within During Schedule timeframes. By default, components are assigned the always-in-During Service schedule (24 x 7 x 365). To choose a schedule for the components, select the schedule from the Schedules pane and click OK. To edit an schedule, select a schedule and click Edit to display the Schedules Editor. For more information about editing schedules see To create or edit a service schedule on page 96. To view what component instances are using the selected schedule, click Usages. To view the details of what times and dates are specified in a selected timeframe, click Timeframe Details.
99
4 Click OK.
Default user groups and rights for BMC Impact Service Model Editor
Rights
s s s s s s
save View create/edit component and relationship instances publish service models view publication history reinitialize to a cell import and export service model data save View create/edit component and relationship instances view publication history read only
Service Managers
s s s
100
To grant permissions to individual component instances 1 With the component instance in an open View, select the component and do one of
the following:
s s
Right-click and choose Edit Component Properties From the menu bar, choose Edit => Edit Component Properties.
2 In the Edit Component Properties dialog box, on the Permissions tab, select the
appropriate options. Figure 17 Changing access for an individual component instance
Chapter 4
101
existing data in the test environment is cleared components and relationships, including production components, as well as those in the sandbox, are sent to the test environment. Management data is also sent. if no impact relationships are visible in the selected view, or if components exist which are not part of an impact relationship, a dialog box is displayed warning the user that the test components being sent do not have impact relationships
102
To send components to a test cell 1 Choose File => Send to Test Objects in Current View.
If there are no impact relationships for the components in the current View, a warning dialog box is displayed. Choose Yes to continue, or No to stop. If there are no test cells available in the current environment, an error dialog box is displayed and the process is stopped. If the send to test is successful, a dialog box is displayed indicating that the test dataset has been populated. Management data is copied automatically to the test environment.
In automated mode, by default, publication is initiated by the completion of a reconciliation job run, such as after a promotion. In manual mode, publication is initiated from CLI commands.
Note that a successful promotion does not guarantee that the automated publication will also be successful. For more details about automated publishing, see Chapter 8, Managing BMC Impact Publishing Server.
Chapter 4
103
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.
s s
each component instance is assigned to a cell all target cells that are registered in the BMC Impact Portal are running and have a live connection with the BMC Impact Publishing Server event types are associated with component instances 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 in the BMC Impact Portal) 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).
104
Submitting a promotion
To promote all sandbox component instances and relationships 1 Start the promotion by doing one of the following:
s s s
On the toolbar, click Promote . From the menu bar, choose File => Promote All Sandbox Changes. In a View window, right-click and choose Promote All Sandbox Changes.
TIP
If promote service model options are unavailable, you may not have the permissions to promote component instances. For information on configuring user rights, see BMC Portal Getting Started.
2 In the Promotion Preview dialog box, in the Objects to be Promoted area, choose
how you want to filter the list of objects that you see. When you filter the list, it only affects what is visible, not what will be promoted. All items will be promoted. In the first Show list, choose All, Components, Relationships, Components and Relationships, or Management Data. In the second Show list, choose All Actions, New Objects, Changed Objects, or Deleted Objects. The component instances and relationships to be promoted are listed in the left pane.
Column heading
Chapter 4
105
Submitting a promotion
Table 28
Type
Column heading
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.
TIP
s
To hide either the Objects to be Promoted pane or the Comparison of New and Promoted Property Values pane, click on the quick expansion arrows (tiny black arrows) between the panes. You can compare published and newly created, changed, or deleted component instances independently of the publication process by choosing Tools => Compare Sandbox to Production.
7 (optional) To stop the promotion, in the Promotion in Progress dialog box, click
Stop.
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.
106
If the promotion and subsequent automated publication processes are successful, the service model is available to the specified cells and you can monitor the component instances in BMC Impact Portal and in BMC Impact Explorer. For troubleshooting information, see Initial source parameters on page 208.
Chapter 4
107
After you submit a promotion request, the Promotion in Progress dialog box opens automatically, enabling you to monitor the progress of the promotion request. However, promotion results dialogs only report success or failure of a promotion and do not offer information about publication status. More detailed information about each publication is available in BMC Impact Publishing Server log files. A log exists for every publish request containing detailed information as to why publication failed and can be consulted to diagnose a publication failure. All publish logs are available in BMC Impact Service Model Editor's publish history. Publish logs can be retrieved in user-friendly format via the CLI command pshowlog (see pshowlogObtaining the XML log in user-friendly format on page 281). Publish logs can also be retrieved via the CLI command plog (see plog Obtaining the XML log for a request on page 265). It is recommended that you give every promotion a unique description because promotion descriptions are found in the publication log and will make locating each publish easier. Another way to find the correct publication in the log is to use the promotion id. BMC Impact Publishing Server includes detailed messages from the different components (such as BMC Impact Portal, BMC Atrium CMDB, and BMC Impact Managers) it communicates with. To understand and troubleshoot these messages, consult the documentation of those components.
To view promotion history 1 From the menu bar, choose Tools => Promote and Publish History. 2 To view promotion details, select the Promotion tab, then select the promotion for
which you want to see details in the Promote History table area.
108
The list of recent promotions is in reverse chronological order, that is, the most recent is listed first.
To view publication history 1 From the menu bar, choose Tools => Promote and Publish History. 2 To view publication details, select the Publish tab, then select the publication for
which you want to see details in the Publication History table area. The list of recent publications is in reverse chronological order, that is, the most recent is listed first.
To view publication history details 1 From the menu bar, choose Tools => Promote and Publish History.
The list of recent publications is in reverse chronological order, that is, the most recent is listed first. By default, 100 publication log files are saved; when the 101st log is saved, the first log is deleted. All BMC Impact Publishing Server requests are counted (not only publish and initialization, but also classinfo (for example, export) requests). You can change the RequestHistorySize parameter in pserver.conf to modify the default number of logs saved.
2 To view publication details, select the Publication tab, then select the publication
for which you want to see details in the Publication History table area.
A On the Publication Details tab, review the detailed information for the
publication you selected. Failures are displayed in red. If the failure is the result of a particular component instance, the component type and component name are included. To open a View with the component instance, select the failure and click Open in New View.
B On the Publication Errors tab (available only if there were failures associated
with the selected publication), review the failure information. You can sort on any column and, if the column width limit truncates the text, the tooltip displays the complete text string.
Chapter 4
109
C In the Recommended Action area, review the action to correct the problem with
publish.
NOTE
You can replace the action recommended by BMC Software, add to it, or modify it by editing the pslog_error_solutions.properties file located in the BMC_PORTAL_KIT_HOME\appserver\websdk\tools\jboss\server\all\conf\resourc es\en_US\smsConsoleServer directory on the server running BMC Portal.
110
The Console Navigation Tree dockable window provides a flexible way of organizing your service component instances under folders that you create. The tree that you create in BMC Impact Service Model Editor is visible in BMC Impact Portal, on the Configure tab, under Properties and in BMC Impact Explorer, from the Services View, the Services Group tab. The top-level folder of the hierarchical directory is userAccount/Business, with userAccount representing the active BMC Impact Portal user account name. You create subfolders that meet the service monitoring requirements for your enterprise. Changes that are made to published service model component instances in the console navigation tree are immediately reflected in the BMC Impact Portal.
To add a folder to the console navigation tree 1 In the Console Navigation Tree dockable window, navigate to and select the folder
under which you want to create a folders. All service component folders must be created under the userAccount/Business folder (which cannot be edited or renamed). The way you organize the folders and component instances is entirely dependent on your enterprise and the way you want to monitor the component instances in BMC Impact Portal and BMC Impact Explorer.
3 In the Create New Folder dialog box, in the text box, enter the folder name. 4 Specify the permission levels for the appropriate user groups. These permissions
settings enable users to see the folder and its contents in BMC Impact Portal and BMC Impact Explorer.
5 Click OK. To rename folders 1 In the Console Navigation Tree dockable window, expand the Business folder
under the userAccount folder.
Chapter 4
111
3 On the Console Navigation Tree toolbar, click Rename Selected Folder 4 In the Rename Folder dialog box, enter the new name. 5 Click OK. To move a folder and its component instances
1 In the Console Navigation Tree dockable window, expand the Business folder
under the userAccount folder.
2 Select the folder or component instance that you want to move to another folder.
You can only move those component instances which exist directly under a folder. Components which appear as providers to other component instances in the console navigation tree cannot be moved (that would be editing the model).
3 Drag the object to the new location. To copy folders 1 In the Console Navigation Tree dockable window, expand the Business folder
under the userAccount folder.
2 Select the folder or component instance that you want to copy to another folder. 3 Control-drag the object to the new location. To define permissions for folders 1 In the Console Navigation Tree dockable window, navigate to and select the folder
for which you want to define permissions.
3 In the Edit Permissions dialog box, specify the permission level for the appropriate 4 Click OK. NOTE
Folder-level permission for the BMC Impact Service Model Editor is controlled by the BMC Portal. This means that if you create a folder in the BMC Impact Service Model Editor and assign specific access control permissions to that folder, the access control permissions from the BMC Portal override the permissions of the BMC Impact Service Model Editor.
112
To remove a folder or a component 1 In the Console Navigation Tree dockable window, expand the Business folder
under the userAccount folder.
2 Select the folder you want to remove. 3 On the Console Navigation Tree toolbar, either click Remove Folders or components
or right-click and choose Remove from the context menu.
4 In the Confirmation box, click Yes. To add a component to the console navigation tree 1 In the Console Navigation Tree dockable window, navigate to and select the folder
under which you want to add component instances.
3 In the Find window, locate and select the components to add and click Add.
For information on using the Find command, see Finding component instances on page 71. When you click Add, the component instances are automatically saved as part of the console navigation tree. You can also undock the Find window and drag component instances from the Find results pane to the console navigation tree.
4 (optional) Continue adding component instances using the Find command. NOTE
s
When you add a component instance that has providers to a folder, you can drill down and see the providers in the console navigation tree, even if they are not published. To see component instances in the BMC Impact Portal that you see in the console navigation tree, you must publish them. When you expand the tree, BMC Impact Service Model Editor checks the BMC Atrium CMDB to see if there are changes to provider component instances, and if there are changes, the tree is refreshed. These provider component instances are not saved as part of the console navigation tree.
Chapter 4
113
To add a component to the console navigation tree from a View 1 In the Console Navigation Tree dockable window, navigate to and select the folder
under which you want to add component instances.
2 In an open View, select the component instances to add and do one of the
following:
s s
Right-click and choose Add Components to Navigation Tree. On the menu bar, choose Edit => Add Components to Navigation Tree.
To open component instances in a View 1 In the Console Navigation Tree dockable window, expand the Business folder
under the userAccount folder.
2 Locate the component instances you want to open in a View. 3 Select the component instances and do one of the following:
s
To open in the current View, on the Console Navigation Tree toolbar, click
Place the selected components in current view
Right-click on the component instances and choose Open in New View or Place in Selected View.
114
Table 29
Topic
To save a View To open a saved View To rename a View To delete a View Understanding visual cues in a View Repositioning objects in a View Controlling what you see in a View Exploring consumer and provider paths Refreshing the View Repositioning the dockable windows Showing topology views
To save a View 1 In an open, active View, choose File => Save View. 2 In the View Name box, enter a unique name for the View.
The name of a saved View displays in the title bar of the View.
3 Click OK.
Chapter 4
115
To open a saved View 1 In the dockable panes area, click Views. 2 In the list of Views, locate the View you want to open and do one of the following:
s s s
Double-click on the View name. Select the View and click on the View toolbar. Right-click and choose Open View.
When you open a saved View, its component and relationship instances are verified against the definitions in the BMC Atrium CMDB. Depending on the number of objects contained in the View, this process can take some time. If any instance cannot be verified in the BMC Atrium CMDB, the View does not open.
To rename a View 1 In the dockable panes area, click Views. 2 In the list of Views, locate the View you want to rename and do one of the
following:
s s
Select the View and click on the View toolbar. Right-click and choose Rename View.
3 The selected row becomes editable; type a new name and press Enter. To delete a View 1 In the dockable panes area, click Views. 2 In the list of Views, locate the View you want to delete and do one of the following:
s s
Select the View and click on the View toolbar. Right-click and choose Delete View.
NOTE
When you delete a View, it does not affect the service model or the topology view. You are deleting only the View window, not any of the actual component or relationship instances in the BMC Atrium CMDB.
3 In the Confirm View Delete box, verify that you are deleting the correct View and
click Yes.
116
a component instance that is set to Not in Model displays the Not in Model Component icon
a component instance that has been edited is flagged with this icon in the top right corner
a newly-created component instance is flagged with this icon in the top right corner
a component that is set to be deleted becomes semitransparent and is flagged with this icon in the top right corner
outline
a component instance showing the mouseover effect that results as you drag the mouse cursor over the icon
solid background
a selected component instance has a solid background and can be moved, viewed, and edited
Chapter 4
117
To quickly move all the objects in a View, click objects as needed. To layout the objects automatically, click
on the toolbar.
You can also manually move single or multiple objects in a View as described below.
To reposition objects manually 1 In an active View, ensure that the mouse cursor is in selection mode
box around the appropriate objects. .
2 Select an object or multiple objects. To select multiple objects as a group, draw a 3 Drag the object to the desired position.
adjust the graphical view use pan and zoom to focus on specific areas of the model exploring consumer and provider paths
Toolbar button
on the toolbar, click Auto-Layout or from the menu bar, choose View => Layout Objects on the toolbar, click Fit to View or from the menu bar, choose View => Fit to View on the toolbar, choose a value in the percentage list or from the menu bar, choose View => Zoom => value
fit all objects in the View window adjust the zoom factor
s s
s s
118
Table 31
Goal
Toolbar button
Zoom Out on the toolbar, click Zoom Out or Zoom In or from the menu bar, choose View => Zoom In or View => Zoom Out Zoom In
click the magnifier icon to turn on magnifier mode left- or right-click an area of the model to magnify that area. click the topology view icon to turn on the topology view click the Component Table View icon to turn on the component table view click the Show Deleted Components icon click the Show Modifier Icons icon
view the component objects in a topology view view the component objects in component table show or hide deleted components show or hide modifier icons for each component
To use the pan and zoom tool 1 Open a View window. 2 Capture the service model view in a outlined rectangle (panner) by using one of
the following methods:
s s
From the menu bar, choose Window => Pan and Zoom. Click the Pan and Zoom dockable window.
The actions you take in the Pan and Zoom dockable window with the panner rectangle are mirrored on the service model in the View window.
3 (optional) To zoom in, position the cursor over a corner of the panner and reduce
the size of the panner. To zoom out, increase the size of the panner.
4 (optional) To resize or reposition the window, drag the panner. 5 (optional) Set the zoom percentage by adjusting the slider bar at the bottom of the
Pan and Zoom window.
Chapter 4 Building a service model in BMC Impact Service Model Editor 119
To explore consumer and provider paths 1 In an active View window, ensure that the cursor is in selection mode. 2 To explore the consumer paths, click the collapsed expansion handle at the top of
the component instance you want to explore.
3 To explore the provider paths, click the collapsed expansion handle at the bottom
of the node. If the component renditions indicate other providers in the chain, you can continue clicking the expansion handles until you reach the last provider node (identifiable because it has no expansion handle). When you click on a + expansion handle, the server is always queried and an up-todate list of consumers or providers is displayed.
120
Table 32
A component instance with expansion handles at the top and/or bottom functions as a consumer and/or provider in an impact relationship. To see the consumer (top +) or provider (bottom +) component instances, click on the expansion handle.
A component instance with two consumer or provider expansion handles indicates that there are other related component instances that are not displayed. For example, clicking on the expansion handle for Database 1 displays all its providers, in this case, Computer System 3. Computer System 3 has additional consumers as indicated by the extra + symbol at the top of the component instance icon.
Clicking the - symbol above Computer System 3 collapses all of its consumers, as shown.
Clicking on the + symbol above Computer System 3 results in the display of all consumer component instances, as shown.
On the toolbar, click Refresh . From the menu bar, choose View => Refresh.
To refresh the list of component types, from the menu bar, choose Tools => Refresh Component Types.
Chapter 4
121
Select one of the bars and drag it into the right pane of BMC Impact Service Model Editor. Right-click on the bar and choose Undock.
Click the X in the top right corner of the undocked window. Right-click in the title bar and choose Close.
To show topology 1 In an active View window, from the menu bar, choose View, and then choose one
of the following:
s s s
TIP
You can redefine the line style for each type of relationship by selecting Tools => Options. See To define line styles for relationships on page 153.
2 (optional) In the same View, choose another relationship type to view its topology. 3 (optional) To see a legend of line styles, open the Relationship Legend box by
choosing Window => Legend.
122
You cannot select a subset of this data for export. The data is exported as a series of files in XML format to a user-specified directory. You can import specified component instance definitions in XML format from another BMC Atrium CMDB dataset.
To export service model data 1 From the menu bar, choose File => Export. 2 In the Look in box, choose the directory where you want to save the file. 3 In the Directory Name box, verify that the path is correct. NOTE
In the Files of type box, do not change the file type; the files must be saved in XML format.
4 Click Export. To import service model data 1 From the menu bar, choose File => Import. 2 In the Look in box, locate the folder and select the file you want to import. 3 In the File Name box, verify the name of the file. 4 Click Import. 5 A dialog displays informing you that the import is in progress. 6 (optional) Close the dialog. The import process will continue in the background.
A notification will display when the import process is complete.
Chapter 4
123
7 To update the current View with the most recent data from the BMC Atrium
CMDB, on the toolbar, click Refresh .
8 To search for the new data, open the Find dockable window. See Finding
component instances on page 71.
For more information on pclassinfo usage, see pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB on page 249.
124
Chapter
5
125 126 128 129 129 129 130 128 130 132 132 133 133 135 136 137 146 147
This chapter contains the following topics: About component and relationship status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How component status computation works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About status computation models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Anatomy of a status computation model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Anatomy of a status computation model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The internal status NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quorum algorithm examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How status computation algorithms work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quorum algorithm examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship status propagation concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How status propagation works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status propagation models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default status propagation models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What is a valid status propagation model? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic prioritization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Self priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Impacts priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Determination of final priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
125
A status computation models primary role is to associate an algorithm with each of the status computation functions. The model can be applied to one or more component instances, enabling the cell to handle status computation appropriately for those objects. The BMC_STATUS_COMPUTATION data class is the basis of all status computation model instances. The service model provides status computation models to support the definition of key component classes.
Table 33 lists the functions, their inputs, and the type of computed status that each function calculates.
126
Table 33
Function
impact_function
self_function
consolidate_function
computed_status
All the functions return a status value in the range of the MC_SM_COMPONENT_STATUS enumeration. Only the cell maintains the real-time status of components. Component status is not reflected in the BMC Atrium CMDB. The component instances status is set to the computed_status except when you set the component to manual status, in which case, the component instances status is set to manual_status.
among the highest values propagated by a quorum of incoming active relationships. The number of active relationships that constitute a quorum correspond to the quorum value of the status model multiplied by the total number of incoming active relationships divided by 100 (rounded up to the next integer if necessary).
127
requiring an integer value. It is used in impact relationships to determine how much importance (numerically weighted) to give to each provider relationship that impacts a consumer instance. A higher numerical value indicates a greater importance.
Self-Preferred(consolidate_function) computed_status is set to the self_status value except when the self_status is NONE.
impact_function
HIGHEST_VAL AVERAGE
QUORUM
consolidate_function
HIGHEST_VAL SELF_PREFERRED
128
Table 35
Standard
Cluster
Weighted Cluster
Self-Preferred
computes the status of a component using the self-preferred algorithm for the consolidation_function
The BMC_STATUS_COMPUTATION data class is the basis of all status computation model instances. For a description of BMC_STATUS_COMPUTATION slots, see BMC_STATUS_COMPUTATION data class on page 317.
the algorithm used by each of the functions involved in status computation a no-alert status value that applies only when the consolidate_function returns NONE. The no-alert status is acceptable for all the default status computation functions. a quorum percentage that applies only when the impact_function uses the QUORUM algorithm an external algorithm that applies only when the impact_function uses the EXTERNAL placeholder
129
Function impact_function
Input value Component has no inbound relationship. Inbound relationships propagate NONE as a status.
Output value
NONE NONE NONE
self_function consolidate_function
No events are associated with the component. Impact status value is NONE and self-status value is NONE or there are no inputs.
s s
There are n providers with propagated_status different from NONE: let i be the lowest integer that is greater or equal to quorum*n/100. Consider the array of propagated_status ordered from highest to lowest status. The impact_status is the status corresponding to the element i of this array.
130
EXAMPLE
CASE A website 1 (quorum-based component status computation) host1 host2 Example A1 QUORUM=50, host1=OK, host2=IMPACTED 50*2/100 = 1 => i = 1 array = [IMPACTED, OK] The percentage of hosts that are not AVAILABLE is 50%, which breaches the quorum threshold, so the status of website 1 is IMPACTED. Example A2 QUORUM=51, host1=OK, host2=IMPACTED 1 < 51*2/100 < 2 => q = 2 array = [IMPACTED, OK] The percentage of hosts that are not AVAILABLE is 50%, which does not breach the quorum threshold, so the status of website 1 is OK. Example A3 QUORUM=51, host1=MINOR, host2=IMPACTED 1 < 51*2/100 < 2 => q=2 array = [IMPACTED, MINOR] There is indeed at least 51% of the providers (actually 100%) that state a severity at least MINOR, so the status of website 1 = MINOR
CASE B website 2 (quorum-driven, impact-based component status computation) host1 host2 host3 host4 Example B1 quorum_percent=30, host1=OK, host2=OK, host3=OK, host4=Minor 1<30*4/100<2=>q=2 array = [MINOR, OK, OK, OK] The percent of hosts that are not UNAVAILABLE is 25%, which is less than 30%, so the status of website2 is OK. Example B2 quorum_percent=30, host1=OK, host2=OK, host3=UNAVAILABLE, host4=MINOR 1 < 30*4/100 < 2 => q = 2 array = [UNAVAILABLE, MINOR, OK, OK] There is at least 30% (actually 50%) of the providers that state a severity of at least MINOR, so the status of website 2 is MINOR. Example B3 quorum_percent=60, host1=MINOR, host2=OK, host3=UNAVAILABLE, host4=UNAVAILABLE 2 < 60*4/100 < 3 => q=3 array = [UNAVAILABLE, UNAVAILABLE, MINOR, OK] There is at least 60% (actually 75%) of the providers that state a severity at least MINOR, so the status of website 2 = MINOR
131
132
When a state change on an outbound impact relationship triggers a new status propagation for that component instance, the cell combines the main status of the component with the retrieved state and the status propagation model of the relationship, and searches the propagation map of the status propagation model for a matching entry. The result is the propagated_status value that is then passed as an input to the impact_function of the consumer component.
the current state of the relationship the current value of the providers status
Status propagation models are used only by impact relationships. Status propagation models serve the following purposes:
s
relationship controlenforcement of logical rules in creating new component relationships so that only valid relationships are created dynamic status mappingtranslating the main status of the provider component into a propagated status for input into the impact_function of the consumer component in a relationship The impact_function is part of the status computation of a component. For more information, see Anatomy of a status computation model on page 129.
INCREASINGconsumer component is overly dependent on the provider. When a problem occurs, the consumers status degrades faster than the providers does DECREASINGconsumer component can function without providers services. When a problem occurs, the consumers status is less degraded than the providers
133
JUST_WARNINGpropagates the status of a provider component so that any value less than OK maps to NONE, OK maps to OK, and any value greater than OK maps to WARNING JUST_INFOpropagates the status of a provider component so that any value less than INFO maps to NONE, and any value greater or equal to INFO maps to INFO
Table 36 describes the how status propagation occurs for a specific model. Table 36 How status propagation models work in relationships
Status propagation model Relationship state Result DIRECT ACTIVE INACTIVE propagates the providers status without modification to the consumer propagation of the providers status is blocked by mapping the providers status to NONE This value is ignored by the consumer. INCREASING ACTIVE INACTIVE increases the impact of the providers status on the consumers status propagation of the providers status is blocked by mapping the providers status to NONE This value is ignored by the consumer. DECREASING ACTIVE INACTIVE decreases the impact of the providers status on the consumers status propagation of the providers status is blocked by mapping the providers status to NONE This value is ignored by the consumer. JUST_WARNING ACTIVE INACTIVE for statuses greater than OK, WARNING is propagated propagation of the providers status is blocked by mapping the providers status to NONE This value is ignored by the consumer. JUST_INFO ACTIVE for statuses greater than or equal to INFO, INFO is propagated; for statuses less than INFO, NONE is propagated propagation of the providers status is blocked by mapping the providers status to NONE This value is ignored by the consumer.
INACTIVE
134
8 instances of the data class BMC_PROPAGATION_MAP, one for each possible provider component status value for the ACTIVE state 8 instances of the data class BMC_PROPAGATION_MAP, one for each possible provider component status value for the INACTIVE state 1 instance of the BMC_STATUS_PROPAGATION data class that defines the propagation models attributes
135
Dynamic prioritization
Figure 18
and there is no other such component in the true impact path from A to B.
Dynamic prioritization
Dynamic prioritization is a system of setting the priority of a component to help you understand what problems to work on first, based on whether a component is in demand at the time (as defined in its service schedule), the severity of its status, and its impacts. The final priority of a component is determined by comparing the components self priority and impacts priority.
136
Self priority
The greater value becomes the final priority value of the component.
Self priority
Self priority is a dynamic priority that changes depending on
s s s
the status of the component the schedule status associated to the component (during or off schedule) and one of the following three methods of priority computation: s base priority (default) s cost s worst SLA state
Both the cost and the worst SLA state methods rely on the concept of down time. A component is considered down from a cost/SLA perspective when its status is greater or equal to a specified value. This value is stored in the slot status of the BMC_DOWNTIME_STATUS_CONFIG BAROC table.
NOTE
Normally, only one instance of this table should ever exist. If several instances exist, the instance with the lowest status is used.
Figure 19
137
Self priority
determined by mapping the current base priority (depending on whether the component is on or off schedule) against the status value of the component.
the During Schedule priority, which is the priority assigned to the component during the peak hours of its schedule stored in the Priority slot the Off Schedule priority, which is the priority assigned to the component during the hours that are not critical for its operation stored in the PriorityOut slot
For example, if the component is a server that supports a business that is open from 8:00AM to 6:00PM, then the higher During Schedule priority would be applied to the server during the hours that the business is open and the Off Schedule priority would be applied to the server when the business is closed (6:00PM to 8:00AM). The base priority values are static priority values that act as a baseline to determine self priority.
138
Self priority
The self-priority value of the important component is calculated based on a formula that takes into account both the base_priority value and its status value, as depicted in the BMC Impact Portal:
This mapping is configured in the match table in BMC Impact Service Model Editor.
Cost method
The cost method determines priority based on the actual cost of a component being down. Cost is a user-specified monetary value per unit of timefor example, $5.00US per second. The more money it costs for a component to be down, the higher priority that component will have.
NOTE
The cost of a component is always computed if the During/Off schedule cost values are set for that component, whether or not the cost method is used to determine the self priority of that component.
139
Self priority
When you create an instance of the BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING, you specify the cost parameter as a date type REAL as shown:
BMC_PUBLISH_DATA_CLASS : BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING ISA BMC_SIM_DATA DEFINES { name: STRING, key=yes; cost: REAL; self_priority : MC_PRIORITY, key=yes; }; END
Self_Priority_Function=COST Self_Priority_Function_Param=name of the cost of downtime priority mapping group (a mapping group is made of a varying number of BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING instances sharing the same name)
the During Schedule cost, which is the cost assigned to the component during the peak hours of its schedule. This value is stored in the ImpactCostPerSec slot. the Off Schedule cost, which is the cost assigned to the component during the hours that are not critical for its operation. This value is stored in the ImpactCostPerSecOut slot.
Depending on whether the component is in the During Schedule or Off Schedule timeframe, the cell copies one or the other of these values to the slot cost. The cost method first checks to determine if the component is down as specified by the down time definition in SIM_DOWNTIME_STATUS. If the cost status is less than the SIM_DOWNTIME_STATUS, then the component is not considered to be down, and its self priority is set the lowest priority (PRIORITY_5). Otherwise, the BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING table is used to determine the self_priority value as follows: Let c be the cost of the component and n be the name of a mapping stored in the
SelfPriorityFunctionParam slot of the component.
140
Self priority
then the self_priority of the component is set to priorityi. If there is no such instance, the self_priority of the component is set to the lowest priority (PRIORITY_5). The status enumeration values for the cost method are stored in the
SIM_DOWNTIME_STATUS_CONFIG table in the mc_sm_root.baroc file of each cell.
Figure 20
141
Self priority
This series of mapping table examples associate different cost values with corresponding self_priority values in ascending order, with 4 as the least severe and 1 as the most severe.
BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING; name=test_cost; cost=1; self_priority=PRIORITY_4; END BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING; name=test_cost; cost=2; self_priority=PRIORITY_3; END BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING; name=test_cost; cost=5; self_priority=PRIORITY_2; END BMC_COST_OF_DOWNTIME_PRIORITY_MAPPING; name=test_cost; cost=10; self_priority=PRIORITY_1; END
Based on the sample test_cost mapping table, if the status is UNAVAILABLE (or at least greater than or equal to the SIM_DOWNTIME_STATUS) then
s s
during schedule the cost is 5.0 and self_priority maps to PRIORITY_2 off schedule the cost is 1.0 and self_priority maps to PRIORITY_4
142
Self priority
The worst SLA state method determines priority based on the Service Level Agreement (SLA) for a component. Each SLA is tracked separately within a specified time period, such as daily or weekly. The SLA states are rolled up for the specified period and the worst SLA state is given priority. The rolled up SLA states are stored in the sla_rollup_status slot. Possible SLA states are:
s s s s
The SLA state for each component is assigned by BMC Service Level Management.
NOTE
The sla_rollup_status of a component is always computed if there is at least one service target associated to that component, whether or not the worst SLA method is used to determine the self priority of that component.
143
Self priority
Self_Priority_Function=WORST_SLA_STATE Self_Priority_Function_Param=name of the worst SLA state priority mapping group (a mapping group is made up of a varying number of BMC_WORST_SLA_STATE_PRIORITY_MAPPING instances sharing the same name)
then the self_priority of the component is set to p. If there is no such instance, the self_priority of the component is set to the lowest priority (PRIORITY_5). The status enumeration values for the worst SLA state method are stored in the
SIM_DOWNTIME_STATUS_CONFIG table in the mc_sm_root.baroc file of each cell.
144
Self priority
Figure 21
145
Impacts priority
In this example, the Self_Priority_Function of the component definition is set equal to WORST_SLA_STATE and the name of the mapping value is test_sla.
BMC_System; mc_udid=compx; Name=compx; SelfPriorityFunction=WORST_SLA_STATE; SelfPriorityFunctionParam=test_sla PriorityWatchdog=YES; END
Impacts priority
The impacts priority of a component reflects the urgency of resolving a problem based on the components it impacts. The impacts priority is based on the components it is impacting that are marked as
priority propagators. A component which is a priority propagator can be considered an
important component in that a priority propagator sends its self priority value back to its causal component, which can have the result that the causal components problem is considered a more urgent problem than it would have been otherwise. Thus, the impacts priority is a dynamic value which changes as the self-priorities of the impacted components change. Figure 22 Impacts priority determination
146
147
Figure 23
148
NOTE
If the cost and sla_rollup_status data are available for an important service component, then these values are always propagated downward to the impact_cost and impact_sla_rollup_status slots of its causal component(s), even if the corresponding cost or worst SLA method is not used to determine the self priority of that important service component.
149
150
Chapter
Service Management administration is performed in large part within BMC Impact Service Model Editor and its supporting data classes, with some administration also being done in the BMC Impact Portal. Administration includes managing all user access to information contained in the service model. Access control is managed in the service model through individual component instances. Each component has a ReadSecurity and WriteSecurity set of attributes, and each attribute can be associated with a user group that can be assigned either read or write access to a component. Additional user control functions in BMC Impact Service Model Editor include console navigation trees, which impose a structure on the organization of service management information, control folder-level rights, and pass this information to the BMC Impact Portal. This chapter includes the following topics: Setting BMC Impact Service Model Editor options . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the topology view in BMC Impact Service Model Editor . . . . . . . . . . . Configuring the topology view in BMC Impact Service Model Editor . . . . . . . . . . . Adding new classes to the BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Making your changes visible to applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a new service model component class in the BMC Atrium CMDB . . . Associating a custom icon with a service model component . . . . . . . . . . . . . . . . Documenting your extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . smeserver properties file and parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 156 156 157 157 159 159 163 163
Chapter 6
151
Personal options
Personal options settings are unique to the user. The values specified here are specific to the user and are reapplied when the user logs into BMC Impact Service Model Editor on any computer. The options settings are saved on BMC Impact Service Model Editor server. Options that you can change include icon colors and label styles, line styles, regional preferences, View appearance, copy/paste settings, and log file preferences. All personal options are available by choosing Tools => Personal Options.
To define component instance icon colors and label styles 1 From the menu bar, choose Tools => Personal Options. 2 On the Components tab, in the Component icon area, choose a drawing mode.
Drawing mode affects how the component instance looks when it is being moved.
s s
Ghost results in a simple rectangular border. Opaque results in the component being fully drawn.
3 In the Selection Background Color list, choose a background color for the
component instance icon when the component instance is selected.
4 In the Active Border Color list, choose a color for the border of the component
instance icon when the mouse cursor is over it.
choose a font, type size, color, and style for the label that names the component instance icon. in the Maximum Number of Characters to Display box, choose a number that limits the number of characters to display for component instance name labels. If a component name is longer that the maximum number of characters, the name is truncated. This value applies to every component instance in every View.
152
To define line styles for relationships 1 From the menu bar, choose Tools => Personal Options. 2 On the Relationships tab, in the Relationship Type pane, select the relationship type
that you want to change.
3 In the Line Color list, choose a predefined color or set a custom color for the line. 4 In Line Style list, select one of the predefined line styles or create a custom line
style. To create a custom line style, enter numbers separated by commas, which alternately define the length of the visible/invisible line segments. For example: 9,3,1,3 creates a repeating line pattern with 9 solid units, 3 invisible units, 1 solid unit, and 3 invisible units.
5 In the Line Weight list, choose a predefined line weight or define a custom line
weight by entering a decimal number (between 0.01 and 5.0) that defines the width of the line. For example, a weight of 2.0 creates a line that is twice as thick as one with a weight of 1.0.
TIP
When a View is open, you can see a legend of line styles by choosing Window => Legend.
To set regional preferences 1 From the menu bar, choose Tools => Personal Options. 2 On the Regional Settings tab, in the Locale area, choose the option that works best in
your environment. The Use Country/Region Specified in BMC Portal User Account option uses the locale specified when BMC Portal was registered as a user.
3 In the Date Format and Time Format areas, choose a format for each.
For the Time Format, the Long and Full options appear the same in English, but may be different in other languages.
Chapter 6
153
To set View appearance options 1 From the menu bar, choose Tools => Personal Options. 2 On the Appearance tab, in the Production/Sandbox View Background Color list,
choose a color for the production and sandbox View background.
3 In the Test View Background Color list, choose a color for the test View background. 4 In the Desktop Background Color list, choose a color for the right pane of BMC
Impact Service Model Editor before a View is opened.
clear this check box to not see tooltips, or enter values (in milliseconds) for the Initial Delay, Dismiss Delay, and Reshow Delay.
6 For the Show Embedded Help Text check box, clear this check box to not display
paragraph-style instances of Help text that appear in some dialog boxes.
To set copy/paste and miscellaneous options 1 From the menu bar, choose Tools => Personal Options. 2 On the Other tab, in the Copy/Paste area, select the appropriate copy/paste options
for renaming copied component instances. This tab also controls the Paste Multiple Components dialog box; see To copy component instances on page 69.
3 In the Miscellaneous area, for the Load Saved Views at Login check box, options are
defined as follows:
s
check box selected: data for all Views is loaded into memory when you log into BMC Impact Service Model Editor check box cleared: data for a View is loaded into memory only when you open that specific View.
4 For the Use Live Server Data During Selection check box, options are defined as
follows:
s
check box selected: as each component is selected in the View, the data is retrieved again from the BMC Atrium CMDB. check box cleared: data for all the components in a View is retrieved from the BMC Atrium CMDB when the View is opened. Data for an individual component may become outdated.
154
NOTE
Whichever setting is selected, when you open the Edit Component or Edit Relationship dialog boxes, the latest information is always retrieved from the BMC Atrium CMDB.
5 For the Show Duplicate Component Dialog checkbox, the dialog box displays when
you use the Find command and want to place found objects in a View (by dragging or clicking Place in Selected View) that already has contains the objects:
s s
checkbox selected: dialog box displays checkbox cleared: dialog box does not display; there is no alert that you are duplicating objects in the View
To set log file preferences 1 From the menu bar, choose Tools => Personal Options. 2 In the Logging tab, set the level of log information you need on the client computer.
Logging becomes more detailed as you go from the top of column one to the bottom of column one, then to the top of column two to the bottom of column two. The most detailed log selection is All. The more detailed the log is, the more disk space is used.
3 In the Buffer Size box, enter the maximum number of log messages you want to
save in memory. This is a first in, first out buffer; when the maximum number of messages is reached, the oldest message is deleted when a new one is added.
4 In the Log Files area, select options for saving log files on the client computer.
You can specify a directory to save the files in, but the file name bmc_sme_integer_log# is generated by BMC Impact Service Model Editor. The first file saved is numbered 0; subsequent logs increment by one. When the number of log files saved reaches the value in the Number of Log Files box, the count starts again at zero and the existing files with the same name are written over.
Global options
To set component instance self-priorities when in a given status, select Tools => Options => Global Options.
Chapter 6
155
For more information on Service Schedules, see Service schedules on page 42.
NOTE
If you change the self-priority of the component for an Other status, the self-priority values are automatically changed for the statuses of INFO, UNKNOWN, and BLACKOUT.
To edit service schedule self-priorities 1 In the Options - Global dialog box, in the Base Priority/Status table, select the
appropriate status level (1-5) for each base priority/status level.
2 In the Impacts Priority Calculation Method, choose the calculation method for the
component.
3 In the Default Component Types that Propagate Priority box, enter the classes of
components that will have a default value of Propagate Priority=Yes. Separate the class names by commas.
com.bmc.sms.sme.topoviews=com.bmc.sms.sme.topo.application,com.bmc.sms.sme.topo. non.impact
It is a resource key to a localized name (that can appear in the user interface). The localized name is defined in the sme_messages.properties file for the appropriate locale. It is the base key for the definition of the topology view.
156
Each base key is appended with an integer (for as many as needed) that defines a graph to traverse for the topology view. The general format of a graph definition is shown in Figure 25. Figure 25 Graph definition format
<ComponentType>.<RelationshipType>.<ComponentType>
For example, for a graph type whose key is com.bmc.sms.sme.topo.application, the following graph entries could be defined as shown in Figure 26. Figure 26 Example of a graph definition
com.bmc.sms.sme.topo.application.1=BMC_BaseElement.BMC_Component.BMC_BaseElement com.bmc.sms.sme.topo.application.2=BMC_BaseElement.BMC_MemberOf.BMC_BaseElement
A graph definition can include as many types as desired, but it must always begin and end with a component type. For example:
BMC_BaseElement.BMC_Impact.BMC_BaseElement
Chapter 6
157
s s
Classes with the custom qualifier 100050 are SIM-enabled classes. Instances with this property are pushed by the BMC Impact Publishing Server to the cells. SIM-enabled class definitions in the BMC Atrium CMDB and the class definitions in the BMC Impact Manager cell must match. For more information, see Exporting class definitions from the BMC Atrium CMDB to a cells on page 124. For your new class to be a service model component class, not only does the new class need to be SIM-enabled (having the class custom qualifier value of 100050), its superclasses, whether concrete or abstract, up to the root class (such as BMC:BaseElement, BMC:BaseRelationship) must be SIM-enabled as well. BMC Impact Service Model Editor filters out abstract classes. The new class inherits the attributes of its superclass.
SIM-enabled attributes have the custom qualifier 300050. BMC Impact Publishing Server pushes attribute values to the cells.
Perform the following steps to update BMC Impact Solutions to use new classes and attributes:
1 Using the Class Manager, add these custom qualifiers to the new classes and
attributes:
s
For instructions on this step, see Creating a new service model component class in the BMC Atrium CMDB on page 159.
3 From BMC Impact Service Model Editor, export cell metadata, import the resulting
file into the cells Knowledge Base, and recompile the cell. For instructions on this step, see Exporting and importing service model data on page 123 and BMC Impact Solutions Knowledge Base Development Reference Guide.
158 BMC Impact Solutions Service Modeling and Publishing Guide
Creating a new service model component class in the BMC Atrium CMDB
Creating a new service model component class in the BMC Atrium CMDB
This section contains steps for creating a new service model component class.
To create a new service model component class in the BMC Atrium CMDB 1 Use the BMC Atrium CMDB Class Manager to create a new CI class. For
instructions, see Modifying the Data Model in the BMC Atrium CMDB 2.0.1 Installation and Configuration Guide.
3 Select the service model component superclass to which you want to assign the
new service model component class. SIM-enabled classes are listed in Service model and the Common Data Model on page 46.
4 Specify the Custom Qualifier 1\100050\2\1\ in the General tab. 5 Click Save.
All superclasses of a SIM class, up to BMC_BaseElement, need to be SIM classes, regardless if they are abstract or concrete.
NOTE
Icons must be in .gif format. However, you can use icons in .png file format if you rename the file extension from .png to .gif.
Chapter 6
159
When you create a new component type by adding a new class to the BMC Atrium CMDB, associate an icon with the new component.
1 Create a new class in the BMC Atrium CMDB. For instructions, see Adding new
classes to the BMC Atrium CMDB on page 157.
2 Create a set of the three different-sized icons for the new class, and save them
using the file naming convention className_size.ext. See Guidelines for associating a custom icon with a service model component class on page 161.
3 Store an identical set of the three icon fileseach file in the set designating a
different pixel sizeunder each of the three specified subfolders on the system where the BMC Portal application server is running. See Guidelines for associating a custom icon with a service model component class on page 161.
4 Associate the icon with the service model component class by performing the
following actions:
Solaris
%BMC_Portal_Kit_Home%\appserver\websdk\tools\jboss\server\all\conf\pr operties\smsConsoleServer\
Windows
%BMC_Portal_Kit_Home%\appserver\websdk\tools\jboss\server\all\conf\pr operties\smsConsoleServer\
C Save the component_icon.properties file. 5 Restart the BMC Impact Administration Server.
160
6 Restart the BMC Portal application server and all BMC Impact Service Model
Editor client instances.
7 Refresh BMC Impact Service Model Editor templates by using Tools => Refresh
Component Types.
8 Synchronize the new service model class definitions with the SIM KB. For
instructions see Exporting and importing service model data on page 123.
9 Create the new class definition in BAROC format by using Tools => Export Cell
Meta Data. The file that is created is named mc_sm_object.baroc.
After you convert the class definition to BAROC format, you make it available to the SIM KB of the target cell or cells.
10 Manually copy the mc_sm_object.baroc file to the destination directory of the target
cell or cells. By default, the mc_sm_object.baroc file is located in the following directory path:
s
Solaris$MCELL_HOME/etc/CellName/kb/classes Windows%MCELL_HOME%\etc\CellName\kb\classes
11 Recompile each cells KB by using the command: mccomp- -n cellname 12 Restart the cell or cells. Guidelines for associating a custom icon with a service model component class
Follow these guidelines when adding and associating custom icons with service model component classes:
s
BMC Impact Service Model Editor and BMC Impact Portal accept three sets of pixel sizes for the component icons: 16 x 16, 32 x 32, and 128 x 128. For each custom class that you create, you must include three sets of identical icons, each set using the three different pixel sizes: 16 x 16, 32 x 32, and 128 x 128. Use .gif format only. For example, set one contains three identical icons of 16 x 16, 32 x 32, and 128 x 128 pixels; set two contains the same three icons of 16 x 16, 32 x 32, and 128 x 128 pixels, and so forth.
Name each custom icon using the same name as the custom class it represents. Follow this naming convention:
Chapter 6
161
className_size.gif
className is the name of the custom class you created. size refers to the pixel sizes 16, 32, and 128. gif is the file extension and is required. For example, if you created a custom class named BMC_ABCServer, you would create three corresponding custom icons named as follows: BMC_ABCServer_16.gif BMC_ABCServer_32.gif BMC_ABCServer_128.gif
s
Save a set of the three different-sized custom icons to the following subdirectory under the BMC_Portal_Kit_Home installation directory. You can find this directory on the system where the BMC Portal application server is installed. On Windows, the directory is located as follows: %BMC_Portal_Kit_Home%\appserver\websdk\tools\jboss\server\all\modules\
smsConsoleServer.sar\smsConsoleServer.war\images\objects
NOTE
If the objects subdirectory is missing, create it, and then move all the files in the images directory to the new objects subdirectory.
By saving an identical set of the three different-sized icon files to the subdirectory, you are making them available to both BMC Impact Service Model Editor, BMC Impact Portal, and BMC Impact Explorer Services View.
162
smeserver.properties file
smeserver.properties BMC_PORTAL_KIT_HOME/appserver/webskd/tools/jboss/server/all/conf/properties/smsS me contains all the user configurable BMC Impact Service Model Editor properties Description sets whether the precache applet is run to request component types from the BMC Atrium CMDB if defined, sets the number (integer) of component instances retrieved as a result of the Find command sets the temp directory of the BMC Impact Service Model Editor server Default value true
Parameter name
com.bmc.sms.sme.server. cmdbservice.precache. componenttypes com.bmc.sms.sme.server. cmdb.find.result.limit com.bmc.sms.sme.server. tmpdir
undefined; no limit undefined; default temp directory is JBOSS_HOME/ server/all/tmp/ sme ps_requests ps_response ps_notifications
sets the name for the BMC Impact Publishing Server request queue sets the name for the BMC Impact Publishing Server response queue sets the name for the BMC Impact Publishing Server notification topic
Chapter 6
163
Table 37
smeserver.properties file
sets the Java Management Extensions (JMX) name for com.bmc.sms. the publishing controller component of the BMC Impact sme.server: Publishing Server name= PublishService Controller defines the JMX name of the last successful Publishing Manager com.bmc.sms. consoleserver: name=LastPubli shManager 60 seconds
com.bmc.sms.sme.server. publish.controller.name
com.bmc.sms.sme.lsp.manager
sets the timeout value (the number of seconds to wait) for reception of BMC Impact Publishing Server responses sets the timeout value (the number of seconds to wait) for reception of BMC Impact Publishing Server extended responses
3600 seconds
com.bmc.sms.sme.server.promot sets the timeout, in seconds, for the Reconciliation ion.timeout Engine to reconcile objects into production com.bmc.sms.sme.server.promot sets the amount of time to wait before checking the ion.wait.time status on a reconciliation job
com.bmc.sms.sme.publish. preview.enable com.bmc.sms.sme.date.format com.bmc.sms.sme.server. export.datasetid com.bmc.sms.sme.cmdb.ping com.bmc.sms.sme.localized. classes.dir
3600000 seconds 1000 seconds true HH:mm:ss z MM/dd/yyyy BMC.ASSET 60 seconds smsConsoleServ er
enables (true) or disables (false) publishing previews sets the date format for the BMC Impact Service Model Editor defines the dataset (using dataset ID) to use for service model exports sets the polling interval, in seconds, for pinging the BMC Atrium CMDB to ensure that it is available defines the base directory used under SDK_HOME/tools/jboss/server/all/ conf/resources/locale/classesdir to retrieve localized server resources for class names and attributes
164
Table 37
smeserver.properties file
lists the names of property files that contain localized classes and attributes. You can define custom files and add them to the list. The files are loaded in the order listed and the files loaded later override settings in files loaded earlier. The files listed must exist in the SDK_HOME/tools/jboss/server/all/ conf/resources/locale/classesdir kb_deprecated_ resource. properties,kb_co re_resource. properties
com.bmc.sms.sme.kb.info. resources
com.bmc.sms.sme.topoviews
defines a comma-delimited list of supported topology views. Each element in the list has two functions:
s
See smeserver. properties file for current It is a resource key for a localized name (suitable for default values. the UI). It is the base key for the definition of the topology view. Each key is appended with an integer (for as many as needed) that defines a graph to traverse for the topology view.
If you edit any of these configuration files manually, you must restart the BMC Portal service or daemon for the changes to take effect. If you have edited any of the BMC Impact Publishing Server configuration files, you must restart the BMC Impact Publishing Server service or daemon also.
Chapter 6
165
166
Chapter
7
168 168 168 168 169 172 172 172
This chapter covers the following topics: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Atrium and non-Atrium environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the integration with HP OVO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Importing HP OVO data to create a service model . . . . . . . . . . . . . . . . . . . . . . . . . . . High-level data flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Steps to import HP OVO data to create a service model. . . . . . . . . . . . . . . . . . . .
Chapter 7
167
Overview
Overview
The BMC Impact Service Model Integration with HP OpenView Operations (OVO) provides a mechanism to import an HP OVO node hierarchy and automatically create a service model view of the hierarchy. From the Administration tab of the BMC Impact Explorer, you can create an HP OVO service model view on demand or at scheduled intervals. The integration with HP OVO automatically publishes the service model either directly to a BEM or SIM cell in a non-Atrium environment or to the BMC Atrium CMDB for reconciliation before passing the data to a SIM cell.
Installation
The integration with HP OVO is installed as an option of the BMC Impact Solutions installation program. After selecting the integration with HP OVO and completing the remainder of the installation process, the installation program installs the integration in the MCELL_HOME directory. If you plan to use an Atrium environment, the integration with HP OVO requires a BMC Atrium CMDB dataset and reconciliation rules. The dataset and rules are installed as part of the SIM CMDB extensions.
168
Configuration
During the installation process, an adapter cell is installed as part of the integration with HP OVO. This adapter cell contains processing rules and handles communication between HP OVO and the Publishing Server. The adapter cell is automatically registered with the Impact Administration Cell (IAC) if the two components are installed on the same computer. The registered adapter cell is displayed under the ADAP_Cell group in the navigation pane of the Infrastructure Management tab of the Administrator view of BMC Impact Explorer, as shown in Figure 28. Figure 28 Adapter cell group
Configuration
If you install the adapter cell on the same computer as the Impact Administration Cell (IAC) and the Publishing Server, no configuration is necessary; the adapter cell is automatically registered with the IAC. If you install the adapter cell on a different computer as the IAC, you must add an entry for the IAC in the mcell.dir file of the adapter cell and then restart the adapter cell to recognize the entry.
Chapter 7
169
Configuration
If you install the adapter cell on a different computer than the Publishing Server, you must add an adapter cell entry in the mcell.dir file in the MCELL_HOME/etc/ directory on the computer where the Publishing Server is installed and then restart the Publishing Server.
NOTE
The adapter cell does not support high availability. Do not attempt to configure an adapter cell to run in a high availability environment.
Before you attempt to import HP OVO data, you must configure the /etc/profile environment variables. For example (the values you set for your variables depend on your installation):
ORACLE_HOME=/usr/oracle/product/10.2.0.1; export ORACLE_HOME ORACLE_SID=openview export ORACLE_SID ORACLE_BASE=/usr/oracle; export ORACLE_BASE TNS_ADMIN=/usr/oracle/product/10.2.0.1/network/admin; export TNS_ADMIN PATH=$ORACLE_HOME/bin: export PATH
The configuration files, listed in Table 38, reside in the MCELL_HOME/etc/ directory. Table 38
File ovcifetcher.conf ovcifetcher.map ovcifetcher.pass
To set the HP OVO administrator password 1 Click the Infrastructure Management tab of the Administrator view of BMC
Impact Explorer.
2 Navigate to the adapter cell. 3 Right-click on the adapter cell and choose Actions => OVO Adapter => Set OVO
User/Password.
Configuration
To use BMC Atrium CMDB version 7.5, uncomment the following line:
#$DoMap(SetTypeItemForCMDB75Map)
These values must match the corresponding values in the Remedy ITSM Product Company Relationship form. These values are customizable, so if you make changes to any of the values, the changes must be made in both the map file and the Product Company Relationship form.
Chapter 7
171
1 A user initiates or schedules a fetch remote action, for example, Fetch Node Group,
against the adapter cell.
2 A fetch routine retrieves the requested node group data from HP OVO and passes
that data to the adapter cell for CI de-duplication and creation of CIs and relationships, if necessary.
3 The adapter cell passes the data to the publishing server. 4 In non-Atrium scenarios, the Publishing Server publishes the service model data
directly to a cell.
5 For Atrium-enabled scenarios, the Publishing Server first sends the service model
data to the BMC Atrium CMDB for reconciliation before the final service model data is published to the cell.
NOTE
After a service model has been created by importing HP OVO data, any subsequent changes made in the Service Model Editor take precedence over subsequent changes made in the HP OVO interface if those changes are for the same attributes.
172
To import HP OVO data to create a service model 1 Click the Infrastructure Management tab of the Administrator view of BMC
Impact Explorer.
2 Navigate to the adapter cell. 3 Right-click on the adapter cell and choose Actions => OVO Adapter => Fetch From
OVO.
6 Click OK.
Depending on the number of CIs to retrieve, the fetch process can take several minutes to execute. As the fetch process continues, a dialog box appears that provides the status of the process.
8 Navigate to the Services view of BMC Impact Explorer. 9 If not already selected, select the cell to which the service model is published. 10 In the Results window in the Find Service Components navigation area, choose the
retrieved group or node bank to display the new service model. If the group or node bank does not yet appear, the publish process might not be complete.
Chapter 7
173
In this example, the fetcher runs once at 2:09 p.m. every day of the month except Saturday and Sunday.
174
Chapter
After you create a service model, the service model data must be delivered from the BMC Atrium CMDB or the pposter source files to the cells. The process of distributing SIM data from the source to the cells is managed and controlled by the BMC Impact Publishing Server component of BMC Impact Solutions. This chapter provides information on managing the BMC Impact Publishing Server and contains these topics: Working with publication logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing publication history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing publication history details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sharing a single log directory between two Publishing Servers. . . . . . . . . . . . . . . . . Specifying a port for Service Model Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . High availability and BMC Impact Publishing Server . . . . . . . . . . . . . . . . . . . . . . . . . Monitoring BMC Impact Publishing Server with BMC Impact Manager events. . . Modifying the generation of events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Understanding classes and slots for BMC Impact Publishing Server events . . . About SIM management data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Understanding publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Publishing to a BEM cell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About home cell, home cell alias, and cell alias . . . . . . . . . . . . . . . . . . . . . . . . . . . Publishing from the BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enabling AtriumCMDB Publish publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using BMC Impact Service Model Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating advanced publish environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Examples of advanced environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining BMC Atrium CMDB classes for SIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining BMC Atrium CMDB attributes for SIM . . . . . . . . . . . . . . . . . . . . . . . . . . ServiceModelSet attribute for components and management data . . . . . . . . . . . ServiceModelSet attribute for impact relationships . . . . . . . . . . . . . . . . . . . . . . . . Initializing the BMC Atrium CMDB with SIM data. . . . . . . . . . . . . . . . . . . . . . . . Initializing a cell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 8 Managing BMC Impact Publishing Server
177 177 178 179 180 180 181 181 183 191 192 192 194 193 194 195 195 199 200 202 202 203 204 205 209
175
Examplecreating SIM data in BMC Atrium CMDB from BAROC files . . . . . . 211 Purging and deleting service model objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 Publishing in automated or manual mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 Publishing from a Direct Publish source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 About home cell and cell alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 About class and slot data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 Enabling Direct Publish publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 Creating an environment for component instances and relationships . . . . . . . . 219 Modifying home cell and cell aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 Initializing a cell from a Direct Publish environment. . . . . . . . . . . . . . . . . . . . . . . 220 Examplesusing cell aliases for Direct Publish publishing . . . . . . . . . . . . . . . . . 220 Securing publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 pserver.conf file and parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 Configuring the Notify ARDBC plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Configuring the Notify plug-in for AR server groups . . . . . . . . . . . . . . . . . . . . . . . . . 231
176
After you submit a promotion request in BMC Impact Service Model Editor, the promotion results dialog box reports only the success or failure of a promotion. It does not offer information about publication status. Detailed information about each publication is available in the request log files. A request log file exists for every publish request containing detailed information as to why publication failed and must be consulted to diagnose a publication failure. All request logs are available in BMC Impact Service Model Editor's publish history. Publish logs can also be retrieved by using the CLI command plog -s <requestId> | plogdisplay -@ (see plogObtaining the XML log for a request on page 265). BMC recommends that you give every promotion a unique description because that makes it easier to locate a specific publish in the BMC Impact Service Model Editors publish history. Another way to find the correct publication in the publish history is to use the promotion ID. BMC Impact Publishing Server includes detailed messages from the different products it communicates with (such as BMC Impact Portal, BMC Atrium CMDB, and BMC Impact Managers). To understand and troubleshoot these messages, consult the documentation of the product.
To view publication history 1 From the menu bar, choose Tools => Promote and Publish History. 2 To view publication details, select the Publish tab, then select the publication for
which you want to see details in the Publication History table area. The list of recent publications is in reverse chronological order, that is, the most recent is listed first.
177
To view publication history details 1 From the menu bar, choose Tools => Promote and Publish History.
The list of recent publications is in reverse chronological order, that is, the most recent is listed first. By default, 100 publication log files are saved; when the 101st log is saved, the first log is deleted. All BMC Impact Publishing Server requests are counted (not only publish and initialization, but also classinfo (for example, export) requests). You can change the RequestHistorySize parameter in pserver.conf to modify the default number of logs saved.
2 To view publication details, select the Publication tab, then select the publication
for which you want to see details in the Publication History table area.
A On the Publication Details tab, review the detailed information for the
publication you selected. Failures are displayed in red. If the failure is the result of a particular component instance, the component type and component name are included. To open a View with the component instance, select the failure and click Open in New View.
B On the Publication Errors tab (available only if there were failures associated
with the selected publication), review the failure information. You can sort on any column and, if the column width limit truncates the text, the tooltip displays the complete text string.
C In the Recommended Action area, review the action to correct the problem with
publish.
NOTE
You can replace the action recommended by BMC Software, add to it, or modify it by editing the pslog_error_solutions.properties file located in the BMC_PORTAL_KIT_HOME\appserver\websdk\tools\jboss\server\all\conf\resourc es\en_US\smsConsoleServer directory on the server running BMC Portal.
3 Click Close.
178
1 Uninstall the Publishing Server for which you want to change the name. Perform
the uninstallation using uninstall_pserver_service.cmd for Windows or uninstall_pserver_service.sh for UNIX. These commands are available from the <MCELL_HOME>/bin directory.
an NFS path name to specify the directory. For more information about the pserver.conf file, see pserver.conf file and parameters on page 224.
5 Update the SystemLogDirName attribute for the other Publishing Server, giving it
the same shared log directory.
6 In the pserver.conf file make sure that the directory path mentioned before
SystemLogDirName is accessible. When you specify the path for the SystemLogDirName, you must use an NFS path.
NOTE
If the log directory is remote and the Publishing Server runs as a service, then the service must not log on as a "Local System account", which is the default logon. If the service is allowed to log on using the default, the account has no access to the remote directory. The service must log on as an account with access to the remote directory.
179
180
Monitoring BMC Impact Publishing Server with BMC Impact Manager events
Monitoring BMC Impact Publishing Server with BMC Impact Manager events
This section describes how to monitor the BMC Impact Publishing Server using BMC Impact Manager events. By default, the BMC Impact Publishing Server sends event information to the Impact Administration Cell (IAC). Users with Full Access and Service Administrator access can monitor the status of BMC Impact Publishing Server in BMC Impact Explorer on the Impact Administration Cell subtab. For the request, connection, and error events, see the Events tab. For more information about Impact Administration Cells, see BMC Impact Solutions Infrastructure Administration Guide. You can view all generated events in BMC IX on the Events tab in the collector "By Location - System - Publishing Server". Also, the IAC creates ADMIN_EVENTs for the control events of BMC Impact Publishing Server, so you can view the status of the BMC Impact Publishing Server in the Infrastructure Management view of BMC IX. If automated AtriumCMDB Publishing is enabled, you should monitor the publish requests to find publication failures.
181
Table 39
Type of event
BMC Impact controlstatus events generated when BMC Impact Publishing Server Publishing Server starts or started stops in a controlled way serverName connectionevents connection failure. generated when the BMC Impact Publishing Server makes a connection with one of its surrounding components requestevents generated for every publish and classinfo request that is processed by Publishing Server errorevents that indicate there is a problem with the correct functioning of the BMC Impact Publishing Server Class validation request failed.
To modify the generation of events 1 In the pserver.conf file, set the IPSEventsIM parameter to the name of the cell that
will receive the events. In the example, events are sent to the cell named cell.Admin (default Impact Administration Cell).
EXAMPLE
In the relevant section of the pserver.conf file:
#--------------------------------------------------------------------------#Events #--------------------------------------------------------------------------#Events tracking Publishing Servers operation and errors are sent to im #<IPSEventsIM> #IPSEventsIM=<ImpactAdminCell> #By default IPS_EVENTs are generated to the Impact Admin Cell IPSEventsIM=cell.Admin #Only operation events of the classes listed in IPSEventClasses are created. #By default events of all IPS_EVENT concrete subclasses are created #IPSEventClasses=IPS_START,IPS_STOP,IPS_CONFIG,IPS_CONNECT,#IPS_IM_CONNECT, #IPS_PUBLISH,IPS_CLASSINFO #Enabling of error events (IPS_ERROR) is to be configured in pserver.trace
182
Understanding classes and slots for BMC Impact Publishing Server events
If you enter an incorrect cell name in this file, (a cell name that is not present in the cell directory as it is configured by IMFileDirectoryName), then no events are generated. In the tmp/ps_hostname/pserver.trace output file, the error message is Unable to report ips events to im X: IPSEventsIM points to unregistered im.
2 To generate error events, in the etc/pserver.trace file, uncomment the following line
by removing the # at the beginning of the line.
#log4j.logger.com.bmc.sms.ps=DEBUG, IPSERROREVENTS
EXAMPLE
In the relevant section of the pserver.trace file:
# Print messages of level DEBUG or above in the package #log4j.logger.com.bmc.sms.imapi=DEBUG #log4j.logger.com.bmc.sms.imapi.nls=DEBUG #log4j.logger.com.bmc.sms.imapi.gw=DEBUG #log4j.logger.com.bmc.sms.imobject=DEBUG log4j.logger.com.bmc.sms.ps=DEBUG, IPSERROREVENTS
Understanding classes and slots for BMC Impact Publishing Server events
Table 40 describes the Common Event Model (CEM) slots (defined in CORE_EVENT) and values that are applicable to all events generated by BMC Impact Publishing Server.
183
Understanding classes and slots for BMC Impact Publishing Server events
Table 40
Slot name
for status events of the publishing server itself = BMC Impact Publishing Server for status events of the automated publishing service of the publishing server = BMC Impact Publishing Server Automated Publishing
ps_hostname Computer
name of the computer on which BMC not defined Impact Publishing Server is running network address of the host computer on which BMC Impact Publishing Server is running identifies the event management system type not defined
mc_origin_class mc_origin
ps_hostName specifies the event management system that is closest to the source of the event and is considered to have detected the event
mc_tool_class mc_tool
the way in which the incident is reported to the cell defines where any event is within a value that can further distinguish where the event is coming from within the mc_tool_class value IP address of the host computer on which BMC Impact Publishing Server is running
mc_tool_address
Tool Address
not defined
184
Understanding classes and slots for BMC Impact Publishing Server events
IPS_EVENT IPS_CONTROL IPS_START IPS_STOP IPS_CONFIG IPS_CNX IPS_CONNECT IPS_IM_CONNECT IPS_ERROR IPS_REQUEST IPS_CLASSINFO IPS_PUBLISH
These classes are defined in the ips.baroc file, located in the MCELL_HOME\etc\default\EM\kb\classes directory. When you enable event generation to a SIM cell, all operational events are generated, which are the event classes IPS_START, IPS_STOP, IPS_CONFIG, IPS_CONNECT, IPS_IM_CONNECT, IPS_PUBLISH, and IPS_CLASSINFO. In addition to operational events, you can also enable the generation of BMC Impact Publishing Server error events of the class IPS_ERROR.
IPS_START slots
Slot label in BMC IX Process Run ID Description All IPS_CONTROL events that are generated from the same processing run of BMC Impact Publishing Server are assigned the same process run ID (guid) for easy correlation of these events. value is the string status indicates the status of BMC Impact Publishing Server:
s s
mc_parameter
Status
185
Understanding classes and slots for BMC Impact Publishing Server events
Table 42
Slot name
IPS_STOP slots
Slot label in BMC IX Process Run ID Description All IPS_CONTROL events that are generated from the same processing run of BMC Impact Publishing Server are assigned the same process run ID (guid) for easy correlation of these events. seriousness of the event; default is INFO value is the string status indicates the status of the BMC Impact Publishing Server:
s s
process_run_id
severity mc_parameter
Severity Status
Description indicates the class of the operating system indicates the version of the operating system All IPS_CONTROL events that are generated from the same processing run of BMC Impact Publishing Server are assigned the same process run ID (guid) for easy correlation of these events. contains the version of the Publishing Server contains the software build number of the Publishing Server contains the build date of the Publishing Server contains the absolute path of the home directory for the Publishing Server contains the absolute path of the configuration file; pserver.conf is the default file contains the absolute path of the kb directory contains the absolute path of the log directory contains the absolute path of the cell directory file (default is mcell.dir)
Process Run ID
IPS Version IPS Build Number IPS Build Date Home Directory Configuration File KB Directory Log Directory Cell Directory File
186
Understanding classes and slots for BMC Impact Publishing Server events
Table 43
Slot name
Description contains the absolute path of the trace configuration file; pserver.trace is the default file contains the absolute path of the trace file; pserver.trace if the default file
trace_conf trace_file
IPS_CONNECT slots
Slot label in BMC IX
Request ID
Description the ID of the request sent to the BMC Impact Publishing Server The connection is required for the processing of the request. For every request, IPS_CONNECT events are created for every component that needs to be connected.
destination
Destination
type of the component to which BMC Impact Publishing Server is connecting; possible values are:
s s s
CMDB for BMC Atrium CMDB IM for BMC Impact Manager SMM for Service Model Manager
name of the component to which BMC Impact Publishing Server is connecting host and port number of the computer to which BMC Impact Publishing Server is connecting logon used to connect blank for Impact Manager and Service Model Manager connections because those connections do not require authentication
result
Result
SCS when the connection succeeds FLR when the connection fails
187
Understanding classes and slots for BMC Impact Publishing Server events
IPS_IM_CONNECT slots
Slot label in BMC IX Destination Secondary Location Description host and port number of the secondary Impact Manager server, if high availability is enabled
Description enables you to follow the status of a request When the request is sent to the BMC Impact Publishing Server, the severity is INFO. When the BMC Impact Publishing Server finishes the processing of this request, it updates the severity of the event:
s s
client_data
Client Data
data coming from the client For automated publishes resulting from a BMC Impact Service Model Editor promotion, this slot displays the ReconJobRunId and the PromotionId.
request_id
Request ID
the ID of the request sent to the BMC Impact Publishing Server This ID is necessary when you retrieve the request log by using a BMC IX local action and is useful in diagnosing publication failures. See Diagnosing publication failures on page 298.
request_msg
Request Message
the content of the request (for example, EnvId=PROD; Queue=T) This is the internal communication protocol, useful for debugging.
188
Understanding classes and slots for BMC Impact Publishing Server events
Table 46
Slot name
Description initially UNK (unknown) Set to SCS (success) or FLR (failure) when processing is terminated.
request_result
result_msg
Result Message
brief description of the success or the failure of the handled request For example, Request failed: Publish verification of IM(s) failed. You can find more detailed failure messages in the request log.
user_id
User ID
the logon user ID of the requestor For automated publishes that are invoked from a BMC Impact Service Model Editor promotion, this slot displays the BMC Impact Service Model Editor logon user ID. For publishes from a CLI, this slot displays the user of the CLI or publish@hostname if the CLI is run locally without authentication.
description
Description
the description that comes with the request For automated publishes resulting from a BMC Impact Service Model Editor promotion, this slot displays the BMC Impact Service Model Editor promotion comment. For publishes from a CLI, this slot displays the description you enter when using the -s option.
189
Understanding classes and slots for BMC Impact Publishing Server events
IPS_PUBLISH slots
Slot label in BMC IX Description are
s
s s
direct when the publish request is for a DirectPublish init when the publish request is an initialization, as with the pinit cli publish when the publish request is a delta or incremental publication, as with automated publish or with the publish CLI command selected_publish when a publish request is for selected objects, as with the publish -d CLI command
env_id
Environment ID
ID of the publish environment For example: s PROD for production environment s TEST.user.1 for BMC Impact Service Model Editor test environment
IPS_CLASSINFO slots
Slot label in BMC IX
Class Info Request Type
validation when the classInfo request happens with the CLI command pclassinfo n cellName
export when the classInfo request is generated with BMC Impact Service Model Editor export meta data functions, or with the CLI command pclassinfo -x
190
IPS_ERROR slots
Slot label in BMC IX
Severity
creation of a publish environment modification of a publish environment initialization of CMDB datasets of a AtriumCMDB? publish environment removal of a publish environment IPS_ENV slots
Slot label in BMC IX Origin ID Environment ID Environment Request Type Description contains the origin ID (AtriumCMDB or DirectPublish) of the publish environment contains the IDs of the publish environment contains the action open, set, init or close
Table 50
Slot name
origin_id env_id env_type
191
Each component and impact relationship of a cell can refer to each management data instance regardless of the source of the management data in the cell (Direct Feed or AtriumCMDB publishing or DirectPublish publishing or CellPublish publishing). Direct Feed management data can also be referred to by published CIs and relationships. The management data need not be published to be referred to by published CIs and relationships.
OriginID AtriumCMDB
BMC Impact Service Model Editor termination of reconciliation job CLI command publish CLI command pposter HP OVO fetch termination CLI command publish
s s s
DirectPublish CellPublish
192
An environment is uniquely identified by EnvID plus OriginId. The environment identifier must be unique within all AtriumCMDB Publish environments or within all Direct Publish environments. However, it is simpler and easier to manage if all publish environments in your enterprise have unique identifiers.
193
A cell name can only be used in one AtriumCMDB Publish environment, however it can be re-used in many DirectPublish environments, even if it is also used in AtriumCMDB environment. Cell-alias to cell-name values must already be defined when publishing is initiated.
you can promote SIM objects in the BMC Impact Service Model Editor product, which triggers reconciliation and when that terminates, publishing of the objects to the cells
194
you can reconcile from any BMC Atrium CMDB reconciliation dataset you can use the Send to test function in BMC Impact Service Model Editor, in which case, the parameters of the environment are defined and managed for you, based on choices you make in the BMC Impact Service Model Editor you can create other AtriumCMDB Publish environments for advanced staging, for which you define the parameters of the environment using the CLI command penv.
During the publishing of a service model, new or modified service model components and their relationships are selected from the asset dataset in the BMC Atrium CMDB and copied to respective BMC Impact Manager cells. New objects coming from a discovery source (such as BMC Topology Discovery or BMC Foundation Discovery) are flagged by default as In-Model and are therefore published by BMC Impact Publishing Server. This default can have a performance impact if too many CIs exist in non-SIM classes. If the impact is too great, then you can revert and set the default value for ServiceModelSet to OUT. In this case, the new objects coming from a discovery source are ignored by the Publishing Server and you must bring In-Model objects in the Service Model Editor. If discovery sources provide updates to objects that are flagged as In-Model, these changes are sent to the cells.
195
When you register a cell in BMC Impact Portal and define it as production, an alias with the same name as the cell name is defined and stored in the SIM_CellAlias CMDB class in the dataset BMC.ASSET. When you send service model objects to test in the BMC Impact Service Model Editor (using the Send to test function), all existing aliases are mapped to the test cell you chose for the test in BMC Impact Service Model Editor.
Cell alias cellA cellB cellC Cell name (prod cell) cellA cellB cellC Cell name (test cell) testcell1 testcell1 testcell1
In production the three component instances are sent to the production cells: cellA, cellB, and cellC. When you send them to test in BMC Impact Service Model Editor, they are all sent to the same test cell, testcell1.
196
Comments
s
read-only; can be updated only by the CMDB Reconciliation Engine as objects are reconciled not limited to objects that are in-model a service model object is successfully promoted when it is moved from the sandbox to this dataset in the BMC Atrium CMDB read-only: can only be updated by the BMC Impact Publishing Server as objects are published a service model object is successfully published when a copy of it is in this dataset in the BMC Atrium CMDB
contains objects that have been successfully published This dataset is a master copy of the service model data in the asset dataset regular dataset
The production service model data is in the BMC Atrium CMDB in the production dataset BMC.ASSET. After you promote service model objects in BMC Impact Service Model Editor, these changes are reconciled in the production dataset and then stored in the production dataset BMC.IMPACT.PROD upon successful publication, which mirrors the last successful publish to the cells.
WARNING
To ensure that the service model data in the BMC Atrium CMDB and in the cell are synchronized, the data in the impact dataset should be managed solely by BMC Impact Publishing Server.
197
BMC Impact Service Model Editor puts the service model data that was sent to test into the asset dataset (BMC.ASSET.user.Test.1) of the new test environment and requests a publication from the BMC Impact Publishing Server. The BMC Impact Publishing Server then looks up the test cell for the cell alias of every component. The last successful publish to the test cells is mirrored in the impact dataset BMC.IMPACT.user.Test.1. The Send to Test function
s s s s
validates the existence of or creates a test publish environment for the user validates the existence of an available test cell for publishing updates entries in the Cellalias table for the current environment empties test datasets of previous contents
A test cell contains only the latest objects sent to test. Any previous objects are removed. Test objects cannot be added to the Console Navigation Tree in BMC Impact Service Model Editor, which means they cannot be monitored in BMC Impact Portal. After a successful publish, the BMC Atrium CMDB contains entries in the BMC.ASSET.user.TEST.1 and BMC.IMPACT.user.TEST.1 datasets for the environment.
WARNING
To ensure that the service model data in the BMC Atrium CMDB and in the cell are synchronized, only the BMC Impact BMC Impact Publishing Server should modify the data in the impact test dataset.
The BMC Impact Service Model Editor test publish environments have an overlay asset dataset, with the production dataset as underlying dataset.
s
To have all management data instances of the production dataset in the test environment, publish mode Overlay is used for PublishModeMgmtData. To be able to cut down the test to a limited number of components and impact relationships the publish mode Current is used for PublishModeServiceModel.
198
2. Register any new cells in BMC Impact See BMC Impact Solutions Infrastructure Portal (which automatically creates them Administration Guide in BMC Atrium CMDB). 3. Determine the source of the service model data (another environment or a BAROC source file). Use the penv init parameters SourceEnvMgmtData and
SourceEnvServiceModel or SourceBarocMgmtData and SourceBarocServiceModel
Create a BAROC source file. 4. Define the environment. 5. Enter the data in the BMC Atrium CMDB. If cells are running, this initializes cells with this data. 6. Publish the objects to the cell. 7. Monitor services. 8. Troubleshoot problems. Execute a CLI command publish In BMC Impact Explorer, on the Services tab See Appendix A, Troubleshooting Execute a CLI command penv open Execute a CLI command penv init
You use the CLI command penv and the pclient.conf file to create, modify, and delete publish environments. For more information about these topics, see penv Managing publish environments on page 252. In an AtriumCMDB Publish environment, the cell is automatically initialized with SIM management data of the asset dataset of the environment when you execute the CLI command publish.
defining it in the CLI command penv when you define the environment defining it after the environment is opened in a CLI command penv with the action command set
199
If home cell is defined, cell aliases, as defined in the BMC Atrium CMDB, are ignored. All service model data in that environment is published to the cell specified in HomeCell, even if HomeCellAlias contains a cell alias that points to another cell.
Cell aliases
If you do not have home cell defined, then cell aliases are required. Using Remedy User or an API program, you must assign cell alias-to-cell name values (per environment) in the BMC Atrium CMDB in instances of the BMC.ASSET dataset in the BMC Atrium CMDB class BMC.SIM.CONFIG:SIM_CellAliases. The values that are assigned at the time of publishing are also stored in the dataset BMC.IMPACT.PROD.
s s s
set the attribute EnvId to the ID of the publish environment set the attribute CellAlias to the alias set the attribute CellName to the name of a cell that is registered in BMC Impact Portal (registered in the class SIM_CellInformation)
You can set a default cell by setting CellAlias to null. In this way, the attribute HomeCellAlias for individual CIs is not required to publish. If you create an instance in the BMC Atrium CMDB class BMC.SIM.CONFIG:SIM_Cellaliases like
Environment EnvId CellAlias CellName arwad
then every CI in BMC.ASSET.EnvId that has no value in HomeCellAlias is published to the cell arwad.
200
1. You define two environments for the two different departments, by executing the following command:
EXAMPLE
>penv open -e dept1 >penv open -1 dept2
2. The components and impact relationships for each department are loaded from BAROC files, in the respective asset datasets BMC.ASSET.dept1 and BMC.ASSET.dept2. After an initial publication, modifications are published incrementally. When you are satisfied with the results, the staging asset datasets can be reconciled into the production dataset. 3. Reconcile the staging asset datasets into the production dataset.
EXAMPLE
penv -e SIMULATION -p AssetDataSetId=BMC.ASSET -p HomeCell=simulation
201
This command creates only the simulation publish environment, not the production publish environment, which should already exist since it is created by default. To create a simulation publish environment with an overlay asset dataset:
EXAMPLE
penv -e SIMULATION -p AssetDataSetType=Overlay -p HomeCell=simulation -p AutomatedPublish=T
OUT
indicates the data instance is not in the service model Out-of-model instances are not published to the cell. default value
OUT_OF_IN
indicates the data instance was in the model but has since been removed from the model At the next publication, the instance is removed from the cell.
For a component in the BMC Atrium CMDB to be considered for publishing by BMC Impact Publishing Server, this attribute must contain specific values:
s
Only CIs with ServiceModelSet IN or OUT_OF_IN are considered by the BMC Impact Publishing Server. The value IN indicates that the CI is included in the service model published to a SIM cell. The value OUT_OF_IN indicates that the CI is not included in the service model published to SIM.
WARNING
By default, the ServiceModelSet attribute is set to IN. If your model as a large number of instances of non-SIM classes, the time required to retrieve those publishable instances can be significant. If this increase in retrieval time is prohibitive, set the default to OUT. You can also create a Remedy AR filter to set ServiceModelSet IN for cases where the instance should automatically be set IN.
203
To ensure synchronization between the impact dataset in BMC Atrium CMDB and the service model in a SIM cell, ServiceModelSet cannot be reset to OUT after it has been IN or OUT_OF_IN. Every CI that has a ServiceModelSet value of IN or OUT_OF_IN should have a ReconciliationIdentity defined. See also In-model and not-in-model component instances on page 54.
If both instances are assigned IN, then the ServiceModelSet value for the impact relationship is IN. If either or both are assigned OUT_OF_IN, then the relationship is defined as OUT_OF_IN. If either or both are assigned OUT, then the relationship is defined as OUT.
204
in the impact dataset, existing objects are removed in the asset dataset, existing objects are either removed or kept, but are moved outof-model, depending on the values in the InitEffectivelyMgmtData and InitEffectivelyServiceModel parameters new initial objects in asset dataset and in impact dataset are copied from the initialization source (see Initial source parameters on page 208)
Objects in the datasets of an environment with asset dataset that overlays the asset dataset of the environment that is being initialized are also initialized. For more information about initializing a publish environment, see also the init action command under penvManaging publish environments on page 252.
205
Table 54
Parameter
Parameters in the pclient.conf file for initializing the BMC Atrium CMDB
Description determines which management data instances are removed from the BMC Atrium CMDB during initialization or reinitialization, based on the value in the ServiceModelSet class attribute relationship instances are removed from the BMC Atrium CMDB during initialization or reinitialization, based on the value assigned in the SeviceModelSet class attribute
InitEffectivelyMgmtData
specifies whether management data is initialized specifies whether service model data is initialized specifies the BAROC files from which the default or initial management data instances are copied specifies the BAROC files from which initial components and impact relationships are copied specifies the publish environment. From its datasets the default or initial management data instances are copied specifies the publish environment. From its datasets the initial components and impact relationships are copied
InitEffectively parameters
The two InitEffectively parameters determine the retention of the existing instances in the asset dataset when initializing. Only the IN and OUT values for ServiceModelSet attribute are taken into consideration.
InitEffectivelyMgmtData relates to management data instances. InitEffectivelyServiceModel relates to component instances and impact
relationship instances. When the objects in the BAROC file have a value in the mc_udid slot, keeping existing data may be impossible. In BMC Atrium CMDB, the DatasetId and the ReconciliationIdentity must be unique.
206
Table 55
InitEffectivelyMgmtData=IN
InitEffectivelyMgmtData=OUT
Management data instances with ServiceModelSet attribute value of OUT are removed from the BMC Atrium CMDB. Management data instances with the ServiceModelSet attribute value of IN or OUT_OF_IN have their attribute value reset to OUT.
InitEffectivelyMgmtData=
Existing management data instances are kept in the BMC Atrium CMDB. Instances with the ServiceModelSet attribute value of IN or OUT_OF_IN have their values reset to OUT.
Generally, you do not move management data in and out of model. Therefore, you do not want to keep existing management data instances. In fact, some of the default management data instances have a mc_udid set, which makes it impossible to keep them. In order to keep a backup of custom management data instances, which is useful when you must reinitialize the production environment, export them to BAROC files by using the CLI command mquery. The default management data BAROC files are stored in the file:
MCELL_HOME\etc\ps_hostname\kb\data
207
all service model component or impact relationship instances are not removed from the BMC Atrium CMDB components and impact relationships with the ServiceModelSet attribute value of IN or OUT_OF_IN have their attribute value reset to OUT
The default initialization does not contain any component or impact relationship. Generally, when reinitializing you do not want to lose components and impact relationships that were already defined or that were detected by a discovery tool. When you reinitialize, you need to browse the existing components and decide if they still need to be in model.
InitEffectivelyServiceModel=IN
Components and impact relationships with the ServiceModelSet attribute value of IN or OUT_OF_IN are removed from the BMC Atrium CMDB.
InitEffectivelyServiceModel=IN, OUT All components and impact relationships, regardless of the value of ServiceModelSet
being IN, OUT_OF_IN or OUT, are removed from the BMC Atrium CMDB.
208
Initializing a cell
By default, the source of service management data for the production publish environment (BMC.ASSET and BMC.IMPACT.PROD) is the BAROC files in MCELL_HOME/etc/ps_hostname/kb/data/.load. For other AtriumCMDB publish environments, the production environment is the source. If the source is BAROC files, then the baroc instances are copied to the asset dataset and the impact dataset. If the source is a publish environment, then the instances from the impact dataset of the source publish environment are copied to the impact dataset of the publish environment that is being initialized. Likewise, the instances from the asset dataset of the source publish environment are copied to the asset dataset of the publish environment that is being initialized. In copying to the asset dataset, the type (Overlay or Regular) and the publish mode (Overlay or Current) is taken into account. If the asset dataset is an overlay dataset and the publish mode is overlay and the initialization's source is the underlying asset dataset, then effectively no copies are taken.
Initializing a cell
Initialization deletes all existing SIM data (service model data and service management data) of the publish environment from the cell. For an AtriumCMDB publish environment, it sends the contents of the BMC Atrium CMDB impact dataset to the cells. When a cell is initialized, existing events are associated with new copies of components, so status information of component instances is not lost. You reinitialize a cell by using the CLI command pinit. Typically, you reinitialize only when
s s s
a cell is reinstalled (restart the cell with the -i option) a cell must be restarted for recovery purposes SIM data in the cell is no longer in sync with the data in the BMC Atrium CMDB impact dataset or with the data in the Direct Publish source
When you add a new cell alias to an AtriumCMDB publish environment, the BMC Impact Publishing Server automatically initializes it with the service model management data upon the first publication to it. When you initialize cells of an AtriumCMDB publish environment, the data in the impact dataset (like BMC.IMPACT.PROD) is sent by the BMC Impact Publishing Server to the cells. When only DirectPublish publishing is enabled, then you have to initialize the new cell with management data manually.
209
Initializing a cell
To initialize a cell from the BMC Atrium CMDB production environment, execute the following CLI command:
pinit -n cellName
For more information about reinitializing a cell, see pinitInitializing a cell with service model data on page 261.
210
EXAMPLE
BMC_BusinessProcess; mc_udid=test1; Name=test1; OwnerName='DSM PSR/I Lab'; OwnerContact='713.918.8800'; Description='BMC DSM - PSR and Interoperability Lab Test Business Process'; StatusModel=STANDARD; HomeCell=lopud; END BMC_BusinessService; mc_udid=test1_S0101; Name=test1_S0101; OwnerName='DSM PSR/I Lab'; OwnerContact='713.918.8800'; HomeCell=lopud; END BMC_ComputerSystem; mc_udid=test1_S0101_N01; Type='WINDOWS_SYSTEM'; Name=test1_S0101_N01; OwnerName='DSM PSR/I Lab'; OwnerContact='713.918.8800'; Description=Computer; HostName=test1_S0101_N01; HomeCell=lopud; END BMC_Application; mc_udid=test1_S0101_N01_A01; Name=test1_S0101_N01_A01; Type=app_type1; OwnerName='DSM PSR/I Lab'; OwnerContact='713.918.8800'; Description=Application; HomeCell=lopud; END BMC_Impact; mc_udid=test1_obj1<-obj2; provider_id=test1_S0101; consumer_id=test1; PropagationModel=DIRECT; provider_home_cell=lopud; consumer_home_cell=lopud; END
211
1 Create a directory MCELL_HOME/etc/ps_hostname/kb/data_Dept1. 2 Copy into it the kb/data directory, add the file sm_Dept1, and edit the .load to add
the sm_dept1.
3 Define the HomeCell parameter of the Dept1 environment as lopud. 4 Execute the following command:
penv -e dept1 -p "SourceBarocServiceModel=etc/kb/data_dept1/.load" init -v
The service model is created in the asset and impact datasets of the AtriumCMDB Publish environment Dept1. The cell for Dept1 is running and is initialized immediately when you initialize the BMC Atrium CMDB. When the initialization completes, the cell has the components and the impact relationships.
212
publishing operates in the background publish is pre-authenticated if you password protect the AtriumCMDB Publish environment publish requests are queued; a new request starts when the one in progress completes if multiple promotion and reconciliation processes are running at the same time, the throughput time of the publication increases all modified instances since the last successful publish are published, so the instances that are promoted and reconciled, and the instances that are published are not necessarily the same
213
publication failures caused by reasons independent of model consistence (for example, when a cell is not available) result in the automated publisher reattempting the publication promotion and reconciliation, and publish are independent processes. It is possible that the promotion and reconciliation processes are successful, but the subsequent publish fails. if an in-progress publish is still retrieving publishable data from an asset dataset, it will also find publishable data that became publishable after the in-progress publish was initiated. This might cause inconsistent data (like an impact relationship pointing to a nonexistent component) and publication failure. Such a failure cannot be prevented because the BMC Atrium CMDB does not know the concept of transactions. causes the first publication to also publish the data of the second reconciliation. The second publication displays the message Nothing to be published.
214
Started - Starting Automated mode Started - Automated mode Started - Manual mode
In an environment without the BMC Atrium CMDB, psstat returns the status of publishing server as Started. For more information about psstat, see psstatDisplaying status of BMC Impact Publishing Server on page 282.
Basic process 1. Enable Direct Publishing. 2. Create a Direct Publish environment for the SIM management data. 3. Create a Direct Publish environment for component instances and impact relationships.
215
Table 57
Basic process 4. Create a source file that contains the service model data in BAROC format. 5. Send service model data in the BAROC source file to the cells.
You must define either the HomeCell or the CellAliases parameter for a Direct Publish environment. You can set a default cell by setting CellAlias to null. Then, the components that do not have a value set for the attribute HomeCellAlias are published to that default cell. You can define values for the parameters HomeCell and CellAliases of Direct Publish environments when you define the environment or you can modify them later. However, when you modify them, keep track of the cells to which you published data using the Direct Publish environment.
216
3. If the components attribute HomeCell is set, that value is used (regardless the value of the HomeCellAlias slot). 4. The value of the HomeCellAlias slot is used to look up the HomeCell in the publish environment's CellAliases.
217
Determining the cells to which management data is published 1 If HomeCell is defined for the publish environment, then management data is send
to HomeCell.
2 Management data is sent to all cells defined in the CellAliases of the publish
environment.
218
EnvId represents the name of the environment you are creating. cellName represents the name of the cell to which you are sending objects.
EnvId represents the name of the environment you are creating. cellAlias# represents the cell alias to which you are sending objects. cellName# represents the name of the cell to which you are sending objects with the preceding cell alias.
NOTE
When you modify the value of the parameter CellAliases, you must redefine all cell aliases.
To change the value of HomeCell to null (unset or remove the value), use the following command:
penv set -e EnvId -p "HomeCell="
219
To change the value of CellAliases to null (unset or remove the value), use the following command:
penv set -e EnvId -p "CellAliases="
Reinitializing a cell
To initialize a cell from a Direct Publish environment and recreate the data from the BAROC source file, execute CLI commands similar to the following:
pposter -e EnvId sourceFileName.baroc pposter -e EnvId -p Init=T sourceFileName.baroc
For more information about reinitializing a cell, see pinitInitializing a cell with service model data on page 261.
EXAMPLE
penv open -e Sales -p OriginId=DirectPublish -p CellAliases=[austin, austin, brussels, brussels]
You create a BAROC source file named sales.baroc. In the source file, these attributes are set: HomeCellAlias=austin, Consumer.HomeCellAlias=austin and Provider.HomeCellAlias=brussels. You send the objects in the source file to the cells austin and brussels by executing the following command:
EXAMPLE
pposter -e Sales sales.baroc
Now you want to experiment with the impact of a change to the service model in the test cells austin_test and brussels_test. You define a test Direct Publish environment by executing the following command:
EXAMPLE
penv open -e Sales.Test OriginId=DirectPublish -p CellAliases=[austin, austin_test, brussels, brussels_test]
You make a copy of the BAROC source file, sales.baroc, and name the copy sales_test.baroc. In the sales_test.baroc file, you add a new component and a new impact relationship and leave the remainder of the data in the source file unmodified. You send the objects in the source file sales_test.baroc to the cells austin_test and brussels_test by executing the following command:
EXAMPLE
pposter -e Sales sales_test.baroc
Example 2
The service model for the Sales department is needed for training. You define a Direct Publish environment by executing the following command:
EXAMPLE
penv open -e Sales.Training -p OriginId=DirectPublish -p CellAliases=[austin, austin_training, brussels, brussels_training]
221
You need the same objects in the Sales.Training environment that are in the source file sales.baroc, so you send the objects in that source file to the cells austin_training and brussels_training by executing the following command:
EXAMPLE
pposter -e Sales.Training sales.baroc
Even though you did not modify the source file sales.baroc, which has component instances defined with HomeCellAlias=austin, the service model objects are sent to the cell austin_training because the Sales.Training environment was defined with cellalias-to-cellname pairs as austin, austin_training and brussels, brussels_training. See Determining the cell to which a component is published on page 216.
222
For example, you want to assign a value to the HomeCell parameter for the Accounting department, which has an environment ID = Accounting and is password protected, so you execute the following command:
EXAMPLE
penv set -e Accounting -p Password=ut0p1a -p HomeCell=cell2
For example, you want to create a service model for the Sales department using a BAROC source file for the service model data and password protect it. So you create a Direct Publish environment with the CLI command penv and the action command open using the following command:
EXAMPLE
penv open -e Sales -p OriginId=DirectPublish -p NewPassword1=sam3ul -p NewPassword2=sam3ul
You can also enter a password in the pclient.conf or pinit.conf configuration files. You enter the password in plain text and it is encrypted the first time a CLI command that uses the configuration file is executed.
EnvId represents the environment ID. the_password (first occurrence) represents the password. the_password (second occurrence) represents the password again, to confirm it.
223
Using CLI command publish for a password protected AtriumCMDB Publish environment
If you password protect an Atrium CMDB Publish environment, you must include the password in the command string when you execute the CLI command publish. For example:
EXAMPLE
publish -e Accounting -p Password=l0b3l1a
Using CLI command pposter for a password protected Direct Publish environment
If you password protect a Direct Publish environment, you must include the password in the command string when you execute the CLI command pposter. For example:
EXAMPLE
pposter -e Payroll -p Password=86a032 sm_payroll.baroc
224
Table 59
Filename File path Description
pserver.conf file
pserver.conf MCELL_HOME/etc/ps_hostname or if that file does not exist MCELL_HOME/etc contains the configuration settings that control the behavior of the BMC Impact Publishing Server Description specifies the name of the log directory for the BMC Impact Publishing Server On UNIX platforms, you must specify an NFS path. Specifying a UNC path is not supported. Default value log
Parameter name
SystemLogDirName
AtriumCMDBPublishOrigin AtriumCMDBHeartbeatInterval
enables (T) or disables (F) publishing from BMC Atrium CMDB to a cell
T (true)
180 (seconds) sets the length of time that BMC Impact Publishing Server waits for a heartbeat, a cancel, or a commit from a client during publish preview When no heartbeat is received after this interval, the publish is cancelled.
AtriumCMDBPreviewTimeout
sets the length of time that BMC Impact Publishing Server waits for an answer to cancel or commit the publish after publish preview When no answer is received after this interval, the publish is cancelled.
180 (seconds)
CellPublishOrigin CellPublishIms
enables (T) or disables (F) publishing from staging cells T (true) lists all the staging cells, that is, all the cells that define CellPublish publish environments. If you want to use the command "publish -e OVO" then you have to add the adapter cell to this parameter. If empty, then the command will fail with the message No publish environment OVO found, and you must use the command "pubilsh -e OVO -p "OriginId=CellPublish" -p "Cell=ovo_java""
CellPublishGateway
enables (T) or disables (F) listening by the Publishing Server for incoming IPS_CP_TRIGGER events propagated by a staging cell that will trigger a publication for a CellPublish environment of the cell defines the name of gateway that listens for incoming IPS_CP_TRIGGER events to trigger a CellPublish publication. This name is looked up in the directory set in IMFileDirectoryName.
T (true)
CellPublishGatewayName
225
Table 59
pserver.conf file
lists the cells from which the Publishing Server accepts not defined incoming events. If no cell is listed then all incoming events are accepted.
CellPublishGatewayIms
CellPublish2CmdbContinueOn Warning
enables (T) or disables (F) continuation when instances F (false) that cannot be imported must skipped The list of skipped instances and the reason they were skipped is output to the request log.
CellPublish2CmdbReconJobTime defines the length of time, in seconds, that Out CellPublish2Cmdb checks for the termination of the
120 (seconds)
reconciliation job run. If the interval expires before the reconciliation job run completes, then the request log does not indicate the result. Even though no result is indicated, the reconciliation job might complete successfully after the timeout.
CellPublishCommitRetryTime Out
900 (seconds) defines the length of time, in seconds that CellPublish2Cmdb retries in total to commit the data in the import dataset. When a commit fails, a new commit is retried without the offending data. By retrying the commit without the offending date, CellPublish2Cmdb can find all offending data in one run.
F (false)
180 (seconds) sets the length of time that BMC Impact Publishing Server waits for a heartbeat, a direct request, or a close from a client When no heartbeat is received after this interval, the publish is cancelled.
JNPServers
defines the host and port of JNP Servers When the Portal is set up in cluster mode, this value must match the same value in the pclient.conf file.
localhost:9379
JMSCommWarnReconnectCount
the number of times to retry to establish JMS communication If the trial fails then an IPS_ERROR event with message "Unable to establish JMS communications." of severity WARNING is generated. If JMSCommWarnReconnectCount is -1 then retries continue indefinitely.
30 (reconnect attempts)
10 (seconds)
attempts
226
Table 59
pserver.conf file
the number of times to retry to establish JMS communication If the trial fails then an IPS_ERROR event with message "Unable to establish JMS communications." of severity MAJOR is generated. If JMSCommMajorReconnectCount is -1 then retries continue indefinitely. -1 (connection attempts)
JMSCommMajorReconnectCount
JMSCommMajorReconnectInterval
the interval (in seconds) between two reconnection attempts specifies the name of the computer on which BMC Atrium CMDB resides defines the port number for connecting to the BMC Atrium CMDB
300 (seconds) not defined, set by install not defined, set by install use 0 for dynamic port detection
CMDBServer CMDBPort
CMDBUser CMDBPassword
defines the user ID that grants access to the BMC Atrium CMDB a valid BMC Atrium CMDB user password appears in plain text when entered; encrypted at first launch
ARSGroupMembers
lists the host and TCP/IP port of every AR Server Group member If an AR Server Group is deployed then you must set this parameter, regardless of whether you use a load balancer. Use 0 for dynamic port detection.
not defined
RequestHistorySize CellConnectionTimeout
sets the maximum number of request log files that are retained by the BMC Impact Publishing Server
100
sets the length of time the BMC Impact Publishing 60 (seconds) Server maintains a connection to a cell when there is no activity from the cell sets the size of the message buffer for communication with the cell sets the time to keep messages buffered while waiting for an answer 2000 300 (seconds)
IMMessageBufferSize IMMessageBufferKeepSent
227
Table 59
pserver.conf file
defines the name of the Impact Manager directory for direct publications; it is looked up in the directory MCELL_HOME/etc/PSName, or if that file does not exist, in the directory MCELL_HOME/etc This directory file is also used to locate the cell for BMC Impact Publishing Server event generation. mcell.dir
IMFileDirectoryName
enables (T) or disables (F) the display of passwords in generated request logs and IPS_REQUEST events sets the size of the message buffer for communication with Service Model Manager sets the time to keep messages buffered while waiting for an answer
enables (T) or disables (F) the use of the estimate when T (true) the length of time exceeds the value that is calculated for the upload time of the service model sets the time to stop waiting on a BMC Remedy AR System operation that occurs quickly sets the time to stop waiting on a BMC Remedy AR System operation that occurs slowly sets the time to stop waiting on a BMC Remedy AR System operation that occurs slowly 120 (seconds) 300 (seconds) 1800
enables (T) or disables (F) the use of the estimate when T (true) the length of time exceeds the value that is calculated for committing bulk entry transactions 5 (seconds) When automated publishing is stopped, an ongoing publish is canceled, if possible. This parameter sets the length of time for an ack reply of the publishing request, which returns the requestID. If the requestID is unknown, then the publish request is not canceled.
AutomatedCancelAckTimeout
900 (seconds)
publish is canceled, if possible. This parameter sets the length of time for the final reply of the publish request, which returns a message indicating if the publish request was canceled or not. If the publish is canceled or if the final reply is unknown, then the publish is retriggered when automated publish is restarted.
AutomatedHeartbeatInterval
sets the length of time between the BMC Impact Publishing Server and the AR Notify plugin for heartbeat. 0 or a negative value disables heartbeat. sets the length of time that BMC Impact Publishing Server waits for an answer to a heartbeat from the AR Notify plugin.
-1 (seconds)
AutomatedHeartbeatTimeout
5 (seconds)
228
Table 59
pserver.conf file
the maximum number of times automated publishing is retried after failures
n represents the number of repeated publication attempts:
s s s
AutomatedPublishRetryCount
12
n = 0 means the publication is attempted once and not retried n = 1 means the publication is attempted and then retried once n < 0 means the BMC Impact Publishing Server continues to retry until a publication is successful
Publications that are skipped are not counted as retry attempts, so AutomatedPublishRetryCount is the effective maximum number of retries.
AutomatedPublishRetryPeriod
sets the length of time between two consecutive publish requests when publish fails If a previous publish request is not terminated when the interval times out, the next trial is skipped.
300 seconds
AutomatedStartMode
the publishing mode when the BMC Impact Publishing automated Server starts or restarts. When the BMC Impact Publishing Server is running, you can change the publishing mode by using requests (using the CLI command pscontrol). By default, the BMC Impact Publishing Server starts in automated mode. defines the cell to which BMC Impact Publishing Server events are sent not defined, set by install to Impact Administration Cell all subclassess of IPS_EVENT set when?
IPSEventsIM
IPSEventClasses DefaultCell
defines the event classes for which BMC Impact Publishing Server events are created sets the CellName for the default HomeCellAlias This parameter is used by the PROD publish environments of AtriumCMDB and CentralPublish origins.
229
You can modify the Notify ARDBC parameters in the following files: UNIX: arInstallDirectory/conf/ar.conf Windows: arInstallDirectory\conf\ar.cfg
After you make changes to these parameters, restart BMC Remedy AR System so the changes take affect. Table 60
Parameter
BMC-ARDBC-NOTIFY-Verify-Log
BMC-ARDBC-NOTIFY-Server-Port
port number for the server If 0 is specified, the plug-in allows the operating system to choose an available port and binds to that port. The actual port is visible in the NOTIFY:servers form.
If encryption is switched on (T), the NOTIFY:protocols property for the V1 protocol contains the key to use for encryption. If encryption is switched off (F), the NOTIFY:protocols property for the V1 protocol is empty.
BMC-ARDBC-NOTIFY-Mem-Trace
enables (T) or disables (F) memory tracing You should enable memory trace only when BMC Customer Support requests it.
F (False)
BMC-ARDBC-NOTIFY-Event-Cache
sets the number of events for the event cache 200 When the size is 0, event caching is disabled
230
1 From the computer running the Publishing Server, logon as Remedy User to the
individual AR Server Group Members.
2 Open the form, NOTIFY:Servers. 3 In the form NOTIFY:Servers, you should find one entry when you attempt to
retrieve the entries.
NOTE
If a Server Name Alias is set equal to one of the group members, the Publishing Server (the AR API client or Remedy User) cannot access the ARDBC vendor form NOTIFY:Servers of the plugin running on the node that is not the alias. Automated publishing will not function.
231
232
Chapter
initiate a service model publish create service model data (with a BAROC source file) create, initialize, and close publish environments request and review information about BMC Impact Publishing Server execution compare service model class definitions on cells with the class definitions in the BMC Atrium Configuration Management Database (BMC Atrium CMDB)
This appendix provides reference information on the BMC Impact Publishing Server CLIs. It contains the following topics: Configuring BMC Impact Publishing Server CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Configuration file and parameters for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Changing the time-out values for all the CLI commands . . . . . . . . . . . . . . . . . . . 240 Setting the configuration for a specific CLI command . . . . . . . . . . . . . . . . . . . . . 241 Configuring trace for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Configuring trace for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Understanding common command options for CLIs. . . . . . . . . . . . . . . . . . . . . . . . . . 241 Understanding return codes for CLIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 Using CLI commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Summary of CLI commands for BMC Impact Publishing Server . . . . . . . . . . . . 247 pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 penvManaging publish environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 pinitInitializing a cell with service model data . . . . . . . . . . . . . . . . . . . . . . . . . . 261 plogObtaining the XML log for a request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 plogdisplayConverting the XML log for a request to text format . . . . . . . . . . 266 pposterSending service model objects to a cell . . . . . . . . . . . . . . . . . . . . . . . . . . 268 pscontrolSending a command to BMC Impact Publishing Server. . . . . . . . . . 278 pserverStarting the BMC Impact Publishing Server service . . . . . . . . . . . . . . . 280 pshowlogObtaining the XML log in user-friendly format . . . . . . . . . . . . . . . . 281 psstatDisplaying status of BMC Impact Publishing Server . . . . . . . . . . . . . . . 282 publishPublishing a service model or viewing instances to be published . . . 283
Chapter 9
233
NOTE
As of version 7.3.00, Publishing Server CLIs no longer require authentication. However, the -i option remains viable for compatibility. If you specify the -i option, you do need to provide authentication credentials.
234
IASServers
specifies the BMC Impact Administration Server (usually by localhost: 3084 host name) that authenticates the CLI commands If you specify a remote BMC Impact Administration Server in the pclient.conf file but do not provide user credentials, you must provide them as command line arguments when you run a CLI command. Two BMC Impact Administration Servers can be setup as a high availability pair. To do this, you must enter both servers as a comma separated list, for example: primaryIAS:3084,secondaryIAS:3084 The p-CLIs first attempt to connect the BMC Impact Administration Server on the host primaryIAS. If that connection attempt fails, an attempt is made to connect to the BMC Impact Administration Server on the host secondaryIAS. Note that this is not only applicable to nodes of a high availability BMC Impact Administration Server pair. You can specify more than one independent BMC Impact Administration Server. The p-CLIs attempt to connect to the first BMC Impact Administration Server. If that connection attempt fails, an attempt is made to connect to the next server in the list and so on until a connection is successful.
ConnectionInitTimeout
5 seconds sets the length of time, measured in seconds, that a CLI command on making a request waits for the acknowledging reply from the BMC Impact Publishing Server, or if the Portal is not running, or the Portal's JMS service is not up and running Normally, the BMC Impact Publishing Server immediately acknowledges any request that it receives. If this time-out expires, it often indicates the BMC Impact Publishing Server is not receiving the request. For example, the BMC Impact Publishing Server service is not running.
Chapter 9
235
Table 61
Parameter
RequestTimeout
Locale
outputs messages in the language of the specified locale if message resource files for the language are defined. The format is language[_country]. Language is a valid 2-letter ISO Language Code as defined by ISO-639. Country is a valid 2-letter ISO Country Code as defined by ISO-3166. indicates whether the Publishing Server should look for additions, modifications, and soft deletions that are to be published. The option is set to T when an automated publication is triggered from a reconciliation job with Merge activity
Purge
F indicates whether the Publishing Server should look for hard deletions that are to be published. This option is set to T when an automated publication is triggered from a reconciliation job with Purge activity sets the password of a secured publish environment for the none execution of the publish CLI command indicates whether pposter should stop when encountering invalid data in the source file If ContinueOnFailure is set to T, true (default), pposter sends as much data as possible, skipping invalid data in the source file. If ContinueOnFailure is set to F, false, pposter stops as soon as invalid data in the source file is encountered and no data is sent to the cell, not even those items processed before the incorrect data in the source file. T
Password
Init
when set to T (true), pposter removes all existing data in the F cell of the publish environment and recopies the data in the input BAROC file to the cell when set to F (false), pposter incrementally updates the cell of the publish environment with data in the input BAROC file
Password
sets the password of a secured publish environment for the none execution of the pposter CLI command
236
Table 61
Parameter
AssetDataSetId AssetDataSetType
AssetUnderlyingDataSetId
BMC.ASSET
AutomatedPublish
enables (T) or disables (F) automated publishing on the publish environment The default value is T, except for an overlay publish environment (an overlay dataset which has a publish mode of overlay), which defaults to F. In this way, automated publication is by default enabled on PROD environment, and is disabled by default on test environments of BMC Impact Service Model Editor.
T (true)
CellAliases
defines cell alias and cell name pairs that are unique in a given environment, in the BAROC list of string format: [cellAlias,cellName[,cellAlias,cellName]] This parameter applies only on Direct Publish environments. For Atrium CMDB environments, cells aliases cannot be created or modified with the penv CLI command.
not defined
Cells
If cell aliases are not used, you can set this parameter as an alternative, in the BAROC list of string format: [cellName[,cellName]] This parameter applies only on Direct Publish environments.
not defined
CloseAliases
enables (T) or disables (F) the removal of aliases of an environment; this releases the cells for use in another environment enables (T) or disables (F) the removal of the asset dataset along with all objects in the dataset
F (false)
CloseAsset CloseCells
F (false)
enables (T) or disables (F) the removal of all data instances T (true) (including management data) of the service model from the cells specifies a description for the environment to BMC Asset EnvDesc sets the environment name to BMC Asset EnvId BMC Asset EnvDesc BMC Asset EnvId
EnvDesc EnvName
Chapter 9
237
Table 61
Parameter
Format
HomeCell
sets the cell to which the entire service model is published If set, CellAliases are not used.
not set
InitEffectivelyMgmtData
determines which asset management data instances, based on the value assigned to their ServiceModelSet class attribute, are removed from the BMC Atrium CMDB Before setting this parameter, please refer to InitEffectively parameters on page 206 which discusses the effect of the possible InitEffectivelyMgmtData settings on management data retention in or removal from the BMC Atrium CMDB.
IN, OUT
InitEffectivelyServiceModel
determines which service model component and impact relationship instances, based on the value assigned to their ServiceModelSet attribute, are removed from the BMC Atrium CMDB asset dataset Before setting this parameter, please refer to InitEffectively parameters on page 206 that discusses the effect of the possible InitEffectivelyServiceModel settings on SIM component instance retention in or removal from the BMC Atrium CMDB. By default, all service model component or impact relationship instances are not removed from the BMC Atrium CMDB. Asset instances with the ServiceModelSet attribute value of IN or OUT_OF_IN have their attribute value reset to OUT.
blank
specifies whether the service model is initialized, T (true) or T F (false) determines the amount of information display by the info 0 action command. Cell names and aliases are displayed only when -p Level=1 is part of the command string. sets a new password for a secured environment confirms a new password for a secured environment specifies the origin of the environment options are AtriumCMDB or DirectPublish not defined not defined AtriumCMDB
Password
not defined
238
Table 61
Parameter
PublishModeMgmtData
if Overlay, all instances of the overlay dataset, as well as the underlying dataset, are considered if Current, only instances of the overlay dataset are considered.
PublishModeServiceModel
determines the mask used when retrieving publishable components and impact relationships, if
AssetDataSetType = Overlay
Overlay
used when the dataset type is overlay, this parameter determines the mask used when retrieving publishable service model instances. if Overlay, all instances of the overlay dataset, as well as the underlying dataset, are considered if Current, only instances of the overlay dataset are considered.
SIM
enables (T) or disables (F) the classes that may be published T (true) for the Direct Publish environments only if T, only SIM classes may be published if F, components and relationships of MC_SM_COMPONENT, MC_SM_RELATIONSHIP, and all subclasses cannot be published
SourceBarocMgmtData
causes the import of initial management data from instances in the .baroc files pointed to in the .load file. Service model instances in those files are ignored. This parameter cannot be set if SourceEnvMgmtData is set.
causes the import of initial service model data from instances in the .baroc files pointed to in the .load file. Management data in those files are ignored. This parameter cannot be set if SourceEnvServiceModel is set.
Chapter 9
239
Table 61
Parameter
SourceEnvMgmtData
is set.
default value for all environments other than PROD. PROD, for reinitialization of environments other than PROD
SourceEnvServiceModel
causes initial service model data to be imported from instances in the asset dataset in the source environment EnvId. Data are created in the asset dataset of the environment. If the asset dataset of source environment is an overlay dataset and EnvId refers to an underlying regular dataset, then:
s s
If PublishModeServiceModel is Overlay, no instances are created in the overlay dataset. If PublishModeServiceModel is Current, all instances will be created in the overlay dataset.
ConnectionInitTimeout RequestTimeout
240
To set the configuration for specific CLI command 1 Make a copy of the pclient.conf file and name it CLIcommand.conf where
CLIcommand is the name of the CLI command for which you are creating a special configuration; for example: pposter.conf.
2 Save the file in the MCELL_HOME/etc directory. 3 Edit the new configuration file with a text editor and set the appropriate parameter
values. When the CLI command is run, the values in the appropriate configuration file are used. Alternately, you can use the -c option (see Understanding common command options for CLIs on page 241).
Chapter 9
241
Option Syntax
-c ConfigFile -h -? -i User/Password[@Host [/Port][,Host[/Port] [,...]]]
specifies a home directory other than MCELL_HOME for the command sets an option (Var) to the specified value (Value); this option modifies and overrides a value defined in the configuration file invokes quiet execution (no banner appears) retrieves the XML-formatted log file and stores it as
RequestLogFile
By default, the location of the log file is relative to the directory where you run the CLI. If you provide only a file name, the file is created in the directory where you run the CLI. You can also provide the absolute path for the log file.
-t ConnectionInitTimeout
specifies the length of time, in seconds, for the command to wait for a connection before terminating; default is 5 seconds
242
Table 62
Option Syntax
-u RequestTimeout
-v -z
Description indicates a syntax error on one or more command line arguments or options indicates an invalid number option
Recommended remedial action Verify the correct syntax for the command string. Verify the correct syntax for the numerical options such as -t and -u.
indicates that the home directory Do the following: (MCELL_HOME) of the application can not be found 1. Verify that the MCELL_HOME environment variable is set for the application. 2. Verify that the CLI script (.bat or .sh) file correctly contains: -DHomeLocation=%MCELL_HOME% 3. Specify the home directory (-l HomeLocation) path at the command line.
Chapter 9
243
Table 63
Error Exit Code 10
Recommended remedial action (This is an internal error.) Do the following: 1. Enable tracing and execute the command again to have a trace. 2. Locate the pcli.trace file to submit to BMC Software Support. pcli.trace is located in MCELL_HOME/tmp/pcli. 3. Contact BMC Software Support and file a user case for this failure.
11
indicates that the CLI is unable to initialize Retry the command. If the error still occurs, do the its communication layer following: 1. Verify that the URL of the provider specified in the pclient.conf file (in the MCELL_HOME/etc directory) is correct. 2. Restart the BMC Portal and BMC Impact Publishing Server. 3. Try the command again.
12
indicates a communication failure when the CLI sent data to its communication provider, for example, the jBoss server
Retry the command. If the error still occurs, do the following: 1. Restart the BMC Portal and BMC Impact Publishing Server. 2. Try the command again.
13
indicates that the CLI cannot decode an answer that it has received from its communication provider
(This is an internal error.) Do the following: 1. Enable tracing and execute the command again so there is an entry in the trace file. 2. Locate the pcli.trace file (MCELL_HOME/tmp/pcli ) to submit to BMC Software Support. 3. Contact BMC Software Support and file a user case for this failure.
14
indicates that the CLI cannot find a file that Verify that the file whose name appears as missing does it requires to run properly; for example a exist FileNotFound exception. indicates that the CLI cannot resolve a host Repair the computers network settings name
15
244
Table 63
Error Exit Code 16
Description indicates the failure to authenticate with the BMC Impact Administration Server
If you are running a CLI command, verify the credentials that you specified. If automatic authentication is set up in the pclient.conf file, verify that the credentials (IASUsername, IASPassword, and IASServers) are valid.
17
indicates an Impact interface initialization Do the following: failure; for example the I18N configuration may be wrong Verify that the file MCELL_HOME/etc/locale/pclient.load exists on the host where the pcli is running/installed. indicates that the UTF-8 character set is not The host computer must support the UTF-8 character supported by the host set. indicates that the CLI does not have a request identifier Do the following: 1. Enable tracing and execute the command again to generate a trace. 2. Locate the pcli.trace file (MCELL_HOME/tmp/pcli) to submit to BMC Software Support. 3. Contact BMC Software Support and file a user case for this failure.
18 19
20
indicates an I/O error when the publishing Verify that the write permission is set for the publishing log file is written request log file. You specify the name of the RequestLogFile for a CLI command by using the -r common option
Chapter 9
245
Recommended remedial action Do the following: 1. Verify that the MCELL_HOME environment variable is set for the application. 2. Verify that the CLI script (.bat or .sh) file correctly contains: -DHomeLocation=%MCELL_HOME% 3. Specify the home directory (-l HomeLocation) path at the command line.
2 3 4 5 6 7 9 10
indicates that the log/ps.lock file cannot be Ensure the pserver user has write access to created MCELL_HOME/log. indicates another Publishing Server is already running indicates the CMDB interface cannot initialize Verify with fuser (Unix) that a process is keeping a lock on ps.lock. If not, remove ps.lock. Verify ARServer and BMC Atrium CMDB settings and installation.
indicates the Impact Administration Server Verify BMC Impact Administration Server settings and interface cannot initialize installation. indicates a configuration file is missing indicates an I/O exception occurred on a configuration file indicates a syntax error Provide the configuration file. Ensure the pserver user has write access to the configuration file. Check the syntax you used for the command and try the command again.
246
Table 64
Error Exit Code 11
Description
indicates the home directory does not exist Do the following: 1. Verify that the MCELL_HOME environment variable is set for the application. 2. Verify that the CLI script (.bat or .sh) file correctly contains: -DHomeLocation=%MCELL_HOME% 3. Specify the home directory (-l HomeLocation) path at the command line.
12 13
Ensure the pserver user has write access to the home directory.
indicates an I/O exception occurred during Ensure the pserver user has write access to the creation of the MCELL_HOME/tmp. HomeLocation/tmp/ps.trace file indicates the publish environments cannot be initialized Verify that the SIM CMDB extension of the same version as the Publishing Server is installed.
14
Chapter 9
247
Table 65
Command
pclassinfo
penv
enables you to set up advanced environments and staging 252 scenarios beyond the abilities of the Send to Test commands available in BMC Impact Service Model Editor initializes or reinitializes cells with service model impact data obtains the XML log for a specific service model publishing request and routes it to standard output Use this command with the plogdisplay command. 261 265
pinit plog
plogdisplay pposter
displays the XML log for a specific service model publishing in text format to standard output sends SIM elements, such as component instances, relationships, and management data to cells by using the BMC Impact Publishing Server sends a specific command (automated, manual, stop) to the BMC Impact Publishing Server starts the BMC Impact Publishing Server service or daemon The major differences between pserver and the other BMC Impact Publishing Server CLI commands are:
s s
266 268
pscontrol pserver
278 280
s s
the exit codes are different pserver is the BMC Impact Publishing Server itself, while the others are CLI commands that communicate with the server the configuration files and tracing files are different although possible, the process for copying pserver to another computer is different, and performance considerations should be taken into account 281
pshowlog
obtains the XML log for a specific service model publishing request plus the prior publishing request and routes it in readable format to standard output returns the status (starting, started, or stopping) and mode (automated or manual) of the BMC Impact Publishing Server publishes service model or displays (-w) the service model objects to be published
psstat
282
publish
283
248
pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB
pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB
Use the pclassinfo command to
s
compare the service model class definitions on a specific cell or cells with the service model class definitions in the BMC Atrium CMDB and list the differences between them. export the service model class definitions from the BMC Atrium CMDB.
pclassinfo syntax
pclassinfo <common options> [-n cellName1[,cellName2[...]] |-a | -x] [-o OutputFile] [-s Description]
-n cellName1[,cellName2[...]]
Chapter 9
249
pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB
Table 66
Options
-o OutputFile
-s description -x
describe request exports service model class definitions from the BMC Atrium CMDB to standard output or if an output file (-o option) is specified to a file Service model class definitions are exported in BAROC language format.
pclassinfo examples
This section contains several examples of the pclassinfo command including:
s
exporting service model class definitions from the BMC Atrium CMDB to standard output exporting service model class definitions from the BMC Atrium CMDB to a file comparing cell service model class definitions with those in the BMC Atrium CMDB
Exporting service model class definitions from the BMC Atrium CMDB To export the service model class definitions in the BMC Atrium CMDB to standard output, type the following command:
pclassinfo -x
This command generates a listing of the service model class definitions defined in the BMC Atrium CMDB and outputs it to standard output. To export the service model class definitions in the BMC Atrium CMDB to a specific file, type the following command:
pclassinfo -x -o fileName
250
pclassinfoComparing service model classes on cells with class definitions in the BMC Atrium CMDB
The service model class definitions are written to a BAROC file with the specified name. You can load this file on a cell.
Comparing cell service model class definitions with those in the BMC Atrium CMDB
To compare the service model class definitions in the cell whose name is the shortversion of its host computer name (the default cell name) with the definitions in the BMC Atrium CMDB, type the following command:
pclassinfo
If there are no differences between the service model class definitions on the cell and those defined in the BMC Atrium CMDB, the command returns output similar to the following:
MCELL_HOME\bin>pclassinfo BMC Impact Service Model Class Retriever v7.2.00 (Build 1544975.000 20-May-2008) Copyright 2005-2008 BMC Software, Inc. as an unpublished work. All rights reserved. Class info is synchronized.
If there are differences between the service model class definitions on the cell and those defined in the BMC Atrium CMDB, the command returns the differences, which appear similar to the following:
MCELL_HOME\bin>pclassinfo BMC Impact Service Model Class Retriever v7.2.00 (Build 1544975.000 20-May-2008) Copyright 2005-2008 BMC Software, Inc. as an unpublished work. All rights reserved. -- BEGIN DIFFS -<PreviewItem><Im>arwad</Im><SlotAdd><Class>BMC_BaseElement</Class><S lot>VersionNumber</CmdbSlot></SlotAdd></PreviewItem> <PreviewItem><Im>arwad</Im><ClassAdd><CmdbClass>BMC_Region</CmdbClas s></ClassAdd></PreviewItem> -- END DIFFS -Class info is not synchronized
To compare the service model class definitions in a specific cell with those defined in the BMC Atrium CMDB on Windows platforms, type the following command:
pclassinfo -n cellName
Chapter 9
251
NOTE
On Windows platforms, you must enclose the cell list in quotation marks (").
This command returns the differences, if there are any, between the service model class definitions on the cell named with those defined in the BMC Atrium CMDB. To compare the service model class definitions for all the cells registered with the BMC Impact Portal with those defined in the BMC Atrium CMDB, type the following command:
pclassinfo -a
This command returns the differences, if any, found between the classes defined in the BMC Atrium CMDB and the service model class definitions on all the cells found by the BMC Impact Publishing Server.
NOTE
When performing a penv init of a large service model the Stack Size and the Heap Size of the Publishing Server might need to be increased. For more information, see Publishing large service models on page 293
252
penv syntax
penv <common options> [-f] (-e EnvId (close | init | open | set)|[-e EnvID] info)
If Cells contains a single element, then this cell name is used to publish all data, regardless of any cell information found in the data. If Cells contains more than one element, then for components and relationships, the destination cell must be found through the data instance: For components, the attribute HomeCell is first searched, then HomeCellAlias is searched. For relationships, the attribute consumer_home_cell is searched, then Consumer.HomeCellAlias is searched.
If no valid destination cell is found, publish fails. If HomeCellAlias is used then CellAliases must be set, otherwise publish fails.
Management data or non-SIM data (that is, instances other than components or relationships) are published to all cells.
Chapter 9
253
Table 67
Option
-e EnvID
-f
forces the command execution without prompting the user to confirm the initialization action. If the -f option is not specified, you are prompted to confirm command execution.
-s description
describe request
requirements, depending on the type of environment, Atrium Publish or Direct Publish, as described in Table 68. Table 68
action command close
254
Table 68
action command info
Specific to BMC Atrium CMDB environments all parameters are valid except CellAliases
Specific to Direct Publish environments relevant parameters are CellAliases, Format, HomeCell, Level, and
OriginId
to display column headings, use the -v option to display cell alias information, use the -p Level=1 option Display characteristics are when HomeCell is not set, a empty string is returned () cell alias values may include blank characters cell name values do not include blank characters values containing blank characters are quoted according to the rules for quoting BAROC strings
init
initializes (or reinitializes) the asset and impact datasets of the specified environment creates the asset and impact datasets of also stores the settings for the specified environment and stores the environment in the environment settings in the cell BMC Atrium CMDB after the environment is opened, you cannot modify values for PublishModeServiceModel or PublishModeMgmtData parameters
not applicable
open
data is stored only in the cell (and the source file); there is no secondary datastore
set
you can reset only parameters HomeCell, Cells, and CellAliases, Password, NewPassword1, and NewPassword2
Chapter 9
255
Table 69
Parameter name
AssetDataSetId AssetDataSetType AssetUnderlyingDataSetId
AutomatedPublish
yes
CellAliases
yes
yes
CloseAliases
enables (T) or disables (F) the removal of aliases of an environment; this releases the cells for use in another environment enables (T) or disables (F) the removal of the asset dataset along with all objects in the dataset
yes
CloseAsset
yes
CloseCells
enables (T) or disables (F) the removal yes of all data instances (including management data) of the service model from the cells describes the environment specifies the name of the environment specifies to which cell to publish. If HomeCell is set, the entire service model is published to the specified cell. In this case, CellAliases are not used defines the information displayed with
info
Format InitEffectivelyMgmtData
yes yes
determines which asset management data instances, based on their ServiceModelSet attribute, are removed from the BMC Atrium CMDB See Configuration file and
256
Table 69
Parameter name
InitMgmtData
specifies whether management data are initialized, T (true) or F (false) See Configuration file and
yes
specifies whether the service model is initialized, T (true) or F (false) See Configuration file and
yes
determines the amount of information display by the info action command specifies a new password confirms a new password defines the source of the service model yes data specifies a password for authentication yes defines whether management data should be approached as overlay or as regular dataset defines whether components and impact relationships should be approached as overlay or as regular dataset causes the import of initial management data from instances in the .baroc files pointed to in the .load file. causes the import of initial service model data from instances in the .baroc files pointed to in the .load file. causes initial management data to be imported from instances of the source environment EnvId. causes initial service model data to be imported from instances in the asset dataset in the source environment EnvId. Data are created in the asset dataset of the environment.
yes yes yes yes yes yes yes yes yes yes yes
PublishModeServiceModel
yes
SourceBarocMgmtData
yes
SourceBarocServiceModel
yes
SourceEnvMgmtData
yes
SourceEnvServiceModel
yes
Chapter 9
257
Parameter name
CellAliases Cells Format HomeCell
penv examples
This section contains examples of penv info. For other examples of penv, see Examples of advanced environments on page 200.
258
Example 1includes cell names and cell aliases, but no column headings
In example 1, Atrium Publish environments are displayed and cell names and cell aliases are displayed because the -p Level=1 option is used, but column headings are missing because the -v option is not used.
EXAMPLE
$ penv -p "OriginId=AtriumCMDB" -p "Level=1" info BMC Impact Publishing Server Environment Manager v7.0 (Build 666.343 - 05/21/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Request received and accepted by the Publishing Server requestId=Z00000emahxa59Xp9yZhyMZ6zowkZ AtriumCMDB Ghislain.TEST.1 BMC.ASSET.Ghislain.TEST.1 Overlay Current F cell1 cell2 cell3 test_ghislain test_ghislain test_ghislain BMC.IMPACT.Marcelle.TEST.1 BMC.IMPACT.PROD Overlay Regular BMC.IMPACT.Ghislain.TEST.1 Overlay
Marcelle.TEST.1 BMC.ASSET.Marcelle.TEST.1 Overlay Current F imtest PROD cell1 cell2 cell3 BMC.ASSET cell1 cell2 cell3
EXAMPLE
$ penv -p "OriginId=AtriumCMDB" -p "Format=Raw" -p "Level=1" info BMC Impact Publishing Server Environment Manager v7.0 (Build 666.343 - 05/21/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Request received and accepted by the Publishing Server requestId=Z00000emahxa59Xp9sZhyMZ6zowkZ AtriumCMDB Ghislain.TEST.1 BMC.ASSET.Ghislain.TEST.1 BMC.IMPACT.Ghislain.TEST.1 Overlay Current Current F '' 3 cell1 test_ghislain cell2 test_ghislain cell3 test_ghislain Marcelle.TEST.1 BMC.ASSET.Marcelle.TEST.1 BMC.IMPACT.Marcelle.TEST.1 Overlay Current Current F imtest 0 PROD BMC.ASSET BMC.IMPACT.PROD Regular T '' 3 cell1 cell1 cell2 cell2 cell3 cell3
Chapter 9
259
EXAMPLE
$ penv -p "OriginId=AtriumCMDB" -p "Level=1" -v info BMC Impact Publishing Server Environment Manager v7.0 (Build 666.343 - 05/21/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Request received and accepted by the Publishing Server requestId=Z00000emahxa59Xp9uZhyMZ6zowkZ OriginId: AtriumCMDB -----------------------------------------------------------------------------------EnvId AssetDataSetId ImpactDataSetId AssetDataSetType PublishModeMgmtData PublishModeServiceModel AutomatedPublish HomeCell Ghislain.TEST.1 BMC.ASSET.Ghislain.TEST.1 BMC.IMPACT.Ghislain.TEST.1 Overlay Overlay Current F CellAlias CellName cell1 test_ghislain cell2 test_ghislain cell3 test_ghislain -----------------------------------------------------------------------------------------------------------------------------------------------------------------------EnvId AssetDataSetId ImpactDataSetId AssetDataSetType PublishModeMgmtData PublishModeServiceModel AutomatedPublish HomeCell Marcelle.TEST.1 BMC.ASSET.Marcelle.TEST.1 BMC.IMPACT.Marcelle.TEST.1 Overlay Overlay Current F ImTest -----------------------------------------------------------------------------------EnvId AssetDataSetId ImpactDataSetId AssetDataSetType PublishModeMgmtData PublishModeServiceModel AutomatedPublish HomeCell PROD BMC.ASSET BMC.IMPACT.PROD Regular T CellAlias CellName cell1 cell1 cell2 cell2 cell3 cell3 -------------------------------------------------------------------------------------
260
EXAMPLE
$ penv -p "OriginId=DirectPublish" -p "Level=1" -v info BMC Impact Publishing Server Environment Manager vDeveloper-ppa (Build 666.343 xx/xx/2008) Copyright 2005-2008 BMC Software, Inc. as an unpublished work. All rights reserved. Request received and accepted by the Publishing Server requestId=Z00000f48fmlfkXp9tZdlMZ3dbyuZ OriginId: DirectPublish -----------------------EnvId HomeCell direct direct_cell -----------------------EnvId HomeCell direct_2 CellAlias CellName direct_al_1 d_cell_1 direct_al_2 d_cell_2 -----------------------EnvId HomeCell direct_3 direct_cell_3 ------------------------
Chapter 9
261
For more information for a Direct Publish environment, see Initializing a cell from a Direct Publish environment on page 220.
NOTE
When performing a pinit of a large service model the Stack Size and the Heap Size of the Publishing Server might need to be increased. For more information, see Publishing large service models on page 293.
pinit syntax
pinit <common options> [-f] [-n cellName1[,cellName2[...]] |-a ] -e EnvId [-s Description]
see Understanding common command options for CLIs <common options> -c -h -? -i -q -l -p - on page 241 t -v -z
-a initializes HomeCell or the cells defined by CellAliases If one or more of the cells cannot be initialized (for example, because a cell is not running), none of them are initialized and the request fails. -f forces the cell initialization without prompting you to confirm the initialization action If the -f option is not specified, you are prompted to confirm the initialization action.
262
Table 71
Option
-n cellName1[,cellName2[ ...]]
-s description -e environmentID
describes request sets environment identifier to environmentID. The default value is PROD. It specifies either an Atrium CMDB environment or a Cell Publish environment, depending on the value of OriginId. For example, OriginId=AtriumCMDB or OriginId=CellPublish).
When you execute a pinit command for a specific environment, only the data for that environment is reinitialized. So, if the same cell contains different environments (for example, Atrium Publish and CellPublish), then only part of the cells data is reinitialized.
pinit examples
This section provides examples of using the pinit command to initialize or reinitialize a cell with service model data.
Initializing a cell with the production service model data from the BMC Atrium CMDB
To initialize or reinitialize the cell whose name is the short host name (default cell name) with the BMC Atrium CMDB production service model, type the following command. (The short host name is the unqualified version of the host computer name.)
pinit
Chapter 9
263
Initializing a specific cell with the BMC Atrium CMDB production service model To initialize a specific cell named jana with the BMC Atrium CMDB production service model, type the following command:
pinit -n jana
Initializing all BMC Impact Portal-registered cells with the BMC Atrium CMDB production service model
To initialize all the cells registered with the BMC Impact Portal with the BMC Atrium CMDB production service model, type the following command.
pinit -a
If one or more of the specified cells cannot be initialized, for example, if a cell is not running, none of them are initialized and the request fails.
This command removes all data of the service model in the Direct Publish environment Sales. In the cell, this corresponds to data that has the slot publish_env_id set to DirectPublish.Sales. If the BMC Impact Publishing Server has both Atrium CMDB and Direct Publish enabled, then you must specify OriginId=DirectPublish, either in the pclient.conf file or in the CLI penv command string as -p OriginId=DirectPublish.
264
plog syntax
plog <common options> RequestID [-r] [-s] [-w]
plog options
Description
plog examples
This section provides examples of using the plog command to obtain and output the XML log for a specific service model publishing request.
Chapter 9
265
Viewing the XML log for a specific publishing request as a text in stdout
To obtain the XML publishing log for a specific publishing request, convert it to text format, and output it to standard output for viewing, type a command similar to the following, substituting the request ID:
plog -s Z00000e8mu7xw9Xpa1ZfsMZeg4v1Z | plogdisplay -@
Using this command, you pipe the output of the plog command through the plogdisplay command to convert it to text format for output. See plogdisplay Converting the XML log for a request to text format on page 266.
plogdisplay syntax
plogdisplay <common options> (-@ | RequestLogFile)
266
Table 73
Option
plogdisplay options
Description
see Understanding common command options for CLIs on page 241 This command does not interact with the BMC Impact Publishing Server so it does not accept these CLI common options: -r, -t, and -u.
You do not need to authenticate a user with the BMC Portal when using this command. If you do include the authentication option (-i), the user is authenticated.
-@ | RequestLogFile
Use -@ to indicate standard input as the source to display. For a specific publishing request, type the name of the XML log file as the source to display.
plogdisplay examples
This section provides examples of using the plogdisplay command to convert an XML log file for a publishing request to text and output it to standard output.
Viewing the XML log for a specific publishing request as a text in stdout
You pipe the output of the plog command through the plogdisplay command to convert it to text format and output it to standard output. To view a specific publishing log in text format, type the following command:
plog -r -s Z00000e8mu7xw9Xpa1ZfsMZeg4v1Z | plogdisplay -@
Chapter 9
267
a number error other than 0 When a CLI command exits with a return value other than 0, additional textual information on the error cause is displayed to standard output and, possibly, to the generated publishing CLI trace file pcli.trace. For information about these error codes, see Understanding return codes for CLIs on page 243.
For more information about creating environments and the penv command, penv Managing publish environments on page 252.
pposter syntax
pposter <common options> -e EnvId sourceFile {sourceFile}
268
pposter options
Description
If SIM is set to T, true (default), pposter publishes components (instances of subclasses of MC_SM_COMPONENT) and impact relationships (instances of subclasses of MC_SM_RELATIONSHIP) to their HomeCell. Instances of all other classes are considered Service Impact Management Data and are published to all cells of the environment. If SIM is set to F, false, pposter publishes data other than SIM data. It is not possible to publish components (instances of subclasses of MC_SM_COMPONENT) and impact relationships (instances of subclasses of MC_SM_RELATIONSHIP). All data is always published to all cells of the environment. If Init is set to F, false (default) or omitted, then existing data is updated with the new data. If Init is set to T, true, then existing published data is replaced with the data of the Baroc file. In other words, existing published data of the DirectPublish publish environment is removed and new data as defined in the Baroc file is added. If the data in the Baroc file has no mc_udid, then the new data will have mc_udid that differs from the existing data. To remove all published data of a DirectPublish publish environment from a cell, execute pposter -p "Init=T" with an empty Baroc file or without Baroc file. When using Init=T, pposter requires confirmation (-f option).
Init=T/F
sourceFile
file that contains the data to send See Source files for pposter on page 270.
Chapter 9
269
If ContinueOnFailure is set to F, false (default), pposter stops as soon as invalid data in the source file is encountered and no data is sent to the cell, not even those items processed before the incorrect data in the source file. If ContinueOnFailure is set to T, true, pposter sends as much data as possible, skipping invalid data in the source file.
For each data instance, provide a value for mc_udid. You can publish new data instances without specifying a value for mc_udid, but the mc_udid is still needed to modify or delete the existing data in cell, except if all existing data is replaced when publishing. For environments that do not have a value for the HomeCell slot, you must provide a value for the HomeCell slot for each component, and a value for the provider_home_cell and the consumer_home_cell slots for each relationship. A relationship is sent to the cell of its consumer component. For relationships in which the consumer and provider components belong to different cells, you must specify a value for the provider_classname slot. See pposter example 2two cells on page 273. You can also use cell aliases by specifying values for HomeCellAlias for components, and Consumer.HomeCellAlias and Provider.HomeCellAlias for relationships. Since these slots do not exist in the class definition of the cell, BMC Impact Publishing Server uses the alias table of the environment and replaces them with the values in the HomeCell, consumer_home_cell and provider_home_cell slots. See pposter example 3using cell aliases on page 275.
270 BMC Impact Solutions Service Modeling and Publishing Guide
Data instances, possibly prepended with dnew (+ or -), dmodify, or ddelete commands, must terminate with END, followed by a Return.
pposter example 1
This example shows how to create a simple service model, modify the service model, and delete the service model. The service model consists of three objects: an application (comp0), that depends on a database (comp1), and the relationship between the two. The environment is MY_ENV and the HomeCell is MY_HOMECELL.
EXAMPLE
BMC_DataBase; mc_udid = comp0; Name = comp0; END BMC_Application; mc_udid = comp1; Name = comp1; END BMC_Impact; mc_udid = rel; provider_id = comp0; consumer_id = comp1; PropagationModel = DIRECT; Name = comp1; END
To send this new service model to the cell, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDnew.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
Chapter 9
271
EXAMPLE
dmodify BMC_DataBase; mc_udid = comp0; ImpactCostPerSec = 5; ImpactCostPerSecOut = 2; END
To send this modification to the service model to the cell, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDmodify.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
EXAMPLE
ddelete BMC_DataBase; mc_udid = rel; END ddelete BMC_Application; mc_udid = comp0; END ddelete BMC_Impact; mc_udid = comp1; END
To send this deletion of the service model to the cell, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDdelete.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
272
EXAMPLE
BMC_DataBase; HomeCell = cell_1; mc_udid = comp0; Name = comp0; END BMC_Application; HomeCell = cell_2; mc_udid = comp1; Name = comp1; END BMC_Impact; provider_home_cell = cell_1; consumer_home_cell = cell_2; provider_classname = BMC_DataBase; mc_udid = rel; provider_id = comp0; consumer_id = comp1; PropagationModel = DIRECT; END
To send this new the service model to the cells, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDnew.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
Chapter 9
273
EXAMPLE
dmodify BMC_DataBase; HomeCell = cell_1; mc_udid = comp0; ImpactCostPerSec = 5; ImpactCostPerSecOut = 2; END
To send this modification to the service model to the cells, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDmodify.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2008) Copyright 2005-2008 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
EXAMPLE
ddelete BMC_DataBase; HomeCell = cell_1; mc_udid = rel; END ddelete BMC_Application; HomeCell = cell_2; mc_udid = comp0; END ddelete BMC_Impact; consumer_home_cell = cell_1; mc_udid = comp1; END
To send this deletion of the service model to the cell, at the command prompt, type the following command:
274
EXAMPLE
pposter -v -e MY_ENV FileDdelete.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
EXAMPLE
BMC_DataBase; HomeCellAlias = c_alias_1; mc_udid = comp0; Name = comp0; END BMC_Application; HomeCellAlias = c_alias_2; mc_udid = comp1; Name = comp1; END BMC_Impact; Provider.HomeCellAlias = c_alias_1; Consumer.HomeCellAlias = c_alias_2; provider_classname = BMC_DataBase; mc_udid = rel; provider_id = comp0; consumer_id = comp1; PropagationModel = DIRECT; END
Chapter 9
275
To send this new the service model to the cells, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDnew.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
EXAMPLE
dmodify BMC_DataBase; HomeCellAlias = c_alias_1; mc_udid = comp0; ImpactCostPerSec = 5; ImpactCostPerSecOut = 2; END
To send this modification to the service model to the cell, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDmodify.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
276
EXAMPLE
ddelete BMC_DataBase; HomeCellAlias = c_alias_1; mc_udid = rel; END ddelete BMC_Application; HomeCellAlias = c_alias_2; mc_udid = comp0; END ddelete BMC_Impact; Consumer.HomeCellAlias = c_alias_2; mc_udid = comp1; END
To send this deletion of the service model to the cell, at the command prompt, type the following command:
EXAMPLE
pposter -v -e MY_ENV FileDdelete.baroc BMC Impact Publishing Server Data Poster vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Publish successfully applied.
Return Code
51
BMC Impact Publishing Server refused to initiate the publish process. The actual cause of the error (for example, another publish is in progress) is displayed on the standard error device. An error is returned by BMC Impact Publishing Server when data are being sent to it. For more information, see the publish log; the -v option provides more detail.
52
Chapter 9
277
Table 76
53
Return Code
54 55
There is a syntax or invalid BAROC object in the source file. There is an I/O error with a source file, for example, no source file or the source file cannot be opened.
pscontrol syntax
pscontrol [-c ConfigFile] [-h|-?] [-i User/Password[@Host[/Port] [,Host[/Port] [,...]]] [-q] [-l HomeLocation] {-p "Var=Value"} [-t ConnectionInitTimeout] [-u RequestTimeout] [-v] [-z] [-f] (automated | manual | stop)
278
Table 77
Options
automated manual
pscontrol examples
This section contains examples of usage of the pscontrol command. Figure 29 contains an example of the pscontrol stop command, which stops the BMC Impact Publishing Server. Figure 29 pscontrol stop example
$ pscontrol stop BMC Impact Publishing Server Controller vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2006 BMC Software, Inc. as an unpublished work. All rights reserved. Please confirm control command (stop) (type y (yes) / n (no). Default is n): y Publishing Server is stopping
Figure 30 contains an example of the pscontrol automated command, which restarts automated publishing. Figure 30 pscontrol automated example
pscontrol -f automated BMC Impact Publishing Server Controller vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2006 BMC Software, Inc. as an unpublished work. All rights reserved. Automated publishing is starting
Figure 31 contains an example of the pscontrol automated command using the -u option. Figure 31 pscontrol automated -u example
pscontrol -f -u 300 automated BMC Impact Publishing Server Controller vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2006 BMC Software, Inc. as an unpublished work. All rights reserved. Automated publishing is starting Automated publishing is started
Chapter 9
279
Figure 32 contains an example of the pscontrol manual command, which stops automated publishing. Figure 32 pscontrol manual example
pscontrol manual BMC Impact Publishing Server Controller vDeveloper-ppa (Build 666.343 - xx/xx/2007) Copyright 2005-2007 BMC Software, Inc. as an unpublished work. All rights reserved. Please confirm control command (manual) (type y (yes) / n (no). Default is n): y Automated publishing is stopping
pserver syntax
pserver [-b psname] [-c ConfigFile] [-d] [-h|-?] [-q] [-l HomeLocation] {-p "Var=Value"} [-v] [-z]
-b psname
identifies the name of the BMC Impact Publishing Server; defaults to ps_hostname
280
pshowlog syntax
pshowlog [ -i User/Password[@Host[/Port][,Host[/Port][,...]]] requestId | -h
pshowlog options
Description
Any non-supported options added to the pshowlog command results in the usage being printed to stdout (standard out).
pshowlog example
This section provides examples of using the pshowlog command to obtain and output the XML log in readable format for a specific service model publishing request. Type a command similar to the following, substituting the request ID in this example:
pshowlog Z00000e8mu7xw9Xpa1ZfsMZeg4v1Z
To pass the Impact Administration Server host name and port number, type a command similar to this example:
Chapter 9
281
psstat syntax
psstat [-c ConfigFile] [-h|-?] [-i User/Password [@Host[/Port] [,Host[/Port] [,...]]] [-q] [-l HomeLocation] {-p "Var=Value"} [-t ConnectionInitTimeout] [-u RequestTimeout] [-v] [-z]
psstat examples
This section provides examples of using the psstat command to view the status of the BMC Impact Publishing Server and whether it is in automated or manual mode.
282
publish the service model without viewing what is being published (default) view the service model instances, including components, relationships, and management data instances that are marked for publishing publish the entire service model or selected service model class instances and view a listing of the component, relationship, and management data instances being published
publish syntax
publish <common options> [-d ClassName.UdId[,ClassName.UdId[,...]]] [-e EnvId] [-w [-o File] [-m]] [-s Description]
Chapter 9
283
-o OutputFile
-w -s description -e environmentID
publish examples
This section provides examples of using the publish command to view the service model class instances to be published (including components, relationships, and management data) and to publish them.
284
To view the service model objects that have been hard-deleted from the production asset dataset, but that still exist in cells, and then to publish the deletions to the cells, type the following command:
publish -p Purge=T -p Merge=F -w -m
Chapter 9
285
286
Appendix
A
288 288 292 292 293 293 293 293 295 296 296 297 297 298 302 303 303 303 304
Troubleshooting
This section describes problem solving for the BMC Impact Service Model Editor, the BMC Impact Publishing Server, and the BMC Impact Service Model Integration with HP OpenView Operations. BMC Impact Service Model Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the BMC Impact Service Model Editor log. . . . . . . . . . . . . . . . . . . . . . . . . . Other BMC Impact Service Model Editor Troubleshooting Options . . . . . . . . . BMC Impact Publishing Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verifying that BMC Impact Publishing Server is running . . . . . . . . . . . . . . . . . . Using trace files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Stopping BMC Impact Publishing Server when JMS is not running . . . . . . . . . . Publishing large service models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Publishing failures and reattempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BMC Impact Publishing Server service or daemon fails to start . . . . . . . . . . . . . No publication after successful promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reconciliation jobs hang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BMC Impact Publishing Server does not reply to requests. . . . . . . . . . . . . . . . . . Diagnosing publication failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Another publish request is ongoing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using dynamic ports with the ARDBC Notify plug-in . . . . . . . . . . . . . . . . . . . . . BMC Impact Service Model Integration with HP OVO . . . . . . . . . . . . . . . . . . . . . . . . Avoiding duplicate CIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Automated publication after reconciling reconciliation failure . . . . . . . . . . . . . .
Appendix A
Troubleshooting
287
By default, this log captures startup and shutdown information. To record different levels of information for debugging purposes, see To set log file preferences on page 155. The following illustration depicts representative log entries of the BMC Impact Service Model Editor GUI log.
Nov 27, 2006 4:57:08 PM [Seq: 0, ID: BMCSME001010, Level: INFO] FindPanel Creation done Nov 27, 2006 4:57:09 PM [Seq: 2, ID: BMCSME000006, Level: INFO] Service Model Editor console started. Version: 5.0.0 Build: 1124943 Nov 27, 2006 4:57:42 PM [Seq: 3, ID: BMCSME000018, Level: INFO] Loaded 1 workspaces from server. Nov 27, 2006 5:01:03 PM [Seq: 4, ID: BMCSME000004, Level: INFO] Logging level changed to ALL.
Outside BMC Impact Service Model Editor, you can enable the log for the BMC Impact Service Model Editor server and the Java Web Start console.
288
the BMC Portal log file a console window a console window and the JBoss log file
To send BMC Impact Service Model Editor Server debug output to the BMC Portal log file 1 In an appropriate editor, open the
BMC_PORTAL_KIT_HOME/appserver/websdk/tools/jboss/server/all/conf/log4j.xml.
2 Add the following appender and category elements under the Setup the Root
Category heading.
<appender name="CLUSTER" class="org.jboss.logging.appender.RollingFileAppender"> <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/> <param name="Threshold" value="DEBUG"/> <param name="File" value="${jboss.server.home.dir}/log/portal.log"/> <param name="Append" value="true"/> <param name="MaxFileSize" value="100MB"/> <param name="MaxBackupIndex" value="10"/> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="<%5.1p,%d{MM/dd/yy HH:mm:ss z},%c{1}> %m%n"/> </layout> </appender> <category name="com.bmc.sms.sme"> <priority value="DEBUG"/> <appender-ref ref="SME_FILE"/> </category>
Appendix A
Troubleshooting
289
To send BMC Impact Service Model Editor Server debug output to a console window 1 In an appropriate editor, open the
BMC_PORTAL_KIT_HOME/appserver/websdk/tools/jboss/server/all/conf/log4j.xml.
2 Add the following appender and category elements under the Setup the Root
Category heading.
<appender name="SME_CONSOLE" class="org.apache.log4j.ConsoleAppender"> <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/> <param name="Target" value="System.out"/> <param name="Threshold" value="DEBUG"/> <layout class="org.apache.log4j.PatternLayout"> <!-- Since sdk logger prints its own context info, we shorten the context info from log4j and use the following format: <last letter of Priority,Date,Category> Message\n --> <param name="ConversionPattern" value="<%5.1p,%d{MM/dd/yy HH:mm:ss z},%c{1}> %m%n"/> </layout> </appender> <category name="com.bmc.sms.sme"> <priority value="DEBUG"/> <appender-ref ref="SME_CONSOLE"/> </category>
3 To view debug output in a console window, start the BMC Impact Portal from a
shell window:
s
For Windows, open a Command Prompt window, and enter the following command:
BMC_PORTAL_KIT_HOME\appserver\websdk\bin\run.bat
For Solaris, open a terminal window, and enter the following command:
BMC_PORTAL_KIT_HOME/tools/jboss/bin/jboss.sh
290
To send BMC Impact Service Model Editor Server debug output to a console window and the BMC Portal log file 1 In an appropriate editor, open the
BMC_PORTAL_KIT_HOME/appserver/websdk/tools/jboss/server/all/conf/log4j.xml.
2 Add both sets of appender and category elements for sending output to the BMC
Portal log and to a console window as described in the preceding two procedures.
3 Add the following ref subelement pointing to the SME_FILE under the category
element with the value com.bmc.sms.sme.
<category name="com.bmc.sms.sme"> <priority value="DEBUG"/> <appender-ref ref=SME_CONSOLE/> <appender-ref ref="SME_FILE"/> </category>
NOTE
The appender element FILE is defined under the Preserve Messages in a local file heading of the default log4j.xml file.
To enable Java Web Start logging 1 Open the Java Web Start Application Manager console in one of the following
ways:
s s
Double-click the Java Web Start icon on your desktop. Under Windows, choose Start => Programs => Java Web Start => Java Web Start or, from the Command Prompt, execute the following command:
%JAVA_HOME%\jre\javaws\javaws.exe
2 In the Java Web Start Application Manager console, choose File => Preferences. 3 On the Advanced tab, in the Output Options area, select Log Output. 4 To select an existing file, click Choose Log File Name, or enter a file path in the Log
File Name box.
Appendix A
Troubleshooting
291
5 Click OK.
3 Kill the BMC Impact Publishing Server process by executing the command:
fuser -k ps.lock
Appendix A
Troubleshooting
293
In the pserver.conf file, the configuration parameter ARSXLongTimeOut may not be set high enough. This parameter specifies the time out value for the communication between BMC Impact Publishing Server and the BMC Atrium CMDB. Reinitialization of a cell (pinit) and a new, successful publication are necessary to avoid subsequent publication job failure with the message Unique data identifier not/already in use. By default, BMC Impact Publishing Server estimates the timeout needed. If the timeout is not adequate, set ARSXLongTimeOutEstimate=F and increase ARSXLongTimeOut. If publication fails during the database update with the message Failure while applying publish on CMDB - Error - 92 Timeout, the operation has been accepted by the server and will usually complete successfully, the value for ARSXLongTimeOut is not set high enough and expires before the BMC Atrium CMDB has terminated committing modifications in the impact dataset. The BMC Atrium CMDB continues to commit modifications in the impact dataset and after a while the service model will be available in the impact dataset. Make sure the parameters are set correctly. The same failure may happen when initializing CMDB with large service models.
In the MCELL_HOME/etc/smmgr.conf file, the DestinationBufferKeepSent parameter is the timeout for communication between smmgr and the cell. In the MCELL_HOME/etc/pserver.conf file, the SMMMessageBufferKeepSent parameter is the timeout for communication between BMC Impact Publishing Server and smmgr. By default, BMC Impact Publishing Server estimates the timeout needed. If the publication fails with Publish verification of IMs failed, set SMMMessageBufferKeepSentEstimate=F and increase SMMMessageBufferKeepSent. If publication fails with Publish validation of IMs failed, use the following information to troubleshoot the problem according to the message you receive: IM <CellName> failed to upload service model from SMM The DestinationBufferKeepSent of smmgr is not high enough and expires before the cell has terminated uploading service model from smmgr.
IM <CellName> did not answer the request
294
The SMMMessageBufferKeepSent of publishing server is not high enough and expires before the smmgr has applied the verification or upload. In both cases, the cell continues to upload and eventually the service model is available in the cell. Nevertheless, reinitialize the cell and publish again to avoid subsequent publish jobs failing with the message Unique data identifier not/already in use.
s
When performing a penv init or a pinit of a large service model the Stack Size and the Heap Size of the Publishing Server might need to be increased. For service models with approximately 10,000 CIs and 10,000 relationships, you should double both the Stack Size and the Heap Size. To double the Stack Size, in the pserver.bat file (Windows) or the pserver file (UNIX) change the default -Xoss400k and Xss512k values to -Xoss800k and -Xss1M. To double the Heap Size, in the pserver.bat file change the default -Xms256M -Xmx800M values to -Xms512M Xmx1600M. Additionally, in the pserver_service.conf file, add the following parameters before restarting the Publishing Server: wrapper.java.additional.2=-Xms512M wrapper.java.additional.3=-Xoss800k wrapper.java.additional.4=-Xss1M wrapper.java.additional.5=-Xmx1600M Making these changes will allow publishing of 10k models successfully if you run pserver.bat manually.
0 means no retrial, thus only a single publish request is performed. 1 means a publish request and one retry attempt, if necessary. a number less than zero (-1) means the automated publisher will republish indefinitely, until a publish is successful.
Appendix A
Troubleshooting
295
remove the ps.lock file in the MCELL_HOME/log/ps_hostname/ directory and restart the BMC Impact Publishing Server service (or daemon).
296
If the psstat command indicates that the BMC Impact Publishing Server is not running in automated mode, it may be in manual mode. This might have occurred because the configuration parameter AutomatedStartMode in pserver.conf is set to Manual, or because the mode was set with the CLI command pscontrol. If the BMC Impact Publishing Server is running in manual mode, you can request a publication using the CLI command publish. To switch to automated mode, execute the CLI command pscontrol automated.
1 Log on to Remedy User. 2 Open the form NOTIFY:protocols and retrieve entries.
You should get one entry with version 1.
1. Verify that BMC Impact Portal is running properly (or restart the BMC Impact Portal). 2. Restart the BMC Impact Publishing Server.
Failure message
Classinfo is not synchronized.
cell in the
MCELL_HOME/etc/cellName/kb/class es directory.
s s
Make sure all CIs have unique aliases. Publish the purge by using the CLI command publish -p
"Purge=T"
See Purging and deleting service model objects on page 212 for more information.
298
Table 82
Failure message
Connection to IM cellName is not open OR Connection to IM cellName dropped
Action Verify that the target cell instance is running. Restart it if necessary. Also verify that the cells location and encryption key are registered with BMC Impact Portal. Verify that the ServiceModelSet of impact relationship is correct. Such problems may occur when two promotions follow very quickly and the first promotion adds a relationship and the second promotion moves a CI out of model. Using automated publish for two promotions will prevent this failure. Increase the value of
ServiceModelManagerStartTimeOut.
an impact relationship is pointing to a non-existent CI the impact relationship has ServiceModelSet IN, but the consumer or provider component instance has ServiceModelSet OUT_OF_IN or OUT
In a cell's trace file you find the message Service Model Manager
process ({0}) not active within expected delay. Please verify.
The cell does fork a Service Model Manager (SMM) process. In the mcell.conf file, the parameter
ServiceModelManagerStartTimeOut = 60
This failure message displays after Reinitialize the cell and publish a failure in the second phase of again (to avoid subsequent two-phase commit. publishes failing with the message
Unique data identifier not/already in use")
Reset the ServiceModelPublish The ServiceModelPublish parameter in the parameter to Yes and restart the MCELL_HOME/etc/mcell.conf file cell. or in MCELL_HOME/etc/<CellName>/ mcell.conf file is set to No. When you have previously published from a Direct Publish environment and now want to publish from BMC Atrium CMDB, the Direct Publish management data conflicts with management data being published from BMC Atrium CMDB. Delete Direct Publish management data using the pposter CLI command and the ddelete action command.
Appendix A
Troubleshooting
299
Table 82
Failure message
No user group defined with id {0}
Operation on instance of different environment Provider_home_cell ({0}) is remote but component {1} is local
The data instance is already published to the cell from another publish environment.
This error can occur as a result of a Correctly register the ports of the cells. typo when registering cells. For example, cell X runs on port X, and cell Y runs on port Y. However, port X is mistakenly entered for both cells. While cell X is running, a provider component with cell name Y is sent to cell on port X, thus the cell X impact relationship is sent to the cell with name Y, thus
s
the cell on port X is component local (same cell as relationship) provider_home_cell has value Y, so the provider_home_cell is remote (other cell as relationship)
The issue originates from the fact that although the CI is sent to cell Y, in reality, it is sent to cell X because that cell is listening on the (erroneous) port (X) of cell Y.
300
Table 82
The attribute HomeCellAlias has a Define the cell aliases correctly. value that is not defined in the publish environment's CellAliases. A CI of the class with the given id has ServiceModelSet IN or OUT_OF_IN, although the class is not flagged as a SIM class. Only instances of SIM classes should have ServiceModelSet IN or OUT_OF_IN. To make the class a SIM class, follow these steps: 1. Use Remedy User's Class Manager Console and assign the attribute Custom Properties to 100050. 2. Export the modified SIM class information with the CLI command pclassinfo -x. 3. Update the Knowledge Base of the cells and recompile. For more information, see Adding new classes to the BMC Atrium CMDB on page 157.
The minimum supported protocol version is 7. Unique data identifier already in use.
The version of the target cell Uninstall the earlier version and instance is earlier than the required install the appropriate version. version. A service component instance with The service model in the cell is the same mc_udid is already most likely not in sync with the published in the cell. master copy kept in the BMC Atrium CMDB impact dataset. Reinitialize the cell. If reinitializing the cell fails because of invalid data, then the master copy is invalid. Reinitialize the BMC Atrium CMDB.
Appendix A
Troubleshooting
301
Table 82
Failure message
Unique data identifier not in use
The entry in the mcell.dir file of the Correct mcell.dir. consumer's cell is not defining the provider's cell. For instance, you will receive failure messages when the number of CI's exceeds the limited number available with a trial license. These failures may occur in the second phase of the two-phase commit. To troubleshoot these failure messages, consult the BMC Remedy AR System and BMC Atrium CMDB documentation. If the failure occurred in the second phase of the two-phase commit, to avoid subsequent publish failures with the message Unique data identifier not in use or already in use, reinitialize the cell and publish again.
You may receive detailed failure messages from the BMC Atrium CMDB.
Another publish request is ongoing The environment is not registered Error with ids/udids for partial publish, i.e. publish of selected instances
302
Appendix A
Troubleshooting
303
To avoid this situation, BMC Software recommends identifying what attributes will avoid duplicate CIs and then modify the identification rule to recognize those attributes.
304
Appendix
B
306 306 306 307 307 313 317 319 321 322 322 323 323 324 324 325 325 326 326 327 327 327 327 328 328 330 330 331
Appendix B
305
Component data classesthe service model data classes that define the component types typically used by business organizations. These classes are loaded into the Knowledge Base by default. Relationship data class (BMC_Impact)the data class that defines the different types of relationships that can exist between service components. The only class that exists for impact relationships is BMC_Impact. Service model management classesthe data classes that define the status computation and propagation, as well as the classes that support the service model event-to-component mapping mechanism. These classes are loaded into the Knowledge Base by default. Event classesthe classes that define the product event types and their behaviors.
306
Table 83
Root
mc_sm_root.baroc
event and data classes and the enumerations that are the foundation of the solution mapping data classes that provide the event-to-component mapping mechanism
Mapping
mc_sm_event_mapping.baroc
Appendix B
307
MC_PUBLISH_DATA_CLASS : BMC_BaseElement ISA MC_SM_COMPONENT DEFINES { Type : STRING; Item : STRING; ReadSecurity : LIST_OF STRING; ManufacturerName : STRING; Description : STRING; ShortDescription : STRING, default = 'n/a'; OwnerContact : STRING; Name : STRING; DatasetId : STRING, default = '0'; ImpactCostUnit : STRING; Notes : STRING; InstanceId : STRING; AccountID : STRING; OwnerName : STRING; Model : STRING; VersionNumber : STRING; WriteSecurity : LIST_OF STRING; Category : STRING; }; END
BMC_BaseElement inherits slots from MC_SM_COMPONENT class, which is defined in Figure 35 on page 309. MC_SM_COMPONENT class is located in the mc_sm_root.baroc file.
308
Figure 35
MC_SM_COMPONENT definition
MC_PUBLISH_DATA_CLASS: MC_SM_COMPONENT ISA MC_SM_DATA DEFINES { ComponentAliases: LIST_OF STRING; HomeCell: STRING; Priority:MC_PRIORITY, default=PRIORITY_5; StatusModel: STRING, default = 'STANDARD'; business_data : STRING; change_number : INTEGER; comment: STRING; component_scope: MC_SM_COMPONENT_SCOPE, default = LOCAL, parse=NO, read_only = YES; computed_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = OK; consolidate_function: MC_SM_CO_FUNCTION, parse =no, read_only=yes; consumer_num: INTEGER, parse=NO, parse=no, read_only=yes; direct_events_count: INTEGER, parse=no, read_only=yes; impact_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = NONE; last_status_modification: INTEGER, parse=no, read_only=yes, representation = date; maintenance_mode: MC_YESNO, parse = no, read_only=yes, default = NO; manual_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = NONE; manual_status_comment: STRING, parse=no, read_only=yes; manual_status_providers: LIST_OF STRING, parse=no, read_only=yes; manual_status_providers_count: INTEGER, parse=no, read_only=yes; manual_status_requestor: STRING, parse=no, read_only=yes; self_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = NONE; shadow_cells: LIST_OF STRING, parse=NO, read_only=YES; status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = OK; sub_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = NONE; # additional slot in 7.0 possible_causes: LIST_OF STRING, parse=no, read_only=yes; root_causes: LIST_OF STRING, parse=no, read_only=yes; sla_roleup_status: MC_SM_SLM_SLA_STATUS, parse=no, default=NO_SLAS; ScheduleId: STRING; PriorityOut:MC_PRIORITY; ImpactCostPerSec : REAL; ImpactCostPerSecOut : REAL; PriorityWatchdog:MC_YESNO, default=NO; self_priority: MC_PRIORITY, parse=no, read_only=yes, default=PRIORITY_5; raw_impact_priority: REAL, parse=no, read_only=yes; impact_priority: MC_PRIORITY, parse=no, read_only=yes, default=PRIORITY_5; computed_priority: MC_PRIORITY, parse=no, read_only=yes, default=PRIORITY_5; cost:REAL, parse=no, read_only=yes; schedule_status: MC_SM_SCHEDULE_STATUS, default=IN; }; END
MC_SM_COMPONENT inherits slots from MC_SM_DATA (which contains no slot definitions, as shown in Figure 36). MC_SM_DATA is located in the mc_sm_root.baroc file. Figure 36 MC_SM_DATA definition
Appendix B
309
MC_SM_DATA inherits slots from CORE_DATA, which is shown in Figure 37. CORE_DATA is located in the mc_root_internal.baroc file. Figure 37 CORE_DATA definition
MC_DATA_CLASS : CORE_DATA DEFINES { data_handle : INTEGER, parse = no, read_only = yes; mc_udid : STRING, read_only = yes; mc_creation_time : INTEGER, parse = no, read_only = yes, representation = date; mc_modification_time : INTEGER, parse = no, read_only = yes, representation = date; mc_modification_requestor : STRING, read_only = yes; }; END
Source class
BMC_BaseElement
Category
BMC_BaseElement
change_number
increments every time an event is sent for the component. Used to determine the order of events for events which happen in the same second.
INTEGER
MC_SM_COMPONENT
ComponentAliases
MC_SM_COMPONENT
consumer_num
INTEGER
MC_SM_COMPONENT
comment
a comment that is set for the component via STRING BMC Impact Manager
MC_SM_COMPONENT
component_scope
STRING
MC_SM_COMPONENT
computed_priority
the priority of a component that is the highest between self priority and impacts priority. Set in the computed_priority field.
enumeration: MC_PRIORITY
MC_SM_COMPONENT
computed_status
status of the component instance computed enumeration: from self and substatuses MC_SM_COMPONENT_STATUS
MC_SM_COMPONENT
310
Table 84
Slots
Source class
MC_SM_COMPONENT
consolidate_function
cost
the current cost for the component depending on the current value of the schedule (either During Schedule or Exceptions Within During Schedule)
MC_SM_COMPONENT
data_handle DatasetId
identifier in local cell identification of the dataset within which the instance exists. This attribute relates to the CoreDatasetId attribute of a BMC_Dataset instance.
INTEGER STRING
CORE_DATA BMC_BaseElement
Description
STRING
BMC_BaseElement
direct_events_count
INTEGER
MC_SM_COMPONENT
HomeCell
STRING
MC_SM_COMPONENT
ImpactCostPerSec
STRING
BMC_BaseElement
ImpactCostPerSec
REAL
MC_SM_COMPONENT
ImpactCostPerSecOut
cost for the component when it is in an Exceptions Within During Schedule period
REAL
MC_SM_COMPONENT
ImpactCostUnit
STRING
BMC_BaseElement
impact_priority
enumeration: MC_PRIORITY
MC_SM_COMPONENT
impact_status
enumeration: MC_SM_COMPONENT_STATUS
MC_SM_COMPONENT
InstanceId
STRING
BMC_BaseElement
Atrium CMDB
BMC_BaseElement
Item
last_status_modification
INTEGER
MC_SM_COMPONENT
maintenance_mode
MC_SM_COMPONENT
manual_status
MC_SM_COMPONENT
manual_status_comment
comment entered by user when component STRING instance is set to manual status
MC_SM_COMPONENT
Appendix B
311
Table 84
Slots
Source class
MC_SM_COMPONENT
manual_status_providers
manual_status_providers_co number of direct and indirect providers unt with manual status set (may contain duplicate entries) manual_status_requestor login ID of user who sets the component instance to manual status ManufacturerName name of the company that manufactured the component instance mc_creation_time mc_modification_time
INTEGER
MC_SM_COMPONENT
STRING
MC_SM_COMPONENT
STRING
BMC_BaseElement
date and time when the object was created INTEGER date and time when the object was last changed INTEGER
CORE_DATA CORE_DATA
STRING STRING
Name
BMC_BaseElement
Notes OwnerContact
INTEGER
BMC_BaseElement BMC_BaseElement
A string that provides information on how STRING the primary system owner can be reached (e.g. phone number, e-mail address
OwnerName
name of the person in the enterprise who is STRING responsible for the component instance
BMC_BaseElement
possible_causes
list of possible causes for the components current status (different from root causes)
LIST_OF_STRING
MC_SM_COMPONENT
Priority
priority
enumeration: MC_PRIORITY
MC_SM_COMPONENT
PriorityWatchdog
enumeration: MC_YESNO
MC_SM_COMPONENT
raw_impact_priority
REAL
MC_SM_COMPONENT
ReadSecurity
list of permission groups that defines who has read access to a component instance
LIST_OF_STRING
BMC_BaseElement
root_causes
LIST_OF_STRING
MC_SM_COMPONENT
ShortDescription
BMC_BaseElement
schedule_status
indicates whether the component is currently During Schedule or Exception Within During Schedule
enumeration_ MC_SM_SCHEDULE_STATUS
MC_SM_COMPONENT
312
Table 84
Slots
self_priority
Source class
MC_SM_COMPONENT
self_status
the status of the object based on events directly attached to it (this does not take into account status from providers)
enumeration: MC_SM_COMPONENT_STATUS
MC_SM_COMPONENT
sla_roleup_status
the aggregation of the compliance status of enumeration: the associated SLAs, if any MC_SM_SLM_SLA_STATUS LIST_OF_STRING
MC_SM_COMPONENT
shadow_cells
MC_SM_COMPONENT
status
main status of the component (equals computed_status unless manual status is set)
enumeration: MC_SM_COMPONENT_STATUS
MC_SM_COMPONENT
StatusModel sub_status
name of the status computation model derived status of the component instance
MC_SM_COMPONENT MC_SM_COMPONENT
Type
BMC_BaseElement
VersionNumber
BMC_BaseElement
WriteSecurity
list of permission groups that define who has write access to a component instance
LIST_OF_STRING
BMC_BaseElement
BMC_BaseElement enumerations
Enumeration types, such as MC_SM_COMPONENT_STATUS, are listed in the mc_sm_root.baroc file and their descriptions are provided in Table 7 on page 24.
Appendix B
313
Figure 38
BMC_Impact definition
MC_PUBLISH_DATA_CLASS : BMC_Impact ISA MC_SM_RELATIONSHIP DEFINES { WriteSecurity : LIST_OF STRING; ShortDescription : STRING, default = 'na'; AccountID : STRING; ReadSecurity : LIST_OF STRING; }; END
BMC_Impact inherits slots from MC_SM_RELATIONSHIP, which is shown in Figure 39. MC_SM_RELATIONSHIP is located in the mc_sm_root.baroc file. Figure 39 MC_SM_RELATIONSHIP definition
MC_PUBLISH_DATA_CLASS: MC_SM_RELATIONSHIP ISA MC_SM_DATA DEFINES { PropagationModel: STRING; provider_home_cell: STRING; provider_classname: STRING; State: MC_SM_RELATIONSHIP_STATE, default = ACTIVE; StatusWeight : INTEGER, default=100; consumer_id: STRING, key = yes; last_status_modification: INTEGER, parse=no, read_only=yes, representation = date; propagated_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = UNKNOWN; propagated_sub_status: MC_SM_COMPONENT_STATUS, parse=no, read_only=yes, default = UNKNOWN; provider_id: STRING, key = yes; true_impact: MC_YESNO, parse=no, read_only=yes, default = NO; change_number : INTEGER; }; END
MC_SM_RELATIONSHIP inherits slots from MC_SM_DATA (which contains no slots, as shown in Figure 40). MC_SM_DATA is located in the mc_sm_root.baroc file. Figure 40 MC_SM_DATA definition
MC_DATA_CLASS : MC_SM_DATA ISA CORE_DATA; DEFINES { publish_env_id : STRING, parse = no, read_only = yes;
};
END
MC_SM_DATA inherits slots from CORE_DATA, which is shown in Figure 41. CORE_DATA is located in the mc_root.internal.baroc file.
314
Figure 41
CORE_DATA definition
MC_DATA_CLASS : CORE_DATA DEFINES{ data_handle : INTEGER, parse = no, read_only = yes; mc_udid : STRING, read_only = yes; mc_creation_time : INTEGER, parse = no, read_only = yes, representation = date ; mc_modification_time : INTEGER, parse = no, read_only = yes, representation = date; mc_modification_requestor : STRING, read_only = yes; }; END
last_status_modification date/time when the value of true_impact function was last changed (used by GUI) mc_creation_time mc_modification_time mc_udid propagated_status date and time when the object was created date and time when the object was last changed internal key used to reference the relationship; it is an inherited slot status that is currently propagated through the relationship maximum of provider substatus and status values name of the status propagation model used for determining the propagated status from of the providers main status name of the class of the provider component instance
INTEGER INTEGER STRING enumeration: MC_SM_COMPONENT_ STATUS enumeration: MC_SM_COMPONENT_ STATUS STRING
propagated_sub_status
PropagationModel
provider_classname
STRING
MC_SM_ RELATIONSHIP
Appendix B
315
Table 85
Slot
provider_home_cell provider_id
mc_udid of the provider STRING component instance, the impacting component instance state of the relationship, Active or Inactive enumeration: MC_SM_RELATIONSHIP _STATE
State
StatusWeight
number that determines the degree INTEGER of importance to give to each provider relationship that impacts a consumer component instance flag indicating whether this relationship affects the impact_status of the consumer enumeration: MC_SM_YESNO
true_impact
MC_SM_ RELATIONSHIP
BMC_Impact enumerations
The following enumerations are listed in the mc_sm_root.baroc file:
s s s s s s s s s s s s s
MC_SM_RELATIONSHIP_STATE MC_SM_IMPACT_FUNCTION MC_SM_SELF_FUNCTION MC_SM_CO_FUNCTION MC_SM_SLA_RESET_MODE MC_SM_COMPONENT_SCOPE MC_SM_COMPONENT_STATUS MC_SM_SHADOW_REQUEST_OP MC_SM_SLM_SLA_STATUS MC_SM_CAUSE_TYPE PRIORITY_FORMULA MC_SM_SCHEDULE_STATUS BMC_SIM_DOWNTIME_STATUS_CONFIG
316
MC_PUBLISH_DATA_CLASS : BMC_DOWNTIME_STATUS_CONFIG ISA BMC_SIM_DATA DEFINES { status : MC_SM_COMPONENT_STATUS, default = UNAVAILABLE; }; END
BMC_DOWNTIME_STATUS_CONFIG inherits slots from BMC_SIM_DATA, which is shown in Figure 45. BMC_SIM_DATA is located in the mc_sm_root.baroc file. Figure 43 BMC_SIM_DATA definition
MC_DATA_CLASS: BMC_SIM_DATA ISA MC_SM_DATA DEFINES { ReadSecurity : LIST_OF_STRING; WriteSecurity : LIST_OF_STRING; }; END
BMC_DOWNTIME_STATUS_CONFIG slots
BMC_DOWNTIME_STATUS_CONFIG has the following slot. Table 86
Slot
BMC_DOWNTIME_STATUS_CONFIG slot
Data type or enumeration enumeration: MC_SM_COMPONENT_STATUS Source class BMC_SIM_DOWNTIME_ST ATUS_CONFIG
Description
Appendix B
317
MC_PUBLISH_DATA_CLASS: BMC_STATUS_COMPUTATION ISA BMC_SIM_DATA DEFINES { model_name: STRING, key = yes; impact_function: MC_SM_IMPACT_FUNCTION, default = HIGHEST_VAL; ext_impact_function: LIST_OF STRING; self_function: MC_SM_SELF_FUNCTION, default = HIGHEST_VAL; consolidate_function: MC_SM_CO_FUNCTION, default = HIGHEST_VAL; quorum: INTEGER, default = 51; no_alert_status: MC_SM_COMPONENT_STATUS, default = OK; }; END
BMC_STATUS_COMPUTATION inherits slots from BMC_SIM_DATA, which is shown in Figure 45. BMC_SIM_DATA is located in the mc_sm_root.baroc file Figure 45 BMC_SIM_DATA definition
MC_DATA_CLASS: BMC_SIM_DATA ISA MC_SM_DATA DEFINES { ReadSecurity : LIST_OF_STRING; WriteSecurity : LIST_OF_STRING; }; END
318
Table 87
Slot
consolidate_function name of the algorithm used to compute the component computed status; it consolidates the impact_status and the self_status ext_impact_function the name of the external algorithm to be used by the impact_function when the impact_function slot contains the placeholder EXTERNAL This slot is reserved for future extension.
LIST_OF_STRING
BMC_STATUS_COMPUTATION
impact_function
name of the algorithm used to enumeration: compute the impact status from MC_SM_IMPACT_FUNCTI provider components; it ONS merges the propagated status values of the different provider components name of the status computation STRING model (key of the table) default main status when the consolidate functions status is NONE
BMC_STATUS_COMPUTATION
model_name noalert_status
BMC_STATUS_COMPUTATION
quorum
quorum percentage applied by INTEGER the impact function when set to use the QUORUM algorithm list of permission groups that defines who has read access to a component instance LIST_OF_STRING
ReadSecurity
BMC_SIM_DATA
self_function
name of the algorithm used to enumeration: compute the self status; it maps MC_SM_SELF_FUNCTION and merges the severity values directly from the events list of permission groups that LIST_OF_STRING defines who has write access to a component instance
BMC_STATUS_COMPUTATION
WriteSecurity
BMC_SIM_DATA
Appendix B
319
MC_PUBLISH_DATA_CLASS: BMC_STATUS_PROPAGATION ISA BMC_SIM_DATA DEFINES { name: STRING, key = yes; provider_type: STRING, key = yes; consumer_type: STRING, key = yes; description: STRING; }; END
BMC_STATUS_PROPAGATION inherits slots from BMC_SIM_DATA, which is shown in Figure 47. BMC_SIM_DATA is located in the mc_sm_root.baroc file. Figure 47 BMC_SIM_DATA definition
MC_DATA_CLASS: BMC_SIM_DATA ISA MC_SM_DATA DEFINES { ReadSecurity : LIST_OF_STRING; WriteSecurity : LIST_OF_STRING; }; END
consumer_typ valid component types for the e consumer component instance description name description applicable to the relationships using this model
name of the status propagation STRING model; it must match the name of a propagation map list of permission groups that defines who has read access to a component instance
ReadSecurity
LIST_OF_STRING BMC_SIM_DATA
320
Table 88
Slot
provider_type valid component types for the provider component instance WriteSecurity list of permission groups that defines who has write access to a component instance
LIST_OF_STRING BMC_SIM_DATA
MC_PUBLISH_DATA_CLASS: BMC_PROPAGATION_MAP ISA BMC_SIM_DATA DEFINES { name: STRING, key = yes; relationship_state: MC_SM_RELATIONSHIP_STATE, key = yes; provider_status: MC_SM_COMPONENT_STATUS, key = yes; propagated_status: MC_SM_COMPONENT_STATUS; }; END
BMC_PROPAGATION_MAP inherits slots from BMC_SIM_DATA, shown in Figure 49. BMC_SIM_DATA is located in the mc_sm_root.baroc file Figure 49 BMC_SIM_DATA definition
MC_DATA_CLASS: BMC_SIM_DATA ISA MC_SM_DATA DEFINES { ReadSecurity : LIST_OF_STRING; WriteSecurity : LIST_OF_STRING; }; END
Appendix B
321
Table 89
Slot name
propagated_status status to be propagated to the consumer component provider_status status of the provider component list of permission groups that defines who has read access to a component instance applicable relationship state list of permission groups that defines who has write access to a component instance
BMC_PROPAGATION_MAP
BMC_PROPAGATION_MAP
ReadSecurity
BMC_SIM_DATA
relationship_state WriteSecurity
322
MC_PUBLISH_DATA_CLASS: BMC_SEVERITY_TO_STATUS ISA BMC_SIM_DATA DEFINES { severity: SEVERITY, key = yes; status: MC_SM_COMPONENT_STATUS, key = yes; }; END
You should not edit a SEVERITY_TO_STATUS table unless the severity and/or the status enumerations are customized.
MC_PUBLISH_DATA_CLASS : BMC_SIM_MATCH_TABLE ISA BMC_SIM_DATA DEFINES { name : STRING ; tag : STRING , key=yes, read_only=yes, default=alias; input_match : LIST_OF STRING , key=yes; ref_instances_classes : LIST_OF STRING ; output_expressions : LIST_OF STRING ; }; END
Appendix B
323
Figure 52
BMC_SIM_ALIAS definition
MC_PUBLISH_DATA_CLASS: BMC_SIM_ALIAS ISA BMC_SIM_DATA DEFINES { ComponentAlias: STRING, key=yes; ComponentID: STRING; }; END
MC_PUBLISH_DATA_CLASS: BMC_SIM_ALIAS ISA BMC_SIM_DATA DEFINES { ComponentAlias: STRING, key=yes; ComponentID: STRING; }; END
324
Figure 54
BMC_TIME_SCHEDULE definition
MC_PUBLISH_DATA_CLASS : BMC_TIME_SCHEDULE ISA BMC_SIM_DATA DEFINES { Name : STRING; Description : STRING; status: MC_SM_SCHEDULE_STATUS, read_only=YES,parse=NO; }; END
MC_PUBLISH_DATA_CLASS : BMC_TIME_FRAME_TO_SCHEDULE ISA BMC_SIM_DATA DEFINES { Timeframe : STRING, key=yes; Schedule : STRING, key=yes; Included : MC_YESNO, default=YES; }; END
Appendix B
325
Figure 56
BMC_SELF_PRIORITY_MAPPING definition
MC_PUBLISH_DATA_CLASS : BMC_SELF_PRIORITY_MAPPING ISA BMC_SIM_DATA DEFINES { priority : MC_PRIORITY, key=yes; status :MC_SM_COMPONENT_STATUS, key=yes; self_priority : MC_PRIORITY; }; END
MC_PUBLISH_DATA_CLASS : BMC_SERVICE_SCHEDULE_CONFIG ISA BMC_SIM_DATA DEFINES { PriorityFormula : PRIORITY_FORMULA, default = WEIGHTED; DefaultSchedule : STRING; }; END
MC_PUBLISH_DATA_CLASS: BMC_STATUS_TO_SEVERITY ISA BMC_SIM_DATA DEFINES { status: MC_SM_COMPONENT_STATUS, key = yes; severity: SEVERITY, key = yes; }; END
326
SIM_TIME_FRAME class
SIM_TIME_FRAME class
The SIM_TIME_FRAME class defines a time period that can be used as part of a schedule. Figure 59 shows the BAROC definition of the BMC_STATUS_TO_SEVERITY class, which is located in the mc_sm_root.baroc file. Figure 59 SIM_TIME_FRAME definition
SIM_TIME_FRAME; mc_udid='SMS_DEFAULT_TIMEFRAME'; description='sms.defaulttimeframe.description'; name='sms.defaulttimeframe.name'; dtstart='20060101T000000'; duration='P1D'; interruptions=[]; tzid=''; rdate=[]; rrule=['FREQ=DAILY;INTERVAL=1;WKST=SU']; exdate=[]; exrule=[]; END
SIM_CellAlias class
The SIM_CellAlias class is assigned to cells and used for publishing. The class maps a cell alias to a real cell name. Cell aliases can be remapped to different cells for different test environments. The definition of the SIM_CellAlias class is located in the cellalias.def file.
SIM_CellInformation class
The SIM_CellInformation class stores cell connection information (similar to mcell.dir). Additionally, it contains a field which specifies whether the cell is a production cell or a test cell.
BMC_PROMOTION_LOG class
BMC_PROMOTION_LOG is a log object created for each user promotion. The object tracks data such as promoted objects, users who initiated the promotion, promotion start and end times, and the status of the promotion (in progress, success, or failed).
Appendix B Default service model data classes 327
328
Figure 60
MC_EV_CLASS : CORE_EVENT DEFINES { event_handle : INTEGER, parse = no, read_only = yes; mc_ueid : STRING, read_only = yes; mc_client_address : STRING, parse = no; adapter_host : STRING; mc_location : STRING; mc_service : STRING; mc_host_class : STRING; mc_host : STRING; mc_host_address : STRING; mc_object_class : STRING; mc_object : STRING; mc_tool_class : STRING; mc_tool : STRING; mc_tool_rule : STRING; mc_tool_key : STRING; mc_tool_sev : STRING; mc_origin_class : STRING; mc_origin : STRING; mc_origin_key : STRING; mc_origin_sev : STRING; mc_parameter : STRING; mc_parameter_value : STRING; mc_event_category : MC_EVENT_CATEGORY; mc_incident_time : INTEGER, representation = date; mc_arrival_time : INTEGER, representation = date; mc_local_reception_time : INTEGER, representation = date; date_reception : INTEGER, representation = date; date : STRING; status : STATUS, default = OPEN; severity : SEVERITY, default = WARNING; mc_original_severity : SEVERITY, parse = no; mc_priority : MC_PRIORITY, default = PRIORITY_5; mc_original_priority : MC_PRIORITY, parse = no; mc_owner : STRING; msg : STRING; duration : INTEGER, parse = no; mc_timeout : INTEGER; repeat_count : INTEGER; mc_action_count : INTEGER, parse = no; administrator : STRING; mc_acl : LIST_OF STRING, parse = no; mc_date_modification : INTEGER, representation = date; mc_notes : LIST_OF STRING, hidden = yes; mc_operations : LIST_OF STRING, hidden = yes; mc_notification_history : LIST_OF STRING, hidden = yes; mc_bad_slot_names : LIST_OF STRING; mc_bad_slot_values : LIST_OF STRING; mc_history : LIST_OF STRING, hidden = yes; mc_modhist : LIST_OF STRING, hidden = yes; mc_propagations : LIST_OF STRING, parse = no, hidden = yes; mc_collectors : LIST_OF STRING, parse = no, hidden = yes; mc_abstraction : LIST_OF INTEGER, parse = no, hidden = yes; mc_abstracted : LIST_OF INTEGER, parse = no, hidden = yes; mc_associations : LIST_OF STRING, parse = no, hidden = yes; mc_cause : INTEGER, parse = no, hidden = yes; mc_effects : LIST_OF INTEGER, parse = no, hidden = yes; mc_event_relations : LIST_OF STRING, parse = no, hidden = yes; mc_relation_source : STRING; mc_smc_id : STRING; mc_smc_alias : STRING; mc_smc_impact : INTEGER, default = 0; mc_smc_type : STRING; mc_smc_causes : LIST_OF STRING, parse = no; mc_smc_effects : LIST_OF STRING, parse = no; }; END
Appendix B
329
CORE_EVENT slots
The CORE_EVENT slots are listed in BMC Impact Solutions Knowledge Base Development Reference Guide.
The service model root event class branches into two subclasses: a history event class and an impact event class.
MC_EV_CLASS: SMC_STATE_CHANGE ISA EVENT DEFINES { mc_smc_id: STRING, dup_detect=yes ; smc_status: SIM_NOTIFICATION_STATUS; smc_previous_status: SIM_NOTIFICATION_STATUS; msg: default='A Service Management Component status has changed'; mc_smc_impact: default=2; }; END
330
Events of class SMC_STATE_CHANGE are automatically generated and associated with their component by the cell. As history events, they are not used in the status computation process.
MC_EV_CLASS: MC_SMC_EVENT ISA MC_SMC_ROOT DEFINES { mc_smc_impact : default = 1; component_sub_type: STRING; component_name: STRING; }; END
Events of class MC_SMC_EVENT, or any custom subclass of that class, are not used in the status computation process.
Appendix B
331
332
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
access rights to service model objects 100 Access Server component type 27 active relationship defined 78 setting as 82 Activity component type 26 Activity Decision component type 26 Activity End component type 26 Activity Interaction component type 26 Activity Manual component type 26 Activity options 82 Activity Start component type 26 Add to Saved Finds button 72 Advanced Find tab 74 algorithm, quorum 129 alias entering in component instance 64 alias formulas conditional operators 88 creating 86 functions in 89 analyzing relevance of events 11 Application component type 27 Application Infrastructure component type 27 Application Service component type 31 Application System component type 27 applications, using with extended data models 157 AR System server using with extended data models 157 ARDBC plug-in 214 Atrium Publish environments parameters for 255 attributes generating fields for AR System 157 automated publishing 53, 296 AutomatedPublish configuration parameter 230 AutomatedPublishRetryPeriod configuration parameter 229, 230 described 46 exporting SIM class definitions from 250 BMC Impact Portal monitoring service events 111 BMC Impact Publishing Server generating events for 181 BMC Impact Publishing Server CLI command summary 247248 common options for commands 241243 configuring 234?? configuring error tracing 241 error exit codes 245 error tracing, configuring 241 pclassinfo command 249?? pcli.trace file 241, 244 pinit command 261?? plog command 265??, 281?? plogdisplay command 266?? pscontrol stop command 278 pserver command 280 publish command 283?? BMC Impact Publishing Server service stopping with pcontrol stop CLI command 278 BMC Impact Solutions using new classes 158 BMC Software, contacting ii BMC.ASSET data set 103 BMC.IMPACT.PROD data set 54, 103 BMC_Activity component class 26 BMC_Application component class 27 BMC_ApplicationInfrastructure component class 27 BMC_ApplicationService component class 31 BMC_ApplicationSystem component class 27 BMC_BaseElement BAROC definition 307 enumerations 313 slot definitions 310, 315 BMC_BusinessProcess component class 26 BMC_BusinessService component class 26 BMC_CDROMDrive component class 31 BMC_Cluster component class 27 BMC_ComputerSystem component class 27, 28, 29, 30, 31 BMC_ConnectivityCollection component class 27 BMC_DataBase component class 26 BMC_DataBaseStorage component class 32 BMC_DiskDrive component class 31
B
blackout status described 24 BMC Atrium Configuration Management Database
Index
333
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
BMC_DiskPartition component class 32 BMC_FileSystem component class 32 BMC_FloppyDrive component class 31 BMC_HardwareSystemComponent component class 31 BMC_Impact data class 313 enumerations 316 BMC_IPConnectivitySubnet component class 27 BMC_IPXConnectivityNetwork component class 27 BMC_LAN component class 27 BMC_LNsCollection component class 27 BMC_LNsCollection component type 27 BMC_LocalFileSystem component class 32 BMC_LogicalSystemComponent component class 32 BMC_Mainframe component class 29 BMC_Media component class 31 BMC_Monitor component class 29 BMC_OperatingSystem component class 32 BMC_Organization component class 27 BMC_PROPOGATION_MAP defined 321 slots 321 BMC_RemoteFileSystem component class 32 BMC_SIM_ALIAS data class 323 BMC_Software component class 32 BMC_SoftwareServer component class 28, 29, 30, 31 BMC_STATUS_COMPUTATION data class 317 BMC_STATUS_PROPOGATION data class 319 BMC_SystemResource component class 32 BMC_SystemSoftware component class 32 BMC_TapeDrive component class 31 BMC_UPS component class 31 BMC_UserCommunity component class 27 BMC_VirtualSystem component class 31 BMC_VirtualSystemEnabler component class 32 BMC_VMWare component class 32 BMC_WAN component class 27 Business Process component type 26 Business Service component type 26 chart illustrating 196 Class Manager Console 158 classes IPS_CONFIG 186 IPS_ERROR 191 IPS_EVENT 184 CLI for BMC Impact Publishing Server 233236 close, action command for penv 254 Cluster component type 27 color setting active border 152 setting selected background 152 command options pclassinfo 249 pinit 253, 262, 269 plog 265, 281 plogdisplay 267 pscontrol stop 278 pserver 280 publish 282, 284 commands mposter 37 msend 37 pclassinfo 249 penv 252 penv, action commands 254 pinit 261 plog 265, 281 plogdisplay 266 pposter 268 pscontrol stop 278 pserver 280 publish 283 common 245 Common Data Model (CDM) SIM-qualified classes of 46 Communication Server component type 28 comparing published to new 106 component classes BMC_Activity 26 BMC_Application 27 BMC_ApplicationInfrastructure 27 BMC_ApplicationService 31 BMC_ApplicationSystem 27 BMC_BMCComputerSystem 27, 28, 29, 30, 31 BMC_BusinessProcess 26 BMC_BusinessService 26 BMC_CDROMDrive 31 BMC_Cluster 27 BMC_ComputerSystem 27, 28, 29, 30, 31 BMC_ConnectivityCollection 27 BMC_DataBase 26 BMC_DataBaseStorage 32 BMC_DiskDrive 31 BMC_DiskPartition 32 BMC_FileSystem 32
C
CD ROM Drive component type 31 cell add or change name 68 assigning related component instances to 83 determining topology 14 field 63 initializing with pinit command 263264 initializing with service model data 261 list of cell names 63 reinitializing 209 SIM, comparing SIM class definitions 252 unassigned 63 cell alias about 193
334
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
BMC_FloppyDrive 31 BMC_HardwareSystemComponent 31 BMC_IPConnectivitySubnet 27 BMC_IPXConnectivityNetwork 27 BMC_LAN 27 BMC_LNsCollection 27 BMC_LocalFileSystem 32 BMC_LogicalSystemComponent 32 BMC_Mainframe 29 BMC_Media 31 BMC_Monitor 29 BMC_OperatingSystem 32 BMC_Organization 27 BMC_RemoteFileSystem 32 BMC_SoftwareServer 28, 29, 30, 31 BMC_Sofware 32 BMC_SystemResource 32 BMC_SystemSoftware 32 BMC_TapeDrive 31 BMC_UPS 31 BMC_UserCommunity 27 BMC_VirtualSystem 31 BMC_VirtualSystemEnabler 32 BMC_VMWare 32 BMC_WAN 27 component instances access to 100 assigning related to cells 83 associating with events 86 copying 69 creating 61 creating multiple copies 62 deleting 70 determining dependencies 10 editing 66 exporting 123 finding existing 71 hide 69 relationship state 35 setting icon colors and labels 152 viewing properties 65 component status computation model 25 computing 126 description of 24 component types 23 Access Server 27 Activity 26 Activity Decision 26 Activity End 26 Activity Interaction 26 Activity Manual 26 Activity Start 26 Application 27 Application Infrastructure 27 Application Service 31 Application System 27 BMC_LNsCollection 27 Business Process 26 Business Service 26 CD ROM Drive 31 Cluster 27 Communication Server 28 Computer System 28 Configuration Management Agent 28 Connectivity Collection 27 Database 26 Database Server 28 Database Storage 32 Disk Drive 31 Disk Partition 32 DNS Server 28 File Server 28 File System 32 Firewall 28 Floppy Drive 31 FTP Server 28 Gateway 28 Hardware System Component 31 Hub 28 Input/Output Device 28 IP Connectivity Network 27 IP Connectivity Subnet 27 JBOD 28 LAN Network 27 Layer 3 Switch 28 LDAP Server 29 Load Balancer 29 Local File System 32 Logical System Component 32 Mail Server 29 Mainframe 29 Media 31 Message Server 29 Mobile User Device 29 Monitor 29 Operating System 32 Organization 27 Print Server 29 RAID Storage Device 29 Remote File System 32 Resource Server 29 Router 29 SAN Bridge 29 SAN Director 30 SAN Hub 30 SAN Router 30 SAN Switch 30 Security Server 30 Server 30 Software 32 Software Server 30 Storage 30 Switch 30
Index
335
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
System Resource 32 System Software 32 Tape Drive 31 Tape Library 30 Telnet Server 30 Transaction Server 30 UDDI Server 30 Uninterruptible Power Supply (UPS) 31 User Community 27 Virtual System 31 Virtual System Enabler 32 VMware 32 WAN Network 27 Web Cache 31 Web Server 31 Computer System component type 28 computing status, of a component 126 Conditional Find tab 75 conditional operators in alias formulas 88 configuration activities for administrators associating custom icons with service model component classes 159 Configuration Management Agent component type 28 configuration parameters AutomatedPublish (publishing server) 230 AutomatedPublishRetryPeriod 229, 230 InitEffectivelyMgmtData 229, 230 configuring BMC Impact Publishing Server CLI 234?? error tracing, BMC Impact Publishing Server CLI 241 Connectivity Collection component type 27 Console Navigation Tree add a component to 113 adding a folder 111 copying a folder 112 dockable window 111 moving a folder 112 permissions for folders 112 refreshing 114 removing a folder 113 renaming a folder 111 copy component instances 69 set options for 154 creating alias formulas 86 component instances 60 multiple copies of component instances 62 relationships 79 custom icons, associating with service model component classes 159 customer support iii
D
data classes BMC_BaseElement, BAROC definition 307 BMC_Impact 313 BMC_PROPOGATION_MAP 321 BMC_SIM_ALIAS 323 BMC_STATUS_COMPUTATION 129, 317 BMC_STATUS_PROPOGATION 319 extending 23 file location 306 mapping 322 relationship 306 service model relationships 313 service model, overview of 306 SEVERITY_TO_STATUS 322 status related 306 Database component type 26 Database Server component type 28 Database Storage component type 32 datasets BMC.ASSET 104 BMC.IMPACT.PROD 104 defined 46 for Atrium Publish environments 197 date and time formats, setting 153 decreasing relationship policy 82 deleting component instance 70 event alias associations 90 relationships 85 Views 116 Direct Feed for service model data 21 Direct Publish environments parameters for 258 direct relationship policy 82 discovery tools 60 Disk Drive component type 31 Disk Partition component type 32 DNS Server component type 28 dockable windows Console Navigation Tree 111 Find 72 Pan and Zoom 119 repositioning 122 Template 62 undocking 122 documenting extensions 163 drawing relationships 79 dynamic prioritization final priority 147 impacts priority 146 overview 43 priority propagators 146 self priority 137
336
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
E
editing component instances 66 event alias associations 90 in model/not in model setting 67 multiple component instances 68 multiple objects 67 relationships 84 embedded Help options 154 error exit codes for BMC Impact Publishing Server CLI 245 error messages modifying 110, 178 event alias associations creating 86 deleting 90 editing 90 testing 102 event classes 328 history 330 impact 324, 325, 326, 331 events associating to component instances 86 generating publishing 181 missing, described 12 monitoring 110 examples pclassinfo 250252 penv 258 pinit 263264 plog 265, 281 plogdisplay 267 publish 284 expansion handles in relationships 120 exploring paths in relationships 120 exporting component instances 123 SIM class definitions from BMC Atrium CMDB 250 extending Common Data Model BMC applications and 157 BMC Impact Solutions and 158 documenting 163
relationships 81 Find, Advanced 74 Find, Conditional 75 finding component instances 71 relationships 72 Firewall component type 28 Floppy Drive component type 31 FTP Server component type 28 functions in alias formulas 89 in status computation 126
G
Gateway component type 28 General tab 62 generating publishing events 181 Go to Component button 74 grab hand in View 119
H
Hardware System Component component type 31 hiding component instance 69 dockable windows or View window 61 history event class 330 home cell about 193 home cell alias about 193 Hub component type 28
I
icons custom, associating with user-defined classes in SME 159 identifying critical events 11 impact event class 324, 325, 326, 331 IMPACTED component status, described 24 import service model data 123 important component 146 in model, defined 54 inactive relationship, defined 78 increasing relationship policy 82 info, action command for penv 255 init, action command for penv 255 InitEffectivelyMgmtData configuration parameter 229, 230 initializing cells with pinit command 263264 Input/Output Device component type 28 IP Connectivity Subnet component type 27 IPS_CONFIG class 186
F
file location of data classes 306 File Server component type 28 File System component type 32 files pcli.trace 241, 244 pclient.conf 234 pserver.trace 241 pserver.trace (configure) 241 Find command configuring results pane 73 filtering the results 73
Index
337
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
IPS_ERROR class 191 IPS_EVENT class 184 IPX Connectivity Network component type 27
O
OK component status, described 24 Open Saved Finds button 72 open, action command for penv 255 opening, Views 116 Operating System component type 32 Options command 152 Organization component type 27 Output Preview option 69
J
JBOD (Just a Bunch Of Disks) component type 28
L
LAN Network component type 27 Layer 3 Switch component type 28 LDAP Server component type 29 line weight, for relationships 153 lines styles, for relationships 153 Load Balancer component type 29 Local File System component type 32 log files setting preferences for 155 log, publishing viewing with plog command 265 logging on BMC Impact Service Model Editor 59 Logical System Component component type 32
P
Pan and Zoom dockable window 119 parameters for Arium Publish environments 255 for Direct Publish environments 258 Paste Multiple Components dialog box 69 pclassinfo command 249?? examples 250252 options 249250 pcli.trace 241 pcli.trace file 241, 244 pclient.conf file configuring Impact Publishing Server CLI 234 location 234 penv command 252 pinit command 261?? examples 263264 options, required 262 syntax 262 plog command 265??, 281?? examples 265, 281 syntax 265, 281 plogdisplay command 266?? examples 267 options 267 return codes 268 syntax 266 pposter CLI command 268 Print Server component type 29 priority propagators 146 product support iii promotion all instances 105 deleting instances 71 guidelines 104 overview 52 requirements before 104 status message 106 step-by-step instructions 105 submitting 104 verifying status 107 promotion of service model 103 provider relationship, described 33
M
Mail Server component type 29 Mainframe component type 29 Match Attributes box for event alias association 87 mc_root_internal.baroc 314 mc_root_redef.baroc 328 MC_SM_COMPONENT data class, BAROC definition 308 mc_sm_event_ mapping.baroc 307 mc_sm_object.baroc 307 mc_sm_root.baroc 307 MC_SMC_EVENT data class BAROC definition 324, 325, 326, 331 Media component type 31 Message Server component type 29 MINOR IMPACT component status, described 24 missing events 12 Mobile User Device component type 29 Monitor component type 29 mposter command 37 msend command 37
N
non-impact relationships, showing 122 not in model defined 54 setting in component instance 63
338
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
pscontrol stop command 278 options 278 syntax 278 pserver command 280 options 280 syntax 280 pserver.conf file configuration parameters 205 pserver.trace file 241 publish command 283?? command options 282, 284 examples 282, 284 syntax 283 Publish History command 108, 177 publishing automated 53, 296 changing recommended actions 110, 178 viewing history 108, 177 publishing large service models 293 publishing log viewing with plog command 265 renaming Views 116 repositioning objects in a View 118 Reset button in Find 74 Resource Server component type 29 return codes plogdisplay 268 Router component type 29
S
SAN Bridge component type 29 SAN Director component type 30 SAN Hub component type 30 SAN Router component type 30 SAN Switch component type 30 save a search statement 72 component instances 64 Views 115 Security Server component type 30 selecting multiple objects 67 relationships 80 Server component type 30 service components types 26 service model class hierarchy 305 composition 17 data classes, overview of 306 Direct Feed 21 internals of 305 objects, access to 100 promotion 103 publishing large 293 service model components computing status of 126 status colors, default 24 status computation 25 status values 24 service model relationships data classes 313 defined 34 ServiceModelSet class attribute, calculation of relationship values 204 set, action command for penv 255 setting options 152 regional preferences 153 SEVERITY_TO_STATUS data class 322 showing topology views 122 SMC_STATE_CHANGE data class BAROC definition 330 Software component type 32 Software Server component type 30 source file
Q
query builder in Find 76 quick expansion arrows 61
R
RAID Storage Device component type 29 refresh View 121 regional preferences, setting 153 reinitializing a cell 209 relationship legend 122 relationship policy, options defined 82 relationships active 78 creating 79 define line styles for 153 deleting 85 drawing 79 example View 83 expansion handles 120 exploring paths 120 finding 72 inactive 78 legend of types of 122 selecting 80 showing non-impact 122 state 35 state values 35 status propagation models 36 testing 102 updating 84 Remote File System component type 32
Index
339
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
for pposter CLI command 270 state_change.baroc file 330 status list of default values for components 24 Status and Alias tab 63 status computation functions 129 model 25 model anatomy 129 of components 25 status propagation models for relationships 36 in BMC Impact Service Model Editor 133 STATUS_COMPUTATION data class, BAROC definition 317, 318 slots 317, 318 stopping BMC Impact Publishing Server service 278 Storage component type 30 support, customer iii Switch component type 30 syntax pclassinfo 249, 253 pinit 262 plog 265, 281 plogdisplay 266 pscontrol stop 278 pserver 280 publish 283 System Resource component type 32 System Software component type 32 User Community component type 27 user groups default rights 100
V
verifying promotion status 107 Views adjusting focus in 118 and user accounts 115 deleting 116 grab and move objects in 119 opening 116 refreshing 121 rename 116 reposition objects in 118 saving 115 setting appearance options 154 visual cues in 117 zoom 118 Virtual System component type 31 Virtual System Enabler component type 32 visual cues in a View 117 VMware component type 32
W
WAN Network component type 27 WARNING status, described 24 Web Cache component type 31 Web Server component type 31 weighted cluster status model 25 wildcards using with Find command 72
T
Tape Drive component type 31 Tape Library component type 30 technical support iii Telnet Server component type 30 topology views configuring 156 showing 122 trace configuration file BMC Impact Publishing Server CLI 241 Transaction Server component type 30
Z
zoom in View 118
U
UDDI Server component type 30 UNAVAILABLE component status, described 24 undocking dockable windows 122 Uninterruptible Power Supply (UPS) component type 31 UNKNOWN status described 24 user accounts views 115
340
Notes
*97725*