DVM-система. Руководство по установке (версия 3.15)

DVM-система разработки параллельных программ
Руководство по установке

* Октябрь, 2000 *

- дата последнего обновления 27.12.00 -

Содержание

1 Установка DVM-системы в OC Windows95/NT

1.1 Установка системы
1.2 Проверка правильности установки DVM-системы
1.3 Запуск демонстрационных программ
1.4 Проблемы, возникающие при установке DVM-системы

2 Установка DVM-системы в OC UNIX

2.1 Установка системы
2.2 Проверка правильности установки DVM-системы
2.3 Запуск демонстрационных программ
2.4 Проверка выполнения DVM-программ на нескольких рабочих станциях

1 Установка DVM-системы в OC Windows95/NT

1.1 Установка системы

Для установки DVM-системы необходимы:

операционная система Windows95/NT;
Microsoft Visual C++ версия 5.0 и выше (использование версии 4.0 связано с некоторыми ограничениями, см. ниже);
Microsoft Fortran PS 4.0 или Digital Fortran 5.0 и выше. (Если предполагается работать с программами, написанными на языке Fortran-DVM);
MPICHWIN - библиотека передачи сообщений MPI для Windows95/NT;
WINZIP - стандартный инструмент Windows для разархивирования файлов.

Для установки DVM-системы выполните следующие шаги.

Выберите или создайте директорию для библиотеки передачи сообщений (например, MPICHWIN), перепишите туда файл mpichwin.zip и распакуйте его.

В результате будут созданы следующие поддиректории и файлы:

include\	- include-файлы;
lib\	- библиотека программ;
copyright*	- лицензионные соглашения.

При последующих установках новых версий DVM-системы (если это не оговорено особо в данной инструкции) этот шаг можно опустить.

Выберите или создайте директорию для данной (NNN-ой) версии DVM-системы (например, DVM_NNN);

Перепишите туда необходимые файлы из следующего списка:

dvmNNN.tar.gz - DVM-система;

dvmUSRrhtm.tar.gz - документация пользователя на русском языке;

dvmSYSrhtm.tar.gz - документация разработчика на русском языке;

dvmUSRehtm.tar.gz - документация пользователя на английском языке;

dvmSYSehtm.tar.gz - документация разработчика на английском языке;

Распакуйте файл dvmNNN.tar.gz;

В результате будут созданы следующие поддиректории и файлы:

dvm_sys
	cdvm\	- конвертор C-DVM;
	driver\	- служебные программы DVM-системы;
	examples\	- демонстрационные программы;
	fdvm\	- конвертор Fortran-DVM;
	pppa\	- анализатор производительности DVM-программ
	predictor\	-предсказатель производительности DVM-программ
	rts\	- система поддержки DVM-программ
	copyright	- лицензионные соглашения
	dvmclean*	- программы очистки директорий DVM-системы
	dvmcleanall*	- программы деинсталляции DVM-системы
	dvminstall*	- программы инсталляции DVM-системы
	makefile*	- файлы поддержки инсталляции и деинсталляции.

Распакуйте один или несколько файлов с документацией, в результате чего дополнительно появится поддиректория dvm_sys\doc.

В файле dvminstall.bat

скорректируйте переменную SETVARSVC, определяющую полное имя программы, устанавливающей переменные среды разработки программ на языке С (С++) аналогично примеру, приведенному в данном файле;

если предполагается работать с программами, написанными на языке Fortran-DVM, скорректируйте переменную SETVARSFTN, определяющую полное имя программы, устанавливающей переменные среды разработки программ на языке Fortran аналогично примеру, приведенному в данном файле;

если упомянутые выше программы потребуют задания параметров, их можно перечислить в переменных ARGSETVARSVC и ARGSETVARSFTN соответственно;

если Fortran-DVM не нужен, установка переменных SETVARSFTN и ARGSETVARSFTN должна быть закомментирована;

