Some words on how to work with MIB servers

1. Computers description

2. Request an account

3. storage description

4. First login

5. Receiving sequencing data

6. transfering data

7. Submitting jobs

8. Monitor jobs

9. Install tools

Space management

Space usage

Every users should bear in mind that space management is tricky, on one hand it is hard to know how much is needed and on the other hand, it is never enough. The amount of space cannot be infinite (for the time being). However, with a good management it is possible to extend the life span of the available storage and make sure everyone can work. We distinguish 2 types of storage, the administrative storage and the working storage.

Administrative storage

The seq and home folders are administrative partitions and their access is limited. seq is where all the sequencing runs are saved. Only admins can modify the folders in this partition. Which means that only admins can save the sequencing run there. User can see all sequencing runs unless decided otherwise. In the home partition, users have access to their personal folders. These folders should not be used to store any sequencing runs or any output files related to sequencing run analysis or big files in general. Another administrative partition is tools, this folder is only meant to host tools, no data and no databases. Users can install tools via 'conda'. Please address a message to admins to install a tool which is not present on conda.

Working storage

The working storage are projects and work, these two folders are meant to store users projects files. To start working in the work partition, make a personal folder with the same name as your login name. By default, other users can see in that folder but not modify it, feel free to adjust the permissions on your folders. That personal folder will host your analyses. After running your analyses, all users are expected to clean their work space, remove any files/folders that are not useful for the future steps of analyses (intermediate files). After being done with all your analyses, delete any file/folder that is not worth keeping for publications and request a project folder to bioinfo.mib@wur.nl. For those who wants to keep intermediate output files until publication several options are available,

• WUR YODA offers to have some significant amount of space for free.

• Take a look at SurfSara service fees

• You can buy an extra hard drive of 2TB or 4TB or more
• It is also possible to rent space from many providers, WUR, amazon,...

projects partition is meant to host after publication files, the files you have to keep for 10 years and those folder should be kept clean. Make sure to compress all text files using either gzip or bzip2. Gzip is faster and more suitable for non redundant files, you can also use the multithreaded version '''pigz''' to speed up the compression. bzip2 offers a better compression level and takes a bit more time, compression can be accelerated using the multithreaded version '''pbzip2'''. Use bzip2 by default. DO NOT STORE RAW SEQUENCING FILES HERE!

Documentation

Documentation is a very important part of data management, it helps your supervisor and anyone interested in your data knowing what you have already done, what is left to do, where to find the data. Many platforms provide a wiki allowing users to document their work, here are a few options:

gitlab, this is managed by FB-IT @WUR. There is a MIB repository that could also be used jupyter notebook redmine, ask bioinfo.mib@wur.nl for questions galaxy with galaxy pages And many external ones... It is recommended to use internal tools for documentation as they are easily accessible to all and are not subject to external rules.

Databases

Bioinformatics database can be of very significant size, therefore it is recommended to manipulate them with care. A database partition exist, admins will store database of common interest there. More specific databases are temporarily stored in the /work/database partition and removed afterward. The owner of the database must give rights to all users (except for students) after creation of the database. to do that use the following command and scheme chmod -R g+rwx PATH_TO_FOLDER.

Working with sequence files

The point of this section is to raise awareness about the size of the datasets we usually process and to give some ideas of actions we could take to avoid unnecessarily filling up the storage. Sequencing files are diverse and their sizes vary depending on the technology used to generate them and the aim of the project.

Given that any data that is used for publication should respect the FAIR principles, analysis outputs are expected to be reproducible. As long as the previous statement is true, the only files you need to store and keep are the data that are cited in the publication and the raw data as well as a complete description of how to obtain those files (commands and parameters).

=> A good habit to take is to keep individual output files => keep input and output files compressed, most software can deal with compressed files. <(gzip -cd myfile.fastq.gz)

Though the different phases of analyses we are often repeating files or pieces of information contained in those files. A lot of output files carry the same information as the input. For example, a common workflow for metagenomics data is,

1. Raw reads [FASTQ]
2. Remove adapter and bad quality reads, reads with Ns or any other artifacts... [FASTQ]
3. Filter out short reads [FASTQ]
4. Assemble reads [FASTA]
5. Filter out potential short reads and chimeric reads [FASTA]
6. Map raw reads to assembly [BAM]
7. Generate Statistics about assembly and mapping [CSV]
8. Remove unmapped reads [BAM]
9. Identify markers in assembly [FASTA]
10. Bin the assembly [FASTA]
11. Filter out incomplete bins [FASTA]
12. Map raw data on each bins
13. Re-assemble the bins

14. Compute bins quality & make a selection

15. Use markers to taxonomically annotate bins

...

Observations::

The steps 2 and 3 contains a subset of reads from the raw reads files, those output files can also be easily reproduce if sufficient information.

Step 5 outputs a subset of step 4

Step 8 outputs a subset of step 6

Step 9 and 10 outputs a subset from step 4 & 5

Step 11 outputs a subset of step 10

Conclusions::

Many could be learned from the previous scheme we see that any steps can be easily reproduce if we have the information of how each step was made. It usually also do not take a long time to reproduce, if sufficient computational resources the entire workflow can be ran in a day or a day and half.

It is a good habit to check and keep log files generated by programs as they usually contain the parameters and version of software used for processing.

Most (maybe all) of the software used to process the datasets can use Gzipped or Bzipped2 compressed files as input. All users are expected to use compressed files as input as often as possible. The size of the file does not matter.

It is not needed to backup output from intermediate steps for example step 8, the same applies to files steps that can be easily repeated.

In some cases, 1 step is an exact subset of a previous step. For example, the bins generated in step 10 are the exact subset of the raw assembly generated in step 4. In this case and only in this case, it is possible to only save the name of the sequences for each bins. Using a software like seqtk you can easily extract a FASTA file for each bin from the raw assembly

Leaving MIB

Think about tidying up

End of contract is always a tricky period for everyone because there are numerous of things to do and cleaning up your workspace on the server is yet another task that is expected from you. Before leaving all important files (publication related files) should be stored in a project folder under the projects partition. Your folder in the work partition should be left empty. Make sure all files are documented somewhere. Your home folder should also be emptied before you leave.

Student files

Student working with the server are not responsible of the files they create, their supervisors are. Supervisors are expected to assess the quality of their students work and make sure important files are saved to the correct place in the correct way. Students folders should be empty before they leave. A documentation of the student work will be much appreciated by their supervisor.

Other IT related actions to take

In addition,

• your laptop must be returned back to IT.

• Docking station and adapters should be handled to admins (bioinfo.mib@wur.nl).