|
|
|
The old Emulab interface (which we affectionately refer to as *Emulab Classic*) has been deprecated for a while, we are no longer doing any active development on it. If possible, you should consider switching over to the new [Portal](https://www.emulab.net/portal) interface which is complete redesign of the web interface and experiment workflow model.
|
|
|
|
The most important feature of the new Portal interface, is that **NS** is no longer used as the specification language for experiments. Instead, we now use Python to describe experiments. Lots of information and a tutorial can be found in the new [Emulab Documentation](http://docs.emulab.net).
|
|
|
|
The most important feature of the new Portal interface, is that **NS** is no longer used as the specification language for experiments. Instead, we now use Python to describe experiments.
|
|
|
|
|
|
|
|
The new documentation includes a detailed section on how to [convert your NS experiments to Python](http://docs.emulab.net/emulab-transition.html) after switching over to the Portal web interface.
|
|
|
|
For more details about transitioning from the old, Classic web interface to the new Emulab portal, see: [http://docs.emulab.net/emulab-transition.html](http://docs.emulab.net/emulab-transition.html). Lots of other information and a tutorial can be found in the new [Emulab Documentation](http://docs.emulab.net).
|
|
|
|
|
|
|
|
### PROFILES
|
|
|
|
|
|
|
|
In comparison to the old, "classic" Emulab UI, the Emulab portal has
|
|
|
|
a streamlined, modern web GUI. More significantly, the portal is
|
|
|
|
organized around *profiles*, which are similar to, but different than,
|
|
|
|
classic Emulab experiments. Profiles:
|
|
|
|
|
|
|
|
* are written in a domain-specific language atop Python (no more NS/Tcl!)
|
|
|
|
* can be created and edited with a web-based GUI
|
|
|
|
* are versioned
|
|
|
|
* can have parameters, settable at swap-in time
|
|
|
|
* can have metadata, including embedded instructions
|
|
|
|
* can potentially be instantiated on other testbeds, like CloudLab
|
|
|
|
* can be based on Git repositories
|
|
|
|
* can be published to the world
|
|
|
|
|
|
|
|
To learn about the portal UI, profiles, and the "geni-lib" DSL, please
|
|
|
|
consult the online documentation:
|
|
|
|
|
|
|
|
* [http://docs.emulab.net/getting-started.html](http://docs.emulab.net/getting-started.html)
|
|
|
|
* [http://docs.emulab.net/creating-profiles.html](http://docs.emulab.net/creating-profiles.html)
|
|
|
|
* [http://docs.emulab.net/geni-lib.html](http://docs.emulab.net/geni-lib.html)
|
|
|
|
|
|
|
|
### CLASSIC EXPERIMENTS
|
|
|
|
|
|
|
|
The Emulab portal can create profiles from Classic Emulab experiments,
|
|
|
|
automatically converting NS files into geni-lib scripts. Within the
|
|
|
|
classic Emulab interface, navigate to one of your experiments and select
|
|
|
|
"Create Profile from Experiment" from the left-hand menu. In the portal,
|
|
|
|
you will also see icons that provide a "shortcut" to the converter.
|
|
|
|
|
|
|
|
The converter covers the most commonly used features of NS. If you find
|
|
|
|
a missing feature, or have an experiment that cannot convert, please let
|
|
|
|
us know. We are especially interested in feedback about the converter!
|
|
|
|
|
|
|
|
### RESERVATIONS
|
|
|
|
|
|
|
|
One of the cool new features of the portal UI is reservations. A project
|
|
|
|
can reserve a set of nodes for some time in the future, and when the time
|
|
|
|
comes, the project can use those nodes to run one or several experiments.
|
|
|
|
Learn more about reservations here:
|
|
|
|
[http://docs.emulab.net/reservations.html](http://docs.emulab.net/reservations.html)
|
|
|
|
|
|
|
|
MISSING FEATURES
|
|
|
|
|
|
|
|
The primary features of NS-based experiments that are *not* currently
|
|
|
|
available in geni-lib profiles relate to the event system. The missing
|
|
|
|
features include dynamic events ("event at time X"), event sequences,
|
|
|
|
event timelines, and event groups. These features are somewhat rarely
|
|
|
|
used by most Emulab experimenters. Please send us feedback if you would
|
|
|
|
like support for these features and/or help with possible workarounds.
|
|
|
|
|
|
|
|
If for some reason you are unwilling or unable to use the new Portal interface, the [Emulab Classic](https://www.emulab.net/classic.html) interface will be available for a while longer. |
|
|
\ No newline at end of file |
