Universal Messaging Administration Guide
Total Page:16
File Type:pdf, Size:1020Kb
Universal Messaging Administration Guide Version 10.3 October 2018 This document applies to Software AG Universal Messaging 10.3 and to all subsequent releases. Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions. Copyright © 2013-2021 Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors. The name Software AG and all Software AG product names are either trademarks or registered trademarks of Software AG and/or Software AG USA Inc. and/or its subsidiaries and/or its affiliates and/or their licensors. Other company and product names mentioned herein may be trademarks of their respective owners. Detailed information on trademarks and patents owned by Software AG and/or its subsidiaries is located at https://softwareag.com/licenses/. Use of this software is subject to adherence to Software AG's licensing conditions and terms. These terms are part of the product documentation, located at https://softwareag.com/licenses/ and/or in the root installation directory of the licensed product(s). This software may include portions of third-party products. For third-party copyright notices, license terms, additional rights or restrictions, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products". For certain specific third-party license restrictions, please refer to section E of the Legal Notices available under "License Terms and Conditions for Use of Software AG Products / Copyright and Trademark Notices of Software AG Products". These documents are part of the product documentation, located at https://softwareag.com/licenses/ and/or in the root installation directory of the licensed product(s). Document ID: NUM-AG-103-20210930 Table of Contents About this Documentation.......................................................................................................................5 Online Information and Support.....................................................................................................6 Data Protection...................................................................................................................................6 Overview......................................................................................................................................................7 2 Universal Messaging Enterprise Manager.........................................................................................9 Introduction.......................................................................................................................................10 Starting the Enterprise Manager....................................................................................................10 Tab-by-Tab Overview.......................................................................................................................11 Administration Using Enterprise Manager..................................................................................14 Using the Enterprise Viewer.........................................................................................................351 3 Using Command Central to Manage Universal Messaging.......................................................353 Managing Universal Messaging Using Command Central.....................................................354 Securing Communication Between Command Central and Universal Messaging..............354 Securing Access to Command Central........................................................................................356 Instance Management....................................................................................................................358 Authentication Configuration......................................................................................................360 Universal Messaging Configuration Types................................................................................360 Universal Messaging Administration Types..............................................................................387 Snooping on Channels...................................................................................................................391 Snooping on Queues......................................................................................................................393 Publishing Events...........................................................................................................................396 Universal Messaging Cloud Transformation.............................................................................398 Universal Messaging Logs............................................................................................................399 Universal Messaging Inventory...................................................................................................399 Universal Messaging Lifecycle Actions.......................................................................................399 Universal Messaging KPIs............................................................................................................400 Universal Messaging Run-time Monitoring Statuses...............................................................401 Universal Messaging and the Command Line Interface..........................................................401 4 Comparison of Enterprise Manager and Command Central Features......................................453 5 Setting up Active/Passive Clustering with Shared Storage........................................................461 About Active/Passive Clustering.................................................................................................462 Overview of Active/Passive Clustering on Windows...............................................................466 Overview of Active/Passive Clustering on UNIX......................................................................467 Configuring a Universal Messaging Active/Passive Cluster on UNIX...................................469 6 Command Line Administration Tools............................................................................................473 Introduction to the Administration Tools...................................................................................474 Universal Messaging Administration Guide 10.3 iii Table of Contents Starting the Tools using the Tools Runner Application............................................................474 Performing Standard Administration Tasks on Realms and Clusters....................................476 Running a Configuration Health Check.....................................................................................482 The "Realm Information Collector" Diagnostic Tool.................................................................492 The ExportEventsFromOfflineMemFile Tool.............................................................................499 The RepublishEventsFromOfflineFile Tool.................................................................................502 Syntax reference for command line tools....................................................................................503 7 Universal Messaging Administration API.....................................................................................579 Introduction.....................................................................................................................................580 Administration API Package Documentation............................................................................583 Namespace Objects........................................................................................................................583 Realm Server Management...........................................................................................................589 Security............................................................................................................................................597 Management Information.............................................................................................................601 8 Thread Pool Monitoring....................................................................................................................609 9 Data Protection and Privacy..............................................................................................................613 iv Universal Messaging Administration Guide 10.3 About this Documentation ■ Online Information and Support ....................................................................................... 6 ■ Data Protection ................................................................................................................. 6 Universal Messaging Administration Guide 10.3 5 Online Information and Support Software AG Documentation Website You can find documentation on the Software AG Documentation website at http:// documentation.softwareag.com. The site requires credentials for Software AG's Product Support site Empower. If you do not have Empower credentials, you must use the TECHcommunity website. Software AG Empower Product Support Website If you do not yet have an account for Empower, send an email to [email protected] with your name, company, and company email address and request an account. Once you have an account, you can open Support Incidents