Version 16

    Debugging bind exceptions


    BindExceptions indicate another process already has the interface/port combination jboss is trying to use in use. This example shows that naming service 1098 port is already in use.

    20:54:40,859 WARN  [ServiceController] Problem starting service jboss:service=Naming
    java.rmi.server.ExportException: Port already in use: 1098; nested exception is: 
   Address already in use
            at sun.rmi.transport.tcp.TCPTransport.listen(
            at sun.rmi.transport.tcp.TCPTransport.exportObject(
            at sun.rmi.transport.tcp.TCPEndpoint.exportObject(
            at sun.rmi.transport.LiveRef.exportObject(


    Note: this can occur on Windows machines as prior to Windows Vista/2008 Server the IANA standards were not adhered to. Windows can grab ports between 1025 and 5000 for it's own use - see


    Finding the process using the port/address on Win32

    Use the TCPView utility from sysinternals to list the process port usage:


    The netstat command on WindowsXP, Server2003+ also support a -o option which displays the owning process ID associated with each connection.


    Reserving Ports on Win32

    You can reserve a range of ephemeral ports so that only processes that

    specifically request a port in the reserved range can use it. Ephemeral (short-lived) port numbers start at 1024. To reserve one or more ranges of ephemeral ports:


    1. Use Regedt32.exe to navigate to: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

    2. On the Edit menu, Add Value name ReservedPorts as a REG_MULTI_SZ Data Type.

    3. For each range that you wish to add, type a line in the Multi-String Editor dialog, using the FFFF-TTTT syntax, where FFFF is the starting port of the range and TTTT is the ending port of the range. If only one port exists in the range, FFFF and TTTT are identical.


    See MSKB 812873 for more information.


    See UsingJBossBehindAFirewall for the typical ports jboss uses. A range of 1098-8093 certainly covers the default port usage for jboss.


    Finding the process using the port/address on nix

    On linux you can use netstat with the -p argument or the lsof tool to find the process using the port in question.


    Reserving Ports on nix

    You can assign ports to applications that request random ports. This can be done by assigning explicit port numbers in /etc/services to those applications that request random ports. This way random port allocations can be avoided and the ports needed by JBoss instances can be freed.


    Referenced by: