Jetstream is a NSF funded cloud computing system used by the LAPPS Grid to provide compute resources.
Once the Jetstream has been configured you probably want to head over to the Clusters page to read about setting up a cluster using Docker Swarm or Kubernetes. Apache Mesos is also an option, but has not been tested.
To acknowledge Jetstream in your work, please cite:
Stewart, C.A., Cockerill, T.M., Foster, I., Hancock, D., Merchant, N., Skidmore, E., Stanzione, D., Taylor, J., Tuecke, S., Turner, G., Vaughn, M., and Gaffney, N.I., Jetstream: a self-provisioned, scalable science and engineering cloud environment. 2015, In Proceedings of the 2015 XSEDE Conference: Scientific Advancements Enabled by Enhanced Cyberinfrastructure. St. Louis, Missouri. ACM: 2792774. p. 1-8. https://dl.acm.org/citation.cfm?doid=2792745.2792774
To be able to make use of Jetstream you will need to:
- Create an account on http://portal.xsede.org
- Send your XSEDE username to a LAPPS Grid admin so you can be added to our allocation.
- After you have been added to the LAPPS Grid allocation verify that you can log into:
- http://iu.jetstream-cloud.org/ (Indiana University)
- http://tacc.jetstream-cloud.org/ (Texas Advanced Computing Center)
Once you are able to log in to the Jetstream system you will need to generate the openrc.sh file that is used by the OpenStack API to communicate with Jetstream.
- Sign on to the Jetstream Dashboard at IU or TACC.
- Go to Compute -> Access & Security
- Select the API Access tab
- Click on the Download OpenStack RC File v3 button
NOTE you will need separate openrc.sh files for each cloud (IU or TACC) and each allocation you are the manager of. It is recommended to copy the files someplace convenient and rename them so it is easy to distinguish between them.
Before we can launch instances on one of the clouds we need to do some initial setup:
- Create a network and subnet.
- Create a router.
- Set the router’s gateway to point to the external (public) network.
- Add an interface to connect the router to the internal subnet created above.
$ neutron net-create example-network $ neutron subnet-create example-network 10.0.0.0/24 $ neutron router-create example-router $ neutron router-gateway-set example-router public $ neutron router-interface-add example-router <subnet-id>
The output of the
neutron subnet-create command will contain the *
The remainder of this document assumes you will be using the jetstream script to manage Jetstream instances.
jetstream launch [size] <name>
jetstream suspend <name>
jetstream resume <name>
jetstream delete <name>
The Proxy Server
Redirecting to a new server.
jetstream proxy <ip address>
Disable the proxy. When the proxy is disabled jetstream.lappsgrid.org will redirect to a static out of service page.
Enable the proxy.