Debugging an AppNode

A running AppNode can be enabled for remote debugging from either bwadmin or the Admin UI. Once enabled, use TIBCO Business Studio™ for BusinessWorks™ to debug the application running on the AppNode. For more information, see "Remote Debugging" in the TIBCO ActiveMatrix BusinessWorks™ Application Development guide. An Appnode should be enabled for remote debugging in secure environments where only an administrator has the access rights to enable or disable ports.

bwadmin Command Line

The enabledebugport command can only be executed against a running AppNode. It should be issued from bwadmin interactive mode, not from the command line.

Procedure

  1. In a terminal, navigate to BW_HOME\bin and type bwadmin.
  2. Go to MyDomain. 
    bwadmin[admin]> cd MyDomain
  3. Go to MyAppSpace. 
    bwadmin[admin@MyDomain]> cd MyAppSpace
  4. Start the AppNode, if it is not already running: 
    bwamdin[admin@MyDomain/MyAppSpace]> start appnode MyAppNode
  5. Run the enabledebugport command, passing the host and port number. For example: 
    bwamdin[admin@MyDomain/MyAppSpace]> enabledebugport -n MyAppNode JSMITH-W520 9061
Enabled debug port on AppNode [MyAppNode] in AppSpace [MyAppSpace] in Domain [MyDomain]
  6. Important: When you finish debugging, close the port to reduce security risks and reduce overhead. For example: 
    bwamdin[admin@MyDomain/MyAppSpace]> disabledebugport -n MyAppNode
Debugger disabled for AppNode [MyAppNode] in AppSpace [MyAppSpace] in Domain [MyDomain]

Admin UI

Procedure

  1. Open the AppNode page for the AppNode to enable for remote debugging.

  2. Click the Remote Debugging > ON option. The Enable Remote Debugging dialog box is displayed.

  3. Enter the following information, and click Submit to open the port.
    • Connection Interface: The default connection interface is the name of the bwagent.
    • Connection Port: The debug port.

    The port is opened and displayed on the AppNode page:

  4. When you finish debugging, close the port by clicking OFF to reduce security risks and reduce overhead.