Установка Wildfly

При установке далее мы рекомендуем указывать JAVA_HOME вручную в standalone.conf, чтобы, если у вас есть установленная JRE/JDK из репозитария, неожиданно для вас не поменялась используемая версия Java. Однако это не касается запуска некоторых команд, требуемых при установке личного кабинета. Для таких команд может использоваться JRE/JDK по умолчанию, установленную из репозитария; или же Вы можете прописать JAVA_HOME глобально, в /etc/environment или в ~/.bashrc.

...

1. Создайте нового пользователя в BGBillingServer, в поле "Полное имя" укажите Пользователь (как ранее помечались действия абонента), в поле "Описание" укажите "Личный кабинет". Придумайте сложные логин и пароль, разрешите все действия.

2. Скачайте с ftp://bgbilling.ru MyBGBilling.war соответствующий версии биллинга, например, в папку /opt. Распакуйте архив, оставив имя директории, содержащее файлы архива MyBGBilling.war и поместите эту папку в /opt/wildfly/standalone/deployments:
   

   Блок кода
   language bash
   unzip ./MyBGBilling.war -d /opt/wildfly/standalone/deployments/MyBGBilling.war && rm -f MyBGBilling.war

3. Поменяйте владельца у директории MyBGBilling.war

   Блок кода
   language bash
   chown -R wildfly:wildfly /opt/wildfly/standalone/deployments/MyBGBilling.war

4. Скопируйте содержимое директории MyBGBilling.war/WEB-INF/script/files в /opt/wildfly/bin:

   Блок кода
   language bash
   cp /opt/wildfly/standalone/deployments/MyBGBilling.war/WEB-INF/script/files/*.* /opt/wildfly/bin

5. Отредактируйте файл /opt/wildfly/bin/setenv.sh, укажите правильный путь к JDK в переменной JAVA_HOME.

6. Если у вас нет значения JAVA_HOME по умолчанию, то отредактируйте jboss-cli.sh и укажите там путь к JAVA_HOME (иначе следующая команда не будет выполнена):

   Блок кода
   language bash
   #!/bin/sh   JAVA_HOME="/opt/java/jdk" CLI_OPTS=""

7. Выполните команду для добавления security-domain в Wildfly, который будет использовать ЛК.

   Блок кода
   language bash
   ./jboss-cli.sh --connect --file=/opt/wildfly/standalone/deployments/MyBGBilling.war/WEB-INF/defaults/configure-security-domain.cli

   Примечание
   Если вы изменяли port-offset, то также изменился порт web-консоли Wildfly, значение по умолчанию которого 9990. В этом случае перед выполнением данной команды нужно редактировать файл jboss-cli.xml, поменяв значение <port>9990</port> на новое.

8. Скопируйте файлы конфигурации из MyBGBilling.war/WEB-INF/defaults в MyBGBilling.war/WEB-INF:

   Блок кода
   language bash
   cp /opt/wildfly/standalone/deployments/MyBGBilling.war/WEB-INF/defaults/*.groovy /opt/wildfly/standalone/deployments/MyBGBilling.war/WEB-INF

9. Отредактируйте MyBGBilling.war/WEB-INF/mybgbilling-conf.groovy, укажите параметры подключения к BGBillingServer

   Блок кода
   language bash
   // Параметры подключения к BGBillingServer. // ЛК является пользователем биллинга, общается с ним также, как BGBillingClient bgbilling { // URL доступа к BGBilling url = 'http://127.0.0.1:8080/bgbilling/executer' // Логин user = 'customer' // Пароль password = 'customer' }

10. Запустите синхронизацию клиентских библиотек биллинга

    Блок кода
    language bash
    /opt/wildfly/bin/mybgbilling-sync-libs.sh

Рекомендация для reverse-proxy (Nginx)

Если вы используется reverse-proxy (например, Nginx) и на нём настроен HTTPS, а reverse-proxy работает с Wildfly по HTTP, то в некоторых случаях нужно, чтобы Wildfly знал, что абонент на самом деле использует HTTPS (например, это может быть нужно при отправке редиректа от Wildfly). Для этого рекомендуется внести такие настройки:

1. Указать в reverse-proxy добавление заголовка X-Forwarded-Proto:

   Блок кода
   language bash
   proxy_set_header X-Forwarded-Proto $scheme;

2. Указать Wildfly, чтобы он обрабатывал такой заголовок. Для этого в standalone.xml в элементе http-listener нужно добавить proxy-address-forwarding="true":

   Блок кода
   language xml
   <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" proxy-address-forwarding="true"/>