Howto fuer Apache2 und PHP5.6 - fcs Fair-Computer
Werbung
Installation und Konfiguration vom Heinzelmann mit PHP 5.6 und Apache2 Dieses Dokument beschreibt die Vorgehensweise für die Einrichtung des HEINZELMANN ServiceDesk auf einem x64 System mit Apache2 und PHP 5.6 Allgemeine Informationen Für die Installation werden einige Setup-Dateien und PHP-Module benötigt: Diese Dateien können Sie aus den offiziellen Quellen laden oder von FCS als komplettes Packet: http://iccm.fair-computer.de/heinzelmann/Apache/ApachePack.zip Apache2 Webserver für Windows Wir empfehlen die Verwendung der Binarys für Windows von der ApacheLounge: http://www.apachelounge.com/download/ Für ein x64-System: http://www.apachelounge.com/download/VC11/binaries/httpd-2.4.12-win64-VC11.zip mit dem entsprechendem FastCGI-Modul (mod_fcgid - enthalten in): http://www.apachelounge.com/download/VC11/modules/modules-2.4-win64-VC11.zip Es werden die Visual C++ Redistributables für Visual Studio 2012 benötigt: VC11 vcredist_x64/86.exe PHP 5.6.x VC11 x86 Non Thread Safe Download Link: http://windows.php.net/downloads/releases/php-5.6.8-nts-Win32-VC11-x86.zip ( Quelle: http://windows.php.net/download/ ) Ioncube Loader Der Ioncube Loader ist ein PHP-Modul und wird benötigt, um den verschlüsselten PHP-Code von Heinzelmann zu dekodieren. Sie können den Loader entweder bei Ioncube herunterladen (Link, Windows VC11 (Non-TS) (32 bits) ) oder aus dem Downloadverzeichnis von FCS beziehen. Download Link: https://www.ioncube.com/loaders.php SQLSRV Seit PHP 5.3 wurde das mssql-Modul aus der Standardinstallation von PHP entfernt. Daher muss, wenn Heinzelmann mit einer MS-SQL Datenbank betrieben wird dieses Modul extra hinzugefügt werden. Die Bibliothek ist hier erhältlich, oder bei FCS: http://iccm.fair-computer.de/heinzelmann/PHP5.5/Bibliotheken/php_sqlsrv_56_nts.dll Microsoft SQL Server Native Client (sqlncli.msi) Wenn Web- und Datenbank-Server auf zwei verschiedenen Maschinen sind, müssen Sie auf dem Web-Server den SQL Native Client installieren, um den Zugriff auf den MS SQL Server zu ermöglichen. Den native Client erhalten Sie direkt bei MS für x64 und x86 Plattformen. Quellen für den Client können Sie hier finden: http://www.connectionstrings.com/download-sql-server-native-client/ Download für Windows Server 2012 x64: http://go.microsoft.com/fwlink/?LinkID=239648&clcid=0x407 Oder bei FCS: http://iccm.fair-computer.de/heinzelmann/PHP5.5/sqlncli_WindowsServer2012_X64.msi Heinzelmann in der aktuellen Version: Die aktuelle Heinzelmann-Version für PHP 5.6 finden Sie auf dem FCS-Server: http://iccm.fair-computer.de/heinzelmann/ -> Heinzelmann-4.x.zip Einrichtung des Servers Verwendung des FCS-Heinzelmann-ApachePacks Folgende Schritte sind im Download des FCS-Heinzelmann-ApachePacks schon weitgehend ausgeführt, Sie brauchen dort nur die Verzeichnisse Apache24 und PHP aus dem Packet auf Laufwerk C kopieren, sowie das Verzeichnis PHPTemp anlegen. Wenn Die Pfade nicht C:\Apache24, C:\PHP und C:\PHPTemp lauten sollen, ändern Sie die entsprechenden Stellen in der httpd.conf und php.ini Datei wie unten beschrieben. Verwendung der Module aus originalen Quellen Wenn Sie die Einstellungen selbstständig vornehmen wollen oder und die Dateien aus oben genannten originalquellen heruntergeladen haben, führen Sie folgende Konfigurationen durch: Zur Installation des Apache2 Webservers entpacken Sie die Datei „httpd-2.4.x-win64-VC11“ in das Verzeichnis „C:\Apache24\“. Sie können auch ein anderes Verzeichnis wählen und dann die httpd.conf des Webservers entsprechend anpassen. Anschließend kopieren Sie das FastCGI-Modul in das Module-Verzeichnis des Webservers: Die Datei „mod_fcgid.so“ in das Verzeichnis „C:\Apache24\modules“ kopieren. In der Apache-Konfiguration wird das Modul aktiviert (siehe Readme-Datei von mod_fcgid). Dafür müssen folgende Zeilen in die Datei httpd.conf eingetragen werden: LoadModule fcgid_module modules/mod_fcgid.so FcgidIOTimeout 64 FcgidConnectTimeout 16 FcgidMaxRequestsPerProcess 1000 FcgidMaxProcesses 50 FcgidMaxRequestLen 8131072 FcgidInitialEnv PHPRC "C:/HeinzelApache/PHP/" FcgidInitialEnv PHP_FCGI_MAX_REQUESTS 1000 <Files ~ "\.php$>" AddHandler fcgid-script .php FcgidWrapper "C://PHP/php-cgi.exe" .php </Files> Installation PHP Laden Sie die aktuelle PHP 5.6 Version herunter und entpacken die Datei an die gewünschte Stelle, wir empfehlen c:\PHP. Anschließend benennen Sie die php.ini-production in php.ini um und nehmen folgende Anpassungen vor: Aktivieren Sie die Module GD2, LDAP, Multi-Byte String indem Sie die Kommentarzeichen am Beginn der Zeile entfernen: extension=php_gd2.dll extension=php_ldap.dll extension=php_mbstring.dll Weitere Anpassungen in der php.ini Zunächst legen Sie ein Verzeichnis für die von PHP angelegten Dateien an, z.B. „C:\PHPTemp“ und geben dem „Authentifizierte Benutzer“ Schreibrechte auf dieses Verzeichnis. In der php.ini („C:\PHP\php.ini“) suchen und ändern sie folgende Einstellungen und achten Sie darauf, dass die Zeile nicht auskommentiert ( ; ) ist: date.timezone = "Europe/Berlin" output_buffering = Off magic_quotes_gpc = Off default_socket_timeout = 60 upload_tmp_dir = "C:\PHPTemp" session.save_path = "C:\PHPTemp" error_reporting = E_ALL & ~E_WARNING & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED display_errors = Off log_errors = On error_log = "C:\PHPTemp\php-errors.log" [SQLSRV] extension=php_sqlsrv_56_nts.dll Ioncube-Loader Damit der Heinzelmann ausgeführt werden kann, muss der Ioncube-Loader zur Entschlüsselung des Heinzelmann-Codes für PHP eingerichtet werden. Kopieren Sie dazu die Datei „ioncube_loader_win_5.6.dll“ in das PHP Extension Verzeichnis („C:\PHP\ext“). Richten Sie das Modul mit folgenden Werten in der php.ini ein. WICHTIG: Die IoncubeBibliothek muss vor allen anderen zend_extensions geladen werden: [ioncube Loader] zend_extension="C:\ PHP\ext\ ioncube_loader_win_5.6.dll" Anschließend starten Sie Apache2 Dienst neu. Bitte beachten Sie auch, dass Sie nach jeder Änderung der php.ini -Datei den Apache2-Dienst neu starten müssen. Weitere Massnahmen Wenn Sie jetzt PHP in der Konsole ausführen (> c:\PHP\php.exe -v) gibt es evtl. die Meldung, dass die „MSVCR100.DLL“ Datei fehlt. Das ist das „Microsoft Visual C++ 2010 SP1 Redistributable Package“, dieses erhalten Sie im FCS-Heinzelmann-ApachePack im Verzeichnis Installation: vcredist_x64.exe Oder für x64-Bit System hier: http://www.microsoft.com/en-us/download/details.aspx?id=13523 Installation von SQL Server Native Client Führen Sie die „sqlncli_WindowsServer2012_X64.msi“ (oder eine entsprechende sqlncli-Version) aus und folgen Sie den Anweisungen. Achtung! Wenn die MS-SQL Datenbank auf einem anderen Rechner liegt, müssen Sie für die Verbindung zu dieser Datenbank folgende Änderung an der Registry vornehmen: Erstellen Sie einen neuen Schlüssel „ConnectTo“ unter „HKLM\SOFTWARE\Wow6432Node\Microsoft\MSSQLSERVER\Client“ ( Auf x86 Bit Systemen den Schlüssel unter folgendem Pfad erstellen: „HKLM\SOFTWARE\Microsoft\MSSQLSERVER\Client“ ) Und darin eine neue Zeichenfolge: „DSQUERY“ = „DBNETLIB“ Heinzelmann Einrichtung Entpacken Sie das ZIP-Archiv vom Heinzelmann in das Verzeichnis „C:\Apache24\htdocs\Heinzelmann“. Kopieren Sie jetzt die Datei „licence.php“, die Sie von unserem Vertrieb erhalten haben ins Verzeichnis „C:\Apache24\htdocs\Heinzelmann“ Passen Sie jetzt die Dateisystemberechtigungen (NTFS) so um, dass die Gruppe „Authentifizierte Benutzer“ das „Lesen/Ausführen“-Recht auf das komplette „C:\Apache24\htdocs\Heinzelmann“-Verzeichnis bekommt. Zusätzlich setzen Sie noch das „Ändern/Schreiben“-Recht auf Unterverzeichnisse „/log“, „/upload“, „/styles“ und „/tpl“ sowie auf die Datei „configuration.php“: Somit ist die Einrichtung vom Heinzelmann abgeschlossen. Wenn Sie jetzt in Ihrem Browser die Adresse des Heinzelmann-Servers angeben, werden Sie auf die Installationsseite des Heinzelmanns umgeleitet. Prüfen Sie bitte, ob alle von uns empfohlenen Einstellungen auf grün stehen und passen Sie ggf. diese direkt an. Nachdem Sie die Web-Installation abgeschlossen haben, vergessen Sie bitte nicht, das „/installation“ - Unterverzeichnis umzubenennen. Auf einem Produktivsystem empfehlen wir immer, dieses Verzeichnis nach Abschluss der Installation komplett zu löschen! Die Heinzelmann Installation ist jetzt abgeschlossen. Sollten Probleme bei der Installation auftreten, finden Sie auf folgenden Seiten evtl. hilfreiche Tipps: Installation von Apache auf Windowsservern: http://www.apachelounge.com/ Dort gibt es auch ApacheModule und Serverupdates ( http://www.apachelounge.com/download/ ) MSVCR110.dll is missing: Visual C++ Redistributable for Visual Studio 2012: VC11 vcredist_x64/86.exe MSVCR100.DLL is missing: Microsoft Visual C++ 2010 SP1 Redistributable Package http://www.microsoft.com/en-us/download/details.aspx?id=13523 Sie können sich bei Problemen und Fragen auch gerne an den Heinzelmann Support von FCS wenden.
