По инструкции номер порта меняется в конфигурации tomcat в файле $ALF_HOME/tomcat/conf/server.xml и еще в большом количестве конфигурационных файлов alfresco. Я пробовал делать, как рекомендуют, Alfresco Explorer заработал сразу после изменения server.xml, а Share запустить на 80 порту так и не смог. Отредактировал все файлы, указанные в инструкции, в каталоге Web-приложения share также искал и менял все, что относится к 8080, но  Share так и не заработало.

Почитав форумы понял, что проблема не у меня одного. Решить удалось с помощью Workaround, из инструкции по смене порта: в конфиге tomcat $ALF_HOME/tomcat/conf/server.xml копируем описание коннектора, работающего на порту 8080, и меняем порт на 80. При этом старый коннектор на порту 8080 не удаляем. Пример конфигурации:

<Connector port="8080" protocol="HTTP/1.1" URIEncoding="UTF-8"
 connectionTimeout="20000"
 redirectPort="8443" />
<Connector port="80" protocol="HTTP/1.1" URIEncoding="UTF-8"
 connectionTimeout="20000"
 redirectPort="8443" />

В результате пользователи ходят через порт 80, используя ссылки вида http://myserver/alfresco и http://myserver/share, а приложения к репозиторию Alfresco подключаются через порт 8080. Работают как Alfresco Explorer, так и Share.

Похожие записи:

1. Установка Alfresco на Solaris 10
2. Русификация Alfresco
3. Установка Alfresco 3.2 на Solaris

Использованные версии ПО:

• Alfresco Community Edition 3.2r Preconfigured Tomcat bundle for any platform
• Solaris 10 x64 (сервер Sun Fire X2100 M2)
• MySQL 5.1.2 for Solaris x86-64

Сразу скажу, что установить и заставить работать Alfresco 3.2 на Solaris проще, чем предыдущие версии. Во-первых, Alfresco 3.2 сразу рассчитано на работу с MySQL и содержит все необходимые настройки, включая MySQL Connector/J, который раньше надо было загружать отдельно с сайта mysql. Без MySQL Alfresco 3.2 работать отказывается, а это значит, что Вы не натолкнетесь на проблему «More than one root node in index», которая часто встречалась в предыдущих версиях, если Alfresco сначала запускалось на встроенной HSQL, а затем подключался MySQL (гарантированного решения этой проблемы не существовало).

Во-вторых, все настройки разработчики попытались собрать в один файл: {$ALF_HOME}/tomcat/shared/classes/alfresco-global.properties. Получилось не до конца, например, чтобы поменять порт, на котором работает Alfresco, надо вручную поправить несколько файлах в разных каталогах. Но большая часть настроек оказалась в alfresco-global.properties, что существенно упрощает установку и конфигурирование.

Итак, последовательность действий при установке:

1. Установите и настройте MySQL, нужен 5.0.67 или выше.

2. Alfresco 3.2 требует JDK 6. У меня на Solaris 10 10/08, было JDK 5  Update 17, с которой Alfresco работать отказалось. Поэтому пришлось установить вручную JDK 6 Update 16. Взять можно здесь. Рекомендую устанавливать не из пакетов, а из самораспаковывающихся архивов. Из архивов можно установить в любой каталог и при запуске Alfresco прописать путь к этому каталогу в переменную JAVA_HOME. Таким образом, новая версия JDK не повлияет на другие приложения в системе.

Если у Вас 64-битная Solaris (а 32-битных я не встречал давно), то обратите внимание, что необходимо сначала установить 32-битный вариант JDK 6, и только потом 64-битный JDK 6, т.к. 64-битный является расширением 32-битного и не работает без него.

3. Создаем каталог для установки Alfresco, например /opt/alfresco:

bash-3.00# mkdir /opt/alfresco

Копируем дистрибутив в этот каталог и распаковываем его:

bash-3.00# gunzip alfresco-community-tomcat-3.2r.tar.gz
bash-3.00# tar xvf alfresco-community-tomcat-3.2r.tar

4. Создаем базу данных MySQL. Скрипт создания базы /opt/alfresco/extras/databases/mysql/db_setup.sql. Для повышения безопасности рекомендуется в этом скрипте поменять как минимум пароль для доступа к создаваемой базе данных, а лучше также изменить название самой базы и имя пользователя.

В Alfresco версии 3.2 в скрипте db_setup.sql явно указано, чтобы база данных создавалась в кодировке UTF-8, а значит в последующем у Вас не будет проблем с русификацией. В предыдущих версиях кодировка явно указана не была, поэтому у меня на Solaris 10 (как SPARC, так и x86) база создавалась в ISO-8859-1, и вместо русских букв в базе были одни знаки вопроса.

