DVM-system of parallel program development
Installation guide
* October, 2000 *

- last edited 27.12.00 -

Contents

1 DVM-system installation under Windows95/NT

1.1 System installation
1.2 DVM-system verification
1.3 Demonstration program run
1.4 Problems arising during DVM-system installation

2 DVM-system installation under UNIX

2.1 System installation
2.2 DVM-system verification
2.3 Demonstration program run
2.4 DVM-program run on several workstations

1 DVM-system installation under Windows95/NT

1.1 System installation

DVM-system requirements:

• operation system Windows95/NT;
• Microsoft Visual C++ 5.0 version and later (4.0 version can be used with some restrictions, see below);
• Microsoft Fortran PS 4.0 or Digital Fortran 5.0 and later. (For programs in Fortran-DVM language);
• MPICHWIN - MPI message passing library for Windows95/NT;
• WINZIP – standard Windows utility to unpack files.

To install DVM-system the following steps should be done:

1. Select or create a directory for MPI library (for example, MPICHWIN), copy to it and unpack mpichwin.zip.

   As a result the following folders and files will be created:

   include\	- include-files;
   lib\	- library;
   copyright*	- copyright information.

   For the installation of new version of DVM-system this step can be skipped (if not stated otherwise in the instruction).

2. Select or create a directory for given (NNN-th) version of DVM system (for example, DVM_NNN);

3. Copy to it required files from the following list

4. Unpack dvmNNN.tar.gz file.

   As a result the following folders and files will be created:

   dvm_sys
   	cdvm\	- C-DVM converter
   	driver\	- DVM-system tools
   	examples\	- demonstration programs
   	fdvm\	- Fortran-DVM converter
   	pppa\	- DVM-program performance analizer
   	predictor\	- DVM-program performance predictor
   	rts\	- DVM-program support system
   	copyright	- copyright information
   	dvmclean*	- programs to delete intermediate files
   	dvmcleanall*	- DVM-system uninstall programs
   	dvminstall*	- DVM-system uninstall programs
   	makefile*	- installation and uninstallation support system files

5. Unpack one or several documentation files; and as result, additional directory dvm_sys\doc will appear.

6. In dvminstall.bat file:

• correct SETVARSVC variable, which define the full name of the program setting environment variables for Ñ (Ñ++) similary to the example, given in the file;
• to work with Fortran-DVM programs correct SETVARSFTN variable, which define the full name of the program setting environment variables for Fortran;
• the parameters for above programs can be defined in ARGSETVARSVC and ARGSETVARSFTN variables respectively;
• if you do not need Fortran you should comment out SETVARSFTN è ARGSETVARSFTN settings;
• correct the parameters specifying required compilers (variables CC, CXX, FORT, LINKER, MAKE) and MPICH library version (variables MPI_HOME, MPI_LIB, MPI_INC).

Note 1. If neither SETVARSVC nor SETVARSFTN is defined, the paths to the programs are taken from autoexec.bat.

Note 2. Predictor requires C++ compiler of standard ISO/IEC14882 “Standard for the C++ programming language”, ratified in August 1998. For example compilers Microsoft Visual C 5.0 and later, GNU C++ 2.8.1 version and later etc. Predictor can not be used with Microsoft Visual 4.0 compiler, you can exclude predictor by commenting out three lines in dvm_sys\makefile.win:

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

If you need predictor you can use DVM-system delivered as a set of libraries and executable files.

Attention!!! DVM-system 3.04 and later versions require MPI library renewing (see 1.).

7. In the directory dvm_sys run command:

   dvminstall.bat

   On successful execution message:
   “DVM-system is successfully installed”
   will be output and the following folders will be created in dvm_sys directory:

   bin\ demo\	- DVM-system executable files; - demonstration programs to verify DVM-system;
   lib\ par\ user\	- support system library; - support system parameters; - files that should be copied into user directories.

   On errors examine logfile.txt files appeared in \src subdirectories of rts, cdvm, fdvm, driver, pppa, predictor directories.

8. DVM-system is ready for use!

Now the user should copy all files from directory dvm_sys/user to his own directory with DVM programs.

1.2 DVM-system verification

To verify correctness of DVM system installation it is recommended to run standard test procedures for two variants of Jacobi program in C-DVM (jac1.cdv) and Fortran-DVM languages (jac.fdv) (if Fortran was installed). You should run

