Red Hat Training

A Red Hat training course is available for Red Hat Development Suite

Chapter 8. Troubleshooting

To troubleshoot a general installation failure, see the contents of the installer.log file. The installer log file is automatically created in the installation target directory. Depending on when the installation failed, the directory can contain additional log files for Vagrant and VirtualBox.

8.1. Cygwin Detection Issue

When detecting components, Red Hat Development Suite assumes that the cygwin/bin folder is added to the PATH environment variable. The Cygwin detection process determines whether Cygwin and its dependencies, OpenSSH and rsync, are installed because Red Hat Container Development Kit requires OpenSSH for ssh-fs and Red Hat JBoss Developer Studio’s oc rsync uses rsync.

If Red Hat Development Suite detects Cygwin, OpenSSH, and rsync, the Cygwin component is marked as detected and skipped during installation. Manually select Cygwin to override this and reinstall all three components, if required. If any of the three components are not found, Cygwin and the two dependencies are installed.

8.2. Terms and Conditions Error

Error: “Terms and Conditions for CDK have not been signed” This error appears on the Log In page when installing Red Hat Development Suite. The workaround for this issue is to log into http://developers.redhat.com and download Red Hat Container Development Kit. This triggers all the required Terms and Conditions approvals (if any are needed).

If you do not have a Red Hat account, create a new account at http://developers.redhat.com/. After signing up for a Red Hat Developers account, you must wait approximately fifteen minutes to allow the new account information to propagate to the Red Hat Subscription Management system.

8.3. BrowserSim Does Not Work After Installing Red Hat Development Suite

Red Hat JBoss Developer Studio installs OpenJDK 8. BrowserSim requires JavaFX which is not yet available in OpenJDK. As a result, when Red Hat JBoss Developer Studio is used, BrowserSim does not work. As a workaround for this issue, Red Hat recommends installing and using Oracle Java for BrowserSim instead. For further information, see http://tools.jboss.org/documentation/faq/browsersim.html#general-browsersim

8.4. OpenShift Console Inaccessible on Microsoft Edge Browser

The OpenShift Console web address does not work on Microsoft’s Edge Browser. This is a known issue, and the only workaround is to use a different browser to access the console.

8.5. Red Hat Development Suite Installer behind a Proxy Server

Red Hat Development Suite Installer can work behind a proxy server by defining environment variables in the following ways:

  • For none authentication proxy server, set HTTPS_PROXY to http(s)://proxyhost:port
  • For authentication proxy server, set HTTPS_PROXY to http(s)://username:password@proxyhost:port

If your username or password has the character @ in it, replace @ with %40. For example, http(s)://usern@me:p@ssword@192.168.0.47:3128 will change to http(s)://usern%40me:p%40ssword@192.168.0.47:3128.

8.6. Reporting an Issue

If you encounter issues other than the ones listed in this section, log an issue at https://issues.jboss.org/projects/JBDS/summary under the Installer component in the Red Hat JBoss Developer Studio (devstudio) project.