formatting style

.gitlab-ci.yml

@@ -9,7 +9,7 @@ docs:
   image: davidhrbac/docker-mdcheck:latest
   allow_failure: true
   script:
-  - mdl -r ~MD013 *.md docs.it4i/
+  - mdl -r ~MD013,~MD033,~MD014 *.md docs.it4i/
 
 two spaces:
   stage: test

docs.it4i/anselm-cluster-documentation/compute-nodes.md

-Compute Nodes
-=============
+# Compute Nodes
+
+## Nodes Configuration
 
-Nodes Configuration
--------------------
 Anselm is cluster of x86-64 Intel based nodes built on Bull Extreme Computing bullx technology. The cluster contains four types of compute nodes.
 
 ### Compute Nodes Without Accelerator
 
--    180 nodes
--    2880 cores in total
--    two Intel Sandy Bridge E5-2665, 8-core, 2.4GHz processors per node
--    64 GB of physical memory per node
--    one 500GB SATA 2,5” 7,2 krpm HDD per node
--    bullx B510 blade servers
--    cn[1-180]
+* 180 nodes
+* 2880 cores in total
+* two Intel Sandy Bridge E5-2665, 8-core, 2.4GHz processors per node
+* 64 GB of physical memory per node
+* one 500GB SATA 2,5” 7,2 krpm HDD per node
+* bullx B510 blade servers
+* cn[1-180]
 
 ### Compute Nodes With GPU Accelerator
 
--    23 nodes
--    368 cores in total
--    two Intel Sandy Bridge E5-2470, 8-core, 2.3GHz processors per node
--    96 GB of physical memory per node
--    one 500GB SATA 2,5” 7,2 krpm HDD per node
--    GPU accelerator 1x NVIDIA Tesla Kepler K20 per node
--    bullx B515 blade servers
--    cn[181-203]
+* 23 nodes
+* 368 cores in total
+* two Intel Sandy Bridge E5-2470, 8-core, 2.3GHz processors per node
+* 96 GB of physical memory per node
+* one 500GB SATA 2,5” 7,2 krpm HDD per node
+* GPU accelerator 1x NVIDIA Tesla Kepler K20 per node
+* bullx B515 blade servers
+* cn[181-203]
 
 ### Compute Nodes With MIC Accelerator
 
--    4 nodes
--    64 cores in total
--    two Intel Sandy Bridge E5-2470, 8-core, 2.3GHz processors per node
--    96 GB of physical memory per node
--    one 500GB SATA 2,5” 7,2 krpm HDD per node
--    MIC accelerator 1x Intel Phi 5110P per node
--    bullx B515 blade servers
--    cn[204-207]
+* 4 nodes
+* 64 cores in total
+* two Intel Sandy Bridge E5-2470, 8-core, 2.3GHz processors per node
+* 96 GB of physical memory per node
+* one 500GB SATA 2,5” 7,2 krpm HDD per node
+* MIC accelerator 1x Intel Phi 5110P per node
+* bullx B515 blade servers
+* cn[204-207]
 
 ### Fat Compute Nodes
 
--    2 nodes
--    32 cores in total
--    2 Intel Sandy Bridge E5-2665, 8-core, 2.4GHz processors per node
--    512 GB of physical memory per node
--    two 300GB SAS 3,5”15krpm HDD (RAID1) per node
--    two 100GB SLC SSD per node
--    bullx R423-E3 servers
--    cn[208-209]
+* 2 nodes
+* 32 cores in total
+* 2 Intel Sandy Bridge E5-2665, 8-core, 2.4GHz processors per node
+* 512 GB of physical memory per node
+* two 300GB SAS 3,5”15krpm HDD (RAID1) per node
+* two 100GB SLC SSD per node
+* bullx R423-E3 servers
+* cn[208-209]
 
 ![](../img/bullxB510.png)
-
 **Figure Anselm bullx B510 servers**
 
 ### Compute Nodes Summary
@@ -61,31 +59,29 @@ Anselm is cluster of x86-64 Intel based nodes built on Bull Extreme Computing bu
   |Nodes with MIC accelerator|4|cn[204-207]|96GB|16 @ 2.3GHz|qmic, qprod|
   |Fat compute nodes|2|cn[208-209]|512GB|16 @ 2.4GHz|qfat, qprod|
 
