RE #27331 Add archive mounting instructions for linux

dev-docs/source/GettingStarted.rst

@@ -131,8 +131,8 @@ Archive access
 ##############
 
 It is very convenient to be able to access the data archive directly.
-At ISIS, this is automatically done on the Windows machines, however OSX
-requires some extra setup.
+At ISIS, this is automatically done on the Windows machines, however OSX and Linux
+require some extra setup.
 
 OSX
 ---
@@ -144,3 +144,49 @@ OSX
 * It can be found at `/Volumes/inst$`
 
 **NB** the address in step 2 sometimes changes - if it does not work, replace `80` with `55` or `3`.
+
+Linux
+------
+1. Install packages:
+
+* ``autofs``
+* ``smbfs`` - Ubuntu 12.04
+* ``cifs-utils`` - Ubuntu 14.04
+
+2. Create an ``/archive.creds`` file in the root directory containing this, filling in the relevant details:
+
+This should only be done if full disk encryption is enabled or if the ``archive.creds`` file is stored in a secure (encrypted) location; to ensure passwords are kept safe.
+
+.. code-block:: text
+
+   username=FEDERAL_ID_HERE
+   password=FED_PASSWD_HERE
+   domain=CLRC
+
+3. Edit ``/etc/auto.master`` and add the line:
+
+.. code-block:: text
+
+   /archive      /etc/auto.archive
+
+4. Create ``/etc/auto.archive`` and add the single line:
+
+.. code-block:: text
+
+   *     -fstype=cifs,ro,credentials=/archive.creds,file_mode=0444,dir_mode=0555       ://isisdatar55/&\$
+
+5. Enter the following commands:
+
+.. code-block:: bash
+
+   sudo chmod 400 /archive.creds
+   sudo mkdir /archive
+   service autofs restart
+
+Done. You can now access directories in the archive. Test it by doing:
+
+.. code-block:: bash
+
+   ls /archive/ndxalf
+
+If it's working the command should return ``ls: cannot access '/archive/ndxalf/DfsrPrivate': Permission denied``