Выполнение (ручная)

к сведению

Для установки сервера приложений, веб-сервера и клиента на компьютере должна быть предварительно установлена Java версии не ниже 8.

к сведению

Для работы сервера приложений должен быть открыт доступ к серверу управления базами данных PostgreSQL версии не ниже 9.6. PostgreSQL сервер должен принимать подключения, используя авторизацию по паролю методом md5 или trust. Настроить авторизацию можно, отредактировав файл pg_hba.conf, как это описано в документации PostgreSQL.

Установка сервера приложений в качестве сервиса

• Скачать файл lsfusion-server-<version>.jar нужной версии (например lsfusion-server-4.1.jar) с центрального сервера в некоторую папку (далее будем называть эту папку $FUSION_DIR$).

• Если сервер БД находится на другом компьютере, а также если на сервере БД включена авторизация (например, для Postgres, по методу md5 и пароль postgres не пустой), задать параметры подключения к серверу БД (например, создав файл настроек запуска в папке $FUSION_DIR$)

• Поместить разработанные на языке lsFusion модули в виде файлов с расширением lsf в папку $FUSION_DIR$ (или в любую подпапку). Кроме того туда необходимо поместить остальные файлы ресурсов (если они есть, например, файлы отчетов, скомпилированные Java файлы, картинки и т.п.).

• Создать службу в операционной системе (например, при помощи Apache Commons Daemon), при этом в качестве рабочего директория необходимо использовать папку $FUSION_DIR$, а в качестве команды запуска - следующую строку:

  • Linux

    bash

    java -cp ".:lsfusion-server-4.1.jar" lsfusion.server.logics.BusinessLogicsBootstrap
    Пример скрипта для запуска службы в CentOS

    [Unit]
    Description=lsFusion
    After=network.target
    
    [Service]
    Type=forking
    Environment="PID_FILE=/usr/lsfusion/jsvc-lsfusion.pid"
    Environment="JAVA_HOME=/usr/java/latest"
    Environment="LSFUSION_HOME=/usr/lsfusion"
    Environment="LSFUSION_OPTS=-Xms1g -Xmx4g"
    Environment="CLASSPATH=.:lsfusion-server-4.1.jar"
    
    ExecStart=/usr/bin/jsvc \
            -home $JAVA_HOME \
            -jvm server \
            -cwd $LSFUSION_HOME \
            -pidfile $PID_FILE \
            -outfile ${LSFUSION_HOME}/logs/stdout.log \
            -errfile ${LSFUSION_HOME}/logs/stderr.log \
            -cp ${LSFUSION_HOME}/${CLASSPATH} \
            $LSFUSION_OPTS \
            lsfusion.server.logics.BusinessLogicsBootstrap
    
    ExecStop=/usr/bin/jsvc \
            -home $JAVA_HOME \
            -stop \
            -pidfile $PID_FILE \
            lsfusion.server.logics.BusinessLogicsBootstrap
    
    [Install]
    WantedBy=multi-user.target

  • Windows

    cmd

    java -cp ".;lsfusion-server-4.1.jar" lsfusion.server.logics.BusinessLogicsBootstrap

Установка веб-сервера (веб и десктоп-клиента) в качестве сервиса

к сведению

Для установки веб-сервера на компьютере должен быть установлен Apache Tomcat не ниже 8 версии.

• Скачать файл lsfusion-client-<version>.war нужной версии с центрального сервера. Например, lsfusion-client-4.1.war.
• Если сервер приложений находится на другом компьютере, а также если параметры доступа к серверу приложений отличается от стандартных, задать параметры подключения к серверу приложений (например, создав / отредактировав файл настроек Tomcat)
• Развернуть приложение на Tomcat. Наиболее простой способ - скопировать в папку webapps Tomcat. В этом случае файл можно сначала переименовать (например, в lsfusion.war), так как имя файла будет соответствовать контекстному пути, по которому будет доступно приложение. Если Tomcat использует порт 8080, то веб-клиент будет доступен по адресу: http://localhost:8080/<имя war-файла>. Например, http://localhost:8080/lsfusion. Пустое имя контекста в Tomcat соответствует имени ROOT, то есть если имя файла - ROOT.war, то веб-клиент будет доступен по ссылке http://localhost:8080/. Десктоп-клиента можно скачать на странице авторизации по ссылке Run Desktop Client (через Java Web Start).

Установка только десктоп-клиента (на компьютере клиента)

• Скачать файл lsfusion-client-<version>.jar нужной версии с центрального сервера. Например, lsfusion-client-4.1.jar

• Создать ярлык на рабочем столе, при этом в качестве рабочего директория необходимо использовать директорий, в котором находится скачанный jar-файл клиента, а в качестве команды запуска - следующую строку:

  • bash

    java -jar lsfusion-client-4.1.jar

к сведению

Для установки десктоп-клиента можно также использовать метод установки десктоп-клиента для разработки. Для этого достаточно скачать файл lsfusion-client-<version>.jnlp нужной версии с центрального сервера, после чего запустить его локально на клиенте. Такой способ является более быстрым и удобным, но менее гибким.

к сведению

Последние версии, которые сейчас находятся в разработке (snapshot), можно скачать непосредственно из maven репозитария https://repo.lsfusion.org. Например для сервера полный путь выглядит следующим образом: https://repo.lsfusion.org/nexus/service/rest/repository/browse/public/lsfusion/platform/server/ (для сервера и десктоп-клиента нужно скачивать jar файлы с постфиксом -assembly)