VCR 2.0k Installation Notes PUMA:038/VCR2/INST Revision 1.8 Mark Debbage Mark Hill November 11, 1992 1 Conditions Of Use The Virtual Channel Router (VCR) software, the accompanying documentation and the virtual occam compiler are licensed free of charge with absolutely no warranty. Copyright of the VCR software and documentation is retained by the University of Southampton. Copyright of the virtual occam compiler is retained by Inmos. The make utility provided in the distribution is, to the best knowledge of the VCR authors, entirely public domain code. Permission is granted to anyone to make or distribute verbatim copies of this document as received, in any medium, provided that the copyright notice and this permission notice are preserved, and that the distributor grants the recipient permission for further redistribution as permitted by this notice. Further copies of the VCR software system may be made and distributed at will, provided that it is distributed in full with no modifications and that no charge is made other than media costs. Parties wishing to distribute modified versions of the VCR package, including commercial products utilising VCR components, should contact the authors for further clarification. Permission will usually then be granted. Since this software is licensed free of charge it is supplied without warranty of any kind, either expressed or implied. The entire risk as to the quality and performance of the VCR system is with the user. 2 VCR Distribution VCR 2.0 forms an extension to the new TCOFF-based Inmos Toolsets. The occam Toolset, Inmos product numbers D(4/5/6/7)205, is a fundamental requirement for this system. Additionally the Inmos C Toolset, Inmos product numbers D(4/5/6/7)214, is required if the VCR package is to be accessed from C. This software package does not integrate with earlier versions of the Inmos occam Toolset (such as D705b). Users who only have that Toolset available will be restricted to VCR Version 1.8 or earlier. Installation of VCR will require about 4MBytes of space to be available on the host filestore. The files comprising the MS-DOS release are listed in Table 1 and those for the Unix release in Table 2. They can be obtained via anonymous ftp from ftp.ecs.soton.ac.uk (152.78.64.201) in the directories pub/transputer/vcr/msdos and pub/transputer/vcr/unix respectively. The accompanying documentation can be found in pub/transputer/vcr/docs. 3 Transferring VCR onto the Host Filestore For MS-DOS installation, first copy zoox onto the PC's path. VCR should then be unarchived by changing to the root directory of the target hard disk and, assuming use of floppy drive a, invoking: 1 File Description readme Distribution note spr.doc Software performance report zoox.exe PC executable public domain archiving tool zoox.doc Document for above zoo.hlp Zoo distribution information zoo.doc Zoo documentation rk.zoo Example ParaPET environment vcr2 01.zoo First file of archived VCR vcr2 02.zoo Second file of archived VCR vcr2 03.zoo Third file of archived VCR vcr2 04.zoo Fourth file of archived VCR vcr2 05.zoo Fifth file of archived VCR vcr2 06.zoo Sixth file of archived VCR vcr2 07.zoo Seventh file of archived VCR vcr2 08.zoo Eighth file of archived VCR vcr2 09.zoo Ninth file of archived VCR Table 1: VCR Distribution Files for MS-DOS. File Description readme Distribution note spr.doc Software performance report rk.tar.Z Example ParaPET environment vcr2.tar.Z Compressed tarred VCR installation voc.sun4.Z Sun 4 binary of virtual occam compiler Table 2: VCR Distribution Files for Unix. zoox x// a: for each of the nine VCR zoo archives, (vcr2 [01..09]), that make up the release. This will create a subdirectory vcr off the current directory containing the entire VCR package. Additionally, a further zoo file, rk.zoo, contains the source code for an example message-passing programming environment based on the ParaPET Toolkit. Unarchiving this file creates a further directory rk off the current directory. Further information on this software can be found in the accompanying document, ParaPET A Parallel Programming Environment Toolkit. For Unix installation, uncompress and then untar the VCR file in a suitable directory. The file, rk.tar.Z, can be expanded as well if required. 4 Installing VCR A step-by-step guide to installing the VCR package and running a few simple examples is given in the Getting Started section of the Virtual Channel Router Version 2.0 User Guide which accompanies these installation notes. The user guide assumes either prior installation of the Inmos Checker Utility or the existence of .map file wiring diagrams to describe the target hardware. Version 2.1 of the Checker Utility distributed with this release comes as two self-unpacking PC executables. One, check"check2v1.exe, unpacks to a set of PC executables and user guide, the other contains sources which can be compiled up to generate binaries for other hosts. The two script or batch files used to launch VCR, vcr and svcr, will need site customisation (as described on P9 of the user guide) in order to resolve issues of accessing raw transputers. They are delivered in a state pertinent to the University of Southampton installation. For fixed topology machines no changes should be necessary. For reconfigurable machines these scripts need to locate the appropriate connectivity descriptions and set the switches. Additionally, multi-user 2 transputers may require availability validation. A subsequent call to the appropriate VCR driver program commences the VCR launch. 3