= Aktualizacja systemy Debian 7 Wheezy do Debian 8 Jessie =

|| || || Debian 7 (Wheezy) || Debian 8 (Jessie) ||
||Domyślne || PostgreSQL || 9.1 ||. 9.4||
|| || PHP || 5.4 ||. 5.6 ||
||Opcjonalne || PostgreSQL || 9.5 ||. 9.6||
|| || PHP || 5.4 ||. 5.6 ||

WAŻNE! W związku z tym, iż PHP 5.6 jest bardzo restrykcyjny w sprawie weryfikacji jednostki wydającej certyfikat dla serwerów poczty. W przypadku nie zaufanego źródła konieczne jest zmiana połączenia na nie szyfrowane.

Poniższa instrukcja przedstawia sposób aktualizacji systemu operacyjnego Linux. Aktualizacja systemu jest przeprowadzana w celu podniesienia wersji PHP do wersji 5.6, instalacji PostgreSQL oraz aktualizacji Apache do wersji 2.4. Należy pamiętać, ze po instalacji będziemy posiadali w systemie dwa działające silniki PostgreSQL, jeden nasz obecny działający na porcie 5432 oraz nowy na porcie 5433.

Po upgrade systemu należy pamiętać o podmianie !ZendGuardLoadera (wersji system 32-bit lub 64-bit) oraz kodu aplikacji eDokumenty dla PHP 5.6.

'''Przed przystąpieniem do prac BEZWZGLĘDNIE należy pamiętać o wykonaniu KOPI BEZPIECZEŃSTWA,
całego systemu, bazy danych, katalogu /home/edokumenty.'''

'''1.''' Zaczynamy od aktualizacji systemu w ramach gałęzi, której aktualnie się znajduje (tj. Wheezy):
{{{
#apt-get update
#apt-get upgrade
}}}
Jeśli system nie był długo aktualizowany pewnie trzeba będzie uruchomić system ponownie ze względu na nowszą wersję jądra systemu.
{{{
#reboot
}}}
Przed aktualizacją dystrybucji wykonujemy kopię klików konfiguracyjnych
{{{
tar -pczf etc.tar.gz /etc 
}}}

'''2.''' Po aktualizacji systemu edytujemy plik /etc/apt/sources.list, zmieniamy dotychczasowe wpisy dla wheezy na jessie 
{{{
deb http://ftp.de.debian.org/debian/ jessie main contrib non-free
deb-src http://ftp.de.debian.org/debian/ jessie main contrib non-free


deb http://httpredir.debian.org/debian jessie-updates main contrib non-free
deb-src http://httpredir.debian.org/debian jessie-updates main contrib non-free


deb http://security.debian.org/ jessie/updates main contrib non-free
deb-src http://security.debian.org/ jessie/updates main contrib non-free
}}}

Następnym krokiem jest zaktualizowanie pakietów
{{{
apt-get update
}}}
oraz aktualizacja dystrybucji
{{{
apt-get dist-upgrade
}}}

W niektórych przypadkach aktualizacji dystrybucji systemu mogą pojawić się problemy z aktualizacją komponentów PHP. W tym przypadku należy usunąć link symboliczny do php.ini z /etc/php5/cli i przeniesienie php.ini z /etc/php5/apache2/. Po zakończonej aktualizacji i restarcie systemu ponownie tworzymy link symboliczny do php.ini.
Wznowienie aktualizacji wykonujemy poleceniem 
{{{
apt-get -f install
}}}

Po zakończonej aktualizacji wykonujemy restart systemu
{{{
reboot
}}}

Odtworzenie linku symbolicznego do php.ini
{{{
ln -s /etc/php5/apache2/php.ini /etc/php5/cli/
}}}

