Developing Applications | HP XC System 3.x Software guide

3 Configuring Your Environment with Modulefiles
Overview of Modules	31
Supplied Modulefiles	32
Modulefiles Automatically Loaded on the System	33
Viewing Available Modulefiles	33
Viewing Loaded Modulefiles	33
Loading a Modulefile	33
Loading a Modulefile for the Current Session	34
Automatically Loading a Modulefile at Login	34
Unloading a Modulefile	34
Modulefile Conflicts	34
Creating a Modulefile	35
Viewing Modulefile-Specific Help	35
4 Developing Applications
Application Development Environment Overview	37
Compilers	37
MPI Compiler	38
Examining Nodes and Partitions Before Running Jobs	38
Interrupting a Job	38
Setting Debugging Options	39
Developing Serial Applications	39
Serial Application Build Environment	39
Building Serial Applications	39
Compiling and Linking Serial Applications	39
Developing Parallel Applications	40
Parallel Application Build Environment	40
Modulefiles	40
HP-MPI	40
OpenMP	40
Pthreads	41
Quadrics SHMEM	41
MPI Library	41
Intel Fortran and C/C++Compilers	41
PGI Fortran and C/C++ Compilers	41
GNU C and C++ Compilers	41
Pathscale Compilers	41
GNU Parallel Make	42
MKL Library	42
ACML Library	42
Other Libraries	42
Building Parallel Applications	42
Compiling and Linking Non-MPI Applications	42
Compiling and Linking HP-MPI Applications	42
Examples of Compiling and Linking HP-MPI Applications	43
Developing Libraries	43
Designing Libraries for the CP4000 Platform	43
5 Submitting Jobs
Overview of Job Submission	45
Submitting a Serial Job Using Standard LSF	46
Submitting a Serial Job Using LSF-HPC	46
Submitting a Serial Job with the LSF bsub Command	46
Submitting a Serial Job Through SLURM only	47
Submitting a Non-MPI Parallel Job	48
Submitting a Parallel Job That Uses the HP-MPI Message Passing Interface	48
Submitting a Batch Job or Job Script	49

4Table of Contents

Image 4

HP XC System 3.x Software manual Configuring Your Environment with Modulefiles, Developing Applications, Submitting Jobs

Contents

