> JavaScout ProjectAssist - Inhalt


Installation der Einzelplatz Version :: ProjectAssist für das JavaScout Fat-Client-Framework

* Bitte beachten Sie die Hinweise und Bestimmungen bezüglich Urheberrecht, Haftungsausschluß und geschützte Marken oder Warenzeichen die für dieses Web-Dokument und möglicherweise auch für 'verlinkte' Dokumente gelten.  

Dieses Dokument drucken.
 Letzte Bearbeitung dieses  Dokuments: 2010-03-18

Inhaltsverzeichnis

Vorbedingungen 
Herunterladen und Entpacken mit dem Archiv-Manager 
Erstellen der Datenbank-Tabellen 
Anpassen der Konfigurationsdatei 'Connections.xml' an das gewählte Datenbanksystem 
Eventuell notwendiges Einbinden von JAR-Dateien für das verwendete Datenbanksystem 
Ändern der Berechtigung der Verzeichnisse und Dateien und erster Test 
Erstellen eines Startes mit Symbol in der Task-Leiste 
Erstellen eines Startes mit Symbol auf der Benutzeroberfläche 
Nachträgliches Verschieben der Installationsdateien 
Erstellen eines Eintrags im Anwendungsmenu 

Vorbedingungen

Voraussetzung für JavaScout ProjectAssist ist ein Java-Runtime-Environment (JRE / Java Laufzeit Umgebung) mit Version 1.6 oder höher.

Zum Überprüfen öffnen Sie ein Terminal-Fenster und geben Sie das Kommando
java -fullversion
ein.
Die angezeigte Version muss mit
1.6 beginnen.

Wenn noch kein JRE oder eine niedrigere Version vorhanden ist, finden Sie die Installationsanleitung im Dokument Java Development-Kit (Entwicklungs-Umgebung) installieren.

 
  



Ich empfehle, vor dem Beginn der Installation von JavaScout ProjectAssist die vorgesehene Datenbank einzurichten.

Das Einrichten der Datenbank ist von Ihrem gewählten Datenbanksystem abhängig.
Ein Beispiel für die MySQL-Datenbank finden Sie im Dokument
MySQL Datenbank für die Verwendung mit Java-Programmen einrichten.
Den Namen der Datenbank, den User-Name und das Passwort können Sie frei wählen.
Zur leichteren Lesbarkeit werden in dieser Installationsanleitung folgende Werte verwendet:

TCP/IP-Adresse des Computers, auf dem das SQL-Datenbanksystem läuft:
192.168.0.1
Datenbank-Name:
JS_ProjAssist
User-Name:
jsprass_user
Passwort:
AmEsadS

Das Erstellen der Datenbank-Tabellen ist in diesem Dokument im Abschnitt Erstellen der Datenbank-Tabellen beschrieben.

zum Inhaltsverzeichnis

Herunterladen und Entpacken mit dem Archiv-Manager

Klicken Sie mit der linken Maustaste auf diesen Text.

In dem erscheinenden Fenster wählen Sie bitte
() Öffnen mit [Archivmanager (Standard)    ]
aus und klicken Sie mit der linken Maustaste auf die Schaltfläche [  OK  ].

 
  

Sie sehen das in der komprimierten Datei enthaltene Stamm-Verzeichnis 'jsprass'.

Zum 'Entpacken' klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Entpacken ].

 
  

Es wird ein neues Fenster ('Entpacken') geöffnet in dem das Ziel-Verzeichnis ausgewählt werden kann.

In diesem Beispiel wird das 'private' Verzeichnis des Benutzers 'kurti-o' verwendet.

Wenn Sie als Anwender 'root' angemeldet sind und JavaScout ProjectAssist allen Benutzern dieses Computers zur Verfügung stellen wollen, dann sind die dafür üblichen Installationsverzeichnisse
'/usr/local'
oder
'/opt'

Manövrieren Sie zum gewünschten Ziel-Verzeichnis und speichern Sie die Verzeichnisse mit den Dateien durch Anklicken der Schaltfläche [  Entpacken  ].

 
  

Nach dem Entpacken wird ein Fenster zur Bestätigung angezeigt.
Schließen Sie dieses Fenster durch Anklicken der Schaltfläche
[  Schließen  ].

Anschließend können Sie das Fenster für den Archivmanager schließen (ohne Abbildung).

 
  

zum Inhaltsverzeichnis

Erstellen der Datenbank-Tabellen

Die Anleitungen zum Erstellen der Datenbank-Tabellen sind individuell von dem von Ihnen verwendeten Datenbanksystem abhängig.

