Перейти к основному содержимому
Версия: 5.x

Для промышленной эксплуатации

Установка​

Помимо установки lsFusion эти программы / скрипты установки также устанавливают OpenJDK, PostgreSQL и Tomcat. При этом Tomcat встраивается в установку lsFusion Client, а OpenJDK и PostgreSQL устанавливаются отдельно (в частности, в отдельные папки).

Исполняемые exe файлы: lsFusion 5.1 (OpenJDK 11.0.16, PostgreSQL 15.1, Tomcat 9.0.67, IntelliJ IDEA Community Edition 2022.3.1)

  • x64

  • Предыдущие версии
    • lsFusion 5.0 Server & Client
    • lsFusion 4.1 Server & Client
    • lsFusion 3.1 Server & Client
    • lsFusion 2.4 Server & Client

В дальнейшем $INSTALL_DIR$ - папка, выбранная при установке lsFusion (по умолчанию Program Files/lsFusion <версия>). Также предполагается, что все параметры (порты, имя веб-контекста) оставлены равными по умолчанию.

После установки​

Порты​

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

  • сервер БД (PostgreSQL) на порту 5432
  • сервер приложений (Server) на порту 7652
  • веб-сервер (Client) на порту 8080

Установка / обновление приложения​

Для того чтобы загрузить разработанную логику на установленный сервер приложений (Server) необходимо:

Поместить разработанные на языке lsFusion модули в виде файлов с расширением lsf в папку находящуюся в classpath сервера (значение по умолчанию при автоматической установке см. ниже). Кроме того туда необходимо поместить остальные файлы ресурсов (если они есть, например, файлы отчетов, скомпилированные Java файлы, картинки и т.п.). Допускается помещать эти файлы в подпапки classpath'а, а также внутри jar-файлов (zip-архивов с расширением jar). После того как все файлы скопированы, необходимо перезапустить сервер.

к сведению

Часто бывает удобно поставлять все файлы проекта внутри одного jar-файла. Для того чтобы сформировать такой файл автоматически, можно использовать Maven (с профилями assemble и noserver) или средства сборки, встроенные в IDE.

