На предприятии, где я работаю, наконец-то окончательно поняли, что для дальнейшего развития необходимо внедрять электронный архив документации. Пару месяцев шли беспредметные споры о том, какую систему выбрать. Колебались между Microsoft Share Point, SAP, Documentum, NauDOC... В конце концов мне это надоело, и я решил разобраться, существуют ли достойные системы документооброта и электронного архива в мире СПО.

После отбрасывания полуживых и нерусифицированных проектов оказалось, что достойная система только одна - Alfresco. Компанию Alfresco создали люди, работавшие до 2005 года в Documentum, но решившие развивать свою ветку этой системы. В данный момент разработкой Alfresco ECM руководят основатель Documentum Дж. Ньютон и ex-топ-менеджер Business Objects Дж. Пауэлл. Alfresco разрабатывается и распространяется в виде свободного программного обеспечения. Монетизация деятельности происходит за счет сопровождения системы на предприятиях. В США система Alfresco считается практически стандартом де-факто, количество инсталляций оценивается как десятки тысяч. Alfresco используется в таких крупных организациях как:

• Компания Toyota
• Американское аэрокосмическое агенство NASA
• Служба доставки FedEx
• Массачусетский технологический университет (MIT)
• Гарвардкий университет
• Кинокомпания FOX (США)
• Компания Adobe
• Компания Hitachi
• ... и многие другие

Полный перечень клиентов Alfresco можно посмотреть на официальном сайте компании alfresco.com/customers.

Установка tomcat

Установить пакеты tomcat:

• tomcat6
• tomcat6-admin
• tomcat6-common
• tomcat6-docs
• tomcat6-examles
• tomcat6-user
• libtcnative-1

После установки пакетов tomcat нужно в браузере открыть URL:

http://localhost:8080/

Должно появиться следующее сообщение:

It works !

If you're seeing this page via a web browser, it means you've setup Tomcat successfully. Congratulations!

This is the default Tomcat home page. It can be found on the local filesystem at: /var/lib/tomcat6/webapps/ROOT/index.html

Tomcat6 veterans might be pleased to learn that this system instance of Tomcat is installed with CATALINA_HOME in /usr/share/tomcat6 and CATALINA_BASE in /var/lib/tomcat6, following the rules from /usr/share/doc/tomcat6-common/RUNNING.txt.gz.

You might consider installing the following packages, if you haven't already done so:

tomcat6-docs: This package installs a web application that allows to browse the Tomcat 6 documentation locally. Once installed, you can access it by clicking here.

tomcat6-examples: This package installs a web application that allows to access the Tomcat 6 Servlet and JSP examples. Once installed, you can access it by clicking here.

tomcat6-admin: This package installs two web applications that can help managing this Tomcat instance. Once installed, you can access the manager webapp and the host-manager webapp.

NOTE: For security reasons, using the manager webapp is restricted to users with role "manager". The host-manager webapp is restricted to users with role "admin". Users are defined in /etc/tomcat6/tomcat-users.xml.

Скрипты запуска и остановки tomcat находятся в каталоге

/usr/share/tomcat6/bin

Запуск: /usr/share/tomcat6/bin/startup.sh

Остановка: /usr/share/tomcat6/bin/shutdown.sh

Если эти скрипты не срабатывают, можно воспользоваться системными:

/etc/init.d/tomcat6 stop

/etc/init.d/tomcat6 start

Установка Alfresco

Для установки Alfresco нужно остановить tomcat6:

/etc/init.d/tomcat6 stop

Далее из zip-архива с 32-х битной версией нужно скопировать:

/alfresco/web-server/shared -> /var/lib/tomcat6

/alfresco/web-server/webapps -> /var/lib/tomcat6

/alfresco/web-server/lib -> /var/lib/tomcat6/shared/lib

/alfresco/bin -> /var/lib/tomcat6/bin

/alfresco/licenses -> /var/lib/tomcat6/licenses

И еще скопировать:

- Положить *.war файлы в папку /var/lib/tomcat6/webapps/

- Из любого unux пакета alfresco взять папку $$$/tomcat/shared/ и положть ее в свою систему в /var/lib/tomcat6 (исправить пути и другие настройки alfresco - как?).

Далее в файле /etc/default/tomcat6 надо прописать путь к каталогу с Java-машиной. Например, так:

JAVA_HOME=/opt/jre1.6.0_26

А так же надо указать опции для старта Java-машины, без них Tomcat с Alfresco, скорее всего, не запустится:

JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=512m -Xms128m -Xmx768m -Dalfresco.home=/opt/alfresco_data -Dcom.sun.management.jmxremote"

Нужно обратить внимание, что здесь указана директория /opt/alfresco_data - это директория с данными Alfresco, ее нужно создать и учитывать и далее в настройках.

Далее в файле /var/lib/tomcat6/conf/catalina.properties подправить опцию shared.loader:

shared.loader=${catalina.home}/shared/classes,${catalina.home}/shared/*.jar,/var/lib/tomcat6/shared/classes,/var/lib/tomcat6/shared/lib/*.jar

Еще нужно создать каталог: /usr/share/tomcat6/logs и назначить ему права 777. Почему-то он автоматически не создается.

Открыть Alfresco можно так:

http://192.168.1.2:8080/share/

Для входа можно воспользоваться логином admin и паролем admin. На данный момент будет работать только окно входа, сама Alfresco пока работать не будет, так как не настоена база данных.

По факту, лог-файл называется так: /usr/share/tomcat6/logs/catalina.out. Однако другой источник утверждает, что логфайл Alfresco, начиная с версии 4.0, называется alfresco.log и хранится в TOMCAT_HOME/bin.

Подключение Alfresco к MySQL

Зайти на сайт MySQL, найти там раздел "MySQL Connectors":

http://dev.mysql.com/downloads/connector/

Скачать коннектор для Java (Connector/J):

http://dev.mysql.com/downloads/connector/j/

Последняя версия на момент написания статьи - mysql-connector-java-5.1.18.zip

Взять из этого архива *.jar - файл и положить его в

/var/lib/tomcat6/shared/lib/

В MySQL создать базу данных с именем alfresco.

В MySQL создать пользователя alfresco. Задать пользователю пароль alfresco.

Открыть файл <classpathRoot>/alfresco-global.properties.sample. Видимо, имеется в виду /var/lib/tomcat6/shared/classes/alfresco-global.properties.sample (есть еще /var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco-global.properties.sample).

Найти в этом файле опцию dir.root и прописать в ней каталог, где будут храниться данные, например:

dir.root=/opt/alfresco_data

Данная директория должна быть создана, и открыта для доступа системному пользователю tomcat6:

chown -R tomcat6:tomcat6 /opt/alfresco_data

Далее в том же файле нужно раскомментировать строки:

db.username=alfresco

db.password=alfresco

Ниже в том же файле найти секцию настройки подключения к MySQL и раскомментировать ее:

#db.driver=org.gjt.mm.mysql.Driver

#db.url=jdbc:mysql://localhost/alfresco?useUnicode=yes&characterEncoding=UTF-8

Пример, как установить хост и порт, по которому отвечает MySQL сервер (JDBC driver ?):

db.url=jdbc:mysql://your-host:3306/alfresco?useUnicode=yes&characterEncoding=UTF-8

После этого надо скопировать файл:

/var/lib/tomcat6/shared/classes/alfresco-global.properties.sample

под именем

/var/lib/tomcat6/shared/classes/alfresco-global.properties

И перезапустить tomcat.

Дополнительные настройки Alfresco

В файле

/var/lib/tomcat6/shared/classes/alfresco-global.properties

обязательно надо настроить путь к ImageMagick:

img.root=/usr/lib/ImageMagick-6.6.0

чтобы был возможен предпросмотр загруженных графических документов.

Русификация Alfresco 4

Вначале нужно остановить tomcat. Как это делать см. выше.

Для русификации нужно скачать два файла.

Первый файл - официальная русификация. Она неполная. Скачать здесь:

http://forge.alfresco.com/frs/?group_id=57&release_id=601

нужно скачать файл alfresco_ru_4.0.1.tar.gz.

Содержимое этого файла распаковать в /var/lib/tomcat6.

Далее открыть на редактирование файл:

/var/lib/tomcat6/webapps/alfresco/WEB-INF/classes/alfresco/web-client-config.xml

В нём:

Найдите раздел <languages>

Добавьте язык строкой вида:

<language locale="ru_RU">НазваниеЯзыка</language>

Внимание! Если вы хотите написать "Русский" по-русски, делайте это в UTF-8

Закомментируйте или удалите строчки для ненужных языков.

Порядок перечисления языков определяет порядок, в котором они представлены в окне входа в систему.

Внимание! Чтобы названия шаблонных элементов создавались по-русски, нужно установить русский язык первым до генерации базы данных. Предполагается, что нужно остановить tomcat, полностью очистить MySQL базу данных alfresco, полностью очистить директорию /opt/alfresco_data, затем снова запустить tomcat.

Второй файл взять по этой ссылке: http://file.qip.ru/file/_7qbBTou/re_.html. Это русификация процессов и workflow.

Файлы из этого архива нужно скопировать в:

process-messages_ru.properties в каталог

tomcat/webapps/alfresco/WEB-INF/classes/alfresco/module/org_alfresco_module_wcmquickstart/process/

workflow-messages_ru.properties в каталог

tomcat/webapps/alfresco/WEB-INF/classes/alfresco/workflow/

Русификация Alfresco Share

Русификацию следует проводить после первичного запуска Alfresco, когда развернутся war-файлы и сформируется дерево каталогов.

Так как в Firefox и IE для русского языка используется суффикс ru - в результирующем переводе файлы properties имеют суффикc ru, а не ru_RU как было раньше. Теперь, по идее, можно убрать из параметров запуска alfresco параметры -Duser.language=ru -Duser.region=RU. Язык будет выбран автоматически в соответствии с настройками браузера.