Installation. Version SDN AG, Solution Development Network November 2010

Transkript

1 - 1 - Installation easylearn Version 4.8 SDN AG, Solution Development Network November 2010

2 - 2 - Inhaltsverzeichnis 1. Installation easylearn Web Server Installationsverzeichnis easylearn und PHP vorbereiten Sicherheitseinstellungen easylearn-scripts installieren Flash-Dateien für Multimediale Benutzerführung (Avatar) installieren Flash-Dateien für die AssistentINNen installieren Installation PHP PHP 5.3 (Für MySQL 5.x oder MS-SQL 2005/2008) PHP 5.2 (Für MS-SQL 2000) Nur für IIS6 (Windows 2003 Server): PHP.INI Konfiguration Windows 2003 Server/ IIS 6 für easylearn konfigurieren FastCGI installieren FastCGI als Webdiensterweiterung konfigurieren FastCGI als Prozessor für.php-dateien konfigurieren PHP Modul für FastCGI konfigurieren Startdokumente erweitern MIME-Typen erweitern Schreibberechtigung beim IIS 6 konfigurieren Sicherheitseinstellungen auf Ordner-/Dateiebene einstellen Sicherheitseinstellungen cmd.exe Windows 2008 Server / IIS / PHP IIS Vorbereiten Konfiguration IIS Handlerzuordnung / Modulzuordnung Anzahl Bytes für Dateiupload evtl. erhöhen FastCGI-Einstellungen Sicherheitseinstellungen auf Ordner-/Dateiebene einstellen Featureberechtigungen bearbeiten Standarddokumente erweitern MIME-Typen erweitern Fehlerseiten konfigurieren MySQL Datenbank MySQL Konfiguration in my.ini Datenbank erstellen und Initialdaten einlesen MySQL Virenscanner Microsoft SQL Server 2000 oder älter Erweiterung MSSQL in PHP.INI konfigurieren Autentifizierung MS SQL überprüfen Microsoft SQL Datenbank erstellen Datenbankschema und Initialdaten einlesen Microsoft SQL Server 2005 oder neuer Erweiterung MS SQL Server in PHP.INI konfigurieren Microsoft SQL Server 2008 Native Client Authentifizierung MS SQL überprüfen Microsoft SQL Datenbank erstellen... 22

3 Datenbankschema und Initialdaten einlesen easylearn konfigurieren Updates durchführen Anmelden an easylearn Optionen Hintergrundprozess erstellen Portalrun einrichten Optionen konfigurieren adresse des Absenders Mindestens eine adresse muss zwingend eingegeben werden Portalrun im Taskscheduler (Geplante Tasks) konfigurieren Zeitplan einstellen Erste Schritte System-Parameter einstellen/systemlizenz eingeben Gesamtsystem Systemadministrator - Einstellungen - Parameter Community Optionen einstellen Community Rollen Community verwalten - Einstellungen Parameter/Vorgaben Community Rollen Community verwalten - Einstellungen Softwarelizenz Datenbankpasswort verschlüsseln Menü: Gesamtsystem Systemadministrator Admin-Funktionen Tools System Ver- /Entschlüsselung Kundenspezifische Konfiguration Versionen easylearn Datenbank Option LDAP... 33

4 Installation easylearn 1.1. Web Server Die Installation setzt einen funktionsfähigen Web Server voraus. Auf dem Serversystem muss ebenfalls der Internet Explorer 6 oder höher installiert sein Installationsverzeichnis easylearn und PHP vorbereiten Als erstes sollt jeweils ein Installationsverzeichnis für easylearn und PHP erstellt werden. Wählen Sie für das easylearn Verzeichnis ein Laufwerk welches genügend Platz für die easylearn Installation sowie zukünftige Dateien (Wissensobjekte) bereitstellt. Wir empfehlen aus Kompatibilitätsgründen das PHP Verzeichnis als Root Verzeichnis anzulegen Sicherheitseinstellungen Um optimale Sicherheit auf Dateiebene zu gewährleisten müssen die Speziellen Berechtigungen des Benutzers Benutzer welche im Windows Standard definiert sind entfernt werden. Unter Windows 2008 und 2008R2 können Sie die Berechtigungen wie folgt anpassen: Eigenschaften -> Register Sicherheit -> Erweitert -> Berechtigungen ändern Deaktivieren Sie die Vererbbare Berechtigungen des übergeordneten Objektes einschliessen, im Windows-Sicherheits Dialog klicken Sie auf Kopieren Danach müssen Sie in der Liste der Berechtigungseinträge den Benutzer Benutzer mit der Berechtigung Speziell auswählen und Entfernen. Markieren Sie nun die Checkbox Alle Berechtigungen für untergeordnete Objekte durch vererbbare Berechtigungen von diesem Objekt ersetzen Klicken Sie auf OK um alle Einstellungen zu übernehmen. Im Fenster Eigenschaften lassen Sie die neu gesetzten Benutzereinstellungen nochmals überprüfen easylearn-scripts installieren Die Portalscripts von der CD in \easylearn\easylearn-x.x.x.exe in das gewünschte Webverzeichnis auspacken (z.b. d:\easylearn). Den Ordner install/courses nach courses kopieren Den Ordner install/chapters nach chapters kopieren

