Commit 6d771542 authored by Leigh Stoller's avatar Leigh Stoller

Address a Tim Stack nit, one thats bothered me for a bit. Get rid of

the newimageid_explain front page, since I had actually moved most of
that text into the tutorial a couple of months ago. I moved the rest
of the text over, and changed the links to point to the short form.
Added a link at the top of the short form pointing to the tutorial
section, and for admin types, a link to the long form.
parent b8e3c94e
......@@ -356,7 +356,7 @@ function SPITFORM($formfields, $errors)
file first!
<li> You can view a <a href='showosid_list.php3'>list of OSIDs</a>
that are available for you to use in your NS file.
<li> Create your own <a href='newimageid_explain.php3'>
<li> Create your own <a href='newimageid_ez.php3'>
custom disk images</a>.
</ul>
</blockquote>\n";
......
<?php
#
# EMULAB-COPYRIGHT
# Copyright (c) 2000-2002 University of Utah and the Flux Group.
# Copyright (c) 2000-2003 University of Utah and the Flux Group.
# All rights reserved.
#
include("defs.php3");
......@@ -764,7 +764,7 @@ if (! isset($node)) {
"deleteimageid.php3?imageid=$fooid");
}
WRITESUBMENUBUTTON("Create a new Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("Create a new OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("Image Descriptor list",
......
<?php
#
# EMULAB-COPYRIGHT
# Copyright (c) 2000-2002 University of Utah and the Flux Group.
# All rights reserved.
#
include("defs.php3");
#
# Standard Testbed Header
#
PAGEHEADER("Create a new ImageID");
#
# Only known and logged in users can get this far!
#
$uid = GETLOGIN();
LOGGEDINORDIE($uid);
$isadmin = ISADMIN($uid);
?>
<p>
This page will allow you to create your own custom disk image,
described by what we call an Image Descriptor. An Image Descriptor
indicates what operating system is contained in the image, what DOS
partition (or "slice" in BSD-speak) the image goes in, where the
image data file should be stored on disk, etc. Once you have created
the description, you can create the image from a node in one of your
experiments, and then load that image on other nodes (say, in a new
experiment). The image data file is in a compressed format that can be
quickly and easily loaded onto a node, or onto a group of nodes all at
the same time.
<p>
The most common approach is to use the <a
href='newimageid_ez.php3'>New Image Descriptor</a> form to create
a disk image that contains a customized version of the standard Redhat
Linux partition or the FreeBSD partition. Or, you can start from
scratch and load your own operating system in any of the DOS
partitions, and then capture that partition when you are done. Either
way, all you need to do is enter the node name in the form, and the
testbed system will create the image for you automatically, notifying
you via email when it is finished. You can then use that image in
subsequent experiments by specifying the descriptor name in your NS
file with the
<a href="tutorial/docwrapper.php3?docname=nscommands.html#OS">
<tt>tb-set-node-os</tt></a> directive. When the experiment is
configured, the proper image will be loaded on each node automatically by
the Testbed system.
<p>
There is a
<a href='showosid_list.php3'>list of descriptors</a> that
have already been created in your project (and are available for you
to use in your experiments).
<?php
if ($isadmin) {
echo "If you want to create an image that contains multiple DOS
partitions, or even the entire disk, you should use the
<a href='newimageid.php3'>long form</a>.\n";
}
?>
<p>
If you already have an Image Descriptor defined, and you want to
create a new version of the image using a node that is allocated in
one of your experiments and setup the way you want it, use the
<tt>create_image</tt> command. Log into <tt>users</tt> and run:
<code><pre>
create_image -p &lt;pid&gt &lt;imageid&gt &lt;node&gt </pre></code>
This will reboot your node and create the new image, writing it to the
filename specified in the descriptor. This program is going exit
immediately and then send you email about 5-10 minutes later, after
the image is finished. In the meantime you should not do anything to
your node. Log out and leave it alone. If you do not get email, its
possible that the node froze up on reboot, which happens
sometimes. Let us know if you do not receive notification in a
reasonable amount of time.
<p>
If you ever want to reload a node in your experiment, either with one
of your images or with one of the default images, you can use the
<tt>os_load</tt> command. Log into <tt>users</tt> and run:
<code><pre>
os_load -p &lt;pid&gt -i &lt;imageid&gt &lt;node&gt </pre></code>
This program will run in the foreground, waiting until the image has
been loaded. At that point you should log in and make sure everything
is working oaky. You might want to watch the console line as well (see
the FAQ). If you want to load the default image, then simply run:
<code><pre>
os_load &lt;node&gt </pre></code>
<?php
#
# Standard Testbed Footer
#
PAGEFOOTER();
?>
......@@ -74,6 +74,19 @@ function SPITFORM($formfields, $errors)
$featurelist;
global $TBDB_IMAGEID_IMAGENAMELEN, $TBDB_NODEIDLEN;
global $TBDB_OSID_VERSLEN, $TBBASE;
echo "<center><b>
See the
<a href=tutorial/docwrapper.php3?docname=tutorial.html#CustomOS>
tutorial</a> for more info on creating/using custom Images.
</b></center>\n";
if ($isadmin) {
echo "<center>
Administrators get to use the
<a href='newimageid.php3'>long form</a>.
</center>\n";
}
if ($errors) {
echo "<table class=nogrid
......@@ -763,7 +776,7 @@ if (! isset($node)) {
"deleteimageid.php3?imageid=$fooid");
}
WRITESUBMENUBUTTON("Create a new Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("Create a new OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("Image Descriptor list",
......
<?php
#
# EMULAB-COPYRIGHT
# Copyright (c) 2000-2002 University of Utah and the Flux Group.
# Copyright (c) 2000-2003 University of Utah and the Flux Group.
# All rights reserved.
#
include("defs.php3");
......@@ -216,7 +216,7 @@ WRITESUBMENUBUTTON("Delete this OS Descriptor",
WRITESUBMENUBUTTON("Create a new OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("Create a new Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("OS Descriptor list",
"showosid_list.php3");
WRITESUBMENUBUTTON("Image Descriptor list",
......
<?php
#
# EMULAB-COPYRIGHT
# Copyright (c) 2000-2002 University of Utah and the Flux Group.
# Copyright (c) 2000-2003 University of Utah and the Flux Group.
# All rights reserved.
#
include("defs.php3");
......@@ -45,7 +45,7 @@ WRITESUBMENUBUTTON("Edit this Image Descriptor",
WRITESUBMENUBUTTON("Delete this Image Descriptor",
"deleteimageid.php3?imageid=$fooid");
WRITESUBMENUBUTTON("Create a new Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("Create a new OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("Image Descriptor list",
......
......@@ -53,7 +53,7 @@ else {
SUBPAGESTART();
SUBMENUSTART("More Options");
WRITESUBMENUBUTTON("Create an Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("Create an OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("OS Descriptor list",
......
......@@ -55,7 +55,7 @@ else {
SUBPAGESTART();
SUBMENUSTART("More Options");
WRITESUBMENUBUTTON("Create an Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("Create an OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("Image Descriptor list",
......
<?php
#
# EMULAB-COPYRIGHT
# Copyright (c) 2000-2002 University of Utah and the Flux Group.
# Copyright (c) 2000-2003 University of Utah and the Flux Group.
# All rights reserved.
#
include("defs.php3");
......@@ -44,7 +44,7 @@ WRITESUBMENUBUTTON("Delete this OS Descriptor",
WRITESUBMENUBUTTON("Create a new OS Descriptor",
"newosid_form.php3");
WRITESUBMENUBUTTON("Create a new Image Descriptor",
"newimageid_explain.php3");
"newimageid_ez.php3");
WRITESUBMENUBUTTON("OS Descriptor list",
"showosid_list.php3");
WRITESUBMENUBUTTON("Image Descriptor list",
......
<!--
EMULAB-COPYRIGHT
Copyright (c) 2000-2002 University of Utah and the Flux Group.
Copyright (c) 2000-2003 University of Utah and the Flux Group.
All rights reserved.
-->
<a name="top"></a>
......@@ -103,7 +103,7 @@ a disk image of the node in question, and later reloading it to a new
node after you swap in again. Disk images in effect create a "custom
OS" that can be loaded automatically based on your NS file. More
information about disk images can be found on our <a
href="https://www.emulab.net/newimageid_explain.php3"> Disk Image
href="https://www.emulab.net/newimageid_ez.php3"> Disk Image
page</a> (you must be logged in to use it). We are currently working
on a system that will allow you to save disk images from all the nodes
in your experiment at swapout time, and reload them automatically when
......
......@@ -1072,7 +1072,7 @@ file.</i>
Emulab allows you to create your own disk images and load them on your
experimental nodes, automatically when your experiment is created or
swapped in. Once you have created a custom disk image (and the
associated <a href="https://www.emulab.net/newimageid_explain.php3">
associated <a href="https://www.emulab.net/newimageid_ez.php3">
image/osid descriptor</a> for it, you can use that OSID in your NS
file. When your experiment is swapped in, the testbed system will
arrange for your disks to be loaded in parallel using a locally
......@@ -1083,18 +1083,18 @@ it may seem like overkill to create your own disk image, we can assure
you it is not!
<p>
The most common approach is to use the <a
href='newimageid_ez.php3'>New Image Descriptor</a> form to create
a disk image that contains a customized version of the standard Redhat
Linux partition or the FreeBSD partition. Or, you can start from
scratch and load your own operating system in any of the DOS
partitions, and then capture that partition when you are done. Either
way, all you need to do is enter the node name in the form, and the
testbed system will create the image for you automatically, notifying
you via email when it is finished. You can then use that image in
subsequent experiments by specifying the descriptor name in your NS
file with the
<a href="tutorial/docwrapper.php3?docname=nscommands.html#OS">
The most common approach is to use the
<a href="https://www.emulab.net/newimageid_ez.php3">New Image Descriptor</a>
form to create a disk image that contains a customized version of the
standard Redhat Linux partition or the FreeBSD partition. Or, you can
start from scratch and load your own operating system in any of the
DOS partitions, and then capture that partition when you are
done. Either way, all you need to do is enter the node name in the
form, and the testbed system will create the image for you
automatically, notifying you via email when it is finished. You can
then use that image in subsequent experiments by specifying the
descriptor name in your NS file with the
<a href="docwrapper.php3?docname=nscommands.html#OS">
<tt>tb-set-node-os</tt></a> directive. When the experiment is
configured, the proper image will be loaded on each node automatically by
the Testbed system.
......@@ -1160,7 +1160,18 @@ default images as a base, goes like this:
</ol>
</blockquote>
More information on creating and loading your own disk images can be
found at <a href="https://www.emulab.net/newimageid_explain.php3">
https://www.emulab.net/newimageid_explain.php3.</a>
If you ever want to reload a node in your experiment, either with one
of your images or with one of the default images, you can use the
<tt>os_load</tt> command. Log into <tt>users</tt> and run:
<code><pre>
os_load -p &lt;pid&gt -i &lt;imageid&gt &lt;node&gt </pre></code>
This program will run in the foreground, waiting until the image has
been loaded. At that point you should log in and make sure everything
is working oaky. You might want to watch the console line as well (see
the <a href="../faq.php3?#UTT-3">FAQ</a>). If you want to load the
default image, then simply run:
<code><pre>
os_load &lt;node&gt </pre></code>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment