Troubleshooter

How do I know that the XRebel Hub agent has started?

When launching an application with an XRebel Hub agent (using the -javaagent parameter), you will see this banner in the console log:

XRebel Hub: ########################################################
XRebel Hub:
XRebel Hub:  XRebel Hub Agent
XRebel Hub:  � Copyright ZeroTurnaround AS, Estonia, Tallinn.
XRebel Hub:
XRebel Hub: ########################################################

When the banner does not show up, check your application startup parameters.


XRebel Hub agent cannot get past my proxy!

When using proxy for your application servers, make sure that XRebel Hub agent is allowed to go through those proxies. You can do this by providing the following JVM startup parameters:

-Dhttps.proxyHost=10.20.30.400 -Dhttps.proxyPort=1234

When using an authenticated proxy, you can provide the credentials as follows:

-Dhttps.proxyUser=username -Dhttps.proxyPassword=password

XRebel Hub agent cannot get through my firewalls!

Whitelist the relevant XRebel Hub domains in your firewalls:

  • hub.xrebel.com
  • s3.amazonaws.com

When the firewall does not allow domain name level setup, you need to determine the specific IP addresses and ranges to be added to the whitelist. To do this, you need to:

  1. Locate the IP addresses for s3.amazonaws.com and hub.xrebel.com. Use the nslookup command line tool to determine the IP address: $ nslookup s3.amazonaws.com and $ nslookup hub.xrebel.com.
  2. Determine the NetRange and CIDR values for the s3.amazonaws.com and hub.xrebel.com IPs. Use the whois command line tool: $ whois s3.amazonaws.com and $ whois hub.xrebel.com. You can also refer to any external whois tool.
  3. Add the IP range exceptions (NetRange and CIDR) to the upstream firewall.