Skip to end of metadata
Go to start of metadata
ЭтапWindowsLinux
УстановкаПомимо установки lsFusion эти программы / скрипты установки также устанавливают OpenJDK, PostgreSQL и Tomcat. При этом Tomcat встраивается в установку lsFusion Client, а OpenJDK и PostgreSQL устанавливаются отдельно (в частности, в отдельные папки).

Исполняемые exe файлы:

lsFusion 2.0 Server & Client (+ OpenJDK 1.8.212, PostgreSQL 10.8, Tomcat 9.0.21) :

Разрядность ОСФайл
x32Скачать
x64Скачать

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

Bash скрипты с использованием yum/apt (в качестве минорных версий используются последние стабильные):

lsFusion 2 Server & Client (+ OpenJDK 1.8, PostgreSQL 11, Tomcat 9.0.21) : 

ОСКоманда / Скрипт
RHEL 7 / CentOS 7 / Fedora 29
Ubuntu 18 / Debian 9

source <(curl -s https://download.lsfusion.org/apt/install-lsfusion2)

PostgreSQL устанавливается версии 10, так как только он есть в репозитории


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

Порты

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

  • сервер БД (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

/var/lib/lsfusion

Сервер приложений инсталлируется и запускается под автоматически создаваемым непривилегированным пользователем lsfusion, соответственно, файлы в этой папке должны быть доступны этому пользователю на чтение. 

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

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

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

Обновление веб и десктоп-клиентов происходит автоматически вместе с обновлением веб-сервера (Client).

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


Все пути и команды ниже приведены для мажорной версии платформы номер 2 (соответственно для других версий необходимо просто заменить 2 на нужное число, например lsfusion2-server → lsfusion11-server)
Все пути по умолчаниюПути изменены (в частности при помощи symlink'ов) в соответствии с идеологией Linux
Обновление

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

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

Скачать файл новой версии компоненты с центрального сервера и заместить им следующий файл:

Выполнить команду:
Сервер приложений (Server)

Файл на центральном сервере: lsfusion-server-2.<новая версия>.jar

Замещаемый файл: $INSTALL_DIR$/Server/server.jar

ОСКоманда
RHEL 7 / CentOS 7 / Fedora 29
yum update lsfusion2_server
Ubuntu 18 / Debian 9
apt install lsfusion2_server

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

Файл на центральном сервере: lsfusion-client-2.<новая версия>.war

Замещаемый файл: $INSTALL_DIR$/Client/webapps/ROOT.war

Для обновления Tomcat, необходимо скачать архив с новой версией Tomcat и разархивировать его в папку $INSTALL_DIR$/Client без каталога webapps и файла параметров запуска

ОСКоманда
RHEL 7 / CentOS 7 / Fedora 29
yum update lsfusion2_client
Ubuntu 18 / Debian 9
apt install lsfusion2_client
Выборочная установка


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

Ниже приведены скрипты для установки отдельных компонент платформы:

Сервер БД - PostgreSQL 11 :

ОСКоманда / Скрипт
RHEL 7 / CentOS 7 / Fedora 29

source <(curl -s https://download.lsfusion.org/yum/install-lsfusion2-db)

Ubuntu 18 / Debian 9

source <(curl -s https://download.lsfusion.org/apt/install-lsfusion2-db)

PostgreSQL 10

Сервер приложений - lsFusion 2 Server (+ OpenJDK 1.8) : 

ОСКоманда / Скрипт
RHEL 7+ / CentOS 7+ / Fedora 29+source <(curl -s https://download.lsfusion.org/yum/install-lsfusion2-server)
Ubuntu 18 / Debian 9source <(curl -s https://download.lsfusion.org/apt/install-lsfusion2-server)

Веб-сервер - lsFusion 2 Client (+ Tomcat 9.0.20) : 

ОСКоманда / Скрипт
RHEL 7+ / CentOS 7+ / Fedora 29+source <(curl -s https://download.lsfusion.org/yum/install-lsfusion2-client)
Ubuntu 18 / Debian 9source <(curl -s https://download.lsfusion.org/apt/install-lsfusion2-client)

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

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

Сервера приложений к серверу БД

Файл lsFusion параметров запуска сервера приложений
Сервер приложений (Server) и веб-сервер (Client)

Веб-сервера к серверу приложений

Файл lsFusion параметров запуска веб-сервера

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

Ручная донастройка 

(пути к файлам, имена служб)

















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

Java 

вкладка Java в графическом интерфейсе $INSTALL_DIR/Server/bin/lsfusion2_serverw.exe

  • classpath - параметр Classpath в той же вкладке

параметр FUSION_OPTS в файле /etc/lsfusion2-server/lsfusion.conf

  • classpath : параметр CLASSPATH в том же файле

файл $INSTALL_DIR/Server/conf/settings.properties

файл /etc/lsfusion2-server/settings.properties

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

Java 

вкладка Java в графическом интерфейсе $INSTALL_DIR/Client/bin/lsfusion2_clientw.exe

параметр CATALINA_OPTS файла /etc/lsfusion2-client/lsfusion.conf

lsFusion 

файл $INSTALL_DIR/Client/conf/catalina/localhost/ROOT.xml

файл /etc/lsfusion2-client/catalina/localhost/ROOT.xml

Десктоп-клиент: Java параметры задаются внутри тега j2se в jnlp файле

Перезапуск 

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

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

Графический интерфейс:

Панель управления → Администрирование → Службы → lsFusion 2 Server

или

Команда
# Остановить сервер
$INSTALL_DIR/Server/bin/lsfusion2_server.exe //SS//lsfusion2_server

# Запустить сервер
$INSTALL_DIR/Server/bin/lsfusion2_server.exe //ES//lsfusion2_server
Команда
# Остановить сервер
systemctl stop lsfusion2-server

# Запустить сервер
systemctl start lsfusion2-server

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

Графический интерфейс:

Панель управления → Администрирование → Службы → lsFusion 2 Client

или

Команда
# Остановить сервер
$INSTALL_DIR/Client/bin/lsfusion2_client.exe //SS//lsfusion2_client

# Запустить сервер
$INSTALL_DIR/Client/bin/lsfusion2_client.exe //ES//lsfusion2_client
Команда
# Остановить клиент
systemctl stop lsfusion2-client

# Запустить клиент
systemctl start lsfusion2-client







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

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

$INSTALL_DIR$/Server/logs

/var/log/lsfusion2-server
Веб-сервер (Client) :
$INSTALL_DIR$/Client/logs/var/log/lsfusion2-client

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

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

Логи десктоп-клиента: $USER_DIR$/.fusion/logs, где $USER_DIR$ - папка пользователя:

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

Графический интерфейс:

Панель управления → Язык и региональные стандарты

Команда
localectl set-locale LANG=ru_RU.utf8
  • No labels