Classpath сервера по умолчанию устанавливается равным $APP_DIR$;$APP_DIR$/*;server.jar, то есть папка $APP_DIR$ и все ее подпапки, все jar-файлы в папке $APP_DIR$ (но не в подпапках), а также jar-файл самого сервера приложений.

$APP_DIR$ при этом равен $INSTALL_DIR$/lib

Установка / обновление клиентов​

Для того чтобы дать доступ пользователям к установленной системе необходимо:

Отправить пользователям ссылку http://<сетевой адрес веб-сервера (Client)>:8080. При открытии этой ссылки, пользователь, по умолчанию, будет перенаправлен на страницу логина, где он, в свою очередь, при необходимости, может установить себе десктоп-клиент через Java Web Start, предварительно установив себе Java (JDK) (например, по этой ссылке с регистрацией или по этой - без). Обновление веб и десктоп-клиентов происходит автоматически вместе с обновлением веб-сервера (Client).

к сведению

Под Windows также можно воспользоваться программами установки десктоп клиента (файлы lsfusion-desktop-* с нужной версией и разрядностью ОС). Однако в отличие от установки при помощи Java Web Start, установленный таким образом десктоп-клиент не будет автоматически обновляться. Соответственно для его ручного обновления необходимо скачать файл новой версии десктоп клиента (lsfusion-client-5.<новая версия>.jar) с центрального сервера и заместить им файл $INSTALL_DIR$/client.jar.

warning

Все пути и команды ниже приведены для мажорной версии платформы номер 5 (соответственно для других версий необходимо просто заменить 5 на нужное число, например lsfusion5-server → lsfusion11-server)

Все пути по умолчанию

Обновление​

Программы устанавливаемые отдельно (OpenJDK, PostgreSQL) обновляются также отдельно (более подробная об этом процессе в документации к соответствующим программам).

Компоненты платформы также обновляются отдельно друг от друга. Чтобы сделать это, необходимо cкачать файл новой версии компоненты с центрального сервера и заместить им следующий файл:

КомпонентФайлы
Сервер приложений (Server)Файл на центральном сервере: lsfusion-server-5.<новая версия>.jar
Замещаемый файл: $INSTALL_DIR$/Server/server.jar
Веб-сервер (Client)Файл на центральном сервере: lsfusion-client-5.<новая версия>.war
Замещаемый файл: $INSTALL_DIR$/Client/webapps/ROOT.war
Для обновления Tomcat, необходимо скачать архив с новой версией Tomcat и разархивировать его в папку $INSTALL_DIR$/Client без каталога webapps и файла параметров запуска

Выборочная установка​

Если какие-то из перечисленных в установке программ (компонент платформы) не надо устанавливать / уже установлены на вашем компьютере:

Эти программы можно исключить в процессе установки при помощи соответствующего графического интерфейса.

При установке компонент платформы на разные компьютеры необходимо дополнительно донастроить параметры их подключения друг к другу:

Компоненты на разных компьютерахПараметры подключенияНастраиваемый файл
Сервер БД и сервер приложений (Server)Сервера приложений к серверу БДФайл lsFusion параметров запуска сервера приложений
Сервер приложений (Server) и веб-сервер (Client)Веб-сервера к серверу приложенийФайл lsFusion параметров запуска веб-сервера
к сведению

При установке под Windows вышеописанные параметры запрашиваются в процессе установки и файлы параметров настраиваются автоматически.

Ручная донастройка (пути к файлам, имена служб)​

Параметры запуска​

Компонентjavalsfusion
Сервер приложений (Server)вкладка Java в графическом интерфейсе $INSTALL_DIR/Server/bin/lsfusion5_serverw.exe
classpath - параметр Classpath в той же вкладке		файл $INSTALL_DIR/Server/conf/settings.properties
Веб-сервер (Client)вкладка Java в графическом интерфейсе $INSTALL_DIR/Client/bin/lsfusion5_serverw.exeфайл $INSTALL_DIR/Client/conf/catalina/localhost/ROOT.xml
Десктоп-клиентJava параметры задаются внутри тега j2se в jnlp файле.

Перезапуск​

Любые изменения, сделанные в параметрах запуска, а также изменение модулей lsFusion требуют перезапуска сервера (при изменении модулей lsFusion только сервера приложений (Server)). Это можно сделать при помощи:

Сервер приложений (Server)​

Графический интерфейс
Панель управления > Администрирование > Службы > lsFusion 5 Server
Команда
# Остановить сервер
$INSTALL_DIR/Server/bin/lsfusion5_server.exe //SS//lsfusion5_server
 
# Запустить сервер
$INSTALL_DIR/Server/bin/lsfusion5_server.exe //ES//lsfusion5_server

Веб-сервер (Client)​

GUI
Панель управления > Администрирование > Службы > lsFusion 5 Client
Команда
# Остановить клиент
$INSTALL_DIR/Client/bin/lsfusion5_client.exe //SS//lsfusion5_client
 
# Запустить клиент
$INSTALL_DIR/Client/bin/lsfusion5_client.exe //ES//lsfusion5_client

Логи​

Логи платформы пишутся в следующие папки:

КомпонентFolder
Сервер приложений (Server)$INSTALL_DIR$/Server/logs
Веб-сервер (Client)$INSTALL_DIR$/Client/logs
Десктоп-клиентUsers/<имя пользователя>/.fusion/logs

Основные логи (в том числе процесс остановки и запуска сервера) находятся в:

  • Сервер приложений (Server) - stdout
  • Веб-сервера (Client) - catalina.out (так как веб-сервер запускается на базе Tomcat).

Локаль​

Локаль, используемая платформой, определяется на основе локали установленной в операционной системе. При необходимости ее можно изменить при помощи:

Графический интерфейс
Панель управления > Язык и региональные стандарты