Installation instructions and Start of PHYWE interTESS

Installation instructions andStart of PHYWE interTESSWelcome to PHYWE interTESS!Table of contentsInformation is supplied on the following topics.TABLE OF CONTENTS...................................................................................................... 11. SYSTEM REQUIREMENTS............................................................................................ 22. INSTALLATION.............................................................................................................. 22.1. Installation under Microsoft Windows.......................................................................................... 22.2. Installation under Apple Macintosh with Mac OS X.................................................................... 32.2.1. Copy data ............................................................................................................................ 32.2.2. Adapt rights.......................................................................................................................... 32.2.3. Testing the Java version...................................................................................................... 32.2.4. Installation of Java............................................................................................................... 32.3. Installation under Linux ................................................................................................................. 42.3.1. Copy data ............................................................................................................................ 42.3.2. Suit rights............................................................................................................................. 42.3.3. Testing the Java version...................................................................................................... 42.3.4. Installation of Java............................................................................................................... 43. DE-INSTALLATION........................................................................................................ 53.1. De-installation under Windows ..................................................................................................... 53.2. De-installation under Mac OS X .................................................................................................... 53.3. De-installation under Linux ........................................................................................................... 54. STARTING INTERTESS................................................................................................. 54.1. Programme start under Windows ................................................................................................. 54.2. Programme start under Mac OS X ................................................................................................ 64.3. Programme start under Linux ....................................................................................................... 65. COPYRIGHT AND INTELLECTUAL PROPERTY.......................................................... 66. IMPRINT ......................................................................................................................... 6© 2005 PHYWE Systeme GmbH & Co. KG – All rights reserved. (interTESS / Installation / en / 04.05.2005) Page 1 / 6