5 Flash-Dateien für Multimediale Benutzerführung (Avatar) installieren Die Flashdateien von der CD in \easylearn\avatar.exe in easylearn -Unterverzeichnis elearnwin auspacken (z.b.: c:\inetpub\wwwroot\eportal\elearnwin) Flash-Dateien für die AssistentINNen installieren Die Flashdateien von der CD in \easylearn\assistants.exe in easylearn -Unterverzeichnis elearnwin auspacken (z.b.: c:\inetpub\wwwroot\eportal\elearnwin) Installation PHP Achtung: Verwenden Sie bitte nicht die Windows Installer Version, da diese in andere Ordner installiert und dies teilweise zu Problemen führt. Verwenden Sie immer die "Non Thread Safe" Versionen von PHP, damit PHP mit FastCGI optimal funktioniert. Diese Versionen sind durch "- nts-" im ZIP-Dateiname erkennbar. PHP ist derzeit offiziell nur als 32-Bit Version verfügbar. Diese Version kann aber problemlos auch bei den 64-Bit Versionen von Windows Server verwendet werden. Die FastCgi-Schnittstelle startet dann jeweils einen 32-Bit Prozess und kommuniziert mit diesem PHP 5.3 (Für MySQL 5.x oder MS-SQL 2005/2008) Das neueste ZIP Package Version 5.3.x (VC9 x86 Non Thread Safe ) von downloaden und in das Verzeichnis C:\PHP extrahieren. Beispiel: php nts-win32-vc9-x86.zip Microsoft Visual C++ Runtime Sie benötigen das neueste Microsoft Visual C++ Runtime, verwenden Sie die Version auf der CD im Verzeichnis \tools. VC9_SP1_vcredist_x86_de.exe (Betriebssystemsprache Deutsch) VC9_SP1_vcredist_x86_en.exe (Betriebssystemsprache Englisch) Sie können die neueste Version auch von 074B9F2BC1BF downloaden und installieren (vcredist_x86.exe) PHP 5.2 (Für MS-SQL 2000) Das neueste ZIP Package Version 5.2.x (VC6 x86 Non Thread Safe) von downloaden und in das Verzeichnis C:\PHP extrahieren. Beispiel: php nts-win32-vc6-x86.zip

