IBM Connect:Direct for UNIX 6.1 Documentation IBM This edition applies to Version 5 Release 3 of IBM® Connect:Direct and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 1993, 2018. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Release Notes.......................................................................................1 New Features and Enhancements...............................................................................................................1 Hardware and Software Requirements....................................................................................................... 3 Support policy for Container Delivery Models.............................................................................................5 Known Restrictions...................................................................................................................................... 5 Upgrade Considerations.............................................................................................................................. 7 Upgrading Connect:Direct File Agent on AIX.............................................................................................. 7 Special Considerations................................................................................................................................ 7 Special Considerations for Connectivity with the HP NonStop Kernel Operating System................... 8 Connect:Direct for UNIX Guidelines............................................................................................................8 Libraries to Install........................................................................................................................................ 8 Chapter 2. Getting Started Guide......................................................................... 11 Connect:Direct for UNIX Overview............................................................................................................11 Process Manager.................................................................................................................................. 11 Command Manager.............................................................................................................................. 11 Session Manager.................................................................................................................................. 12 User Authorization................................................................................................................................12 Process Restart.................................................................................................................................... 12 Archive Statistics Files......................................................................................................................... 13 Sample Processes, Shell Scripts, and API Programs.......................................................................... 13 Connect:Direct for UNIX Configuration Files.......................................................................................14 Connect:Direct for UNIX Directory Structure...................................................................................... 15 Installation Overview.................................................................................................................................15 Installing Connect:Direct for UNIX............................................................................................................16 Preparing to Install Connect:Direct for UNIX in a Cluster Environment.............................................16 Conventions to Observe When Installing Connect:Direct for UNIX....................................................18 Installation Worksheets....................................................................................................................... 18 Installing IBM Connect:Direct..............................................................................................................26 Customizing Connect:Direct for UNIX................................................................................................. 27 Setting Up the IBM Connect:Direct Server.......................................................................................... 28 Setting Up the Connect:Direct for UNIX Client....................................................................................29 Installing Connect:Direct File Agent....................................................................................................31 Installing Connect:Direct Secure Plus................................................................................................. 32 Defining High-Availability Settings in the Configuration Files.............................................................34 Setting Up Additional Configuration Requirements for IBM HACMP..................................................35 Setting Up Additional Configuration Requirements for Hewlett-Packard MC/ServiceGuard ............35 Verifying the Installation......................................................................................................................36 Deploying IBM Connect:Direct for UNIX using a Docker container..........................................................37 Prerequisites to Deploy Connect:Direct® for UNIX using a Docker container.................................... 37 Deploying the Software........................................................................................................................ 41 Validating the Deployment...................................................................................................................44 Post Deployment Configurations......................................................................................................... 45 Container Stop/Restart procedure.......................................................................................................45 Container Recovery.............................................................................................................................. 46 Known Limitations................................................................................................................................46 Upgrading IBM Connect:Direct for UNIX using a Docker Container................................................... 47 Migrating IBM Connect:Direct for Unix using a Docker Container...................................................... 48 Deploying IBM Connect:Direct for UNIX using an IBM Certified Container Software............................. 49 Planning................................................................................................................................................ 50 iii Installing...............................................................................................................................................53 Post-installation tasks..........................................................................................................................70 Upgrade, Rollback, and Uninstall.........................................................................................................70 Known Limitations................................................................................................................................71 Migrating to Connect:Direct for UNIX using Certified Container Software.........................................72 Migration from Helm 2 to Helm 3 ........................................................................................................73 Troubleshooting your deployment in an IBM Certified container and Docker environment...................73 Troubleshooting IBM Certified container and Docker Container issues.............................................73 Troubleshooting in a Docker Container environment..........................................................................76 Troubleshooting your IBM certified Containerized environment........................................................77 Managing Files with Sterling Connect:Direct File Agent...........................................................................79 Connect:Direct File Agent Operation................................................................................................... 80 Connect:Direct File Agent Logging Capabilities...................................................................................80 Connect:Direct File Agent Configuration Interface and Help............................................................. 80 Planning the Connect:Direct File Agent Configuration........................................................................80 IBM Connect:Direct Worksheet........................................................................................................... 81 Sterling Connect:Direct File Agent Configuration Examples...............................................................82 Connect:Direct Manual Pages....................................................................................................................84 Accessing IBM Connect:Direct Manual Pages.....................................................................................85 Virtualization support...............................................................................................................................