Schild-NRW Installation: Unterschied zwischen den Versionen

===Registrierung der Statitsik.dlls===

Sollten Sie eine Fehlermeldung [[Fehlermeldung Klasse nicht registriert|Fehler beim Aufruf der Statistik-DLL: Klasse nicht registriert]] erhalten, so führen Sie das Programm Schild-NRW nochmals explizit mit der rechten Maustaste als Administrator aus.  

<nowiki>[oledb]</nowiki><br />

<nowiki>; Everything after this line is an OLE DB initstring</nowiki><br />

<nowiki>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Program Files (x86)\SchILD-NRW\DB\RS_2012_HJ1.mdb;Persist Security Info=False</nowiki>

[[https://www.svws.nrw.de/download/schild-module Schild-NRW Module]]

 

[[https://www.svws.nrw.de/download/tools Schild-NRW Tools]]

==Serverinstallation==

 

===Server-Installation mit Access-Datenbank===

===Server-Installation mit Microsoft SQL Server-Datenbank===

Schild-NRW kann auch mit SQL Server betrieben werden. Informationen zur Einrichtung und zur Inbetriebnahme der Datenbanksysteme finden Sie hier. Grundsätzlich wird aber vorausgesetzt, dass bei einem Betrieb mit einem Datenbankserver Kenntnisse über dieses Datenbanksystem vorhanden sind.

Stellen Sie sicher, dass ein Server im Schulverwaltungsnetz über den Port, den Sie später verwenden wollen, erreichbar ist. Installieren Sie dort den SQL Server in der gewünschten Variante. Die kostenfreie SQL Server Express-Variante können Sie über Microsoft beziehen. Wir empfehlen SQL Server Express 2014 oder -2017. Installieren Sie ein Datenbanktool, mit dem Sie auf den Server zugreifen können, z.B. Microsoft SQL Server Management Studio.

Legen Sie auf dem Server eine neue Datenbank an und spielen Sie das Script zum Anlegen der Tabellen und Felder von Schild-NRW ein. Bitte beachten Sie, dass dieses Script aus einer älteren Version sein kann! Die leere Datenbank muss dann einmal mit der aktuellen Version von Schild-NRW gestartet werden, damit alle Tabellen und Felder vorhanden sind!

Legen Sie mit diesem Befehl einen Admin-Zugang zu Schild-NRW mit leerem Passwort an:

<nowiki>INSERT INTO [dbo].[Users]</nowiki><br />

<nowiki>([ID],[US_Name],[US_LoginName],[US_Password],[US_UserGroups],[US_Privileges],[SchulnrEigner],[EMail],[EMailName],[SMTPUsername],[SMTPPassword],[EMailSignature],[HeartbeatDate],[ComputerName],[US_PasswordHash])</nowiki><br />

[[Datei:unicode.png|thumb|right|UDL-Datei in Unicode speichern]]

Richten Sie im Schild-NRW-Installationsverzeichnis nun eine UDL-Datei für den Zugriff auf den SQL Server ein. Kopieren Sie folgende Zeilen in eine Text-Datei und speichern Sie diese in Unicode-Kodierung mit der Dateiendung UDL ab! Diese UDL-Dateien müssen im Unterordner UDL der Schild-NRW-Installation liegen.

<nowiki>; Everything after this line is an OLE DB initstring</nowiki><br />

<nowiki>Provider=SQLNCLI11.1;Persist Security Info=False;Initial Catalog=Schild-NRW-DB;Data Source=SERVER\SQLEXPRESS</nowiki>

Tragen Sie in der UDL Ihren Servernamen und Ihren Instanznamen ein!

Führen Sie dann das Programm SchILD_PWCryptneu.exe aus. Wählen Sie die UDL-Datei und geben Sie dort den Usernamen und das Passwort Ihres SQL Servers ein.

Starten Sie nun Schild-NRW und wählen Sie die Datenbank-UDL aus. Es sollten nun Tabellen und Felder angelegt werden.

Sie können nun Ihre Schule einrichten. Dies muss aber nur geschehen, wenn Sie eine neue Datenbank aufbauen wollen. Wenn Sie aus einer bestehenden Datenbank in diese SQL-Server-Datenbank migrieren wollen, so können Sie diese Einrichtung abbrechen und den [[#Schild-NRW-Daten in eine andere Datenbank übertragen (migrieren)|Migrationsprozess mit Hilfe des Migrationstools]] vornehmen.

===Serverinstallation mit Oracle MySQL-Datenbank===

Die Einrichtung eines MySQL-Zugriffs (bzw. MariaDB-Zugriffs) funktioniert im Prinzip so, wie die in einer MS SQL Server-Umgebung. Ein Unterschied besteht jedoch darin, dass die MySQL-Datenbanken einen ODBC-Treiber benötigen, dem auch eine Datenquelle in der ODBC32-Verwaltung zugewiesen werden muss. Die einzelnen Schritte werden hier erklärt.

Legen Sie auf dem Server eine neue Datenbank an und spielen Sie das Script zum Anlegen der Tabellen und Felder von Schild-NRW ein. Bitte beachten Sie, dass dieses Script aus einer älteren Version sein kann! Die leere Datenbank muss dann einmal mit der aktuellen Version von Schild-NRW gestartet werden, damit alle Tabellen und Felder vorhanden sind!

Collation UTF8_bin<br />

Legen Sie mit diesem Befehl einen Admin-Zugang zu Schild-NRW mit leerem Passwort an:

<nowiki>ID,US_Name,US_LoginName,US_Password,US_UserGroups,US_Privileges,SchulnrEigner,EMail,EMailName,SMTPUsername,SMTPPassword,EMailSignature,HeartbeatDate,ComputerName,US_PasswordHash)</nowiki><br />

<nowiki>(1,'Administrator','Admin',NULL,'1;2;3;4;5','$',NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL)</nowiki>

Laden Sie sich den MySQL-ODBC-Treiber in der 32Bit-Variante herunter und installieren Sie diesen auf jedem Client, der eine Schild-NRW-Verbindung erhalten soll. Richten Sie nun eine ODBC-Datequelle ein, indem Sie die Windows-ODBC32-Verwaltunng aufrufen (Ausführen > ODBC32.exe). Fügen Sie eine Datenquelle hinzu und wählen Sie den MySQL-ODBC-Treiber. Zur Zeit empfehlen wir den älteren Treiber in der Version 5.1.13.

Achten Sie darauf, dass die Datenquelle auf jedem Client den gleichen Namen hat!

Richten Sie im Schild-NRW-Installationsverzeichnis nun eine UDL-Datei für den Zugriff auf den SQL-Server ein. Kopieren Sie folgende Zeilen in eine Text-Datei und speichern Sie diese in Unicode-Kodierung mit der Dateiendung UDL ab! Diese UDL-Dateien müssen im Unterordner UDL der Schild-NRW-Installation liegen.

<nowiki>[oledb]</nowiki><br />

<nowiki>; Everything after this line is an OLE DB initstring</nowiki><br />

<nowiki>Provider=MSDASQL.1;Persist Security Info=False;Data Source=schild_nrw_db</nowiki>

Tragen Sie in der UDL Ihren Servernamen und Ihren Instanznamen ein!

Führen Sie dann das Programm SchILD_PWCryptneu.exe aus. Wählen Sie die UDL-Datei und geben Sie dort den Usernamen und das Passwort Ihres SQL-Servers ein. Starten Sie nun Schild-NRW und wählen Sie die Datenbank-UDL aus. Es sollten nun Tabellen und Felder angelegt werden.

Sie können nun Ihre Schule einrichten. Dies muss aber nur geschehen, wenn Sie eine neue Datenbank aufbauen wollen. Wenn Sie aus einer bestehenden Datenbank in diese MySQL-Datenbank migrieren wollen, so können Sie diese Einrichtung abbrechen und den [[#Schild-NRW-Daten in eine andere Datenbank übertragen (migrieren)|Migrationsprozess mit Hilfe des Migrationstools]] vornehmen.

Eine [[Media:Schildnrw_mysql_installation.pdf|Anleitung von Herrn Roß als PDF]] gibt es in einer etwas älteren Version.

<nowiki>[Administration]</nowiki><br />

<nowiki>AdminDir={AdminDir}</nowiki><br />

<nowiki>GroupDir={GroupDir}</nowiki><br />

<nowiki>PrivateDir={PrivateDir}</nowiki>

Über den Eintrag <code>PrivateDir={PrivateDir}</code> kann ein Verzeichnis definiert werden, in dem exportierte Daten gespeichert werden. Dies hat den Vorteil, dass z.B. die Dateien für die Word-Serienbrieferstellung für jeden Benutzer getrennt abgelegt werden, so dass die Dateien nicht gegenseitig überschrieben werden, wenn mehrere Benutzer gleichzeitig die Serienbriefe erstellen wollen. Beispiel: Sie haben folgenden Eintrag in der Datei ADMIN.INI gemacht <code>PrivateDir=C:\Meine Schild-Daten</code>. In diesem Fall werden exportierte Daten in das jeweilige lokale Verzeichnis "C:\Meine Schild-Daten"gespeichert. Hinweis: Über den Eintrag <code>PrivateDir={PRIVATE}</code> (genau so geschrieben, inkl. der geschweiften Klammern) kann auf das Verzeichnis "C:\Dokumente und Einstellungen\{Benutzername}" verwiesen werden.

:C:\Programme\SchILD-NRW\Floskeln.txtC:\Programme\SchILD-NRW\Keytabs\Reports.mdb

<nowiki>[Administration]</nowiki><br />

<nowiki>AdminDir=</nowiki><br />

<nowiki>GroupDir=</nowiki><br />

<nowiki>PrivateDir=</nowiki>

<nowiki>[Administration]</nowiki><br />

<nowiki>AdminDir=</nowiki><br />

<nowiki>GroupDir=</nowiki><br />

<nowiki>PrivateDir=</nowiki>

<nowiki>[Administration]</nowiki><br />

<nowiki>AdminDir=</nowiki><br />

<nowiki>GroupDir=\\Server\SchILD-Dateien</nowiki><br />

<nowiki>PrivateDir=</nowiki>