From a65b0a52f2685a281ce73b99715d9e34f498740d Mon Sep 17 00:00:00 2001
From: rink <rink@dtu.dk>
Date: Fri, 3 Feb 2017 16:03:22 +0100
Subject: [PATCH] Addressing merge request comments
Specific changes:
1. Updated text regarding Gorm wiki being out of date
2. Restructured mapping of network drive text to have specific
directions but also note to google if they don't work for
you
---
docs/howto-make-dlcs.md | 63 +++++++++++++++++++++++------------------
1 file changed, 36 insertions(+), 27 deletions(-)
diff --git a/docs/howto-make-dlcs.md b/docs/howto-make-dlcs.md
index 61085e0..470dd99 100644
--- a/docs/howto-make-dlcs.md
+++ b/docs/howto-make-dlcs.md
@@ -74,7 +74,9 @@ Connecting to the cluster
We provide here an overview of how to connect to the cluster, but general,
up-to-date information can be found in the [HPC documentation](https://docs.hpc.ait.dtu.dk)
-or on the [Gorm-wiki](http://gorm.risoe.dk/gormwiki).
+or on the [Gorm wiki](http://gorm.risoe.dk/gormwiki). Note that the
+information from the Gorm wiki will be migrated into the HPC documentation
+over time.
You connect to the cluster via an SSH terminal, and there are different SSH
terminals based on your operating system (see the platform-specific
@@ -141,36 +143,43 @@ to the Gorm cluster.
Mounting the cluster discs
--------------------------
-You need to be connected to the DTU network in order for this to work. You can
-also connect to the DTU network over VPN. When doing the HAWC2 simulations, you
-will interact regularly with the cluster file system and discs.
+When doing the HAWC2 simulations, you will interact regularly with the cluster
+file system and discs. Thus, it can be very useful to have two discs mounted
+locally so you can easily access them: 1) your home directory on Gorm and 2)
+the HAWC2 simulation folder on Mimer.
-### Windows
+You need to be connected to the DTU network (either directly or via VPN) for
+the following instructions to work.
-It is convenient to map gorm discs to local network drives on Windows, because
-then you can navigate through different directories in Windows Explorer just
-as you would do with normal folders. You can find instructions for mapping network
-drives for your version of Windows by Googling "map network drive $WIN_VERSION",
-where $WIN_VERSION is your version of windows. As an example, in Windows 7, you
-can map a network drive by right-clicking "Computer" in Windows Explorer and then
-selecting "Map network drive". Be sure to check the "Reconnect at sign-in" box if
-you want to connect to this drive every time you log into your computer.
-
-Map the following network drives (replacing ```$USER``` with your user name)
-to any local drive of your choice (e.g., the ```Y:``` or ```Z:``` drives):
-```
-\\mimer\hawc2sim
-\\gorm\$USER # this is your Gorm home directory
-```
-
-Alternatively, on Windows you can use [WinSCP](http://winscp.net) to interact
-with the cluster discs.
+### Windows
-Note that by default Windows Explorer will hide some of the files you will need edit.
-In order to show all files on your Gorm home drive, you need to un-hide system files:
-Explorer > Organize > Folder and search options > select tab "view" > select the
-option to show hidden files and folders.
+On Windows, we recommend mapping the two drives to local network drives, which
+means that you can navigate/copy/paste to/from them in Windows Explorer just as
+you would do with normal folders on your computer. You may also use [WinSCP](http://winscp.net)
+to interact with the cluster discs if you are more familiar with that option.
+
+Here we provide instructions for mapping network drives in Windows 7. If these
+instructions don't work for you, you can always find directions for your
+version of Windows by Googling "map network drive windows $WIN_VERSION", where
+$WIN_VERSION is your version number.
+
+In Windows 7, you can map a network drive in the following steps:
+1. Open a Windows Explorer window
+2. Right-click on "Computer" and select "Map network drive"
+3. Select any unused drive and type "\\gorm\$USER" into the folder field,
+replacing "$USER" with your DTU username (e.g., DTU user "ABCD" has a Gorm home
+drive of "\\gorm\abcd")
+4. Check the "Reconnect at logon" box if you want to connect to this drive
+every time you log into your computer (recommended)
+5. Click the Finish button
+6. Repeat Steps 1 through 5, replacing the Gorm home address in Step 3 with the
+HAWC2 simulation folder address: "\\mimer\hawc2sim"
+
+Note that by default Windows Explorer will hide some of the files you will need
+edit. In order to show all files on your Gorm home drive, you need to un-hide
+system files: Explorer > Organize > Folder and search options > "View" tab >
+Hidden files and folders > "Show hidden files, folders, and drives".
### Unix
--
GitLab