1. System requirements Computer on which one of the following operating systems runs reliably and quickly:Microsoft Windows 98 / ME / 2000 / XP, Apple Macintosh OS X, Linux in a suitable configuration (minimalhardware requirements acc. to those of the operating system used, e.g. for Windows, at least Pentium IIwith 200 MHz and 64 MB RAM; we recommend at least Pentium III from 500 MHz and 128 MB RAM on) with Macintosh: Java Runtime Environment (JRE) from Sun from version 1.4.2 on(for Linux and Windows, a suitable version is included on the CD) Monitor or beamer with a screen resolution from 800 x 600 pixels upward Graphics support of the hardware and colour setting High Color (16 bits = 65536 colours) or higher At least 100 MB free fixed disk storage(up to 500 MB, acc. to the language version, experiment content etc.) CD ROM drive 4x (only required for the installation) Recommended: A software for the display of PDF files,e.g. “Adobe Reader” (see also http://www.adobe.com/)(The fully functional version of interTESS was developed in the programming language Java from Sun. Thisallows, in principle, the use of the software on all operating systems for which a Java Runtime Environment(JRE) from Sun is available. The JRE used should be the “Java 2 Platform, Standard Edition” (J2SE),version 1.4.2 or higher. For Windows and Linux, a suitable version is standardly supplied.2. InstallationThe installation of interTESS is dependent on the operating system used (Windows, Mac OS X, Linux).Please follow the instructions in the appropriate section.Should you experience difficulty in carrying out installation, please read further in section FAQof the manual “interTESS_Manual_EN”.Extensive information such as directions for installation, help files and brochures on PHYWE products are tobe found in the "interTESS_Info" directory. Please note that to view PDF files an appropriate programmemust be installed. Should the PDF files not be displayed, you can download "Adobe Reader" free of chargevia the Internet address http://www.adobe.com/ for installation in your computer.2.1. Installation under Microsoft WindowsTo install in a Windows system, insert the "interTESS" CD in the CD-drive of your computer.The installation programme is started and leads you through the installation process.Should installation not start of its own accord, proceed as follows: Click on "Start" and select "Run...". Enterin the "Run dialog box":D:\interTESS_Windows\setup.exeSubsequently confirm with "OK". (Should your CD-drive not be described by the letter “D:", then replace the"D:" with the appropriate letter for your CD-drive.)You can alternatively select the CD-drive via "Workplace" and change to the "interTESS_Windows"directory, where you can double click to start the file "setup" or "setup.exe".Follow the installation programme instructions.The choice of language concerns only the installation programme, and not the "interTESS" software.You can use the standard settings when installing.© 2005 PHYWE Systeme GmbH & Co. KG – All rights reserved. (interTESS / Installation / en / 04.05.2005) Page 2 / 6

Please note that you have the necessary rights to write in the selected installation directory. Ifapplicable, you must be registered as administrator. An installation that already exists will beoverwritten, following an appropriate query. WARNING! ALL files in the installation directory will beoverwritten! Should you want to retain the old version, then you must select a different directory name forthe installation.During installation, the necessary data will be copied onto your fixed disk and an icon for calling theprogramme filed on the desktop. In addition, a "PHYWE interTESS" entry is generated underStart" » "Programs". It is also possible to start the interTESS programme here, as well as to call theprogramme documentation or de-install the interTESS programme.Following successful installation, the "interTESS" CD can be removed from the CD-drive. The data will beloaded from the fixed disk when the programme is put to use.The installation of interTESS has herewith been completed.2.2. Installation under Apple Macintosh with Mac OS XTo install in an Apple Macintosh system, insert the "interTESS" CD in the CD-drive of your computer.2.2.1. Copy dataThe data for the installation is to be found on the "interTESS" CD in the "interTESS_MacOSX" directory.Copy the "interTESS_MacOSX" directory in any directory in your computer, e.g. /Volumes/Phywe.2.2.2. Adapt rightsAdapt the rights for this directory so that the user has sufficient rights to write or run in the"interTESS_MacOSX" directory. The following rights, further to the right to read, are the least that arerequired for the user:rw- for directory: .../interTESS_MacOSXr-x for file: .../interTESS_MacOSX/run_osx.shrw- for file: .../interTESS_MacOSX/config.propertiesrw- for directory: .../interTESS_MacOSX/logrw- for file: .../interTESS_MacOSX/log/phywe.logYou can adapt the rights for example in the "Terminal" window, e.g.:chmod u+x [InstallationDirectory]/interTESS_MacOSX/run_osx.shchmod u+w [InstallationDirectory]/interTESS_MacOSX/log/phywe.logFollowing successful installation, the "interTESS" CD can be removed from the CD-drive. The data will beloaded from the fixed disk when the programme is put to use.2.2.3. Testing the Java versionFrom Mac OS X on, a JAVA Runtime Environment (JRE) from Sun is standardly supplied. It is only importanthere to check that it is a current version. You can easily test this. Start "Terminal" and enterjava –versionThe version number shown should be at least 1.4.2. If this is not the case, then you must install a currentversion.2.2.4. Installation of JavaWhen your Java version is not sufficient, you can download and install a current JRE version underhttp://www.apple.com/de/macosx/features/java/. The current JRE is "Java 2 Platform, Standard Edition(J2SE), version 1.4.2 for Mac OS X. Please follow the appropriate instructions. You can find furtherinformation on Java under http://java.sun.com/.The installation of TESS has now been successfully completed.© 2005 PHYWE Systeme GmbH & Co. KG – All rights reserved. (interTESS / Installation / en / 04.05.2005) Page 3 / 6

2.3. Installation under LinuxTo install in a Linux system, insert the "interTESS" CD in the CD-drive of your computer.2.3.1. Copy dataThe data for the installation is to be found on the "interTESS" CD in the "interTESS_Linux" directory.Copy the "interTESS_Linux" directory in any directory in your computer, e.g. /usr/local/Phywe.2.3.2. Suit rightsSuit the rights for this directory for the user to have sufficient rights to write or run in the"interTESS_Linux" directory. The following rights, further to the right to read, are the least that arerequired for the user:rw- for directory: .../interTESS_Linuxr-x for file: .../interTESS_Linux/run_linux.shrw- for file: .../interTESS_Linux/config.propertiesrw- for directory: .../interTESS_Linux/logrw- for file: .../interTESS_Linux/log/phywe.logYou can suit the rights e.g. with the KDE Desktop or in the "Console" (Shell), e.g.:chmod u+x [InstallationDirectory]/interTESS_Linux/run_linux.shchmod u+w [InstallationDirectory]/interTESS_Linux/log/phywe.logFollowing successful installation, the "interTESS" CD can be removed from the CD-drive. The data will beloaded from the fixed disk when the programme is put to use.2.3.3. Testing the Java versionA Runtime Environment (JRE) from Sun is standardly supplied with current distributions of Linux. It isimportant here to check that it is a current version. You can easily test this. Start "Terminal" and enterjava –versionThe version number shown should be at least 1.4.2. If this is not the case, then you must install a currentversion.2.3.4. Installation of JavaPHYWE interTESS is standardly supplied with a Java Runtime Environment (JRE) from Sun. To avoidpossible problems with regard to versions, we recommend that this version be used to start the programme.The current JRE is "Java 2 Platform, Standard Edition (J2SE), version 5.0(1.5.0) for Linux. You can findfurther information on Java under http://java.sun.com/.The installation directory for the JRE to be used must be given as environmental variable JAVA_HOME. Withthis, the following entry in the file follows/etc/profileexport JAVA_HOME=[Java-InstallationDirectory]These changes can only be made from root. A renewed logon is then necessary.When a root logon is not possible, then this command is carried out at the command line. The variable isthen only valid for the actual session, however.If the JRE supplied is used, then JAVA_HOME is to be put on the directory[InstallationDirectory]/interTESS_Linux/jre_linuxThe java file in the [JAVA_HOME]/bin directory must be executable by all users, who are to use theinterTESS programme. The following rights are the least that are required for the use:r-x for file:.../interTESS_Linux/jre_linux/bin/java© 2005 PHYWE Systeme GmbH & Co. KG – All rights reserved. (interTESS / Installation / en / 04.05.2005) Page 4 / 6

You can suit the rights e.g. with the KDE Desktop or in the "Console" (Shell), e.g.:chmod u+x [InstallationDirectory]/interTESS_Linux/jre_linux/bin/javaYou should subsequently test the successful installation as described under "Testing the Java version".The installation of interTESS has now been successfully completed.3. De-installation3.1. De-installation under WindowsDe-installation of the “PHYWE interTESS” programme is effected via the menu. Therefore, click on“Uninstall PHYWE interTESS” via “Start” » “Programs” » “PHYWE interTESS”. Follow the directions of thede-installation programme.3.2. De-installation under Mac OS XFor de-installation the “PHYWE interTESS” programme, just delete the directory interTESS_MacOSX,which you have copied on your hard drive while installing.3.3. De-installation under LinuxFor de-installation the “PHYWE interTESS” programme, just delete the directory interTESS_Linux, whichyou have copied on your hard drive while installing.If you have set the environment variable JAVA_HOME into the Java version of the directory[InstallationDirectory]/interTESS_Linux/jre_linux in a permanent status, please note thatthis directory will no longer be available after deleting. Modify the environment variable JAVA_HOMEaccording to an effective Java installation (compare with “Installation of Java” in Linux).4. Starting interTESSEnclosed is a teacher password generated by PHYWE. Please treat this password confidentially andonly pass it on to trustworthy persons authorized to teach. We recommend that you change thepassword given to one that is easier for you to remember (see “Change password…”).Remember – everyone who knows the password has access to all the solutions.4.1. Programme start under WindowsThe "PHYWE interTESS" programme can be started either via the corresponding icon on the desktop or viathe menu. For the latter, under "Start" » "Programs" » "PHYWE interTESS", click on the "interTESS" entry.The start of the software takes place in several steps. An information window is first displayed. Java (theJRE) is loaded in the background. This process can take a good 20 seconds on 500 MHz computers.Following this, the interTESS software is loaded. This is shown by a further information window. The loadingof this programme also takes a few seconds. The software is ready to use when the main display is shown.© 2005 PHYWE Systeme GmbH & Co. KG – All rights reserved. (interTESS / Installation / en / 04.05.2005) Page 5 / 6

4.2. Programme start under Mac OS XTo start interTESS under Mac OS X the "terminal" must be opened.In the "terminal" you change the directory with the corresponding installation, e.g.cd [InstallationDirectory]/interTESS_MacOSXOn entering./run_osx.shin the "terminal" interTESS is started.Should it not be possible to start run_macosx.sh, then you must check if the rights of use, as describedunder "Suit rights" in the "Installation" section, have been correctly placed.4.3. Programme start under LinuxTo start interTESS under Linux the "console" (shell) must be opened.In the "console" you change the directory with the corresponding installation, e.g.cd [InstallationDirectory]/interTESS_LinuxIf no permanent commitment of the environmental variable of the Java installation has occurred (seeInstallation of Java under Linux), then this must be temporarily committed:export JAVA_HOME=[Java-InstallationDirectory]and tested, if the environmental variable has been correctly committed:echo $JAVA_HOMEOn entering./run_linux.shin the "console", interTESS will be started.Should it not be possible to start run_linux.sh, then you must check if the rights of use, as describedunder "Suit rights" in the "Installation" section, have been correctly placed.When the fault message "java: command not found" should be given, please check: Is Java correctlyinstalled? Is the java-command contained in the path?5. Copyright and intellectual propertyCopyright © 2005 PHYWE Systeme GmbH & Co. KG. All rights reserved.All rights for “interTESS” software, the name and the design are held by PHYWE. Reproduction, even ofextracts, requires the express authorization of the proprietor of the rights. This software, including thecomputer programmes, contents and documentation, is protected by copyright.PHYWE Systeme GmbH & Co. KGRobert-Bosch-Breite 10D-37079 GoettingenGermanyPhone: +49–551-604-0Fax: +49–551-604-107E-Mail: intertess@phywe.deInternet: http://www.phywe.com/6. Imprint© 2005 PHYWE Systeme GmbH & Co. KG – All rights reserved. (interTESS / Installation / en / 04.05.2005) Page 6 / 6