Установка Alfresco 3.3 на Ubuntu 10.04

TL;DR

Краткое пошаговое руководство по установке Alfresco Community 3.3 на Ubuntu Server 10.04. Включает подготовку системы, установку зависимостей, настройку MySQL, конфигурацию alfresco-global.properties, запуск сервисов и тестирование.

Важно: инструкция рассчитана на Ubuntu Server 10.04 и Alfresco 3.3. Для других версий шаги могут отличаться.

Введение

Это руководство объясняет, как установить Alfresco Community 3.3 на Ubuntu Server 10.04 (Lucid Lynx). Alfresco — свободное решение для управления корпоративным содержимым (ECM): управление документами, совместная работа, управление записями, веб-контентом и обработкой изображений.

Кому полезно: системным администраторам и инженерам, которые развертывают Alfresco 3.3 на старых серверах или в лабораторных средах.

Основные шаги установки

Подготовка чистой системы Ubuntu Server 10.04.
Установка необходимых пакетов (MySQL, Sun Java 6, ImageMagick, OpenOffice и др.).
Настройка JAVA_HOME и MySQL для поддержки UTF-8.
Создание базы данных Alfresco и пользователя MySQL.
Скачивание, распаковка и конфигурация Alfresco.
Запуск сервисов (OpenOffice как сервис, Alfresco) и проверка доступа.

1. Установка Ubuntu Server 10.04

Вам нужна свежая установка Ubuntu Server 10.04. Подробную инструкцию по установке можно найти в руководстве “The Perfect Server - Ubuntu 10.04”. Следуйте шагам на страницах установки для базовой настройки сети, разделов и пакетов.

2. Примечания

В /etc/apt/sources.list необходимо включить репозиторий ‘partner’, иначе пакет sun-java6-jdk не установится.
В примере используется имя хоста dms.example.lan (в файлах примера — dms).
Пример IP сервера: 192.168.1.1/255.255.255.0. Замените его на ваши реальные настройки.

3. Необходимые зависимости

Запустите от имени root следующую команду, чтобы установить требуемые пакеты:

root@dms:~# apt-get install mysql-server sun-java6-jdk imagemagick swftools openoffice.org-core openoffice.org-java-common openoffice.org-writer openoffice.org-impress openoffice.org-calc

Совет: если пакет sun-java6-jdk недоступен в вашем зеркале, включите репозиторий partner и выполните apt-get update.

4. Настройка переменной JAVA_HOME

Отредактируйте /etc/environment и добавьте:

JAVA_HOME="/usr/lib/jvm/java-6-sun/"

После сохранения рекомендуется выйти из сеанса и снова войти, чтобы bash подтянул переменную. Если вы не хотите выходить, выполните:

root@dms:~# source /etc/environment

5. Смена кодировки по умолчанию в MySQL

Если вы планируете работать с языками, требующими UTF-8 (например, арабский, персидский, иврит), принудительно включите поддержку UTF-8 в MySQL. Иначе заголовки документов на таких языках будут отображаться как «????». Отредактируйте /etc/mysql/my.cnf и под секцией [mysqld] добавьте:

[mysqld]
#
# * Basic Settings
#
#
# * IMPORTANT
#   If you make changes to these settings and your system uses apparmor, you may
#   also need to also adjust /etc/apparmor.d/usr.sbin.mysqld.
#
default-character-set = utf8

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

root@dms:~# /etc/init.d/mysql restart

6. Создание базы данных для Alfresco

Войдите в MySQL под root:

root@dms:~# mysql -u root -p

Выполните команды SQL:

mysql> CREATE DATABASE alfresco DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
mysql> GRANT ALL PRIVILEGES ON alfresco.* TO alfresco@localhost IDENTIFIED BY 'alfresco';
mysql> GRANT SELECT,LOCK TABLES ON alfresco.* TO alfresco@localhost IDENTIFIED BY 'alfresco';
mysql> FLUSH PRIVILEGES;
mysql> quit;

Примечание: при желании измените пароль и имя пользователя на более безопасные.

7. Скачивание и установка Alfresco

В примере Alfresco устанавливается в /opt/alfresco. Вы можете выбрать другой путь.

root@dms:~# mkdir -p /opt/alfresco

Скачивание и распаковка:

