[[Include(WikiToC)]]

=== Loading an image

'''Note:''' Several OMF commands are utilized through out the loading process. If you are not familiar with OMF and need a very quick start, please refer to the [wiki:Documentation/OmfQuickStart OMF Quick Start Page.]



 1. Before we begin using the nodes, it's a good idea to check their status first. This is done with the ''omf stat'' command.

{{{
console> omf stat -t all

 INFO NodeHandler: OMF Experiment Controller 5.4 (git 861d645)
 INFO NodeHandler: Slice ID: default_slice (default)
 INFO NodeHandler: Experiment ID: default_slice-2019-05-16t11.30.21.088-04.00
 INFO NodeHandler: Message authentication is disabled
 INFO property.resetDelay: resetDelay = 200 (Fixnum)
 INFO property.resetTries: resetTries = 1 (Fixnum)
 INFO property.nodes: nodes = "system:topo:all" (String)
 INFO property.summary: summary = false (FalseClass)
 INFO Topology: Loaded topology 'system:topo:all'.

Talking to the CMC service, please wait
-----------------------------------------------
 Node: mob1.sb1.cosmos-lab.org           State: POWEROFF
 Node: mob2.sb1.cosmos-lab.org           State: POWEROFF
 Node: mob3.sb1.cosmos-lab.org           State: POWEROFF
 Node: sdr1-lg1.sb1.cosmos-lab.org       State: POWEROFF
 Node: sdr1-md1.sb1.cosmos-lab.org       State: POWEROFF
 Node: sdr2-lg1.sb1.cosmos-lab.org       State: POWEROFF
 Node: sdr2-md1.sb1.cosmos-lab.org       State: POWEROFF
 Node: srv1-lg1.sb1.cosmos-lab.org       State: POWEROFF
 Node: srv2-lg1.sb1.cosmos-lab.org       State: POWEROFF
-----------------------------------------------

 INFO EXPERIMENT_DONE: Event triggered. Starting the associated tasks.
 INFO NodeHandler:
 INFO NodeHandler: Shutting down experiment, please wait...
 INFO NodeHandler:
 INFO run: Experiment default_slice-2019-05-16t11.30.21.088-04.00 finished after 0:5

}}}

The node can be in 1 of 3 states
 || POWEROFF || Node is available for use but turned off ||
 ||POWERON || Node is available and is on ||
 ||NOT REGISTERED || Node is not available for use ||


2. It is recommended that the node be in the POWEROFF state prior to any experiment process. If the node is in the POWERON state you can use the ''omf tell'' command to get the node into the off state.

{{{
console> omf tell -a offh -t sdr2-lg1.sb1.cosmos-lab.org

 INFO NodeHandler: OMF Experiment Controller 5.4 (git 861d645)
 INFO NodeHandler: Slice ID: default_slice (default)
 INFO NodeHandler: Experiment ID: default_slice-2019-05-16t11.33.26.632-04.00
 INFO NodeHandler: Message authentication is disabled
 INFO property.resetDelay: resetDelay = 200 (Fixnum)
 INFO property.resetTries: resetTries = 1 (Fixnum)
 INFO property.nodes: nodes = "sdr2-lg1.sb1.cosmos-lab.org" (String)
 INFO property.command: command = "offh" (String)

Talking to the CMC service, please wait
-----------------------------------------------
 Node: sdr2-lg1.sb1.cosmos-lab.org       Reply: OK
-----------------------------------------------

 INFO EXPERIMENT_DONE: Event triggered. Starting the associated tasks.
 INFO NodeHandler:
 INFO NodeHandler: Shutting down experiment, please wait...
 INFO NodeHandler:
 INFO run: Experiment default_slice-2019-05-16t11.33.26.632-04.00 finished after 0:10
}}}

 3. Use the ''omf stat'' to verify the node is in the POWEROFF state. At this point load an image with ''omf load'' command.

{{{
console> omf load -i baseline-uhd1.ndz -t sdr2-lg1.sb1.cosmos-lab.org

 INFO NodeHandler: OMF Experiment Controller 5.4 (git 861d645)
 INFO NodeHandler: Slice ID: pxe_slice
 INFO NodeHandler: Experiment ID: pxe_slice-2019-05-16t11.04.08.897-04.00
 INFO NodeHandler: Message authentication is disabled
 INFO property.resetDelay: resetDelay = 200 (Fixnum)
 INFO property.resetTries: resetTries = 1 (Fixnum)
 INFO property.nodes: nodes = "sdr2-lg1.sb1.cosmos-lab.org" (String)
 INFO property.image: image = "baseline-uhd1.ndz" (String)
 INFO property.domain: domain = "sb1.cosmos-lab.org" (String)
 INFO property.outpath: outpath = "/tmp" (String)
 INFO property.outprefix: outprefix = "pxe_slice-2019-05-16t11.04.08.897-04.00" (String)
 INFO property.timeout: timeout = 800 (Fixnum)
 INFO property.resize: resize = nil (NilClass)
 INFO property.resetDelay: resetDelay = 80 (Fixnum)
 INFO Experiment: Resetting resources
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [0 sec.]
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [10 sec.]
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [20 sec.]
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [30 sec.]
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [40 sec.]
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [50 sec.]
 INFO stdlib: Waiting for nodes (Up/Down/Total): 0/1/1 - (still down: sdr2-lg1.sb1.cosmos-lab.org) [60 sec.]
 INFO ALL_UP: Event triggered. Starting the associated tasks.
 INFO exp: Progress(0/0/1): 0/0/0 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 790 sec.
 INFO BRING_UP: Event triggered. Starting the associated tasks.
 INFO Experiment: Bringing up resources
 INFO exp: Progress(0/0/1): 0/0/0 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 780 sec.
 INFO exp: Progress(0/0/1): 20/20/20 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 770 sec.
 INFO exp: Progress(0/0/1): 40/40/40 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 760 sec.
 INFO exp: Progress(0/0/1): 60/60/60 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 750 sec.
 INFO exp: Progress(0/0/1): 70/70/70 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 740 sec.
 INFO exp: Progress(0/0/1): 90/90/90 min(sdr2-lg1.sb1.cosmos-lab.org)/avg/max (59) - Timeout: 730 sec.
 INFO exp: Progress(1/0/1): 100/100/100 min()/avg/max (59) - Timeout: 720 sec.
 INFO exp:  -----------------------------
 INFO exp:  Imaging Process Done
 INFO exp:  1 node successfully imaged - Topology saved in '/tmp/pxe_slice-2019-05-16t11.04.08.897-04.00-topo-success.rb'
 INFO exp:  -----------------------------
 INFO EXPERIMENT_DONE: Event triggered. Starting the associated tasks.
 INFO NodeHandler:
 INFO NodeHandler: Shutting down experiment, please wait...
 INFO NodeHandler:
 INFO NodeHandler: Shutdown flag is set - Turning Off the resources
 INFO run: Experiment pxe_slice-2019-05-16t11.04.08.897-04.00 finished after 2:25
}}}

Once the node finishes the imaging process, the node is in the POWEROFF state. So use the ''omf tell'' command to turn it back on, give it some time to boot and then ssh into it.  
{{{
console> omf tell -a on -t sdr2-lg1.sb1.cosmos-lab.org
}}}

Now you can access the node(s) and start your development.