In diesem Abschnitt wird die Anleitung für das häufig verwendete, kostenlos erhältliche Datenbanksystem MySQL-Datenbanksystem beschrieben.

Vorbedingung ist, dass das Datenbanksystem installiert ist und die Datenbank eingerichtet ist.
Links auf Dokumente mit Anleitungen für MySQL finden Sie im Abschnitt
Vorbedingungen.

Statt Platzhaltern werden in den folgenden Beispielen diese Werte verwendet:
TCP/IP-Adresse des Computers, auf dem das SQL-Datenbanksystem läuft:
192.168.0.1
Datenbank-Name:
JS_ProjAssist
User-Name:
jsprass_user
Passwort:
AmEsadS
Datei mit den SQL-Kommandos für das Erstellen der Datenbank: /home/kurti-o/jsprass/DB_SCRIPTS/Create_Tables.txt
Als Hinweis, dass diese Werte für Ihre Installation individuell angepasst werden müssen, wird kursive Schrift verwendet.

Wenn Sie noch keine Datenbanksystem installiert haben finden Sie die Anleitung für die Installation von MySQL im Dokument MySQL Datenbanksystem installieren.

Wenn Sie nicht MySQL als Datenbank verwenden benötigen Sie das zu Ihrer verwendeten Datenbank passende JAR (Java-Archive) mit den Treiber-Klassen.
Diese Datei(en) erhalten Sie vom Hersteller des Datenbanksystems.

Die folgenden Anleitungen gelten nur für das MySQL-Datenbanksystem.
Bitte beachten:
Die Berechtigung des MySQL-Datenbanksystem, das auf dem anderen Computer läuft, muß zulassen, daß von einer 'fremden' TCP/IP-Adresse auf die Datenbank zugegriffen wird
.
Eine Anleitung für die Linux-Distribution UBUNTU (getestet mit Version 9.04) finden Sie unter
MySQL Datenbanksystem installieren > Zugriff von anderen Computern im Netzwerk erlauben (UBUNTU).

Das Einloggen als registrierter Benutzer in den MySQL-Monitor erfolgt in einem 'Terminal-Window' durch folgendes Kommando:
mysql –-host="192.168.0.1"-user="jsprass_user"
–p
JS_ProjAssist

(in einer Zeile geschrieben; bitte beachten Sie die unterschiedliche Anzahl der Bindestriche vor den jeweiligen Parametern !)

Durch den Parameter p wird das Passwort extra abgefragt und die Eingabe ist nicht sichtbar.

Als Ergebnis wird das 'Prompt' des MySQL-Monitors angezeigt.


  

Das Ausführen der SQL-Kommandos zum Erstellen der notwendigen Datenbank-Tabellen wird durch folgendes Kommando innerhalb des SQL-Monitors begonnen:
source /home/kurti-o/jsprass/DB_SCRIPTS/Create_Tables.txt;

Als Ergebnis wird für jedes ausgeführte SQL-Kommando eine Bestätigung angezeigt.
Scrollen Sie bitte wieder nach oben und Überprüfen Sie bitte, ob Fehler aufgetreten sind.


  

zum Inhaltsverzeichnis

Anpassen der Konfigurationsdatei 'Connections.xml' an das gewählte Datenbanksystem

Der Name der Datei inklusive des Verzeichnisses ist: /home/kurti-o/jsprass/CONNECTIONS/Connections.xml.
Der kursiv geschriebene Text weist darauf hin, dass dieser Teil für Ihre Installation individuell angepasst werden muss.

Öffnen Sie diese Datei mit einem Editor und adaptieren Sie die Werte innerhalb des Bereichs <DataBaseParameters> entsprechend der verwendeten Datenbank.
Eine detaillierte Beschreibung der einzelnen XML-Elemente finden Sie im Dokument Datei 'Connections.xml' mit Parametern für Datenbank und JAS > Detailbeschreibung der Datenbank-Parameter.

In der installierten Muster-Datei sind die Werte in den XML-Elementen
<DataBaseDriverName>com.mysql.jdbc.Driver</DataBaseDriverName>
<DataBaseName>jdbc:mysql://192.168.0.1:3306/JS_ProjAssist</DataBaseName>
für die Verwendung eines MySQL-Datenbanksystems eingetragen.
Wenn Sie ein anderes Datenbanksystem verwenden, adaptieren Sie bitte diese Werte entsprechend der Anleitung des verwendeten Datenbanksystems.

zum Inhaltsverzeichnis

Eventuell notwendiges Einbinden von JAR-Dateien für das verwendete Datenbanksystem

