installatio

Info zur QtLog Installation unter Linux
-------------------------------------------------------------------------------------

QtLog verwendet für die Datenbasis die MySQL Datenbank. Das Programm benötigt daher als Arbeitsumgebung einen betriebsbereiten MySQL Server der im Netzwerk oder als 'localhost' auf einem PC eingerichtet ist. Ist der Server im Netzwerk angesiedelt erfolgt die Einrichtung der Logbook Datenbank gemeinsam mit dem MySql Administrator.

Ist MySql auf einem PC, so ist der PC-Inhaber auch der Datenbankadministrator der die Verantwortung für einen arbeitsfähigen MySql 'localhost' Server hat. Ist dieser noch nicht vorhanden, muss er als erstes einen arbeitsfähigen Server zur Verfügung stellen.
Benötigt wird ein MySQL Server ab Version 5.0.45.x

Jetzt prüfen ob für den 'Client' also das QtLog-Programm die erforderliche Arbeitsumgebung vorhanden ist.
Benötigt wird Qt4 ab Version 4.3.x und libqt4-sql-mysql ( Qt4 MySQL support ).

Sind diese Voraussetzungen geschaffen kann QtLog installiert werden.

Das Tararchiv nach (HOME) kopieren und auspacken mit:
   - qunzip qtlog1.5_xx.tar.gz
- tar -xf qtlog1.5_xx.tar
    Tar legt das Verzeichnis 'log' an und kopiert alle Dateien nach log.

    - gehe in den log Ordner.
    hole Supper_user_Rechte mit:
    su -m
    Passwort xxxxx
    Programm ./install_bin aufrufen.
    Hiermit werden alle QtLog-Programme nach /usr/local/bin/ kopiert.
su mit exit zurück geben !

Jetzt starte './setupqtlog'. - NICHT mit Supper_user_Rechten, das führt immer zu Problemen !!

Der QtLog user mit seinem Passwort wird angelegt. Hierfür wird das mysql_root_Passwort benötigt.
Die Initialisierungstabellen werden in die Datenbank kopiert.

Hiermit ist die Installation und Einrichtung der log_Datenbank beendet.

QtLog aufrufen. Als erstes die persönlichen Daten Call, Name usw.. anlegen. Mit dem vorhandenen Test_logbook fun - das Programm kennen lernen und testen.

-----------------------------------------

Info: Beim Aufruf von ./setupqtlog wird geprüft ob eine Neuinstallation oder ein Upgrade der Datenbank vorliegt.
Ist kein betriebsbereites qtlog vorhanden, wird nach Rückfrage die Installation vorgeschlagen..

Ist qtlog betriebsbereit - meldet sich der Setup-Dialog.
Hier können alle Datenbank-Umgebungsparameter verändert werden,
Will man dieses tun, wird das Passwort verlangt.

Vorsicht. Jede Änderung der Datenbank Login-Parameter kann zu einem Problem führen und der Server verweigert den Dienst.

Viel Spaß
DL1HBD
----------------------------------------

Upgrade QtLog

Ist ein laufendes QtLog vorhanden, und es soll eine neue erweiterte Version installiert werden, ist zu beachten.

Ein QtLog-Upgrade baut immer auf die Vorgänger Version auf. Es muss daher, ausgehend von der vorhanden Version, für alle folge Versionen ein Upgrade durchgeführt werden
Zum Schutz der Log-Daten und eventuelle wieder Herstellung des laufenden Systems wie folgt vorgehen.

Vorbereitung:
- Vorsorglich wird ein Datenbank-DUMP in ein entferntes Verzeichnis durchgeführt
Zusätzlich für alle Fälle auch ein DUMP der Logtabellen.
( geht etwas schief kann die alte Version wieder hergestellt werden )
- Den log Ordner in log_old_Versions_Nr ändern.

- Das neue Tararchiv auspacken mit:
gunzip qtlog1.5_xx.tar.gz
tar -xf qtlog1.5_xx.tar

Im neuen log Ordner supper_user_Rechte holen und die Programmdateien mit
- ./install_bin nach /usr/local/bin kopieren. Supper_user_Rechte wieder zurück geben.
- Im neuen log Ordner ./setupqtlog aufrufen.

