In the event that a student in your class experiences connectivity issues, you can run a test from the instructor console to get some information about the student's connectivity and see how to help improve the student's experience using their CloudShare environment.
The test gives you basic results at a glance, and you can optionally open a detailed results window per student.
It's so quick and easy to run the test that you might want to run it periodically for all of your students, just to make sure everyone is enjoying an optimal experience.
From the instructor console, in the Students section of the action panel, select the students whose connectivity you want to test. (Click All to select all the students.)
Click the button and select Test Connectivity.
In the Run Speed Tests confirmation box, click Test Connectivity to confirm you want to go ahead.
The test runs for the students you selected. When done, each student's test indicator icon changes color to indicate a test result status.
To see a basic description of the test result:
Hover over the color coded connectivity test indicator icon for each student (). A tooltip gives you a basic summarized result.
Each student's indicator icon may appear in any of the following colors:
. All WebSockets tests passed. The Speed test revealed a fast connection.
. Some tests timed out, or the student was not logged in or speed tests reveal a slow connection. If spinning, some tests are still running.
. Some WebSockets tests failed or some speed tests failed to run. If spinning, some tests are still running.
. No tests were run, or you cleared the test results.
To see detailed results for a specific student:
Click the student's connectivity test indicator icon.
The results appear:
The following results are displayed:
This section displays information retrieved from the student's browser, such as the browser version and the CloudShare region that is serving the student's environment.
The student's browser needs to support WebSockets in order to connect to the VMs in the student's environment. Several tests of WebSockets support are run so that we can pinpoint any specific problem the student's browser may be having with WebSockets:
WebSockets browser support. This tests whether the browser supports WebSockets. If it doesn't, the student needs a browser update or to use a different browser. If this test fails, the other tests don't run.
WebSockets echo server test. Attempts to connect to the echo.websocket.org WebSockets server in order to test if the browser can establish a secure WebSocket connection to a WebSockets server external to CloudShare.
Certificate authority check. Checks if the browser is missing certificate authority trusts. A WebSocket connection to CloudShare's remote access gateway will fail if the websocket server's TLS certificate is not trusted by the browser.
WebSockets gateway server test. Tests if the browser can establish a secure WebSocket connection to CloudShare's remote access gateway in the CloudShare region where the environment is hosted.
The results of several websockets tests are displayed clearly, followed by a helpful explanation and recommended actions. Follow our guidance to instruct your student how to fix connection problems.
The speed tests section displays the latency, which is the time taken for data to travel between CloudShare's remote access gateway and your student's browser. It is measured in milliseconds (ms) with a percentage error in parentheses.
If the latency is very high, a recommendation is displayed that may help you work with the student to improve the student's experience. Note that the student can run their own speed test from their environment viewer, and then use a slider in their test result window to adjust resolution and improve browser performance. See Test Your Connectivity to VMs for details.
Clearing the test results restores students' connectivity test indicators to the default state as they appear when no test has been run.