| 1 | = geni-get = |
| 2 | |
| 3 | A command that runs on a GENI node and tells you GENI meta-information about the slivers and slices and experimenter assocaited with the node. |
| 4 | |
| 5 | = PG implementation = |
| 6 | |
| 7 | * https://www.emulab.net/downloads/geni-get.tar.gz |
| 8 | * https://www.emulab.net/downloads/geni-get_1.0_all.deb |
| 9 | * https://www.emulab.net/downloads/geni-get-1.0-1.fc15.noarch.rpm |
| 10 | |
| 11 | = Usage = |
| 12 | |
| 13 | {{{ |
| 14 | +$ geni-get --help |
| 15 | usage: geni-get [-h] [-a] [-c] [-n] [-p PORT] [-v] [command] |
| 16 | |
| 17 | positional arguments: |
| 18 | command |
| 19 | |
| 20 | optional arguments: |
| 21 | -h, --help show this help message and exit |
| 22 | -a, --all dump all information available |
| 23 | -c, --client-version display client version |
| 24 | -n, --no-cache disable reading cached results |
| 25 | -p PORT, --port PORT specify server port |
| 26 | -v, --version display server version |
| 27 | }}} |
| 28 | |
| 29 | = Output = |
| 30 | |
| 31 | == manifest == |
| 32 | |
| 33 | Returns nothing. |
| 34 | |
| 35 | == control_mac == |
| 36 | |
| 37 | {{{ |
| 38 | +$ geni-get control_mac |
| 39 | 02bed2ecdc92 |
| 40 | }}} |
| 41 | |
| 42 | == client_id == |
| 43 | |
| 44 | {{{ |
| 45 | +$ geni-get client_id |
| 46 | bbn-ig-jbs15 |
| 47 | }}} |
| 48 | |
| 49 | == slice_urn == |
| 50 | |
| 51 | {{{ |
| 52 | +$ geni-get slice_urn |
| 53 | urn:publicid:IDN+ch.geni.net:JBS+slice+jbs15 |
| 54 | }}} |
| 55 | |
| 56 | == slice_email == |
| 57 | |
| 58 | {{{ |
| 59 | +$ geni-get slice_email |
| 60 | slice-jbs15@example.com |
| 61 | }}} |
| 62 | |
| 63 | == user_urn == |
| 64 | |
| 65 | {{{ |
| 66 | +$ geni-get user_urn |
| 67 | urn:publicid:IDN+ch.geni.net+user+jbs |
| 68 | }}} |
| 69 | |
| 70 | == user_email == |
| 71 | |
| 72 | {{{ |
| 73 | +$ geni-get user_email |
| 74 | jbs@bbn.com |
| 75 | }}} |
| 76 | |
| 77 | == version == |
| 78 | |
| 79 | {{{ |
| 80 | +$ geni-get version |
| 81 | 1 |
| 82 | }}} |
| 83 | |
| 84 | == geni_user == |
| 85 | |
| 86 | {{{ |
| 87 | +$ geni-get geni_user | python -mjson.tool | sed -e 's/ / /g' |
| 88 | [ |
| 89 | { |
| 90 | "keys": [ |
| 91 | "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAvxWF39ISW4XwXbQ480ZumhPY/t+3hnhS91GxvBU2szCNZa7xvRO56sr7gbZLCD9TvQ+gD3X4W1Iy9pvVNX31EUmT+IKwIu8rwxbGF2Qt1VICw9Y0fbBnhkYSBnNwfwlsQUiGojv7IAyD3fi6gmBNdeKBtmiaJQSJf4iARPwfQE6QaXG8Q3+h9jH5GHW9LnWMpZ8VuStLaNLR0DQ8l/xU+i/1NX0vZHqaxxzbR5OSfQcDOlz+NxVjXa1uz7h3W8E0zVL6ZLn650OhoFAfPWEf+pdjyixHx2bUMMCzjBCTMhxQ2u792f/WD0Nq1bwwbZ93tifta8KiMc7UPJQUm4dw8Q== jbs@gpolab.bbn.com", |
| 92 | "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA0nK/+rVwI+KMRz5t91eT0AsO+VA+SSkXhtjHO/ReECiOFJOY6qa70OTBTHTBnQtVP2gwzpKDVInqPkqzdoujdV9LrPwxawhZVx3CdSDiKtWbSNvWxdKL2Htnq21vULmAWf7qMhGchvRfGANfLg7mDItH7zLcngPks3FOKP2+xiG4JTGL7z5vF9GaZKi7ujaW0VvXHVxQ6aTbsxo1yx8JlV6IYc3L4PqDprTtpBTFcsh4hgVVahOxRY6dUt+eF6vQcNGEqpBQLf1ndH4z9b+eU9gR7Oe7q01+oTWskLL5VDRIHy9XBx6MV20kufmHd9YXeTQBegDJFDhPWZXa4QowIw== jbs@fenris.infersys.com", |
| 93 | "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAxRl7mayQ54SDCoQyigPbrgJcwMLbwG47w0aW7bNGHgdjM82emdIi6VXdajI2AK9hJo09UotY1fvCkvCF8bI0zUxF8tvHkTmIAb1pGAsAyjGMly4LR3NhigyB/3GH3scD8YHmDxH5GiCYW+b4dTJ1WbIsksw11w1+bm/jLJfhrvzTkafHJOp3AHu9dwq8COgrlyxEAV2bLnmLOEmpJr6tmX0GNnq0XsISNgcqzvX5UqNa2IFALoro9dlmSkAl+rgZX/QKBI+c3AwoVlVbafT/VRUHbFvcvJGzRX90JEremnB+8UxbPgz1IIfgWgBii4HFyECXb7Yvu3pOTyMsU3DevQ== jbs" |
| 94 | ], |
| 95 | "urn": "urn:publicid:IDN+ch.geni.net+user+jbs" |
| 96 | } |
| 97 | ] |
| 98 | }}} |
| 99 | |
| 100 | == get_version == |
| 101 | |
| 102 | Returns nothing. |
| 103 | |
| 104 | == sliverstatus == |
| 105 | |
| 106 | {{{ |
| 107 | +$ geni-get sliverstatus |
| 108 | {'geni_urn':'urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15632','geni_status':'ready','geni_resources':[{'geni_urn':'urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15631','geni_status':'ready','geni_error':''}]} |
| 109 | }}} |
| 110 | |
| 111 | Bug: This shouldn't use single quotes, that's not legal JSON. Converted to double quotes: |
| 112 | |
| 113 | {{{ |
| 114 | +$ geni-get sliverstatus | sed -e "s/'/\"/g" | python -mjson.tool | sed -e 's/ / /g' |
| 115 | { |
| 116 | "geni_resources": [ |
| 117 | { |
| 118 | "geni_error": "", |
| 119 | "geni_status": "ready", |
| 120 | "geni_urn": "urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15631" |
| 121 | } |
| 122 | ], |
| 123 | "geni_status": "ready", |
| 124 | "geni_urn": "urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15632" |
| 125 | } |
| 126 | }}} |
| 127 | |
| 128 | == --all == |
| 129 | |
| 130 | {{{ |
| 131 | +$ geni-get --all |
| 132 | {"client_id":"bbn-ig-jbs15","slice_urn":"urn:publicid:IDN+ch.geni.net:JBS+slice+jbs15","slice_email":"slice-jbs15@example.com","user_urn":"urn:publicid:IDN+ch.geni.net+user+jbs","user_email":"jbs@bbn.com","geni_user":[{"urn":"urn:publicid:IDN+ch.geni.net+user+jbs","keys":["ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAvxWF39ISW4XwXbQ480ZumhPY/t+3hnhS91GxvBU2szCNZa7xvRO56sr7gbZLCD9TvQ+gD3X4W1Iy9pvVNX31EUmT+IKwIu8rwxbGF2Qt1VICw9Y0fbBnhkYSBnNwfwlsQUiGojv7IAyD3fi6gmBNdeKBtmiaJQSJf4iARPwfQE6QaXG8Q3+h9jH5GHW9LnWMpZ8VuStLaNLR0DQ8l/xU+i/1NX0vZHqaxxzbR5OSfQcDOlz+NxVjXa1uz7h3W8E0zVL6ZLn650OhoFAfPWEf+pdjyixHx2bUMMCzjBCTMhxQ2u792f/WD0Nq1bwwbZ93tifta8KiMc7UPJQUm4dw8Q== jbs@gpolab.bbn.com","ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA0nK/+rVwI+KMRz5t91eT0AsO+VA+SSkXhtjHO/ReECiOFJOY6qa70OTBTHTBnQtVP2gwzpKDVInqPkqzdoujdV9LrPwxawhZVx3CdSDiKtWbSNvWxdKL2Htnq21vULmAWf7qMhGchvRfGANfLg7mDItH7zLcngPks3FOKP2+xiG4JTGL7z5vF9GaZKi7ujaW0VvXHVxQ6aTbsxo1yx8JlV6IYc3L4PqDprTtpBTFcsh4hgVVahOxRY6dUt+eF6vQcNGEqpBQLf1ndH4z9b+eU9gR7Oe7q01+oTWskLL5VDRIHy9XBx6MV20kufmHd9YXeTQBegDJFDhPWZXa4QowIw== jbs@fenris.infersys.com","ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAxRl7mayQ54SDCoQyigPbrgJcwMLbwG47w0aW7bNGHgdjM82emdIi6VXdajI2AK9hJo09UotY1fvCkvCF8bI0zUxF8tvHkTmIAb1pGAsAyjGMly4LR3NhigyB/3GH3scD8YHmDxH5GiCYW+b4dTJ1WbIsksw11w1+bm/jLJfhrvzTkafHJOp3AHu9dwq8COgrlyxEAV2bLnmLOEmpJr6tmX0GNnq0XsISNgcqzvX5UqNa2IFALoro9dlmSkAl+rgZX/QKBI+c3AwoVlVbafT/VRUHbFvcvJGzRX90JEremnB+8UxbPgz1IIfgWgBii4HFyECXb7Yvu3pOTyMsU3DevQ== jbs"]}],"control_mac":"02bed2ecdc92","version":"1","getversion":{'code_tag':'9eec998c9be94ed82cf7e21f5b280368d1af0e59','urn':'urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm','url':'https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am','geni_am_type':'protogeni','geni_single_allocation':true,'geni_allocate':'geni_disjoint','geni_credential_types':{'geni_type':'geni_sfa','geni_version':'2','geni_type':'geni_sfa','geni_version':'3'}},"sliverstatus":{'geni_urn':'urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15632','geni_status':'ready','geni_resources':[{'geni_urn':'urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15631','geni_status':'ready','geni_error':''}]}} |
| 133 | }}} |
| 134 | |
| 135 | Bug: This shouldn't use single quotes, that's not legal JSON. Converted to double quotes: |
| 136 | |
| 137 | {{{ |
| 138 | +$ geni-get --all | sed -e "s/'/\"/g" | python -mjson.tool | sed -e 's/ / /g' |
| 139 | { |
| 140 | "client_id": "bbn-ig-jbs15", |
| 141 | "control_mac": "02bed2ecdc92", |
| 142 | "geni_user": [ |
| 143 | { |
| 144 | "keys": [ |
| 145 | "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAvxWF39ISW4XwXbQ480ZumhPY/t+3hnhS91GxvBU2szCNZa7xvRO56sr7gbZLCD9TvQ+gD3X4W1Iy9pvVNX31EUmT+IKwIu8rwxbGF2Qt1VICw9Y0fbBnhkYSBnNwfwlsQUiGojv7IAyD3fi6gmBNdeKBtmiaJQSJf4iARPwfQE6QaXG8Q3+h9jH5GHW9LnWMpZ8VuStLaNLR0DQ8l/xU+i/1NX0vZHqaxxzbR5OSfQcDOlz+NxVjXa1uz7h3W8E0zVL6ZLn650OhoFAfPWEf+pdjyixHx2bUMMCzjBCTMhxQ2u792f/WD0Nq1bwwbZ93tifta8KiMc7UPJQUm4dw8Q== jbs@gpolab.bbn.com", |
| 146 | "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA0nK/+rVwI+KMRz5t91eT0AsO+VA+SSkXhtjHO/ReECiOFJOY6qa70OTBTHTBnQtVP2gwzpKDVInqPkqzdoujdV9LrPwxawhZVx3CdSDiKtWbSNvWxdKL2Htnq21vULmAWf7qMhGchvRfGANfLg7mDItH7zLcngPks3FOKP2+xiG4JTGL7z5vF9GaZKi7ujaW0VvXHVxQ6aTbsxo1yx8JlV6IYc3L4PqDprTtpBTFcsh4hgVVahOxRY6dUt+eF6vQcNGEqpBQLf1ndH4z9b+eU9gR7Oe7q01+oTWskLL5VDRIHy9XBx6MV20kufmHd9YXeTQBegDJFDhPWZXa4QowIw== jbs@fenris.infersys.com", |
| 147 | "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAxRl7mayQ54SDCoQyigPbrgJcwMLbwG47w0aW7bNGHgdjM82emdIi6VXdajI2AK9hJo09UotY1fvCkvCF8bI0zUxF8tvHkTmIAb1pGAsAyjGMly4LR3NhigyB/3GH3scD8YHmDxH5GiCYW+b4dTJ1WbIsksw11w1+bm/jLJfhrvzTkafHJOp3AHu9dwq8COgrlyxEAV2bLnmLOEmpJr6tmX0GNnq0XsISNgcqzvX5UqNa2IFALoro9dlmSkAl+rgZX/QKBI+c3AwoVlVbafT/VRUHbFvcvJGzRX90JEremnB+8UxbPgz1IIfgWgBii4HFyECXb7Yvu3pOTyMsU3DevQ== jbs" |
| 148 | ], |
| 149 | "urn": "urn:publicid:IDN+ch.geni.net+user+jbs" |
| 150 | } |
| 151 | ], |
| 152 | "getversion": { |
| 153 | "code_tag": "9eec998c9be94ed82cf7e21f5b280368d1af0e59", |
| 154 | "geni_allocate": "geni_disjoint", |
| 155 | "geni_am_type": "protogeni", |
| 156 | "geni_credential_types": { |
| 157 | "geni_type": "geni_sfa", |
| 158 | "geni_version": "3" |
| 159 | }, |
| 160 | "geni_single_allocation": true, |
| 161 | "url": "https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am", |
| 162 | "urn": "urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm" |
| 163 | }, |
| 164 | "slice_email": "slice-jbs15@example.com", |
| 165 | "slice_urn": "urn:publicid:IDN+ch.geni.net:JBS+slice+jbs15", |
| 166 | "sliverstatus": { |
| 167 | "geni_resources": [ |
| 168 | { |
| 169 | "geni_error": "", |
| 170 | "geni_status": "ready", |
| 171 | "geni_urn": "urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15631" |
| 172 | } |
| 173 | ], |
| 174 | "geni_status": "ready", |
| 175 | "geni_urn": "urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+15632" |
| 176 | }, |
| 177 | "user_email": "jbs@bbn.com", |
| 178 | "user_urn": "urn:publicid:IDN+ch.geni.net+user+jbs", |
| 179 | "version": "1" |
| 180 | } |
| 181 | }}} |