6 Nur für IIS6 (Windows 2003 Server): FastCGI für IIS6 (Windows 2003 Server) herunterladen und installieren (fcgisetup32.msi resp. fcgisetup64.msi) PHP.INI Benennen Sie die Datei php.ini-production im PHP Installatiosverzeichnis in php.ini um. Erstellen Sie die beiden Unterordner c:\php\uploadtemp und c:\php\sessiondata Konfiguration In der PHP Konfigurationsdatei c:\php\php.ini sind folgende Einträge anzupassen: upload_tmp_dir="c:\php\uploadtemp" session.save_path="c:\php\sessiondata" extension_dir = c:/php/ext smtp=[ihren Mailserver angeben, IP-Adresse oder Name (muss via DNS auflösbar sein)] error_reporting = E_ALL & ~E_NOTICE session.gc_maxlifetime=28800 fastcgi.impersonate = 1 fastcgi.logging = 0 cgi.fix_pathinfo = 1 cgi.force_redirect = 0 date.timezone = Europa/Zurich (siehe: Maximale Grösse der Upload-Dateien einstellen upload_max_filesize = 24M post_max_size = 30M memory_limit = 128M max_input_time=120 max_execution_time= Erweiterungen GD und SOAP, OpenSSL aktivieren. extension=php_gd2.dll extension=php_soap.dll extension=php_openssl.dll extension=php_mbstring.dll extension=php_mysql.dll (Für MySQL)

7 - 7 - extension=php_mssql.dll (Für PHP 5.2 und MS-SQL 2000) extension=php_sqlsrv_52_nts_vc6.dll (Für PHP 5.2 und MS-SQL 2005/2008) extension=php_sqlsrv_53_nts_vc9.dll (Für PHP 5.3 und MS-SQL 2005/2008) Option LDAP Wenn LDAP verwendet wird, muss php_ldap.dll aktiviert werden. extension=php_ldap.dll

8 Windows 2003 Server/ IIS 6 für easylearn konfigurieren Der Webserver wird über den Informationsdienste-Manager verwaltet. In der nachfolgenden Installationsanleitung wird immer davon ausgegangen, dass PHP via FastCGI ausgeführt wird FastCGI installieren Die Installationsdatei für FastCGI befindet sich auf der Installations-CD unter Tools\fcgisetup32.msi FastCGI als Webdiensterweiterung konfigurieren Internet Informationsdienste -> Servername -> Webdiensterweiterungen Neue Webdiensterweiterung hinzufügen Erweiterungsname Erforderliche Dateien FastCGIHandler C:\WINDOWS\system32\inetsrv\fcgiext.dll Erweiterungsstatus auf "Zugelassen" setzen Wichtig: Wenn Webquiz installiert wird, muss die Webdiensterweiterung für Active Server Pages aktiviert werden.

9 FastCGI als Prozessor für.php-dateien konfigurieren Internet Informationsdienste -> Servername -> Standardwebsite -> Eigenschaften [Basisverzeichnis] -> Konfiguration -> Hinzufügen -> FastCGIHandler Ausführbare Datei Erweiterung C:\WINDOWS\system32\inetsrv\fcgiext.dll.php PHP Modul für FastCGI konfigurieren Start -> Ausführen: cmd.exe cd \windows\system32\inetsrv copy <Installationscd>\tools\fcgiext.ini In der Datei fcgiext.ini von der Installations-CD sind folgende Einstellungen vorhanden: [Types] php=php Application [PHP Application] ExePath=C:\PHP\php-cgi.exe EnvironmentVars=PHPRC:C:\PHP,PHP_FCGI_MAX_REQUESTS:10000 InstanceMaxRequests=1000 RequestTimeout=240 ActivityTimeout= Startdokumente erweitern [Dokumente] -> Standarddokument aktivieren : index.php, index.htm, index.html hinzufügen MIME-Typen erweitern Mit dem mitgelieferten Script install/mime-add-iis.vbs können die nachfolgenden Mime-Typen automatisch hinzugefügt werden. Internet Informationsdienste -> Servername -> WebSites oder ausgewählte Site [HTTP-Header] -> MIME-Typen -> Neu AICC Dateien

10 Erweiterung MIME-Type.crs text/plain.cst text/plain.des text/plain.flv video/x-flv Flash Video File (FLV), MP4 Videos.flv video/x-flv.mp4 video/mp4.m4v video/mp Word 2007 Erweiterung MIME-Type.docx application/vnd.openxmlformats-officedocument.wordprocessingml.document.docm application/vnd.ms-word.document.macroenabled.12.dotx application/vnd.openxmlformats-officedocument.wordprocessingml.template.dotm application/vnd.ms-word.template.macroenabled Excel 2007 Erweiterung MIME-Type.xlsx application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.xlsm application/vnd.ms-excel.sheet.macroenabled.12.xltx application/vnd.openxmlformats-officedocument.spreadsheetml.template.xltm application/vnd.ms-excel.template.macroenabled.12.xlsb application/vnd.ms-excel.sheet.binary.macroenabled.12.xlam application/vnd.ms-excel.addin.macroenabled Powerpoint 2007 Erweiterung MIME-Type.pptx application/vnd.openxmlformats-officedocument.presentationml.presentation.pptm application/vnd.ms-powerpoint.template.macroenabled.12.potx application/vnd.openxmlformats-officedocument.presentationml.template.potm application/vnd.ms-powerpoint.template.macroenabled.12.ppam application/vnd.ms-powerpoint.addin.macroenabled.12.ppsx application/vnd.openxmlformats-officedocument.presentationml.slideshow.ppsm application/vnd.ms-powerpoint.slideshow.macroenabled.12

11 Schreibberechtigung beim IIS 6 konfigurieren Für die Verzeichnisse upload, download,chapter, courses muss das Recht für Schreiben aktiviert werden. Start -> Einstellungen -> Systemsteuerung -> Verwaltung -> Internet Informationsdienste-Manager Internet Informationsdienste -> Servername -> (easylearn Website) Verzeichnis upload wählen, Eigenschaftsseite Verzeichnis, Optionen für Lesen und Schreiben markieren, bei Anwendungseinstellungen/Ausführungsberechtigungen auf keine einstellen. Für die Verzeichnisse download, chapters, courses kann nach dem gleichen Schema vorgegangen werden.

12 Sicherheitseinstellungen auf Ordner-/Dateiebene einstellen. Die Berechtigung für das PHP-Verzeichnis (C:\PHP) muss so gesetzt werden, dass der Prozess, welcher PHP.EXE ausführt, im Verzeichnis C:\PHP (+Unterverzeichnisse) lesen und ausführen darf. Zusätzlich muss für die Unterordner uploadtemp und sessiondata die Berechtigung für Schreiben, Ändern, Löschen gesetzt werden. Standardmässig müssen die Berechtigungen für den Benutzer IUSR_[SERVERNAME] wie folgt gesetzt werden. C:\PHP Lesen + Ausführen C:\PHP\uploadtemp Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen C:\PHP\sessiondata Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen WebSite-Ordner Lesen WebSite-Ordner upload, download, Lesen+Schreiben+Löschen+Verzeichnisse chapters, courses erstellen+verzeichnisse löschen Spezielle Berechtigungen für Benutzer NETZWERKDIENST WebSite-Ordner download Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen PHP wird mit der anonymen Benutzerkennung (IUSER_XXXX) für die entsprechende WebSite aufgerufen. Wenn der anonyme Zugriff ausgeschaltet wurde, muss jeder Benutzer, der auf easylearn zugreift mit den entsprechenden Rechten ausgestattet werden (evtl. Vollzugriff für Jeder für die

13 Ordner PHP/upload/download/courses/chapters und Lesen für Jeder beim WebSite-Ordner einstellen). Anonymer Zugriff IUSR_XXXXX Windowsautentifizierung Jeder einzelne Benutzer oder Jeder Sicherheitseinstellungen cmd.exe Das Windowsprogramm \windows\system32\cmd.exe muss durch den Benutzer IUSR_XXXX gelesen und ausgeführt werden dürfen. Ansonsten kann der PDFExtractor nicht ausgeführt werden.

14 Windows 2008 Server / IIS / PHP IIS Vorbereiten Der WebServer (IIS) wird über den Server-Manger -> Rollenübersicht -> Rollen hinzufügen installiert. Vom WebServer benötigte Features werden automatisch vom Assistenten für die Installation vorgeschlagen. Für die Verwendung von PHP muss der Rollendienste CGI (beinhaltet auch FastCGIModul) unter Anwendungsentwicklung ausgewählt werden. Wichtig: Wenn Webquiz installiert wird, muss die Webdiensterweiterung für ASP aktiviert werden Konfiguration IIS Der Webserver wird über den Internetinformationsdienste-Manager verwaltet. In der nachfolgenden Installationsanleitung wird immer davon ausgegangen, das PHP via FastCGI- Modul ausgeführt wird. Start -> Verwaltung -> Internetinformationsdienste-Manager Handlerzuordnung / Modulzuordnung Internetinformationsdienste-Manager -> Servername -> Handlerzuordnung -> Modulzuordnung hinzufügen Anforderungspfad Modul Ausführbare Datei Name *.php FastCGIModul C:\php\php-cgi.exe PHP-FastCGI Einschränkungen für die Modulzuordnung: Zuordnung: [nicht markiert] Verben: GET,POST,HEAD Zugriff: Script Anzahl Bytes für Dateiupload evtl. erhöhen Internetinformationsdienste-Manager -> Servername -> Anforderungsfilterung -> Featureeinstellungen bearbeiten Im Feld "Maximal zulässige Inhaltslänge (Bytes)" den Standardwert von 30'000'000 Millionen Bytes gegebenenfalls erhöhen.

15 FastCGI-Einstellungen Start -> Verwaltung -> Internetinformationsdienste-Manager -> Servername -> FastCGI-Einstellungen -> c:\php\phpcgi.exe (doppelklicken) Achtung: Sollte bei Ihnen der Menü Punkt FastCGI-Einstellungen nicht vorhanden sein und Sie einen Windows 2008 Server einsetzen müssen Sie das IIS7 Admin Pack Installieren Allgemein "MaxRequests"-Instanz: 1000 Umgebungsvariablen: Fügen Sie folgende Variable hinzu: Name: PHP_FCGI_MAX_REQUESTS Wert: Der Wert muss höher sein als der Wert bei "MaxRequests"-Instanz Der Standardfehlermodus muss von ReturnStdErrIn500 auf IgnoreAndReturn200 geändert werden Prozessmodell Aktivitätstimeout: 240 Anforderungstimeout: Sicherheitseinstellungen auf Ordner-/Dateiebene einstellen. Bei den nachfolgenden Ordnern muss die Berechtigung für die Benutzergruppe IUSR gesetzt werden. C:\PHP C:\PHP\uploadtemp C:\PHP\sessiondata WebSite-Ordner WebSite-Ordner upload, download, chapters, courses Lesen + Ausführen Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse lösche) Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen Lesen Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen Spezielle Berechtigungen für Benutzer NETZWERKDIENST WebSite-Ordner download Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen

