Установка Plone CMS на Debian

Предварительное примечание

Это руководство предполагает, что у вас уже настроена базовая система Debian Sarge (3.1). Первые шаги по базовой настройке описаны в отдельном материале «The Perfect Setup - Debian Sarge (3.1)». Цель здесь — показать последовательную установку Plone с использованием Python и Zope на Debian.

Определение: Plone — это CMS на базе Zope/ Python, ориентированная на расширяемость и безопасность.

Важно: часть команд выполняется от root, часть — от обычного пользователя. Это критично для корректных прав файлов и безопасности.

0 Подготовка каталогов и загрузка пакетов

Важно: войдите в систему под учётной записью пользователя, а не под root, где это указано.

Создайте структуру каталогов (пример для пользователя zopy):

cd /home/zopy
mkdir zinstance
mkdir tools
cd tools
mkdir python
mkdir zope
mkdir packages

Скачайте исходники Zope, Python и Plone в каталог packages:

cd packages
wget http://www.zope.org/Products/Zope/2.9.4/Zope-2.9.4-final.tgz
wget http://www.python.org/ftp/python/2.4.3/Python-2.4.3.tgz
wget http://superb-east.dl.sourceforge.net/sourceforge/plone/Plone-2.5.tar.gz

1 Зависимости для сборки Python и Zope

Важно: для установки системных библиотек используйте root.

Установите компилятор и зависимости:

apt-get install gcc
apt-get build-dep gcc
apt-get install libmxml1
apt-get install python2.4-xml
apt-get install python-libxml2
apt-get install python-imaging

2 Установка Python 2.4.3

Важно: сборку Python выполняйте под обычным пользователем (не root).

cd /home/zopy/tools/packages
tar -xvzf Python-2.4.3.tgz
cd Python-2.4.3
./configure --prefix=/home/zopy/tools/python/
make
make install

Если при запуске Zope после установки Python появится ошибка, что не хватает zlib, скопируйте недостающую библиотеку в директорию lib-dynload собранного Python:

cp /usr/lib/python2.4/lib-dynload/zlib.so /home/zopy/tools/python/lib/python2.4/lib-dynload/

Важно: используйте реальные пути вашей системы.

3 Установка Zope 2.9.4

Сборку Zope выполняйте под обычным пользователем с указанием пути к только что установленному Python:

cd /home/zopy/tools/packages
tar -xvzf Zope-2.9.4-final.tgz
cd Zope-2.9.4-final
./configure --with-python=/home/zopy/tools/python/bin/python2.4 --prefix=/home/zopy/tools/zope/
make
make install

Создайте экземпляр Zope (zinstance):

/home/zopy/tools/zope/bin/mkzopeinstance.py

При запросе укажите каталог установки экземпляра, например:

Directory: /home/zopy/zinstance/

Задайте учётные данные администратора (например, admin и пароль).

Запустите экземпляр:

cd /home/zopy/zinstance/bin/
./zopectl start

4 Управление Zope через веб-интерфейс

Проверьте работоспособность Zope: откройте в браузере адрес

http://localhost:8080/manage

или замените localhost на IP сервера (например, http://192.X.X.X:8080/manage).

5 Установка Plone 2.5

Установка Plone выполняется под обычным пользователем.

cd /home/zopy/tools/packages
tar -xvzf Plone-2.5.tar.gz
cd Plone-2.5

Проблема совместимости: Plone 2.5 содержит каталог Five, который конфликтует с Zope 2.9.4. Удалите его:

rm -R Five

Копируйте содержимое Plone в каталог Products вашей zinstance:

rsync -av * /home/zopy/zinstance/Products/

Перезапустите zinstance:

cd /home/zopy/zinstance/bin/
./zopectl restart

6 Создание и управление Plone-сайтом

Откройте снова http://localhost:8080/manage и в интерфейсе Zope создайте Plone Site.

После создания сайт будет доступен по адресу:

http://localhost:8080/plone

Отказоустойчивость и распространённые ошибки

• Когда не запускается Zope после сборки Python — обычно отсутствует zlib.so в lib-dynload. Копирование этой библиотеки решает проблему.
• Если Plone не отображается корректно — проверьте логи zinstance/var and zinstance/log. Частая причина — права доступа на каталоги Products.
• При конфликте версий модулей используйте вывод make и /var/log для поиска несовместимых пакетов.

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

• Использовать buildout и готовые дистрибутивы Plone (рекомендуется для новых установок). Это упрощает управление версиями, но выходит за рамки данного руководства по ручной установке.
• Разворачивать Plone в контейнере (Docker) или виртуальной машине для изоляции окружения.

Рекомендации по безопасности

• Не выполняйте повседневную работу под root — это снижает риск повреждения системы.
• Защитите административный интерфейс (доступ только по VPN или через брандмауэр).
• Регулярно делайте резервные копии каталога zinstance и базы данных.

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

1. Подготовьте структуру каталогов под пользователем.
2. Под root: установите зависимости через apt-get.
3. Под пользователем: соберите и установите Python в локальный префикс.
4. Установите Zope, указывая путь к локальному Python.
5. Создайте zinstance, запустите zopectl.
6. Установите Plone: удалите конфликтующие каталоги, rsync в Products, перезапустите.
7. Проверьте веб-интерфейс и создайте Plone Site.

Ролевые чеклисты

• Системный администратор:
  • Установить зависимости через apt-get.
  • Обеспечить права на каталоги и резервное копирование.
• Разработчик/инженер Plone:
  • Собрать локальный Python и Zope.
  • Установить Plone и протестировать сайт.
• Оператор/контент-менеджер:
  • Создать Plone Site через Zope и управлять контентом.

Глоссарий (1 строка)

• zinstance — экземпляр Zope/Plone с конфигурацией и продуктами для одного сайта.

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

• Zope управляется через http://localhost:8080/manage.
• Plone Site доступен по http://localhost:8080/plone.
• Отсутствуют ошибки при старте zinstance в логах.

Заключение

Вы установили Plone 2.5 поверх Zope 2.9.4 и Python 2.4.3 на Debian. Для продакшн‑систем рассмотрите использование более современных версий Plone и Python, контейнеризацию и инструменты сборки (buildout, Docker).

Важно: это руководство описывает ручной метод сборки; для крупных проектов предпочтительнее автоматизированные и поддерживаемые методы развертывания.

Ключевые шаги: подготовка каталогов, установка зависимостей, сборка Python и Zope, создание zinstance, установка Plone и проверка через веб-интерфейс.