Skip to content

Commit

Permalink
Merge "Add instructions to compress folders and sudo apt update. Text…
Browse files Browse the repository at this point in the history
… and syntax updates throughout."
  • Loading branch information
Sam Morrison authored and Gerrit Code Review committed Jul 1, 2024
2 parents 85d805a + 7888dc7 commit 20dcc2f
Showing 1 changed file with 41 additions and 25 deletions.
66 changes: 41 additions & 25 deletions _virtual-desktop-service/03-general-tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,78 +4,94 @@ order: 3
duration: 1
---

Let's open your Desktop for the first time! Click the green `Open Desktop` button.
Let's open your Desktop for the first time! Click the green `OPEN DESKTOP` button.

![Open Desktop button]({{ site.baseurl }}/assets/images/virtual-desktop-service/update_desktop_button.PNG)

Now you will see a desktop environment, with some similarities to what you know with your standard computer. You have a taskbar at the top, a menu button to access applications, and folders on your desktop itself.
Now you will see a desktop environment, with some similarities to your standard computer. There is a taskbar at the top, a menu button in the top-left corner to access applications, and folders on the desktop background.

![desktop map]({{ site.baseurl }}/assets/images/virtual-desktop-service/full-vdi.PNG)

#### Finding programs
### Finding programs

To find programs you can navigate via the menu button called `Applications` in the top left corner. You have the basics, like an Internet Browser, Terminal and Office suite. Let's open the Terminal. It should be the second option under `Applications`.
To find programs you can navigate via the menu button called `Applications` in the top left corner. You have the basics, like an Internet Browser, Terminal and Office suite.

Let's open the Terminal. It should be the second option under `Applications`.

![terminal-select]({{ site.baseurl }}/assets/images/virtual-desktop-service/select_terminal.PNG)

Once you've opened the Terminal, you can type in commands as normal. One good command to know, even if you haven't used the terminal before is:
Once you have opened the Terminal, you can enter commands. Two good commands to know are:

```bash
sudo apt update
```
sudo apt-get upgrade

and

```bash
sudo apt upgrade
```

In a nutshell, this command tells your virtual desktop two things:
- `sudo` elevates you to administrator priviledges
- `apt-get upgrade` is telling your computer to check for upgrades
To understand these commands, consider their components:

- `sudo` stands for 'superuser do', and elevates you to administrator privileges.
- `apt update` tells the computer to check for updates to packages.
- `apt upgrade` tells the computer to check for upgrades and install newer versions.

If there are updates available, you will be asked if you want to install them, and you can respond with typing a `y` into the Terminal and hitting the `enter` key.
If there are upgrades available, you will be asked if you want to install them, and you can respond by typing `y` into the Terminal and pressing the `Enter` key on your keyboard.