-Processor Architecture
-----------------------
+## Processor Architecture
+
 Anselm is equipped with Intel Sandy Bridge processors Intel Xeon E5-2665 (nodes without accelerator and fat nodes) and Intel Xeon E5-2470 (nodes with accelerator). Processors support Advanced Vector Extensions (AVX) 256-bit instruction set.
 
 ### Intel Sandy Bridge E5-2665 Processor
 
--   eight-core
--   speed: 2.4 GHz, up to 3.1 GHz using Turbo Boost Technology
--   peak performance:  19.2 GFLOP/s per
-    core
--   caches:
-    -   L2: 256 KB per core
-    -   L3: 20 MB per processor
--   memory bandwidth at the level of the processor: 51.2 GB/s
+* eight-core
+* speed: 2.4 GHz, up to 3.1 GHz using Turbo Boost Technology
+* peak performance:  19.2 GFLOP/s per core
+* caches:
+  * L2: 256 KB per core
+  * L3: 20 MB per processor
+* memory bandwidth at the level of the processor: 51.2 GB/s
 
 ### Intel Sandy Bridge E5-2470 Processor
 
--   eight-core
--   speed: 2.3 GHz, up to 3.1 GHz using Turbo Boost Technology
--   peak performance:  18.4 GFLOP/s per
-    core
--   caches:
-    -   L2: 256 KB per core
-    -   L3: 20 MB per processor
--   memory bandwidth at the level of the processor: 38.4 GB/s
+* eight-core
+* speed: 2.3 GHz, up to 3.1 GHz using Turbo Boost Technology
+* peak performance:  18.4 GFLOP/s per core
+* caches:
+  * L2: 256 KB per core
+  * L3: 20 MB per processor
+* memory bandwidth at the level of the processor: 38.4 GB/s
 
 Nodes equipped with Intel Xeon E5-2665 CPU have set PBS resource attribute cpu_freq = 24, nodes equipped with Intel Xeon E5-2470 CPU have set PBS resource attribute cpu_freq = 23.
 
