index.md 4.38 KB
Newer Older
David Hrbáč's avatar
David Hrbáč committed
1
# Documentation
Lukáš Krupčík's avatar
Lukáš Krupčík committed
2

David Hrbáč's avatar
David Hrbáč committed
3
Welcome to IT4Innovations documentation pages. The IT4Innovations national supercomputing center operates supercomputers [Salomon](/salomon/introduction/) and [Anselm](/anselm/introduction/). The supercomputers are [available](general/applying-for-resources/) to academic community within the Czech Republic and Europe and industrial community worldwide. The purpose of these pages is to provide a comprehensive documentation on hardware, software and usage of the computers.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
4

David Hrbáč's avatar
David Hrbáč committed
5
## How to Read the Documentation
Lukáš Krupčík's avatar
Lukáš Krupčík committed
6

Lukáš Krupčík's avatar
Lukáš Krupčík committed
7 8 9
1. Read the list in the left column. Select the subject of interest. Alternatively, use the Search in the upper right corner.
1. Scan for all the notes and reminders on the page.
1. Read the details if still more information is needed. **Look for examples** illustrating the concepts.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
10

David Hrbáč's avatar
David Hrbáč committed
11
## Getting Help and Support
Lukáš Krupčík's avatar
Lukáš Krupčík committed
12 13

!!! note
David Hrbáč's avatar
David Hrbáč committed
14
    Contact [support\[at\]it4i.cz](mailto:support@it4i.cz) for help and support regarding the cluster technology at IT4Innovations. Please use **Czech**, **Slovak** or **English** language for communication with us. Follow the status of your request to IT4Innovations at [support.it4i.cz/rt](http://support.it4i.cz/rt).
Lukáš Krupčík's avatar
Lukáš Krupčík committed
15

Lukáš Krupčík's avatar
Lukáš Krupčík committed
16
Use your IT4Innotations username and password to log in to the [support](http://support.it4i.cz/) portal.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
17

David Hrbáč's avatar
David Hrbáč committed
18
## Required Proficiency
Lukáš Krupčík's avatar
Lukáš Krupčík committed
19

David Hrbáč's avatar
David Hrbáč committed
20
!!! note
Lukáš Krupčík's avatar
Lukáš Krupčík committed
21
    You need basic proficiency in Linux environment.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
22

David Hrbáč's avatar
David Hrbáč committed
23
In order to use the system for your calculations, you need basic proficiency in Linux environment. To gain the proficiency, we recommend you reading the [introduction to Linux](http://www.tldp.org/LDP/intro-linux/html/) operating system environment and installing a Linux distribution on your personal computer. A good choice might be the [CentOS](http://www.centos.org/) distribution, as it is similar to systems on the clusters at IT4Innovations. It's easy to install and use. In fact, any distribution would do.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
24

David Hrbáč's avatar
David Hrbáč committed
25
!!! note
Lukáš Krupčík's avatar
Lukáš Krupčík committed
26
    Learn how to parallelize your code!
Lukáš Krupčík's avatar
Lukáš Krupčík committed
27

Lukáš Krupčík's avatar
Lukáš Krupčík committed
28
In many cases, you will run your own code on the cluster. In order to fully exploit the cluster, you will need to carefully consider how to utilize all the cores available on the node and how to use multiple nodes at the same time. You need to **parallelize** your code. Proficieny in MPI, OpenMP, CUDA, UPC or GPI2 programming may be gained via the [training provided by IT4Innovations.](http://prace.it4i.cz)
Lukáš Krupčík's avatar
Lukáš Krupčík committed
29

David Hrbáč's avatar
David Hrbáč committed
30
## Terminology Frequently Used on These Pages
Lukáš Krupčík's avatar
Lukáš Krupčík committed
31

Lukáš Krupčík's avatar
* -> *  
Lukáš Krupčík committed
32 33
* **node:** a computer, interconnected by network to other computers - Computational nodes are powerful computers, designed and dedicated for executing demanding scientific computations.
* **core:** processor core, a unit of processor, executing computations
Branislav Jansik's avatar
Branislav Jansik committed
34
* **core-hour:** also standard core-hour, SCH. A metric of computer utilization, [see definition](salomon/resources-allocation-policy/#standard-core-hours-sch).
Lukáš Krupčík's avatar
* -> *  
Lukáš Krupčík committed
35 36 37 38 39 40 41 42
* **job:** a calculation running on the supercomputer - The job allocates and utilizes resources of the supercomputer for certain time.
* **HPC:** High Performance Computing
* **HPC (computational) resources:** corehours, storage capacity, software licences
* **code:** a program
* **primary investigator (PI):** a person responsible for execution of computational project and utilization of computational resources allocated to that project
* **collaborator:** a person participating on execution of computational project and utilization of computational resources allocated to that project
* **project:** a computational project under investigation by the PI - The project is identified by the project ID. The computational resources are allocated and charged per project.
* **jobscript:** a script to be executed by the PBS Professional workload manager
Lukáš Krupčík's avatar
Lukáš Krupčík committed
43

David Hrbáč's avatar
David Hrbáč committed
44
## Conventions
Lukáš Krupčík's avatar
Lukáš Krupčík committed
45

Lukáš Krupčík's avatar
Lukáš Krupčík committed
46
In this documentation, you will find a number of pages containing examples. We use the following conventions:
Lukáš Krupčík's avatar
Lukáš Krupčík committed
47

Lukáš Krupčík's avatar
Lukáš Krupčík committed
48
Cluster command prompt
Lukáš Krupčík's avatar
Lukáš Krupčík committed
49

Lukáš Krupčík's avatar
Lukáš Krupčík committed
50
```console
Lukáš Krupčík's avatar
Lukáš Krupčík committed
51
$
Lukáš Krupčík's avatar
Lukáš Krupčík committed
52
```
Lukáš Krupčík's avatar
Lukáš Krupčík committed
53 54 55

Your local linux host command prompt

Lukáš Krupčík's avatar
Lukáš Krupčík committed
56
```console
Lukáš Krupčík's avatar
Lukáš Krupčík committed
57
local $
Lukáš Krupčík's avatar
Lukáš Krupčík committed
58
```
Lukáš Krupčík's avatar
Lukáš Krupčík committed
59

David Hrbáč's avatar
David Hrbáč committed
60
## Errata
Lukáš Krupčík's avatar
Lukáš Krupčík committed
61

David Hrbáč's avatar
David Hrbáč committed
62
Although we have taken every care to ensure the accuracy of our content, mistakes do happen. If you find a mistake in the text or the code we would be grateful if you would report this to us. By doing so, you can save other readers from frustration and help us improve subsequent versions of this documentation. If you find any errata, please report them by visiting <http://support.it4i.cz/rt>, creating a new ticket, and entering the details of your errata. Once your errata are verified, your submission will be accepted and the errata will be uploaded on our website.