08.02.2004 Version 1.9.0 ======================== Home: http://www.zetagrid.net/ +---------+ | Inhalt: | +---------+ 1. Systemvoraussetzungen 2. Installation 2.1. als Bildschirmschoner oder als Dienst in der Systemsteuerung unter Microsoft Windows (NT/2000/XP) 2.2. als permanenter Prozess unter Microsoft Windows (95/98/Me/NT/2000/XP), Linux oder IBM AIX 3. Uninstall 1. Systemvoraussetzungen ======================== - freier Plattenspeicher für temporäre Dateien - bei Verwendung der Vorgabewerte: etwa 16 MB - bei Verwendung der niedrigsten Einstellung: etwa 10 MB - bei Verwendung der höchsten Einstellung: etwa 47 MB - freier Hauptspeicher zwischen 37 und 85 MB (konfigurierbar) - Java 1.3 (z.B. IBM oder Sun) oder eine höhere Version Falls Sie keine 'java.exe' auf Ihrem Rechner besitzen, dann können Sie zum Beispiel unter der folgenden Adresse Java herunterladen und installieren: 'Java(TM) 2 Platform, Standard Edition (J2SE(TM))' http://java.sun.com/j2se/1.3/download.html 2. Installation =============== Empfohlen wird die Installation des Bildschirmschoners, weil diese Installation die geringsten Systemkenntnisse voraussetzt. Bei der Installation muss darauf geachtet werden, dass nur eine dieser drei Möglichkeiten aktiv ist, weil sie sich sonst gegenseitig beenden. Bitte gehen Sie zur Internetseite http://www.zetagrid.net/zeta/faq.html oder zum ZetaGrid Forum http://www.zetagrid.net/forum/index.jsp wenn Sie Probleme mit der Installation besitzen und mit dieser Hilfe nicht weiterkommen. 2.1. Installation als Bildschirmschoner oder als Dienst in der Systemsteuerung unter Microsoft Windows (NT/2000/XP) ------------------------------------------------------------------------------ Kurzanleitung: Die heruntergeladene Datei "zeta_install_1.9.0.exe" starten und dann wird alles automatisch ins definierte Verzeichnis, z.B. 'c:\zeta', installiert. Die Einstellungen (mindestens den Benutzername und ggf. die Java-VM) des installierten Bildschirmschoners anpassen und aktivieren. Ausführliche Anleitung: 1. Datei "zeta_install_1.9.0.exe" vom Server http://www.zetagrid.net herunterladen. Bei Unsicherheit mit dem Tool MD5 überprüfen, (siehe z.B. http://userpages.umbc.edu/~mabzug1/cs/md5/md5.html) ob die korrekte Datei heruntergeladen wurde. 2. Datei "zeta_install_1.9.0.exe" starten. Alles wird automatisch ins definierte Verzeichnis, z.B. "c:\zeta", installiert. 3. Auswählen zwischen der Service- oder der Bildschirmschonerinstallation. 4. Die Oberfläche für die Einstellungen wird angezeigt. a) Benutzername und ggf. e-Mail-Adresse angeben. Bei mehreren Computern können dieselben Angaben verwendet werden. b) Optional kann im Kasten "Number of Work Units" die Anzahl und die Größe der zu berechnenden Arbeitseinheiten bestimmt werden. Allerdings können Beginner nur maximal 5 Arbeitseinheiten gleichzeitig reserviert werden. c) Im Kasten "Process" können mehrere Parameter eingestellt werden: -- Priorität der Berechnung, die im Hintergrund läuft. Empfehlung: Den Vorgabewert "low" verwenden, weil meist nur dann der Bildschirmschoner sofort unterbrochen werden kann (abhängig von der zugrundeliegenden Rechnerleistung). -- Intensität (direkte Prozessorbelastung) der Berechnung, die im Hintergrund läuft. Empfehlung: Den Vorgabewert "high" (100%) nur dann verwenden, wenn es nicht als störend empfunden wird, dass z.B. bei Notebooks der Lüfter die ganze Zeit über läuft. -- Anzahl der Prozessoren (>1 nur für Multi-Prozessor-Maschinen) Der Wert muss kleiner oder gleich der Anzahl der lokalen Arbeitseinheiten sein. d) Im Kasten "Process" unter "JavaVM" muss die Datei "java.exe" der Java-Virtual-Machine eingetragen werden, wenn diese Datei nicht automatisch gefunden wurde. In den meisten Fällen ist dies eines der folgenden Verzeichnisse: C:\java13\jre\bin\java.exe oder C:\Programme\java13\jre\bin\java.exe oder C:\Program Files\java13\jre\bin\java.exe oder C:\Programme\javasoft\java13\jre\bin\java.exe oder C:\Program Files\javasoft\java13\jre\bin\java.exe. Hilfreich ist dabei die Verwendung der Schaltfläche "Browse", um die Datei auf dem eigenen Computer auszuwählen; der Dialog wird mit "Öffnen" (Open) abgeschlossen. e) Sie müssen die Option "use a proxy server for HTTP" aktivieren, wenn Ihr Internetzugang über einen Proxy-Server läuft. Sie können dann die Adresse und Port Ihres Proxy-Servers definieren. f) Im Kasten "Options" kann die Schaltfläche "Display Status" aktiviert werden, durch die während der Berechnung der aktuelle Fortschritt der Berechnung angezeigt wird. 5. Testen Sie Ihr Programm mit der Schaltfläche "Test"; ggf. kann hier beim ersten Mal der Fehler "java.lang.ClassNotFoundException: zeta.ZetaCalc" auftreten (abhängig von der Version der Java-VM), der bei einem zweiten Test verschwunden ist. Der Test beendet sich normalerweise automatisch, kann aber auch mit Strg-C (Ctrl-C) Unterbrochen werden. Es muss eine Netzwerkverbindung zum Internet während des Tests vorhanden sein. Die Dauer des Tests hängt von der Netzwerkleistung ab. 6. Dialog mit der Schaltfläche "OK" schließen. Bildschirmschoner: 7. Der Dialog zur Auswahl des Bildschirmschoners erscheint; ggf. hier den neuen Bildschirmschoner mit der Schaltfläche "Voranzeige/Testen" (Preview) testen. Die Berechnung läuft erfolgreich, wenn in der Statusanzeige ein Fortschrittsbalken angezeigt wird (nur möglich, wenn die Option "Display Status" aktiviert ist). 8. Dialog mit der Schaltfläche "OK" schließen. Service: 7. Der Dienst wird installiert und läuft nun im Hintergrund. Im Task Manager muss nun ein Prozess mit dem Namen "ZetaGrid.exe" aktiv sein. 8. Mit "net stop ZetaGrid" kann dieser Dienst gestoppt und mit der Skriptdatei "remove_service.cmd" kann der Dienst aus dem System entfernt werden. 2.2. Installation als permanenter Prozess ----------------------------------------- 1. Dateien "zeta.jar" und "zeta.cfg" in ein neues Verzeichnis kopieren. 2. Die Datei "zeta.cfg" im Texteditor mit den eigenen Daten ändern: a) "name=" und "eMail=" Auf mehreren Computern können dieselben Angaben verwendet werden. b) Alle anderen Werte sind optional. Diese Werte sind in der Konfigurationsdatei beschrieben. Beispiel für die Datei "zeta.cfg": name=Sebastian Wedeniwski eMail=wedeniws@de.ibm.com work_unit_size=m work_units=1 processors=1 sleep=0 Nicht eingetragene Parameter werden automatisch aus der Datei "default.cfg" gelesen. Diese Datei darf deshalb NICHT geändert werden! 3. Das Programm wird durch den Befehl 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 aufgerufen; ggf. kann hier beim ersten Mal der Fehler "java.lang.ClassNotFoundException: zeta.ZetaCalc" auftreten (abhängig von der Version der Java-VM), der bei einem zweiten Aufruf verschwunden ist. Dieser Befehl kann auch als Datei heruntergeladen werden, und zwar für Microsoft Windows mit "zeta.cmd" und für Linux, AIX und SunOS mit "zeta.sh". 4. Zusätzlicher Parameter: a) Sie müssen den folgenden Paramter im Kommando hinzufügen -Dhttp.proxyHost=$PROXY_HOST -Dhttp.proxyPort=$PROXY_PORT wenn Ihr Internetzugang über einen Proxy-Server läuft. 2.3. Uninstall -------------- 1. Serviceinstallation: Mit "net stop ZetaGrid" kann der Dienst gestoppt und mit der Skriptdatei "remove_service.cmd" kann der Dienst aus dem System entfernt werden. 2. Entferne das komplette Verzeichnis 'c:\zeta'. Das ist alles!