02/08/2004 Version 1.9.0 ======================== Home: http://www.zetagrid.net/ +-----------+ | Contents: | +-----------+ 1. Prerequisites 2. Installation 2.1. as screen saver or as service in the control panel for Microsoft Windows (NT/2000/XP) 2.2. as permanent process for Microsoft Windows (95/98/Me/NT/2000/XP), Linux or IBM AIX 3. Uninstall 1. Prerequisites ================ - free disk space for temporary files - using defaults: about 16 MB - using lowest configuration: about 10 MB - using highest configuration: about 47 MB - free main memory between 37 and 85 MB (configurable) - Java 1.3 (e.g. IBM or Sun) or higher If you do not have a java.exe then you can download it for example at 'Java(TM) 2 Platform, Standard Edition (J2SE(TM))' http://java.sun.com/j2se/1.3/download.html 2. Installation =============== The installation of the screen saver is recommended since this installation requires minimal detailed knowledge about your system. You should install one and only one of these three possibilities; otherwise the programs conflict. Please go to the Internet site http://www.zetagrid.net/zeta/faq.html or at the ZetaGrid forum at http://www.zetagrid.net/forum/index.jsp if you have problems with the installation and using this help is insufficient. 2.1. Installation as screensaver or as service in the control panel for Microsoft Windows (NT/2000/XP) ------------------------------------------------------------------------ Short description: Start the downloaded file "zeta_install_1.9.0.exe" and all files will be installed in the specified folder, e.g. 'c:\zeta'. Configure (at least the name and maybe the Java VM) and activate the screen saver. Detailed description: 1. Download the file "zeta_install_1.9.0.exe" from server http://www.zetagrid.net Optionally use the tool MD5 (see e.g. http://userpages.umbc.edu/~mabzug1/cs/md5/md5.html) to check that your downloaded file is correct. 2. Start the file "zeta_install_1.9.0.exe" All components will be installed to the specified folder, e.g. "c:\zeta" 3. Choose between installation mode: as a screensaver as a service. 4. The dialog for the configuration will open. a) Define your name and optionally your e-mail. The same values can be used for other computers. b) Optional: The "Number of Work Units" field allows for the determination of the number and size of the work units computed. A value larger than 1 is only necessary if the computer is occasionally offline; no more than 5 work units can be reserved simultaneously for beginners. c) The "Process" field allows for the definition of more parameters: -- Priority of the computation which runs in the background. Recommended: Use the default value "Low" since only in that case will the screen saver be capable of being stopped without delay, (depending on the available computing power). -- Intensity (processor usage) of the computation which runs in the background. Recommended: Use the default value "High" (100%) only if, for example, the constant noise from any cooling fans does not disturb you. -- Number of processors ( >1 only for multi processor machines) This value must be less or equal to the number of local work units. d) In the "JavaVM" field, the location of the "java.exe" file belonging to the Java Virtual Machine must be defined if it is not recognized automatically. In most cases it would be one of the following directories: C:\java13\jre\bin\java.exe or C:\Programs\java13\jre\bin\java.exe or C:\Program Files\java13\jre\bin\java.exe or C:\Programs\javasoft\java13\jre\bin\java.exe or C:\Program Files\javasoft\java13\jre\bin\java.exe. The "Browse" button is useful to locate the file on the computer; the dialog box will vanish when the file location is selected and "Open" is clicked. e) Activate the option "use a proxy server for HTTP" if your access to the Internet needs a proxy server. Here you can define the address and port of your proxy server. f) The option "Display Status" can be activated to view the progress of the present computation. 5. Test your program by using the button "Test;" first time there may occur the error "java.lang.ClassNotFoundException: zeta.ZetaCalc" (depends on the version of the Java VM) this error will not appear on subsequent test. Normally, the test stops automatically if it is completed. But the test can be interrupted by Ctrl+C. During the test there must exist a network connection to the Internet. The duration of the test depends on the network capabilities. 6. Close dialog by clicking the "OK" button. Screen saver: 7. The dialog for choosing the screen save appears; optional you can make a preview of your screen saver. The computation runs successfully if the progress bar will be viewed (only possible if the option "Display Status" is active). 8. Close dialog by clicking the "OK" button. Service: 7. The service will be installed and runs in the background. Using the Task Manager the process with the name "ZetaGrid.exe" must be active. 2.2. Installation as permanent process for Microsoft Windows (95/98/Me/NT/2000/XP), Linux or IBM AIX -------------------------------------------------------------- 1. Download the files "zeta.jar" and "zeta.cfg" into a new directory. 2. Change the configuration file "zeta.cfg" with a text editor: a) "name=" and "eMail=" The same values can be used for other computers. b) All other values are optional. These values are documented is in the configuration file. Example for the file "zeta.cfg": name=Sebastian Wedeniwski eMail=wedeniws@de.ibm.com work_unit_size=m work_units=1 processors=1 sleep=0 Undefined parameters will be automatically read from the file "default.cfg." This file should never be changed manually! 3. The program can be started by the command java -Xmx128m -Djava.library.path=. -Dsun.net.inetaddr.ttl=0 -Dnetworkaddress.cache.ttl=0 -Dnetworkaddress.cache.negative.ttl=0 -cp zeta.jar:zeta_client.jar zeta.ZetaClient first time there may occur the error "java.lang.ClassNotFoundException: zeta.ZetaCalc" (depends on the version of the Java VM) this error should not occur again. This command can also be downloaded as a script file "zeta.cmd" for Microsoft Windows and "zeta.sh" for Linux, AIX, and SunOS. 4. Additional parameters: a) If you have to access the Internet through a proxy server you must add -Dhttp.proxyHost=$PROXY_HOST -Dhttp.proxyPort=$PROXY_PORT to the command. 2.3. Uninstall -------------- 1. Service installation: The command "net stop ZetaGrid" stops the service and the script file "remove_service.cmd" removes the service from your system. 2. Remove the entire folder 'c:\zeta'. That is all!