16 Featureberechtigungen bearbeiten Für die Verzeichnisse upload, download, chapters, courses, install, images, include, modules, themes muss die Featureberechtigung nur auf Lesen gesetzt werden. Gehen Sie dazu wie folgt vor: Internetinformationsdienste-Manager -> Servername -> Sites -> [SITE_NAME] -> [VERZEICHNISS_NAME] -> Handlerzuordnungen doppelklicken -> im Menü Aktionen Rechts die Featureberechtigungen bearbeiten. Die Berechtigung für Script und Ausführen muss entfernt werden. Vergewissern Sie sich in easylearn unter Systemadministrator -> Admin-Funktionen - Installcheck, dass keine roten Warnungen erscheinen Standarddokumente erweitern Internetinformationsdienste-Manager -> Servername -> Standarddokumente -> Hinzufügen index.php, index.htm, index.html MIME-Typen erweitern Internetinformationsdienste-Manager -> Servername -> MIME-Typ -> hinzufügen AICC Dateien Erweiterung MIME-Type.crs text/plain.cst text/plain.des text/plain Flash Video File (FLV), MP4 Videos.flv video/x-flv.mp4 video/mp4.m4v video/mp4

17 Fehlerseiten konfigurieren Für den PHP SOAP Service muss die Einstellung für Fehlerseiten angepasst werden. Internetinformationsdienste-Manager -> Servername -> Verwaltung -> Konfigurationseditor Die Einstellung existingresponse von Auto auf PassThrough einstellen MySQL Datenbank Die MySQL Datenbanksoftware 5.0 oder höher muss installiert sein. Folgende Schritte müssen durchgeführt werden. Bei MySQL Version 5.0 muss der Zeichensatz auf latin1 eingestellt und in der Datei config.php des easylearn Installationsverzeichnisses folgender Eintrag hinzugefügt werden: $GLOBALS["SET_MYSQL_INITCMD"] = "SET SESSION SQL_MODE='' ; "; Alternativ kann bei der MySQL Installation auch der Strict Mode Deaktiviert werden. Hinweis: Eine Kurzanleitung zur MySQL Installation finden Sie in der easylearn Academy ( unter MySQL Installation Windows 2008 Unter Windows 2008 kann es bei der Installation von MySQL zu Problemen kommen falls der Datenbank Typ InnoDB ist, verwenden Sie deswegen unter Windows 2008 immer den Datenbank Typ MyISAM.

18 MySQL Konfiguration in my.ini Die Einstellung max_allowed_packet im Abschnitt [mysqld] muss mindestens auf 8 MB eingestellt werden. [mysqld] max_allowed_packet=16m Datenbank erstellen und Initialdaten einlesen Um den MySQL Datenbank Server nicht über die Windows Kommandozeile Verwalten zu müssen empfehlen wir die Verwendung von HeidiSQL. Den Download finden Sie unter Datenbank manuell erstellen C:\mysql\bin\mysqladmin h localhost u root create eportal Datenbankschema und Initialdaten manuell einlesen. C:\mysql\bin\mysql u root -e "source c:\inetpub\wwwroot\eportal\install\mysql.eportal-4.6.sql" eportal C:\mysql\bin\mysql u root -e "source c:\inetpub\wwwroot\eportal\install\mysql.initialdata.sql" eportal MySQL Virenscanner Verschiedene Antivirenlösungen verursachen beim Prüfen des MySQL Data Verzeichnisses sowie temporären Tabellen Fehlalarme und können zu Performanceverlusten führen. Nach der Installation des MySQL Servers, ist es daher erforderlich, dass der Datenordner Data, in welchem MySQL die Daten speichert, dauerhaft von der Virenprüfung ausgeschlossen wird. Zusätzlich sollte beachtet werden, dass MySQL temporäre Tabellen im Windows Temp Verzeichnis anlegt. Empfohlen wird ein separates MySQL Temp Verzeichnis anzulegen und dieses ebenfalls von der Viren-Prüfung auszuschliessen. MySQL Konfigurationsdatei my.ini Abschnitt: [mysqld], Wert: tmpdir="c:/mysql/temp"

19 Microsoft SQL Server 2000 oder älter Die Datenbank MS SQL Server 2000 und älter werden von easylearn ab PHP 5.3 nicht mehr unterstützt. Für diese Datenbanken muss PHP 5.2.x verwendet werden. Falls sich der MS SQL Server auf einem anderen PC als dem Webserver befindet, muss der SQL Server Client installiert werden (Setup SQL Server -> Nur Client installieren) Erweiterung MSSQL in PHP.INI konfigurieren Den Eintrag ;extension=php_mssql.dll suchen und das Semikolon entfernen (aktivieren) extension=php_mssql.dll Wenn die Verbindung über die Windows-Authentifizierung hergestellt werden soll, muss folgendes eingestellt werden: [MSSQL]: ; Use NT authentication when connecting to the server mssql.secure_connection = on Autentifizierung MS SQL überprüfen Der MS SQL Server muss für die Autentifizierungsmethoden SQL Server und Windows konfiguriert werden.

20 Microsoft SQL Datenbank erstellen Mit dem SQL Server Enterprise Manager eine neue Datenbank erstellen (z.b. eportal) Datenbankschema und Initialdaten einlesen. Den SQL Query Analyzer starten (im Menü Tools) und die neu erstellte Datenbank auswählen. Um das Datenbankschema zu erstellen, das Script install\mssql.eportal.4.6.sql im easylearn Ordner öffnen und ausführen. Danach das Script install\mssql.initialdata.sql öffnen und ausführen. Dieses Script erstellt die notwendigen Datensätze für easylearn Microsoft SQL Server 2005 oder neuer Erweiterung MS SQL Server in PHP.INI konfigurieren Für den Zugriff auf den SQL Server wird SQL Server Driver for PHP 1.1 oder neuer benötigt. Die Version 1.0 wird nicht unterstützt. Es wird easylearn oder neuer benötigt. Bei älteren easylearn Versionen muss der Datenbanktreiber php_mssql mit PHP 5.2 verwendet werden caad9&displaylang=en In der Datei SQLServerDriverForPHP11.Exe (auf der Installations-CD unter Tools) sind die verschiedenen Varianten / PHP Versionen enthalten. Die Variante muss jeweils zur PHP Version passen. Es muss jeweils die Non Thread Safe Version (_nts_) gewählt werden. Kopieren Sie die gewünschte DLL in das..\php\ext Verzeichnis z.b. php_sqlsrv_53_nts_vc9.dll wird für PHP 5.3 und MS-SQL 2005/2008 verwendet z.b. php_sqlsrv_52_nts_vc6.dll wird für PHP 5.2 und MS-SQL 2000 verwendet Die Erweiterung muss in PHP.INI aktiviert werden. extension=php_sqlsrv_xxxx.dll Microsoft SQL Server 2008 Native Client Der SQL Server Driver for PHP 1.1 benötigt den Microsoft SQL Server 2008 Native Client. Falls der Datenbankserver MS SQL Server 2008 nicht auf dem Webserver installiert ist, muss der Native Client installiert werden. Auch wenn der MS SQL Server 2005 auf dem Webserver installiert ist, braucht es den neueren Microsoft SQL Server 2008 Native Client C099BCB4&displaylang=en

21 Der Client ist auf der CD im Ordner Tools als sqlncli_x32.exe resp sqlnci_x64.exe Authentifizierung MS SQL überprüfen Der MS SQL Server muss für die Authentifizierungsmethoden SQL Server und Windows konfiguriert werden. Wenn der SQL Server nicht auf dem Webserver installiert ist, muss die Option Remoteverbindungen mit diesem Server zulassen markiert sein.

22 Microsoft SQL Datenbank erstellen Mit dem SQL Server Management Studio eine neue Datenbank erstellen (z.b. easylearn) Datenbankschema und Initialdaten einlesen. In Microsoft SQL Server Management Studio die neu erstellte Datenbank auswählen. Dann über Datei -> Öffnen -> Datei das Script install\mssql.eportal.4.6.sql im easylearn-verzeichnis öffnen und ausführen. Danach das Script install\mssql.initialdata.sql öffnen und ausführen. Dieses Script erstellt die notwendigen Datensätze für easylearn.

23 easylearn konfigurieren Die Scriptvorlage install/install.config.php nach config.php kopieren. Die Datei config.php mit dem Editor öffnen die Einträge für die Datenbank konfigurieren. $db_server='localhost'; $db_database='eportal'; $db_login='sa'; $db_password='secret'; Tipp: Das Passwort kann nach der Installation verschlüsselt werden. $db_type="mssql"; (für MS SQL 2000 oder früher, mssqlnc für SQL Server 2005 oder neuer, oder mysql für MySQL Datenbankenn Bei MS SQL Server 2005/2008 muss bei der Einstellung $db_server auch die Instanz angegeben werden, z.b. $db_server= Servername\Instanz ; Updates durchführen Über die URL die Updateroutine starten, um eventuelle Datenbankergänzungen durchzuführen. Als Benutzer admin@easylearn.ch mit dem Passwort easylearn anmelden und den Updater starten.

24 Anmelden an easylearn Bei der Grundinstallation wird der Benutzer mit dem Passwort easylearn erstellt. Dieser Benutzer hat Systemverwalterrechte und kann sämtliche Einstellungen ändern Optionen Die Anmelde-Sprache und das Design kann über die URL gesteuert werden. Der Parameter userlang=xx übersteuert die standardmässige eingestellte Sprache. Als Sprachcode kann de, en oder fr eingegeben werden. Wenn ebenfalls das Design übersteuert werden soll, kann dies mit usertheme=xxxxxx angegeben werden, wobei xxxxxx ein gültiges Design sein muss (z.b. default, simple ). Als weiterer Parameter kann userframe mit 1 oder 0 übergeben werden. Dadurch wird die standardmässige Einstellung für Frames (mit/ohne Frames) überschrieben. Wenn nur das Logo auf der rechten Bannerseite überschrieben werden soll, kann mit den Parametern ubimage=<pfad der Logo-datei> und ubimagewidth=xxx die Breite des Logos eingestellt werden. Beispiel:

25 Hintergrundprozess erstellen easylearn benötigt einen Hintergrundprozess, welcher die Mailwarteschlange abarbeitet und weitere Aktionen in bestimmten Abständen (ca. alle 10 Minuten) durchführt. Für die Verarbeitung wird das Programm portalrun.exe verwendet Portalrun einrichten Das Programm portalrun.exe führt eine angegebene URL auf dem Webserver aus und prüft das Ergebnis des Aufrufs. Wird vom Webserver eine Leerseite zurückgegeben mit dem HTTP-Status "200 OK" wird dies als korrekte Ausführung interpretiert. Wenn Fehler auftreten, kann portalrun eine oder mehrere s versenden und/oder ein Programm starten. Dadurch wird ein mögliches Fehlverhalten des Servers oder einer Ihrer Komponenten sofort entdeckt und es kann ein an den zuständigen Administrator geschickt werden, oder per Programm z.b. eine SMS erstellt und gesendet werden. Die option und die Programmausführungsoption sind optional und müssen nicht eingeschaltet sein. Das Programm portalrun.exe und die Konfigurationsdatei portalrun.ini befinden sich auf der Installations- CD im Ordner Portal. Kopieren Sie diese Dateien auf den Webserver, z.b. ins Verzeichnis c:\admin. Wenn die aufzurufende URL eine Authentifizierung benötigt (nur "Basic"), kann mit der Option HTTPAuth der Benutzername und das Passwort angegeben werden Optionen konfigurieren Die Optionen werden in der Datei portalrun.ini gespeichert. Diese Datei muss sich im selben Verzeichnis wie portalrun.exe befinden. Die Datei portalrun.ini enthält die Abschnitte SMTP, Message, HTTPAuth und Run. Portalrun.ini [SMTP] Host=localhost UserID= Password= Name des SMTP-Servers. Diese Angabe ist zwingend notwendig, wenn die Mailoption verwendet werden soll. Wenn diese Angabe fehlt, ist die Mail-option ausgeschaltet Falls die Anmeldung am SMTP-Server zwingend ist, können hier die UserID und das Passwort eingegeben werden. Wenn der Wert Password gesetzt ist, wird immer versucht sich am SMTP-Server anzumelden. Im Normalfall muss UserID und Password nicht gesetzt und kann mit vorangestelltem Strichpunkt auskommentiert werden. [Message] Subject=Betreff Betreffzeile der Mail, Vorgabe: easylearn Taskscheduler FromName= Name des Absenders, Vorgabe: easylearn FromAddress= adresse des Absenders To= adresse[n] der Empfänger. Mehrere adressen müssen durch ein Komma voneinander getrennt werden Mindestens eine adresse muss zwingend eingegeben werden Cc= adresse[n] der Empfänger welche eine Kopie erhalten. Mehrere E- Mailadressen müssen durch ein Komma voneinander getrennt werden.

26 [HTTPAuth] User= Benutzername für die Authentifizierung am Webserver Password= Passwort für die Authentifizierung am Webserver [Run] Command= auszuführendes Programm inkl. Pfad und Parametern [Option] NumTries= Anzahl Wiederholungen bei Fehlschlägen. Vorgabe: 2 WaitTime= Zeit in Sekunden welche zwischen den Wiederholungen gewartet wird. Vorgabe: 30 Um in den Konfigurationsmodus zu gelangen, die oder Programmfunktion zu testen, kann portalrun.exe ohne Parameter aufgerufen werden. Mit der Schaltfläche "Test URL" kann eine beliebige URL eingegeben werden Portalrun im Taskscheduler (Geplante Tasks) konfigurieren Öffnen Sie das Fenster Geplante Tasks : 1. Start -> Einstellung -> Systemsteuerung -> Geplante Tasks 2. Wählen Sie Geplanten Task hinzufügen 3. Klicken Sie im Assistent auf die Schaltfläche Weiter 4. Klicken Sie auf die Schaltfläche Durchsuchen und wählen Sie das Programm Portalrun.exe aus (z.b. in C:\Admin) 5. Klicken Sie auf Täglich und die Schaltfläche Weiter 6. Ändern Sie die Zeit auf 06:00 und klicken Sie auf die Schaltfläche Weiter 7. Geben Sie den Benutzernamen und das Passwort ein, unter dem dieses Programm ausgeführt werden soll. Es reicht, wenn der Task mit dem Benutzer NT AUTHORITY\SYSTEM ausgeführt wird (leeres Passwort) 8. Klicken Sie auf Fertigstellen Nun wird Ihnen der erstellte Task angezeigt. Fügen Sie jetzt im Feld "Starten" die korrekte URL an. Die URL muss auf das easylearn PHP-Script sysmailqueue.php zeigen. Beispiele:

27 Zeitplan einstellen Stellen Sie die Startzeit ein, ab wann portalrun.exe täglich ausgeführt wird. Klicken Sie anschliessend auf die Schaltfläche Erweitert.

28 Aktivieren Sie den Wiederholungsintervall und erhöhen Sie die Dauer auf die gewünschte Stundenzahl. Wenn Sie das Programm z.b. von morgens 06:00 Uhr bis 22:Uhr ausführen möchten, stellen Sie die Dauer auf 16 Stunden ein.

29 Erste Schritte Nach der Installation von easylearn müssen die gewünschten Optionen eingestellt werden. In dieser Kurzanleitung sind nur die einzelnen Arbeitsschritte aufgeführt. Die einzustellenden Optionen sind in der Dokumentation genauer beschrieben System-Parameter einstellen/systemlizenz eingeben Die Systemparameter werden verwendet, wenn der Benutzer noch nicht angemeldet ist. Alle Optionen ausser META-Beschreibung und META-Schlüsselwörter können in den Communityoptionen geändert werden. Die Communityoptionen werden aber erst aktiv, wenn sich der Benutzer angemeldet hat und dadurch die Communityzugehörigkeit feststeht. Die Systemlizenz muss hier eingegeben werden. Ohne gültige Systemlizenz stehen die anderen Menüoptionen nicht zur Verfügung Gesamtsystem Systemadministrator - Einstellungen - Parameter Wenn die rechte Menübox ausgeschaltet wird, dann werden alle Einträge dieser Box an Ende der linken Menübox angezeigt. Die META -Informationen werden als Zusatzinformationen in den HTML-Header eingefügt.

30 Community Optionen einstellen In den Community- Optionen sind communityabhängige Einstellungen gespeichert. Im Minimum muss hier die Beschreibung der Community, die Adresse der Homepage und die Admin-Mail definiert werden Community Rollen Community verwalten - Einstellungen Parameter/Vorgaben Community Rollen Community verwalten - Einstellungen Softwarelizenz

31 Datenbankpasswort verschlüsseln Passwörter sind sicherheitsrelevante Daten. Diese sollten nach Möglichkeit nicht unverschlüsselt in einer Datei abgelegt werden. easylearn unterstützt diese Anforderung in dem es über eine Funktion für die Ver-/Entschlüsselung verfügt Menü: Gesamtsystem Systemadministrator Admin- Funktionen Tools System Ver-/Entschlüsselung Mit der Verschlüsselung können Passwörter für folgende Einstellungen generiert werden: - config.php: $db_password - config.ldap.php $GLOBALS[ LDAPCONFIG ][ BIND_PASSWORD ]

32 Kundenspezifische Konfiguration Versionen easylearn Version Windows Server Version IIS Version PHP Version Datenbank MS-SQL My-SQL ASP Nein Ja Bemerkungen easylearn Installationsverzeichnis Umfrage Intern SDN AG Online Hilfe Intern SDN AG SMTP Server Admin Mail From Mail Bemerkungen

33 Datenbank My-SQL MS-SQL Server / Server Name Web - Server Anderer Server Installationsverzeichnis Datenverzeichnis DB-Name DB-Benutzername DB-Passwort Bemerkungen MS-SQL: Befindet sich der Datenbank Server nicht auf dem Web - Server müssen die MS-SQL Client Tools Installiert werden Option LDAP Server / Server Name Server Typ MS-Active-Directory Andere Base-DN Domain Bind - User Bind User - Passwort From Mail Bemerkungen