Changes between Version 1 and Version 2 of Internal/newTutorials/0-2

Timestamp:

Jan 23, 2018, 8:36:31 PM (6 years ago)

Author:

jkol

Comment:

—

Internal/newTutorials/0-2

@@ -21 +21 @@
 
 [[BR]]
-== Accessing ==
+== Connecting to a testbed ==
 TODO
 
- {{{ssh yourUserName@sb7.orbit-lab.org}}}
+All access to a testbed is done through the testbed's console machine. During the time slot of your approved reservation, you can connect to the console via SSH.
+
+For example, connecting via SSH to {{{yourUserName@sb7.orbit-lab.org}}} will connect you to the console machine of "Sandbox 7".
 
 [[BR]]
@@ -35 +37 @@
  {{{omf load -i baseline.ndz -r -t node1-1}}}
 
-For the "topology" (-t), you can specify a single node such as "node1-1", a set of nodes sucha as "node1-1,node1-3,node1-4", or even a range of nodes such as "[1..2,7..9]" which in this case is equivalent to "node1-7,node1-8,node1-9,node2-7,node2-8,node2-9". See the command's help output for more possibilities.
+For the "topology" listed after '''-t''', you can specify a single node such as "node1-1", a set of nodes such as "node1-1,node1-3,node1-4", or even a range of nodes such as "[1..2,7..9]" which in this case is equivalent to "node1-7,node1-8,node1-9,node2-7,node2-8,node2-9".
+
+After imaging completes successfully, the nodes will be turned off. They must be turned on before you can SSH into them.
 
 Command help output:
@@ -80 +84 @@
  {{{omf tell -a on -t node1-1}}}
 
+'''NOTE:''' Just like a normal computer, it can take several minutes for a node to finish booting up. Please wait before trying to SSH into it.
+
 To turn off ''node1-1'' as if you held down the power button (ie. hard off):
 
  {{{omf tell -a offh -t node1-1}}}
 
-To turn reset ''node1-1'' as if your pressed the reset button:
+To reset ''node1-1'' as if your pressed the reset button:
 
  {{{omf tell -a reset -t node1-1}}}
@@ -125 +131 @@
  {{{ssh root@node1-1}}}
 
-If you see an error or warning message while trying to SSH into a node, please read the message. Often times the message has to do with host keys on the node having changed from what the console expects (this is typically normal) because every image has a different host key, therefore it will change depending on what node and image you happen to be using. Follow the instructions in the message to resolve this.
+'''NOTE:''' If you see an error or warning message while trying to SSH into a node, please read the message. Often times the message has to do with host keys on the node having changed from what the console expects (this is typically normal) because every image has a different host key, therefore it will change depending on what node and image you happen to be using. Follow the instructions in the message to resolve this.
 
 [[BR]]
 == Saving a node's disk image ==
 TODO
+
+If you wish to save a node's disk image for future use, it is important to do so BEFORE your reservation is over because it takes several minutes to complete and there is no guarantee what the next user will do to the node.
 
 '''Example:''' Suppose we want to save the disk image of ''node1-1'' on the ''grid'' testbed.
@@ -136 +144 @@
  {{{/root/prepare.sh}}}
 
-'''NOTE: If you do not run prepare.sh on the node, the disk image WILL NOT WORK when loaded onto another node.'''
+'''If you do not run prepare.sh on the node, the disk image WILL NOT WORK when loaded onto another node.'''
 
 Then on the console run:
  {{{omf save -n node1-1.grid.orbit-lab.org}}}
-It will take several minutes to complete the save. Once finished, take note of the filename the disk image was saved to (the format of which is username-node-nodename-date-time.ndz) so that you can use it later when loading the disk image again.
+It will take several minutes to complete the save. Once finished, take note of the filename the disk image was saved to (the format of which is ''username-node-nodename-date-time.ndz'') so that you can use it later when loading the disk image again.
 
 Command help output:
@@ -159 +167 @@
                     omf save -n node1-1.sb2.orbit-lab.org
 }}}
-
-[[BR]]
-== Accessing the list of node images ==
- {{{ ssh userName@gw.orbit-lab.org }}}
-
- {{{ ssh repository1 }}}
-
-Go to the disk images folder {{{ cd /export/omf/omf-images/ }}}
-
-TODO