Netzwerkinstalltion

Dieses Dokument ist Teil der ITHau.Faktura Dokumentation (http://www.freewarefaktura.de)

Hier erfahren Sie, wie Sie die Anwendung so installieren, dass Sie von mehreren Personen im Netzwerk genutzt werden kann.

Alle Anwendungsdaten werden in einem Profil gespeichert. Ein Profil ist ein Verzeichnis, in dem sich die Konfigurationsdateien, die Druckvorlagen und einige weitere Informationen befinden.

Nachdem Sie die Anwendung installiert haben, befindet sich das Profilverzeichnis im Programmverzeichnis. Bei einer Standartinstallation auf der Festplatte C wäre dies also das Verzeichnis ,,C:\Programme\Faktura\profiles\default".

Die Konfigurationsdateien befinden sich im Profil-Verzeichnis in einem Order mit Namen conf (der vollständige Pfad wäre bei einer Standartinstallation also ,,C:\Programme\Faktura\profiles\default\conf").

Es gibt für jede im Programmpaket enthaltene Anwendung mehrere Konfigurationsdateien. Bei der Faktura sind es folgende Dateien:

• Faktura.Settings.xml
  Diese Datei ist die wichtigste Konfigurationsdatei. Sie enthält die grundsätzlichen Konfigurationsinformationen.
• Faktura.PrintSettings.xml
  Hier sind alle Konfigurationsinformationen rund um das Thema Drucken enthalten. So wird hier zum Beispiel festgelegt, welcher Objekt-Typ (Aufträge, Rechnungen etc.) welche Formular-Datei verwendet.
• Faktura.ExportSettings.xml
  In dieser Datei können Verweise auf unterschiedliche Export-Module hinterlegt werden.
• Faktura.UI.xml
  Hier sind alle Bedienelemente (Menüeinträge, Werkzeugleisten) definiert inkl. C#-Quellcode der beim Klicken der Elemente ausgeführt wird.

Die Freeware Faktura enthält 2 Dialoge zur Profilverwaltung.

Dialog: Neues Profil erstellen...
Sie finden diesen Dialog im Menü ,,Datei". Mit diesem Dialog können Sie ein neues Profil in einem Ordner Ihrer Wahl (z.B. auf Ihrer Festplatte oder auf einem Netzwerklaufwerk) erstellen. Dieser Dialog erstellt dabei alle benötigten Dateien und Verzeichnisse, in dem er das Standart-Profil kopiert. Wahlweise kann dabei eine neue und somit leere Datenbank-Datei erstellt werden oder die vorhandene inkl. aller enthaltener Daten kopiert werden.

Dialog: Profil wechseln...
Sie finden diesen Dialog im Menü ,,Datei". Mit diesem Dialog können Sie das Profil auswählen, das verwendet werden soll. Die Anwendung merkt sich Ihre Auswahl und verwendet automatisch das zuletzt gewählte Profil beim nächsten Programmstart.

Normalerweise verwendet das Programm eine Access-Datenbank zum speichern aller Daten. Die Datenbankdatei befindet sich im Profilverzeichnis im Unterordner ,,dbs".

Wenn Sie, wie oben beschrieben, das Profilverzeichnis auf ein Netzwerklaufwerk verschieben, können Sie von allen Arbeitsplätzen aus, die Zugriff auf das Laufwerk haben, die Daten der selben Datenbank aus dem Netzwerkprofil bearbeiten.

Damit nutzen also alle Installationen die selbe Konfiguration und die selbe Datenbank.

Die Anwendung unterstützt erst seit Version 2008-06-20 eine Überwachung von Datensätzen. Wenn 2 Personen gleichzeitig Daten bearbeiten, bleiben die Daten erhalten, die zuletzt verändert wurden. Die Anwendung gibt nur eine Warnung aus. In älteren Versionen wird keine Warnung ausgegeben.

Es ist möglich, eine andere Datenbank zu verwenden. Dies kann eine andere Access-Datenbank an einem beliebigen Speicherort sein oder ein Datenbankserver.

Um eine andere Access-Datenbankdatei zu verwenden müssen Sie nicht zwangsläufig ein neues Profil erstellen oder das Standartprofil wechseln.

1. Öffnen Sie über den Menüpunkt Verwaltung den Dialog Einstellungen
2. Wechseln Sie zur Registerkarte Datenbank
3. Wählen Sie im Drop-Down-Menü Datenbank-Typ den Eintrag MS-Access aus

Nun können Sie unter Datenbank-Datei den Pfad direkt angeben oder über den Button [...] die neue Datenbank suchen und auswählen.

Das Feld Connection-String wird in diesem Fall nicht mehr benötigt und ist deshalb nicht editierbar.

Die Faktura kann ohne größere Umstellungen mit einer MySQL-Datenbank betrieben werden. Diese Beschreibung geht davon aus, dass bereits eine MySQL-Datenbank-Server vorhanden und dieser über das Netzwerk erreichbar ist.

Sie benötigen mindestens einen MySQL-Server der Version 4. (Die Anwendung geht davon aus, das Beziehungen mit Aktualisierungs- und Löschweitergabe vom verwendeten Datenbanksystem angeboten werden.)

Sie können den MySQL-Kommandozeilen-Client verwenden um eine MySQL-Datenbank zu einzurichten. Alternativ können Sie eines der grafischen Tools verwenden, die von MySQL angeboten werden:

• MySQL-Workbench (http://www.mysql.de/products/workbench/)
• Alt: MySQL-Query-Browser (http://dev.mysql.com/downloads/gui-tools/5.0.html)

In diesem Dokument werden die SQL-Befehle gezeigt, die für die einzelnen Schritte notwendig sind. Es kann also das Kommandozeilentool verwendet werden oder die Befehle in einem der Tools importiert/eingeben und ausgeführt werden.

Erstellen Sie sich auf dem MySQL-Datenbankserver eine Datenbank, z.B. mit dem Namen ,,faktura".

  CREATE DATABASE faktura;

Es muss ein Benutzer angelegt werden, der Lese- und Schreibrechte auf alle Tabellen der Faktura-Datenbank hat.

  CREATE USER 'faktura_user'@'%' IDENTIFIED BY 'passwort';
  GRANT ALL ON faktura.* TO 'db-user-name'@'%';

Im Beispiel oben wird ein Benutzer mit Namen ,,faktura_user" angelegt, der von jedem beliebigem Rechner im Netzwerk auf die Datenbank ,,faktura" zugreifen kann. Bitte verwenden Sie ein besseres Passwort als im Beispiel oben. Zudem ist es empfehlenswert, den Zugriff auf bestimmte Rechner oder Netzwerke zu beschränken. Die MySQL-Dokumentation (zu finden auf www.mysql.com erklärt die Möglichkeiten sehr genau).

Sie finden nach der Installartion im Verzeichnis ./profiles/default/dbs/ eine Datei mit Namen Faktura.SetupMySQL.sql. Diese Datei enthält alle SQL-Befehle zum einrichten der Datenbank.

Eine einfache Möglichkeit dieses Skript auszuführen ist folgende:
(Vorraussetzung ist, dass Sie den MySQL-Client installiert haben)

Öffnen Sie die ,,Eingabeaufforderung": Klicken Sie auf ,,Start" und dann auf ,,Ausführen". Hier geben Sie ,,cmd" in das Feld ,,Öffnen" ein und klicken dann auf ,,OK".

Wechseln Sie nun in das Verzeichnis, in dem sich das SQL-Skript befindet.

 cd C:\Programme\Faktura\profiles\default\dbs\

Starten Sie nun den MySQL-Client und melden sich am Datenbankserver an.

 C:\mysql\bin\mysql -u benutzername -p -h mysql-servername.oder.ip

Nun wählen Sie die Datenbank und führen das Skript aus:

 use faktura;
 source Faktura.SetupMySQL.sql

Damit die Faktura mit der MySQL-Datenbank kommunizieren kann, müssen Zugriffskomponenten installiert werden. Empfehlenswert ist die Verwendung des .NET-Connectors für MySQL.

.NET-Connector installieren

Der .NET-Connector kann auf der MySQL-Webseite heruntergeladen werden: http://www.mysql.com/downloads/connector/net/

Installieren Sie den .NET-Connector auf jedem Rechner, auf dem die Anwendung installiert ist und der mit dem MySQL-Datenbankserver zusammenarbeiten soll.

MySql.Data.dll in das Programmverzeichnis kopieren

Die Faktura benötigt für die Kommunikation eine DLL-Datei des Connectors im eigenen Programmverzeichnis: MySql.Data.dll. Suchen Sie im .NET.Connector-Installations-Verzeichnis die Datei ,,MySql.Data.dll" und kopieren Sie diese in das ,,bin"-Verzeichnis der Faktura (also in das gleicher Verzeichnis, in dem sich die Faktura.exe befindet)
Beispiel: Kopieren Sie die Datei MySql.Data.dll von C:\Program Files\MySQL\MySQL Connector Net 6.3.7\Assemblies\v2.0 nach C:\Programme\Faktura\bin.

Anwendung verbinden

Der Connection-String (die Verbindungsinformation) muss nun noch konfiguriert werden:

1. Öffnen Sie die Faktura
2. Begeben Sie sich über den Menüpunkt Verwaltung -> Einstellungen... zur Registerkarte Datenbank
3. Wählen Sie im Drop-Down-Menü Datenbank-Typ die Einstellung MySQL aus.

Dadurch wird das Drop-Down-Menü Datenbank-Datei deaktiviert und das Feld Connection-String editierbar. Nun können Sie die Konfigurationsinformationen (wie im Beispiel zu sehen) anpassen.

Beispiel:

 Server=192.168.8.8;
 Database=faktura;
 User ID=dbuser;
 Password=passwd;
 Pooling=false

Es ist auch möglich, die Verbindung zu MySQL über die ODBC-Schnittstelle herzustellen. Es wird aber empfohlen, den .NET-Connector (siehe oben) anstatt ODBC zu verwenden. Sollten Sie dennoch ODBC vorziehen, so kann die Verbindung wie folgt beschrieben hergestellt werden:

ODBC-Treiber installieren

Den ODBC-Treiber können Sie auf der MySQL-Homepage (http://www.mysql.de/downloads/connector/odbc/) herunterladen. Er wird mit Installationsprogramm angeboten.

Installieren Sie den MySQL-ODBC-Trieber auf jedem Rechner, auf dem die Anwendung installiert ist und der mit dem MySQL-Datenbankserver zusammenarbeiten soll.

Anwendung verbinden

Der Connection-String (die Verbindungsinformation) muss nun noch konfiguriert werden:

1. Öffnen Sie die Faktura
2. Begeben Sie sich über den Menüpunkt Verwaltung -> Einstellungen... zur Registerkarte Datenbank
3. Wählen Sie im Drop-Down-Menü Datenbank-Typ die Einstellung ODBC aus (da in diesem Fall die Verbindung über ODBC-Treiber hergestellt wird, wählen Sie bitte ODBC und nicht MySQL aus. Für die direkte Verbindung über die Option MySQL sind .NET-Konnektoren erforderlich).

Dadurch wird das Drop-Down-Menü Datenbank-Datei deaktiviert und das Feld Connection-String editierbar. Nun können Sie die Konfigurationsinformationen (wie im Beispiel zu sehen) anpassen.

Beispiel:

 DRIVER={MySQL ODBC 5.1 Driver};
 SERVER=192.168.8.8;
 DATABASE=faktura;
 UID=root;
 PASSWORD=;
 OPTION=3;

Wenn Sie eine neuere Version des MySQL-ODBC-Treibers verwenden, dann müssen Sie die Zeile DRIVER=... entsprechend anpassen.