Etrust Directory Administrator Guide
Total Page:16
File Type:pdf, Size:1020Kb
eTrust ™ Directory Administrator Guide 4.1 This documentation and related computer software program (hereinafter referred to as the “Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (“CA”) at any time. This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies. This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the user’s responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed. To the extent permitted by applicable law, CA provides this documentation “as is” without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or non- infringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage. The use of any product referenced in this documentation and this documentation is governed by the end user’s applicable license agreement. The manufacturer of this documentation is Computer Associates International, Inc. Provided with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions. This product includes code licensed from RSA Data Security. 2003 Computer Associates International, Inc. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Contents Chapter 1: Introduction The Importance of Distributed Directories....................................................... 1-2 Replication ............................................................................... 1-2 Distribution .............................................................................. 1-2 eTrust Directory Features...................................................................... 1-4 Directory Information Storage and Management ............................................. 1-4 Performance .............................................................................. 1-4 Reliability ................................................................................ 1-5 Scalability ................................................................................ 1-6 Distribution .............................................................................. 1-7 Replication ............................................................................... 1-8 Security .................................................................................. 1-8 Operational Extensions .................................................................... 1-9 Integration ............................................................................... 1-9 eTrust Directory Modules .................................................................... 1-10 Other Components of eTrust Directory..................................................... 1-11 DXconsole............................................................................... 1-12 The DXserver Process .................................................................... 1-12 The RDBMS ............................................................................. 1-13 Configuration Files....................................................................... 1-13 DXtools ................................................................................. 1-13 Samples ................................................................................. 1-14 RDBMS Tools............................................................................ 1-15 DXweb Server ........................................................................... 1-15 Chapter 2: DXserver Overview DXserver Configuration ....................................................................... 2-2 DXserver Directories ...................................................................... 2-3 The Config Subdirectories ................................................................. 2-4 File Types ................................................................................ 2-5 DXserver Commands ......................................................................... 2-6 Contents iii Command-line Options .................................................................... 2-6 The Initialization File ...................................................................... 2-8 Configuration Grouping Files............................................................... 2-9 DXserver Script Language .................................................................... 2-10 Configuration Files ....................................................................... 2-10 Command Syntax ........................................................................ 2-11 Script Files ............................................................................... 2-12 Script File Errors and Debugging........................................................... 2-13 DXconsole ................................................................................... 2-14 Configuring DXconsole ................................................................... 2-14 Opening DXconsole....................................................................... 2-15 Closing DXconsole........................................................................ 2-15 Help Command .......................................................................... 2-16 Command Shortcuts ...................................................................... 2-16 Databases ................................................................................... 2-17 Multiple DSA Processes to One DIT/DIB ................................................... 2-17 Multiple Directory Databases on One Machine .............................................. 2-18 Hot Swap ................................................................................ 2-18 Chapter 3: General Administration Defining DSAs ................................................................................ 3-1 Port Numbers ............................................................................. 3-4 Viewing Communications Settings .......................................................... 3-4 Alarms, Traces, and Logs ...................................................................... 3-5 Alarms ................................................................................... 3-5 Traces .................................................................................... 3-5 Logs...................................................................................... 3-8 Associations ................................................................................. 3-13 Assoc Commands ........................................................................ 3-13 Viewing Association Configuration ........................................................ 3-15 Viewing Associations ..................................................................... 3-16 Tracing Associations ...................................................................... 3-16 Stopping a DSA .......................................................................... 3-16 Association Times ........................................................................ 3-17 Controlling Binds......................................................................... 3-17 Aborting Associations .................................................................... 3-18 Concurrent Associations .................................................................. 3-18 Association Queues....................................................................... 3-19 Local Operations ............................................................................. 3-20 Oper Commands ......................................................................... 3-20 Viewing Operation Configuration.......................................................... 3-21 iv eTrust Directory Administrator Guide Viewing Operation Statistics .............................................................. 3-22 Concurrent Operations ................................................................... 3-22 Administration Limits .................................................................... 3-23 Operational Attributes.................................................................... 3-23 Access Controls .......................................................................... 3-23 Read Only..............................................................................