Installation. Version SDN AG, Solution Development Network Januar 2006

Transkript

1 - 1 - Installation easylearn skills4u Version 4.1 SDN AG, Solution Development Network Januar 2006

2 - 2 - Inhaltsverzeichnis INSTALLATION EASYLEARN SKILLS4U... 3 WEB SERVER... 3 PORTAL-SCRIPTS INSTALLIEREN... 3 FLASH-DATEIEN FÜR MULTIMEDIALE BENUTZERFÜHRUNG (AVATAR) INSTALLIEREN... 3 INSTALLATION PHP WINDOWS 2003 SERVER/ IIS 6 FÜR EASYLEARN SKILLS4U KONFIGURIEREN... 5 WINDOWS 2000 MIT IIS 5 FÜR EASYLEARN SKILLS4U KONFIGURIEREN... 9 MYSQL DATENBANK MS SQL DATENBANK EASYLEARN SKILLS4U KONFIGURIEREN ANMELDEN AN EASYLEARN SKILLS4U HINTERGRUNDPROZESS ERSTELLEN PORTALRUN EINRICHTEN PORTALRUN IM TASKSCHEDULER (GEPLANTE TASKS) KONFIGURIEREN ERSTE SCHRITTE SYSTEM-PARAMETER EINSTELLEN/SYSTEMLIZENZ EINGEBEN COMMUNITY OPTIONEN EINSTELLEN KUNDENSPEZIFISCHE KONFIGURATION... 22

3 - 3 - Installation easylearn skills4u Web Server Die Installation setzt einen funktionsfähigen Web Server voraus. Unter Windows NT 4 muss ein aktueller Servicepack und das Option Pack mit dem IIS4 installiert werden. Auf dem Serversystem muss ebenfalls der Internet Explorer 5 oder höher installiert werden, damit der Taskplaner (Scheduled Tasks) installiert wird. Portal-Scripts installieren Die Portalscripts von der CD in \skills4u\eportal.exe in das gewünschte Webverzeichnis auspacken (z.b. c:\inetpub\wwwroot). Flash-Dateien für Multimediale Benutzerführung (Avatar) installieren Die Flashdateien von der CD in \skills4u\avatar.exe in easylearn skills4u-unterverzeichnis elearnwin auspacken (z.b.: c:\inetpub\wwwroot\eportal\elearnwin). Installation PHP 4.4 Die neueste Version 4.4.x von downloaden und installieren. Bei Neuinstallationen zuerst die Installerversion nach c:\php installieren. Danach die volle Version (ZIP-Datei, z.b php win32.zip) downloaden und nach c:\temp extrahieren. Den Inhalt des extrahierten Ordners (z.b. C:\temp\php Win32) markieren und nach c:\php verschieben. PHP.INI In der PHP Konfigurationsdatei c:\windows\php.ini den Eintrag extension_dir= suchen und anpassen. extension_dir = c:/php/extensions Maximale Grösse der Upload-Dateien einstellen upload_max_filesize = 2M Module php_gd2.dll aktivieren. extension=php_gd2.dll Wenn LDAP verwendet wird, muss php_ldap.dll aktiviert werden und die Dateien ssleay32.dll und libeay32.dll aus dem PHP-Ordner dlls nach c:\windows\system32 kopiert werden. extension=php_ldap.dll PHP mit FastCGI Es wird grundsätzlich empfohlen mit FastCGI für Windows zu arbeiten. Bei schnellen Windows-Servern kann es ohne FastCGI für Windows zu Fehlern bei der Seitenverarbeitung kommen.

4 - 4 - Informationen und Tipps zu FastCGI unter Bei der Konfiguration FastCGI muss anstelle von php.exe das DLL isapi_fcgi.dll eingestellt werden. Installation FastCGI Die FastCGI Erweiterung von der easylearn skills4u CD in \Tools\fastcgi.exe in das PHP Verzeichnis C:\PHP auspacken. Die Datei fastcgi.reg ausführen und somit zur Registry Hinzufügen. In der Datei fastcgi.reg enthält die Einstellungen für FastCGI. StartServers IncrementServers MaxServers Timeout AppPath BindPath Anzahl PHP-Prozesse, welche beim Start des Webservers geladen werden. Anzahl Prozesse, welche neu gestartet werden, wenn die bestehenden PHP-Prozesse ausgelastet sind Maximale Anzahl PHP-Prozesse, welche gestartet werden können, z.b.10 Prozesse Definiert die Zeit in Sekunden, wie lange die Extra-Prozesse (Zahl über StartServers) auf Anfragen warten, bevor sie beendet werden. Nicht mehr benötigte Prozesse werden nach dieser Zeit beendet. Pfad und Name zu PHP.EXe (Bsp.: c:\php\php.exe) Muss phpfcgi lauten Falls PHP nicht in C:\PHP installiert ist, muss der Eintrag AppPath angepasst werden. Inhalt von fastcgi.reg [HKEY_LOCAL_MACHINE\SOFTWARE\FASTCGI] "StartServers"=dword: "IncrementServers"=dword: "MaxServers"=dword: a "Timeout"=dword: [HKEY_LOCAL_MACHINE\SOFTWARE\FASTCGI\.php] "AppPath"="c:\\php\\php.exe" "BindPath"="php-fcgi"

