9.2 Установка документации.
В начало страницы
Этот шаг необязателен. Однако, если вы устанавливаете mpich, вы должны
быть уверены, что указали каталог, в котором mpich должна быт установлена,
если вы ее конфигурируете с использованием параметра –prefix. Например, если
планируете установить mpich в `/usr/local/mpich-1.2.1', то вы должны
конфигурировать с параметром –prefix=/usr/local/mpich-1.2.1. Если имеется
какая-нибудь возможность построения mpich для нескольких систем и/или
устройств, вы должны включить эту информацию в префикс.
Например, употребив
-prefix=/usr/local/mpich-1.2.1/solaris/ch p4, вы можете позже добавить –prefix=/usr/local/mpich-1.2.1/solaris/ch p4smp для версии, которая строится с параметром конфигурации –comm=shared (подходит для кластеров симметричных мультипроцессоров, отсюда «smp» в имени каталога). Если вы уже проверили все части поставки MPI (включя инструментарий, в частносит upshot и/или nupshot), вы можете установить mpich в общедоступный каталог и сообщить об этом другим пользователям, чтобы каждый мог пользоваться общей установкой. Чтобы установить библиотеки и файлы include в доступное всем место, войдите в верхний уровень каталога mpich и выполните
make install
Man pages будут скопированы с установкой и вы можете добавить /usr/local/mpich-1.2.1/man к установленной по умолчанию системе MANPATH. Мan pages удобно просматривать командой mpiman, находящейся в каталоге mpich/bin. Можно также указать каталог, в который mpich будет установлена, с помощью установки значения PREFIX при выполнении шага инсталляции:
make install PREFIX=/usr/local/mpich-1.2.1
Однако, некоторые возможности, в особенности способность Totalview показывать очереди сообщений mpich, будут работать только если mpich конфигурирована с префиксом, указывающим каталог установки.
Хороший путь обращения с многими выпусками mpich – устанавливать их в каталоги, имена которых содержат номер версии, и затем установить связь от mpi к этим каталогам. Например, если текущая версия есть 1.2.1, команда установки в `/usr/local' будет
make install PREFIX=/usr/local/mpi-1.2.1
rm /usr/local/mpi
ln –s /usr/local/mpi-1.2.1 /usr/local/mpi
Сценарий `bin/mpiinstall' дает больший контроль над установкой mpich (фактически, установка происходит по этому сценарию). Например, можно изменить защиту файлов, когда они устанавливаются с параметрами –mode=nnnn (для регулярных файлов) и –xmode=nnnn (для выполнимых и каталогов). Можно указать каталог, в который будут помещены man pages, с помощью –manpath=!path?. Параметр –help выдает все множество опций для mpiinstall.
Установка nupshot может иногда оказаться хлопотной. Можно употребить переключатель –nonupshot для mpiinstall, чтобы не устанавливать nupshot; альтернативно можно использовать переключатель –cpnuphost
для установки копии в `mpich/profiling/nupshot'.
Нормально mpiinstall строит новую версию nupshot для проверки того, что все пути правильны (nupshot ищет файлы там, где она установлена). Если вы хотите построить «вручную» nupshot для установки, переключатель –cpnupshot позволит вам установить эту версию.
Можно тестировать установку использованием конфигурации в `mpich/examples/test'. Например, если вы установили MPICH в `/usr/local/mpich' для архитектуры Solaris и устройства ch.p4, выполните
./configure –mpichpath=/usr/local/mpich-1.2.1/solaris/ch.p4/bin –mpi2
make testing
(переключатель –mpi2 вызывает проверку функций MPI-2, которые являются частью mpich; коды тестов в каталоге `mpich/examples/test' могут использоваться каждой реализацией MPI, а не только реализацией mpich.
В начало страницы
Команды mpirun, mpicc, mpif77, mpiCC, mpif90, mpiman и mpireconfig должны
быть в доступном для пользователя месте. Заметим, что если поддерживаются
несколько архитектур и/или устройств MPICH, необходимо, чтобы надлежащие
каталоги были добавлены к пути пользователя. Они располагаются в каталоге
`bin'. Если используются многие архитектуры и устройства, необходимо, чтобы
пути в установке различали их. Например, если в системе Solaris имеются
устройства и ch.p4 и ch.shmem, поставьте префиксы установки с этими именами:
-prefix=/usr/local/mpich-1.2.1/solaris/ch.p4 и –prefix=/usr/local/mpich-1.2.1/solaris/ch.shmem соответственно.
В начало страницы
Реализация MPICH приходит с несколькими видами документации. Установщикам
предлагается обеспечивать информацию о месте ее нахождения, особенно если
она не в `/usr/local/mpich-1.2.1').
В начало страницы
Полный комплект Unix man pages для реализации MPICH находится в `mpich/man'.
`man/man1' содержит команды компиляции и компоновки программ MPI; `man/man3'
содержит подпрограммы MPI; `man/man4' содержит подпрограммы для MPE и
mpirun, а `man/man5' содержит подпрограммы для MPID ( это обеспечение низшего
уровня MPICH, оно не представляет интереса для пользователя). Команда
`mpich/bin/mpiman' представляет сценарий для запуска xman на man pages.
В начало страницы
Версии Web (HTML) доступны в ftp://ftp/.mcs.anl.gov/pub/mpi/manwww.tar.Z.
Они находятся также в
http://www.mcs.anl.gov/mpi/www. Примеры Web page показаны ниже.
!!DOCTYPE HTML PUBLIC «-//W3C//DTD HTML3.2 EN»? !HTML? !HEAD? !TITLE?Using MPICH!/TITLE? !/HEAD? !BODY BGCOLOR="FFFFFF»? !H1?Site-специальная информация об реализации MPICH для MPI!/H1?
!H2?Размещение библиотек и программ!/H2? Реализация MPICH размещена в !TT?/home/MPI/releases/current!/TT?; файлы со специализацией архитектур лежат в указанных ниже каталогах. Каждый из них имеет каталоги lib для библиотек и каталоги bin для программ.
!CENTER? !TABLE? !TR?!TH?!B?System!/B?!TH?!B?Location!/B?!TH?!B?Notes!/B?!/TR? !TR?!TD VALIGN=TOP?Sun4 SunOS!TD?sun4/ch.p4!BR? sun4/ch.shmem!/TR? !TR?!TD VALIGN=TOP?Solaris!TD?solaris/ch.p4!BR? solaris/ch.p4smp!BR? solaris/ch.shmem!TD?ch.p4smp is for p4 –comm=shared!/TR? !TR?!TD VALIGN=TOP?IBM SP!TD?rs6000/ch.mpl!/TR? !TR?!TD VALIGN=TOP?IBM RS6000!TD?rs6000/ch.p4!BR? rs6000/ch.shmem!/TR? !TR?!TD VALIGN=TOP?SGI IRIX!TD?IRIXN32/ch.p4!BR? IRIXN32/ch.shmem!/TR? !TR?!TD VALIGN=TOP?SGI IRIX (64bit)!TD?IRIX64/ch.p4!BR? IRIX64/ch.shmem!/TR? !TR?!TD VALIGN=TOP?LINUX!TD?LINUX/ch.p4!BR? LINUX/ch.shmem!/TR? !/TABLE? !/CENTER?
!H2?Докумениация!/H2? Команда !TT?bin/mpiman!/TT? в соответствующих каталогах (например, !TT?/home/MPI/releases/current/solaris/ch.p4/bin!/TT?) выдает man pages с xman. Также доступны !A HREF="http://www.mcs.anl.gov/mpi/www/index.html»?manpages!/A?
!H2?Examples!/H2? Простой пример на Си и Фортран находится в !TT?/home/MPI/releases/current/examples!/TT?. Больше примеров можно найти в исходном дереве MPICH, помещенном в !TT?/home/MPI/mpich/examples!/TT?. !/BODY? !/HTML?
В начало страницы
Users часто предпочитают работать по примерам из `Makefile's и программ.
Каталог, установленный в каталоге `examples', содержит Си– и Фортран-версии
программ `pi', вместе с `Makefile.in'. Другие примеры здесь включают
простые параллельные I/O-программыи и MPI-программу на C++ связи с функциями
MPI. Пользователей могут заинтересовать некоторые примеры из дерева поставки
(source tree), находящиеся также в каталоге `examples'.