LoQR — различия между версиями

Материал из PayControl Wiki
Перейти к: навигация, поиск
Строка 53: Строка 53:
 
REDIS_HOST=redis-hostname
 
REDIS_HOST=redis-hostname
 
REDIS_DB=1</syntaxhighlight>
 
REDIS_DB=1</syntaxhighlight>
 +
# Указать в external/application.yml адрес самого LoQR External:
 +
#* <syntaxhighlight lang="yaml">
 +
  url: "http://loqr-ext-hostname:loqr-ext-port"
 +
</syntaxhighlight>
 
# Запустить инсталлятор
 
# Запустить инсталлятор
 
#* на сервере '''LoQR Internal''':<syntaxhighlight lang="bash">./install internal</syntaxhighlight>
 
#* на сервере '''LoQR Internal''':<syntaxhighlight lang="bash">./install internal</syntaxhighlight>
 
#* на сервере '''LoQR External''':<syntaxhighlight lang="bash">./install external</syntaxhighlight>
 
#* на сервере '''LoQR External''':<syntaxhighlight lang="bash">./install external</syntaxhighlight>
−
=Запуск и остановка служб сервера LoQR=
+
 
−
Запуск:
 
−
<syntaxhighlight lang="bash">
 
−
systemctl start pc-loqr-external
 
−
systemctl start pc-loqr-internal
 
−
</syntaxhighlight>
 
−
Остановка:
 
−
<syntaxhighlight lang="bash">
 
−
systemctl stop pc-loqr-external
 
−
systemctl stop pc-loqr-internal
 
−
</syntaxhighlight>
 
−
Перезапуск:
 
−
<syntaxhighlight lang="bash">
 
−
systemctl restart pc-loqr-external
 
−
systemctl restart pc-loqr-internal
 
−
</syntaxhighlight>
 
 
=Конфигурирование=
 
=Конфигурирование=
 
==Включение TLS==
 
==Включение TLS==
Строка 95: Строка 84:
 
         min-idle: 8
 
         min-idle: 8
 
</syntaxhighlight>
 
</syntaxhighlight>
−
==Настройка url==
 
−
Localhost не подходит для параметров LoQR.
 
−
 
−
Нужно использовать IP-адреса или DNS-имя.
 
  
−
Примеры:
 
−
===Internal===
 
−
<syntaxhighlight lang="yaml">
 
−
  url: "http://127.0.0.1:8098/"
 
−
  urlExternal: "http://127.0.0.1:8099"
 
−
</syntaxhighlight>
 
−
===External===
 
−
Нужно прописать в external/application.yml адрес самого LoQR External:
 
−
<syntaxhighlight lang="yaml">
 
−
  url: "http://127.0.0.1:8099"
 
−
</syntaxhighlight>
 
 
==Пример полной конфигурации==
 
==Пример полной конфигурации==
 
<syntaxhighlight lang="yaml">
 
<syntaxhighlight lang="yaml">
Строка 140: Строка 114:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
=Администрирование=
 
=Администрирование=
 +
==Запуск и остановка служб сервера LoQR==
 +
Запуск:
 +
<syntaxhighlight lang="bash">
 +
systemctl start pc-loqr-external
 +
systemctl start pc-loqr-internal
 +
</syntaxhighlight>
 +
Остановка:
 +
<syntaxhighlight lang="bash">
 +
systemctl stop pc-loqr-external
 +
systemctl stop pc-loqr-internal
 +
</syntaxhighlight>
 +
Перезапуск:
 +
<syntaxhighlight lang="bash">
 +
systemctl restart pc-loqr-external
 +
systemctl restart pc-loqr-internal
 +
</syntaxhighlight>
 
==Просмотр журналов==
 
==Просмотр журналов==
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">

Версия 22:59, 2 июля 2020

