= [wiki:AdminGuide Przewodnik administratora] > Instalacja systemu na serwerze Windows (Apache + PHP + FastCGI) = #top

=== Menu ===
 1. [#intro Wstęp]
 2. [#zend Instalacja]

== Wstęp == #intro
W niniejszym artykule przedstawiono sposób instalacji i konfiguracji systemu eDokumenty na serwerach Windows wykorzystując do tego Apache + PHP w trybie FastCGI.

Sugeruje się aby przed przystąpieniem do instalacji serwera Apache dokonać instalacji serwera baz danych: PostgreSQL, który to proces opisany jest na stronie:
[wiki:AdminGuide/Procedures/WindowsPostgreSQL http://support.edokumenty.eu/trac/wiki/AdminGuide/Procedures/WindowsPostgreSQL]

[#top Powrót do menu]
== Instalacja == #zend
Cały proces składać się będzie z kilku etapów:
 0. [#intro Konfiguracja podstawowa]
 1. [#svn Instalacja serwera kontroli wersji (Subversion)]
 2. [#install Pobierania i instalacji Apache+PHP]
 3. [#config Konfiguracja serwera]
 4. [#ext Konfiguracja rozszerzeń PHP]
 5. [#edokumenty Instalacja i konfiguracja systemu eDokumenty]

=== 0. Konfiguracja podstawowa === #intro

Dokumentacja oraz załączona paczka [http://support.edokumenty.eu/download/installation/windows/new_apache_php_fcgi.7z new_apache_php_fcgi.7z] zakłada instalację systemu eDokumenty w lokalizacji "D:\edokumenty\"
Strukturę katalogów nalezy utworzyć w ścieżce: {{{d:\edokumenty}}}
W tej lokalizacji należy utworzyć strukturę katalogów (lub przenieść z innego serwera):
 * files -  katalog dla plików niewersjonowanych
 * maildir - katalog dla poczty email
 * ''public_frp'' (opcjonalny) - publiczne repozytorium plików dostępne w Eksploratorze plików dostępnym w systemie eDokumenty 
 * public_html - tu znajdują się pliki programu
 * repos - katalog bazy danych systemu kontroli wersji (Subversion)
 * repository - katalog, który przechowuje pliki wersjonowane
 * ''users'' (opcjonalny) - prywatne (użytkownika) repozytorium plików dostępne w Eksploratorze plików dostępnym w systemie eDokumenty 

=== 1. Instalacja i konfiguracja serwera kontroli wersji (Subversion) ===
Przed instalacja Zend Server-a należy zainstalować w systemie serwer systemu kontroli wersji.
W tym celu ze strony należy pobrać dwa narzędzia:
 * [http://sourceforge.net/projects/win32svn/files/latest/download Subversion (Windows)]
 * [http://tortoisesvn.net/downloads.html TortoiseSVN] - interfejs graficzny do systemu zarządzania wersją (przydatny do konfiguracji).

W pierwszej kolejności należy zainstalować Subversion, a dopiero potem TortoiseSVN.
Po zainstalowaniu serwera i narzędzia należy utworzyć repozytorium. W tym celu należy na katalogu repos kliknąć prawym przyciskeim myszy i kliknąć opcję ''TortoiseSVN > Create repository here''.

Następnie należy prawym klawiszem myszy na katalogu repository kliknąć opcję SVN Checkout. W oknie, które się otworzy należy wybrać ścieżkę do katalogu repos. Uwaga, należy zwrócić uwagę, aby druga ścieżka wskazywała na katalog repository.

Ostatnim krokiem jest konfiguracja ścieżek w pliku config.inc (po skońćzonej instalacji systemu eDokumenty):
{{{
#!php

// Ścieżka do repozytorium plików, na Linux względna, na Windows bezwzględna
define('REPOSITORY_PATH', 'D:/www/eDokumenty/repository/');
define('NOT_VERSIONED_REPOSITORY_PATH', 'D:/www/eDokumenty/files/');
}}}


=== 2. Pobieranie i instalacja Apache + PHP === #install
 1. Pobrać i rozpakować paczkę [http://support.edokumenty.eu/download/installation/windows/new_apache_php_fcgi.7z new_apache_php_fcgi.7z]


=== 3. Konfiguracja Apache, PHP === #config
Edycja konfiguracji Apache oraz PHP rozpocząć należy od modyfikacji plików konfiguracyjnych. 
 1. Pierwszym z nich jest '''php.ini''' w lokalizacji (domyślnie): {{{ "C:\php\php.ini" }}}
W podstawowej konfiguracji oraz instalacji w katalogu "c:\php" nie ma potrzeby ingerencji w plik php.ini.


 2. Modyfikacja pliku '''httpd.conf''' {{{ c:\Apache24\conf\httpd.conf }}}

W podstawowej konfiguracji oraz instalacji Apache w katalogu "c:\Apache24" oraz PHP w "c:\php" należy tylko zmienić ścieżki dotyczące lokalizacji systemu eDokumenty.

 3. Plik '''httpd-vhosts.conf''' {{{ c:\Apache24\conf\extra\httpd-vhosts.conf }}}

W podstawowej konfiguracji oraz instalacji Apache w katalogu "c:\Apache24" oraz PHP w "c:\php" należy tylko zmienić ścieżki dotyczące lokalizacji systemu eDokumenty.


[#top Powrót do menu]

=== 4. Konfiguracja rozszerzeń PHP === #ext

W tej części opisano sposób instalacji rozszerzeń na przykładzie sterowników PHP do serwera baz danych Microsoft SQL Server.
Pierwszym krokiem jest pobranie sterowników ze strony producenta [http://www.microsoft.com/en-us/download/details.aspx?id=20098 Microsoft Drivers 3.0 for PHP for SQL Server] (instalator zamieszczono również w załącznikach). Podczas instalacji instalator zapyta się, gdzie rozpakować pliki. Należy wskazać domyślny katalog rozszerzeń PHP:
czyli: {{{ c:\php\ext }}}.
Następnym punktem procesu jest dodanie odpowiedniego wpisu do pliku '''php.ini''':
{{{
#!ini
extension=php_mssql.dll
}}}
Po zrestartowaniu Apache'a podstawowy sterownik PHP do MS SQL Server będzie dostępny.

[#top Powrót do menu]
=== 5. Instalacja i konfiguracja systemu eDokumenty === #edokumenty

Ostatnim krokiem instalacji jest wykonanie [DeployerGuide/Others/WebInstallation instalacji przez przeglądarkę].


=== Pojawiające się problemy: ===
- Podczas wysyłania e-maili z załącznikami, Fast-CGI przestaje reagować.

W pliku konfiguracyjnym '''httpd-fastcgi.conf''' (domyślnie: C:\Apache24\conf\extra\) w pozycji '''FcgitIOTimeout''' zmieniamy wartość na 6000.

[#top Powrót do menu]