====== Remote Workspace ======

The Lorentz Institute provides all of its users with access to a virtual workspace which emulates the Institute physical workstations and their custom software setup by means of only a web browser without the installation of plugins or extra software. The immediate advantages to the users are

|Access to the Lorentz Institute workstation setup from the comfort of your laptop, wherever you are, and without VPN or SSH tunnels|
|Access to your documents/files at the Lorentz Institute from a web browser window without installing extra software|
|Access to intranet services as you were physically located in your office|

On this page you will find a short guide to get you started using IL Remote Workspace. The impatient can see these [[https://www.lorentz.leidenuniv.nl/IL-only/ood_videos.html|example videos]] (//accessible via intranet//).
===== Login to Remote Workspace =====

|Browse to https://remote.lorentz.leidenuniv.nl \\ //Any modern browser would do, but Firefox and Chrome are advised//|{{:institute_lorentz:ood1.png?nolink&400|}}|
|Access by using your [[:when_you_are_new_at_the_lorentz_institute#how_to_use_your_lorentz_institute_credentials| Lorentz Institute credentials]] \\ //Your username is the part preceding the ''@'' symbol//| ::: |
|Several failed login attempts will cause your IP to be banned \\ //To unblock your IP address contact the [[https://helpdesk.lorentz.leidenuniv.nl|helpdesk]]//| ::: |
|The __only__ bookmark that will work is https://remote.lorentz.leidenuniv.nl \\ //Other bookmarks will cause login errors//| ::: |




===== Using Remote Workspace =====

==== Dashboard ====

|{{:institute_lorentz:ood2.png?nolink&700|}}| Start/monitor/manage your remote sessions via the Dashboard \\ //View/edit/create/transfer files \\ The system GUI __cannot__ handle large files (max 1GB is advised)//| 
| ::: | Quota information and server status \\ //Do not ignore quota warnings, because many applications rely on free home space to work correctly//| 
| ::: | The server should be able to handle up to 20 concurrent remote sessions \\ //Each interactive session allocates 4 CPUs and 16 GB RAM to a user \\ A user can only request 1 session per time // | 

==== Interactive Apps ====

| Access Interactive Apps via the toolbar ''Interactive Apps'' menu \\ //or via the ''Quick links'' buttons in the Dashboard. Choiches are  \\ - Lorentz Institute Workstation \\ - Jupyter Notebook \\ Workstations are preconfigured with several softwares  // |{{:institute_lorentz:ood7.png?nolink&600|}}|
| An interactive desktop or notebook (session) can last a max of 72 hours \\ //Past that mark, it will be terminated//| ::: |
| Connectons to an unterminated (active) session is always possible \\ //even after logging out by clicking on ''My Interactive sessions'' toolbar menu// | ::: |
|{{ :institute_lorentz:ood10.png?nolink&500 |}}| An interactive session tab reports \\ // - session remaining time \\ - allocated resources \\ - link to debugging files//  |
| ::: | The ''Session ID'' button will open a file browser to the session files \\ //Tune VNC compression and image quality for better experience// | 
| ::: | Active sessions can be terminated by clicking on the ''Delete'' button | 
| Really use a remote workstation as you wish |{{ :institute_lorentz:ood12.png?nolink&600 |}}|
| Launch a terminal \\ //start a screen session within the terminal \\ Note though that any process associated to your session \\ will be terminated if the session is killed// | ::: |
| Launch a browser \\ //browse to IL subscribed journal sites, \\ browse the intranet//  | ::: |

:!: Users who wish to use Jupyter Lab instead of the classic Jupyter Notebook must first launch a notebook and then substitute ''tree'' with ''lab'' in the window URL.

==== Files ====

|{{:institute_lorentz:ood5.png?nolink&1000|}}|Access your files by clicking on the ''Files'' dropdown menu on the toolbar \\ //Different users have access to different file locations//|
| ::: |Seamlessly manage files stored on the IL disks \\ //Transfer files from/to your laptop using the browser \\ No extra software or browser plugins needed//| 
| ::: |The GUI  does __not__ to work well with large files (max 1GB) \\ //Transfer large files from/to using your favorite sftp client to ''ssh.lorentz.leidenuniv.nl''//| 

===== Known issues =====

Please read https://osc.github.io/ood-documentation/master/issues/overview.html