Zone Restrictions with pilotcli
- Mojib Javadi
- Omer Kleiner
The Pilot Command Line Interface (pilotcli) is available for download for use on a user’s local machine, and is available within Workspace Virtual Machines (VMs) that are deployed on the Pilot platform. Pilotcli is available natively in JupyterHub Pilot Workspace VMs, and as extension resource within each Guacamole-connected Pilot Workspace VM. Inside Workspace VMs, the file operations permitted by the Pilot Command Line Interface depend on whether the VM is physically deployed in the Green Room or Core Zone. For more information on Pilot Project Zones, please see: Getting Started.
Please note that while Pilot provides mechanisms to prevent cross-zone transfers, Pilot does not provide all technical means for stopping this. Users should always process data according to the workflow outlined in their research protocol, data management plan, privacy impact assessment, or other approved work plan.
pilotcli in Core Virtual Machines & JupyterHub
After launching the Pilot Command Line Interface in a Core VM or JupyterHub, the following actions are possible:
File Operation | Permitted in the | Permitted in the |
|---|---|---|
File upload | Yes | Yes |
File download | No | Yes |
Files from the Green Room are not able to be downloaded to a Core VM or JupyterHub. If you require access to a Green Room file, it will need to be copied to the Core by a user with Copy to Core permissions.
pilotcli in Green Room Virtual Machine
If your Project has a Green Room VM set up, the following actions are possible when using the Pilot Command Line Interface in the Green Room VM.
File Operation | Permitted in the | Permitted in the |
|---|---|---|
File upload | Yes | No |
File download | Yes | No |
Files from the Core are not able to be downloaded to a Green Room VM. If you require access to a Core file, please use JupyterHub or a Core VM.
Restrictions Outside of Pilot Workspace VMs
The Pilot Command Line Interface doesn’t allow upload any files/folders to the Core zone when launched outside Guacamole-connected Workspace VMs. Please upload all files to the Green Room from external locations or VMs.
File Operation | Permitted in the | Permitted in the |
|---|---|---|
File upload | Yes | No |
File download | Yes | Yes |
Related articles