Отредактировав файл db_setup.sql запускам создание базы данных:

bash-3.00# mysql –u root –p < /opt/alfresco/extras/databases/mysql/db_setup.sql

Спросят пароль пользователя root для MySQL, и после успешного ввода база данных будет создана.

5. Редактируем файл alfresco-global.properties. Указываем полный путь к репозиторию:

dir.root=/opt/alfresco/alf_data

Прописываем параметры соединения с базой данных MySQL, если они были изменены в скрипте db_setup.sql:

db.name=alfresco
db.username=alfresco
db.password=alfresco
db.host=localhost
db.port=3306

6. Редактируем файл /opt/alfresco/alfresco.sh. Заменяем в первой строке интерпретатор sh на bash:

#!/bin/bash

Указываем путь к JDK 6:

export JAVA_HOME=/opt/java/jdk1.6.0_16

Указываем полный путь к каталогу установки Alfresco:

ALF_HOME=/opt/alfresco

7. Запускаем Alfresco. В каталоге /opt/alfreso выполняем команду:

bash-3.00# ./alfresco.sh start

Мониторим процесс запуска:

bash-3.00# tail -f /opt/alfresco/alfresco.log

8. Проверяем, что Alfresco работает, открываем в браузере страницу http://localhost:8080/alfresco.

Также необходимо отметить, что документация по установке и настройке Alfresco в версии 3.2 существенно улучшилась. В нее включили подробную инструкцию по установке Tomcat Bundle, правда для Linux, но под Solaris последовательность действий почти такая же. Документация значительно расширилась, можно найти решения почти всех проблем, возникающих при установке на Solaris, например, необходимость заменить sh на bash в файле запуска alfresco.sh.

Документация, конечно, все еще не совершенна. Например, в ней нет описания такой часто выполняемой операции, как смены порта с 8080. Я не нашел простого и гарантированно работающего способа смены порта, при котором работает share. Будем наедятся, что проблема решится в следующих версиях. Повод для надежды есть, т.к. в версии 3.2 появилось много полезных усовершенствований.

Похожие записи:

1. Установка Alfresco на Solaris 10
2. Русификация Alfresco
3. Подключение Alfresco к MySQL в Solaris 10

Alfresco поддерживает локализацию как в версии Enterprise, так и в Community. Все сообщения вынесены в так называемые «Языковые пакеты» (Language Pack). С дистрибутивом распространяется только английский языковой пакет, остальные нужно устанавливать самостоятельно.

Я проводил русификацию следующей конфигурации Alfresco:

• Alfresco Lab 3.1 Final Preconfigured Tomcat bundle
• MySQL 5.1.2 for Solaris x86-64
• Solaris 10/08 x64

Русификацию лучше планировать заранее и начинать сразу после установки Alfresco. В моем случае скрипт создания базы данных в MySQL от Alfresco создал базу в кодировке Latin1. Для русификации пришлось пересоздавать базу данных.

Для определенности будем считать, что Alfresco установлена в каталог /opt/alfresco

Итак, последовательность шагов по русификации Alfresco с базой MySQL на Solaris 10:

1. При создании базы данных MySQL убедиться, что используется кодировка UTF8. Лучше всего прямо прописать это в скрипте создания базы данных /opt/alfresco/extras/databases/mysql/db_setup.sql:

create database alfresco default character set utf8;

2. Указать драйверу MySQL использовать принудительно юникод и кодировку UTF8 в файле /opt/alfresco/tomcat/shared/classes/alfresco/extension/custom-repository.properties:

#
# MySQL connection (This is default and requires mysql-connector-java-5.0.3-bin.
jar, which ships with the Alfresco server)
#
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/alfresco?useUnicode=true&characterEncoding=UTF-8

3. Скачать языковой пакет для русского языка. Последняя версия очень старая, от 20 ноября 2006 года. К версии Alfresco Lab 3.1 он подходит, но переведены не все сообщения.

4. Файлы с русскими сообщениями вида имя_ru_RU.properties из языкового пакета скопировать в каталог /opt/alfresco/tomcat/shared/classes/alfresco/messages.

5. Включить возможность выбора русского языка в Web-клиенте Alfresco в файле /opt/alfresco/tomcat/shared/classes/alfresco/extension/web-client-config-custom.xml. Ищем раздел Languages, удаляем все, что есть, оставляем только русский. Должно выглядеть примерно так:

<!-- Example of adding languages to the list in the login page -->
<config evaluator="string-compare" condition="Languages">
    <languages>
       <language locale="ru_RU">Russian</language>
    </languages>
</config>

