Skip to end of metadata
Go to start of metadata
ProblemPossible Solution
VM gets stuck trying to provision the network
  1. Refresh your browser and confirm that the Atmosphere interface has synchronized with the latest Jetstream information.
  2. 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. 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 /vol1

    will terminate all processes using the volume named /vol1


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:

  • then click on the "X" in the top-right menu bar:

  • then close the browser window/tab.
  • 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 conjuction 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.

  • No labels