alltest.bat

from dvm_sys\demo directory.

This command will do the following:

• starts standard testing procedure which execute both programs in different debugging modes (see below);
• compares results of the program execution with standard results supplied with the system in files jacc_res.win, jacf_res.win;
• starts predictor (of DVM-program performance) for jac1.cdv and compares the predicted results with standard results supplied with the system in file prd_res.win;

Step names and results of comparison are displayed for the user at screen. After successful execution of each step a prompt is output to the screen and the user can interrupt (Ctrl+C) or continue (any key) the test execution. In case of error the prompt is not output to the screen and the test will be stop.

On successful execution of all the steps the user will see the message:

… end of testing DVM …

It means that DVM-system has been installed correctly and either demonstration or user programs can be executed.

If results are not identical to standard at any step it is necessary to check correctness of performing all steps of the instruction. Detailed information about DVM-program startup modes, used by test procedures and all diagnostics messages is contained in the following documents:

• "Debugging DVM-program. User guide";
• “C-DVM compiler. User guide”;
• “Fortran-DVM compiler. User guide”.

1.3 Demonstration program run

Directory dvm_sys\demo contains set of C-DVM and Fortran-DVM programs that show capabilities of DVM-system. In the directory the user can also find batch files:

By default demonstration program execution results are saved in demo.1 and democ.1 files respectively. After execution the user can compare the results of demonstration program execution on user computer system with standard results from demo_res.win and democ_res.win in the same directory. Comparison can be made by command:

fc demo.1 demo_res.win
fc demoñ.1 democ_res.win

If the results are not matched they should be examined taking into account the following information.

On successful execution each of demonstration program output into demo.1 and democ.1 files the message.

End of test <program_name>.

If case of demonstration program execution error:

1. the following messages are output to the screen and into demo.1 or democ.1 file:

• errors of testing procedure execution steps (during testing process);
• !!!ERROR!!! of test<test_name> (after testing completion);

2. the prompt is displayed and the user can interrupt (Ctrl+C) or continue (any key) the demonstration program execution;

3. one or several of the following files will be created:

In this case (but if DVM-system installation was succesfully verified) the user should keep above files with errors and ask for system programmer support.

1.4 Problems arising during DVM-system installation

1.4.1 Device is not ready

If during installation after the message:

Setting environment for Micrsoft Visual C++ tools

you see the message:

Device is not ready: disk <name of CD_ROM>

it means that Microsoft Visual C++ attempts to read CD_ROM. To turn off CD_ROM in file:

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

user should comment out or delete the string:

set vcsource=D:\DEVSTUDIO

and start up DVM-system installation once more.

1.4.2 Not enough memory for environment variables

It is possible that during the first installation or while executing DVM-program you will see the following message:

“Out of environment space”

There are three ways to increase the memory (3072 is minimal memory size for DVM-system environment variables):

• in file config.sys you can specify the string:
  Shell=command.com /E:3072 /P
  and then restart your computer;

• when you run your program previously change properties of corresponding object (select MS-DOS Prompt or Far Manager icon and click right button of a mouse) as follows

• if you run any bat-file from Explorer , previously change the object (bat-file) properties as follows:

The first two methods are preferable as it is sufficient to do only once.

2 DVM-system installation under UNIX

2.1 System installation

DVM-system requirements:

• any UNIX- like operating system;
• cc compiler;
• f77 compiler;
• c++ compiler;
• compiler gcc (c++) - version 2.8.1 and later;
• MPICH library;
• make utility;
• ar utility;
• gunzip, tar utilities to unpack files.

To install DVM-system the following steps should be done.

1. Select or create a directory for given (NNN-th) version of DVM system (for example, DVM_NNN).

1. Copy to it required files from the following list

3. Unpack dvmNNN.tar.gz file. For example run:

   gunzip -c dvmNNN.tar| tar xf -

   As a result the following folders and files will be created:

   dvm_sys
   	cdvm\	- C-DVM converter
   	driver\	- DVM-system tools
   	examples\	- demonstration programs
   	fdvm\	- Fortran-DVM converter
   	pppa\	- DVM-program performance analizer
   	predictor\	- DVM-program performance predictor
   	rts\	- DVM-program support system
   	copyright	- copyright information
   	dvmclean*	- programs to delete intermediate files
   	dvmcleanall*	- DVM-system uninstall programs
   	dvminstall*	- DVM-system uninstall programs
   	makefile*	- installation and uninstallation support system files

