****************** File Systems on M3 ****************** The M3 File System is arranged in 3 parts: - your home directory - your project directory - project scratch space In your home directory you should find a number of symbolic links (``ls -al``). These point to the project space and scratch you have been allocated. You can request additional space via help@massive.org.au For example if your project name is "YourProject001" you will see the following two links: .. code-block:: bash ls -al ~/ YourProject001 -> /projects/YourProject001 YourProject001_scratch -> /scratch/YourProject001 The first link points to your ``project`` data that is backed up daily (as with your ``home`` directory). The second one points to the larger file system ``scratch`` space, which is not backed up and is used for temporary data. What to put on each file system? -------------------------------- That is up to you, but as a general guide: Home directory (~10GB) ====================== This should contain all of your hidden files and configuration files. Things like personal settings for editors and other programs can go here. Project directory (Shared with everyone on your project) ======================================================== This area is backed up but limited in space. It should contain all of your input data, a copy of all your job scripts and final output data. It might be worth while to keep copies of any spreadsheets you might use to analyse results or any ``matlab`` or ``mathematica`` scripts/programs here as well. Basically anything that would be hard to regenerate. Generally each user in the project should create a subdirectory in the project folder for themselves. Scratch directory (Shared with everyone on your project) ======================================================== This area is not backed up. Generally all your intermediate data will go here. Anything that you can recreate by submitting a job script and waiting (even the job runs for quite a long time) can go here. Anything that you can't regenerate automatically, things that you have to think about and create rather than asking the computer to calculate should go in the project directory because that is backed up. Disk Quotas ----------- M3 uses ``soft`` and ``hard`` quota limits. A ``soft`` limit allows you to have more than your allocated space for a short period of "grace" time (in days). After the grace time has been exceeded, the filesystem will prevent further files being added until the excess is removed. A ``hard`` limit prevents further files being added. The quotas on the Project directories are much larger than the space users get in their own Home directories, so it is much better to use the Project space. Also the project space is available for all members of your project, so you can use it to share data with your colleagues. Default Quotas for New Projects ------------------------------- By default, quotas for ``/projects`` directory will be applied as below: - Default projects for Cryo-Electron Microscopy: 5TB - Default project for MX: 5TB - Other projects: 500GB - CVL projects: 50GB Default quota for ``/scratch`` directory is 3TB, except for CVL projects which are 100GB. Please use the ``user_info`` command to view your usage and quota on all your projects and ``/scratch``. If you need higher allocation for project storage spaces, please send your request via quota request form_ or contact help@massive.org.au. .. _form: https://tinyurl.com/massive-m3-quota-request Scratch Usage Policies ---------------------- Demand for scratch space is high so the following policies are now in force to ensure fair access to this high performance resource. Scratch space is only to be used for data that is actively being processed. We can also help make archival storage (such as RDS) available on M3 for integrating into your workflows directly. System Backups and File Recovery -------------------------------- The data storage on M3 is based on Lustre which distributes data across a number of disks and provides a mechanism to manage disk failures. It means that the M3 file system is fault tolerant and provides a high level of data protection. In addition to this, the home directories are backed up to tape every night. This means that if you create a file on Tuesday, on the following day there will be a copy of the file stored in the backup system. Backups are kept for 30 days, before the system permanently removes the file to make space for new data. +------------------------+----------------+----------+--------------+-------------------------------+ | File System | Type | Quota | Policy | How long are backups kept? | +========================+================+==========+==============+===============================+ | Home Directory | NFS | Yes | Daily Backup | 30 days | +------------------------+----------------+----------+--------------+-------------------------------+ | Project Directory | Lustre | Yes | Daily Backup | 30 days | +------------------------+----------------+----------+--------------+-------------------------------+ | Scratch Directory | Lustre | Yes | No | | +------------------------+----------------+----------+--------------+-------------------------------+ File Recovery Procedure ======================= If you delete a file/directory by mistake, you may be able to recover the file by following the following the following procedure: - Email a request to help@massive.org.au. - Please include the the full path to the missing data, as well as information on when it was last seen and when it was deleted - We will be able to restore files modified within the 30 day window. Beyond that time, any changes in the file will be lost. The project scratch space is not backed up. Information for Desktop Users ----------------------------- Desktop users should be aware that many application and Desktop defaults dump data to your home directory. Care must be taken when dealing with large files as these can create large amounts of hidden data and that can cause your home directory to go over quota. The following is some information for solving common issues: Thumbnails Generating Too Much Data =================================== The act of viewing large amounts of images in a file browser cause the generation of many Gigabytes of thumbnail images. To fix: - Go to Applications - System Tools - File Browser - At your File Browser, Go to Edit - Preference - At preference, Go to Preview - At Other Previewable files - Show thumbnails - Change to 'Never' - Ok . Remember to empty your trash folder =================================== Some users may still encounter disk quota full messages when they have already removed many files from their Home directories. Files in the trash folder count towards a user's home directory quota. Ensure that you clear your trash folder when you exit your MASSIVE Desktop Session. Already over quota? =================== If you are over quota, and cannot login via the desktop, you can login using a login shell and use the commands described above in "Tools for Helping Manage Files". If you need higher allocation for project storage spaces, please send your request via quota request form_ or contact help@massive.org.au. .. _form: https://tinyurl.com/massive-m3-quota-request Storage outside of M3 --------------------- With your M3 project, you have an allocation of storage on its high performance Lustre file system. This storage space is intended for data analyses and has a limited capacity. For large-scale, secure, and long-term research data storage, Monash University has the following offerings available through VicNode: - ``Vault`` -- primarily used as archive, is a tape-based system specifically for long-term storage; this is best used to free up space on your M3 project, allowing for more data to be staged into your project for analyses. You can learn more in the `RDSM Confluence Wiki `_, but you will need to be connected to the Monash VPN. - ``Market`` -- is backed-up storage intended for active data sets and is accessible through the Windows, Linux, or Mac desktop environments at your research laboratory for convenient sharing of data files. You can learn more in the `RDSM Confluence Wiki `_, but you will need to be connected to the Monash VPN. All additional storage requests can be lodged with the Research Storage team via the `Data Dashboard `_ or contacting researchdata@monash.edu Instructions to access Market and Vault shares on M3 ===================================================== The ``Market`` allocation is presented as an SMB share with a given name, usually of the form: ``RDS-R--``. This share can be mounted on M3 either by using a Desktop, or via the Data Transfer Node (DTN). 1. If you are accessing shares with the `M3 Desktop `_, open a Terminal window within your Desktop session and move to step 2. If you are accessing shares via the Data Transfer Node (DTN), there are additional steps. First, connect to the DTN on the command line, with the following: .. code-block:: bash ssh @m3-dtn.massive.org.au Once you have connected to the DTN, you will need to run a command to export D-Bus, which will allow you to use the ``gio mount`` command to access your shares. .. code-block:: bash # Run the following to export D-Bus, ensure you have the backticks. export `dbus-launch` 2. Once you have set up either your Desktop Terminal or your DTN access, you can mount your shares with the ``gio mount`` command. .. code-block:: bash gio mount smb://storage.erc.monash.edu.au/shares/ Similarly, for shares on Vault2 .. code-block:: bash gio mount smb://vault-v2.erc.monash.edu.au/ - Replace the ```` with the one provided by your allocation; - Enter your Monash ID (previously known as Authcate) username, when prompted; - Enter ``MONASH`` when prompted to enter the "Domain"; and - Finally, enter your Monash ID password on the "Password" prompt. .. note:: ``gio mount`` is not available on M3 login nodes, use either the DTN or Desktop access methods listed above. 3. If successful, the mounted share will be visible through the file browser. You should be able to find your mounted shares under ``~/.gvfs``. If the user is not a member of the group, an access denied message will be displayed. 4. It is best to cleanly ``unmount`` the share when it is no longer needed, by using this command: .. code-block:: bash gio mount -u smb://storage.erc.monash.edu.au/shares/ .. code-block:: bash gio mount -u smb://vault-v2.erc.monash.edu.au/ However, the share will be automatically unmounted once the desktop session terminates, or you exit your DTN terminal. The collection owner should be able to add and/or remove collaborators who can mount the share through the eSolutions Group Management page: https://groupadmin.monash.edu/. On this page, a list of shares that you have admin privileges for will appear, each of this shares will appear as: ``RDS-R---Shared``. **Important Note:** We are unable to add non-Monash users to mount a share, since this authenticates against the Monash AD. Instructions to access Vault with SFTP and Rsync ================================================= The Vault-V2 has allowed MeRC to extend the protocols available to Vault users. Vault comprises a disk cache frontend and a tape library backend. This is not suited to millions of little files, but is highly effective with tar, zip and squashFS archives. SFTP and RSYNC access is available on a request basis. SSH keys can be used. Users with SSH access to Linux hosts such as M3 DTN can use the command line interactively to launch SFTP or RSYNC applications and use scripts to archive, locate and recall large quantities of data. These methods have slightly different syntax depending on the OS version of Linux. There are issues around the use of the backslash character as part of the MONASH domain declaration. The backslash is also used as a text escape character. There are examples below that use one, two and even three backslash characters in a row to get the desired folder/file path interpreted properly. **SFTP Access** (requires two backslashes MONASH\\ and you will be prompted for your Monash Password) .. code-block:: bash sftp MONASH\\@vault-v2.erc.monash.edu **SFTP to upload data to Vault from M3 login or dtn node** (requires two backslashes MONASH\\) If you already in the working directory, you can simply upload the file .. code-block:: bash sftp> put Or you can specify the destination: .. code-block:: bash sftp> put /home/MONASH\\//vault// **SFTP to retrieve the data from Vault on M3 login or dtn node** (requires three backslashes MONASH\\\) .. code-block:: bash sftp> get /home/MONASH\\\//vault// **Rsync** You can also use RSync to archive a copy of your data to Vault (requires two backslashes MONASH\\) .. code-block:: bash rsync -aHWv --stats --progress // MONASH\\@vault-v2.erc.monash.edu:/vault/ To retrieve your files back from Vault with Rsync: (requires two backslashes MONASH\\) .. code-block:: bash rsync -aHWv --stats --progress MONASH\\@vault-v2.erc.monash.edu:/vault/ //