Deploying and Managing Apama Applications Version 10.5.3 May 2020 This document applies to Apama 10.5.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-2020 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 http://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 http://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 http://softwareag.com/licenses/ and/or in the root installation directory of the licensed product(s). Document ID: PAM-DEP-1053-20200525 Table of Contents About this Guide........................................................................................................................................5 Documentation roadmap..................................................................................................................6 Online Information and Support.....................................................................................................7 Data Protection...................................................................................................................................8 1 Security Requirements for Apama......................................................................................................9 2 Overview of Deploying Apama Applications.................................................................................13 About deploying components with Command Central.............................................................14 About deploying Apama applications with an Ant script.........................................................14 About deploying Apama applications with Docker...................................................................14 About deploying Apama applications with Kubernetes............................................................14 About Apama command line utilities...........................................................................................14 About deploying dashboards.........................................................................................................14 About tuning applications for performance.................................................................................15 Setting up the environment using the Apama Command Prompt...........................................15 3 Deploying Apama Components with Command Central.............................................................17 Overview of deploying components with Command Central..................................................18 Getting started with Command Central.......................................................................................18 Administering Apama in Command Central...............................................................................20 Monitoring Apama from Command Central...............................................................................46 Deploying a Designer project to Command Central...................................................................54 4 Deploying and Managing Queries....................................................................................................57 Overview of deploying and managing query applications.......................................................58 Query application architecture.......................................................................................................58 Deploying query applications........................................................................................................59 Running queries on correlator clusters.........................................................................................60 Managing parameterized query instances....................................................................................66 Monitoring running queries...........................................................................................................66 5 Deploying Apama Applications with Docker.................................................................................69 Introduction to Apama in Docker..................................................................................................70 Licensing Apama in Docker............................................................................................................71 Quick start to using an Apama image...........................................................................................72 Building an Apama image from the current installation............................................................74 Deploying an Apama application in Docker................................................................................75 Developing an Apama application using the Docker image.....................................................76 Building Apama projects during the Docker build.....................................................................77 Using Docker Compose with Apama............................................................................................79 Apama samples for Docker.............................................................................................................80 Deploying and Managing Apama Applications 10.5.3 iii Table of Contents Using the Apama image with the Docker stack...........................................................................81 6 Deploying Apama Applications with Kubernetes.........................................................................83 Introduction to Apama in Kubernetes..........................................................................................84 Quick start to using Apama in Kubernetes..................................................................................84 Deploying an Apama application using Kubernetes..................................................................85 Apama samples for Kubernetes.....................................................................................................87 7 Tuning Correlator Performance..........................................................................................................89 Scaling up Apama............................................................................................................................90 Partitioning strategies......................................................................................................................90 Engine topologies.............................................................................................................................94 Correlator pipelining.......................................................................................................................95 Using jemalloc to optimize memory usage................................................................................103 8 Restricting Correlator Resource Usage with Control Groups....................................................105 9 Managing and Monitoring over REST............................................................................................107 10 Monitoring with Prometheus.........................................................................................................111 11 Correlator Utilities Reference.........................................................................................................113 Starting the correlator....................................................................................................................114 Configuring the correlator............................................................................................................137 Injecting code into a correlator.....................................................................................................155 Creating and managing an Apama project from the command line......................................157 Deploying a correlator...................................................................................................................161 Deleting code from a correlator....................................................................................................166 Packaging correlator input files....................................................................................................169 Sending