Die Tätigkeiten in diesem Abschnitt sind nur notwendig wenn Sie ein anderes Datenbanksystem verwenden als MySQL.
Wenn Sie MySQL verwenden sind die notwendigen Treiber für die Verbindung zum Datenbanksystem bereits in der ausgelieferten Datei 'JS_ProjAssist_EP.jar' enthalten; fahren Sie bitte mit dem Abschnitt
Ändern der Berechtigung der Verzeichnisse und Dateien fort.

Öffnen Sie mit einem Texteditor die Datei /home/kurti-o/jsprass/run_de.sh und fügen Sie die JAR-Datei mit den Treibern für Ihr verwendetes Datenbanksystem ein:
java -cp JS_ProjAssist_EP.jar:Verzeichnis_und_Datei_Namen_für_Ihr_Datenbanksystem. js_prass.clientframes.JS_ProjAssist_CommandCenter de

zum Inhaltsverzeichnis

Ändern der Berechtigung der Verzeichnisse und Dateien und erster Test

Damit nicht versehentlich Änderungen an der Konfiguration vorgenommen werden können ist es sinnvoll, die Dateien gegen Veränderungen zu schützen.
Dazu wird die 'Schreib'-Berechtigung von den Dateien entfernt und nur die Berechtigungen zum 'Lesen' und 'Ausführen' bleiben erhalten.

In einem 'Terminal-Window' wird folgendes Kommando ausgeführt:
chmod -R 555 /home/kurti-o/jsprass

Damit wird von allen Dateien die 'Schreib'-Berechtigung entfernt.


  

Anschließend kann mit dem Kommando
/home/kurti-o/jsprass/run_de.sh
das Anwendungsprogramm gestartet werden.


  

Abhängig von der Geschwindigkeit Ihres Computers erscheint nach wenigen Sekunden das 'CommandCenter' von ProjectAssist.


  

zum Inhaltsverzeichnis

Erstellen eines Starters mit Symbol in der Task-Leiste

Zum einfacheren Aufrufen von ProjectAssist ist es sinnvoll, einen 'Starter' mit dem Symbol in der Task-Leiste einzufügen.
Damit kann
ProjectAssist durch einen einfachen Klick mit der linken Maustaste auf das Symbol aufgerufen werden.

Platzieren Sie den Mauszeiger auf jene Position an der der 'Starter' eingefügt werden soll.
Durch einen Klick auf die rechte Maustaste wird das Kontext-Menu aufgerufen.
Wählen Sie daraus
Zum Panel hinzufügen … aus.


  

Anschließend erscheint das Fenster 'Zum Panel hinzufügen'.
Wählen Sie daraus
Benutzerdefinierter Anwendungsstarter und bestätigen Sie die Auswahl durch Anklicken der Schaltfläche [ Hinzufügen ] mit der linken Maustaste.


  

Es erscheint das Fenster 'Einen Starter anlegen'.
Geben Sie darin den (Kurz-)Namen des Anwendungsprogramms und im Feld 'Kommentar' eine Beschreibung ein.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Durchsuchen … ].


  

Es erscheint das Fenster 'Anwendung auswählen …'.
Manövrieren Sie zum Verzeichnis in dem
ProjectAssist installiert ist (im Beispiel '/home/kurti-o/jsprass' und wählen Sie die Datei 'run_de.sh' aus.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Öffnen … ].


  

Die ausgewählte Datei wurde in das Eingabefelde 'Befehl' übernommen.

Zum Auswählen eines grafischen Symbols klicken Sie bitte mit der linken Maustaste auf die Schaltfläche mit dem Symbol ohne Namen.


  

Es erscheint das Fenster 'Symbole durchsuchen' mit einem Set vorgegebener grafischer Symbole.

Um ein eigenes Symbol auszuwählen klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Auswählen ... ].


  

Im anschließend geöffneten Fenster 'Auswählen' manövrieren Sie bitte zum Verzeichnis 'GRAPHICS' innerhalb des Installationsverzeichnisses von ProjectAssist (im Beispiel: '/home/kurti-o/jsprass/GRAPHICS').
Lassen Sie sich bitte nicht verwirren wenn jetzt noch keine Dateien angezeigt werden.

Zum Bestätigen des ausgewählten Verzeichnisses klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Öffnen ].


  

Im Fenster 'Symbole durchsuchen' sind die im ausgewählten Verzeichnis enthaltenen Dateien mit den grafischen Symbolen zu sehen.

Wählen Sie das Logo für ProjectAssist aus und bestätigen Sie bitte die Auswahl durch einen Klick mit der linken Maustaste auf die Schaltfläche [ OK ].


  