Скорректируйте параметры, определяющие требуемые компиляторы (переменные CC, CXX, FORT, LINKER, MAKE) и версию библиотеки MPICH (переменные MPI_HOME, MPI_LIB, MPI_INC).

Замечание1. Если ни одна из переменных SETVARSVC и SETVARSFTN не устанавливается, то пути к установленным программным продуктам берутся из файла autoexec.bat.

Замечание2. Компиляция предиктора возможна только компиляторами, удовлетворяющими стандарту языка С++ (ISO/IEC14882 “Standard for the C++ programming language”), ратифицированному в августе 1998г. Например, это могут быть компиляторы версий Microsoft Visual C 5.0 и выше, GNU C++ версии 2.8.1 и выше и др. При работе с версией Microsoft Visual 4.0 компиляция предиктора невозможна, поэтому ее следует отключить, закомментировав в файле dvm_sys\makefile.win три строки:

@cd predictor
@$ (MAKE) ………….all
@cd ..

Если этот инструмент необходим, то следует произвести установку DVM-системы, поставляемой в виде готовых библиотек и выполняемых файлов.

Внимание!!! Версия 3.04 DVM-системы и последующие требуют обновления библиотеки передачи сообщений (см.п.1), если она была установлена ранее.

В директории dvm_sys выполните команду инсталляции DVM-системы:

dvminstall.bat

В случае ее успешного выполнения на экран будет выдано сообщение:

“DVM-system is successfully installed”

и помимо вышеперечисленных в директории dvm_sys появятся следующие поддиректории:

bin\ demo\	- выполняемые файлы DVM-системы; - копия демонстрационных программ для проверки правильности установки DVM-системы;
lib\ par\ user\	- библиотека программ системы поддержки; - параметры системы поддержки; - файлы, копируемые в директории пользователей.

Если при ее выполнении возникнут какие-то ошибки, то следует проанализировать файлы logfile.txt, которые появятся в поддиректориях \src директорий rts, cdvm, fdvm, driver, pppa, predictor.

DVM-система готова к использованию!

Теперь каждый пользователь может скопировать в свою директорию с DVM-программами все файлы из директории dvm_sys\user и начинать работать с DVM-системой.

1.2 Проверка правильности установки DVM-системы

Для проверки правильности установки DVM-системы рекомендуется сначала запустить стандартную процедуру тестирования программ для вариантов задачи Jacobi на языках C-DVM (jac1.cdv) и Fortran-DVM (jac.fdv). Для этого в директории dvm_sys\demo надо выполнить команду:

alltest.bat

Эта команда выполняет следующие шаги:

инициирует стандартную процедуру тестирования, запускающую сначала одну, затем другую программу в различных отладочных режимах (см. ниже);
сравнивает результаты работы каждой программы с эталонными, поставляемыми вместе с системой в файлах jacc_res.win, jacf_res.win;
запускает предиктор (предсказатель производительности выполнения DVM-программ) для программы jac1.cdv и сравнивает результаты его работы с эталонными, поставляемыми вместе с системой в файле prd_res.win;

Названия шагов и результаты сравнения выдаются пользователю на экран. После успешного завершения выполнения каждого шага на экран выдается приглашение, позволяющее пользователю либо прервать (Ctrl+C), либо продолжить (любая клавиша) выполнение теста. Если же некоторый шаг закончился с ошибкой, приглашение на экран не выдается и последующие шаги не выполняются.

Если результаты на всех шагах совпали, на экран выдается сообщение:

… end of testing DVM …

означающее, что DVM-система установлена правильно, и можно переходить либо к запуску демонстрационных программ, либо к работе с программами, написанными пользователем.

Если результаты на каком-либо шаге не совпали, необходимо, прежде всего, проверить правильность осуществления всех шагов данной инструкции. Подробную информацию об используемых стандартной тестовой процедурой режимах запуска DVM-программ, а также обо всех диагностических сообщениях DVM-системы можно найти в следующих документах:

“Отладка DVM-программ. Руководство пользователя”;
“Компилятор C-DVM. Руководство пользователя”;
“Компилятор Fortran-DVM. Руководство пользователя”.

1.3 Запуск демонстрационных программ

Директория dvm_sys\demo содержит набор демонстрационных программ на языках C-DVM и Fortran-DVM. Эти программы можно использовать для дополнительной проверки DVM-системы. Для этого в директории dvm_sys\demo следует выполнить одну из двух команд:

alldemo.bat	запускающую стандартную процедуру тестирования всех демонстрационных C-DVM и Fortran-DVM программ;
allcdemo.bat	запускающую стандартную процедуру тестирования только демонстрационных C-DVM программ.

Результаты тестирования демонстрационных программ направляются, соответственно, в файлы demo.1 и democ.1. Пользователь может сравнить полученные на своей установке результаты с эталонными результатами, поставляемыми разработчиками в файлах demo_res.win и democ_res.win в той же директории dvm_sys\demo. Сравнение можно выполнить командами:

fc demo.1 demo_res.win
fc demoс.1 democ_res.win

Если результаты не совпадают, то следует их проанализировать, принимая во внимание следующую информацию.

В случае успешного завершения тестирования каждой демонстрационной программы в файлы demo.1 или democ.1 выдается сообщение:

End of test <имя_программы>.

В случае обнаружении ошибок при тестировании какой-либо демонстрационной программы:

на экран и в файлы demo.1 или democ.1 выдаются сообщения:

ошибки выполнения отдельных шагов стандартной тестовой процедуры (в процессе тестирования),
!!!ERROR!!! of test <имя_теста> (после завершения тестирования программы);

на экран выдается приглашение, позволяющее пользователю либо прервать (Ctrl+C), либо продолжить (любая клавиша) тестирование демонстрационных программ;

в текущей директории появятся один или несколько из следующих файлов:

<имя_программы>.edb
<имя_программы>.et1
<имя_программы>.et2
<имя_программы>.etr

- ошибки динамического контроля;
- ошибки сравнения трассировок на одном процессоре;
- ошибки сравнения трассировок на двух процессорах;
- файл эталонной трассировки.

В этом случае (но при успешном завершении проверки правильности установки DVM-системы) следует обращаться к разработчикам, сохранив вышеупомянутые файлы с ошибками.

1.4 Проблемы, возникающие при установке DVM-системы

1.4.1 Устройство не готово при чтении

Если при инсталляции DVM-системы на экране после сообщения:

Setting environment for Micrsoft Visual C++ tools

появится сообщение:

Устройство не готово при чтении: диск <имя CD_ROM-устройства>

то это означает, что Micrsoft Visual C++ при своей работе пытается использовать компакт-диск. Для отключения CD_ROM-устройства необходимо в файле

…\Program Files\DevStudio\VC\bin\vcvars32.bat

закомментировать или удалить строку

set vcsource=D:\DEVSTUDIO

и заново выполнить команду инсталляции DVM-системы.

1.4.2 Недостаточно памяти для переменных среды

Возможно, во время первой инсталляции DVM-системы или во время выполнения DVM-программы на экране появится сообщение:

“Недостаточно памяти для переменных среды”
(“Out of environment space”)

В этом случае следует увеличить эту память одним из трех следующих способов (3072 - минимальный размер памяти для переменных среды DVM-системы):

задав в файле config.sys строку:
Shell=command.com /E:3072 /P
с последующей перезагрузкой компьютера;

при запуске задач в окне MS-DOS или Far Manager надо предварительно изменить свойства соответствующего объекта (выделив иконку MS-DOS Prompt или Far Manager и нажав правую кнопку мыши) с помощью подокна

Свойства

Память

Переменные среды

= 3072

при запуске любого bat-файла из “Проводника” надо предварительно изменить свойства этого объекта (bat-файла) с помощью подокна

Свойства

Память

Переменные среды

