Установка Liferay на Debian 9

О чём эта инструкция

Liferay — это свободная система управления контентом и портал на Java. Она хранит данные в СУБД (например, MariaDB/MySQL) и разворачивается как веб-приложение на Apache Tomcat. Liferay состоит из тем, страниц и навигации; для базовой установки программирование не требуется. В этой инструкции показан пошаговый процесс установки Liferay Community Edition на сервер с Debian 9, включая подготовку Java, MariaDB, конфигурацию и запуск.

Требования

Сервер с Debian 9 (stretch).
Ненулевой пользователь с sudo-привилегиями.
Доступ в интернет для загрузки пакетов и архива Liferay.

Обновите систему

Перед началом обновите пакеты и зависимые компоненты:

sudo apt-get update -y  
sudo apt-get upgrade -y

После применения обновлений рекомендуется перезагрузить сервер.

Важно: всегда делайте резервную копию конфигураций и данных перед обновлением в продакшн-среде.

Установка Java 8

Liferay требует Java 8 (OpenJDK или Oracle JDK). На Debian 9 обычно доступен OpenJDK 8, и это самый простой вариант для установки.

Вариант A — установить OpenJDK 8 из репозиториев Debian:

sudo apt-get install openjdk-8-jdk -y

Проверьте версию Java:

java -version

Вы увидите что-то вроде:

java version "1.8.0_xxx"
Java(TM) SE Runtime Environment (build 1.8.0_xxx)
Java HotSpot(TM) 64-Bit Server VM (build xxx, mixed mode)

Вариант B — установить Oracle Java 8 через внешние репозитории. В исходном руководстве показан PPA webupd8team, который предназначен для Ubuntu и может не работать корректно на Debian. Если вы уверены в совместимости или используете адаптированный репозиторий, можно выполнить следующие команды (на Ubuntu):

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update -y
sudo apt-get install oracle-java8-installer -y

Совет: для серверов часто достаточно OpenJDK. Использование Oracle JDK может потребовать дополнительной лицензии и отдельного источника пакетов.

Установка MariaDB

Добавим репозиторий MariaDB и установим сервер. В исходном примере используется репозиторий и ключи:

sudo apt-get install software-properties-common -y  
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8  
sudo add-apt-repository 'deb [arch=amd64] http://www.ftp.saix.net/DB/mariadb/repo/10.1/debian stretch main'

Обновим список пакетов и установим MariaDB:

sudo apt-get update -y
sudo apt-get install mariadb-server -y

Далее запустите встроенный скрипт безопасности:

sudo mysql_secure_installation

Ответы, рекомендуемые в примере:

Enter current password for root (enter for none): Enter
Set root password? [Y/n]: Y
New password: 
Re-enter new password: 
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y

Этот скрипт установит пароль для root, удалит анонимных пользователей и тестовую базу, запретит удалённый вход для root и перезагрузит таблицы привилегий.

Теперь запустите и включите сервис MariaDB при старте системы:

sudo systemctl start mysql  
sudo systemctl enable mysql

Создание базы и пользователя для Liferay

Войдите в консоль MariaDB:

mysql -u root -p

Затем создайте базу и пользователя (замените пароль на сильный):

MariaDB [(none)]>CREATE DATABASE lportal;
MariaDB [(none)]>CREATE USER 'lportal'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]>GRANT ALL PRIVILEGES ON lportal.* TO 'lportal'@'localhost';
MariaDB [(none)]>flush privileges;
MariaDB [(none)]>exit;

Совет: используйте надёжный пароль и при необходимости ограничьте доступ по IP. Для продакшна рассмотрите отдельный пользователь с минимально необходимыми правами.

Загрузка и установка Liferay

Скачайте сборку Liferay, поставляемую вместе с Apache Tomcat. В примере используется конкретная версия 7.0.4 GA5:

wget https://excellmedia.dl.sourceforge.net/project/lportal/Liferay%20Portal/7.0.4%20GA5/liferay-ce-portal-tomcat-7.0-ga5-20171018150113838.zip

Распакуйте архив:

unzip liferay-ce-portal-tomcat-7.0-ga5-20171018150113838.zip

