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

* Март, 2002 *


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


Содержание

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-системы необходимы:

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

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

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

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

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

  2. Выберите или создайте директорию для данной (NNN-ой) версии DVM-системы (например, DVM_NNN);
  1. Перепишите туда необходимые файлы из следующего списка:

dvmNNN.tar.gz - DVM-система;
dvmUSRrhtm.tar.gz - документация пользователя на русском языке;
dvmSYSrhtm.tar.gz - документация разработчика на русском языке;
dvmUSRehtm.tar.gz - документация пользователя на английском языке;
dvmSYSehtm.tar.gz - документация разработчика на английском языке;
  1. Распакуйте файл 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* - файлы поддержки инсталляции и деинсталляции.
  1. Распакуйте один или несколько файлов с документацией, в результате чего дополнительно появится поддиректория dvm_sys\doc.
  1. В файле dvminstall.bat

Замечание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), если она была установлена ранее.

  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.

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

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

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

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

alltest.bat

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

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

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

… end of testing DVM …

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

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

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

  1. на экран и в файлы demo.1 или democ.1 выдаются сообщения:
  1. на экран выдается приглашение, позволяющее пользователю либо прервать (Ctrl+C), либо продолжить (любая клавиша) тестирование демонстрационных программ;
  1. в текущей директории появятся один или несколько из следующих файлов:
<имя_программы>.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-системы):

Свойства -> Память -> Переменные среды = 3072
Свойства -> Память -> Переменные среды = 3072

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

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

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

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

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

  1. Выберите или создайте директорию для данной (NNN-ой) версии DVM-системы (например, DVM_NNN);
  1. Перепишите туда необходимые файлы из следующего списка:
dvmNNN.tar.gz - DVM-система;
dvmUSRrhtm.tar.gz - документация пользователя на русском языке;
dvmSYSrhtm.tar.gz - документация разработчика на русском языке;
dvmUSRehtm.tar.gz - документация пользователя на английском языке;
dvmSYSehtm.tar.gz - документация разработчика на английском языке;
  1. Распакуйте файл 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* - файлы поддержки инсталляции и деинсталляции.
  1. Аналогично распакуйте один или несколько файлов с документацией, в результате чего дополнительно появится поддиректория dvm_sys/doc.
  1. В файле 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).
    1. В директории 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.

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

      Требуется отредактировать файлы 'machinelist' и 'dvmwork' в директории dvm_sys/user.

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

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

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

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

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

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

    alltest

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

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

    … end of testing DVM …

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

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

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

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

    1. Скомпилировать выбранную демонстрационную программу:

      dvm c <program name>

      или

      dvm f <program name>

    2. Запустить ее на выполнение на N1*N2 рабочих станциях:

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

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

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