@@ -101,35 +97,34 @@ Intel Turbo Boost Technology is used by default,  you can disable it for all nod
     $ qsub -A OPEN-0-0 -q qprod -l select=4:ncpus=16 -l cpu_turbo_boost=0 -I
 ```
 
-Memory Architecture
--------------------
+## Memory Architecture
 
 ### Compute Node Without Accelerator
 
--   2 sockets
--   Memory Controllers are integrated into processors.
-    -   8 DDR3 DIMMs per node
-    -   4 DDR3 DIMMs per CPU
-    -   1 DDR3 DIMMs per channel
-    -   Data rate support: up to 1600MT/s
--   Populated memory: 8 x 8 GB DDR3 DIMM 1600 MHz
+* 2 sockets
+* Memory Controllers are integrated into processors.
+  * 8 DDR3 DIMMs per node
+  * 4 DDR3 DIMMs per CPU
+  * 1 DDR3 DIMMs per channel
+  * Data rate support: up to 1600MT/s
+* Populated memory: 8 x 8 GB DDR3 DIMM 1600 MHz
 
 ### Compute Node With GPU or MIC Accelerator
 
--   2 sockets
--   Memory Controllers are integrated into processors.
-    -   6 DDR3 DIMMs per node
-    -   3 DDR3 DIMMs per CPU
-    -   1 DDR3 DIMMs per channel
-    -   Data rate support: up to 1600MT/s
--   Populated memory: 6 x 16 GB DDR3 DIMM 1600 MHz
+* 2 sockets
+* Memory Controllers are integrated into processors.
+  * 6 DDR3 DIMMs per node
+  * 3 DDR3 DIMMs per CPU
+  * 1 DDR3 DIMMs per channel
+  * Data rate support: up to 1600MT/s
+* Populated memory: 6 x 16 GB DDR3 DIMM 1600 MHz
 
 ### Fat Compute Node
 
--   2 sockets
--   Memory Controllers are integrated into processors.
-    -   16 DDR3 DIMMs per node
-    -   8 DDR3 DIMMs per CPU
-    -   2 DDR3 DIMMs per channel
-    -   Data rate support: up to 1600MT/s
--   Populated memory: 16 x 32 GB DDR3 DIMM 1600 MHz
+* 2 sockets
+* Memory Controllers are integrated into processors.
+  * 16 DDR3 DIMMs per node
+  * 8 DDR3 DIMMs per CPU
+  * 2 DDR3 DIMMs per channel
+  * Data rate support: up to 1600MT/s
+* Populated memory: 16 x 32 GB DDR3 DIMM 1600 MHz

docs.it4i/anselm-cluster-documentation/introduction.md

-Introduction
-============
+# Introduction
 
 Welcome to Anselm supercomputer cluster. The Anselm cluster consists of 209 compute nodes, totaling 3344 compute cores with 15 TB RAM and giving over 94 TFLOP/s theoretical peak performance. Each node is a powerful x86-64 computer, equipped with 16 cores, at least 64 GB RAM, and 500 GB hard disk drive. Nodes are interconnected by fully non-blocking fat-tree InfiniBand network and equipped with Intel Sandy Bridge processors. A few nodes are also equipped with NVIDIA Kepler GPU or Intel Xeon Phi MIC accelerators. Read more in [Hardware Overview](hardware-overview/).
 
-The cluster runs bullx Linux ([bull](http://www.bull.com/bullx-logiciels/systeme-exploitation.html)) [operating system](software/operating-system/), which is compatible with the  RedHat [ Linux family.](http://upload.wikimedia.org/wikipedia/commons/1/1b/Linux_Distribution_Timeline.svg) We have installed a wide range of software packages targeted at different scientific domains. These packages are accessible via the [modules environment](environment-and-modules/).
+The cluster runs [operating system](software/operating-system/), which is compatible with the  RedHat [Linux family.](http://upload.wikimedia.org/wikipedia/commons/1/1b/Linux_Distribution_Timeline.svg) We have installed a wide range of software packages targeted at different scientific domains. These packages are accessible via the [modules environment](environment-and-modules/).
 
 User data shared file-system (HOME, 320 TB) and job data shared file-system (SCRATCH, 146 TB) are available to users.
 
 The PBS Professional workload manager provides [computing resources allocations and job execution](resources-allocation-policy/).
 
 Read more on how to [apply for resources](../get-started-with-it4innovations/applying-for-resources/), [obtain login credentials,](../get-started-with-it4innovations/obtaining-login-credentials/obtaining-login-credentials/) and [access the cluster](shell-and-data-access/).
-

docs.it4i/anselm-cluster-documentation/job-submission-and-execution.md

-Job submission and execution
-============================
+# Job submission and execution
+
+## Job Submission
 
-Job Submission
---------------
 When allocating computational resources for the job, please specify
 
 1. suitable queue for your job (default is qprod)
-2.  number of computational nodes required
-3.  number of cores per node required
-4.  maximum wall time allocated to your calculation, note that jobs exceeding maximum wall time will be killed
-5.  Project ID
-6.  Jobscript or interactive switch
+1. number of computational nodes required
+1. number of cores per node required
+1. maximum wall time allocated to your calculation, note that jobs exceeding maximum wall time will be killed
+1. Project ID
+1. Jobscript or interactive switch
 
 !!! Note "Note"
     Use the **qsub** command to submit your job to a queue for allocation of the computational resources.
@@ -61,8 +60,7 @@ By default, the PBS batch system sends an e-mail only when the job is aborted. D
 $ qsub -m n
 ```
 
-Advanced job placement
-----------------------
+## Advanced job placement
 
 ### Placement by name
 
@@ -103,8 +101,7 @@ We recommend allocating compute nodes of a single switch when best possible comp
 
 In this example, we request all the 18 nodes sharing the isw11 switch for 24 hours. Full chassis will be allocated.
 
-Advanced job handling
----------------------
+## Advanced job handling
 
 ### Selecting Turbo Boost off
 
@@ -133,8 +130,8 @@ The MPI processes will be distributed differently on the nodes connected to the
 
 Although this example is somewhat artificial, it demonstrates the flexibility of the qsub command options.
 
