Transcription
IBMIBM Sterling Connect:Direct for Windows4.8
iiIBM Sterling Connect:Direct for Windows 4.8
ContentsChapter 1. Connect:Direct for MicrosoftWindows Release Notes. . . . . . . . 1Requirements . . . . . . . . . . . . .Features and Enhancements . . . . . . . .Special Considerations . . . . . . . . . .Known Restrictions . . . . . . . . . . .Restrictions for Connect:Direct for MicrosoftWindows . . . . . . . . . . . . .Restrictions for Related Software. . . . . .Installation Notes . . . . . . . . . . . .Installation Notes for Sterling Connect:DirectRequester . . . . . . . . . . . . .Installation Notes for Connect:Direct File AgentSterling Connect:Direct Secure Plus for MicrosoftWindows . . . . . . . . . . . . .Upgrading Guidelines . . . . . . . . . .Upgrading Guidelines for Connect:Direct forMicrosoft Windows . . . . . . . . . .Upgrading Guidelines for Related Software . .1344. 4. 6. 7. 7. 7. 8. 8. 8. 9Chapter 2. Getting Started Guide . . . 11Prepare for the Installation of IBM SterlingConnect:Direct for Microsoft Windows . . . .Requirements for Copying Files To and FromNetwork Servers. . . . . . . . . . .Configure Microsoft Windows User Privileges .Customize a Sterling Connect:Direct LogonAccount . . . . . . . . . . . . .Configure TCP/IP Connectivity . . . . .Sterling Connect:Direct for Microsoft WindowsInstallation Worksheet . . . . . . . . .Install and Configure Database Software. . .Automate the Sterling Connect:Direct forMicrosoft Windows Installation . . . . . .Sample Sterling Connect:Direct for z/OSNetwork Map Entries . . . . . . . . .XCA Token Ring: Switched Net Definitions . .XCA Token Ring: Independent LU Definition .XCA Token Ring: Major Node Definition . .Sample Sterling Connect:Direct APPLDEF . .Sample Sterling Connect:Direct MODEENTS(Mode Definitions) . . . . . . . . . .Sample VTAM Start Options (ATCSTRxx) . .z/OS Network Map Example for VTAM. . .Microsoft Windows Network Map Example .Installing in a Windows clustered environment .Install Sterling Connect:Direct for MicrosoftWindows . . . . . . . . . . . . . .Installation Overview . . . . . . . . .Automate Installation . . . . . . . . . .About Silent Installations . . . . . . . .Customize Initialization Information for a SilentInstallation . . . . . . . . . . . .CD SRVR.INI Parameter Values . . . . . 11. 11. 11. 12. 13. 13. 14. 15.1516161818.1819202021.21213333. 34. 34Customize Sterling Connect:Direct for MicrosoftWindows Configuration Information . . . . . 38Run a Silent Installation . . . . . . . . . 38Perform an Unattended Uninstallation . . . . 39Chapter 3. System Guide . . . . . . . 41Configure the Local Node . . . . . . . . .Configuring the Sterling Connect:Direct LocalNode . . . . . . . . . . . . . . .Adding or Modifying a Local Node Definition .Adding a User . . . . . . . . . . . .Modifying a User ID . . . . . . . . . .Deleting a User . . . . . . . . . . . .Attaching to a Local Node . . . . . . . .About Local Functional Authorities . . . . .Define Remote User Proxies . . . . . . . .Creating or Modifying a Remote User Proxy . .Deleting a Remote User Proxy . . . . . . .Define and Manage the Sterling Connect:DirectNetwork . . . . . . . . . . . . . . .Define and Manage the Sterling Connect:DirectNetwork . . . . . . . . . . . . . .About Defining the Network Map . . . . . .Define Remote Node Information . . . . . .Creating or Modifying a Remote Node DefinitionCreating or Modifying a Communications PathDefinition . . . . . . . . . . . . . .Defining a New Mode for a CommunicationsPath . . . . . . . . . . . . . . . .Deleting a Network Map Entry . . . . . . .Validating a Network Map Entry . . . . . .Viewing a Network Map as Text . . . . . .Applying a Network Map . . . . . . . .Printing and Viewing Node and Network MapDefinitions. . . . . . . . . . . . . .View the Sample Configuration Files . . . . .Customizing Configuration Files . . . . . .Adding an Encrypted Password for a User ProxyValidating Configuration Files for Use withSterling Connect:Direct . . . . . . . . .Applying Updated Configuration Information . .Stop Sterling Connect:Direct for Microsoft WindowsStopping Sterling Connect:Direct for MicrosoftWindows . . . . . . . . . . . . . .Stopping Connect:Direct for Microsoft Windowsfrom Sterling Connect:Direct Requester . . . .Stopping Connect:Direct for Microsoft WindowsUsing the Services Facility . . . . . . . .Stopping Connect:Direct for Microsoft WindowsUsing the CLI . . . . . . . . . . . .Stopping Connect:Direct for Microsoft Windowsfrom the Admin Tool Utility . . . . . . . .Create a Process . . . . . . . . . . . . .About Processes . . . . . . . . . . . .Establishing Preferences . . . . . . . . 6666767686868696969707070iii
Creating a Process . . . . . . . . . . . 73Commands and Statements . . . . . . . . 74Process or Command Options . . . . . . . 80Setting Security Options . . . . . . . . . 80Setting Control Functions for a Command orProcess . . . . . . . . . . . . . . . 81Assigning Values to Symbolic Variables . . . . 82Specifying Accounting Data . . . . . . . . 83Add Comments . . . . . . . . . . . . 84Validating Process Content . . . . . . . . 84Saving a Process . . . . . . . . . . . . 85Copying a Process . . . . . . . . . . . 85Changing a Submitted Process . . . . . . . 85Manage Processes Using a Work List . . . . . 85Manage Processes . . . . . . . . . . . . 89SMTP Notification . . . . . . . . . . . 89Manage Processes . . . . . . . . . . . 89Understanding the TCQ . . . . . . . . . 90TCQ Logical Queues . . . . . . . . . . 90View Processes in the TCQ . . . . . . . . 93Creating a Process Monitor . . . . . . . . 93Monitoring Processes Based on Selection Criteria 93Opening a Process Monitor File . . . . . . 95Saving a Process Monitor . . . . . . . . . 95The Process Monitor Output. . . . . . . . 95Using the Output Display . . . . . . . . 97Notification . . . . . . . . . . . . . 97NT Broadcast . . . . . . . . . . . . . 97Changing Process Notification . . . . . . . 98View Process Statistics . . . . . . . . . . 98The Statistics Monitor Window . . . . . . . 99Delete Statistics Records . . . . . . . . . 100Control Statistics File Content . . . . . . . 100Creating a Statistics Report . . . . . . . . 100Selecting Statistics Based on Process Name orNumber . . . . . . . . . . . . . . 101Statistics Report Output . . . . . . . . . 103Understand the Microsoft Windows EventLogging Facility . . . . . . . . . . . 104Control Event Log Content . . . . . . . . 105Filter the Event Log . . . . . . . . . . 105Viewing Messages . . . . . . . . . . . 106Send Messages to an SNMP ManagementSystem . . . . . . . . . . . . . . 106Identify the Trap Variables . . . . . . . . 107Initialization Events . . . . . . . . . . 108Shutdown Events . . . . . . . . . . . 108API Events . . . . . . . . . . . . . 108Execution Events . . . . . . . . . . . 109Miscellaneous Events . . . . . . . . . . 109Use the Activity Log . . . . . . . . . . 110Opening an Activity Log . . . . . . . . 110Saving an Activity Log . . . . . . . . . 110Type Events . . . . . . . . . . . . . 110Manage a Sterling Connect:Direct Server . . . . 111Manage a Sterling Connect:Direct Server . . . 111Starting the Admin Tool Utility . . . . . . 111About the Toolbar . . . . . . . . . . . 111Starting and Stopping a Sterling Connect:DirectServer . . . . . . . . . . . . . . . 111ivIBM Sterling Connect:Direct for Windows 4.8Configuring a Sterling Connect:Direct SterlingConnect:Direct Server. . . . . . . . .Work with Active Directory. . . . . . .Adding an Active Directory Entry . . . .Deleting an Active Directory Entry . . . .Creating an Active Directory Report . . . .Troubleshoot Sterling Connect:Direct . . . .Diagnose a Server Problem Using Traces . .Defining a Trace . . . . . . . . . .Stopping a Trace . . . . . . . . . .Trace Startup Parameters . . . . . . .Recover from a Problem . . . . . . . .Process Step Restart . . . . . . . . .Automatic Session Retry. . . . . . . .Checkpoint/Restart . . . . . . . . .Restart During Run Task Operations . . .Troubleshoot Sterling Connect:Direct ProblemsWorksheets . . . . . . . . . . . . .Network Map Communications Mode ObjectWorksheet . . . . . . . . . . . .Network Map Communications Path ObjectWorksheet . . . . . . . . . . . .Network Map Remote Node Object WorksheetUser Functional Authorization Worksheet . .Remote User Proxy Worksheet. . . . . .Change Sterling Connect:Direct Settings . . .Change Sterling Connect:Direct for MicrosoftWindows Settings . . . . . . . . . .Sample Initialization Parameters Format . .Changing Initialization Parameters . . . .Specify an IP Address . . . . . . . . .Specify IP Addresses, Host Names, and PortsSubmit a Process Using the Command LineInterface . . . . . . . . . . . . . .Submit Processes Using the CLI Command .Creating a Configuration File to Connect to aServer . . . . . . . . . . . . . .Invoke the CLI . . . . . . . . . . .Terminating the CLI . . . . . . . . .CLI Commands . . . . . . . . . .Command Syntax . . . . . . . . . .Piping Conventions . . . . . . . . .Submit Process Command . . . . . . .Change Process Command . . . . . . .Delete Process Command . . . . . . .Select Process Command . . . . . . .Select Message Command . . . . . . .Select Statistics Command . . . . . . .Traceoff Command . . . . . . . . .Traceon Command . . . . . . . . .Help Command . . . . . . . . . .Stop Sterling Connect:Direct . . . . . .Modify Translation Tables . . . . . . . .Translation Tables . . . . . . . . . .Modify a Translation Table Using SterlingConnect:Direct Requester . . . . . . .Edit Connection Settings . . . . . . . .About the Client Connection Utility . . . .Start the Client Connection Utility . . . .Add a Node . . . . . . . . . . . .Deleting a Node . . . . . . . . . .112116116116117117117117118119121121121122122123. 123. 123. 124125. 126. 127. 128.128129131145145. 148. 75176176.176177177177178178
Adding a User with Client Connection UtilityDeleting a User with the Client ConnectionUtility . . . . . . . . . . . . . . .Updating a Node or User . . . . . . . .Defining a Default Node or User . . . . . .Importing Registry Settings. . . . . . . .Exporting Registry Settings . . . . . . . .Printing Registry Settings . . . . . . . .Use Sterling Connect:Direct for Microsoft Windowsin a Test Mode . . . . . . . . . . . . .Use Sterling Connect:Direct in Test Mode . . .Preparing the NDMPXTBL Parameter Table . .Sample Test Scenarios . . . . . . . . .Configure Certificate Authentication for Client APIConnections . . . . . . . . . . . . . .Local Impersonation . . . . . . . . . . .Managing no-password proxies for DomainAccounts . . . . . . . . . . . . . .Accessing shared network drive . . . . . ter 4. Using FASP with IBMAspera High-Speed Add-on forConnect:Direct for Microsoft Windows(V4.8.0 or later) . . . . . . . . . . 191Activating FASP . . . . . . . . . . . .Licensed bandwidth for FASP transactions . . .Using Connect:Direct for Microsoft Windows withIBM Aspera High-Speed Add-on and Secure Proxy .Configuring FASP . . . . . . . . . . . .FASP Process Language . . . . . . . . . .FASP Messages . . . . . . . . . . . . .Monitoring FASP transactions . . . . . . . .Known Limitations . . . . . . . . . . .191192192193197199200200Chapter 5. Secure Plus OptionImplementation Guide. . . . . . . . 203Overview. . . . . . . . . . . . . . .About Sterling Connect:Direct Secure Plus. . .Security Concepts . . . . . . . . . . .Sterling Connect:Direct Secure Plus Tools . . .Plan the Sterling Connect:Direct Secure PlusConfiguration . . . . . . . . . . . .Summary of Processing Using SterlingConnect:Direct Secure Plus . . . . . . . .IBM Connect:Direct Secure Plus for MicrosoftWindows Documentation . . . . . . . .Set Up Sterling Connect:Direct Secure Plus . . .Set Up Sterling Connect:Direct Secure Plus . .Start Secure Admin Tool . . . . . . . .Prepare to Set Up Sterling Connect:Direct SecurePlus . . . . . . . . . . . . . . . .Populate the Sterling Connect:Direct Secure PlusParameters File . . . . . . . . . . . .Configure Nodes . . . . . . . . . . . .Node Configuration Overview . . . . . .Import Existing Certificates. . . . . . . .Create CMS Key Store . . . . . . . . .Configure the Sterling Connect:Direct SecurePlus .Local Node Record . . . . . . . 15Configure Sterling Connect:Direct Secure PlusRemote Node Record . . . . . . . . . .Validate the Configuration . . . . . . . .Enable or Disable External Authentication for aRemote Node . . . . . . . . . . . .Configure External Authentication in the.SEAServer Record . . . . . . . . . .Automate Setup Using the CLI . . . . . . .Start and Set Up the Sterling Connect:DirectSecure Plus CLI . . . . . . . . . . .Use LCU Files to Encrypt Passwords for Usewith the Sterling Connect:Direct Secure Plus CLISample Scripts . . . . . . . . . . . .Manage the Parameters File . . . . . . .Manage CMS Keystore . . . . . . . . .Update the .Local Node Record . . . . . .Manage Remote Node Records . . . . . .Update the .Client Node Record . . . . . .Manage the External AuthenticationServerRecord . . . . . . . . . . . .Maintain the .Password File (Strong PasswordEncryption) . . . . . . . . . . . . .Maintain Sterling Connect:Direct Secure Plus . . .Sterling Connect:Direct Secure Plus Node ListView Sterling Connect:Direct Secure PlusParameters File Information . . . . . . .View Sterling Connect:Direct Secure Plus NodeRecord Change History . . . . . . . . .Disable Sterling Connect:Direct Secure Plus . .Delete a Sterling Connect:Direct Secure PlusRemote Node Record . . . . . . . . . .Resecure Sterling Connect:Direct Secure PlusParameters and Access Files . . . . . . .View Statistics . . . . . . . . . . . . .View Statistics . . . . . . . . . . . .Audits. . . . . . . . . . . . . . . .Sterling Connect:Direct Secure Plus ParametersFile Auditing . . . . . . . . . . . .Sterling Connect:Direct Secure Plus CertificateAuditing . . . . . . . . . . . . . .Troubleshoot Sterling Connect:Direct Secure PlusTroubleshooting . . . . . . . . . . .Configuration Worksheets . . . . . . . . .Local Node Security Feature DefinitionWorksheet . . . . . . . . . . . . .Remote Node Security Feature DefinitionWorksheet . . . . . . . . . . . . .Certificate File Layout . . . . . . . . . .Certificate File Layout . . . . . . . . .Validate the Configuration . . . . . . . . .Exchange Data and Verify Results . . . . . .Automation Scripts . . . . . . . . . . .Configure Sterling Connect:Direct Secure Plus toUse the SSL or TLS Protocol . . . . . . .Use LCU to Configure Encrypted Passwords . . .Configure Encrypted Passwords Using the LCUCreate an LCU File . . . . . . . . . .Chapter 6. SDK Programmers 1244244244245245246246246246249249251253. 253Contentsv
Connect:Direct for Microsoft Windows SDKOverview. . . . . . . . . . . . .Edit Connection Settings . . . . . . . .Edit Connection Settings with the ClientConnection Utility . . . . . . . . . .Start the Client Connection Utility . . . .Add and Delete Node Connection DefinitionsAdd a Node . . . . . . . . . . . .Delete a Node . . . . . . . . . . .Add a User . . . . . . . . . . . .Delete a User . . . . . . . . . . .Update Node Properties . . . . . . . .Define a Default Node or Default User . . .Import Registry Settings . . . . . . . .Export Registry Settings . . . . . . . .Print Registry Settings Report . . . . . .Apply the C API . . . . . . . . . . .The C Applications Programming Interface .Compile and Debug . . . . . . . . .Activate Tracing . . . . . . . . . .Standard C API . . . . . . . . . .View Sample Programs . . . . . . . .Apply the C Class Interface. . . . . . .Compile and Debug . . . . . . . . .Manipulate Nodes. . . . . . . . . .Create an Object to Connect to a Node . . .Manage Connections . . . . . . . . .View Information . . . . . . . . . .Control the Return of Information . . . .Execute Sterling Connect:Direct Commands .Manage Exception Conditions . . . . . .Manage Administrative Functions . . . .Multithreaded Access and Blocking . . . .Objects On The Stack . . . . . . . . .Apply the ActiveX Control Interface . . . . .Submit Process . . . . . . . . . . .Display Select Statistics Results . . . . .Apply Automation Servers . . . . . . . .Apply Automation Servers . . . . . . .Create Virtual Servers Using the Node FactoryUse Automation Objects . . . . . . . .viIBM Sterling Connect:Direct for Windows 4.8. 253. 255. 255. 255256. 256. 257. 257. 258. 258. 259. 259. 260. 260. 260. 260. 261. 261. 261. 263. 263. 263. 264. 265. 266. 266. 267. 268. 269. 270. 272. 272. 273. 273. 274. 280. 280281. 284Enhance Security and Automate File Opening withUser Exits . . . . . . . . . . . . . .User Exits . . . . . . . . . . . . .Apply Enhanced Security . . . . . . . .Apply Automated File Opening . . . . . .Structure Types. . . . . . . . . . . . .Structure Types. . . . . . . . . . . .NETMAP DESC STRUCT Structure . . . . .USER STRUCT Structure . . . . . . . .MESSAGE STRUCT Structure . . . . . . .NETMAP MODE SNA Structure . . . . . .NETMAP MODE TCP Structure . . . . . .NETMAP NODE STRUCT Structure . . . .NETMAP PATH STRUCT Structure. . . . .PROCESS STRUCT Structure . . . . . . .NODE STRUCT Structure . . . . . . . .STATISTICS STRUCT Structure . . . . . .TRACE STRUCT Structure . . . . . . . .TRANSLATE STRUCT Structure . . . . . .Return Codes . . . . . . . . . . . . .C Class and the C API Functions ReturnCodes . . . . . . . . . . . . . . 00301302302Chapter 7. .Net SDK User Guide . . . 305Connect:Direct for Microsoft Windows .NetOverview. . . . . . . . . . . .Sample Programs . . . . . . . . .Add the .Net Class Interface . . . . .About Classes . . . . . . . . . .Connect to a Connect:Direct for MicrosoftWindows Node. . . . . . . . . .Disconnect Nodes . . . . . . . . .Submit Processes . . . . . . . . .Manage Processes . . . . . . . . .Retrieve Statistics . . . . . . . . .Node Properties . . . . . . . . .Process Class . . . . . . . . . .Process Properties . . . . . . . . .Statistic Class . . . . . . . . . .Statistic Properties . . . . . . . . .SDK. . . . .305305306306.306307307307309309309310311311
Chapter 1. Connect:Direct for Microsoft Windows ReleaseNotesThe IBM Sterling Connect:Direct for Microsoft Windows Version 4.8 ReleaseNotes document supplements Connect:Direct for Microsoft Windows version 4.8documentation and the documentation for the following Connect:Direct forMicrosoft Windows related software: IBM Sterling Connect:Direct Requester, IBMConnect:Direct File Agent, and IBM Connect:Direct Secure Plus for MicrosoftWindows. Release notes are updated with each release of the product and containlast-minute changes and product requirements. Read the document beforeinstallation.RequirementsConnect:Direct for Microsoft Windows Sterling Connect:Direct for MicrosoftWindows has the following requirements.Hardware and SoftwareConnect:Direct for Microsoft Windows and related software require the followinghardware and software.ComponentHardwareSoftwareConnect:Direct forMicrosoft Windowsv 512 MB RAM (min.) 1GB or morerecommendedMicrosoft Windows operating systemoptions:v 200 MB disk spacev Microsoft Windows Server 2016 withDesktop Experience (Fix Pack 5 orlater)v Microsoft Windows Server 2012 R2v Microsoft Windows Server 2012v Microsoft Windows 10 ( Fix Pack 3 orlater)v Microsoft Windows 8v Virtualization software—All of theabove options running under VMwareInfrastructure 3 (VMware ESX server)v Clustered environment supported on:– Microsoft Windows 2012 ServerMicrosoft TCP/IPSupportToken ring or ethernetinterface cardMicrosoft TCP/IP WinSOCK interfaceinstalled as part of the MicrosoftWindows system1
ComponentHardwareSoftwareDatabase Software2 GB or more. Theamount may varydepending on the productconfiguration and usage.Install one of the following before youinstall Connect:Direct for MicrosoftWindows:Note: PostgreSQL is the default databaseprovided and installed with SterlingConnect:Direct for Microsoft Windowsrelease 4.8v Microsoft SQL Server 2016, 2014 (FixPack 3 or later), and 2012—Thissoftware is not provided. You canconfigure SQL Server during theSterling Connect:Direct installation.Note: Local-domain access must beavailable to Microsoft SQL Server.For more information, see the IBMSterling Connect:Direct for MicrosoftWindows Getting Started Guide.Connect:Direct FileAgentSame as requirements forConnect:Direct forMicrosoft WindowsSame requirements as Connect:Direct forMicrosoft WindowsSterlingConnect:DirectRequesterSame as requirements forConnect:Direct forMicrosoft WindowsSame requirements as Connect:Direct forMicrosoft WindowsConnect:Direct forMicrosoft WindowsSDKSame as requirements forConnect:Direct forMicrosoft WindowsThis software is required to build thesamples, but is not required to run thesamples.Virtualization supportIBM cannot maintain all possible combinations of virtualized platforms. However,IBM generally supports all enterprise class virtualization mechanisms, such asVMware ESX, VMware ESXi, VMware vSphere, Citrix Xen Hypervisor, KVM(Kernel-based virtual machine), and Microsoft Hyper-V Server.IBM investigates and troubleshoots a problem until it is determined that theproblem is due to virtualization. The following guidelines apply:v If a specific issue is happening because the system is virtualized and theproblem cannot be reproduced on the non-virtualized environment, you candemonstrate the issue in a live meeting session. IBM can also require that furthertroubleshooting is done jointly on your test environment, as there is not all typesand versions of VM software installed in-house.v If the issue is not able to be reproduced in-house on a non-virtualizedenvironment, and troubleshooting together on your environment indicates thatthe issue is with the VM software itself, you can open a support ticket with theVM software provider. IBM is happy to meet with the provider and you to shareany information, which would help the provider further troubleshoot the issueon your behalf.v If you chose to use virtualization, you must balance the virtualization benefitsagainst its performance impacts. IBM does not provide advice that regardsconfiguring, administering, or tuning virtualization platforms.2IBM Sterling Connect:Direct for Windows 4.8
Features and EnhancementsConnect:Direct for Microsoft Windows version 4.8 and its related software have thefollowing features and enhancements:Fix Pack 3 (V4.8.0.3)New Features and EnhancementsTo install this software, you should go to the Fix Central website, and follow instructionsdescribed in sections given below to install the latest available fix pack:v Attended installation for Connect:Direct for Windowsv “About Silent Installations” on page 33With this fix pack Connect:Direct for Microsoft Windows introduces support for licensegovernance, remote maintenance application, and upgrades by Control Center Director. Forrelated document see, “IBM Control Center Director Support” on page 30.Fix Pack 2 (V4.8.0.2)Added support for Local ImpersonationWith this fix pack, Connect:Direct for Microsoft Windows extends support for LocalImpersonation feature. For more information see, “Local Impersonation” on page 187.Connect:Direct for Windows can now be configured to eliminate the need to storepassword in the following two contexts:v Secondary Node Proxying that is, a Local User in a Proxy recordv Submitting a process through an API that is, Application Interface for Java (AIJ)-basedprograms that interact with Connect:Direct through its API that submit Connect:DirectProcessesWhen running the Connect:Direct service under a Windows domain account, proxies thatmap to a domain account no longer require a password to perform user impersonation. Formore information on how to configure the service account see, “Managing no-passwordproxies for Domain Accounts” on page 187.When submitting a process through the API use certificate-based authentication toeliminate the need to store passwords. For more information see, “Configure CertificateAuthentication for Client API Connections” on page 186.Fix Pack 1 (V4.8.0.1)New Features and Enhancementsv Added support for 'Operator' user local functional authority type. Local functionalauthority type template is now updated to include a new Operator user type. AnOperator user has Read-only permissions to view configuration files and monitor filetransfers but not modify, delete or submit a process. For more information see, “AboutLocal Functional Authorities” on page 43.Note: To support this functionality both, Sterling Connect:Direct Requester andConnect:Direct for Microsoft Windows server must be upgraded to iFix pack v4.8.0.1v Removed dependencies on Microsoft Visual C 2008 runtime libraries.Base Release (V4.8.0)Chapter 1. Release Notes3
New Features and Enhancementsv Support for PostgreSQL database is added in this release. Support for SolidDb has beenremoved. Current C:D Windows installations configured with SolidDb will be migratedto use PostgreSQL.v The Connect Direct Windows software is now digitally signed with a certificate toconfirm the software author which guarantees that the software has not been alteredsince it was signed.Features removed from this releasev Support for solidDb database has been removed. Current C:D Windowsinstallations configured with solidDb will be migrated to use PostgreSQL.v Support for SNA has been removed.Note: Default installation folder has changed:On 32-bit OS: C:\Program Files\IBM\Connect Direct v4.8.0On 64-bit OS: C:\Program Files (x86)\IBM\Connect Direct v4.8.0Special ConsiderationsThis section details special considerations to be aware of for your platform.v Certain maintenance fixes should be applied to Sterling Connect:Direct for z/OSto have the correct TLS protocol negotiation with Connect:Direct for MicrosoftWindows 4.8. It is suggested the you upgrade Sterling Connect:Direct for z/OSwith these four HIPER fixes: UI14876, UI14924, UI16043, UI16936. For additionalinformation, see search?domain psp and search for the FMID for CDZ/5.3 (HDGA520) and selectUpgrade STRCD520, Subset HDGA520 , then select Service Recommendations forthe most current list of HIPER fixes.v The database retry feature retries a connection for up to eight minutes before afailure is allowed to continue. When you use client applications like SterlingConnect:Direct Requester, the application may appear to quit working. If thisoccurs, check the event log for database errors indicating a retry is in progress. Ifthe retry is unsuccessful, you may need to recycle the Connect:Direct forMicrosoft Windows server.v PostgreSQL– If you do not install PostgreSQL as your database and would like to install itat a later time, re-run setup.exe. You can also install the PostgreSQL feature.v The use of solidDB database is deprecated.Known RestrictionsConnect:Direct for Microsoft Windows and its related software have the followingknown restrictions.Restrictions for Connect:Direct for Microsoft WindowsConnect:Direct for Microsoft Windows version 4.8 has the following restrictions:v Secure ParmFiles encrypted with IDEA is not upgradeable. Impacted versionsinclude, Connect:Direct for Windows 4.2.00v Changes to the SPCli will break customer scripts.v There is no GUI support for creating ECDSA signed certificates.4IBM Sterling Connect:Direct for Windows 4.8
v You can keep an earlier version of Connect:Direct for Microsoft Windows on thecomputer on which you are installing Connect:Direct for Microsoft Windowsversion 4.8.v Connect:Direct for Microsoft Windows version 4.8 SNMP and NT Broadcast donot send messages on 64-bit operating systems.v Built-in variables should only be specified in a SUBMIT statement within aProcess if the statement will be executed on a Connect:Direct for MicrosoftWindows version 4.6 (or later) node or another Sterling Connect:Direct versionthat supports built-in variables.v Temporary addresses, which are a security feature of the IPv6 protocol, aregenerated automatically by the operating system and are used only foroutbound connections. These addresses have a short life span and are replacedby other temporary outbound addresses. This feature of the IPv6 protocol causesproblems with Netmap Checking. If the outgoing address of the PNODErandomly changes and netmap checking is enabled by the SNODE, the SNODEalways refuses the connection because the IP address of the PNODE nevermatches the IP address configured for it.You can work around the problem created by temporary addresses in two ways:– On the PNODE, configure outgoing.address in the initialization parametersfile using the IPv6 address for the PNODE server. This ensures that the IPaddress that the PNODE uses to create a connection to a remote node isalways constant. Consider the following:- If a PNODE has several IP addresses configured, for example, two IPv6addresses and two IPv4 addresses, configure the outgoing.addressinitialization parameter with one IPv6 address. This address can then beused to connect to an SNODE configured with either IPv6 or IPv4addresses.- If a PNODE wants to use an IPv4 address to connect to an SNODE that hasboth IPv6 and IPv4 IP addresses, ensure that the tcp.api.port andtcp.host.port initialization parameters of the SNODE are configured withan IPv4 address and port.– Disable temporary addresses for the PNODE. This is a configuration option inthe Windows networking component. If the temporary addresses are notgenerated, connections to a remote that use the IPv6 protocol use theconfigured IPv6 address.Note: To disable temporary addresses in the Windows Vista OS, issue thefollowing command from a command prompt: netsh int
Installation Notes for Sterling Connect:Dir ect Requester . . 7 Installation Notes for Connect:Dir ect File Agent . 7 Sterling Connect:Dir ect Secur e Plus for Micr osoft W indows . . 8 Upgrading Guidelines . . 8 Upgrading Guidelines for Connect:Dir ect for Micr osoft W indows . . 8
