Appeon Server Configuration Guide for .NET Appeon® for PowerBuilder® 2016 (on .NET) FOR WINDOWS DOCUMENT ID: ADC20240-01-0700-01 LAST REVISED: September 07, 2016 Copyright © 2000-2016 by Appeon Limited. All rights reserved. This publication pertains to Appeon software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Appeon Limited. Appeon, the Appeon logo, Appeon Developer, Appeon Enterprise Manager, AEM, Appeon Server and Appeon Server Web Component are registered trademarks of Appeon Limited. SAP, Sybase, Adaptive Server Anywhere, SQL Anywhere, Adaptive Server Enterprise, iAnywhere, PowerBuilder, Sybase Central, and Sybase jConnect for JDBC are trademarks or registered trademarks of SAP and SAP affiliate company. Java and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. All other company and product names used herein may be trademarks or registered trademarks of their respective companies. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Appeon Limited, 1/F, Shell Industrial Building, 12 Lee Chung Street, Chai Wan District, Hong Kong. Contents 1 About This Book .................................................................................................... 1 1.1 Audience ...................................................................................................... 1 1.2 How to use this book .................................................................................. 1 1.3 Related documents ...................................................................................... 1 1.4 If you need help .......................................................................................... 3 2 Server Configuration Tasks ................................................................................... 4 2.1 Scope of configurations discussed in this book ........................................... 4 2.2 Configuration stages and tasks ................................................................... 4 2.2.1 Configuration during application deployment ..................................... 5 2.2.2 Configuration during debugging ........................................................ 5 2.2.3 Configuration during security management ....................................... 6 2.2.4 Configuration during performance management ............................... 6 2.2.5 Configuration during server information management ....................... 7 2.2.6 Configuration for emergency control ................................................. 7 3 Appeon Server Monitor .......................................................................................... 9 3.1 Overview ...................................................................................................... 9 3.2 Launching Appeon Server Monitor .............................................................. 9 3.3 Configuring Monitors .................................................................................. 10 3.3.1 General tab ...................................................................................... 11 3.3.2 Common Monitors tab ..................................................................... 12 3.3.3 Recycle Monitor tab ......................................................................... 14 3.3.4 Mail Settings tab .............................................................................. 15 3.3.5 Log Settings tab .............................................................................. 16 3.4 Understanding the information in monitor window ..................................... 18 4 Database Connection Setup ................................................................................ 20 4.1 Overview .................................................................................................... 20 4.2 What is Appeon Server data source? ....................................................... 20 4.3 Supported Database Drivers ..................................................................... 20 4.4 Setting up Appeon Server data sources .................................................... 21 4.4.1 Data source settings for ODBC driver ............................................. 21 4.4.2 Data source settings for SQL Anywhere .NET Data Provider .......... 22 4.4.3 Data source settings for Oracle native driver .................................. 24 4.4.4 Data source settings for SQL Server native driver .......................... 25 4.4.5 Data source settings for Informix native driver ................................ 25 4.4.6 Data source settings for MySQL native driver ................................. 30 4.4.7 Data source settings for ASE native driver ...................................... 31 4.4.8 Data source settings for Teradata native driver ............................... 32 4.4.9 Data source settings for IBM DB2 native driver .............................. 33 4.4.10 Data source settings for PostgreSQL native driver ........................ 34 4.5 Setting up transaction object to data source mapping ............................... 35 4.5.1 Dynamic transaction object to data source mapping ....................... 36 4.5.2 Static transaction object to data source mapping ............................ 37 4.6 Advanced configurations related with database connection ...................... 37 4.6.1 Application security .......................................................................... 37 4.6.1.1 Database security .................................................................. 38 4.6.1.2 Using INI files for connection security ................................... 38 4.6.2 Appeon security ............................................................................... 39 4.6.2.1 Incorporate Appeon security in PowerBuilder code ............... 40 4.6.2.2 Database auditing .................................................................. 40 5 AEM User Guide .................................................................................................. 41 5.1 Introduction ................................................................................................ 41 5.1.1 Overview .......................................................................................... 41 5.1.2 AEM Tools ....................................................................................... 41 5.1.3 Supported Web browsers ................................................................ 41 5.2 Getting started ........................................................................................... 42 5.2.1 Running Appeon Server .................................................................. 42 5.2.2 Starting AEM ................................................................................... 43 5.2.2.1 AEM URL .............................................................................. 43 5.2.2.2 Three ways to launch AEM ................................................... 43 5.2.2.3 AEM user name and password ............................................. 43 5.2.2.4 Installing Appeon Workspace ................................................ 43 5.2.2.5 AEM language ....................................................................... 44 5.2.3 AEM Help ........................................................................................ 45 5.3 Server ......................................................................................................... 46 5.3.1 Sessions .......................................................................................... 46 5.3.1.1 Active Sessions ..................................................................... 46 5.3.1.2 Active Transactions ............................................................... 48 5.3.1.3 Deployment Sessions ............................................................ 49 5.3.2 Logging ............................................................................................ 50 5.3.2.1 Viewing logs .......................................................................... 50 5.3.2.2 Log mode .............................................................................. 51 5.3.2.3 Replace log files .................................................................... 52 5.3.3 Resources ........................................................................................ 53 5.3.3.1 Cluster ................................................................................... 53 5.3.3.2 Data Source ........................................................................... 57 5.3.3.3 Maintenance .......................................................................... 62 5.3.4 Product Activation ............................................................................ 64 5.3.4.1 Licensing ................................................................................ 65 5.3.4.2 Support .................................................................................. 74 5.3.5 Server Security