Установка системы WMS

Установка

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

Windows

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

lsFusion 4.1 Server & Client (+ OpenJDK 11.0.9, PostgreSQL 13.1(x64)/10.8(x32), Tomcat 9.0.21):

• x32

• x64

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

Linux

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

lsFusion 4 Server & Client (+ OpenJDK 1.8, PostgreSQL 13, Tomcat 9.0.21):

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

Порты

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

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

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

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

$APP_DIR$ при этом равен: 

• Windows  - $INSTALL_DIR$/lib
• Linux - /var/lib/lsfusion . Сервер приложений инсталлируется и запускается под автоматически создаваемым непривилегированным пользователем lsfusion, соответственно, файлы в этой папке должны быть доступны этому пользователю на чтение.

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

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

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

Обновление

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

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

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

• Linux - выполнить подходящую команду:

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

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

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

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

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

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

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

Здесь приводятся пути к файлам и названия служб, параметры которых могут требовать донастройки. Непосредственно параметры запуска сервера приложений и веб-сервера подробно описаны в Приложении 1.

• Windows

• Linux 

Перезапуск

Любые изменения, сделанные в параметрах запуска, а также изменение модулей lsFusion требуют перезапуска сервера (при изменении модулей lsFusion только сервера приложений (Server)). Перезапуск под Windows можно запустить как из графического интерфейса, так и из  командной строки. 

• Windows 

• Linux

Логи

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

• Windows

• Linux

Основные логи (в том числе процесс остановки и запуска сервера) находятся в файлах stdout (сервер приложений) и catalina.out (веб-сервер, т.к. он запускается на базе Tomcat)