EDT Local Edition 4.3 (requires dongle)


This software runs on the 32-bits edition of Windows XP and Windows Vista. The 64-bits editions of these operating systems are not supported.

For standalone usage, install 'Simulator' and 'Admin' (optional) only. You need the 'Admin' component to access the solutions and the log files. Do not install the 'Dongle server' and select 'no' when the wizards asks 'Do you have a network dongle?'.

This readme file describes how to deploy EDT in a network. The information below is not needed for standalone usage.

======================
= NETWORK DEPLOYMENT =
======================

0. Introduction
---------------

EDT consists of three components which can be selected in the EDT Setup Wizard:

- Simulator
- Admin (requires Simulator)
- Dongle server

In a typical network situation the installation procedure is as follows:

1. Create directories on a network drive to store all files that need to be shared. 

2. Install the dongle server. This step is only required when a network dongle is used, it should be skipped when normal dongles are used.

3. Install 'Simulator' on all computers that are used by students. 

4. Install 'Simulator' and 'Admin' on all computers that are used by teachers.

5. Create subdirectories for each group of students in E:\edt\log.

6. Set the permissions for the directories and files in E:\edt.


1. Create directories
---------------------

a. Create a directory on a network drive (e.g. on a file server) to contain all files that need to be shared. In this readme file 'E:\edt' is used as an example.

b. Create a subdirectory 'log' to store all log files (E:\edt\log). All activities of the students will be stored in this directory.

c. Create a subdirectory 'fault' to store all fault simulation files (E:\edt\fault). After installation this directory will contain the exercises the student can access.


2. Installing the dongle server (Optional)
------------------------------------------

(Note: this should only be performed when a network dongle is used!! Do not install a dongle server if you are unsure!)

a. Check the 'Dongle server' checkbox in the 'Select Components' dialog of the EDT Setup Wizard. The other components (Simulator and Admin) are not required,
unless you want to run the Simulator on the computer that serves as dongle server.

b. Choose E:\edt as the location to store the dongle file, edt.mx.

c. Finish the installation.

d. Connect the dongle to the USB-port of the computer.

e. Start the dongle server from the Start menu: Programs->EDT->Dongle server. The server application (MATRIX - NET) appears as an icon in the system tray. Click the icon to see if the network dongle is found.

f. To run the server at system startup click the 'Settings' button in the MATRIX - NET application and check the 'Start Matrix-NET at system startup' checkbox.


3. Preparing the student computers
----------------------------------

a. Check the 'Simulator' checkbox in the 'Select Components' dialog of the EDT Setup Wizard.

b. Choose 'E:\edt\log' as the location to store the log files in the EDT Setup Wizard. This location can be edited manually after installation by setting the LogDir variable in C:\Program Files\edt\edt.ini, e.g.:

	[settings]
	LogDir=E:\edt\log

c. Choose 'E:\edt\fault' as the location to store the fault simulation files in the EDT Setup Wizard..

d. Answer 'no' when the wizards asks 'Do you have a network dongle?', unless you have installed a dongle server in step 2. 
Only answer 'yes' when you have installed a dongle server and select the dongle file (E:\edt\edt.mx). This setting can be edited manually after installation by setting the DongleFile variable in C:\Program Files\edt\edt.ini, e.g:

	[settings]
	DongleFile=E:\edt\edt.mx

e. Finish the installation. This will create two shortcuts in the Start menu: 
- Exercises
This shortcut presents a list of exercises the student can try to solve. The exercises are numbered, so the teacher can ask the student to solve a specific problem. To start an exercuse the student should click a 
- Demo
You can use this shortcut to run EDT in demo mode (without using a dongle). When you have a dongle you do not need this shortcut.

f. Connect the dongle to the USB-port of the computer (optional, you can skip this step if you use a dongle server in step 2).


4. Preparing the teacher computers
----------------------------------

This procedure is identical to installing the student computers, except that in the 'Select Components' dialog the 'Admin' checkbox should be checked too. This will install the Admin files to E:\edt\admin. 
After installation two additional shortcuts are created in the Start menu: 
- Log files
This shortcut points to directory that will contain the log files (E:\edt\log).
- Solutions
This shortcut presents the same list of exercises as the 'Exercises' link, but this list shows what the problem and the solution is for each exercise.


5. Creating group directories
-----------------------------

By default, the EDT Setup Wizard creates a subdirectory 'group1' in the log file directory E:\edt\log. Typically you want to create a subdirectory for every group or class of students in E:\edt\log. When a student starts the Simulator by double clicking a fault simulation file, the student has to select a name of one of the subdirectories in E:\edt\log. The log file is then stored in the selected subdirectory.


6. Setting file permissions
---------------------------

a. This step should only be performed when a dongle server is used (see step 2). Grant permission to read from and write to E:\edt\edt.mx to all accounts that need to access the dongle server, i.e. all student and teacher accounts and the account that runs the dongle server application.

b. Grant read access to E:\edt\fault to all accounts used by teachers and students.

c. Grant read access to E:\edt\admin and the files in the directory to accounts used by teachers. Student accounts should not have access to this directory.

d. Grant permission to list the directory contents of E:\edt\log to all student accounts. Do not grant permission to write or create files to student accounts in this directory.

e. Grant permission to create, write and read files in all the subdirectories of E:\edt\log (created in section 5 above) to all student accounts. Permission to list the directory contents of these subdirectories and delete files therein should not be granted.

f. Grant full control of E:\edt\log, it's subdirectories and log files to all teacher accounts. Teachers should be able to create, move and delete subdirectories in E:\edt\log and to read, move and delete log files in those subdirectories.
You may also choose a more restrictive policy by only granting permission to list the directory contents of the subdirectories and read the files in the subdirectories.
