index.md 4.35 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 the IT4Innovations documentation pages. The IT4Innovations national supercomputing center operates the supercomputers [Salomon](salomon/introduction.md) and [Anselm](anselm/introduction.md). The supercomputers are [available](general/applying-for-resources.md) to the academic community within the Czech Republic and Europe, and the industrial community worldwide. The purpose of these pages is to provide comprehensive documentation of the 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

John Cawley's avatar
John Cawley committed
7
1. Read the list in the left column. Select the subject of interest. Alternatively, use the Search tool in the upper right corner.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
8 9
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). The IT4Innovations support team will use best efforts to resolve requests within thirty days.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
15

John Cawley's avatar
John Cawley committed
16
Use your IT4Innovations 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
John Cawley's avatar
John Cawley committed
21
    You need basic proficiency in Linux environments.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
22

John Cawley's avatar
John Cawley committed
23
In order to use the system for your calculations, you need basic proficiency in Linux environments. To gain this proficiency we recommend you read the [introduction to Linux](http://www.tldp.org/LDP/intro-linux/html/) operating system environments, and install 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 Linux 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

John Cawley's avatar
John Cawley 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 [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

John Cawley's avatar
John Cawley committed
32 33
* **node:** a computer, interconnected via a network to other computers - Computational nodes are powerful computers, designed for, and dedicated to executing demanding scientific computations.
* **core:** a processor core, a unit of processor, executing computations
David Hrbáč's avatar
David Hrbáč committed
34
* **core-hour:** also normalized core-hour, NCH. A metric of computer utilization, [see definition](salomon/resources-allocation-policy.md#normalized-core-hours-nch).
John Cawley's avatar
John Cawley committed
35
* **job:** a calculation running on the supercomputer - the job allocates and utilizes the resources of the supercomputer for certain time.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
36 37 38 39
* **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
John Cawley's avatar
John Cawley committed
40 41
* **collaborator:** a person participating in the execution of a 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. Computational resources are allocated and charged per project.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
42
* **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

John Cawley's avatar
John Cawley committed
60
## Errors
Lukáš Krupčík's avatar
Lukáš Krupčík committed
61

62
Although we have taken every care to ensure the accuracy of the content, mistakes do happen.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
63
If you find an inconsistency or error, report it by visiting [http://support.it4i.cz/rt](http://support.it4i.cz/rt), creating a new ticket, and entering the details.
Branislav Jansik's avatar
Branislav Jansik committed
64
By doing so, you can save other readers from frustration and help us improve.
Lukáš Krupčík's avatar
fix  
Lukáš Krupčík committed
65 66 67

!!! tip
    We will fix the problem as soon as possible.