Administering My Webmethods Server
Total Page:16
File Type:pdf, Size:1020Kb
Administering My webMethods Server Version 10.3 October 2018 This document applies to My webMethods Server 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 © 2004-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: MWS-AG-103-20200425 Table of Contents About This Guide......................................................................................................................................9 Exporting My webMethods Server Assets....................................................................................10 Document Conventions...................................................................................................................10 Online Information and Support...................................................................................................11 Data Protection.................................................................................................................................11 Deprecation of webMethods Broker..............................................................................................12 I Startup and Configuration...................................................................................................................13 1 Getting Started with My webMethods Server...........................................................................15 Introduction to My webMethods Server..............................................................................16 Starting and Stopping My webMethods Server on Windows..........................................17 Automatically Starting My webMethods Server on UNIX................................................17 Logging Into My webMethods Server..................................................................................17 Logging Out of My webMethods Server..............................................................................18 Changing the Administrator Password................................................................................18 2 Changing the My webMethods Server Configuration.............................................................21 Post-Installation Configuration Changes.............................................................................22 Using My webMethods Server with a MySQL Database..................................................22 Did You Install Without Specifying a Database?................................................................23 Guidelines for Multiple My webMethods Server Instances..............................................23 Changing the HTTP Listener Port for a Standalone Server...............................................24 Changing HTTP and HTTPS Listener Ports........................................................................24 Changing the JMX Listener Port............................................................................................25 Changing the JCR Repository RMI Listener Ports..............................................................26 Specifying the Java Location for My webMethods Server.................................................26 Managing Redirection in My webMethods Server.............................................................28 3 My webMethods Server and HTTPS..........................................................................................31 Using My webMethods Server as an HTTPS Client...........................................................32 Communicating with webMethods Applications Using HTTPS.....................................36 Managing Authentication Certificates as My webMethods Administrator...................37 4 Using My webMethods Server with Web Servers....................................................................43 Integration with Web Servers.................................................................................................44 My webMethods Server and Apache....................................................................................44 My webMethods Server and IIS............................................................................................44 5 Running My webMethods Server from the Command Line..................................................45 Basic Command Line Syntax for My webMethods Server................................................46 Executing My webMethods Server Commands..................................................................46 Accessing the Command Line Help Contents.....................................................................47 My webMethods Server Instance Administration Commands........................................47 My webMethods Server Instance Operation Commands..................................................53 My webMethods Server Instance Configuration Commands...........................................56 My webMethods Server Service Management Commands..............................................57 My webMethods Server OSGi Profile Commands.............................................................59 Start, Stop and Execute My webMethods Server Commands on Multiple Server Instances....................................................................................................................................61 Administering My webMethods Server 10.3 iii Table of Contents Log Files for mws Commands...............................................................................................62 6 Modifying Configuration Files....................................................................................................65 The Java Service Wrapper.......................................................................................................66 Configuring JVM Settings for My webMethods Server.....................................................69 Modifying Configuration Files Stored in the Database.....................................................73 Configuring My webMethods Server to Run in 32-bit on Solaris, HP-UX, or Linux....75 Configuring HTTP Listeners to Use a Single IP Address..................................................76 Configuring Whether Diagnostics Are Executed at Startup.............................................79 II My webMethods Administrator Functions....................................................................................81 7 Managing My webMethods Configuration...............................................................................83 Managing Directory Services.................................................................................................84 Managing External Directory Services.................................................................................86 Managing External Data Sources........................................................................................103 Managing Email Settings......................................................................................................111 Managing Calendars.............................................................................................................112 8 Searches for Users, Groups, and Roles.....................................................................................113 Searching for Existing Users, Groups, or Roles.................................................................114 Advanced Searches................................................................................................................114 Working with Saved Searches..............................................................................................116 Exporting Search Results to a .csv File...............................................................................118 9 Managing Users and Groups.....................................................................................................121 About Managing Users and Groups...................................................................................122 Managing Users.....................................................................................................................123