4. Similary unpack one or several documentation files; and as result, additional directory dvm_sys\doc will appear.

5. In dvminstall file:

• if a platform the system to be installed on is in provided platform list
  ###set platform (SGI_ws, MVS1000_m, MVS1000_r, GNU, Parsytec, LinuxSCI ...)
  assign to the platform variable corresponding name. In this case all platform variables (for example, specifying required compilers) will be corrected for each platform in accordance with patterns from dvminstall file;
• if the platform is absent in the list, correct parameters, specifying required tools (compilers) for host-computer (CC, CXX, FORT, ar, LINKER and FLINKER variables), and for parallel computer (PCC, PFORT, Par, PLINKER and PFLINKER variables). To install the system on workstation network it is enough to set CC, CXX, FORT, ar, LINKER and FLINKER variables.
• correct parameters specifying required MPICH library version (variables MPI_HOME, MPI_LIB, MPI_INC).

6. In the directory dvm_sys run command:

   dvminstall

   On successful execution the message:
   “DVM-system is successfully installed”
   will be output and the following subdirectories will be created in dvm_sys directory:

   bin/ demo/	- DVM-system executable files; - demonstration programs to verify DVM-system;
   lib/ par/ user/	- support system library; - support system parameters; - files that should be copied in user directories.

   On errors examine logfile.txt files appeared in /src subdirectories of rts, cdvm, fdvm, driver, pppa, predictor directories.

7. To start DVM-program on several workstations user should have working directory shared by all the computers. For that a user should be registered on each computer under the same login name and password.
   The files 'machinelist' and 'dvmwork' should be edited in dvm_sys/user directory.
   The 'machinelist' file should contain workstation list. A name of the workstation, where the DVM-program is started, must also be in the list (in the format of 'hostname' command output).
   The 'dvmwork' file must contain full name of the shared working directory.

8. DVM-system is ready for use!

Now the user can copy all files from directory dvm_sys/user to his own directory with DVM programs.

2.2 DVM-system verification

To verify correctness of DVM system installation it is recommended to run standard test procedures for two variants of Jacobi program in C-DVM (jac1.cdv) and Fortran-DVM languages (jac.fdv). You should run:

alltest

from dvm_sys\demo directory.

This command will do the following:

• starts standard testing procedure which execute both programs in different debugging modes (see below);
• compares results of the program execution with standard results supplied with the system in files jacc_res.uni, jacf_res.uni;
• starts predictor (of DVM-program performance) for jac1.cdv program and compares predicted results with standard results supplied with the system in file prd_res.uni;

On successful execution of all the steps the user will see the message:

… end of testing DVM …

It means that DVM-system has been installed correctly and either demonstration or user programs can be executed.

If results are not identical at any step the following message will appear at the screen:

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

and DVM-system verification will be stop. Detailed information about DVM-program startup modes, used by test procedures and all diagnostics messages is contained in the following documents:

• “Debugging DVM-program. User guide”;
• “C-DVM compiler. User guide”;
• “Fortran-DVM compiler. User guide”.

2.3 Demonstration program run

Directory dvm_sys\demo contains set of C-DVM and Fortran-DVM programs that show capabilities of DVM-system. The programs can be used for additional testing of DVM-system. In the directory dvm_sys\demo the user can run one of the two commands:

By default demonstration program execution results are saved in demo.1 and democ.1 files respectively and compared with standard results from demo_res.uni and democ_res.uni files supplied with the system in the same directory. If results are coincident the following message will appear on the screen:

alldemo done
or
allcdemo done

If results are not coincident with standard ones the following message will appear on the screen:

result is different from demo_res.uni
or
result is different from democ_res.uni

On successful execution each of demonstration program output into demo.1 and democ.1 files the following message:

End of test <program_name>

2.4 DVM-program run on several workstations

To verify execution of DVM-program on several workstations it is necessary:

1. To compile selected demo program:

   dvm c <program name>
   or
   dvm f <program name>

2. To start up program on N1*N2 workstations:

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

Example (if selected program is jac1.cdv):

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