index.md 4.45 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 4 5
!!! Warning
    There's a planned Salomon upgrade. Make sure to read the [details][upgrade].

David Hrbáč's avatar
David Hrbáč committed
6 7
Welcome to the IT4Innovations documentation pages. The IT4Innovations national supercomputing center operates the supercomputers [Salomon][1] and [Anselm][2]. The supercomputers are [available][3] 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.

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

John Cawley's avatar
John Cawley committed
10
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
11 12
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
13

David Hrbáč's avatar
David Hrbáč committed
14
## Getting Help and Support
Lukáš Krupčík's avatar
Lukáš Krupčík committed
15 16

!!! note
David Hrbáč's avatar
David Hrbáč committed
17
    Contact [support\[at\]it4i.cz][a] 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 [here][b]. The IT4Innovations support team will use best efforts to resolve requests within thirty days.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
18

David Hrbáč's avatar
David Hrbáč committed
19
Use your IT4Innovations username and password to log in to the [support][b] portal.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
20

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

David Hrbáč's avatar
David Hrbáč committed
23
!!! note
John Cawley's avatar
John Cawley committed
24
    You need basic proficiency in Linux environments.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
25

David Hrbáč's avatar
David Hrbáč committed
26
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][c] operating system environments, and install a Linux distribution on your personal computer. A good choice might be the [CentOS][d] 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
27

David Hrbáč's avatar
David Hrbáč committed
28
!!! note
Lukáš Krupčík's avatar
Lukáš Krupčík committed
29
    Learn how to parallelize your code!
Lukáš Krupčík's avatar
Lukáš Krupčík committed
30

David Hrbáč's avatar
David Hrbáč committed
31
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][e].
Lukáš Krupčík's avatar
Lukáš Krupčík committed
32

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

John Cawley's avatar
John Cawley committed
35 36
* **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
37
* **core-hour:** also normalized core-hour, NCH. A metric of computer utilization, [see definition][4].
John Cawley's avatar
John Cawley committed
38
* **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
39 40 41 42
* **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
43 44
* **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
45
* **jobscript:** a script to be executed by the PBS Professional workload manager
Lukáš Krupčík's avatar
Lukáš Krupčík committed
46

David Hrbáč's avatar
David Hrbáč committed
47
## Conventions
Lukáš Krupčík's avatar
Lukáš Krupčík committed
48

Lukáš Krupčík's avatar
Lukáš Krupčík committed
49
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
50

Lukáš Krupčík's avatar
Lukáš Krupčík committed
51
Cluster command prompt
Lukáš Krupčík's avatar
Lukáš Krupčík committed
52

Lukáš Krupčík's avatar
Lukáš Krupčík committed
53
```console
Lukáš Krupčík's avatar
Lukáš Krupčík committed
54
$
Lukáš Krupčík's avatar
Lukáš Krupčík committed
55
```
Lukáš Krupčík's avatar
Lukáš Krupčík committed
56 57 58

Your local linux host command prompt

Lukáš Krupčík's avatar
Lukáš Krupčík committed
59
```console
Lukáš Krupčík's avatar
Lukáš Krupčík committed
60
local $
Lukáš Krupčík's avatar
Lukáš Krupčík committed
61
```
Lukáš Krupčík's avatar
Lukáš Krupčík committed
62

John Cawley's avatar
John Cawley committed
63
## Errors
Lukáš Krupčík's avatar
Lukáš Krupčík committed
64

65
Although we have taken every care to ensure the accuracy of the content, mistakes do happen.
David Hrbáč's avatar
David Hrbáč committed
66
If you find an inconsistency or error, report it by visiting [support][b], creating a new ticket, and entering the details.
Branislav Jansik's avatar
Branislav Jansik committed
67
By doing so, you can save other readers from frustration and help us improve.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
68 69 70

!!! tip
    We will fix the problem as soon as possible.
David Hrbáč's avatar
David Hrbáč committed
71 72 73 74 75

[1]: salomon/introduction.md
[2]: anselm/introduction.md
[3]: general/applying-for-resources.md
[4]: salomon/resources-allocation-policy.md#normalized-core-hours-nch
David Hrbáč's avatar
David Hrbáč committed
76
[upgrade]: salomon-upgrade.md
David Hrbáč's avatar
David Hrbáč committed
77 78 79 80 81 82

[a]: mailto:support@it4i.cz
[b]: http://support.it4i.cz/rt
[c]: http://www.tldp.org/LDP/intro-linux/html/
[d]: http://www.centos.org/
[e]: http://prace.it4i.cz