diff --git a/howTo/img/rtools_env_pane_h.png b/howTo/img/rtools_env_pane_h.png new file mode 100644 index 0000000000000000000000000000000000000000..dec5179a182359c9319731e62b74f553b4a8d507 Binary files /dev/null and b/howTo/img/rtools_env_pane_h.png differ diff --git a/howTo/img/rtools_env_pane_mydocs.png b/howTo/img/rtools_env_pane_mydocs.png new file mode 100644 index 0000000000000000000000000000000000000000..459d50528881b320b66bb4c0aa62c24fa32042c6 Binary files /dev/null and b/howTo/img/rtools_env_pane_mydocs.png differ diff --git a/howTo/img/rtools_terminal_pane.png b/howTo/img/rtools_terminal_pane.png new file mode 100644 index 0000000000000000000000000000000000000000..8b4444864028446f618219b6221a40f10dff37c4 Binary files /dev/null and b/howTo/img/rtools_terminal_pane.png differ diff --git a/howTo/sve.md b/howTo/sve.md index f7d8a13ed07287b75c51b8e40c867080bfb9a098..d53cb13572fe1badb353597a13ee42a662b985ba 100644 --- a/howTo/sve.md +++ b/howTo/sve.md @@ -6,9 +6,9 @@ A windows [virtual desktop](https://sotonac.sharepoint.com/teams/IT/SitePages/Se The SVE offers two services: - * Win 10 Student service - this one has research & academic software suites such as RStudio etc. But it does **not** have persistence. This means that any packages you install or any repos you clone into your local space will vanish when you log out. The only expection is if you: + * Win 10 Student service - this one has research & academic software suites such as RStudio etc. But it does **not** have persistence. This means that any packages you install or any repos you clone into your local space will vanish when you log out. The only exception is if you: * clone the repos to your MyDocuments/OneDrive account - * work out how to use your Windows profile to 'host' the packages + * work out how to use your Windows profile to 'host' the packages (or do some nifty work with the `renv` package) * Win 10 Staff service - this is a generic staff service intended for admin & professional staff use (for now). While it **does** have persistence, it does **not** have RStudio installed... ## Why would I use the SVE? @@ -25,12 +25,36 @@ But: ## Git -Git is installed - yay! +Git is installed - yay! It does however have some weird behaviour on the SVE to be aware of ... -You will need to create your RSA key so that git (inside or outside RStudio) can talk to github/gitlab etc. This RSA key should now be persistent (it didn't used to be before the SVE upgrade). +### Git authentication + +You will need to create your RSA key so that git (inside or outside RStudio) can talk to github/gitlab etc. This RSA key should now be persistent (it didn't used to be before the SVE upgrade). Alternatively, use https and enter your username and password each session (not a big deal). ## RStudio in SVE +### Using Git within RStudio + +If storing local repositories within your [Documents folder]() on the university filestore. The correct operation of Git witin RStudio on the University network requires some careful working practices with respect to file paths when creating and loading projects. + +Using the University filestore for project (working) files requires use of the mapped file path `filestore (H:)` _<u>not</u>_ the `Documents` shortcut in the `Quick access` group of Windows Explorer. + +While these two paths refer to the same physical location for your documents folder, they are resolved differently i.e. `H:\` vs `\\filestore.soton.ac.uk\users\xxmyusernamexx\mydocuments`. When a project is started in RStudio from the latter location, the Git repository is not recognised correctly. As a result, the `Git` tab will be missing from the Environment pane. + +Loading a project from `Documents` in `Quick access` group, the figure shows no `Git` tab and thus no access to Git processes thru the RStudio IDE: + + + +Loading project from the same folder via `H` (mapped drive), figure shows the `Git` tab is now present and Git commands now accessible: + + + +This problem seems to be limited to the Environment pane within the RStudio IDE as running Git commands through the Terminal (Console pane) pick up the repository correctly (as shown in image below). + + + +So using Git through the Terminal is unaffected by the path used to open the project. + ### Packages See note above re persistence.