Базовая настройка Celesta — различия между версиями

Материал из Course Orchestra
Перейти к: навигация, поиск
 
Строка 98: Строка 98:
 
|-
 
|-
 
| h2.in-memory
 
| h2.in-memory
| Значение true заставляет Celesta использовать базу H2 в in-memory режиме. Параметры JDBC подключения при этом игнорируются.  
+
| Значение true заставляет Celesta использовать базу H2 в in-memory режиме. Параметры JDBC подключения при этом игнорируются. Режим необходим, прежде всего, для [[CelestaUnit|модульных тестов]].
 +
| Нет
 +
| true
 +
| false
 +
|-
 +
| h2.port
 +
| Если указано целочисленное значение, и при этом h2.in-memory установлено в true, то база H2 запускается в виде сервера на указанном порту. Данный режим позволяет присоединяться к базе данных H2 внешним приложениям, читать и модифицировать данные. Параметры JDBC подключения при этом игнорируются. Этот режим необходим для UI и приёмочных автоматических тестов.  
 
| Нет
 
| Нет
 
| true
 
| true

Текущая версия на 16:42, 3 апреля 2018

Внимание! Вы просматриваете документацию к Celesta 6.x. Документация по Celesta 7.x доступна на courseorchestra.github.io/celesta.

1. Справочник Celesta

1.1 Введение и основные понятия
1.2 Запуск и авто-обновление
1.3 Базовая настройка
1.4 Системные таблицы
1.5 CelestaSQL
1.6 CelestaDoc
1.7 Контексты сессии и вызова
1.8 Курсоры
1.9 BLOB-поля
1.10 Option-поля
1.11 Защита от потерянных обновлений
1.12 Метаданные Celesta
1.13 CelestaUnit

2. Celesta и базы данных

2.1 Особенности работы Celesta с поддерживаемыми типами СУБД
2.2 Проектирование базы данных Celesta в DBSchema

3. Создание решений с использованием Celesta для ShowCase

3.1 Программа обучения Celesta
3.2 Подготовка рабочего места для работы с Celesta
3.2.1 Для разработчиков платформы
3.2.2 Для разработчиков решений
3.3 Системные гранулы Celesta
3.3.1 common
3.3.1.1 Экспорт/импорт данных
3.3.1.2 Навигатор
3.3.1.3 Серии номеров
3.3.1.4 Иерархия Дьюи
3.3.1.5 Системные функции
3.3.1.6 Реестр настроек
3.3.1.7 Mailsender
3.3.1.8 Common.filter
3.3.2 common.api
3.3.4 security
3.3.3 lyra
3.4 Стандартные гранулы Celesta
3.4.1 dirusing
3.4.2 workflow
3.4.3 File repository
3.5 Отрисовка элементов Showcase при помощи Celesta
3.5.1 Конвертер XML-JSON
3.5.2 Навигатор (Navigator)
3.5.3 Информационная панель (Datapanel)
3.5.4 Серверное действие (Server activity)
3.5.5 Вебтекст (WebText)
3.5.6 Грид (Grid)
3.5.6.1 Панель инструментов (ToolBar)
3.5.7 XForms
3.5.7.1 Селекторы
3.5.7.2 Submission
3.5.7.3 Загрузка/Выгрузка файлов (Upload/Download)

5. Решение проблем

5.1 Проблемы с кодировкой jython-файлов

К базовым настройкам Celesta относятся общесистемные параметры, такие как параметры подключения к базе данных и путь к партитуре (score path, определение этому термину см. в разделе Основные понятия).

Эти настройки выполняются в .properties-файле системы, в которую встроена Celesta. Например, если вы работаете с системой ShowCase, то таковым являетя общий файл generalapp.properties, лежащий в папке general (обратите внимание, что в файле generalapp.properties свойства, имеющие отношение к Celesta, должны иметь префикс "celesta.").

Если вы работаете с системой Flute, то таковым является файл flute.properties.

В крайне маловероятном случае вы будете работать с системой Celesta самой по себе, в этом случае настройки должны содержаться в файле celesta.properties, который в этой ситуации должен находиться в одной папке с файлом celesta.jar.

Базовыми настройками Celesta являются:

(смотрите ниже, т. к. Wiki странно верстает эту страницу)

Параметр Назначение Обязательный Пример значения Значение по умолчанию
score.path score path Celesta (список папок, разделённый разделителем путей, специфичным для операционной системы) Да c:/eDacha/score/;c:/celestabasic -
pylib.path путь к папке со стандартными библиотеками Jython Нет c:/Program Files/Apache Software Foundation/Tomcat 7.0/webapps/edacha/WEB-INF/libJython/ pylib
javalib.path список папок с .jar-файлами, разделённый разделителем путей, каждый из которых будет добавлен в classpath при запуске Celesta и, как следствие, будет доступен в jython-скриптах Нет c:/pathto/javalib1;c:/pathto/javalib2
rdbms.connection.url URL подключения к JDBC-драйверу Да
  • jdbc:sqlserver://172.16.1.114:52836;databaseName=celesta;user=sa;password=111
  • jdbc:postgresql://127.0.0.1:5432/celesta?user=postgres&password=7464
  • jdbc:oracle:thin:celesta/123@192.168.110.128:1521:XE
-
rdbms.connection.username Логин для подключения к базе данных Нет (если не заполнен, используется информация из rdbms.connection.url) -
rdbms.connection.password Пароль для подключения к базе данных Нет (если не заполнен, используется информация из rdbms.connection.url) -
log.logins Включает режим записи (логирования) пользовательских входов в систему и пользовательских выходов из системы в таблицу sessionlog. Нет true false
skip.dbupdate Заставляет систему при инициализации полностью пропустить фазу обновления базы данных (включая создание системных таблиц).

Этот параметр категорически не рекомендуется включать, если вы не знаете твёрдо, чего хотите добиться.

Этот параметр требуется при некоторых сценариях разворачивания Celesta на заранее существующей базе данных - например, для работы системы Flute, если в её скриптах не планируется использовать классы Celesta для доступа к данным.

Нет true false
force.dbinitialize Заставляет систему при инициализации создавать системные объекты Celesta даже в том случае, если база данных не пустая (уже содержит таблицы).

Этот параметр категорически не рекомендуется включать, если вы не знаете твёрдо, чего хотите добиться, и рекомендуется выключать после того, как база данных будет проинициализирована один раз.

Этот параметр требуется при некоторых сценариях разворачивания Celesta на заранее существующей базе данных.

Нет true false
h2.in-memory Значение true заставляет Celesta использовать базу H2 в in-memory режиме. Параметры JDBC подключения при этом игнорируются. Режим необходим, прежде всего, для модульных тестов. Нет true false
h2.port Если указано целочисленное значение, и при этом h2.in-memory установлено в true, то база H2 запускается в виде сервера на указанном порту. Данный режим позволяет присоединяться к базе данных H2 внешним приложениям, читать и модифицировать данные. Параметры JDBC подключения при этом игнорируются. Этот режим необходим для UI и приёмочных автоматических тестов. Нет true false
h2.referential.integrity Использовать ли контроль ссылочной целостности (контроль Foreign Keys), работая с базой H2 в in-memory режиме (для всех других БД данный параметр игнорируется). По умолчанию при работе с H2 in-memory, ссылочная целостность отключается для упрощения создания модульных тестов. Нет true false

Замечание: При инициализации celesta в свойство score.path добавляется папка "general/score" с тем, что в ней могут храниться общесистемные гранулы для всех userdat.