Rally: Troubleshooting "connection refused" issues or general network issues when connecting to Rally
search cancel

Rally: Troubleshooting "connection refused" issues or general network issues when connecting to Rally


Article ID: 137317


Updated On:


Rally On-Premise Rally SaaS


User was seeing this error:

Release: ERROR : java.lang.Exception: org.apache.http.conn.HttpHostConnectException: Connection to https://rally1.rallydev.com refused



The examples in this article can be used to make quick get requests to verify connectivity using a command line.   This will take the product out of the equation to see if there is an issue in the system.

The examples can also be used to confirm if valid credentials are used in a custom code. For example, if a java or c# code returns 401, a quick WS API request using curl or a browser REST client may confirm if the issue is related to credentials or the code.

The article assumes that a user generated an API Key following steps outlined in CA Agile Central Application Manager documentation.

The article considers both APIKey and username/password authentication scenarios.

1.  Use curl to see if you are able to reach Rally from the command line.  Possible proxy issues or firewall issues.

I will post a curl using the APIkey and a curl using username/password.  Please use whichever command is easiest for you.  If you are using Windows and do not currently have curl installed, here is a link for curl: https://curl.haxx.se/download.html.  It will be necessary to replace the example Workspace OID (<WORKSPACE_OID>) in the curl command to the workspace OID the application is using.  Here is an article on how to find your workspace OID:  https://ca-broadcom.wolkenservicedesk.com/external/article?articleId=47763

GET request with curl using ApiKey

Use ApiKey to set zsessionid as shown below.  the "zsessionid:<API Key - include the underscore before the key>" will be replaced with the apikey being used in the application receiving the error:

curl --header "zsessionid:<API Key - include the underscore before the key>" -H "Content-Type: application/json" https://rally1.rallydev.com/slm/webservice/v2.0/hierarchicalrequirement?workspace=workspace/<WORKSPACE_OID>


A GET request with curl using basic authentication (username:password)

curl -u <User>@<Company.com>:zsessionid:<API Key - include the underscore before the key>' -H "Content-Type: application/json" https://rally1.rallydev.com/slm/webservice/v2.0/hierarchicalrequirement?workspace=workspace/<WORKSPACE_OID>

2.  Ping Rally - run the following command in a command-line window on the machine that runs the app having the issue.  Issues here may point to a DNS issue.

ping rally1.rallydev.com