Im Fenster 'Einen Starter anlegen' wurde das Standard-Symbol durch das gewählte Symbol ersetzt.
Die Eingaben für den Starter sind jetzt vollständig und der Starter wird durch einen Klick mit der linken Maustaste auf die Schaltfläche
[ OK ] angelegt.


  

Der Starter für (erkennbar durch das Symbol) ist jetzt in der Task-Leiste sichtbar.
Sie können das noch offene Fenster 'Zum Panel hinzufügen' durch einen Klick mit der linken Maustaste auf die Schaltfläche
[ Schließen ] schließen.


  

zum Inhaltsverzeichnis

Erstellen eines Starters mit Symbol auf der Benutzeroberfläche

Wenn Sie einen 'Starter' für ProjectAssist lieber auf dem Desktop einfügen wollen führen Sie die Anweisungen in diesem Abschnitt aus.
So kann
ProjectAssist durch einen doppelten Klick mit der linken Maustaste auf das Symbol werden.

Platzieren Sie den Mauszeiger auf jene Position an der der 'Starter' eingefügt werden soll.
Durch einen Klick auf die rechte Maustaste wird das Kontext-Menu aufgerufen.
Wählen Sie daraus
Starter anlegen … aus.


  

Es erscheint das Fenster 'Einen Starter anlegen'.
Geben Sie darin den (Kurz-)Namen des Anwendungsprogramms und im Feld 'Kommentar' eine Beschreibung ein.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Durchsuchen … ].


  

Es erscheint das Fenster 'Anwendung auswählen …'.
Manövrieren Sie zum Verzeichnis in dem
ProjectAssist installiert ist (im Beispiel '/home/kurti-o/jsprass' und wählen Sie die Datei 'run_de.sh' aus.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Öffnen … ].


  

Die ausgewählte Datei wurde in das Eingabefelde 'Befehl' übernommen.

Zum Auswählen eines grafischen Symbols klicken Sie bitte mit der linken Maustaste auf die Schaltfläche mit dem Symbol ohne Namen.


  

Es erscheint das Fenster 'Symbole durchsuchen' mit einem Set vorgegebener grafischer Symbole.

Um ein eigenes Symbol auszuwählen klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Auswählen ... ].


  

Im anschließend geöffneten Fenster 'Auswählen' manövrieren Sie bitte zum Verzeichnis 'GRAPHICS' innerhalb des Installationsverzeichnisses von ProjectAssist (im Beispiel: '/home/kurti-o/jsprass/GRAPHICS').
Lassen Sie sich bitte nicht verwirren wenn jetzt noch keine Dateien angezeigt werden.

Zum Bestätigen des ausgewählten Verzeichnisses klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Öffnen ].


  

Im Fenster 'Symbole durchsuchen' sind die im ausgewählten Verzeichnis enthaltenen Dateien mit den grafischen Symbolen zu sehen.

Wählen Sie das Logo für ProjectAssist aus und bestätigen Sie bitte die Auswahl durch einen Klick mit der linken Maustaste auf die Schaltfläche [ OK ].


  

Im Fenster 'Einen Starter anlegen' wurde das Standard-Symbol durch das gewählte Symbol ersetzt.
Die Eingaben für den Starter sind jetzt vollständig und der Starter wird durch einen Klick mit der linken Maustaste auf die Schaltfläche
[ OK ] angelegt.


  

Der Starter für (erkennbar durch das Symbol) ist jetzt auf der Benutzeroberfläche sichtbar.


  

zum Inhaltsverzeichnis

Nachträgliches Verschieben der Installationsdateien

Um ProjectAssist für alle Anwender aufrufbar zu machen ist es sinnvoll, die Dateien in einem für alle Anwender lesbaren Verzeichnis zu speichern.

Die Anleitungen in diesem Abschnitt erklären, wie die Dateien aus einem nur einem Anwender zugeordneten Verzeichnis (*/home/Username/...)' in ein für alle Anwender lesbares Verzeichnis verschoben werden können.

Voraussetzung ist, dass Sie als Benutzer 'root' (oder ein anderer Benutzer mit Administrator-Rechten) angemeldet sind.

Öffnen Sie einen 'Datei-Browser'.

Anmerkung:
Die Abbildungen stammen von UBUNTU-Linux; bei anderen Distributionen kann das Aufrufen des 'Datei-Browsers' z.B. durch Anklicken eines grafischen Symbols (Icon) erfolgen.


  