**Call Security!** 🚨
It is good security practice to check for updates. You should do this each day you log into the Desktop for the first time. This ensures you have the latest Security patches. There is further information on our Security Guidelines [here](https://support.ehelp.edu.au/a/solutions/articles/6000253768).
It is good security practice to check for upgrades. You should do this each day you log into the Desktop for the first time. This ensures you have the latest Security patches. There is further information on our [Security Checklist](https://support.ehelp.edu.au/a/solutions/articles/6000253768).
{: .callout-warning}

#### Copy and Pasting
### Copying and Pasting

Copy and pasting should work as normal, between your local computer and the Virtual Desktop. However, we are aware of a few minor anomalies:
- If you are using a Mac, you would use your `Commmand` key as normal when copying from your local computer, but use `Ctrl` instead when pasting to the Virtual Desktop.
- When using Firefox browser and the NeuroDesktop, there are extra steps required to ensure the copy/paste function works. Instructions can be found [here](https://www.neurodesk.org/docs/overview/faq/#copying-text-from-my-host-computer-and-pasting-it-inside-neurodesktop-doesnt-work-in-firefox).
Copying and pasting text between your local computer and the Virtual Desktop should work as expected. However, we are aware of a few minor anomalies:

#### Moving files
- If you are using a Mac, use your `Commmand` key as normal when copying from your local computer, but use `Ctrl` instead when pasting to the Virtual Desktop.
- When using Firefox browser and the Neurodesktop, there are extra steps required to ensure the copy/paste function works. Instructions can be found on the [Neurodesk FAQ](https://www.neurodesk.org/docs/overview/faq/#copying-text-from-my-host-computer-and-pasting-it-inside-neurodesktop-doesnt-work-in-firefox).

Moving files back and forth is easy! All you have to do, is drag and drop between you local computer and the Virtual Desktop window.
### Transferring files

Try it now! Drag and Drop something to the desktop. You will see in the bottom right hand corner, a box will appear with the name of your file you transfered.
To transfer files from your local computer to the Virtual Desktop, drag them from your computer and drop them into the Virtual Desktop window.

When you do this, a box will appear in the bottom-right cornder with the name of your file you transferred.

![file transfer]({{ site.baseurl }}/assets/images/virtual-desktop-service/file_transfer.PNG)

But, you may be wondering where the actual file went! Doesn't matter where you drag and drop your file, whether it's to the desktop or a particular folder, it will always go to the `thinclient_drives` first (it's like a USB in the file explorer!).
**Transferring folders**
If you want to transfer a folder from your local computer onto the Virtual Desktop, you will first need to compress it into a zipped file. To compress a folder on Mac, right-click on the folder and select `Compress`. To compress a folder on Windows, right-click on the folder and select `Send to` then select `Compressed (zipped) folder`. Once you have dragged the compressed folder onto the Virtual Desktop, you can unzip it by right-clicking on the .zip file, and selecting `Extract Here` or `Extract To...`
{: .callout-info}

Where did the file go? It doesn't matter where you drag and drop your file, whether it's to the desktop or a particular folder, it will always go to `thinclient_drives` (it acts like a USB in the file explorer).

#### Navigating to the added files

**To navigate to the files you added:**
1. Open the `File System` folder on your Desktop
1. Open the `File System` folder on the Virtual Desktop

![file system]({{ site.baseurl }}/assets/images/virtual-desktop-service/file_system.PNG)

1. On the left hand side, under `Devices`, select `thinclient_drives`, then open the `GUACFS` folder.

![devices/thinclient]({{ site.baseurl }}/assets/images/virtual-desktop-service/thin_client_drive.png)

1. Here you should see the file(s) you transferred.
1. Here you should see any files or (zipped) folders you transferred.

![success file transferred]({{ site.baseurl }}/assets/images/virtual-desktop-service/success_file.PNG)

Now, you can move this to where ever you want to store this, for example, your `Documents` folder. You can do this any way you normally would on your computer, whether its drag and drop or copy and paste etc.
You can move files and folders to anywhere you want to store them on the Virtual Desktop, in the same ways you would move files on your computer. For example, you can drag and drop a file into the `Documents` folder.

**Note**
It is important to move your files from the `GUACFS` directory into your Virtual Desktop, as this location is only for file transfer and your files are not guaranteed to persist there.
{: .callout-danger}

**To download a file to your local desktop:**
#### Downloading a file from the Virtual Desktop to your local computer

1. Navigate to `Devices`, `thinclient_drives`, then open the `GUACFS` folder.

1. Drag and drop your file onto the `Download` folder. This will immediately begin the download
process within the browser.

**You're up and running!**
Well done. You've accessed your Desktop for the first time, opened applications, and learnt how to move files back and forth. In the next [tutorial]({{ site.baseurl }}/virtual-desktop-service/04-managing-desktop) we will learn about how to manage your desktop.
Well done. You have accessed your Virtual Desktop for the first time, opened applications, and learnt how to move files back and forth. In the next [tutorial]({{ site.baseurl }}/virtual-desktop-service/04-managing-desktop) we will learn about how to manage your Virtual Desktop.
{: .callout-success}

0 comments on commit 20dcc2f

Please sign in to comment.