HP XC System Software Users Guide Page Table of Contents Developing Applications Configuring Your Environment with ModulefilesSubmitting Jobs Tuning Applications Using SlurmUsing LSF Debugging Applications Examples Advanced TopicsGlossary 109 Index 115 List of Figures Page List of Tables Determining the Node PlatformPage List of Examples Submitting a Job ScriptPage About This Document Intended AudienceDocument Organization This document is organized as follows HP XC Information For More Information $ man lsfcommandnameSupplementary Information Related Information Manpages$ man discover $ man 8 discover $ man -k keyword Related Linux Web Sites Related MPI Web SitesRelated Compiler Web Sites Additional Publications Typographic Conventions HP Encourages Your CommentsEnvironment Variable User input Overview of the User Environment System ArchitectureHP XC System Software Operating System Node Specialization Storage and I/O File System SAN StorageLocal Storage File System Layout System Interconnect Network Determining System Configuration InformationNetwork Address Translation NAT User Environment CommandsModules Application Development Environment Run-Time EnvironmentParallel Applications Serial Applications Standard LSF Load Sharing Facility LSF-HPCHow LSF-HPC and Slurm Interact Mpirun command Components, Tools, Compilers, Libraries, and Debuggers Using the System LVS Login RoutingUsing the Secure Shell to Log Logging In to the System Getting Information About Queues IntroductionGetting Information About Resources Performing Other Common User Tasks Getting System Help and Information $ man sinfo Configuring Your Environment with Modulefiles Overview of Modules Supplied Modulefiles Modulefiles Automatically Loaded on the System Viewing Available ModulefilesViewing Loaded Modulefiles Loading a Modulefile Automatically Loading a Modulefile at Login Unloading a ModulefileModulefile Conflicts Loading a Modulefile for the Current Session Creating a Modulefile Viewing Modulefile-Specific Help$ module load modules $ man modulefile $ module help totalviewPage Application Development Environment Overview Developing ApplicationsCompilers Examining Nodes and Partitions Before Running Jobs Interrupting a JobMPI Compiler Partition Avail Timelimit Nodes State Nodelist Setting Debugging Options Developing Serial ApplicationsSerial Application Build Environment Building Serial Applications Developing Parallel Applications Parallel Application Build EnvironmentModulefiles OpenMP Pthreads Quadrics ShmemMPI Library Intel Fortran and C/C++Compilers Building Parallel Applications Designing Libraries for the CP4000 Platform Developing LibrariesExamples of Compiling and Linking HP-MPI Applications Linkcommand 64-bit -L/opt/mypackage/lib/x8664 -lmystuff Linkcommand 32-bit -L/opt/mypackage/lib/i686 -lmystuffTo build a 64-bit application, you might enter Overview of Job Submission Submitting JobsExtSLURMslurm-arguments Submitting a Serial Job Using Standard LSF Submitting a Serial Job Using LSF-HPCSubmitting a Serial Job with the LSF bsub Command $ bsub hostname Submitting a Serial Job Through Slurm only Submitting a Non-MPI Parallel Job $ bsub -n4 -I srun hostnameBsub -nnum-procsbsub-optionsmpijob Mpirun mpirun--options-srunsrun-optionsmpi-jobname $ bsub -n4 -I mpirun -srun ./helloworld Submitting a Batch Job or Job ScriptBsub -nnum-procs bsub-optionsscript-name $ cat myscript.sh #!/bin/sh Srun hostname mpirun -srun hellompi$ bsub -I -n4 Myscript.sh $ bsub -n4 -ext SLURMnodes=4 -I ./myscript.sh $ bsub -n4 -I ./myscript.sh Running Preexecution Programs$ cat ./envscript.sh #!/bin/sh name=`hostname` Opt/hptc/bin/srun Mypreexec Debugging Applications Debugging Serial ApplicationsDebugging Parallel Applications TotalView Setting Up TotalView Using TotalView with SlurmSSH and TotalView Module load mpimodule load totalview Setting TotalView Preferences Using TotalView with LSF-HPCDebugging an Application Sourcefile initfdte.f was not found, using assembler mode Debugging Running ApplicationsDirectories in File ⇒ Search Path $ mpirun -srun -n2 Psimple Exiting TotalView $ scancel --user username$ squeue Page Using the Intel Trace Collector and Intel Trace Analyzer Tuning ApplicationsBuilding a Program Intel Trace Collector and HP-MPI Running a Program Intel Trace Collector and HP-MPI Visualizing Data Intel Trace Analyzer and HP-MPILibs Cldflags Using the Intel Trace Collector and Intel Trace Analyzer Page Using Slurm Launching Jobs with the srun CommandSrun Squeue Scancel Sinfo Scontrol Introduction to Slurm Monitoring Jobs with the squeue Command Using the srun Command with HP-MPIUsing the srun Command with LSF-HPC Srun Roles and Modes Getting System Information with the sinfo Command Terminating Jobs with the scancel CommandJob Accounting Security Fault Tolerance# chmod a+r /hptccluster/slurm/job/jobacct.log Using Standard LSF on an HP XC System Using LSFUsing LSF-HPC Introduction to LSF-HPC in the HP XC Environment Overview of LSF-HPC Differences Between LSF-HPC and Standard LSF HostnameResources Hostname Status JL/U MAX Njobs RUN Ssusp Ususp RSV $ ssh n15 lshosts Job TerminologyUnknown Unknown HP XCCompute Node Resource Support SLURMnodelist =nodelist if specified $ bsub -n 10 -I srun hostname $ bsub -n 10 -ext SLURMnodes=10 -I srun hostname$ bsub -n 10 -ext SLURMnodes=10exclude=n16 -I srun hostname $ bsub -n 10 -ext SLURMconstraint=dualcore -I srun hostname How LSF-HPC and Slurm Launch and Manage a Job $ bsub -n4 -ext SLURMnodes=4 -o output.out ./myscript Job Startup and Job Control #!/bin/sh hostname srun hostname Mpirun -srun ./hellompi Determining the LSF Execution Host Determining Available LSF-HPC System ResourcesGetting the Status of LSF-HPC Getting Information About LSF Execution Host Node Getting Host Load Information Examining LSF-HPC System QueuesGetting Information About the lsf Partition SLINUX6 $ sinfo -p lsf Summary of the LSF bsub Command Format$ sinfo -p lsf -lNe LSF-SLURM External Scheduler For information about running scriptsBsub -n num-procs-ext SLURMslurm-arguments \ Bsub-options srun srun-optionsjobname job-options Submitting a Job from a Non-HP XC Host Starting on lsfhost.localdomain n6Waiting for dispatch ... Starting on lsfhost.localdomain n1 Type=SLINUX64 Getting Information About Jobs Getting Job Allocation InformationSlurmid=slurmjobidncpus=slurmnprocsslurmalloc=nodelist $ bjobs -l Examining the Status of a Job $ bhist -lTime stamp $ bjobs Viewing the Historical Information for a Job $ bhistSummary of time in seconds spent Various States Jobid User Jobname Pend Psusp RUN Ususp Ssusp Unkwn Total Translating Slurm and LSF-HPC JOBIDs Working Interactively Within an LSF-HPC Allocation $ bsub -I -n4 -ext SLURMnodes=4 /bin/bash$ bjobs -l 124 grep slurm $ srun --jobid=150 hostname $ unset Slurmjobid Alternatively, you can use the following$ export SLURMJOBID=150 $ export SLURMNPROCS=4 $ unset Slurmjobid $ unset Slurmnprocs Job 125 is submitted to the default queue normal LSF-HPC Equivalents of Slurm srun Options$ srun --jobid=250 uptime $ bsub -n4 -ext SLURMnodes=4 -o %J.out sleep Bsub -iinputfile Mpi=mpitype Quit-on-interrupt Page Advanced Topics Enabling Remote Execution with OpenSSHRunning an X Terminal Session from a Remote Node Determining IP Address of Your Local Machine Running an X terminal Session Using LSF-HPC Running an X terminal Session Using SlurmLogging in to HP XC System Using the GNU Parallel Make Capability $ bsub -n4 -Ip srun -n1 xterm -display$ srun -n4 hostname n46 $ srun -n2 hostname n46 $ cd subdir srun -n1 -N1 $MAKE -j4 Example Procedure $ make PREFIX=’srun -n1 -N1 MAKEJ=-j4 Local Disks on Compute Nodes Performance ConsiderationsModified Makefile is invoked as follows $ make PREFIX=srun -n1 -N1 MAKEJ=-j4 Communication Between Nodes Shared File ViewPrivate File View Fp = fopen myfile, a+Page Appendix a Examples Building and Running a Serial ApplicationLaunching a Serial Interactive Shell Through LSF-HPC Examine the LSF execution host information Running LSF-HPC Jobs with a Slurm Allocation Request Launching a Parallel Interactive Shell Through LSF-HPC Example 2. Four cores on Two Specific NodesR15s r1m r15m It tmp swp mem LoadSched LoadStop SLURMnodes=2 $ hostname n16 $ srun hostname n5 $ bjobs Examine the the running jobs information124 Lsfad Submitting a Simple Job Script with LSF-HPC Examine the the finished jobs informationShow the environment Display the script Run some commands from the pseudo-terminal Submitting an Interactive Job with LSF-HPCSubmit the job Show the job allocation Submitting an HP-MPI Job with LSF-HPC Exit the pseudo-terminalView the interactive jobs View the finished jobs View the finished job View the running jobLsfhost.localdomai States by date and time Using a Resource Requirements String in an LSF-HPC Command$ bsub -n 8 -R ALPHA5 SLINUX64 \ -ext SLURMnodes=4-4 myjob 108 Glossary To the queue First-come See Fcfs First-served Global storageAs local storage Are not appropriate for replication Single command Login requests and directs them to a node with a login roleLinux Virtual See LVS Server Load file LSF master host Network See NIS Information Services Remotely. PXE booting is configured at the Bios levelNotably to install and remove software packages Slurm backup Ssh Power available per unit of spaceSymmetric See SMP Multiprocessing 114 Index Index PGI Utilities, 63 Slurm commands