Chapter 7. Troubleshooting

If your Windows username includes a space, an error appears:

+ image::space_error.png[Error due to Space in Installation Path for Vagrant]

+ To resolve the issue: . In the Control Panel, type Environment variables in the search box and click on the Environment Variable option in the search results. . In the User variables for $YourUsername section, select New…​ . Create a new variable with the name VAGRANT_HOME and set the value to a valid path. . Click OK to exit the Environment Variables options and restart the installer.

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.

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.

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

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.

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

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.

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.