Changes for page Using JupyterHub in HDC

Last modified by Dennis Segebarth on 2024/10/02 18:14
From version 1.2
edited by Susan Evans
on 2023/07/11 13:40
Change comment: (Autosaved)
To version 1.3
edited by Susan Evans
on 2023/07/11 13:45
Change comment: (Autosaved)

Summary

Details

Page properties
Content
... ... @@ -222,4 +222,109 @@
222 222  1. In the Jupyterhub Terminal, type {{code}}pilotcli{{/code}} to launch the latest version of the Pilot Command Line Interface.
223 223  1. Use the {{code}}pilotcli --help{{/code}} at any time to show the welcome message again.
224 224  
225 +{{code language="none"}}
226 +collaborator4@jupyter-collaborator4:~$ pilotcli
227 +Usage: pilotcli [OPTIONS] COMMAND [ARGS]...
225 225  
229 + What's new (Version 2.2.0):
230 +
231 + 1. CLI supports to perform multi-threading upload for file/folders
232 +
233 + 2. CLI supports to perform resumable upload for single file
234 +
235 +
236 +
237 +Options:
238 + --help Show this message and exit.
239 +
240 +Commands:
241 + container_registry Container Registry Actions.
242 + dataset Dataset Actions.
243 + file File Actions.
244 + project Project Actions.
245 + use_config Config Actions.
246 + user User Actions.
247 +{{/code}}
248 +
249 +== Logging into the Pilot Command Line Interface ==
250 +
251 +Users are required to login with platform credentials before performing any tasks through Pilot Command Line Interface.
252 +
253 +* Use the command {{code}}pilotcli user login{{/code}} to log into the Pilot Command Line Interface.
254 +
255 +{{code language="none"}}
256 +collaborator4@jupyter-collaborator4:~$ pilotcli user login
257 +Please, access https://iam.staging.pilot.indocresearch.com/realms/pilot/device?user_code=XXXX-XXXX to proceed
258 + ▄▄▄▄▄▄▄ ▄ ▄▄ ▄ ▄▄▄▄ ▄ ▄▄▄▄▄▄▄
259 + █ ▄▄▄ █ ▄ ▄███ ▀▀ █▀ ▀██▄ █ ▄▄▄ █
260 + █ ▄ ▀ ▄ ▀▄ ▀▀ ▄█▀▄▀ ▀▀▄█▄▄▀ █████▄▄▀▄
261 + ▄▄▄▄▄▄▄ ▀ ▀█▄ ▀▄ ██▀█ ▄▀▄▄ █ ▄ █▀▄▄▄
262 + █ ▄▄▄ █ █▀█▄▀ █▀ █▀▀█ ▀▄█▄█▄▄▄█▀▄█
263 + █ ███ █ █▀██▀▄ █▀▄▄▀▀█▄▀▀█▄▀█ ▀ ▀▄▀██
264 + █▄▄▄▄▄█ ▄▀▄▄██▄▄▀▄ ▀▀▄ ▄▄▀▀▀▄ █▄▄▄█
265 +
266 + Waiting validation finish...
267 +{{/code}}
268 +
269 +* (((
270 +You’ll be asked to validate your HDC user account using one of the provided methods.
271 +
272 +* Copy and paste the provided validation link into a new browser tab or
273 +* Scan the QR code with your mobile device.
274 +)))
275 +* Open the login window and enter your HDC username and password (i.e. your EBRAINS account credentials).
276 +* Grant access by clicking **Yes**.
277 +
278 +[[image:Pilotcli Jupyter user login Grant Access window v2.4.0 2023-05-25.png||height="46%" width="50%"]]
279 +
280 +[[image:Pilotcli Jupyter user login Device Login Successful v2.4.0 2023-05-25.png||height="16%" width="50%"]]
281 +
282 +* After successful confirmation, return to the terminal in your JupyterHub browser tab.
283 +
284 +{{code language="none"}}
285 +Welcome to the Command Line Tool!
286 +{{/code}}
287 +
288 +* You’re now ready to start using the Pilot Command Line Interface to work with your Project data in JupyterHub.
289 +
290 +== Zone Restrictions when using Pilot Command Line Interface in JupyterHub ==
291 +
292 +When using the Pilot Command Line Interface in JupyterHub and the following actions are possible on the derivative files generated in JupyterHub:
293 +
294 +{table}
295 +**File Operation** | **Permitted in the **
296 +**Green Room**
297 +Word 1 | Word 2
298 +{table}
299 +
300 +|=(% colspan="1" rowspan="1" %)(((
301 +**File Operation**
302 +
303 +
304 +)))|=(% colspan="1" rowspan="1" %)(((
305 +**Permitted in the **
306 +**Green Room**
307 +
308 +
309 +)))|=(% colspan="1" rowspan="1" %)(((
310 +**Permitted in the **
311 +**Core**
312 +
313 +
314 +)))
315 +|(% colspan="1" rowspan="1" %)File upload 
316 +(upload derivative output files from JupyterHub to the Green Room or Core storage)|(% colspan="1" rowspan="1" %)(((
317 +Yes
318 +)))|(% colspan="1" rowspan="1" %)(((
319 +Yes
320 +)))
321 +|(% colspan="1" rowspan="1" %)File download
322 +(download files from Green Room or Core into JupyterHub)|(% colspan="1" rowspan="1" %)(((
323 +**No**
324 +)))|(% colspan="1" rowspan="1" %)(((
325 +Yes
326 +)))
327 +
328 +
329 +
330 +
Pilotcli Jupyter user login Device Login Successful v2.4.0 2023-05-25.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +10.3 KB
Content
Pilotcli Jupyter user login Grant Access window v2.4.0 2023-05-25.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content