Внимание! По-умолчанию секция выбора языка закомментирована символами <!–  –> до и после тега <config>. Обязательно уберите символы комментария, иначе возможность выбора языка в интерфейсе не появится.

6. Если хотите, чтобы в Alfresco по-умолчанию использовался русский язык, в файл запуска /opt/alfresco/alfresco.sh можно добавить две строки:

LANG=ru_RU
export LANG

Вот и все. Если сделили все правильно, русския язык в Alfresco должен заработать.

Ссылки на англоязычные ресурсы:

1. Language Packs
2. Language Pack Installation
3. Language Pack Development

Похожие записи:

1. Подключение Alfresco к MySQL в Solaris 10
2. Установка Alfresco на Solaris 10
3. Установка Alfresco 3.2 на Solaris

Используемые версии ПО:

• Alfresco Lab 3.1 Final Preconfigured Tomcat bundle
• MySQL 5.1.2 for Solaris x86-64
• Solaris 10/08 x64

Подключать Alfresco к MySQL рекомендую сразу же после установки и до первого запуска Alfresco. Иначе возможны проблемы, решить которые не всегда удается. Подробнее об этом в конце статьи.

Будем считать, что Alfresco и MySQL уже установлены. Последовательность действий по подключению Alfresco к MySQL:

1. Скачайте MySQL Connector/J и скопируйте jar-файл в каталог /opt/alfresco/tomcat/shared/lib/

2. Отредактируйте файл создания базы данных  /opt/alfresco/extras/databases/mysql/db_setup.sql:

create database alfresco;
grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;
grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;

Желательно поменять пароль к базе данных, можно также заменить имя пользователя и имя базы.

MySQL я ставил уже скомпилированный для Solaris 10 из tar архива, там кодировка по-умолчанию для базы данных Latin 1. Чтобы не было проблем с русским языком в Alfresco, база данных должна быть в кодировке utf8. Поэтому надо явно указать кодировку по умолчанию для базы данных в первой строке файла db_setup.sql:

create database alfresco default character set utf8;

3. Создайте базу данных. В каталоге /opt/alfresco/extras/databases/mysql/ запустите команду:

mysql -u root -p < db_setup.sql

4. Отредактируйте конфигурационные файлы Alfresco с параметрами базы данных. Файлы находятся в каталоге /opt/alfresco/tomcat/shared/classes/alfresco/extension. Первый файл custom-repository.properties. В нем нужно поменять имя и пароль пользователя базы данных, закомментировать строки, относящиеся к HSQL и раскомментировать строки, относящиеся к MySQL:

#
# Sample database connection properties
#
db.username=alfresco
db.password=alfresco
#db.pool.initial=10
#db.pool.max=100
...
#
# HSQL connection
#
#db.driver=org.hsqldb.jdbcDriver
#db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=true
;

#
# MySQL connection (This is default and requires mysql-connector-java-5.0.3-bin.
jar, which ships with the Alfresco server)
#
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/alfresco?useUnicode=true&characterEncoding=UTF-8

В последней строке пришлось явно указать, чтобы драйвер JDBC MySQL использовал кодировку UTF-8. Без этого вместо русских символов в базу записывались вопросительные знаки.

Следующий файл, который нужно отредактировать custom-hibernate-dialect.properties. В нем также нужно закомментировать все, что относится к HSQL и раскомментировать строки, относящиеся к MySQL.

#
# HSQL dialect
#
#hibernate.dialect=org.hibernate.dialect.HSQLDialect

#
# MySQL dialect (default)
#
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

На этом установка заканчивается. Если Вы ни разу не запускали Alfresco до этого, то все должно заработать.

Если Вы уже запускали Alfresco на HSQL, и записали туда документы, то после подключения MySQL Alfresco может не запустится. В логе должны появится ошибки следующего вида:

Caused by: org.alfresco.repo.search.SearcherException: More than one root node in index 2

Средства для гарантированного решения этой проблемы нет. Можете попробовать сделать следующее:

1. Остановите Alfresco.

2. Полностью удалите каталог /opt/alfresco/alf_data/lucene_indexes.

3. Отредактируйте файл /opt/alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/repository.properties. Нужно поменять значения параметров index.recovery.mode и system.bootstrap.config_check.strict:

# The index recovery mode (NONE, VALIDATE, AUTO, FULL)
#index.recovery.mode=VALIDATE
index.recovery.mode=FULL

# Change the failure behaviour of the configuration checker
#system.bootstrap.config_check.strict=true
system.bootstrap.config_check.strict=false

4. Попробуйте запустить ALfresco. Есть шанс, что все заработает.

Если Alfresco не заработало, попробуйте снова удалить каталог /opt/alfresco/alf_data/lucene_indexes, пересоздать базу данных и опять опытаться запустить Alfresco. В случае успешного запуска не забудьте поменять параметр index.recovery.mode, иначе Alfresco будет перестраивать индексы при каждом запуске.