= 3072

Рекомендуется использовать первые два способа, т.к. это нужно проделать только один раз.

2 Установка DVM-системы в OC UNIX

2.1 Установка системы

Для установки DVM-системы необходимы:

операционная система UNIX^TM;
cc компилятор;
f77 компилятор;
c++ компилятор;
компилятор gcc (c++) - версия 2.8.1 и выше;
библиотека MPICH;
утилита make;
утилита ar;
утилиты gunzip, tar для разархивирования.

Для установки DVM-системы выполните следующие шаги.

Выберите или создайте директорию для данной (NNN-ой) версии DVM-системы (например, DVM_NNN);

Перепишите туда необходимые файлы из следующего списка:

dvmNNN.tar.gz	- DVM-система;
dvmUSRrhtm.tar.gz	- документация пользователя на русском языке;
dvmSYSrhtm.tar.gz	- документация разработчика на русском языке;
dvmUSRehtm.tar.gz	- документация пользователя на английском языке;
dvmSYSehtm.tar.gz	- документация разработчика на английском языке;

Распакуйте файл dvmNNN.tar.gz, выполнив, например, команду:

gunzip -c dvmNNN.tar | tar xf -

В результате будут созданы следующие поддиректории и файлы:

dvm_sys
	cdvm/	- конвертор C-DVM;
	driver/	- служебные программы DVM-системы;
	examples/	- демонстрационные программы;
	fdvm/	- конвертор Fortran-DVM;
	pppa/	- анализатор производительности DVM-программ
	predictor/	-предсказатель производительности DVM-программ
	rts/	- система поддержки DVM-программ
	copyright	- лицензионные соглашения
	dvmclean*	- программы очистки директорий DVM-системы
	dvmcleanall*	- программы деинсталляции DVM-системы
	dvminstall*	- программы инсталляции DVM-системы
	makefile*	- файлы поддержки инсталляции и деинсталляции.

Аналогично распакуйте один или несколько файлов с документацией, в результате чего дополнительно появится поддиректория dvm_sys/doc.

В файле dvminstall

если платформа, на которой устанавливается система, содержится в списке предусмотренных платформ:
###set platform (SGI_ws, MVS1000_m, MVS1000_r, GNU, Parsytec, LinuxSCI ...)
то переменной platform присвойте соответствующее имя. В этом случае все зависящие от платформы переменные (например, определяющие требуемые компиляторы) будут скорректированы в соответствии с имеющимися в файле dvminstall образцами

если платформа отсутствует в этом списке, скорректируйте параметры, определяющие требуемые инструменты (компиляторы) для хост-компьютера (переменные CC, CXX, FORT, ar, LINKER и FLINKER), а также параметры, определяющие требуемые инструменты для параллельной машины (переменные PCC, PFORT, Par, PLINKER и PFLINKER). В случае установки системы для сети рабочих станций достаточно, установить переменные CC, CXX, FORT, ar, LINKER и FLINKER.

скорректируйте параметры, определяющие версию библиотеки MPICH (переменные MPI_HOME, MPI_LIB, MPI_INC).

В директории dvm_sys выполните команду

dvminstall

В случае ее успешного выполнения на экран будет выдано сообщение:

“DVM-system is successfully installed”

и помимо вышеперечисленных в директории dvm_sys появятся следующие поддиректории:

bin/ demo/	- выполняемые файлы DVM-системы; - копия демонстрационных программ для проверки правильности установки DVM-системы;
lib/ par/ user/	- библиотека программ системы поддержки; - параметры системы поддержки; - файлы, копируемые в директории пользователей.

Если при ее выполнении возникнут какие-то ошибки, то следует проанализировать файлы logfile.txt, которые появятся в поддиректориях /src директорий rts, cdvm, fdvm, driver, pppa, predictor.

