= Aktualizacja systemy Debian 8 Jessie do Debian 9 Stretch =
|| || || Debian 8 (Jessie) || Debian 9 (Stretch) ||
||Domyślne || PostgreSQL || 9.6 || 10 ||
|| || PHP || 5.6 || 7.0 ||
||Opcjonalne || PostgreSQL || 10 || 11 ||
|| || PHP || 5.6 || downgrade 5.6/ upgrade 7.2 ||
''Support dla Debian oraz PHP''[[BR]]
Support dla Debian 8
[https://wiki.debian.org/LTS/ https://wiki.debian.org/LTS/][[BR]]
Support dla PHP
[http://php.net/supported-versions.php http://php.net/supported-versions.php][[BR]]
[[BR]]
Poniższa instrukcja przedstawia sposób aktualizacji systemu operacyjnego Linux. Aktualizacja systemu jest przeprowadzana w celu podniesienia wersji PHP do wersji 7.2, jest także możliwość pozostania przy wersji PHP 5.6 (PHP 5.6 przestaje być wspierany w grudniu 2018r).
Jeśli aktualizujemy system z wersji 7 Debian zalecamy zapoznanie się z instrukcją [http://support.edokumenty.eu/trac/wiki/AdminGuide/UpgradeDebian7to8 Aktualizacja systemy Debian 7 Wheezy do Debian 8 Jessie], która zawiera wszelkie uwagi dotyczące zmian w Apache gdzie aktualizowany jest z wersji 2.2 do 2.4.
'''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. Aktualizacja systemy w gałęzi Jessie, Debian 8'''
Zaczynamy od aktualizacji systemu w ramach gałęzi, której aktualnie się znajduje (tj. Jessie, Debian 8):
{{{
#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. Aktualizacja dystrybucji z Jessie na Stretch, Debian 8 na Debian 9'''
Po aktualizacji systemu edytujemy plik /etc/apt/sources.list, zmieniamy dotychczasowe wpisy dla Jessie na Stretch
{{{
deb http://httpredir.debian.org/debian stretch main
deb http://httpredir.debian.org/debian stretch-updates main
deb http://security.debian.org stretch/updates main
}}}
Możemy również skorzystać z polecenia, który wykona zmiany
{{{
sed -i 's/jessie/stretch/g' /etc/apt/sources.list
}}}
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
}}}
'''3. Downgrade do PHP 5.6 lub aktualizacja do PHP 7.2'''
Ten punkt zostanie podzielony na dwa oddzielne w zależności od tego jaką ścieżkę wybierzemy przechodzimy do podpunktu a) Downgrade do PHP 5.6 lub podpunktu b) Aktualizacja do PHP 7.2
'''3a. Downgrade do PHP 5.6'''
Po aktualizacji systemu do Linux Debian 9, Stretch, na naszym serwerze dostępna będzie wersja PHP 7.0:
{{{
php -v
}}}
Aktualizacja nie odinstaluje poprzedniej wersji czyli PHP 5.6 z której będziemy mogli nadal korzystać wystarczy tylko wykonać poniższe polecenie które odinstaluje PHP 7.0:
{{{
sudo apt-get remove php7.0*
}}}
Po tej czynności nadal będziemy mogli korzystać z eDokumentów działających na PHP w wersji 5.6
Odtworzenie linku symbolicznego do php.ini
{{{
ln -s /etc/php5/apache2/php.ini /etc/php5/cli/
}}}
Przy pozostaniu na wersji php 5.6 - eDokumenty będą działać tak jak do tej pory.
'''3b. Aktualizacja do PHP 7.2'''
W tym podpunkcie zajmiemy się aktualizacją PHP do wersji 7.2 a także zmianą ZendLoadera na IONCubeLoadera.
Przed instalacją nowych pakietów musimy posprzątać nie potrzebne elementy w tym PHP oraz ZendLoadrera. Jeśli korzystaliśmy z PHP 5.6 wykonujemy poniższe polecenie:
{{{
apt-get purge php5 php5-common php5-dev php5-imap php5-ldap php5-odbc php5-readline php5-sybase php5-cli php5-curl php5-gd php5-json php5-memcached php5-pgsql php5-sqlite php5-xsl
}}}
Jeśli świeżo aktualizowaliśmy do Debian 9 Stretch możemy również usunąć pakiety PHP 7.0 poniższym poleceniem.
{{{
sudo apt-get remove php7.0*
}}}
Usuńmy również ręczenie pliki ZendLoadera nie będą nam już potrzebne. Pliki powinny znajdować się w lokalizacji:
{{{
/usr/lib/php/ZendGuardLoader.so
/usr/lib/php/opcache.so
}}}
Przystępujemy do instalacja PHP 7.2 w środowisku Debian 9. Dodajemy repozytoria dla PHP 7.2
{{{
sudo apt install ca-certificates apt-transport-https
wget -q https://packages.sury.org/php/apt.gpg -O- | sudo apt-key add -
echo "deb https://packages.sury.org/php/ stretch main" | sudo tee /etc/apt/sources.list.d/php.list
}}}
{{{
apt-get update
}}}
Przystępujemy do instalacji pakietów PHP 7.2:
{{{
apt install php7.2-fpm php7.2-cli php7.2-common php7.2-curl php7.2-mbstring php7.2-mysql php7.2-xml php7.2-gd php7.2-pgsql php7.2-bcmath php7.2-sqlite3 php7.2-imap php7.2-xsl php7.2-ldap php7.2-odbc php7.2-json php7.2-sybase php7.2-readline php7.2-soap
}}}
{{{
apt-get install php7.2-zip
}}}
Modułu do Apache2 dla FCGI
{{{
apt install apache2 libapache2-mod-fcgid
}}}
Dla FCGI instalujemy REDIS zamiast memcached
{{{
apt-get install redis-server
apt-get install php7.2-redis
}}}
Konfiguracja dla Redis, którą wprowadzamy w pliku '''/etc/redis/redis.cont'''
{{{
save 1200 1
save 600 10
save 120 10000
}}}
Włączamy obsługę modułu FCGI w Apache
{{{
sudo a2enmod actions fcgid alias proxy_fcgi
}}}
Dodajemy IonCubeLoadera, plik znajduje się w paczce konfiguracyjnej [http://support.edokumenty.eu/download/installation/linux-os/php72_fcgi_apache_conf.zip tutaj]. Po umieszczeniu go na serwerze np
{{{
/usr/lib/php/
}}}
Dodajemy w pierwszej linii pliku php.ini w lokalizacjach
{{{
/etc/php/7.2/fmp/php.ini
/etc/php/7.2/cli/php.ini
}}}
następujący wpis:
{{{
zend_extension=/usr/lib/php/ioncube_loader_lin_7.2.so
}}}
W plikach php.ini dodajemy również
{{{
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379"
}}}
oraz modyfikujemy wartości dla:
{{{
memory_limit = 512M
upload_max_filesize = 32M
post_max_size = 64M
expose_php = Off
}}}
Kolejnym krokiem jest modyfikacja pliku www.conf
{{{
vim /etc/php/7.2/fpm/pool.d/www.conf
}}}
modyfikujemy wpis
{{{
security.limit_extensions = .php engine
pm.max_children = 8
}}}
Ostatnim elementem jest zmiana handlera w Apache w pliku default.conf oraz default-ssl.conf, obecny wpis:
{{{
SetHandler application/x-httpd-php
}}}
modyfikujemy następująco
{{{
SetHandler "proxy:unix:/var/run/php/php7.2-fpm.sock|fcgi://localhost/"
}}}
W plikach konfiguracyjnych default.conf oraz default-ssl.conf Apache dodajemy również, na potrzeby autoryzacji WebDAV oraz CalDAV:
{{{
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
}}}
Z poziomu konsoli wykonujemy polecenie:
{{{
a2enmod headers
}}}
W plikach konfiguracyjnych '''conf-enabled/security.conf''' w Apache wprowadzamy następujące zmiany:
{{{
ServerSignature Off
Header set X-Content-Type-Options: "nosniff"
Header set X-Frame-Options: "sameorigin"
}}}
Uruchomienie moduł tłumaczącego dla Ready_™.
Dodajemy moduł do php 7.2 - bsedt.so w lokalizacji
{{{
/usr/lib/php/20170718
}}}
Następnie tworzymy pliki bsedt.ini w folderach php:
{{{
/etc/php/7.2/mods-available/bsedt.ini
}}}
Zawartość pliki bsedt.ini
{{{
extension=bsedt.so
}}}
Tworzymy symlinki do pliku bsedt.ini
{{{
ln -s /etc/php/7.2/mods-available/bsedt.ini /etc/php/7.2/cli/conf.d/bsedt.ini
ln -s /etc/php/7.2/mods-available/bsedt.ini /etc/php/7.2/cli/conf.d/bsedt.ini
}}}
W pliku '''php.ini''' dla '''/etc/php/7.2/cli/''' oraz '''/etc/php/7.2/cli/''' dodajemy wpis:
{{{
[bsedt]
bsedt.lang_path="/home/edokumenty/public_html/apps/edokumenty/share/lang"
bsedt.lang=en_UK
}}}
Po zakończeniu konfiguracji restartujemy usługi Apache oraz FPM
{{{
service php7.2-fpm restart
/etc/init.d/apache2 restart
}}}
Gotowe pliki konfiguracyjne można pobrać z [http://support.edokumenty.eu/download/installation/linux-os/php72_fcgi_apache_conf.zip poniższej lokalizacji]. Po wgraniu plików wystarczy tylko restart usług Apache oraz PHP-FPM
Po zmianie PHP na 7.2 konieczna jest aktualizacja kodu system Ready_™ do kompilacji dla php 7.2. Aktualizacja kodu na nowszą wersję może wymagać wykonania patchy. Aktualizację wykonujemy w taki sam sposób jak dla systemu eDokumenty. Pomocny może być w tym przypadku ten [http://support.edokumenty.eu/trac/wiki/DeployerGuide/Upgrade link.]
'''4. Aktualizacja PostgreSQLa do wersji 10/11'''
Przystępujemy do aktualizacji PostgreSQLa do wersji 10/11. Po zainstalowaniu PostgreSQLa będą dostępne dwa klastry dla wersji 9.6 oraz wersji 10/11, odpowiednio na portach 5432 i 5433. Instalację przeprowadzamy za pomocą polecenia
Aktualizujemy dotyczący pakietów dla nowej wersji Debiana obecnie jest to stretch
{{{
deb http://apt.postgresql.org/pub/repos/apt/ stretch-pgdg main
apt-get update
}}}
{{{
apt-get install postgresql-10
}}}
lub
{{{
apt-get install postgresql-11
}}}
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/[WERSJA_POSTGRESQL]/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
$pg_dump -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.6/main/postgresql.conf
port=5433
}}}
W konfiguracji nowego PostgreSQL zmieniamy na 5432
{{{
vim /etc/postgresql/10/main/postgresql.conf
port=5432
}}}
W pliku konfiguracyjnym pg_hba.conf dla aktualnej wersji PostgreSQL dodajemy wpisy,
{{{
vim /etc/postgresql/10/main/pg_hba.conf
local edokumenty edokumenty md5
local edokumenty http md5
}}}
Następnym krokiem jest uruchomienie PostgreSQL
{{{
/etc/init.d/postgresql start
}}}
Możemy również wykonać aktualizację clustra za pomocą poleceń opisanych w artykule [http://support.edokumenty.eu/trac/wiki/AdminGuide/PgUpgrade Upgrade PostgreSQL]
W przypadku aktualizacji z Linux Debian 8 większość elementów została już wykonana przy okazji aktualizacji do tej wersji systemu.
W Debian 8 powinniśmy już posiadać zaktualizowany repozytoria SVN opisane w poniższym artykule [http://support.edokumenty.eu/trac/wiki/AdminGuide/UpgradeDebian7to8 Aktualizacja systemy Debian 7 Wheezy do Debian 8 Jessie], a także podmieniony Zend Loader dla PHP 5.6, poprawnie prawnie skonfigurowanego Apache a także PostgreSQLa w wersji 9.6