Документация на documentation.lsfusion.org скоро станет недоступной, используйте, пожалуйста, https://docs.lsfusion.org/ru.
Этап | Windows | Linux | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Установка | Помимо установки lsFusion эти программы / скрипты установки также устанавливают OpenJDK, PostgreSQL и Tomcat. При этом Tomcat встраивается в установку lsFusion Client, а OpenJDK и PostgreSQL устанавливаются отдельно (в частности, в отдельные папки). | |||||||||||||||||||
Исполняемые exe файлы: lsFusion 4.1 Server & Client (+ OpenJDK 11.0.9, PostgreSQL 13.1(x64)/10.8(x32), Tomcat 9.0.21): В дальнейшем $INSTALL_DIR$ - папка, выбранная при установке lsFusion (по умолчанию Program Files/lsFusion <версия>). Также предполагается, что все параметры (порты, имя веб-контекста) оставлены равными по умолчанию. | Bash скрипты с использованием yum/apt (в качестве минорных версий используются последние стабильные): lsFusion 4 Server & Client (+ OpenJDK 11, PostgreSQL 13, Tomcat 9.0.21) :
| |||||||||||||||||||
После установки | Порты | После того как установка завершится, по умолчанию, на компьютере будут локально установлены и запущены в качестве служб:
| ||||||||||||||||||
Установка / обновление приложения | Для того чтобы загрузить разработанную логику на установленный сервер приложений (Server) необходимо: Поместить разработанные на языке lsFusion модули в виде файлов с расширением lsf в папку находящуюся в classpath сервера (значение по умолчанию при автоматической установке см. ниже). Кроме того туда необходимо поместить остальные файлы ресурсов (если они есть, например, файлы отчетов, скомпилированные Java файлы, картинки и т.п.). Допускается помещать эти файлы в подпапки classpath'а, а также внутри jar-файлов (zip-архивов с расширением jar). После того как все файлы скопированы, необходимо перезапустить сервер. Classpath сервера по умолчанию устанавливается равным $APP_DIR$;$APP_DIR$/*;server.jar, то есть папка $APP_DIR$ и все ее подпапки, все jar-файлы в папке $APP_DIR$ (но не в подпапках), а также jar-файл самого сервера приложений $APP_DIR$ при этом равен: | |||||||||||||||||||
$INSTALL_DIR$/lib | /var/lib/lsfusion Сервер приложений инсталлируется и запускается под автоматически создаваемым непривилегированным пользователем lsfusion, соответственно, файлы в этой папке должны быть доступны этому пользователю на чтение. | |||||||||||||||||||
Установка / обновление клиентов | Для того чтобы дать доступ пользователям к установленной системе необходимо: Отправить пользователям ссылку http://<сетевой адрес веб-сервера (Client)>:8080. При открытии этой ссылки, пользователь, по умолчанию, будет перенаправлен на страницу логина, где он, в свою очередь, при необходимости, может установить себе десктоп-клиент через Java Web Start, предварительно установив себе Java (JDK) (например, по этой ссылке с регистрацией или по этой - без). Обновление веб и десктоп-клиентов происходит автоматически вместе с обновлением веб-сервера (Client). Под Windows также можно воспользоваться программами установки десктоп клиента (файлы lsfusion-desktop-* с нужной версией и разрядностью ОС). Однако в отличие от установки при помощи Java Web Start, установленный таким образом десктоп-клиент не будет автоматически обновляться. Соответственно для его ручного обновления необходимо скачать файл новой версии десктоп клиента (lsfusion-client-4.<новая версия>.jar) с центрального сервера и заместить им файл $INSTALL_DIR$/client.jar | |||||||||||||||||||
Все пути и команды ниже приведены для мажорной версии платформы номер 4 (соответственно для других версий необходимо просто заменить 4 на нужное число, например lsfusion4-server → lsfusion11-server) | ||||||||||||||||||||
Все пути по умолчанию | Пути изменены (в частности при помощи symlink'ов) в соответствии с идеологией Linux | |||||||||||||||||||
Обновление | Программы устанавливаемые отдельно (OpenJDK, PostgreSQL) обновляются также отдельно (более подробная об этом процессе в документации к соответствующим программам) Компоненты платформы также обновляются отдельно друг от друга. Чтобы сделать это необходимо: | |||||||||||||||||||
Скачать файл новой версии компоненты с центрального сервера и заместить им следующий файл: | Выполнить команду: | |||||||||||||||||||
Сервер приложений (Server) | Файл на центральном сервере: lsfusion-server-4.<новая версия>.jar Замещаемый файл: $INSTALL_DIR$/Server/server.jar |
| ||||||||||||||||||
Веб-сервер (Client) | Файл на центральном сервере: lsfusion-client-4.<новая версия>.war Замещаемый файл: $INSTALL_DIR$/Client/webapps/ROOT.war Для обновления Tomcat, необходимо скачать архив с новой версией Tomcat и разархивировать его в папку $INSTALL_DIR$/Client без каталога webapps и файла параметров запуска |
| ||||||||||||||||||
Выборочная установка | Если какие-то из перечисленных в установке программ (компонент платформы) не надо устанавливать / уже установлены на вашем компьютере: | |||||||||||||||||||
Эти программы можно исключить в процессе установки при помощи соответствующего графического интерфейса. | Ниже приведены скрипты для установки отдельных компонент платформы: Сервер БД - PostgreSQL 11 :
Сервер приложений - lsFusion 4 Server (+ OpenJDK 1.8) :
Веб-сервер - lsFusion 4 Client (+ Tomcat 9.0.20) :
| |||||||||||||||||||
При установке компонент платформы на разные компьютеры необходимо дополнительно донастроить параметры их подключения друг к другу:
При установке под Windows вышеописанные параметры запрашиваются в процессе установки и файлы параметров настраиваются автоматически. | ||||||||||||||||||||
Ручная донастройка (пути к файлам, имена служб) | ||||||||||||||||||||
Сервер приложений (Server) : | ||||||||||||||||||||
вкладка Java в графическом интерфейсе $INSTALL_DIR/Server/bin/lsfusion4_serverw.exe
| параметр FUSION_OPTS в файле /etc/lsfusion4-server/lsfusion.conf
| |||||||||||||||||||
файл $INSTALL_DIR/Server/conf/settings.properties | файл /etc/lsfusion4-server/settings.properties | |||||||||||||||||||
Веб-сервер (Client) : | ||||||||||||||||||||
вкладка Java в графическом интерфейсе $INSTALL_DIR/Client/bin/lsfusion4_clientw.exe | параметр CATALINA_OPTS файла /etc/lsfusion4-client/lsfusion.conf | |||||||||||||||||||
файл $INSTALL_DIR/Client/conf/catalina/localhost/ROOT.xml | файл /etc/lsfusion4-client/catalina/localhost/ROOT.xml | |||||||||||||||||||
Десктоп-клиент: Java параметры задаются внутри тега j2se в jnlp файле | ||||||||||||||||||||
Перезапуск | Любые изменения, сделанные в параметрах запуска, а также изменение модулей lsFusion требуют перезапуска сервера (при изменении модулей lsFusion только сервера приложений (Server) ). Это можно сделать при помощи: Сервер приложений (Server) | |||||||||||||||||||
Графический интерфейс: Панель управления → Администрирование → Службы → lsFusion 4 Server или | ||||||||||||||||||||
Веб-сервер (Client) | ||||||||||||||||||||
Графический интерфейс: Панель управления → Администрирование → Службы → lsFusion 4 Client или | ||||||||||||||||||||
Логи платформы пишутся в следующие папки: Сервер приложений (Server) : | ||||||||||||||||||||
$INSTALL_DIR$/Server/logs | /var/log/lsfusion4-server | |||||||||||||||||||
Веб-сервер (Client) : | ||||||||||||||||||||
$INSTALL_DIR$/Client/logs | /var/log/lsfusion4-client | |||||||||||||||||||
Основные логи (в том числе процесс остановки и запуска сервера) находятся в:
Логи десктоп-клиента: $USER_DIR$/.fusion/logs, где $USER_DIR$ - папка пользователя: | ||||||||||||||||||||
Users/<имя пользователя> | /home/<имя пользователя> | |||||||||||||||||||
Локаль | Локаль, используемая платформой, определяется на основе локали установленной в операционной системе. При необходимости ее можно изменить при помощи: | |||||||||||||||||||
Графический интерфейс: Панель управления → Язык и региональные стандарты |