Skip to end of metadata
Go to start of metadata
ProblemPossible Solution

VM gets stuck trying to provision the network.

or

Previously behaving and unmodified VM develops problems.

Try these in this order:

  1. Refresh: Refresh your browser and confirm that the Atmosphere interface has synchronized with the latest Jetstream information.
  2. Wait: Please be aware that while provisioning is generally rapid, it can sometimes take several minutes during times of heavy activity. (wait 5-10 minutes)
  3. Redeploy/Reboot: Click Projects (on the top menu) and select the Project with the instance that is stuck.
    Then click on the instance name that's stuck.
    From the Actions menu on the right try
    • Redeploy first (waiting about 2 minutes before proceeding),
    Reboot if that fails (waiting about 5-10 minutes before going to the next step), and 
    Hard Reboot
    if the first two actions fail (waiting about 5-10 minutes).

If none of these Actions work, DO NOT DELETE THE INSTANCE. Make note of the Alias (UID) and IP Address of the Instance, and email that information to help@jetstream-cloud.org or click the button.


Hostname mismatch

If you’re having hostname mismatch issues with some software, try the following:

  1. type su
  2. type 'crontab -e'
  3. add this line:

    @reboot /bin/hostname | awk -F'.' '{print $1}' > /etc/hostname
  4. save
Volume fails to detach


  1. make sure the instance to which the volume is attached is actively running
  2. make sure no jobs or process are running on the instance are using the volume
    The command:

    fuser -km /vol_b

    will terminate all processes using the volume named /vol_b


Volume fails to attach


  1. make sure the instance to which the volume should be attached is actively running


My instance has been locked by an administrator
  1. Are you running an insecure web-service like Apache or MongoDB with no security features enabled ?
    1. MongoDB: https://docs.mongodb.com/manual/administration/security-checklist/
    2. Apache: https://httpd.apache.org/docs/2.4/misc/security_tips.html
Web-Shell (Gate-One) does not connect (via ssh)

If your Web-Shell / Gate-One stalls at a prompt like:

  1. then close the session by clicking on the "X" in the top-right menu bar:

2. then close the browser window/tab.

3. Go back to your Jetstream Atmosphere window and re-click on the link.

Web Desktop does not launch

Try using the instructions for an external VNC viewer

API command line access to TACC fails with "requires authentication" error

Add the following two lines to the openrc.sh script if they are not there:

missing TACC openrc.sh env variables
export OS_USER_DOMAIN_NAME=tacc
export OS_IDENTITY_API_VERSION=3
btrfs in conjunction with OpenStack's ceph has known kernel bugplease use a different file system. e.g XFS, EXT4
Your VM is in ERROR state

While there are a number of reasons for this potentially happening, one thing to check is to see if your VM name has a period within the last characters. If so, it is most likely failing because OpenStack, the underlying framework for Jetstream, is interpreting that as a domain name server (DNS) name and is trying to resolve it and failing, stopping the boot entirely.

The instance will never boot correctly with a name that has a period and numbers in the last three characters. Delete the instance and create a new one without a period in the last three characters. If you have changed the name since initial launch and are getting the error on subsequent boot attempts, contact support and we can help you bring it back online.

Mouse does not work in web desktop

Laptops with touchscreens are unable to use the mouse in the web desktop using Chrome and Firefox on Windows 10.

There is a bug in the web browser code in both Chrome and Firefox for using a touchscreen PC with the web desktop of Jetstream. This is not a bug we can easily work around since it's in the browser code itself.


While we do not recommend using Internet Explorer, it does not have the issue. Using a VNC Viewer also is a viable workaround.
web-shell works for my Ubuntu 16.04 version or newer instance, but I cannot ssh to it directly from an external ssh client
  • Are you using DSA keys? DSA keys are deprecated for Ubuntu 16.04 and newer instances. Please use RSA keys.

Users with a brace " { " in their passwords may experience errors with OpenStack command line commands. 

  • There is a known issue with braces in openstack passwords when using the OpenStack command line client. At this time, do not use a brace in your password.
  • No labels