How i can start JIRA in debug mode on docker container

Question

Hello guys,

I'm trying to debug a plugin I've developed, I have Jira installed on my docker container  I already did some researchers and what I found out that I have first to   enter my docker container using docker exec -it <docker container name>  bash

-  I had to locate my Jira bin folder which was  in  /opt/atlassian/jira/bin

- then I had to modify startup.sh by adding  jpda to the following line exec "$PRGDIR"/"$EXECUTABLE" jpda start "$@"

- after that, I had to modify the setenv.sh script by adding the following  line :

${JVM_SUPPORT_RECOMMENDED_ARGS:="-agentlib:jdwp=transport=dt_socket,server=y,s
uspend=n,address=*:8000"}

and when I am trying to connect it using my IDEA which is IntelliJ  it shows

Unable to open debugger port (lcoalhost:8000):java.net.ConnectException "Connection refused (Connection refused)"

worthy of thanks

Dave Chevell · Answer

Hey @Abdulrahman Aldakak

A couple of things:

First, it's worth noting that if you're using one of our official Jira docker images, e.g. atlassian/jira-software, you can specify JVM_SUPPORT_RECOMMENDED_ARGS as an environment variable to the container:

docker run -d \
    --name jira \
    -p 8080:8080 \
    -p 8000:8000 \
    -e JVM_SUPPORT_RECOMMENDED_ARGS="-agentlib:jdwp=transport=dt_socket,server=y,s
uspend=n,address=*:8000" \
    atlassian/jira-software:latest

This is the recommended method of supplying this and other configuration - the full details on available configuration options can be found on https://hub.docker.com/r/atlassian/jira-software

As for your issue, the error you received made it sound like the port you were trying to connect to wasn't connectable - in the case of Docker, it may not have been published. Going back to my example above, you can see that as part of my docker run command I'm publishing both Jira's port of 8080 as well as the jdwp port of 8000

My first suggestion would be to ensure this port is actually being published and is connectable from your host machine. e.g. telnet localhost 8000 or something similar.

Cheers

Dave

Andy Heinzer · Answer

Hi Abdulrahman,

I see that you're trying to start Jira in the docker container so that you can connect it with IntelliJ, but so far you have been unable to do so.

From looking at your error message,

Unable to open debugger port (lcoalhost:8000):java.net.ConnectException "Connection refused (Connection refused)"

It looks like it might just be a typo of localhost that could cause this problem.  Your error message makes it look like your connection is trying to reach a host called lcoalhost instead of localhost.   Try adjusting that address first to see if that helps.  From here it looks like that is the most common cause, but I'm not sure if you just did a copy and paste of that error, or if perhaps the actual error doesn't have the typo.

If that doesn't help, then try using the actual IP address instead, such as the private address or something like 127.0.0.1.  And in turn, if that doesn't help fix this then, I think the next steps I'd try would be to try to determine if perhaps this docker instance has its own network address that is being bridged somehow to your host machine.

Perhaps a command such as

netstat -a | grep 8000

Could help show you what entries of your system are using or listening on port 8000.  For course this is for a linux/unix based system.

Try this and let me know if this helps.

Andy