Setupqtlog kopiert falls erforderlich eine neue qtlog.ini Datei, öffnet die Datenbank und prüft die Datenbankstruktur. Ist ein Datenbank-Upgrade erforderlich wird dieses nach Rückfrage durchgeführt. Es wird eine Info ausgegeben.
Danach kann QtLog mit neuer, erweiterter Funktionalität wie üblich gestartet werden. Eine Datensicherung ist zu empfehlen.

Wieder Herstellung des bisherigen QtLog-Systems.
Ist beim Upgrade etwas schief gelaufen. Kann die alte Programm Version wieder hergestellt werden.
Den neuen Ordner log auf log_fault setzen oder löschen. Den Ordner log_old auf log.
In das log Verzeichnis gehen mit su -m root_Rechte holen und ./install_bin durchführen.
Jetzt ein RESTORE der Datenbank durchgeführt. Danach steht das Programm in der alten Version wieder zur Verfügung.

Es kann passieren das die Qtlog.ini Datei angepasst werden muss. Qtlog.ini steht unter:
.config/QtLog/qtlog.ini. Mit einem Editor können einzelne Variable angepasst werden.

-----------------------------------------

Hinweise und Unterstützung zur Installation und Einrichtung ' MySQL localhost '.

Einrichten der MySQL Datenbank unter openSUSE 11 oder 11.1

1. Lade die Pakete mysql Multiuser, Multithreaded SQL Database Version ab 5.0.45.x
mysql-client Version ab 5.0.45.x
Von der DVD oder aus dem Netz.

2. Hole supper_user_Rechte in einem xTerminal.

3. Den mysql_Server installieren mit:
    /usr/bin/mysql_install_db ( die Arbeitsumgebung für den Server einrichten )

    Erfahrungsgemäß gibt es an dieser Stelle seit langem ein Problem.
    Der Arbeitsbereich des Servers wird nicht richtig gesetzt und es muss
daher nach gebessert werden.

    Mit cd /var/lib/mysql in den Arbeitsbereich des Servers gehen und die
    File-Struktur anschauen.
    Alle Ordner müssen den Eigentümer 'mysql mysql' haben.
    Ist das nicht der Fall muss korrigiert werden mit: chown -R mysql.mysql *

    Jetzt kann der Server mit folgendem 'Kommando gestartet werden.
    /etc/rc.d/mysql start

    Die Antwort vom Server ist je nach Version unterschiedlich. In jedem Fall
    muss am Textende das Wort 'done' stehen. Nur dann läuft der Server.

    Für den 'MySql_root_user' ein Passwort vergeben.
    Das erfolgt mit dem Kommando :
/usr/bin/mysqladmin -u root password xxxxx ( xxxx ist das Passwort. )

    Wurde das Passwort akzeptiert - erfolgt keine Meldung.
    Wird das Passwort abgelehnt, läuft der Server nicht oder es gibt ein anderes Problem.
Zum Beispiel einen Tippfehler in der Kommandozeile.

Wichtig ist auf die Antwort des Servers zu achten und diese richtig zu behandeln.
Es wird immer notwendig sein alle Schritte sorgfältig zu überprüft.

Läuft der Server, ist die Vorbereitung zur Inbetriebnahme von QtLog beendet.
Mit exit werden die 'Supper_user Rechte' zurückgegeben, das xTerminal wenn nötig schliessen.

Zusätzlich kann getestet werden ob der Server wirklich läuft und sich auch öffnen lässt.
In einem User_xTerminal ( ohne supper_user_Rechte ) eingeben: mysq -uroot -pxxxxx ( xxxxx = passwd )

Die Antwort vom Server:
Welcome to the MySQL monitor. Commands end with ; or \g.

Your MySQL connection id is 1
Server version: 5.0.51a SUSE MySQL RPM
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
mysql>
mysql> \q ( hiermit wird der Server wieder geschlossen )

Soll der mysql_server bei jedem Linux-Start gestartet werden, wird dieses mit Yast eingerichtet.
Yast -> System -> Runlevel-Editor
Die Funktion "Start the MySQL database server" auf 'Aktive' stellen.

Jetzt starte 'setupqtlog'. - NICHT als root_user !!! und initialisiere das Programm.

Viel Erfolg