Altair® Panopticon™ v2021 STREAMS SERVER INSTALLATION AND REFERENCE GUIDE TABLE OF CONTENTS [1] INTRODUCTION ....................................................................................................................................... 1 Acronyms .......................................................................................................................................... 1 Terminology ...................................................................................................................................... 1 Overview ......................................................................................................................................................... 1 Panopticon Streams Applications ..................................................................................................... 2 Panopticon Streams Operators ......................................................................................................... 3 Panopticon Streams Inputs ......................................................................................................... 4 Panopticon Streams Outputs ....................................................................................................... 4 System Requirements ..................................................................................................................................... 4 System Hardware Requirements ...................................................................................................... 5 Development / Test ..................................................................................................................... 5 Small Scale Deployment ............................................................................................................. 5 Medium Scale Deployment .......................................................................................................... 5 Large Scale Deployment ............................................................................................................. 6 [2] GETTING STARTED ................................................................................................................................. 7 Setting Up Confluent Kafka Enterprise on a Local Machine Using Docker ..................................................... 7 Setting Up ZooKeeper, Kafka, and Schema Registry ..................................................................................... 9 Additional Notes on Setting Up the Schema Registry ..................................................................... 10 Setting Up Panopticon Streams .................................................................................................................... 11 Open JDK 11+ Dependencies ........................................................................................................ 15 Background ............................................................................................................................... 15 Installation ................................................................................................................................. 15 Zip File Content ......................................................................................................................... 15 Importing the Bundle of Example Applications ................................................................................ 16 Configuration of the Client Properties ............................................................................................. 16 Licensing ....................................................................................................................................................... 19 Using Altair Units License in the Panopticon Streams .................................................................... 19 Using the Hosted Altair Units License in the Panopticon Streams Server ...................................... 21 Migration to Streams Server 2021.0 from an Older version .......................................................................... 22 1. Copy All Content .................................................................................................................. 23 2. Delete Old Content ............................................................................................................... 23 3. One-time Conversion ........................................................................................................... 23 4. Applications, Data Sources, and Data files .......................................................................... 24 5. Do Not Make Changes on Both Servers .............................................................................. 24 6. Post-migration Cleanup ........................................................................................................ 24 Upgrade ........................................................................................................................................................ 25 [3] AUTHENTICATION ................................................................................................................................. 26 Introduction ................................................................................................................................................... 26 Altair Engineering, Inc. All Rights Reserved. / Nasdaq:ALTR / altair.com Mapping Users to Roles .................................................................................................................. 27 Token .............................................................................................................................................. 28 Tomcat Realm ............................................................................................................................................... 29 Tomcat User Base .......................................................................................................................... 29 Tomcat Memory Configuration for Windows .............................................................................. 30 Tomcat Memory Configuration for Linux.................................................................................... 30 LDAP .............................................................................................................................................. 31 Active Directory ............................................................................................................................... 32 Windows Authentication ................................................................................................................................ 33 SAML ............................................................................................................................................................ 33 OAuth 2.0 ...................................................................................................................................................... 34 Example .......................................................................................................................................... 35 Filter .............................................................................................................................................................. 35 Creating a Custom Filter ................................................................................................................. 35 Header .......................................................................................................................................................... 37 [4] PCLI: COMMAND UTILITIES FOR PANOPTICON ................................................................................ 39 Export Data Sources ..................................................................................................................................... 39 Parameters ..................................................................................................................................... 39 Example 1: Export data sources from a workbook .................................................................... 39 Example 2: Export data sources from all workbooks example .................................................. 39 [5] USING ALTAIR PANOPTICON STREAMS ............................................................................................ 40 Connecting to or Disconnecting from the CEP Engine .................................................................................. 40 Connecting to the CEP Engine ....................................................................................................... 42 Disconnecting from the CEP Engine: .............................................................................................. 42 [6] MANAGING THE STREAMS SYSTEM .................................................................................................. 43 Setting the Server Metrics Publisher ............................................................................................................. 45 Viewing and Managing Kafka Properties ...................................................................................................... 46 Reloading Configurations .............................................................................................................................. 47 Logging/Monitoring .......................................................................................................................................