11.2 Jumpshot
В начало страницы
Поставка mpich содержит несколько программ для визуализации файлов log,
производимых приложениями mpich, или самой библиотеки mpich. Самая старая из
включенных в mpich программ называется upshot. Это – чистое приложение 7
tcl/tk. Ее преемница называется nupshot, она быстрее выдает результаты из
больших log-файлов, так как часть ее написана на Си. Новая программа,
используемая но еще дорабатываемая, представляет Java-версию upshot,
которую мы называем jumpshot. Upshot и nupshot используют log-файл в формате
ASCII, который мы называем ALOG. Jumpshot использует новый, двоичный формат,
который мы называем CLOG. Mpich выдает файлы в CLOG по умолчанию;
для получения ALOG-файлов установите переменную окружения MPE LOG FORMAT на
ALOG. Новый, масштабируемый, формат log-файлов называется SLOG. Он
также поддерживается в mpich. Просматривать файлы SLOG может только программа
jumpshot.
В начало страницы
Другая программа в подкаталоге `examples/basic' или `mpe/contrib/test'
есть cpilog. Эта программа использует некоторые из подпрограмм из библиотеки
MPE. Если вы построите и выполните ее, она выдаст простой log-файл, который
можно просматривать инструментами программного анализа upshot или Jumpshot.
Upshot будет установлен как часть установки mpich, если параметр –nompe
не будет передан конфигурации mpich, a конфигурация в подкаталоге `mpe'
в состоянии найти tk и wish (они могут быть указаны как параметры при
конфигурации mpe; см. раздел 10.2). Если библиотека mpe строится реализацией
MPI, отличной от MPICH, конфигурация mpe все равно
будет нуждаться в указании места tk и wish.
Чтобы использовать upshot для просмотра log-файла, выполните
make cpilog mpirun –np 4 cpilog upshot cpilog.log
В начало страницы
Инструментарий для визуализации SLOG-файлов называется jumpshot-3. Он находится
в mpich/jumpshot-3.
Построение jumpshot-3: (Одна из более ранних версий upshot была реализована с помощью Xlib и средств Athena)
cd to $(MPICH)/jumpshot-3, наберите configure в командной строке. Если либо configure сообщит, что не может найти рабочую версию JAVA, либо если вы хотите конфигурировать jumpshot-3 с определенной версией JAVA, наберите
./configure –with-java=/homes/chan/java/jdk117.v3 и затем наберите
make
cd to $(MPICH)/jumpshot-3/bin
чтобы увидеть, есть ли исполнимые jumpshot и slog.print. slog.print – это сценарий для исполнения slog java api для печати информации из в log-файлов. jumpshot есть сценарий для исполнения jumpshot-3, являющегося средством для демонстрации slog-файлов. Если есть вопросы, пошлите их в mpi-maint@mcs.anl.gov.
В начало страницы
Jumpshot поставляется с 2 сценарными файлами, `jumpshot.in' (для использования
с JAVA 1.1.*) и `jumpshot12.in' (для использования с JAVA 1.2.*),
которые находятся в подкаталоге `jumpshot/build/unix/bin'. Назначение
этих сценарных файлов – установить переменную CLASSPATH перед активизацией
jumpshot. Для установки переменной CLASSPATH нужно задать переменные
JAVA HOME и JUMPSHOT HOME. Роль конфигурации из каталога `jumpshot'
состоит в задании этих переменных, подстановке их в соответствующий .in file,
создание выполнимых jumpshot или jumpshot12 и помещении их в нужный
каталог bin. После установки вашего пути для включения этих каталогов вы
будете в состоянии вызвать jumpshot из любого каталога, набрав
jumpshot
или jumpshot !name of clog file?
В начало страницы
Jumpshot можно конфигурировать тремя способами:
Как часть конфигурации mpich. Конфигурирование в каталоге mpich может вызвать can конфигурацию в подкаталоге `mpe', которая может вызвать конфигурацию в подкаталоге `jumpshot'. Это есть способ для конфигурации mpich по умолчанию, он может быть подавлен конфигурацией mpich с параметром –nompe.
Как часть конфигурации mpe. Конфигурация в каталоге mpe может вызвать конфигурацию в каталоге jumpshot. Это происходит по умолчанию, если библиотека mpe была конфигурирована с mpich. В противном случае должен быть указан параметр конфигурации –with-jumpshot home=JUMP HOME.
Самостоятельно. Jumpshot можно конфигурировать, набрав configure !configure options? в каталоге jumpshot. Набрав
./configure –help
в каталоге верхнего уровня `jumpshot', можно вывести список флажков/переключателей. Обязательные конфигурационные флажки/переключатели:
-with-bindir=DIR Указывает каталог для размещения исполнимой программы jumpshot. Без этого jumpshot не будет сконфигурирован. При конфигурации с MPICH или только с библиотекой mpe он будет определен по умолчанию (но может быть подавлен).
-with-jumpshot home=JUMP HOME Указывает путь в каталоге верхнего уровня, где установлен jumpshot. Без этого каталога jumpshot не может конфигурироваться. При конфигурации с MPICH автоматически определяется по умолчанию (но может быть подавлен).
Необязательные флажки/переключатели:
-enable-echo Включает сильное эхо. По умолчанию эхо отсутствует.
-with-java=DIR Указывает путь к верхнему каталогу JAVA. Если опущен, конфигурация пытается найти java.
-with-java version=VERSION Указывает версию JAVA. Если опущен, конфигурация сама пытается найти вашу версию java.
В начало страницы
Как отмечалось выше, jumpshot может быть установлен как часть конфигурации
mpich или mpe или самостоятельно. Ниже приводятся инструкции и примеры для
каждого случая.
Конфигурация jumpshot как части конфигурации mpich. Для такой установки не требуются никакие переключатели или флажки. Конфигурации в каталогах mpich и mpe находят необходимую информацию и передают ее конфигурации в каталоге jumpshot. Если конфигурация в каталоге mpich не указывает параметров, jumpshot будет сконфигурирован с значениями по умолчанию. Пользователь при желании может подавить в конфигурации с mpich следующие параметры:
-mpe.opts=MPE.OPTS –jumpshot.opts=JUMP.OPTS
где JUMP OPTS есть один из выборов, указанных в разделе 11.2.1 (кратное употребление –jumpshot.opts не разрешает указывать более одного параметра для конфигурации jumpshot's configure). См. раздел 10.1 о MPE OPTS.
Пример 1: Конфигурирование MPICH с библиотекой mpe и jumpshot
В каталоге верхнего уровня для mpich наберите
./configure !mpich configure options? make
Пример 2: Конфигурирование MPICH без библиотеки mpe library и с jumpshot
В настоящее время, если MPICH конфигурируется без библиотеки mpe, то jumpshot не получит конфигурации (поскольку конфигурация mpe активизирует конфигурацию jumpshot). Следующие шаги необходимы для конфигурации MPICH и jumpshot без библиотеки mpe
В каталоге mpich верхнего уровня наберите
./configure !mpich configure options? –nompe make
В подкаталоге jumpshot
configure –with-bindir=!directory path of mpich/bin? « –with-jumpshot.home=!directory path of jumpshot?
Пример 3: Конфигурирование MPICH с библиотекой mpe и с путем к каталогу java указанным как параметр для конфигурации jumpshot
В каталоге верхнего уровня для mpich
./configure !mpich configure options? « –jumpshot.opts=-with-jumpshot.opts=-with-java=!directory path of java? make
Необходимо включить –with-jumpshot.opts, поскольку конфигурация mpich избавится от –jumpshot.opts и конфигурация mpe избавится от –with-jumpshot.opts и передаст параметр в конфигурацию jumpshot.
Пример 4: Конфигурирование MPICH с библиотекой mpe и подавлением параметра jumpshot home в конфигурации jumpshot.
В каталоге верхнего уровня для mpich
./configure !mpich configure options? « –jumpshot.opts=-with-jumpshot.opts=-with-jumpshot.home=DIR
make
Конфигурирование jumpshot как части конфигурации mpe.
Пример 1: Конфигурация библиотеки mpe с jumpshot и MPICH (уже конфигурированной и установленной)
В каталоге верхнего уровня для mpe
./configure –with-mpich=!top-level directory of MPICH? « –with-mpichdev=!library subdirectory of MPICH? make
Пример 2: Конфигурация библиотеки mpe с jumpshot и SGI's MPI
В верхнем каталоге для mpe
./configure –with-sgi –libdir=!directory path of libdir? « –with-jumpshot.home=!directory path of jumpshot? make
Пример 3: Конфигурирование библиотеки mpe без jumpshot и IBM's MPI
В верхнем каталогеhe mpe
./configure –with-sp –libdir=!directory path of libdir? « –enable-jumpshot=no make
Пример 4: Конфигурирование библиотеки mpe с java данным как параметр для конфигурации jumpshot
В верхнем каталоге mpe
./configure !MPI implementation switch? « –with-jumpshot.opts=-with-java=!directory path of java? make
Самостоятельная конфигурация jumpshot. Example 1: Конфигурировать jumpshot
В верхнем каталоге для jumpshot
./configure –bindir=!directory path of bindir? « –with-jumpshot.home=!directory path of jumpshot?
Пример 2: Конфигурирование jumpshot с сильным эхо
В верхнем каталоге для jumpshot
./configure –bindir=!directory path of bindir? « –with-jumpshot.home=!directory path of jumpshot? « –enable-echo=yes
Log-файл, приготовленный с помощью cpilog, не очень интересен, так как cpi – простая программа. Более интересные log-файлы можно посмотреть в подкаталогах `profiling/upshot/logfiles' или `jumpshot/lib/logfiles'. Файл cpilog.c демонстрирует как инструментировать ваш собственный код для выдачи таких logs. Руководство пользователя 9 описывает, как связаться с версией mpich, которая производит их автоматически. Для краткого знакомства с программами в каталоге examples/basic см. там файл README.