root@dms:~# cd /opt/alfresco
root@dms:/opt/alfresco# wget http://dl.alfresco.com/release/community/build-2765/alfresco-community-tomcat-3.3.tar.gz?dl_file=release/community/build-2765/alfresco-community-tomcat-3.3.tar.gz -O alfresco-community-tomcat-3.3.tar.gz
root@dms:/opt/alfresco# tar zxvf alfresco-community-tomcat-3.3.tar.gz
root@dms:/opt/alfresco# rm -f alfresco-community-tomcat-3.3.tar.gz

Если ссылка устарела, получите пакет с официального репозитория Alfresco или зеркала.

8. Конфигурация Alfresco

Отредактируйте alfresco-global.properties:

root@dms:/opt/alfresco# nano /opt/alfresco/tomcat/shared/classes/alfresco-global.properties

Базовая конфигурация — измените значения следующим образом.

Исходный фрагмент:

###############################
## Common Alfresco Properties #
###############################
#
# Sample custom content and index data location
#-------------
dir.root=./alf_data
#
# Sample database connection properties
#-------------
db.name=alfresco
db.username=alfresco
db.password=alfresco
db.host=localhost
db.port=3306
#
# External locations
#-------------
#ooo.exe=soffice
#ooo.enabled=false
#img.root=./ImageMagick
#swf.exe=./bin/pdf2swf

Изменённый фрагмент:

###############################
## Common Alfresco Properties #
###############################
#
# Sample custom content and index data location
#-------------
dir.root=/opt/alfresco/alf_data
#
# Sample database connection properties
#-------------
db.name=alfresco
db.username=alfresco
db.password=alfresco
db.host=localhost
db.port=3306
#
# External locations
#-------------
ooo.exe=/usr/lib/openoffice/program/soffice
ooo.enabled=true
img.root=/usr
swf.exe=/usr/bin/pdf2swf

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

Поддержка CIFS

Чтобы получить доступ к документам Alfresco через CIFS (Windows Shares), добавьте в конец файла:

#
# CIFS Support
#------------------------
cifs.enabled=true
cifs.serverName=dms
cifs.ipv6.enabled=false
cifs.tcpipSMB.port=1445
cifs.netBIOSSMB.namePort=1137
cifs.netBIOSSMB.datagramPort=1138
cifs.netBIOSSMB.sessionPort=1139

Поддержка SharePoint

Если вы хотите открывать документы из Alfresco напрямую из MS Office, потребуется модуль SharePoint (VTI). Он не входит в базовую сборку Alfresco, поэтому скачайте и примените его:

root@dms:~# cd /opt/alfresco/amps
root@dms:/opt/alfresco/amps# wget -c http://dl.alfresco.com/release/community/build-2765/vti-module.amp?dl_file=release/community/build-2765/vti-module.amp -O vti-module.amp
root@dms:/opt/alfresco/amps# cd ..
root@dms:/opt/alfresco# bash apply_amps.sh

В конец alfresco-global.properties добавьте:

#
# Sharepoint
#-------------
vti.server.port=7070
vti.alfresco.deployment.context=/alfresco
vti.alfresco.alfresoHostWithPort=http://192.168.1.1:8080
vti.share.shareHostWithPort=http://192.168.1.1:8080

Замените IP 192.168.1.1 на IP вашего сервера.

9. Запуск Alfresco

Запустите OpenOffice.org как службу (Headless), чтобы Alfresco мог конвертировать документы:

root@dms:~# /usr/lib/openoffice/program/soffice "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" -nologo -headless -nofirststartwizard &

Замечание: Alfresco обычно пытается запускать OpenOffice самостоятельно, но иногда требуется запустить его вручную.

Обновите правила файрвола, чтобы перенаправить порты CIFS на нестандартные порты, указанные в конфигурации:

root@dms:~# iptables -t nat -A PREROUTING -p tcp -m tcp --dport 445 -j REDIRECT --to-ports 1445
root@dms:~# iptables -t nat -A PREROUTING -p tcp -m tcp --dport 139 -j REDIRECT --to-ports 1139
root@dms:~# iptables -t nat -A PREROUTING -p udp -m udp --dport 137 -j REDIRECT --to-ports 1137
root@dms:~# iptables -t nat -A PREROUTING -p udp -m udp --dport 138 -j REDIRECT --to-ports 1138

Запустите Alfresco:

root@dms:~# cd /opt/alfresco
root@dms:/opt/alfresco# bash alfresco.sh start