Инсталляция

  1. Установить на серверы LoQR Internal и LoQR External Java Runtime Environement (8/11).
  2. Создать БД Redis, доступную для LoQR Internal и LoQR External.
  3. Распаковать архив с инсталлятором.
  4. Разрешить запуск файла install.
  5. Скопировать конфигурационные файлы internal.conf.DEFAULT и external.conf.DEFAULT в файлы internal.conf и external.conf соответственно.
  6. В файлах internal.conf и external.conf указать необходимые конфигурационные параметры.
    • internal.conf 
      # Installator Params (NOT NEED TO MODIFY) - Параметры инсталлятора. Не стоит изменять при необходимости.
PC_MODULE=internal 
PC_TITLE="PC LoQR Internal"
PC_MODULE_FILENAME=loqr-1.0-25.jar

# PC LoQR Internal Params

## Self params - Протокол доступа, имя сервера LoQR Internal, порт, пользователь, под которым будет запускаться служба.
PC_URL=http://loqr-int-hostname
PC_PORT=8098
PC_USER=pc_user

## Another components addressation - Расположение прочих компонентов

### PC LoQR External
PC_LOQR_EXT_URI=http://loqr-ext-hostname:8099

### PC Server
PC_SERVER_URI=https://pc-server-hostname/pc-api/

### Redis
REDIS_PORT=6379
REDIS_HOST=redis-hostname
REDIS_DB=1
    • external.conf 
      # Installator Params (NOT NEED TO MODIFY)
PC_MODULE=external
PC_TITLE="PC LoQR External"
PC_MODULE_FILENAME=loqr-external-1.0-25.jar


# PC LoQR External Params

## Self params
PC_URL=http://loqr-ext-hostname
PC_PORT=8099
PC_USER=pc_user
PC_QR_LOGO=logo.png

## Another components addressation

### PC LoQR Internal
PC_LOQR_INT_URI=http://loqr-int-hostname:8098

### Redis
REDIS_PORT=6379
REDIS_HOST=redis-hostname
REDIS_DB=1
  7. Указать в external/application.yml адрес самого LoQR External: 
    •   url: "http://loqr-ext-hostname:loqr-ext-port"
  8. Запустить инсталлятор
    • на сервере LoQR Internal:
      ./install internal
    • на сервере LoQR External:
      ./install external

Конфигурирование

Включение TLS

Чтобы включить TLS необходимо в конфигурационном файле application.yml LoQR External в секцию server добавить записи: 

  ssl:
    key-store-type: PKCS12
    key-store: <path-to-pkcs-12-file>
    key-store-password: <pkcs-12 password>
    key-alias: <key-alias>

Аутентификация в Redis

Для аутентификации по паролю в Redis необходимо его указать в параметрах подключения, в поле password: 

spring:
  redis:
    host: redis.example.com
    port: 6379
    database: 1
    password: pass
    lettuce:
      pool:
        min-idle: 8

Пример полной конфигурации

server:
  port: 8099
  address: 0.0.0.0
  ssl:
    key-store-type: PKCS12
    key-store: /media/keystore/examcont.p12
    key-store-password: 874814
    key-alias: examplecont
loqrExternal:
  url: "http://loqr.example.com:8099"
  loqr: "http://loqr.example.com:8098"
  logoQRPath: "/opt/loq/logo_.png"
  logoOn: true
  timeoutInSecond:
    QR: 120
    session: 600
spring:
  redis:
    host: redis.example.com
    port: 6379
    database: 1
    password: pass
    lettuce:
      pool:
        min-idle: 8

Администрирование

Запуск и остановка служб сервера LoQR

Запуск: 

systemctl start pc-loqr-external
systemctl start pc-loqr-internal

Остановка: 

systemctl stop pc-loqr-external
systemctl stop pc-loqr-internal

Перезапуск: 

systemctl restart pc-loqr-external
systemctl restart pc-loqr-internal

Просмотр журналов

journalctl -u pc-loqr-external
journalctl -u pc-loqr-internal
Источник — «https://repo.paycontrol.org/wiki/index.php?title=LoQR&oldid=366»