Dollar Universe SNMP Monitoring User Guide Version: 6.6.01 Publication Date: 2016-02 Automic Software GmbH
ii Copyright Copyright Automic and the Automic logo are trademarks owned by Automic Software GmbH (Automic). All such trademarks can be used by permission only and are subject to the written license terms. This software/computer program is proprietary and confidential to Automic Software and is only available for access and use under approved written license terms. This software/computer program is further protected by copyright laws, international treaties and other domestic and international laws and any unauthorized access or use gives rise to civil and criminal penalties. Unauthorized copying or other reproduction of any form (in whole or in part), disassembly, decompilation, reverse engineering, modification, and development of any derivative works are all strictly prohibited, and any party or person engaging in such will be prosecuted by Automic Software. No liability is accepted for any changes, mistakes, printing or production errors. Reproduction in whole or in part without permission is prohibited. Copyright Automic Software GmbH. All rights reserved. Other names may be trademarks of their respective holders.
Dollar Universe SNMP Monitoring User Guide iii Contents 1 Release Notes... 5 2 Introduction... 6 2.1 Overview... 6 2.2 Features... 6 2.3 Architecture... 7 2.3.1 Management Information Base... 7 3 Configuration... 11 3.1 Node Settings... 11 3.2 Logging... 11 3.3 Alerting Rules... 12 4 About Automic Software, Community and Services... 13 4.1 Automic Software Company... 13 4.2 Automic Community... 13 4.3 Download Center... 13 4.4 Technical Support... 14 4.5 Training and Services... 14
Chapter 1 Release Notes 5 1 Release Notes The following is the change history. Information on bug-fixes and known errors is available in the Workload Automation Release Notes and by contacting Automic technical support. Date Key Features 2014-11 Dollar Universe user manuals change their look to integrate the Automic world. 2015-02 New node setting
6 Chapter 2 Introduction 2 Introduction Welcome to the Dollar Universe SNMP Monitoring User Guide! This user manual contains information that is useful for: Consultants Dollar Universe users and administrators Administrators and operators responsible for monitoring and controlling applications It is assumed that the reader has an understanding of Dollar Universe, UniViewer as well as SNMP concepts. 2.1 Overview This manual describes the technical data and functions of Dollar Universe V6 SNMP Monitoring. The UniViewer interface is described in the Dollar Universe UniViewer Console Interface Manual. Dollar Universe proposes integration packages with leading software solutions to provide coherent overall management of batch processing in the corporate information system. These integration packages are built to handle batch jobs submitted by all types of applications, whether in-house developments or standard software packages. In the SNMP context, the Dollar Universe SNMP Monitoring module supervises batch operations from a SNMP Network management system (NMS). Dollar Universe jobs can be monitored with SNMP. A MIB is designed for Dollar Universe and should be installed on the NMS side. In Dollar Universe, the SNMP monitoring is set from UniViewer. The Dollar Universe MIB is built to take into account new information like Task ID and Task Management Unit. This MIB is compatible with SNMP v1 and SNMP v2c. 2.2 Features Dollar Universe SNMP Monitoring enables job runs monitoring within Dollar Universe. Four kinds of notifications can be sent: duasuprocstatuschanged: Uproc run status duassessionstatuschanged: Session run status duasuprocduration: Uproc duration duassessionduration: session duration The user can configure: Jobs that need monitoring (Task, MU, Session, Uproc), Statuses to be notified Durations: if the run time is too short or too long or if the waiting time is too long.
Chapter 2 Introduction 7 2.3 Architecture The key elements of a SNMP-managed network are: The managed elements (hardware device, or a software component) The SNMP agent The SNMP manager or NSM Figure 1: Architecture Schema Using SNMP terminology: Dollar Universe job runs are the managed elements. Dollar Universe acts as the SNMP agent. It collects information on job runs and sends notifications (traps) to the SNMP Manager. Dollar Universe acts as the SNMP agent. The IO server of the job/session run Area sends a notification directly to NSM according to the established configuration. Messages sent between SNMP agent and SNMP manager are named PDU (Protocol Data Unit). PDU are exchanged using the UDP protocol. The agent sends traps to the manager on the UDP port 162. This port is the default value, and can be changed. 2.3.1 Management Information Base SNMP uses a Management Information Base (MIB) to describe the structure of the information related to managed elements. In order to receive SNMP notifications, administrators must import Dollar Universe s MIB in their monitoring tool according to their own tool s methodology. Administrators shall refer to their tool s documentation to install the MIB. The monitoring tool they use must support SNMP v2. The MIB file is called DUAS6-MIB and is delivered in the UNI_DIR_BIN folder of the Dollar Universe Company The MIB for Dollar Universe V6 is shown below:
8 Chapter 2 Introduction Figure 2: Dollar Universe V6 MIB Structure The different items of the duasjobmonitor table are described below: duasjobtskid: executed Task ID. If the Uproc or Session runs outside of a Task, this ID is empty. duasjobtskmu: Management Unit of the executed Task. If the Uproc or Session is executed outside of this Task, this Management Unit remains empty. duasjobuproc: executed Uproc s code (unavailable parameter for a notification on a Session). duasjobsession: executed Session s code (unavailable parameter for a notification on a Uproc) duasjobmu: Uproc execution Management Unit s code. This ID cannot be empty. duasjobstatus: Job Status For a Uproc, the status value can be: o Completed (1) o Aborted (2)
Chapter 2 Introduction 9 o Pending (3) o Running (4) o Refused (5) o EventWait (6) o TimeOverrun (7) o LaunchWait (8) o Disabled (11) For a Session, the status value can be: o Executing (9) o Terminated (10) duasjobalertdatetime: Date and time of the notification dispatch by the IO server in the YYYY/MM/DD hh:mm:ss form. duasjobcompany: Dollar Universe Company for which the job was executed duasjobarea: Area in which the job was executed o Application (1) o Integration (2) o Simulation (3) o Production (4) duasjobnode: Dollar Universe node on which the job was executed duasjobrunid: Job run launch ID duasjobrunuprid: Uproc execution ID (unavailable parameter for a notification on a session) duasjobrunsessid: Session execution ID (unavailable parameter of a notification on a Uproc) duasjobuser: job submission account duasjobqueue: job submission batch queue duasjobpriority: job priority in the batch queue duasjobapplication: Application linked to the Uproc (unavailable parameter for a notification on a Session) duasjobdomain: Domain associated to the Uproc application (unavailable parameter for a notification on a Session) duasjobprocessingdate: Job date processing in a YYYYMMDD form. duasjobsessver: Session s version (unavailable parameter for a notification on a Uproc) duasjobuprver: Uproc version (unavailable parameter for a notification on a Session) duasjobinformation: Job Information field value duasjobuniseverity: Job Severity field value duasjobstdseverity: o Alert High: Notification severity is Critical (3) o Alert Medium: Notification severity is Major (4) o Alert Low: Notification severity is Minor (5) duasjobalerttype: Monitoring duration Alert type (unavailable parameter for status monitoring)
10 Chapter 2 Introduction o o o toolongrun (1): Execution duration is too long tooshortrun (2): Execution duration is too short toolongwaiting (3): Waiting time is too long duasjobstatisticalruntime: Value of the "Based on statistical runtime" field, defined in the alert rule (unavailable parameter for a notification on the status) duasjobabsoluteduration: Value of the "Based on absolute duration" field, defined in the alert rule (unavailable parameter for a a notification on the status) In the case of a job or a session s duration monitoring, combining different items such as duasjobalerttype / duasjobstatisticalruntime or duasjobalerttype / duasjobabsoluteduration allows you to find the exact definition of the alert. The fields length is described in Dollar Universe Interface Manual for UniViewer or the UniViewer Console Online Help, in the "Length of Objects" section.
Chapter 3 Configuration 11 3 Configuration Dollar Universe SNMP Monitoring has a three-step configuration: General setup Logging Alerts setup 3.1 Node Settings SNMP Monitoring s general set up is performed from UniViewer Console Administration > Nodes > Nodes. In the Nodes list, select the Dollar Universe node which will send the notifications and click on Node Settings. Then in the categories list, select SNMP Monitoring. As for Dollar Universe, the variables are of Install (I), Static (S) or Dynamic (D) type. The variables related to Dollar Universe Installation cannot be modified. They are Install type. The other variables of Static or Dynamic type can be modified with UniViewer Console or with the unisetvar command. The change in static variables requires Dollar Universe to be restarted for the changes to take effect. Dynamic variables are taken into account without having to restart it. Variable / Name I/S/D Description UNI_SNMP_VERSION Implementation SNMP version S Select the SNMP version used: SNMP v2 (by default for DUAS V6) UNI_SNMP_TARGET SNMP network coordinates SNMP_COMMUNITY_NAME SNMP community S S Enter the network address (IP address or network name) of the SNMP Manager which will receive notifications and the associated port number. By default: localhost:162. "public" by default This configuration must be performed for each Dollar Universe node which will send notifications to the SNMP Manager. After updating these node parameters you will be required to restart Dollar Universe. 3.2 Logging Traces of the SNMP Monitoring activity are written to the Dollar Universe log file %UNI_DIR_LOG%\universe.log. Valid SNMP Monitoring logging keywords and their meanings are listed below: Keyword IOALM IOSPVSNMP Usage Alerting SNMP monitoring messages To update the logging level from UniViewer Console: Administration mode > Nodes > Nodes Select Dollar Universe node > Node Settings > Logging > Main Log Level Add the keyword to the list.
12 Chapter 3 Configuration For example: 0,IOALM,IOSPVSNMP The logging level is dynamic; changes are taken into account as soon as the user saves the nodes settings. 3.3 Alerting Rules Selecting jobs to monitor and notifications to be sent is performed from UniViewer Console, in Monitoring mode. Select the configuration which should be monitored: Dollar Universe V6 node and the Area, then select Operations Settings > Alerting Rules. This document is detailed in the Dollar Universe Interface Manual for UniViewer or in UniViewer Console online help, in DU Alerting Rules section. The user must define alerting rules (one or more) matching the jobs to be monitored by SNMP. Click on New to create a new alerting rule In the alerting rule definition: The General section enables you to enter the alerting rule id and its priority level. The Criteria section allows you to define filters on the Node, the Area and the job characteristics and to select the jobs to be monitored. The Monitor section enables you to select the monitoring type ; status or job duration followup In the Notification section, select SNMP As soon as the IO server updates a job which matches the selected criteria, a SNMP notification is sent to the SNMP Manager. The Manager is defined in the node settings. At the same time, the Job Monitor displays the alert in the Action column: If the alert is defined with a Medium or a High criticalness, a specific icon appears in the Action column which signals an alert was sent for this job. If the alert was defined with a Low criticalness, no icon will be displayed in the Action column of the Job Monitor.
Chapter 4 About Automic Software, Community and Services 13 4 About Automic Software, Community and Services This topic introduces the Automic Software company and how to leverage the full potential of our solutions to you. You can also obtain Automic documentation online from docs.automic.com. 4.1 Automic Software Company Automic Software is dedicated to business automation. Automic is the world's most comprehensive platform in automating businesses. Founded 1985, Automic pioneered the largest, independent, globally deployed automation platform which powers the enterprise, application and infrastructure. Now, as the consumerization of IT accelerates, Automic is re-imagining how organizations integrate next generation service models such as Cloud, DevOps and Big Data. Today, our software automates tens of millions of operations a day for over 2,000 customers worldwide. We challenge conventional thinking, enabling our customers to be faster, smarter, in control. Automic the standard in business automation. Find out more at our website www.automic.com. 4.2 Automic Community Want to connect with other Automic users to compare notes or learn how others are tackling problems that you re running into? Talk with other users from around the world to learn how they optimize their business automation with Automic. Interact with the Automic Team to get ONE Automation Platform tips and tricks straight from the source. Join the Automic Community and become an Automic Insider and be among the first to get news about new products and events, even before they are generally announced! 4.3 Download Center Make sure that you are using our products to their fullest potential. The Download Center is the place where you find product downloads, documentation and information on new releases and hot-fixes about your Automic solution. It s all in one place: from service hotfixes, release notes, and all guides. You will also find patch descriptions, known bugs or workarounds.
14 Chapter 4 About Automic Software, Community and Services 4.4 Technical Support We have a support team you can trust. Our team of professionals is ready to support you, anytime and anywhere. Three support centers located in Europe, the United States, and Asia Pacific build the core of the Automic support organization. Our Technical Support Team makes sure that your closest Automic experts are never more than a few hours flight away, no matter on which continent your subsidiaries and data centers are located. Automic Software is designed to provide global connectivity for international companies. You are employing Automic software on a global scale and therefore you can expect global service. 4.5 Training and Services Do you want to learn even more about Automic solutions? We offer a range of training options on how to get the most out of your Automic solution. Depending on your location, either open training sessions at an Automic Software Service Center, or personalized training sessions at your company's site suits best. Visit the training site and get detailed information about currently offered courses.