********************************************************************** LUCID Learning and Understanding through Computer-based Interactive Discovery Installation Guidelines vs. 1.02 Beta Troy Wolfskill Last Updated 05-29-2000 ********************************************************************** CONTENTS - System Requirements - System Recommendations - Included Files - Unzipping the Downloaded LUCID.zip File - Installing LUCID on a Stand-Alone Computer - Configuring LUCID on a Stand-Alone Computer - Running LUCID on a Stand-Alone Computer - Installing LUCID on a Network - Configuring LUCID on Network - Running LUCID from a Network Computer - Customizing LUCID - Running the Reporting Utility - Using the Reporting Utility - Known Problems Over a Network - Contacts for Technical Support SYSTEM REQUIREMENTS - Pentium computer, Minimum 120 MHz recommended - Windows 3.1, Windows 95, or Windows NT operating system - Minimum 45 MB hard disk space - Minimum 16 MB RAM - 800x600 video resolution with a minimum of 256 colors SYSTEM RECOMMENDATIONS 1. Some simulations may run slow below 166 MHz PCs. 2. LUCID is optimized for 800x600 resolution with 256 or more colors. Lower resolution will introduce scroll bars that make it difficult to view information and navigate. Higher resolution produces unpredictable effects on objects. Less than 256 colors will reduce the visual quality and perhaps the readability of certain sections. There is no problem with using more that 256 colors. INCLUDED FILES The following files should be found, either on the CD or after unzipping the downloaded LUCID.zip file. - Readme.txt, the file you are currently reading - Setup.exe, the installation program - LUCID.asu, a supplemental file - LUCID.001, a compressed file containing all of the program and activity files If you have received LUCID on a CD, you should also find a directory entitled LUCID containing uncompressed forms of all program and activity files as well as a Raswin directory containing the Raswin molecular graphics program along with molecular structure files used by selected activities. UNZIPPING THE DOWNLOADED LUCID.ZIP FILE If you have received LUCID on a CD you can skip this step. If you have downloaded LUCID you will first need to unzip the LUCID.zip file. To do this you will need software to extract the archived files. We recommend winzip for this purpose. If you do not have winzip, it is available from http:\\www.winzip.com. After downloading and installing winzip, open the LUCID.zip file in winzip. Extract the files to a temporary directory. INSTALLING LUCID ON A STAND-ALONE COMPUTER If you are installing from a CD, simply run setup.exe. If you have unzipped a downloaded file, run setup.exe from the directory to which you extracted the files. Running setup will install three types of files -- 1) Asymetrix Toolbook run-time files; 2) the program and activity files for LUCID; and 3) the program files for Raswin along with selected molecular structure files. Asymetrix ToolBook files should be installed automatically into a directory entitled ASYM in the operating system directory, i.e., the Windows directory for Windows 3.1 or Windows 95, or WINNT for Windows NT. The run-time files will occupy about 6 MB of disk space. The program and activity files for LUCID can be placed anywhere. The default location is C:\LUCID. They will occupy about 38 MB of disk space. Raswin is placed by default in the LUCID directory. If you prefer moving it elsewhere you can, though see "Configuring LUCID" below. CONFIGURING LUCID ON A STAND-ALONE COMPUTER Once installation is complete, you may need to configure the software by running the LUCID Configuration program--LUCIDIni.exe. This program provides an easy way to set paths to various files and programs. These paths include the following. Work Path. This is the path on which LUCID will store your answers to questions. For individual use, this may be any path with full write access. The default is C:\LUCID\Workdisk. For use in a workshop, we recommend this point to the floppy drive, as answers saved in this path by one group of students will be accessed by another group using the same computer. Communication Path. The communication path is only used in workshop mode. For individual use, it can be left at the default, which is C:\LUCID\Reports. For workshop installation, this path should be to a drive accessible by all computers students are using with full write access by all users of the program. For further information, see below under Installing LUCID on a Network. Molecule Path. This is the path to the molecular structure files (.ent files) included with the Raswin molecular graphics program. This should point to the directory where you placed the Raswin files. Molecular Graphics Program. Raswin.exe is the molecular graphics program supplied with LUCID. The default path is C:\LUCID\Raswin\Raswin.exe. You may also use any other molecular graphics program that will accept standard PDB files. Note, however, that LUCID uses the .ent extension for PDB files. User Mode. This may be workshop or individual. For use with a stand-alone computer it should be set to Individual Mode. NOTE 1: If you have difficulty running the LUCID Configuration program (lucidini.exe), you can modify LUCID.ini, the initialization file containing all paths, directly with any text editor, e.g., Notepad. NOTE 2: All of the above paths must comply with DOS filename restrictions, i.e., a maximum of 8 letters in the name. Thus C:\Program Files becomes C:\Progra~1 RUNNING LUCID ON A STAND-ALONE COMPUTER You should now be able to run LUCID from the Program Folder in Windows 3.1 or the Start Menu button in Windows 95 or NT. Toolbook occasionally has trouble placing shortcuts on the Start menu in Windows NT. If you do not find the LUCID folder on an NT box, install the shortcut using the Settings/Taskbar in the Start menu button. Note that on a stand-alone computer you cannot use the Reporting Utility. You can explore this utility as follows. After entering the program, go to the activity entitled "An Introduction to LUCID". Click on the "Going On" button in the lower right corner of the page and select "Sample Activity" from the choices. This will take you to the activity on VSEPR Theory. Sample files are included that enable you to explore a simulation of the Reporting Utility as it would be seen by students. You can access this by selecting the File View_Reports menu item. If you supply answers to the questions, these will appear in the Reporting Utility. INSTALLING LUCID ON A NETWORK Server Installation. Follow the general directions under "Installing Lucid on a Stand-Alone Computer" but install to a network server instead. To provide access to the activities by clients, set all the files to read-only. This is readily done by selecting all of the files, right-clicking, selecting Properties from the pop-up menu, and changing their priviliges to read-only. In order to secure the activity files, they should be placed in a folder whose write access is password protected. This password should be provided to the instructor using LUCID as well as the system administrator so that activities can be modified as needed. Before running the program, complete the Client Installation and Configuring LUCID on a Network below. Client Installation. The Asymetrix Toolbook run-time files must be installed on each computer that will access the activities. This is readily done by running Setup.exe and selecting the Custom option. Unselect the checkbox next to LUCID and then click the Continue button. This will install just the run-time files and make the appropriate updates to the registry file. You or your system administrator will then need to provide a link to the following files in the taskbar or through a shortcut on the desktop. - LUCID Activities: lucid.exe - LUCID Reports: report.tbk A shortcut to the third program provided--LUCID Configuration (lucidini.exe) should not be provided as this could introduce security problems. If you prefer, you can install LUCID on each computer. Be aware that this will require modifying the lucid.ini file on each computer. To support networked reporting and peer-evaluation, you will need to create a communication path by setting up an accessible network path with write access by all students using the program. This path must be entered in LUCID.ini as the Communication Path. We do this by setting up a group with a separate login that students must use for workshops. Security concerns are minimal, however, and all that can happen is that a malicious student could interfere temporarily with reporting. CONFIGURING LUCID ON A NETWORK Follow the instructions under Configuring LUCID on a Stand-Alone Computer noting the following exceptions. - Set the Mode to Workshop - Set the Work Path to A:\ - Set the Communication Path to the path defined above in Installing LUCID on a Network If you have trouble browsing drives with the LUCID Configuration program (lucidini.exe), the LUCID.ini initialization file can be edited directly with any ASCII text editor. Simply write the full path to the directory of interest as indicated in the ini file. For security purposes, the path containing the activity and program files should have write access by the instructor and system administrator only. RUNNING LUCID FROM A NETWORK COMPUTER You should now be able to run LUCID from Start menu button or the shortcut you created above. When LUCID opens, an initial screen appears which can be closed by clicking. If the software is set up to run in workshop mode, a list of sections will appear along with the option to run the software in Individual Mode. The section list is modifiable by the instructor (see below under Customizing LUCID). It is important that students log into the appropriate section as this determines the names of files involved in the reporting process. You should thus use workshop mode even if you only have one section of students using the software, as reporting features are not available in Individual Mode. If a section is selected, a dialog box will appear in which up to three students can enter their names as part of a team. After entering as many names as there are students in the team, click the OK button and the program will be ready to use. CUSTOMIZING LUCID A number of features of LUCID can be modified to fit your course. These include the following: - The name of your institution; - the course title for each semester; - the activities displayed each semester; - the order of activities for each semester; and - team roles. To customize any or all of these features, enter the program, close opening copyright window, and select Modify Course from the Edit menu. (NOTE: If you have a problem doing this it may be because LUCID.sbk -- not LUCID.sys -- is a read only file. Simply go to the installation folder, find LUCID.sbk, right click and select properties. At the bottom of the dialog box unselect Read-only and proceed. You should now be able to modify the program. Be aware, however, that if you want to run LUCID over a network you will have to make this file read-only again when you are done.) You will be requested to enter a password which is simply "teacher", without the quotes. A dialog box will appear which you can use to specify your personal preferences. Use the Next and Previous buttons to move through the options. Click the Finish button to finish making changes. If you need help on any section, simply click the Help button at the lower left of the authoring utility. RUNNING THE REPORTING UTILITY To use the network reporting feature, simply run the LUCID Reports program. This should not be started until all teams have logged in by selecting the appropriate section. When the Reporting utility starts you will be asked for a password which is simply "teacher" without the quotes. You will then be asked to type in the course containing the activities. This corresponds to the page names in the Table of Contents, which are by default Chemistry 131, Chemistry 132, and Additional Activities. These titles can be modified as discussed below under Customizing LUCID. After you have selected a course, all of the activities for that course will be presented in a list box. Select the activities you want to include in the reporting for that workshop by clicking on them. To select adjacent activities, click on the first, hold down the Shift key, then click on the last activity. To select nonadjacent activities, click the first, hold down the Ctrl key, then click on another activity. Once you have selected all of the activities to be included in the reporting, click the Next button. All of the Key Questions, Exercises, and Problems from the activities you have selected will now be displayed in a list box. Select groups of questions to include in a single reporting cycle using the Shift and Ctrl keys as appropriate, then click the Next button. The questions you selected will be removed from the list. For example, to include all of the Key Questions in the first report, select all of the Key Questions and click the Next button. To include all of the Exercises in a second report, select these and click the Next button. If you change your mind, click the Previous button and your selections will be undone. Note that you cannot currently include questions from two activities in the same report. Note also that you must select all of the questions before you can continue. If there are questions you do not want students to report, simply group all of these in the last selection. Note that if there are questions from two activities you do not want reported, you will need to define two sets questions, one from each of the two activities . After grouping questions into report cycles, you will be asked whether you want support for peer evaluations. If you select Yes, radio buttons will appear with all reported answers with the labels "Good", "OK", or "Challenge". These buttons can be used by students to evaluate the quality of reported answers, and can be used to stimulate debate on the correctness and quality of answers. If you select Yes, you will be asked whether you want to save both initial and final reports. If you select Yes, two copies of each team's answers will be kept, an original prior to peer evaluation and a second after students have modified their answers. If you select No, only the most recent report submitted by a team is maintained. Selecting No produces a somewhat simpler report for students to use. Selecting Yes provides the opportunity for students to reflect on the quality improvements in their answers brought about by the peer evaluation process and also allows performance distributions for reporting and evaluations to be created for the Self-Assessment process. Once you have selected the options you prefer, click the "Finish" button. We recommend a graded approach to using the Reporting Utility. During the first workshop we do not use network reporting, allowing students an opportunity to focus on the activities. In the second workshop we use network reporting without support for peer evaluations, using the Reporting Utility as a white board. For the third workshop we add support for student evaluations. After this we add support for initial and final reports. USING THE REPORTING UTILITY As students enter a particular workshop, they are assigned a team number which will appear in the activity below the names of the team members. As they work through an activity, they can publish their work by selecting the File Publish_Report menu item. Once teams have published their work, you can import it into the reporting utility by left-clicking any report button, e.g., Report 1. Two teams are randomly selected to report their answer to each question. You can navigate between questions using the Next and Previous buttons. In order for students to be able to view each others' answers you need to left-click the Update Report button at the lower left of the screen in the Reporting Utility. After clicking this, students can access the Reporting Utility by selecting the File View_Reports menu item. If support for peer evaluations has been selected, students can click the radio buttons to evaluate each others' work. Displaying these evaluations in the Reporting Utility requires a three-step process. 1. The students must click the "Publish Evaluations" button to make their evaluations available to the Reporting Utility. 2. The instructor must click the "Get Evaluations" button in the Reporting Utility. 3. The instructor must click the "Update Report" button in the Reporting Utility. Once this has been done, students can view the evaluations by again viewing the reports or clicking the Update Report button. Evaluations are summarized in a horizontal bar graph in which all Good evaluations are shown as yellow bars and all Challenge evaluations are shown as red bars. Evaluations from individual teams are shown in the checkboxes immediately to the right of a team's answer, and are arranged in numerical order, with team 1 at the top. To explore the Reporting Utility outside of a workshop, follow the instructions at the bottom of Running LUCID on a Stand-Alone Computer. KNOWN PROBLEMS OVER A NETWORK 1. If LUCID will not run over your network... Asymetrix provides a plug-in for Netscape and Internet Explorer called Neuron that allows ToolBook files to be viewed over the Web. When Neuron is installed, it creates entries in the autoexec.bat and win.ini files that conflict with those for the run-time files. If the demonstration will not run over a network, check if Neuron has been installed and, if it has, uninstall it, then re-install Lucid, then re-install Neuron. 2. If LUCID runs but only one user can access an activity at any one time... In order for multiple users to access an activity, the file must be set to read-only. 3. If LUCID runs but the View Reports option is not accessible... a. Check that the instructor has followed the instructions for Running the Reporting Utility. b. Check that the instructor has created a file viewable by students by clicking the Update Report button in the Reporting Utility. c. Be sure that no firewall exists between the users' computers and the application directory or the communication path. 4. If the View Reports option functions but users are unable to view each others work... a. Make sure that the Reporting Utility is running, i.e., that the instructor has launched the LUCID Reports program. b. Make sure the instructor has imported student work by clicking the appropriate Report button in the Reporting Utility c. Make sure the instructor has made the report available by clicking the Update Report button in the Reporting Utility d. Make sure all students have published their work by selecting the File Publish_Reports menu item. e. Make sure all users have logged in to the same section. Students can change the section they are logged on to by double clicking on either the Individual Mode or Workshop Mode label in any activity. f. Make sure that all users have write access to the communication path. 5. When using the Reporting Utility, a dialog box appears saying "Please notify the instructor that a lock for file (some file name) could not be removed."... The instructor should use Windows Explorer or My Computer to access the communication path. A file should be found containing the extension .lck. Delete this file and continue. 6. When using the Reporting Utility, a dialog box appears saying "(filename) is currently busy. Would you like to try again?"... Follow the instructions for problem 5. CONTACTS FOR TECHNICAL SUPPORT If you have any difficulty installing or using LUCID, please contact us so that we may help you and update our installation guidelines. Phone: 516-632-7712 Email: Troy.Wolfskill@sunysb.edu