IBM Sterling Transformation Extender

Sterling Transformation Extender

Come for answers, stay for best practices. All we're missing is you.


#Sterling
#Supplychain
 View Only
  • 1.  Unable to shutdown the launcher - what could be the reason?

    Posted 12/26/25 02:28 AM

    Hi,

    Sometimes when I try to shut down the launcher, I get the following error:

    Attempting to shut down launcher on port 5015 ...
    Failed to correctly shutdown launcher listening on port 5015.
    Running system possibly in a bad state.

    What could be the possible causes of this, and what can we do to resolve it?

    Also, should I delete all tmp workfiles and logs as part of the recovery steps?

    Thanks.



    ------------------------------
    NeverXP YANG
    ------------------------------


  • 2.  RE: Unable to shutdown the launcher - what could be the reason?

    Posted 12/31/25 02:12 PM

    Could be lots of reasons really and without knowing your system will be hard to diagnose without more information.  Some of my questions would be:

    1. Are you windows, linux, unix environment?  I *think* from previous posts you are running Linux?  I will answer further from that perspective...
    2. How are you trying to shut down the launcher? 
      • Are you trying to execute the command under the same account the launcher is running under by doing an su to the launcher account?
      • Are you at the command line and not in a shell such as Midnight Commander (I learned this one the hard way)
      • have you issued a pause command prior to asking it to stop? (best practice)
      • have you checked for run away jobs after issuing stop and checked why they aren't stopping?  You may have to use the kill command to terminate that running process and try again.  If it is always the same job then you need to trouble shoot the process that isn't allowing it to shutdown.

    Additionally - google AI had these suggestions from the following search prompt (so you can repeat and see documentation links) "itx launcher hung and won't respond to pause command":

            "When your ITX Launcher hangs and ignores pause commands, it's often due to connectivity loss with monitored systems, permission issues in the temp directory, or an internal hung process needing a hard kill, requiring you to manually kill the process (Task Manager on Windows, kill -9 <pid> on Linux) and potentially debug with IBM support by collecting core dumps for analysis. Check for related error logs, ensure correct permissions, and use command-line tools for proper shutdown if possible. 
    Immediate Actions (To regain control)
      1. Windows: Open Task Manager (Ctrl+Shift+Esc), find the ITX Launcher process, right-click, and select "End task".
      2. Linux/UNIX: Use kill -9 <ProcessID> (e.g., kill -9 12345) to force termination, but first try kill -6 <ProcessID> to generate a core dump for IBM support if possible. 
    Common Causes & Solutions
      • Lost Connection: The Launcher might appear hung if it loses connection to a remote system it's "watching" (like an NFS share or database).
      • Permissions: A crash or hang can occur if the ITX temporary directory lacks write permissions, showing errors like "System <SystemName.msl> has stopped with result 190".
      • Internal Hung Process: Sometimes an internal error or a blocked communication task (like a multi-line WTO on z/OS) freezes the console/launcher. 
    Next Steps (For diagnosing the root cause)
      • Check Logs: Look at the Launcher logs and system logs for specific error messages or signs of connectivity failure.
      • IBM Support: For persistent issues, use the dtx_ui.sh script (or similar provided tools) to gather diagnostic information and contact IBM support.
      • Verify Environments: Confirm that the server, platform, and deployment settings match what's configured in Design Studio."

    Hope this helps!



    ------------------------------
    Lisa Edwards
    Software Engineer / Subject Matter Expert
    Rainbow Data Systems, Inc
    ------------------------------



  • 3.  RE: Unable to shutdown the launcher - what could be the reason?

    Posted 01/01/26 11:20 AM
    I am on Linux side, and in some instances I have had to delete this file in the main install dir
    Eventserver.5015 

    And the cleanup the hidden files that get created there for each launcher(.*PID)

    Hope this helps

    Thanks,
    Attila





  • 4.  RE: Unable to shutdown the launcher - what could be the reason?

    Posted 01/12/26 08:55 PM

    Yes. I am running on AIX/Unix.



    ------------------------------
    NeverXP YANG
    ------------------------------