Commit 5d814138 authored by Robert Ricci's avatar Robert Ricci

More complete instructions for how to tell if the setup scripts are finished

parent 4bc6ee4f
......@@ -223,7 +223,10 @@ information about how they work.
@bold{Important:} A ``Ready'' status indicates that resources are
provisioned and booted; this particular profile runs scripts to
complete the OpenStack setup, and it will be a few more minutes before
OpenStack is fully ready to log in and create virtual machine instances.
OpenStack is fully ready to log in and create virtual machine
instances. For now, don't attempt to log in to OpenStack, we will
explore the CloudLab experiment first.
}
]
......@@ -390,6 +393,40 @@ command line interfaces or other APIs as well.}
@itemlist[#:style 'ordered
@instructionstep["Check to see if OpenStack is ready to log in"]{
As mentioned earlier, this profile runs several scripts to complete
the installation of OpenStack. These scripts do things such as
finalize package installation, customize the installation for the
specific set of hardware assigned to your experiment, import cloud
images, and bring up the hypervisors on the compute node(s).
If exploring the @(tb) experiment took you more than ten minutes, these
scripts are probably done. You can be sure by checking:
@itemlist[
@item{The setup script will attempt to send mail to the addresses
associated with your GENI portal account when it is finished.
We find, however, that this mail often gets caught by spam
filters.}
@item{You can watch the setup log by logging into the @tt{controller}
node via @(ssh) (either a traditional @(ssh) client, or the
@seclink["tutorial-web-shell"]{web-based shell} described
above), and running
@tt{sudo tail -F /root/setup/setup-controller.log} . If this
log is no longer producing output, the setup process is
finished.
}
]
If you continue without verifying that the setup scripts are
complete, be aware that you may see temporary errors from the
OpenStack web interface. These errors, and the method for dealing with
them, are generally noted in the text below.
}
@instructionstep["Visit the OpenStack Horizon web interface"
#:screenshot "tutorial/experiment-instructions.png"]{
On the status page for your experiment, in the ``Instructions''
......@@ -407,9 +444,7 @@ command line interfaces or other APIs as well.}
@bold{Important:} if the web interface rejects your password, wait
a few minutes and try again. If it gives you another type of error,
you may need to wait a minute and reload the page to get login
working properly. If you want to see what the setup software is up to,
you can @(ssh) into the @tt{control} node and watch the process list
and @tt{top}.
working properly.
}
@instructionstep["Launch a new VM instance"
......@@ -466,9 +501,9 @@ command line interfaces or other APIs as well.}
experiment network.}
@bold{Important:} If you are missing the Networking tab, you may have
logged into the OpenStack web interface before all services were started.
Unfortunately, reloading does not solve this, you will need to log out
and back in.
logged into the OpenStack web interface before all services were
started. Unfortunately, reloading does not solve this, you will need
to log out and back in.
}
@instructionstep["Launch, and Wait For Your Instance to Boot"
......
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