Accessing VMs with your browser

The Secure Remote Access (SRA) browser client is the quickest and easiest way to access and use a VM.

Notes:
  • SRA access may be disabled by your administrator.
  • SRA access may be blocked in Microsoft Azure regions if IP-based access is enabled. For additional details, see Setting access policies.

To open the SRA browser client, click on the picture of the VM displayed on your environment or sharing portal page. You can then interact with the VM in your browser window. No additional software or plugins are required.

Contents

How to open the browser client and use the VM

To open the browser client
  1. From the environment page or a sharing portal, click on the thumbnail image of a running VM. VM Desktop Thumbnail
  2. The VM desktop or console displays in a new tab in the browser.

    ubuntu desktop

    In the browser client:

    • Use your mouse and keyboard to interact with the VM.
    • Use the toolbar at the top of the screen to change the VM power state, access any saved credentials, and customize your VM session. For more information about the toolbar, see Supported actions in the browser client toolbar below.

      Some of the browser toolbar buttons may not work until the VM is fully started.

Access requirements

To use Skytap virtual machines, you need:

  • A supported browser, such as the latest version of Chrome, Firefox, Microsoft Edge, or Safari.
  • A good network connection. This means:

    • At least 1.2 Mbps for each concurrent browser session with a VM.
    • Low latency (150ms or less) to the region where your VMs are located.

Use the Connectivity Checker tool to quickly test whether you meet the minimum access requirements.

For more information, see Access requirements.

Supported actions in the browser client toolbar

When you use the SRA browser client, the toolbar at the top of the screen provides helpful tools for working with the VM.

Switch to another VM

Click All VMs Button to display a list of the VMs in the environment.

HTML5 Client All VMs

To return to an environment-wide view, click the View all VMs link.

  • If you’re a logged in Skytap user, the View all VMs link opens the Environment Details page page.
  • If you’re accessing the VM from a sharing portal, the View all VMs link opens the sharing portal page.

Change VM power state

Click the power buttons (Power Options Buttons) to run, suspend, shut down, or power off the VM. For more information about the power options, see Running and stopping VMs and environments.

Notes

  • If the power buttons are missing, you don't have access to run, suspend, or shut down the VM. For help, contact your administrator, instructor, or the person who provided you with access to the VM.
  • Power A CPU architecture that supports IBM i, AIX, and Linux (on Power) in Skytap. VMs don't support suspend.

Press Ctrl+Alt+Delete

Click Ctrl+Alt+Delete Button to send the Ctrl+Alt+Del keyboard combination to the VM.

Open an on-screen, virtual keyboard

Click Keyboard Button to send common keyboard shortcuts to the VM to show an on-screen keyboard.

The Keyboard layout: field displays the language of the on-screen keyboard.

To change the keyboard layout, see the instructions below.

HTML5 Client Keyboard

To type keyboard shortcuts directly from your local keyboard instead of the on-screen keyboard, see Keyboard shortcuts for the SRA browser client.

Change the keyboard layout

Click Keyboard Button to change the keyboard language mapping recognized by the VM.

HTML5 Client Keyboard

Select a new layout from the Keyboard layout list. The Keyboard layout setting affects:

  • The language settings for the on-screen keyboard that is displayed when you click Show Keyboard.
  • How the keystrokes from your local, physical keyboard are interpreted by the VM.

Notes

  • Don't change this setting unless you have a physical keyboard that matches the new keyboard layout or unless you plan to solely use the virtual, on-screen keyboard.
  • The Keyboard layout setting doesn't change the guest operating system language settings in the VM. You must configure the guest OS to use the same language as the Keyboard layout setting. For more information, see Using an international keyboard during an SRA session.
  • Alternate keyboard layouts aren't supported for Power VMs.

View user names and passwords

Click Credentials Button to display the user names and passwords saved with the VM. To paste a User name or Password into the currently selected VM window, click Insert.

HTML5 Client Credentials

Notes

  • If the VM has more than five sets of credentials, scroll the drop-down list to see all of them.
  • You can't edit VM credentials in this view.
    • If you have a Skytap account, edit the credentials from VM Credentials page.
    • If you don't have access to edit the environment, contact your administrator, instructor, or the person who sent you the link to the environment. Skytap support doesn't manage VM credentials.

Copy and paste text

Click Clipboard Button to copy and paste text between your local machine and the VM. For more information, see Using the VM Clipboard.

VM Clipboard

If this icon is missing, you don’t have permission to copy and paste text to and from the VM.

Notes

  • The clipboard only supports copy and paste of plain text. For options about moving files to and from VMs, see Transferring files to a VM.
  • Power VMs don't support copy and paste.

Adjust VM screen resolution

There are two options:

  • Click Screen Size Button to change the VM screen resolution to fit the current browser window size. The maximum screen resolution size is 1920 x 1080.
  • Click Screen Size Options Button to select from a list of screen resolution sizes.

VM Screen Resolution button

Power VMs don’t support adjustable screen resolutions.

Check VM connection quality

Click Display Quality Button to display the quality of the browser connection to the VM or change the display quality.

To improve performance, reduce the display quality. A lower display quality reduces the amount of bandwidth that your session requires. For more information, see Improving performance during a browser client session.

Sample Display Quality Settings

Use VM audio

If the VM has been enabled to support VM audio through the browser client session, the toolbar contains additional icons.

  • Click rdp to switch the connection type or learn more about it.
  • Check the audio status icons rdp audio to see the whether audio input and output have been enabled.

For more information about using VM audio, see Using audio with a VM.

Display Server Settings

If you’re a Skytap user who wants to enable this feature for a VM, see Enabling audio for a VM.

Connect to the VM using SSH

If the VM has been enabled to support SSH sessions through the browser client session, the toolbar contains an additional icon.

Click SSH (ssh) to switch the connection type or learn more about it. Generally, an SSH session is best if you want a unique, interactive sign-in session.

For more information, see Using an SSH connection during an SRA browser client session.

Display Server Settings

If you’re a Skytap user who wants to enable this feature for a VM, see Enabling SSH on a VM for use in SRA browser client sessions.

Collapse or display the VM toolbar

Click Collapse toolbar button to collapse or display the toolbar.

Troubleshooting

Help with connectivity or performance issues

To resolve connectivity or performance issues, use our guided troubleshooting assistant:

Start troubleshooting

Help with browser client errors

The browser client may display an error message if your browser session remains inactive or if your network is disconnected.

To clear the error, try refreshing the page.

For more help with specific errors, see:

Help with keyboard issues
  • Unresponsive keys

    If a VM is accessed by multiple clients at the same time, certain keys may become unresponsive. To restore key function, close all of the browser sessions and restart the VM.

  • StuckCaps Lock or Num Lock keys

    The Caps Lock and Num Lock keys on the VM may get out of sync with the Caps Lock and Num Lock keys on the physical keyboard. To re-synchronize the keys, either click the Caps Lock or Num Lock key on the VM on-screen keyboard, or press the keys on the physical keyboard when focus is outside of the web client (for example, another window or tab is active).

    Notes

    • Skytap separates the physical key on and off states from the VM key on and off states. This helps to prevent the client from rapidly turning the Caps Lock or Num Lock keys on and off when multiple users are using the VM at the same.
    • For Apple keyboards, the Clear key on the numeric keypad is mapped to the Num Lock key on the VM.
  • and ~ keys not working

    The double quote () and tilde (~) characters may not work on Ubuntu 14.04 VMs; to fix this issue, adjust the VM keyboard settings from within the guest OS. For more information, see Troubleshooting broken keys on an Ubuntu 14.04 VM.

  • Can’t control the mouse or keyboard

    Click the VM screen and try again. This re-focuses your browser window. If you’re still having issues, see Restoring keyboard or mouse control.

Help with VM audio

See Troubleshooting VM audio.