5 - 5 - Windows 2003 Server/ IIS 6 für easylearn skills4u konfigurieren Die Webserver wird über den Informationsdienste-Manager verwaltet. In den nachfolgenden Installationsanleitung wird immer davon ausgegangen, dass der IIS Server mit der FastCGI Erweiterung betrieben wird. Start -> Einstellungen -> Systemsteuerung -> Verwaltung -> Internet Informationsdienste-Manager PHP als Webdiensterweiterung konfigurieren Internet Informationsdienste -> Servername -> Webdiensterweiterungen Neue Webdiensterweiterung hinzufügen Erweiterungsname Erforderliche Dateien PHP C:\PHP\ISAPI_FGCI.DLL C:\PHP\PHP.EXE Erweiterungsstatus auf "Zugelassen" setzen Wichtig: Wenn Webquiz installiert wird, muss die Webdiensterweiterung für Active Server Pages aktiviert werden.

6 - 6 - PHP als Prozessor für.php-dateien konfigurieren Internet Informationsdienste -> Servername -> Standardwebsite -> Eigenschaften [Basisverzeichnis] -> Konfiguration -> Hinzufügen -> C:\php\isapi_fcgi.dll Mit Fast-CGI Ausführbare Datei Erweiterung Ohne FastCGI Ausführbare Datei Erweiterung C:\PHP\ISAPI_FGCI.DLL.php C:\PHP\PHP.EXE.php Startdokumente erweitern [Dokumente] -> Standarddokument aktivieren : index.php, index.htm, index.html hinzufügen MIME-Typen erweitern Internet Informationsdienste -> Servername -> WebSites oder ausgewählte Site [HTTP-Header] -> MIME-Typen -> Neu... Erweiterung.crs.cst.des Mime-Typ text/plain text/plain text/plain

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

8 - 8 - 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. C:\PHP Lesen + Ausführen C:\PHP\uploadtemp Vollzugriff C:\PHP\sessiondata Vollzugriff WebSite-Ordner Lesen WebSite-Ordner upload Vollzugriff (oder Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen) WebSite-Ordner download Vollzugriff (oder Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen) Wenn PHP mit FastCGI konfiguriert ist, wird der Prozess von NETZWERKDIENST (NETWORK- SERVICE) ausgeführt (Im TaskManager unter Prozesse PHP.EXE nachsehen!). Ohne FastCGI wird PHP mit dem anonymen Benutzerkennung (IUSER_XXXX) für die entsprechende WebSite aufgerufen. Wenn der anonyme Zugriff ausgeschaltet wurde, muss jeder Benutzer, der auf easylearn skills4u zugreift mit den entsprechenden Rechten ausgestattet werden (evtl. Vollzugriff für Jeder für die Ordner PHP/upload/download und Lesen für Jeder beim WebSite-Ordner einstellen). PHP mit FastCGI NETZWERKDIENST PHP als ISAPI W3wp,NETZWERKDIENST Anonymer Zugriff IUSR_XXXXX Windowsautentifizierung Jeder einzelne Benutzer oder Jeder

9 - 9 - Windows 2000 mit IIS 5 für easylearn skills4u konfigurieren Die Webserver wird über den Informationsdienste-Manager verwaltet. Start -> Einstellungen -> Systemsteuerung -> Verwaltung -> Internet Informationsdienste-Manager PHP als Prozessor für.php-dateien konfigurieren Internet Informationsdienste -> Servername -> (skills4u website) -> Eigenschaften [Basisverzeichnis] -> Konfiguration -> Anwendungszuordnungen -> Hinzufügen -> C:\php\isapi_fcgi.dll Mit FastCGI Ausführbare Datei Erweiterung Ohne FastCGI Ausführbare Datei Erweiterung C:\PHP\ISAPI_FGCI.DLL.php C:\PHP\PHP.EXE.php Startdokumente erweitern [Dokumente] -> Standarddokument aktivieren : index.php, index.htm, index.html hinzufügen

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

11 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. C:\PHP Lesen + Ausführen C:\PHP\uploadtemp Vollzugriff C:\PHP\sessiondata Vollzugriff WebSite-Ordner Lesen WebSite-Ordner upload Vollzugriff (oder Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen) WebSite-Ordner download Vollzugriff (oder Lesen+Schreiben+Löschen+Verzeichnisse erstellen+verzeichnisse löschen) Wenn PHP mit FastCGI konfiguriert ist, wird der Prozess von SYSTEM ausgeführt Ohne FastCGI wird PHP mit dem anonymen Benutzerkennung (IUSER_XXXX) für die entsprechende WebSite aufgerufen. Wenn der anonyme Zugriff ausgeschaltet wurde, muss jeder Benutzer, der auf easylearn skills4u zugreift mit den entsprechenden Rechten ausgestattet werden (evtl. Vollzugriff für Jeder für die Ordner PHP/upload/download und Lesen für Jeder beim WebSite-Ordner einstellen). PHP mit FastCGI SYSTEM PHP als ISAPI IUSR_XXXXX Anonymer Zugriff IUSR_XXXXX Windowsautentifizierung Jeder einzelne Benutzer oder Jeder