Если и это не поможет, то придется переустанавливать и настраивать подключение к MySQL до первого запуска Alfresco.

Ссылки на англоязычные ресурсы:

1. Setting up the MySQL database for Alfresco
2. Using Alfresco with other databases than MySQL
3. Alfresco on Debian: using MySQL

Похожие записи:

1. Русификация Alfresco
2. Установка Alfresco 3.2 на Solaris
3. Установка Alfresco на Solaris 10

Использованные версии ПО:

• Solaris 10 SPARC (сервер Sun Fire T1000) и x86/x64 (сервер Sun Fire X2100 M2).
• Alfresco Lab 3.1 Final Preconfigured Tomcat bundle

Последовательность действий при установке.

1. Не обязательно, но очень желательно устанавливать Alfresco в отдельную зону для повышения безопасности. Почему это безопасно, можно посмотреть здесь, здесь или здесь. Инструкции по созданию зоны здесь.

2. Создаем каталог для установки Alfresco, например /opt/alfresco

bash-3.00# mkdir /opt/alfresco

3. Распаковываем дистрибутив Alfresco в каталоге /opt/alfresco

bash-3.00# gunzip alfresco-labs-tomcat-3Stable.tar.gz
bash-3.00# tar xvf alfresco-labs-tomcat-3Stable.tar

4. Редактируем файл alfresco.sh:

• Прописываем путь к Java в переменную JAVA_HOME и экспортируем ее;
• Прописываем полный путь к каталогу с Alfresco в переменную ALF_HOME;
• Меняем все конструкции вида export VAR=value, на синтаксис, понятный для Bourne:

VAR=value
export VAR

Пример файла alfresco.sh:

#!/bin/sh
# Start or stop Alfresco server
# Set the following to where Tomcat is installed
JAVA_HOME=/usr/java
export JAVA_HOME
ALF_HOME=/opt/alfresco
cd "$ALF_HOME"
APPSERVER="${ALF_HOME}/tomcat"
# Set any default JVM values
JAVA_OPTS='-Xms128m -Xmx512m -XX:MaxPermSize=128m -server'
export JAVA_OPTS
…

5. В файле /opt/alfresco/tomcat/shared/classes/alfresco/extension/custom-repository.properties прописываем полный путь к контенту и индексам в параметре dir.root:

dir.root=/opt/alfresco/alf_data

6. Запускаем Alfresco:

bash-3.00# ./alfresco.sh start
Using CATALINA_BASE:   /opt/alfresco/tomcat
Using CATALINA_HOME:   /opt/alfresco/tomcat
Using CATALINA_TMPDIR: /opt/alfresco/tomcat/temp
Using JRE_HOME:       /usr/java
bash-3.00#

7. Можно понаблюдать, как запускается Tomcat и развертывается web-приложение alfresco.war:

bash-3.00# tail -f /opt/alfresco/tomcat/logs/catalina.out

8. Запускаем браузер, открываем ссылку http://localhost:8080/alfresco. Логин и пароль по-умолчанию admin/admin.

В минимальном варианте Alfresco заработало. Самое интересное предстоит впереди:

• Интеграция с MySQL;
• Русификация;
• Автозапуск через SMF;
• Интеграция с LDAP;
• Настройка HTTPS.

Я постараюсь написать обо всем вышеперечисленном. Также, когда сам разберусь, напишу о:

• Интеграции с Open Office;
• Интеграции с Image Magick;
• Интеграция с SWT Tools;
• Настройке CIFS.

И напоследок англоязычные ресурсы по установке Alfresco на Solaris:

• Installing on Solaris
• Installing Alfresco Labs 3b on Solaris 10

Похожие записи:

1. Установка Alfresco 3.2 на Solaris
2. Изменение порта 8080 в Alfresco
3. Русификация Alfresco

• Alfresco
• Nuxeo
• KnowledgeTree

Все три системы Open Source, у каждой есть бесплатная версия и коммерческая версия с поддержкой.

После тестирования и сравнения, мы остановились на Alfresco. Надеюсь, что соберусь с силами и напишу отдельный пост по обоснованию выбора.

В качестве серверной платформы у нас используется Solaris. Alfresco же больше рассчитано на работу с Linux и Windows. Solaris тоже поддерживается, но есть особенности при установке и конфигурировании, с некоторыми из них мне пришлось столкнуться. Об этих особенностях я планирую написать несколько постов.

Похожие записи:

1. Русификация Alfresco
2. Установка Alfresco на Solaris 10
3. Изменение порта 8080 в Alfresco