Проверьте логи в /opt/alfresco/tomcat/logs для диагностики запуска.

10. Тестирование

Доступ к Alfresco Repository: http://192.168.1.1:8080/alfresco
Доступ к Alfresco Share: http://192.168.1.1:8080/share
Логин: admin Пароль: admin
Из Windows: откройте Пуск → Выполнить и введите: \dms\alfresco
Инструкции по использованию протокола SharePoint в MS Office можно найти в документации по интеграции VTI.

Когда этот подход может не подойти

Вы используете более новую версию Ubuntu или Alfresco — некоторые пакеты или пути изменятся.
В вашей среде запрещён Sun Java 6; потребуются альтернативы (например, OpenJDK) и корректировки конфигурации.
Для больших продакшен-систем требуется настроить кластеры, балансировку и репликацию индексов — это выходит за рамки данного руководства.

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

Установить Alfresco через пакетный менеджер или готовый Docker-образ (современный способ для новых версий).
Использовать OpenJDK вместо Sun Java, если политика безопасности не позволяет использовать проприетарную JDK.
Для оффлайн-установки заранее скачать все deb-пакеты и зависимости.

Контрольный список для установки (оператор)

Включён репозиторий ‘partner’ в /etc/apt/sources.list
Установлен MySQL и перезапущен с поддержкой UTF-8
Создана база данных alfresco с корректными привилегиями
Установлена Sun Java 6 или совместимая JDK, настроен JAVA_HOME
Установлены ImageMagick, OpenOffice, swftools
Скачан и распакован пакет Alfresco в /opt/alfresco
[ ] Отредактирован alfresco-global.properties (dir.root, db., ooo., CIFS/SharePoint)
OpenOffice запущен в headless-режиме
Применены правила iptables для CIFS
Alfresco запущен, страницы /alfresco и /share доступны

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

Веб-интерфейс /share доступен и успешно авторизует admin/admin.
Репозиторий Alfresco доступен по /alfresco и возвращает ожидаемые страницы.
CIFS-шары доступны с Windows-произведения и отображают содержимое alf_data.
Логи не содержат ошибок соединения с базой данных или ошибок инициализации OpenOffice.

Советы по безопасности и файрволу

Не используйте в продакшене пароли по умолчанию (admin/admin, alfresco/alfresco). Поменяйте сразу после установки.
Отключите прямой доступ к MySQL с внешних интерфейсов или настройте firewall, разрешая доступ только с приложенческого сервера.
Убедитесь, что OpenOffice и Alfresco запускаются под сервисным аккаунтом, а не под root, в продакшен-средах.
Для CIFS/SMB используйте безопасные правила и, при необходимости, VPN вместо проброса портов.

Совместимость и миграция

Этот гайд ориентирован на Ubuntu 10.04 и Alfresco 3.3. При переходе на Ubuntu LTS более поздних версий проверьте пути к OpenOffice, Java и pdf2swf.
Миграция: создавайте резервные копии alf_data и базы данных перед обновлениями. Проверьте совместимость модулей AMP с новой версией.

Ключевые команды и подсказки

Проверка логов:
- /opt/alfresco/tomcat/logs/catalina.out
- /opt/alfresco/alf_data/logs
Перезапуск MySQL:

/etc/init.d/mysql restart

Запуск OpenOffice в background (headless): используйте nohup и проверьте, что процесс удерживается при перезапуске сервера.

Частые ошибки и способы их устранения

Alfresco не подключается к базе: проверьте db.name/db.username/db.password и доступ MySQL для локального пользователя.
Проблемы с кодировкой: убедитесь, что база создана с CHARACTER SET utf8 и my.cnf содержит default-character-set = utf8.
OpenOffice не запускается: проверьте путь ooo.exe в alfresco-global.properties и права на исполняемый файл.

Полезные ссылки и источники

Резюме

Это поэтапное руководство поможет быстро развернуть Alfresco Community 3.3 на Ubuntu Server 10.04. Проверьте конфигурации базы данных, пути к OpenOffice и параметры CIFS/SharePoint. В продакшене замените пароли по умолчанию и настройте бэкапы.

Важно: для новых сред и продакшен-окружений рассмотрите использование актуальных версий ОС и Alfresco, контейнеризации или готовых пакетов, чтобы получить поддержку безопасности и обновлений.