Identity Manager Connector for Java Messaging Service + DirXML® Driver 2.0 for Java* Message Service (JMS) Novelltm * and WebSphere MQ Driver Overview and Configuration Version 2.0 This document contains trade secrets and proprietary information. No use or disclo- sure of the information contained herein is permitted without prior written consent. All trade names, trademarks, or registered trademarks are trade names, trademarks, or registered trademarks of their respective companies. -1- Identity Manager Connector for Java Messaging Service Table of Contents TABLE OF CONTENTS................................................................................................. 2 PREFACE ...................................................................................................................... 5 DOCUMENTATION CONVENTIONS ............................................................................ 5 INTRODUCING THE DRIVER ....................................................................................... 6 Overview ...................................................................................................................................... 6 What Is JMS.................................................................................................................................. 7 High Availability JMS ................................................................................................................. 7 Understanding JMS Driver Concepts ..................................................................................... 7 JMS Engine Processing .............................................................................................................. 8 The DirXML Publisher Channel................................................................................................ 9 The DirXML Subscriber Channel.............................................................................................. 9 Publishing to eDirectory......................................................................................................... 10 Subscribing from eDirectory.................................................................................................. 10 Benefits....................................................................................................................................... 10 Features ..................................................................................................................................... 11 Java-Enabled Enterprise Application Integration (EAI) Systems ........................................ 11 Supported Platforms................................................................................................................ 12 JMS Driver Features ................................................................................................................ 12 For More Information about DirXML.................................................................................... 12 JMS Configuration and Setup ................................................................................................ 14 Using iManager.......................................................................................................................... 14 Product Components ............................................................................................................... 14 Driver Configuration................................................................................................................ 14 Driver Shim.............................................................................................................................. 14 INSTALLING AND CONFIGURING THE DRIVER ...................................................... 15 Prerequisites ............................................................................................................................. 15 -2- Identity Manager Connector for Java Messaging Service iManager................................................................................................................................... 15 Supported Platforms................................................................................................................. 16 PLANNING FOR INSTALLATION............................................................................... 16 JMS Checklist............................................................................................................................. 16 Planning a Local or Remote Installation............................................................................. 17 Local Installation...................................................................................................................... 17 Remote Installation .................................................................................................................. 17 Installing Components............................................................................................................. 17 Installing or Upgrading The Driver....................................................................................... 18 Installing the Driver ................................................................................................................. 18 Activating DirXML Products.................................................................................................... 20 Post- Installation Tasks ........................................................................................................... 21 Importing the Driver Configuration ......................................................................................... 21 Configuring the Remote Loader on the Remote System ................................................ 22 Generating a Security Certificate on the eDirectory Container ............................................... 23 Creating an Organizational Trusted Root Certificate............................................................... 23 Using the Wizard to Configure Remote Loader Properties on the Remote Loader Host Server .................................................................................................................................................. 24 Starting the Remote Loader if It Is Installed as a Service........................................................ 25 Starting the Remote Loader Manually ..................................................................................... 25 Configuring Driver Object Properties for the Remote Loader................................................. 26 Configuring The JMS Driver Parameters............................................................................. 27 Configuring Driver Parameters ................................................................................................ 27 Troubleshooting the Driver ................................................................................................... 30 Using the DSTrace Utility ....................................................................................................... 30 Common ErrorsDeveloping Solutions with the DirXML Driver for JMS ....................... 31 Developing Solutions with the DirXML Driver for JMS .................................................... 32 Using JMS Features.................................................................................................................. 32 Performance Data............................................................................................................... 35 Association Style Sheets......................................................................................................... 39 Overview .................................................................................................................................. 39 Association StyleSheet (XDS Format)..................................................................................... 39 Association Write Back (Non-XDS Format) ........................................................................... 39 Association (Publisher Channel).............................................................................................. 40 XSLT Channel Write-Back In Depth....................................................................................... 41 Sample Query Style Sheet........................................................................................................ 46 Sample Query Reply Documents ............................................................................................ 46 -3- Identity Manager Connector for Java Messaging Service Audit Features .......................................................................................................................... 48 Automatic Failover and Load Balancing ............................................................................. 49 Vendor Configurations ............................................................................................................ 50 Features .................................................................................................................................... 63 Message Properties................................................................................................................... 68 Message Body .......................................................................................................................... 68 JMS Messaging Models: Publish-and-Subscribe and Point-to-Point .....................................