Escolar Documentos
Profissional Documentos
Cultura Documentos
By
Tushar Jain
Version 1.0
Contents
1. Introduction ....................................................................................................3 1.1 Purpose .........................................................................................................3 1.2 Scope.............................................................................................................3 2. Hawk Overview ..............................................................................................3 2.1 Introduction to Hawk Rulebases...........................................................3 2.2 Hawk Microagents ...........................................................................................3 3. Rule-bases & TIBCO infrastructure monitoring ...................................4 3.1 Model TIBCO infrastructure monitoring .............................................4 3.2 RuleBase.......................................................................................................4 3.3 Basic Types of Rulebase Monitoring....................................................4 4. Hawk development Guidelines......................................................................5 4.1 General Naming convention...................................................................5 Clarity..............................................................................................................5 Spaces and Special Characters .........................................................................5 Capitalization...................................................................................................5 Initial Character ...............................................................................................5 4.2 TIBCO Guidelines & Naming Conventions .........................................5 4.2.1 Rulebasemap...........................................................................................5 4.2.2 Rulebase ...................................................................................................6 4.3 Rulebase configuration ............................................................................6 4.3.1 Rulebase configuration types.............................................................6 4.3.2 Manual Configuration of Hawk Rulebases......................................7 4.4 Version Control...........................................................................................7 5. Design Considerations.....................................................................................8
Version 1.0
1. Introduction
1.1 Purpose
The purpose of this document is to recommend naming standards, guidelines and organizational methods, based on standards and TIBCO Best Practices. The focus is to follow naming standards & use the best practices for the hawk rule base development in the XXXX Integration project.
1.2 Scope
The scope of this document is to cover the Define standards & guidelines to be followed for EMMA Project Organization Design considerations
2. Hawk Overview
2.1 Introduction to Hawk Rulebases
A TIBCO Hawk agent monitors managed objects by processing rulebases, which are named collections of rules that contain management logic. For general monitoring tasks, several default rulebases are installed with TIBCO Hawk software. Rules monitor parameters of an operating system, application or other managed object and perform tasks. To simplify administration, rules in a rulebase should be related. Multiple rules in the same rulebase can monitor a particular application or system function. Every rulebase contains rules which are made up of data sources, tests, and actions. Efficiently written hawk rule bases really helps to manage the highly scalable, flexible solutions with an easy automated monitoring. The guidelines for the hawk rulebase development will help to build the robust & efficient monitoring systems.
Version 1.0
3.2 RuleBase
A rulebase is a collection of rules that you create for the agent to monitor. For example, a rulebase might monitor the health of an application and take corrective actions if they are necessary. A rulebase consists of three components: a data source (microagent method), a test (if-then), and an action (alert, notify, script or method execution).
Version 1.0
Clarity
Clarity is the number one guideline for names, within reason. A user unfamiliar with the specifics of the implementation should be able to understand the function of any object by its name, and its position in a hierarchy. To that end, acronyms should be avoided unless they are well known through the entire company. Examples of acronyms might be: DB database The exception to the above rule is when spelling out the full name would make something less clear, not more.
Capitalization
TIBCO objects are all started with capital letters, and then capitals are used in the name as they correspond to correct English.
Initial Character
The first character of any name should be alphabetical (A-Z), not numeric.
4.2.1
Rulebasemap
A rulebase map is a configuration object that maps rulebases to TIBCO Hawk agents on your network. It directs TIBCO Hawk agents or groups of agents on your network to load particular rulebases at startup. For example, using a
Version 1.0
rulebase map you can instruct an agent to load a rulebase designed specifically for the operating system where it runs. To efficiently manage agent configuration, an entire enterprise should use the same rulebase map. Configuration objects access the rulebase map using the same configuration source they use to access rulebases Following naming guidelines should be used for the rulebase map The format for a Rulebasemap is RBM_<BW_Project/System>_<Component> Example: RBM_APP1-APP2 <BW_Project/system> can be APP1-APP2 <Component> can be Adapter,BWEngine, Log, Database etc.
For example, App1-App2 in context to XXXX Integration project, following RulebaseMap can be created 1. RBM_ APP1-APP2_AdapterInclude all the rulebases which monitors the Adapter ( Publihser, Subscriber,RR) status. 2. RBM_ APP1-APP2_BWEngineInclude all the rulebases, which monitors the BWEngine. 3. RBM_ APP1-APP2_Log Include all the rulebases, which monitors the log files. 4. RBM_ APP1-APP2_DatabaseIncludes the rulebases, which monitors that the data is flowing from End-to-End.
4.2.2
Rulebase
A rulebase is a configuration object that provides the rules for the monitoring activities that are to be autonomously performed on an agent. The format of the Rulebase is RB_<BW_Project/System>_<component> _<Function> Following are a few examples RB_ APP1-APP2_Logfile_checkPattern RB_ APP1-APP2_ADBAdapter_checkStatus
Version 1.0
error is logged. When TIBCO Hawk Agents is running in auto config mode, rulebases are loaded from the autoconfig directory. When TIBCO Hawk Agents is running in repository config mode, rulebases are loaded from the specified repository
4.3.2
In the EMMA Project we will be using the Manual Loading of the rulebases. In Manual Configuration mode, the agent performs the following sequence of tasks to load startup rulebases: At startup, the agent searches the configuration source for schedules, then for a rulebase map. The agent searches the configuration source and loads all rulebases specified in the rulebase map. The agent searches the configuration source for any additional rulebases specified in the rulebases command line option and loads them. If these rulebases have Include lists of other rulebases, the agent searches the configuration source for included rulebases and loads them. After an agent is started in Manual Configuration mode, we can load additional rulebases by invoking the RuleBaseEngine: loadRuleBase() or RuleBaseEngine:loadRuleBaseFromFile()
Note: A file will be maintained which would contain the list of rulebases that
will be monitored. If any rulebase fails to load from the list specified an alert would be triggered.
Version 1.0
All the rulebases for Production environment will be maintained in the //XXXX/PROD folder in perforce. The latest version the production rulebase will be exact copy of the production environment.
Rulebases for Test Environment
All the rulebases for Test environment will be maintained in the //XXX/TEST folder in perforce. The latest version the rulebase will be exact copy of the Test environment. Any new rule created must be first tested in the dev environment & later on baseline into the //EMMA/TEST folder on perforce.
5. Design Considerations
While creating a hawk rule base there are some important points that should be taken care. These points are based on the operation team experience in managing the NetApp TIBCO infrastructure.
4. Clear condition
When the adapter terminates, the hawk detects the condition as False. After executing the predefined rules this should ideally be set to True immediately. In the current implementation, this is being cleared after 300 seconds. In a synchronous environment it is recommended to set it immediately instead of waiting for 300 seconds.
Version 1.0
Version 1.0