Скопируйте извлечённый каталог в /var:

sudo cp -r liferay-ce-portal-7.0-ga5 /var/liferay

Создайте файл portal-ext.properties и укажите параметры подключения к базе. Откройте редактор:

sudo nano /var/liferay/tomcat-8.0.32/webapps/ROOT/WEB-INF/classes/portal-ext.properties

Добавьте следующие строки (сохраните пароль, логин и URL базы):

jdbc.default.url=jdbc\:mysql\://localhost/lportal?useUnicode\=true&characterEncoding\=UTF-8&useFastDateParsing\=false
jdbc.default.driverClassName=com.mysql.jdbc.Driver
jdbc.default.username=lportal
jdbc.default.password=password

Сохраните и закройте файл.

Запуск Liferay

Запустите Tomcat/Liferay:

sudo bash /var/liferay/tomcat-8.0.32/bin/startup.sh

Подождите до полного старта приложения. Просматривайте логи в реальном времени:

tail -f /var/liferay/tomcat-8.0.32/logs/catalina.out

Откройте в браузере адрес:

http://your-server-ip:8080

Вы будете перенаправлены в веб-портал Liferay и сможете пройти первичную настройку.

Поздравляем — Liferay установлен и запущен.

Частые проблемы и варианты устранения

Порт 8080 уже занят: проверьте процессы командой sudo lsof -i:8080 или netstat -tuln. Остановите сервис или измените порт в конфигурации Tomcat.
Неправильная версия Java: убедитесь, что java -version показывает Java 8. Liferay 7.x требует Java 8. Если стоит Java 11+, возможны ошибки.
Ошибка соединения с базой: проверьте правильность jdbc URL, пользователя и пароля. Попробуйте подключиться клиентом mysql -u lportal -p lportal.
Права доступа к файлам: проверьте владельца и права в /var/liferay. Tomcat должен иметь доступ на чтение/запись туда, где нужны временные и конфиг-файлы.
Долгий старт: при первом запуске Liferay выполняет миграции и создаёт индексы — это занимает время. Мониторьте catalina.out на предмет прогресса.

Альтернативные подходы

Использовать Docker-контейнеры: готовые образы Liferay + MariaDB позволяют быстрее развернуть среду и изолировать зависимости.
Применять управляемые облачные сервисы или PaaS: убирает часть задач по поддержке инфраструктуры.
Использовать более свежие версии Liferay или коммерческую версию Liferay DXP для поддержки и SLA.

Контрольный список по ролям

Системный администратор:

Обновил систему и установил Java 8.
Установил и обезопасил MariaDB.
Настроил права на /var/liferay и запустил Tomcat.

Администратор портала:

Подключился к Liferay через браузер.
Проверил создание сайта и возможность добавлять страницы.

Разработчик:

Убедился, что плагины и расширения загружаются.
Проверил доступ к API и журналам ошибок.

Критерии приёмки

Портал доступен по адресу http://your-server-ip:8080.
Пользователь с правами администратора может войти в систему.
Liferay успешно подключился к базе данных lportal без ошибок в логах.
Сервис Tomcat запущен и настроен на автозапуск при старте ОС.

Короткая методология установки

Подготовьте сервер и выполните обновление. 2. Установите Java 8. 3. Установите и обезопасьте MariaDB. 4. Создайте базу и пользователя. 5. Скачайте и распакуйте Liferay с Tomcat. 6. Пропишите portal-ext.properties и запустите приложение. 7. Проверяйте и фиксируйте ошибки в логах.

Короткие советы по отладке

Просматривайте catalina.out для ошибок и предупреждений.
Используйте mysql клиент для проверки доступа к базе.
Проверяйте права на файлы и правильность путей в portal-ext.properties.

Итог

Следуя этим шагам, вы установите Liferay Portal на сервер Debian 9. Для продакшна дополнительно настройте резервное копирование базы и файлов Liferay, настройку TLS и регулярные обновления. Если вы планируете масштабирование или высокую доступность, рассмотрите распределённую архитектуру с отдельной базой данных, кешем и балансировщиком нагрузки.

Спасибо за внимание. Удачной установки и настройки!