79 | | * You should receive a {{{Reply: OK}}} message. If you do not, please see the troubleshooting section below. After receiving this notice, please run the following command to load the image: |
80 | | |
81 | | Login into the node: {{{ssh -X sb2@10.116.250.100}}}. The password is {{{cosmossandbox2}}}. After logging in into the node, a {{{FD_Examples}}} folder should exist under the home directory which contains some example experiments. Again, see above for using the {{{-Y}}} flag on macOS. |
82 | | * Check the conection and serial number of the USRP 2974: {{{uhd_find_devices}}}. The serial numbers should be 318DCED with address {{{192.168.50.2}}}. |
| 82 | * You should receive a {{{Reply: OK}}} message. If you do not, please see the troubleshooting section below. After receiving this notice, please run the command below to load the image. Note - this command can take over 5-10 minutes to run, so this is a good time to grab a tea or coffee... |
| 83 | {{{ |
| 84 | omf load -o 1800 -i flexicon-cosmos-v1.ndz -t srv2-lg1 |
| 85 | }}} |
| 86 | * '''Let the command run to completion, even if it does not seem to finish.''' Confirm that the command finished and output something along the lines of the text below. If not, please see the troubleshooting section. |
| 87 | {{{ |
| 88 | INFO exp: ----------------------------- |
| 89 | INFO exp: Imaging Process Done |
| 90 | INFO exp: 1 node successfully imaged - Topology saved .... |
| 91 | INFO exp: ----------------------------- |
| 92 | }}} |
| 93 | * Switch on the server with the command below, and check for {{{Reply: OK}}}. The server will take a couple of minutes to switch on fully after the command finishes. |
| 94 | {{{ |
| 95 | omf tell -a on -t srv2-lg1 |
| 96 | }}} |
| 97 | * Log into the server with SSH |
| 98 | {{{ |
| 99 | ssh -X root@srv2-lg1 |
| 100 | }}} |
| 101 | * Run the following command to optimize the server network interfaces for use with UHD and GNU Radio: |
| 102 | {{{ |
| 103 | ./optimizeInterfaces |
| 104 | }}} |
| 105 | * At this point, the server is ready to use. Please see the sections below for details on how to save work when finished, and the experiments and resources that are available on the server. |
| 106 | |
| 107 | ==== Wrapping Up & Saving Work ==== |
| 108 | When you are finished with your experiments, you can save your work to a new node image, that you can then load in next time. Since it can take some time to finish saving your work to a new server image, we recommend saving at least '''30 minutes''' of your reservation time to make sure you have enough time to complete the process. |
| 109 | |
| 110 | * To ensure a reliable image save, it is strongly recommended to reboot the server first. You will need to return to the Sandbox 2 console, either in a new SSH session, or by typing {{{exit}}} on the server SSH window. |
| 111 | * Run the following command from the Sandbox 2 console: |
| 112 | {{{ |
| 113 | omf tell -a reboot -t srv2-lg1 |
| 114 | }}} |
| 115 | * Check for {{{Reply: OK}}} and give some minutes to allow the server to come back online. |
| 116 | * Log back into the server: {{{ssh -X root@srv2-lg1}}} |
| 117 | * Run the following script to prepare the node for imaging. It is ok to ignore warnings and errors from this command. Note the command it provides to you once finishing. |
| 118 | {{{ |
| 119 | ./prepare.sh |
| 120 | }}} |
| 121 | * Go back to the Sandbox 2 console by running {{{exit}}}. |
| 122 | * Run the command that should have been provided by the {{{prepare.sh}}} script. This command, like the {{{omf load}}} command, can take 5-10 minutes to run. Good time to refill your tea or coffee... |
| 123 | {{{ |
| 124 | omf save -n srv2-lg1.sb2.cosmos-lab.org |
| 125 | }}} |
| 126 | * '''Let this command run to completion, even if it does not seem to finish.''' Confirm that the command finished and output something along the lines of the text below. If not, please see the troubleshooting section. |
| 127 | {{{ |
| 128 | INFO exp: |
| 129 | INFO exp: - Saving process started at: 2023-03-21 04:33:09 +0000 |
| 130 | INFO exp: (this may take a while depending on the size of your image) |
| 131 | INFO exp: - Saving disk image of 'srv2-lg1.sb2.cosmos-lab.org' finished with success. |
| 132 | INFO exp: - Saving process completed at: 2023-03-21 04:35:49 +0000 |
| 133 | INFO exp: |
| 134 | }}} |
| 135 | * The filename of your image will be located in the output of the command, specifically in the third line of this part of the output: |
| 136 | {{{ |
| 137 | INFO srv2-lg1.sb2.cosmos-lab.org: |
| 138 | INFO srv2-lg1.sb2.cosmos-lab.org: - Saving image of '/dev/sda' on node 'srv2-lg1.sb2.cosmos-lab.org' |
| 139 | INFO srv2-lg1.sb2.cosmos-lab.org: to the file 'mpk2138-node-srv2-lg1.sb2.cosmos-lab.org-2023-03-21-04-32-59.ndz' on host '10.116.0.40' |
| 140 | INFO srv2-lg1.sb2.cosmos-lab.org: |
| 141 | }}} |
| 142 | * Keep a note of this filename. You can use this instead of {{{flexicon-cosmos-v1.ndz}}} the next time you login to use the FD testbed. |
| 143 | * If you would like to change the filename, you can run the following command. Note, it is good to keep your COSMOS username on the front of your node image filename. Make sure to use your specific filename that was provided in the output of the {{{omf save}}} command. Spaces cannot be used in the filename. |
| 144 | {{{ |
| 145 | mv /export/omf-images-5.4/mpk2138-node-srv2-lg1.sb2.cosmos-lab.org-2023-03-21-04-32-59.ndz /export/omf-images-5.4/mpk2138-IMAGE-NAME-HERE.ndz |
| 146 | }}} |
| 147 | * The node image is now saved, and you will be able to pick up where you left off the next time you login to use the FD radios. |