-Job Management
---------------
+## Job Management
+
 !!! Note "Note"
     Check status of your jobs using the **qstat** and **check-pbs-jobs** commands
 
@@ -237,8 +234,7 @@ Learn more by reading the pbs man page
 $ man pbs_professional
 ```
 
-Job Execution
--------------
+## Job Execution
 
 ### Jobscript
 

docs.it4i/anselm-cluster-documentation/prace.md

-PRACE User Support
-==================
+# PRACE User Support
+
+## Intro
 
-Intro
------
 PRACE users coming to Anselm as to TIER-1 system offered through the DECI calls are in general treated as standard users and so most of the general documentation applies to them as well. This section shows the main differences for quicker orientation, but often uses references to the original documentation. PRACE users who don't undergo the full procedure (including signing the IT4I AuP on top of the PRACE AuP) will not have a password and thus access to some services intended for regular users. This can lower their comfort, but otherwise they should be able to use the TIER-1 system as intended. Please see the [Obtaining Login Credentials section](../get-started-with-it4innovations/obtaining-login-credentials/obtaining-login-credentials/), if the same level of access is required.
 
 All general [PRACE User Documentation](http://www.prace-ri.eu/user-documentation/) should be read before continuing reading the local documentation here.
 
-Help and Support
---------------------
+## Help and Support
+
 If you have any troubles, need information, request support or want to install additional software, please use [PRACE Helpdesk](http://www.prace-ri.eu/helpdesk-guide264/).
 
 Information about the local services are provided in the [introduction of general user documentation](introduction/). Please keep in mind, that standard PRACE accounts don't have a password to access the web interface of the local (IT4Innovations) request tracker and thus a new ticket should be created by sending an e-mail to support[at]it4i.cz.
 
-Obtaining Login Credentials
----------------------------
+## Obtaining Login Credentials
+
 In general PRACE users already have a PRACE account setup through their HOMESITE (institution from their country) as a result of rewarded PRACE project proposal. This includes signed PRACE AuP, generated and registered certificates, etc.
 
 If there's a special need a PRACE user can get a standard (local) account at IT4Innovations. To get an account on the Anselm cluster, the user needs to obtain the login credentials. The procedure is the same as for general users of the cluster, so please see the corresponding section of the general documentation here.
 
-Accessing the cluster
----------------------
+## Accessing the cluster
 
 ### Access with GSI-SSH
 
@@ -30,11 +28,11 @@ The user will need a valid certificate and to be present in the PRACE LDAP (plea
 
 Most of the information needed by PRACE users accessing the Anselm TIER-1 system can be found here:
 
--   [General user's FAQ](http://www.prace-ri.eu/Users-General-FAQs)
--   [Certificates FAQ](http://www.prace-ri.eu/Certificates-FAQ)
--   [Interactive access using GSISSH](http://www.prace-ri.eu/Interactive-Access-Using-gsissh)
--   [Data transfer with GridFTP](http://www.prace-ri.eu/Data-Transfer-with-GridFTP-Details)
--   [Data transfer with gtransfer](http://www.prace-ri.eu/Data-Transfer-with-gtransfer)
+* [General user's FAQ](http://www.prace-ri.eu/Users-General-FAQs)
+* [Certificates FAQ](http://www.prace-ri.eu/Certificates-FAQ)
+* [Interactive access using GSISSH](http://www.prace-ri.eu/Interactive-Access-Using-gsissh)
+* [Data transfer with GridFTP](http://www.prace-ri.eu/Data-Transfer-with-GridFTP-Details)
+* [Data transfer with gtransfer](http://www.prace-ri.eu/Data-Transfer-with-gtransfer)
 
 Before you start to use any of the services don't forget to create a proxy certificate from your certificate:
 
@@ -116,8 +114,8 @@ If the user uses GSI SSH based access, then the procedure is similar to the SSH
 
 After successful obtainment of login credentials for the local IT4Innovations account, the PRACE users can access the cluster as regular users using SSH. For more information please see the section in general documentation.
 
-File transfers
-------------------
+## File transfers
+
 PRACE users can use the same transfer mechanisms as regular users (if they've undergone the full registration procedure). For information about this, please see the section in the general documentation.
 
 Apart from the standard mechanisms, for PRACE users to transfer data to/from Anselm cluster, a GridFTP server running Globus Toolkit GridFTP service is available. The service is available from public Internet as well as from the internal PRACE network (accessible only from other PRACE partners).
@@ -199,8 +197,8 @@ Generally both shared file systems are available through GridFTP:
 
 More information about the shared file systems is available [here](storage/).
 
-Usage of the cluster
---------------------
+## Usage of the cluster
+
 There are some limitations for PRACE user when using the cluster. By default PRACE users aren't allowed to access special queues in the PBS Pro to have high priority or exclusive access to some special equipment like accelerated nodes and high memory (fat) nodes. There may be also restrictions obtaining a working license for the commercial software installed on the cluster, mostly because of the license agreement or because of insufficient amount of licenses.
 
 For production runs always use scratch file systems, either the global shared or the local ones. The available file systems are described [here](hardware-overview/).

docs.it4i/anselm-cluster-documentation/resources-allocation-policy.md

-Resources Allocation Policy
-===========================
+# Resources Allocation Policy
+
+## Introduction
 
-Resources Allocation Policy
----------------------------
 The resources are allocated to the job in a fair-share fashion, subject to constraints set by the queue and resources available to the Project. The Fair-share at Anselm ensures that individual users may consume approximately equal amount of resources per week. Detailed information in the [Job scheduling](job-priority/) section. The resources are accessible via several queues for queueing the jobs. The queues provide prioritized and exclusive access to the computational resources. Following table provides the queue partitioning overview:
 
 !!! Note "Note"
-	Check the queue status at https://extranet.it4i.cz/anselm/
+    Check the queue status at [https://extranet.it4i.cz/anselm/](https://extranet.it4i.cz/anselm/)
 
 |queue|active project|project resources|nodes|min ncpus|priority|authorization|walltime|
 |---|---|---|---|---|---|---|---|
@@ -21,11 +20,11 @@ The resources are allocated to the job in a fair-share fashion, subject to const
 
 **The qexp queue is equipped with the nodes not having the very same CPU clock speed.** Should you need the very same CPU speed, you have to select the proper nodes during the PSB job submission.
 
-- **qexp**, the Express queue: This queue is dedicated for testing and running very small jobs. It is not required to specify a project to enter the qexp. There are 2 nodes always reserved for this queue (w/o accelerator), maximum 8 nodes are available via the qexp for a particular user, from a pool of nodes containing Nvidia accelerated nodes (cn181-203), MIC accelerated nodes (cn204-207) and Fat nodes with 512GB RAM (cn208-209). This enables to test and tune also accelerated code or code with higher RAM requirements. The nodes may be allocated on per core basis. No special authorization is required to use it. The maximum runtime in qexp is 1 hour.
-- **qprod**, the Production queue: This queue is intended for normal production runs. It is required that active project with nonzero remaining resources is specified to enter the qprod. All nodes may be accessed via the qprod queue, except the reserved ones. 178 nodes without accelerator are included. Full nodes, 16 cores per node are allocated. The queue runs with medium priority and no special authorization is required to use it. The maximum runtime in qprod is 48 hours.
-- **qlong**, the Long queue: This queue is intended for long production runs. It is required that active project with nonzero remaining resources is specified to enter the qlong. Only 60 nodes without acceleration may be accessed via the qlong queue. Full nodes, 16 cores per node are allocated. The queue runs with medium priority and no special authorization is required to use it. The maximum runtime in qlong is 144 hours (three times of the standard qprod time - 3 * 48 h).
-- **qnvidia**, qmic, qfat, the Dedicated queues: The queue qnvidia is dedicated to access the Nvidia accelerated nodes, the qmic to access MIC nodes and qfat the Fat nodes. It is required that active project with nonzero remaining resources is specified to enter these queues. 23 nvidia, 4 mic and 2 fat nodes are included. Full nodes, 16 cores per node are allocated. The queues run with very high priority, the jobs will be scheduled before the jobs coming from the qexp queue. An PI needs explicitly ask [support](https://support.it4i.cz/rt/) for authorization to enter the dedicated queues for all users associated to her/his Project.
-- **qfree**, The Free resource queue: The queue qfree is intended for utilization of free resources, after a Project exhausted all its allocated computational resources (Does not apply to DD projects by default. DD projects have to request for persmission on qfree after exhaustion of computational resources.). It is required that active project is specified to enter the queue, however no remaining resources are required. Consumed resources will be accounted to the Project. Only 178 nodes without accelerator may be accessed from this queue. Full nodes, 16 cores per node are allocated. The queue runs with very low priority and no special authorization is required to use it. The maximum runtime in qfree is 12 hours.
+* **qexp**, the Express queue: This queue is dedicated for testing and running very small jobs. It is not required to specify a project to enter the qexp. There are 2 nodes always reserved for this queue (w/o accelerator), maximum 8 nodes are available via the qexp for a particular user, from a pool of nodes containing Nvidia accelerated nodes (cn181-203), MIC accelerated nodes (cn204-207) and Fat nodes with 512GB RAM (cn208-209). This enables to test and tune also accelerated code or code with higher RAM requirements. The nodes may be allocated on per core basis. No special authorization is required to use it. The maximum runtime in qexp is 1 hour.
+* **qprod**, the Production queue: This queue is intended for normal production runs. It is required that active project with nonzero remaining resources is specified to enter the qprod. All nodes may be accessed via the qprod queue, except the reserved ones. 178 nodes without accelerator are included. Full nodes, 16 cores per node are allocated. The queue runs with medium priority and no special authorization is required to use it. The maximum runtime in qprod is 48 hours.
+* **qlong**, the Long queue: This queue is intended for long production runs. It is required that active project with nonzero remaining resources is specified to enter the qlong. Only 60 nodes without acceleration may be accessed via the qlong queue. Full nodes, 16 cores per node are allocated. The queue runs with medium priority and no special authorization is required to use it. The maximum runtime in qlong is 144 hours (three times of the standard qprod time - 3 * 48 h).
+* **qnvidia**, qmic, qfat, the Dedicated queues: The queue qnvidia is dedicated to access the Nvidia accelerated nodes, the qmic to access MIC nodes and qfat the Fat nodes. It is required that active project with nonzero remaining resources is specified to enter these queues. 23 nvidia, 4 mic and 2 fat nodes are included. Full nodes, 16 cores per node are allocated. The queues run with very high priority, the jobs will be scheduled before the jobs coming from the qexp queue. An PI needs explicitly ask [support](https://support.it4i.cz/rt/) for authorization to enter the dedicated queues for all users associated to her/his Project.
+* **qfree**, The Free resource queue: The queue qfree is intended for utilization of free resources, after a Project exhausted all its allocated computational resources (Does not apply to DD projects by default. DD projects have to request for persmission on qfree after exhaustion of computational resources.). It is required that active project is specified to enter the queue, however no remaining resources are required. Consumed resources will be accounted to the Project. Only 178 nodes without accelerator may be accessed from this queue. Full nodes, 16 cores per node are allocated. The queue runs with very low priority and no special authorization is required to use it. The maximum runtime in qfree is 12 hours.
 
 ### Notes
 
@@ -37,7 +36,8 @@ Anselm users may check current queue configuration at <https://extranet.it4i.cz/
 
 ### Queue status
 
->Check the status of jobs, queues and compute nodes at <https://extranet.it4i.cz/anselm/>
+!!! tip
+    Check the status of jobs, queues and compute nodes at <https://extranet.it4i.cz/anselm/>
 
 ![rspbs web interface](../img/rsweb.png)
 
@@ -105,8 +105,7 @@ Options:
   --incl-finished       Include finished jobs
 ```
 
