Skip to content
Snippets Groups Projects
index.md 4.37 KiB
Newer Older
  • Learn to ignore specific revisions
  • David Hrbáč's avatar
    David Hrbáč committed
    # Documentation
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    Welcome to the IT4Innovations documentation pages. The IT4Innovations national supercomputing center operates the supercomputers [Anselm][2], [Barbora][3] and [Salomon][1]. The supercomputers are [available][4] 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
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    ## How to Read the Documentation
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    John Cawley's avatar
    John Cawley committed
    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
    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
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    ## Getting Help and Support
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    !!! note
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
        Contact [support\[at\]it4i.cz][a] for help and support regarding the cluster technology at IT4Innovations. 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
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    Use your IT4Innovations username and password to log in to the [support][b] portal.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    ## Required Proficiency
    
    David Hrbáč's avatar
    David Hrbáč committed
    !!! note
    
    John Cawley's avatar
    John Cawley committed
        You need basic proficiency in Linux environments.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    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
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    !!! note
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
        Learn how to parallelize your code!
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    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
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    ## Terminology Frequently Used on These Pages
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    John Cawley's avatar
    John Cawley committed
    * **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
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    * **core-hour:** also normalized core-hour, NCH. A metric of computer utilization, [see definition][5].
    
    John Cawley's avatar
    John Cawley committed
    * **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
    * **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
    * **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
    * **jobscript:** a script to be executed by the PBS Professional workload manager
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    ## Conventions
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    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
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    Cluster command prompt
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ```console
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    $
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ```
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    Your local linux host command prompt
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ```console
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    local $
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ```
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    John Cawley's avatar
    John Cawley committed
    ## Errors
    
    Although we have taken every care to ensure the accuracy of the content, mistakes do happen.
    
    David Hrbáč's avatar
    David Hrbáč committed
    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
    By doing so, you can save other readers from frustration and help us improve.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    !!! tip
        We will fix the problem as soon as possible.
    
    David Hrbáč's avatar
    David Hrbáč committed
    
    [1]: salomon/introduction.md
    [2]: anselm/introduction.md
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    [3]: barbora/introduction.md
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    [4]: general/applying-for-resources.md
    [5]: general/resources-allocation-policy.md#normalized-core-hours-nch
    
    David Hrbáč's avatar
    David Hrbáč committed
    
    [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