Manövrieren Sie zum Verzeichnis, in dem Sie ProjectAssist installiert haben (im Beispiel: '/home/kurti-o').
Markieren Sie das Verzeichnis mit den Unterverzeichnissen und Dateien für
ProjectAssist (im Beispiel: 'jsprass'.

Wählen Sie anschließend Bearbeiten > Ausschneiden aus.


  

Manövrieren Sie anschließend zum Verzeichnis, in das Sie ProjectAssist verschieben wollen (im Beispiel: '/usr/local') und wählen Sie Bearbeiten > Einfügen aus.


  

Sie sehen, dass das Verzeichnis (im Beispiel: 'jsprass') eingefügt wurde.


  


Wenn Sie bereits 'Starter' in der Taskleiste (Abschnitt Erstellen eines Starters mit Symbol in der Task-Leiste) oder auf der Benutzeroberfläche (Abschnitt Erstellen eines Starters mit Symbol auf der Benutzeroberfläche) angelegt haben vergessen Sie bitte nicht, bei diesen den Wert (Verzeichnis und Dateiname für 'Befehl' und die Referenz auf das grafische Symbol (Icon) anzupassen.

zum Inhaltsverzeichnis

Erstellen eines Eintrags im Anwendungsmenu

Die Aufnahme in das Anwendungsmenu ist nur dann sinnvoll, wenn die Dateien für ProjectAssist in einem für alle Anwender zugänglichen Verzeichnis installiert ist.
Wenn Sie
ProjectAssist in einem '/home/...' Verzeichnis eines Anwenders installiert haben, verschieben Sie die Dateien zuerst in ein allgemein zugängliches Verzeichnis.
Die Anleitung dazu finden Sie im Abschnitt
Nachträgliches Verschieben der Installationsdateien.

Platzieren Sie den Mauszeiger auf 'Anwendungen'.
Durch einen Klick auf die rechte Maustaste wird das Kontext-Menu aufgerufen.
Wählen Sie daraus
Menüs bearbeiten aus.


  

Es erscheint das Fenster 'Hauptmenü'.
Wählen Sie in der linken Spalte ('Menüs') das Untermenü aus in dem der Eintrag für
ProjectAssist erfolgen soll.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Neuer Eintrag ].


  

Es erscheint das Fenster 'Einen Starter anlegen'.
Geben Sie darin den (Kurz-)Namen des Anwendungsprogramms und im Feld 'Kommentar' eine Beschreibung ein.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Durchsuchen … ].


  

Es erscheint das Fenster 'Anwendung auswählen …'.
Manövrieren Sie zum Verzeichnis in dem
ProjectAssist installiert ist (im Beispiel '/usr/local/jsprass' und wählen Sie die Datei 'run_de.sh' aus.

Klicken Sie anschließend mit der linken Maustaste auf die Schaltfläche [ Öffnen … ].


  

Die ausgewählte Datei wurde in das Eingabefelde 'Befehl' übernommen.

Zum Auswählen eines grafischen Symbols klicken Sie bitte mit der linken Maustaste auf die Schaltfläche mit dem Symbol ohne Namen.


  

Es erscheint das Fenster 'Symbole durchsuchen' mit einem Set vorgegebener grafischer Symbole.

Um ein eigenes Symbol auszuwählen klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Auswählen ... ].


  

Im anschließend geöffneten Fenster 'Auswählen' manövrieren Sie bitte zum Verzeichnis 'GRAPHICS' innerhalb des Installationsverzeichnisses von ProjectAssist (im Beispiel: '/usr/local/jsprass/GRAPHICS').
Lassen Sie sich bitte nicht verwirren wenn jetzt noch keine Dateien angezeigt werden.

Zum Bestätigen des ausgewählten Verzeichnisses klicken Sie bitte mit der linken Maustaste auf die Schaltfläche [ Öffnen ].


  

Im Fenster 'Symbole durchsuchen' sind die im ausgewählten Verzeichnis enthaltenen Dateien mit den grafischen Symbolen zu sehen.

Wählen Sie das Logo für ProjectAssist aus und bestätigen Sie bitte die Auswahl durch einen Klick mit der linken Maustaste auf die Schaltfläche [ OK ].


  

Im Fenster 'Einen Starter anlegen' wurde das Standard-Symbol durch das gewählte Symbol ersetzt.
Die Eingaben für den Starter sind jetzt vollständig und der Starter wird durch einen Klick mit der linken Maustaste auf die Schaltfläche
[ OK ] angelegt.


  

Der Eintrag ist jetzt im Anwendungsmenü sichtbar.


  

zum Inhaltsverzeichnis