Для запуска DVM-программ на нескольких рабочих станциях каждому пользователю требуется иметь рабочую директорию, разделяемую всеми этими ЭВМ. При этом пользователь должен быть зарегистрирован на каждой такой ЭВМ под одним именем и с одинаковыми паролями.
Требуется отредактировать файлы 'machinelist' и 'dvmwork' в директории dvm_sys/user.

Файл 'machinelist' должен содержать список рабочих станций. В этом списке должно быть и имя рабочей станции (в формате, выдаваемом командой 'hostname'), с которой осуществляется запуск DVM-программы.

Файл 'dvmwork' должен содержать полное имя разделяемой рабочей директории.
DVM-система готова к использованию!

Теперь каждый пользователь может скопировать в свою директорию с DVM-программами все файлы из директории dvm_sys/user и начинать работать с DVM-системой.

2.2 Проверка правильности установки DVM-системы

Для проверки правильности установки DVM-системы рекомендуется сначала запустить стандартную процедуру тестирования программ для вариантов задачи Jacobi на языках C-DVM (jac1.cdv) и Fortran-DVM (jac.fdv) (если Fortran установлен). Для этого в директории dvm_sys/demo надо выполнить команду:

alltest

Эта команда выполняет следующие шаги:

инициирует стандартную процедуру тестирования, запускающую сначала одну, затем другую программу в различных отладочных режимах (см. ниже);
сравнивает результаты работы каждой программы с эталонными, поставляемыми вместе с системой в файлах jacc_res.uni, jacf_res.uni;
запускает предиктор (предсказатель производительности выполнения DVM-программ) для программы jac1.cdv и сравнивает результаты его работы с эталонными, поставляемыми вместе с системой в файле prd_res.uni;

Если результаты на всех шагах совпали, на экран выдается сообщение:

… end of testing DVM …

Если результаты на каком-либо шаге не совпали, то на экран выдается сообщение

!!! The result is differ from expected !!!

и проверка правильности установки DVM-системы завершается. Подробную информацию об используемых стандартной тестовой процедурой режимах запуска DVM-программ, а также обо всех диагностических сообщениях DVM-системы можно найти в следующих документах:

“Отладка DVM-программ. Руководство пользователя”;
“Компилятор C-DVM. Руководство пользователя”;
“Компилятор Fortran-DVM. Руководство пользователя”.

2.3 Запуск демонстрационных программ

Директория dvm_sys/demo содержит набор демонстрационных программ на языках C-DVM и Fortran-DVM. Эти программы можно использовать для дополнительной проверки DVM-системы. Для этого в директории dvm_sys/demo следует выполнить одну из двух команд:

alldemo	запускающую стандартную процедуру тестирования всех демонстрационных C-DVM и Fortran-DVM программ;
allcdemo	запускающую стандартную процедуру тестирования только демонстрационных C-DVM программ.

Результаты тестирования демонстрационных программ направляются, соответственно, в файлы demo.1 и democ.1 и сравниваются с эталонными результатами, поставляемыми разработчиками в файлах demo_res.uni и democ_res.uni в той же директории. В случае совпадения результатов на экран выдаются соответственно сообщения:

alldemo done

или

allcdemo done

При расхождении полученных результатов с эталонными на экран выдаются соответственно сообщения:

result is different from demo_res.uni

или

result is different from democ_res.uni

Если результаты не совпадают, то следует их проанализировать, принимая во внимание, что в случае успешного завершения тестирования каждой демонстрационной программы в файлы demo.1 или democ.1 выдается сообщение:

End of test <имя_программы>

2.4 Проверка выполнения DVM-программ на нескольких рабочих станциях

Для проверки выполнения DVM-программы на нескольких рабочих станциях необходимо:

Скомпилировать выбранную демонстрационную программу:
dvm c <program name>

или

dvm f <program name>
Запустить ее на выполнение на N1*N2 рабочих станциях:

dvm run N1 N2 -m –cp <program name>

Пример (если выбрана программа jac1.cdv):

dvm c jac1
dvm run 2 2 -m -cp jac1