{"id":137968,"date":"2021-12-03T15:35:58","date_gmt":"2021-12-03T20:35:58","guid":{"rendered":"http:\/\/www.bu.edu\/tech\/?page_id=137968"},"modified":"2025-05-09T09:19:19","modified_gmt":"2025-05-09T13:19:19","slug":"interactive-mpi","status":"publish","type":"page","link":"https:\/\/www.bu.edu\/tech\/support\/research\/system-usage\/running-jobs\/interactive-mpi\/","title":{"rendered":"Running MPI jobs in an Interactive Session"},"content":{"rendered":"

Usually MPI programs are run by\u00a0submitting a batch job<\/strong><\/a><\/span>. However if you want to run MPI jobs interactively, for example to debug or test MPI programs, you can request an interactive session to do that.<\/p>\n

How to run MPI jobs in an interactive session<\/h3>\n

To start an interactive MPI session, use qrsh<\/span><\/span><\/span><\/span> command with -pe mpi_X_tasks_per_node Y<\/span><\/nobr><\/span>\u00a0 option, where X<\/span><\/span> is the number of CPU cores per node and\u00a0Y<\/span> is the total<\/strong> number of cores. For example, to request two compute nodes with 28 CPU cores each:<\/p>\n

scc % <\/span>qrsh -pe mpi_28_tasks_per_node 56\r\n<\/span><\/code><\/pre>\n
When you submit your interactive job it will wait in the queue until the resources you requested are available. Depending on how busy the SCC is, you may need to wait more than a couple minutes. Interactive jobs by default assume you are only willing to wait for 15 minutes for them to start; if you are willing to wait longer you can use -now n<\/span><\/span> <\/span>option to make your job waiting in the queue until the requested resources are available:<\/p>\n
scc % <\/span>qrsh -pe mpi_28_tasks_per_node 56 -now n<\/span><\/code><\/pre>\n
In an interactive session, necessary MPI environment variables have been set by the system, so you can run an MPI program with mpirun<\/span><\/span>, simply specifying the total number of MPI tasks with the flag -np<\/span><\/span> (or -n<\/span><\/span>):<\/p>\n
scc-ha1 % <\/span>mpirun -np 32 .\/your_mpi_binary\r\n<\/span><\/code><\/pre>\n
Note that the host file required to run an MPI program on multiple nodes is automatically handled by the system and you do not need to explicitly provide the host file for mpirun<\/span><\/span>.<\/p>\n
Please refer to this page<\/strong><\/a> for MPI programming and examples.<\/p>\n
For further questions on running MPI jobs in an interactive session, please contact us at help@scc.bu.edu<\/a> .<\/p>\n","protected":false},"excerpt":{"rendered":"
Usually MPI programs are run by\u00a0submitting a batch job. However if you want to run MPI jobs interactively, for example to debug or test MPI programs, you can request an interactive session to do that. How to run MPI jobs in an interactive session To start an interactive MPI session, use qrsh command with -pe…<\/p>\n","protected":false},"author":1692,"featured_media":0,"parent":137962,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137968"}],"collection":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/users\/1692"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/comments?post=137968"}],"version-history":[{"count":9,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137968\/revisions"}],"predecessor-version":[{"id":157268,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137968\/revisions\/157268"}],"up":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137962"}],"wp:attachment":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/media?parent=137968"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}