'''3.''' Po aktualizacji dystrybucji musimy podmienić Zenda dla nowego php 5.6 [http://support.edokumenty.eu/download/deployment/components/ Komponenty ZEND] Ścieżkę dla Zenda znajdziemy w php.ini. A także zaktualizować kod aplikacji eDokumenty

'''4.''' W przypadku problemów z uruchomieniem Apache po aktualizacji systemu należy zweryfikować błędy, które będzie nam zwracał Apache podczas jego uruchomienia. To możemy sprawdzić poleceniem
{{{
systemctl status apache2.service
}}}

W załączniku znajdują się przykładowe pliki konfiguracyjne Apache2.

Po zakończonej aktualizacji systemu należy wprowadzić modyfikację w konfiguracji Apache. W pliku /etc/apache2/sites-enabled/000-default musimy zmodyfikować linię
Wpis z Apache22
{{{
<Directory /home/*/public_html/>
    Options -Indexes FollowSymLinks MultiViews
    AllowOverride Options
    Order allow,deny
    allow from all
    # Odwo³ania do nazwy serwera przekieruj± do edokumentów
</Directory>
}}}
Zmieniamy na
{{{
<Directory /home/*/public_html/>
    Options -Indexes FollowSymLinks MultiViews
    AllowOverride Options
    Require all granted
    # Odwo³ania do nazwy serwera przekieruj± do edokumentów
</Directory>
}}}

Kolejnym krokiem jest modyfikacja ''/etc/apache2/mods-available'' wprowadzamy zmiany w pliku '''userdir.conf'''

Domyślny plik w systemie Linux Debian
{{{
<IfModule mod_userdir.c>
        UserDir public_html
        UserDir disabled root

        <Directory /home/*/public_html>
                AllowOverride FileInfo AuthConfig Limit Indexes
                Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
                <Limit GET POST OPTIONS>
                        Order allow,deny
                        Allow from all
                </Limit>
                <LimitExcept GET POST OPTIONS>
                        Order deny,allow
                        Deny from all
                </LimitExcept>
        </Directory>
</IfModule>
}}}

Plik userdir.conf po modyfikacjach, do pliku dodajemy '''''HEAD REPORT'''''
{{{
<IfModule mod_userdir.c>
        UserDir public_html
        UserDir disabled root

        <Directory /home/*/public_html>
                AllowOverride FileInfo AuthConfig Limit Indexes
                Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
                <Limit GET POST OPTIONS HEAD REPORT>
                        Require all granted
                </Limit>
                <LimitExcept GET POST OPTIONS HEAD REPORT>
                        Require all granted
                </LimitExcept>
        </Directory>
</IfModule>
}}}

Po wprowadzeniu mofygikacji w pliku userdir.conf wykonujemy restart Apache

{{{
/etc/init.d/apache2 restart
}}}

'''5.''' Obecnie mamy zainstalowane dwa silniki PostreSQL jeden działą na poracie 5432 drugi na 5433. W przypadku gdy nowa wersja PostgreSQL nie zostanie należy wykonać polecenie

{{{
apt-get install postgresql-9.6
}}} 

Po zainstalowaniu PostgreSQL a przed odtworzeniem bazy należy pamiętać aby wgrać pliki tssearch_data dla wyszukiwarki.
{{{
wget http://support.edokumenty.eu/download/deployment/components/tsearch_data_polish_20120730.zip
unzip tsearch_data_polish_20120730.zip
cp tsearch_data_polish/* /usr/share/postgresql/9.6/tsearch_data/
}}}
Po tych czynnościach możemy przystąpić do odtworzenia bazy danych


Możemy wykonać zrzut bazy z PostgreSQL na porcie 5432.
{{{
#su - postgres
$psql -U edokumenty -f edokumenty_upgrade.sql edokumenty (polecenie zakłada że eDokumenty działają na bazie edokumenty i właścicielem bazy jest użytkownik edokumenty)
}}}

W nowym klastrze trzeba utworzyć użytkownika oraz bazę: 
{{{
$createuser -p 5433   --no-superuser --no-createdb --no-createrole http
$createuser -p 5433   --no-superuser --no-createdb --no-createrole edokumenty
$createdb -p 5433 -E UTF8 edokumenty -O edokumenty
}}}

Następnie wrzucamy do serwera psql zrzut wykonany chwilę wcześniej: 
{{{
$psql -p 5433 -U edokumenty -f edokumenty_upgrade.sql edokumenty
}}}

Następnym krokiem jest zatrzymanie PostgreSQL

{{{
/etc/init.d/postgresql stop
}}}

W pliku konfiguracyjnym zmieniamy porty dla PostgreSQL aby nowy działał na domyślnym porcie 5432
Starego PostgreSQL zmieniamy na 5433
{{{
vim /etc/postgresql/9.1/main/postgresql.conf 
port=5433
}}}

W konfiguracji nowego PostgreSQL zmieniamy na 5432
{{{
vim /etc/postgresql/9.4/main/postgresql.conf 
port=5432
}}}

W pliku konfiguracyjnym pg_hba.conf dla aktualnej wersji PostgreSQL dodajemy wpisy
{{{
vim /etc/postgresql/9.4/main/pg_hba.conf

local edokumenty all trust
}}}

Następnym krokiem jest uruchomienie PostgreSQL
{{{
/etc/init.d/postgresql start
}}}

'''6.''' Po aktualizacji systemu konieczna będzie także aktualizacja repozytorium plików
{{{
su - www-data
cd /home/edokumenty/repository
}}}
Sprawdzamy status repozytorium
{{{
svn status
}}}
W przypadku otrzymania komunikatu o starej wersji repozytorium, korzystamy z polecenia. W celu zaktualizowania go do najnowszej wersji
{{{
svn upgrade
}}}
W przypadku gdy powyższą czynność wykonamy z konta roota należy naprawić uprawnienia do folderów repos oraz repository.
Naprawa uprawnień została opisana w poniższym artykule [http://support.edokumenty.eu/trac/wiki/AdminGuide/FilePermissions Uprawnienia do plików systemu eDokumenty]