Software AG Infrastructure Administrator's Guide
Total Page:16
File Type:pdf, Size:1020Kb
Software AG Infrastructure Administrator’s Guide Version 10.3 September 2020 This document applies to Software AG Shared Infrastructure 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 © 1999-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: SAG-INFRA-103-20210916 Table of Contents About this Guide........................................................................................................................................5 Document Conventions.....................................................................................................................6 Online Information and Support.....................................................................................................6 Data Protection...................................................................................................................................7 1 Concepts....................................................................................................................................................9 Software AG Common Platform....................................................................................................10 Software AG Runtime......................................................................................................................10 Software AG Security Infrastructure.............................................................................................11 Software AG Web Services Stack....................................................................................................12 The Java Service Wrapper...............................................................................................................14 2 webMethods Metering.........................................................................................................................15 About webMethods Metering........................................................................................................16 Collected Usage Data.......................................................................................................................16 Configuring webMethods Metering..............................................................................................18 Troubleshooting webMethods Metering.......................................................................................20 3 Running Web Applications.................................................................................................................23 Configuring Software AG Runtime Credentials..........................................................................24 Changing the Default Software AG Runtime Keystore and Truststore...................................24 About Configuring HTTP Connectors..........................................................................................26 About Configuring HTTPS Connectors........................................................................................27 Accepting an HTTPS Connection on the Client Side..................................................................29 About the Predefined JMX Connector...........................................................................................29 About Configuring JNDI Resources..............................................................................................31 Configuring the Software AG Runtime Java Service Wrapper..................................................34 Configuring Software AG Runtime Log Settings........................................................................35 Hot Configuration Update..............................................................................................................35 Using Path Tokens............................................................................................................................36 Starting and Stopping Software AG Runtime..............................................................................37 Managing Software AG Runtime Security...................................................................................38 4 Setting Up Security...............................................................................................................................39 Setting Up the JAAS Configuration File.......................................................................................40 Turning On Logging........................................................................................................................43 Making the JAAS Configuration File Active................................................................................43 Creating Technical User Credential Files......................................................................................43 Creating or Editing Internal User Repository Files.....................................................................44 Creating Login Modules..................................................................................................................45 Using the LDAP Framework..........................................................................................................46 Updating the Single Sign-On System for Your Product.............................................................47 Creating Custom Keys and Certificates........................................................................................49 Software AG Infrastructure Administrator’s Guide 10.3 iii Table of Contents Developing a JAAS Client...............................................................................................................50 Troubleshooting Problems..............................................................................................................50 Predefined Login Modules..............................................................................................................51 5 Working with Web Services................................................................................................................63 Configuring Web Services Stack.....................................................................................................64 Configuring Web Service Security.................................................................................................67 About Configuring Message Transports.......................................................................................84 Configuring Logging in Web Services Stack................................................................................95 Deploying Web Services Stack........................................................................................................95 Deploying Web Services Stack on an Apache Tomcat Installation...........................................96 Managing Web Services...................................................................................................................96 6 Configuring the Java Service Wrapper..............................................................................................99 Determine Whether Your Product Uses the Java Service Wrapper, and Which Version.....100 Editing Java Service Wrapper Properties....................................................................................100 Generating a Thread Dump Using the Java Service Wrapper Utility.....................................101 7 Using Command Central to Manage Software AG Runtime (CTP).........................................103 Configuration Types That OSGI-CTP-TOMCAT-ENGINE Supports.....................................104 Lifecycle Actions for OSGI-CTP-TOMCAT-ENGINE...............................................................104 Run-Time Monitoring Statuses for OSGI-CTP-TOMCAT-ENGINE.......................................105 8 Software AG Runtime Logging........................................................................................................107 Software AG Runtime Audit Logging.........................................................................................108