Installation der Einzelplatz
Version :: ProjectAssist
für das JavaScout
Fat-Client-Framework
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