Установка OpenOffice.org и настройка для XWiki в варианте internal
Nbsp; XWiki Инструкция По установке и настройке связки приложений:XWiki + OracleXE + GlassFish Russian подсмотрено у Thomas Mortagne и актуализировано по состоянию на 2018г. Оглавление 1. Вступление. 2 2. ПО, необходимое для загрузки. 2 3. Установка базового набора приложений. 3 4. Установка XWiki Enterprise. 3 5. Установка и настройка сервера OpenOffice.org. 6 6. Рекомендации от старой инструкции. 7 1. Вступление Данная инструкция содержит последовательное описание процесса первоначальной установки и оптимальной настройки XWiki Enterprise в варианте под Windows + GlassFish + OracleXE. Исходным материалом послужили инструкции по инсталляции с сайта https//xwiki.org. Однако они являются более абстрактными и часто не учитывают специфики настроек под русские условия. Именно это и послужило стимулом к написанию данной инструкции. Инструкция делалась "под себя" - для обеспечения простой возможности повторить быстрое развертывание системы (в т.ч. другими администраторами). Инструкция составлена не по принципу "если - то" (как например, составлены инструкции по инсталляции на xwiki.org), а более жестко - "делать так" - поэтому многие вещи указываются без подробных объяснений, почему именно так. Из нового варианта инструкции убрано много лишнего, в 1-ую очередь - все что касается Jetty. Изначально я пытался развертывать XWiki в варианте Windows + Jetty + OracleXE, но потом понял, что Jetty не годится для рабочей эксплуатации. Из принципиальных минусов - зависания сервиса и медленная скорость работы с аттачами. Потом стал искать что-то вместо Jetty - и остановился на GlassFish. Понравилось - web-интерфейс настройки, то что не надо так сильно тюннить его как Jetty, ну и конечно скорость - файлы аттачились почти со скоростью, как если бы они копировались в локалке (jetty раз в 10 хуже)! Новый вариант инструкции пока не полный. Еще будут добавляться разделы касаемо настройки LDAP, настройки соединения со сторонней базой Oracle и пр. Также планируется перевод на английский и румынский языки. 2. ПО, необходимое для загрузки · XWiki Enterprise: o берем war-файл - собственно само приложение, o и также xar-файл - содержит начальные настройки и базовые страницы wiki (в 9й версии XWiki ввели Flavor (наборы) для того что бы, можно было создавать и устанавливать стандартные настройки XWiki под себя, не требуется, если Вы не хотите вручную настроить все) · В случае, если СУБД Oracle будет устанавливаться локально, то также будет необходимо Oracle Database Express Edition. Следует скачивать т.н. Universal-версию OracleXE для обеспечения поддержки UTF-8 (мультиязычности) на уровне БД. · Java Development Kit (JDK) - необходимо для работы сервера приложений. · Glassfish Application Server - сервер приложений. · Oracle JDBC Drivers - оптимальный выбор ojdbc7.jar от Oracle 11G. · Для работы приложения "импорт офисных документов" требуется: o OpenOffice / LibreOffice - офисный пакет, используемый для конвертации. o windows server 2003 resource kit - позволяет создать сервис. 3. Установка базового набора приложений OracleXE (если будем использовать локальную БД). просто инсталлируем через Setup. · В OracleXE, при инсталляции, отсутствуют возможности настройки языковых параметров БД. А для XWiki, для обеспечения мультиязычности, нужно чтобы они были настроены в UTF8 (например, NLS_CHARACTERSET должен быть AL32UTF8). Для этого необходимо чтобы OracleXE устанавливалась на версию Windows, где изначально все языковые настройки были сделаны в English. При этом недостаточно, чтобы эти настройки были настроены перед установкой OracleXE - они должны быть изначально такими именно при инсталляции Windows. Попытки настройки "по ходу дела" не дали результата. Запоминаем пароль от администратора, который нам предложат для него ввести. Логин администратора — SYSTEM.
|
|
|
|
|
|
Java Development Kit (JDK)
· Запускаем installer
· дальше все автоматически
GlassFish application server
· Распаковываем из архива на жесткий диск Glassfish Application Server.
· До запуска программы заходим в ..\glassfish4\glassfish\domains\domain1\config\ и открываем файл domain.xml. В строке:
|
|
|
<network-listener port=«8080» protocol=«http-listener-1» transport=«tcp» name=«http-listener-1» thread-pool=«http-thread-pool»></network-listener>
меняем значение порта, скажем, на 8008. Это связано с тем что Glassfish не запустится из-за конфликта портов с OracleXE
4. Установка XWiki Enterprise
Запуск Glassfish
· запускаем GlassFish командой из консоли
..\glassfishv4\bin\asadmin start-domain (останавливать командой stop-domain).
· В браузере набираем http://localhost:4848 и заходим в админ-консоль GlassFIsh (имя и пароль задаются при инсталляции, например, как в XWiki - Admin/admin, но в портативной версии их нет, впрочем и открыть извне не получается, т.к. запрашивает логин и пароль которого у нас нет).
Настройка соединения с Oracle
· создаем схему для XWiki:
1. Через консоль Oracle db
o подключаемся к Oracle dba-юзером: conn / as sysdba
o создаем схему: create user xwiki identified by xwiki;
o назначаем привилегии: grant all privileges to xwiki;
Можно не назначать полные привилегии, а оставить по умолчанию. Полные привилегии могут потребоваться для режима multi-wiki (когда устанавливается XEM) (пока в точности не известно).
2. Через графический интерфейс Oracle.
o Жмем на ярлык «Get Started with Oracle Database 11g Express Edition» на рабочем столе, который в свою очередь в браузере открывает локальную WEB-страничку OracleXE.
o Кликаем на «Application Express», в окне появляется форма, предлагающая ввести логин и пароль для дальнейших действий с БД. Вводим данные.
|
|
|
o Мы попадаем на форму «Create Application Express Workplace», в которой нам предлагают создать нового пользователя. Вводим везде «xwiki» без кавычек и нажимаем «Create Workplace»
Создаем подключение в GlassFish:
· Заходим в админку GlassFish -> Resources -> JDBC.
Создаем Connection Pool
Name - имя connection pool
Resource Type - это интерфейс, который реализуется конкретными вендорами в драйвере в виде классов. В списке Resource Type доступны следующие типы:
DataSource - Обычный data source для доступа к коннекциям
XADataSource - Доступ с использованием механизма распределенных транзакций
ConnectionPoolDataSource - Доступ с использованием connection pool. Но вендорами, к примеру, Oracle, интерфейс DataSource реализуется по умолчанию с использованием Connection Pool
DataBase Vendor - поставщик используемого драйвера базы данных
Рис. 1 Создание Connection Pool
На следующем шаге устанавливаем значения необходимых параметров. Достаточно указать следующие параметры:
user - имя пользователя для работы с БД
password - пароль
databaseName - xwiki
url :
thin - тип используемого драйвера
localhost - хост
1521 - порт
XE - название БД (XE стандартное имя для Oracle 10XE)
Остальные параметры оставляем по умолчанию.
Рис. 2 Добавление параметров Connection Pool
Затем создаем JDBC ресурс
Называем наш ресурс jdbc/ConncetionPool и выбираем в названии пула имя только что созданного пула.
Рис. 3 Создание JDBC ресурса
· Следует добавить дополнительную опцию для JVM –Xrs
Данная настройка необходима, т.к. в противном случае, GlassFish windows-сервис будет завершаться всегда при logout пользователя на сервере.
o Заходим в админ-консоль GlassFish
o В дереве слева выбираем Configuration, Default config, JVM Settings
o На открывшейся страничке выбираем закладку вверху JVM Options
o Откроется страница с параметрами JVM. Нажимаем кнопку вверху списка параметров Add JVM Options
o В добавленном поле пишем -Xrs и нажимаем на Save
Установка XWiki в GlassFish
- Выбираем в дереве слева Applications а в правой части - Deploy.
- Открываем с диска war-файл XWiki.
- Устанавливаем: Type = Web Application, Context Root = xwiki, Application name = xwiki, Virtual Servers – server, Impliсit CDI – снять галочку.
- Остальные параметры можно не менять и жмем OK.
· Останавливаем GlassFish командой stop-domain.
· Копируем файл JDBC-драйвера (ojdbc7.jar) «директория где установлен Glassfis»\glassfish\domains\domain1\lib\ext\
· Редактируем файл настроек соединения XWiki с БД \xwiki\WEB-INF\hibernate.cfg:
o Закомментировать строки, не относящиеся к Oracle (general database).
o Раскомментировать ту часть, где касается Oracle.
o Указываем параметры коннекта к базе (SID и host).
Если локально установлен OracleXE можно ничего не менять - а только раскомментировать и закомментировать соответствующие места.
· Возможно еще следует включить UTF-8 для Oracle (точно не известно насколько это нужно или нет)
o Открываем файл настроек соединения XWiki с БД \xwiki\WEB-INF\hibernate.cfg
o перед строкой <mapping resource="xwiki.oracle.hbm.xml"/> добавляем 2 строки:
<property name="connection.useUnicode">true</property>
o <property name="connection.characterEncoding">UTF-8</property>
· Запускаем GlassFish командой start-domain.
· Если Вы все сделали правильно, то зайдя в -> Resources -> JDBC -> ConnectionPool и нажав кнопку Ping Вы должны получить статус Ping Succeeded.
5. Установка и настройка сервера OpenOffice.org
Установка OpenOffice.org и настройка на работу с XWiki возможна 2 способами:
· internal - XWiki непосредственно работает с установленной версией OpenOffice.org
· external - OpenOffice.org запускается как windows-сервис, а XWiki работает уже с ним
Далее каждый из этих способов будет рассмотрен отдельно. Нами будет рассматриваться internal-вариант, как более простой.
Установка OpenOffice.org и настройка для XWiki в варианте internal
· Запускаем инсталлятор, отвечаем на вопросы, путь по умолчанию лучше не менять.
· После завершения запускаем Openoffice хотя бы один раз, чтобы выполнился мастер регистрации.
· Заходим в опции OpenOffice.org, раздел Open/Save, дальше HTML Compatibility
· Устанавливаем параметр Character set в UTF-8 и сохраняем
· Открываем файл \xwiki\WEB-INF\xwiki.properties, раскоментируем и меняем в нем следующие переменные:
o переменную openoffice.serverType=0
o переменную openoffice.serverPort=8100
o переменную openoffice.autoStart=true
o переменную openoffice.homePath=c:/Program Files//LibreOffice
· Теперь надо перезапустить GlassFish и в XWiki, Administration открыть раздел OpenOffice Server. Если все нормально - в поле server state будет стоять Connected.
Начальные настройки
· Для группы, куда нужно сразу включить Вашего юзера (это группа XWikiAdminGroup) следует дать права на programming (в разделе Administration, Rights)
· Также можно настроить XWiki на работу в MultiLanguage режиме.
o Выберите раздел Administration, General
o На открывшейся странице установите true для опции Multilingual
o В поле languages установите перечень желаемых языков через запятую, например en,ru,ro
6. Рекомендации от старой инструкции
Дата добавления: 2018-09-20; просмотров: 641; Мы поможем в написании вашей работы! |
Мы поможем в написании ваших работ!