SAP Open Server and Open Client Configuration Guide for Windows Company
Total Page:16
File Type:pdf, Size:1020Kb
PUBLIC SAP Open Server and SDK for SAP Adaptive Server Enterprise 16.0 SP03 PL07 Document Version: 1.0 – 2019-06-06 SAP Open Server and Open Client Configuration Guide for Windows company. All rights reserved. All rights company. affiliate THE BEST RUN 2019 SAP SE or an SAP SE or an SAP SAP 2019 © Content 1 About Open Client and Open Server..............................................6 2 Configuration Overview....................................................... 7 2.1 Initializing Open Client and Open Server.............................................7 2.2 Making a Connection from Open Client..............................................8 2.3 Listening for a Request in Open Server..............................................8 3 Configuring Basic Tasks for Open Client and Open Server.............................9 4 Configuration Information Required for Open Client.................................10 5 Configuring Open Client......................................................13 6 Configuration Information Required for Open Server................................ 15 7 Configuring Open Server......................................................17 8 Configuring Open Client for SAP Failover.........................................19 8.1 Adding a hafailover Line to the sql.ini File............................................19 8.2 Modifying an Application with Client-Library Calls.....................................20 8.3 Using isql with SAP HA Failover...................................................21 9 Directory Service...........................................................23 9.1 LDAP Directory Services.......................................................23 9.2 LDAP Directory Services Versus the Interface File..................................... 24 9.3 Server Objects and Attributes...................................................26 9.4 Directory Drivers............................................................ 26 9.5 How Applications Use a Directory Service...........................................27 How Applications Use LDAP Directory Services.................................... 28 9.6 Enabling LDAP Directory Services................................................ 29 Specifying Multiple Directory Services with LDAP...................................30 Importing Microsoft Active Directory Schema......................................31 9.7 Connecting to LDAP using SSL/TLS...............................................32 10 Security Services...........................................................33 10.1 Network-based Security.......................................................33 Security Mechanisms.......................................................33 Security Drivers...........................................................34 Security Services..........................................................34 10.2 How Applications Use Security Services............................................38 SAP Open Server and Open Client Configuration Guide for Windows 2 PUBLIC Content Client-Library and Security Services............................................39 Server-Library and Security Services............................................39 10.3 Configuring Tasks to Use a Security Service......................................... 40 10.4 Data Protection in SAP Open Client and Open Server...................................40 11 ocscfg Utility..............................................................44 11.1 Starting ocscfg..............................................................44 11.2 Setting Environment Variables...................................................45 Setting the SYBASE Environment Variables.......................................45 Setting Environment Variables Other Than SYBASE................................. 46 Clearing Environment Variables Other Than SYBASE................................ 46 11.3 Configuring a Directory Driver...................................................47 Adding a Directory Driver Entry ............................................... 47 Modifying an Existing Directory Driver Entry.......................................48 Deleting a Directory Driver Entry...............................................49 Activating a Directory Driver..................................................49 11.4 Configuring a Security Driver....................................................49 Adding a Security Driver Entry................................................ 50 Modifying an Existing Security Driver Entry....................................... 50 Deleting a Security Driver Entry................................................51 Setting the Default Security Driver..............................................51 12 dsedit Utility...............................................................52 12.1 Using dsedit................................................................52 Opening a Session.........................................................53 12.2 Adding a Server to the Directory Services...........................................55 Adding a Server to the Directory Service Using dsedit................................55 12.3 Making and Modifying Server Entries..............................................56 Server Attributes..........................................................57 Adding a Server Entry...................................................... 58 Modifying a Server Entry.................................................... 58 Renaming a Server Entry....................................................59 Deleting Entries...........................................................59 12.4 Using the Ping Command......................................................59 12.5 Copying Server Entries........................................................60 Copying Entries Within a Session.............................................. 60 Copying Entries Between Sessions............................................. 61 12.6 Exiting dsedit...............................................................61 13 Troubleshooting with dsedit .................................................. 62 13.1 Troubleshooting Connection Failures.............................................. 62 If dsedit Fails.............................................................63 SAP Open Server and Open Client Configuration Guide for Windows Content PUBLIC 3 If dsedit Succeeds but Other Applications Fail..................................... 63 13.2 Commonly Asked Questions....................................................64 14 Environment Variables.......................................................65 14.1 Environment Variables Used for Connection.........................................65 14.2 Environment Variables Used for Localization.........................................66 14.3 Environment Variables Used for Configuration........................................66 15 Configuration Files..........................................................68 15.1 The libtcl.cfg and libtcl64.cfg Files................................................69 Layout of libtcl.cfg .........................................................69 15.2 The sql.ini File...............................................................76 sql.ini Entries.............................................................77 sql.ini Examples...........................................................78 Multiple Connection Service Entries............................................ 79 15.3 The ocs.cfg File............................................................. 80 16 Localization............................................................... 81 16.1 Environment Variables Used During Localization...................................... 81 16.2 Localization Files............................................................ 82 16.3 The Locales Directory.........................................................83 The locales.dat File........................................................ 83 Localized Message Files.....................................................85 16.4 The Charsets Directory........................................................86 Collating Sequence Files.................................................... 86 Unicode Conversion Files....................................................87 16.5 The ini Directory.............................................................87 The objectid.dat File........................................................87 17 Secure Sockets Layer in Open Client and Open Server...............................89 17.1 SSL Handshake.............................................................89 17.2 SSL Security Levels and Security Mechanisms.......................................90 17.3 Validating a Server by its Certificate...............................................91 Common Name Validation in an SDC Environment.................................. 91 The Trusted Roots File......................................................92 17.4 Requesting and Authorizing SSL Certificates Using Keytool and ExportPrivateKey Utility..........93 Creating a Self-signed Root Certificate...........................................94 Creating a Private Key and a Certificate Request for Server............................96 Converting a Certificate Request to a CA-signed Server Certificate.......................98 Encrypting the Server Private Key in PKCS8 Format.................................99 Appending Private Key to the Server Certificate................................... 100 17.5 FIPS 140-2