12 MySQL Datenbank Die MySQL Datenbanksoftware 3.23.xx/4.0.xx muss installiert sein. Im Installationsverzeichnis install ist die Datei mysql.install.cmd vorhanden, welche eine standardmässige Installation ermöglicht. Folgende Schritte müssen durchgeführt werden. Datenbank erstellen C:\mysql\bin\mysqladmin mysqladmin h localhost u root create eportal Datenbankschema und Initialdaten einlesen. C:\mysql\bin\mysql u root -e "source c:\inetpub\wwwroot\eportal\install\mysql.eportal-4.1.sql" eportal C:\mysql\bin\mysql u root -e "source c:\inetpub\wwwroot\eportal\install\mysql.initialdata.sql" eportal

13 MS SQL Datenbank 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). ACHTUNG: Bei Verwendung von FastCGI und MSSQL Datenbank muss die Option Automatische Konvertierung von ANSI in OEM in der SQL Server Clientkonfiguration abgeschaltet werden. Erweiterung MSSQL in PHP.INI konfigurieren Den Eintrag ;extension=php_mssql.dll suchen und das Semikolon entfernen (aktivieren) extension=php_mssql.dll Autentifizierung MS SQL überprüfen Der MS SQL Server muss für die Autentifizierungsmethoden SQL Server und Windows konfiguriert werden. MS 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.1.sql im Portalverzeichnis ö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 skills4u.

14 easylearn skills4u konfigurieren Die Scriptvorlage 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'; $db_type="mssql"; oder mysql Bei der Datenbank mssql und PHP 4.2.x folgende Optionen einstellen: $db_dbdatestd = false; $db_datefmt = "Y-m-d h:i:sa"; $db_datetimefmt = "Y-m-d h:i:sa"; Evtl. Systemsprache und Datumsformat einstellen. Die Systemsprache (de oder en) wird verwendet, wenn sich der Benutzer noch nicht angemeldet hat. $lang= en ; $db_datefmt = Y/m/d H:i ; $sitename= easylearn skills4u ; // Name des Know-how Portals $logincookievalue=0; $logincookieenabled=true; $defaultbandwidth=3; $sysadminmail= webmaster@mycompany.com ; $sysmailfrom= easylearn@mycompany.com ; Anmelden an easylearn skills4u Bei der Grundinstallation wird der Benutzer admin@easylearn.ch mit dem Passwort easylearn erstellt. Dieser Benutzer hat Systemverwalterrechte und kann sämtliche Einstellungen ändern.

15 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:

16 Hintergrundprozess erstellen easylearn skills4u 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 Mailoption ausgeschaltet Falls die Anmeldung am SMTP-Server zwingend ist, kann hier die UserID und das Passwort eingegenen werden. Wenn der Wert Password gesetzt ist, wird immer versucht sich am SMTP-Server anzumelden. Im Normalfall muss UserID und Password nicht gesetzt werden und kann mit vorangestelltem Strichpunkt auskommentiert werden. [Message] Subject=Betreff Betreffzeile der Mail, Vorgabe: easylearn skills4u Taskscheduler FromName= Name des Absenders, Vorgabe: easylearn skills4u 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.

17 [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 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 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 Portalscript sysmailqueue.php zeigen. Beispiele:

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

19 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.

20 Erste Schritte Nach der Installation von easylearn skills4us 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.

21 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

22 Kundenspezifische Konfiguration Versionen Skills4u Version Windows Server Version IIS Version PHP Version FastCGI Version Datenbank MS-SQL My-SQL ASP Nein Ja Bemerkungen skills4u Installationsverzeichnis Installation Avatar Nein Ja Umfrage Intern SDN AG Online Hilfe Intern SDN AG SMTP Server Admin Mail From Mail Bemerkungen

23 IIS Installation PHP Prozessor php.exe isapi_fcgi.dll ASP aktiviert Nein Ja Bemerkungen PHP Installationsverzeichnis ExtensionDir Extensions aktiviert FastCGI aktiviert Nein Ja Bemerkungen

24 Datenbank MS-SQL Server / Server Name Web - Server Anderer Server Installationsverzeichnis Datenverzeichnis DB-Name DB-Benutzername DB-Passwort Befindet sich der Datenbank Server nicht auf dem Web - Server müssen die MS-SQL Client Tools Installiert werden. My-SQL Server / Server Name Web - Server Anderer Server Installationsverzeichnis Datenverzeichnis DB-Name DB-Benutzername DB-Passwort Win My-SQL Admin Nein Ja My-SQL Administrator Nein Ja My-SQL Query Browser Nein Ja PHP My-SQL Nein Ja Bemerkungen