-Resources Accounting Policy
--------------------------------
+## Resources Accounting Policy
 
 ### The Core-Hour
 

docs.it4i/anselm-cluster-documentation/shell-and-data-access.md

-Accessing the Cluster
-==============================
+# Accessing the Cluster
+
+## Shell Access
 
-Shell Access
------------------
 The Anselm cluster is accessed by SSH protocol via login nodes login1 and login2 at address anselm.it4i.cz. The login nodes may be addressed specifically, by prepending the login node name to the address.
 
 |Login address|Port|Protocol|Login node|
@@ -13,7 +12,7 @@ The Anselm cluster is accessed by SSH protocol via login nodes login1 and login2
 
 The authentication is by the [private key](../get-started-with-it4innovations/accessing-the-clusters/shell-access-and-data-transfer/ssh-keys/)
 
-!!! Note "Note"
+!!! note
     Please verify SSH fingerprints during the first logon. They are identical on all login nodes:
 
     29:b3:f4:64:b0:73:f5:6f:a7:85:0f:e0:0d:be:76:bf (DSA)
@@ -57,8 +56,8 @@ Example to the cluster login:
 !!! Note "Note"
     The environment is **not** shared between login nodes, except for [shared filesystems](storage/#shared-filesystems).
 
-Data Transfer
--------------
+## Data Transfer
+
 Data in and out of the system may be transferred by the [scp](http://en.wikipedia.org/wiki/Secure_copy) and sftp protocols.  (Not available yet.) In case large volumes of data are transferred, use dedicated data mover node dm1.anselm.it4i.cz for increased performance.
 
 |Address|Port|Protocol|
@@ -116,9 +115,8 @@ On Windows, use [WinSCP client](http://winscp.net/eng/download.php) to transfer
 
 More information about the shared file systems is available [here](storage/).
 
+## Connection restrictions
 
-Connection restrictions
------------------------
 Outgoing connections, from Anselm Cluster login nodes to the outside world, are restricted to following ports:
 
 |Port|Protocol|
@@ -133,8 +131,7 @@ Outgoing connections, from Anselm Cluster login nodes to the outside world, are
 
 Outgoing connections, from Anselm Cluster compute nodes are restricted to the internal network. Direct connections form compute nodes to outside world are cut.
 
-Port forwarding
----------------
+## Port forwarding
 
 ### Port forwarding from login nodes
 
@@ -159,7 +156,8 @@ Port forwarding may be established directly to the remote host. However, this re
 $ ssh -L 6000:localhost:1234 remote.host.com
 ```
 
-Note: Port number 6000 is chosen as an example only. Pick any free port.
+!!! note
+    Port number 6000 is chosen as an example only. Pick any free port.
 
 ### Port forwarding from compute nodes
 
@@ -198,13 +196,11 @@ local $ ssh -R 6000:localhost:1080 anselm.it4i.cz
 
 Now, configure the applications proxy settings to **localhost:6000**. Use port forwarding  to access the [proxy server from compute nodes](#port-forwarding-from-compute-nodes) as well.
 
-Graphical User Interface
-------------------------
+## Graphical User Interface
 
--   The [X Window system](../get-started-with-it4innovations/accessing-the-clusters/graphical-user-interface/x-window-system/) is a principal way to get GUI access to the clusters.
--   The [Virtual Network Computing](../get-started-with-it4innovations/accessing-the-clusters/graphical-user-interface/vnc/) is a graphical [desktop sharing](http://en.wikipedia.org/wiki/Desktop_sharing) system that uses the [Remote Frame Buffer protocol](http://en.wikipedia.org/wiki/RFB_protocol) to remotely control another [computer](http://en.wikipedia.org/wiki/Computer).
+* The [X Window system](../get-started-with-it4innovations/accessing-the-clusters/graphical-user-interface/x-window-system/) is a principal way to get GUI access to the clusters.
+* The [Virtual Network Computing](../get-started-with-it4innovations/accessing-the-clusters/graphical-user-interface/vnc/) is a graphical [desktop sharing](http://en.wikipedia.org/wiki/Desktop_sharing) system that uses the [Remote Frame Buffer protocol](http://en.wikipedia.org/wiki/RFB_protocol) to remotely control another [computer](http://en.wikipedia.org/wiki/Computer).
 
-VPN Access
-----------
+## VPN Access
 
--   Access to IT4Innovations internal resources via [VPN](../get-started-with-it4innovations/accessing-the-clusters/vpn-access/).
+* Access to IT4Innovations internal resources via [VPN](../get-started-with-it4innovations/accessing-the-clusters/vpn-access/).

docs.it4i/anselm-cluster-documentation/software/gpi2.md

-GPI-2
-=====
+# GPI-2
 
-##A library that implements the GASPI specification
+## Introduction
 
-Introduction
-------------
 Programming Next Generation Supercomputers: GPI-2 is an API library for asynchronous interprocess, cross-node communication. It provides a flexible, scalable and fault tolerant interface for parallel applications.
 
 The GPI-2 library ([www.gpi-site.com/gpi2/](http://www.gpi-site.com/gpi2/)) implements the GASPI specification (Global Address Space Programming Interface, [www.gaspi.de](http://www.gaspi.de/en/project.html)). GASPI is a Partitioned Global Address Space (PGAS) API. It aims at scalable, flexible and failure tolerant computing in massively parallel environments.
 
-Modules
--------
+## Modules
+
 The GPI-2, version 1.0.2 is available on Anselm via module gpi2:
 
 ```bash
@@ -19,9 +16,9 @@ The GPI-2, version 1.0.2 is available on Anselm via module gpi2:
 
 The module sets up environment variables, required for linking and running GPI-2 enabled applications. This particular command loads the default module, which is gpi2/1.0.2
 
-Linking
--------
-!!! Note "Note"
+## Linking
+
+!!! note
     Link with -lGPI2 -libverbs
 
 Load the gpi2 module. Link using **-lGPI2** and **-libverbs** switches to link your code against GPI-2. The GPI-2 requires the OFED infinband communication library ibverbs.
@@ -42,10 +39,9 @@ Load the gpi2 module. Link using **-lGPI2** and **-libverbs** switches to link y
     $ gcc myprog.c -o myprog.x -Wl,-rpath=$LIBRARY_PATH -lGPI2 -libverbs
 ```
 
-Running the GPI-2 codes
------------------------
+## Running the GPI-2 codes
 
-!!! Note "Note"
+!!! note
     gaspi_run starts the GPI-2 application
 
 The gaspi_run utility is used to start and run GPI-2 applications:
@@ -80,7 +76,7 @@ machinefle:
 
 This machinefile will run 4 GPI-2 processes, 2 on node cn79 o 2 on node cn80.
 
-!!! Note "Note"
+!!! note
     Use the **mpiprocs**to control how many GPI-2 processes will run per node
 
 Example:
@@ -93,13 +89,12 @@ This example will produce $PBS_NODEFILE with 16 entries per node.
 
 ### gaspi_logger
 
-!!! Note "Note"
+!!! note
     gaspi_logger views the output form GPI-2 application ranks
 
 The gaspi_logger utility is used to view the output from all nodes except the master node (rank 0). The gaspi_logger is started, on another session, on the master node - the node where the gaspi_run is executed. The output of the application, when called with gaspi_printf(), will be redirected to the gaspi_logger. Other I/O routines (e.g. printf) will not.
 
-Example
--------
+## Example
 
 Following is an example GPI-2 enabled code:
 

docs.it4i/anselm-cluster-documentation/software/omics-master/diagnostic-component-team.md

-Diagnostic component (TEAM)
-===========================
+# Diagnostic component (TEAM)
 
-### Access
+## Access
 
 TEAM is available at the [following address](http://omics.it4i.cz/team/)
 
-!!! Note "Note"
+!!! note
     The address is accessible only via VPN.
 
-### Diagnostic component (TEAM)
+## Diagnostic component
 
 VCF files are scanned by this diagnostic tool for known diagnostic disease-associated variants. When no diagnostic mutation is found, the file can be sent to the disease-causing gene discovery tool to see whether new disease associated variants can be found.
 

docs.it4i/anselm-cluster-documentation/software/omics-master/priorization-component-bierapp.md

-Prioritization component (BiERapp)
-================================
+# Prioritization component (BiERapp)
 
-### Access
+## Access
 
 BiERapp is available at the [following address](http://omics.it4i.cz/bierapp/)
 
-!!! Note "Note"
+!!! note
     The address is accessible only via VPN.
 
-###BiERapp
+## BiERapp
 
 ** This tool is aimed to discover new disease genes or variants by studying affected families or cases and controls. It carries out a filtering process to sequentially remove: (i) variants which are not no compatible with the disease because are not expected to have impact on the protein function; (ii) variants that exist at frequencies incompatible with the disease; (iii) variants that do not segregate with the disease. The result is a reduced set of disease gene candidates that should be further validated experimentally. **