mbadmin

Модуль для работы с биллингом, состоит из backend (логика) и frontend (интерфейс) частей

Файловая структура модуля

/var/bill
├── mbadmin
│   ├── chroot
│   │   ├── production
│   │   │   ├── bin -> usr/bin
│   │   │   ├── dev
│   │   │   ├── etc
│   │   │   ├── home
│   │   │   ├── lib -> usr/lib
│   │   │   ├── lib64 -> usr/lib64
│   │   │   ├── root
│   │   │   ├── sbin -> usr/sbin
│   │   │   ├── tmp
│   │   │   ├── usr
│   │   │   └── var
│   │   │       ├── bill
│   │   │       │   ├── config -> /var/bill/mbadmin/production/config
│   │   │       │   └── logs -> /var/bill/logs/mbadmin
│   │   │       ├── lib
│   │   │       │   └── php
│   │   │       │       └── session
│   │   │       ├── log
│   │   │       │   └── php-fpm
│   │   │       └── www
│   │   │           └── mbadmin
│   │   │               ├── cache.appcache
│   │   │               ├── classic.json
│   │   │               ├── classic.jsonp
│   │   │               ├── index.html
│   │   │               ├── index.php
│   │   │               ├── MBPlatform
│   │   │               │   └── ..
│   │   │               ├── modern.json
│   │   │               └── modern.jsonp
│   │   └── testing
│   │       ├── bin -> usr/bin
│   │       ├── dev
│   │       ├── etc
│   │       ├── home
│   │       ├── lib -> usr/lib
│   │       ├── lib64 -> usr/lib64
│   │       ├── root
│   │       ├── sbin -> usr/sbin
│   │       ├── tmp
│   │       ├── usr
│   │       └── var
│   │           ├── bill
│   │           │   ├── config -> /var/bill/mbadmin/testing/config
│   │           │   └── logs -> /var/bill/logs/mbadmin
│   │           ├── lib
│   │           │   └── php
│   │           │       └── session
│   │           ├── log
│   │           │   └── php-fpm
│   │           └── www
│   │               └── mbadmin
│   │                   ├── cache.appcache
│   │                   ├── classic.json
│   │                   ├── classic.jsonp
│   │                   ├── index.html
│   │                   ├── index.php
│   │                   ├── MBPlatform
│   │                   │   └── ..
│   │                   ├── modern.json
│   │                   └── modern.jsonp
│   ├── production
│   │   ├── add_to_chroot.sh
│   │   ├── config
│   │   │   └── config.xml
│   │   ├── public
│   │   │   ├── cache.appcache
│   │   │   ├── classic.json
│   │   │   ├── classic.jsonp
│   │   │   ├── index.html
│   │   │   ├── index.php
│   │   │   ├── MBPlatform
│   │   │   │       └── ..
│   │   │   ├── modern.json
│   │   │   └── modern.jsonp
│   │   └── updates
│   │       ├── mbadmin_backend_update.sh
│   │       ├── mbadmin.current.checksum
│   │       ├── mbadmin.downloaded.checksum
│   │       ├── mbadmin_frontend_update.sh
│   │       ├── mbfront.current.checksum
│   │       └── mbfront.downloaded.checksum
│   └── testing
│       ├── add_to_chroot.sh
│       ├── config
│       │   └── config.xml
│       ├── public
│       │   ├── cache.appcache
│       │   ├── classic.json
│       │   ├── classic.jsonp
│       │   ├── index.html
│       │   ├── index.php
│       │   ├── MBPlatform
│       │   │       └── ..
│       │   ├── modern.json
│       │   └── modern.jsonp
│       └── updates
│           ├── mbadmin_backend_testing.sh
│           ├── mbadmin.current.checksum
│           ├── mbadmin.downloaded.checksum
│           ├── mbadmin_frontend_testing.sh
│           ├── mbfront.current.checksum
│           └── mbfront.downloaded.checksum
├── logs
│   ├── mbadmin
│   │   ├── mbadmin.debug
│   │   ├── mbadmin.log
│   │   └── update.log

Описание директорий и файлов

chroot среда модуля

файл/директория

описание

/var/bill/mbadmin/chroot/<version>

корневая директория chroot среды

chroot/<version>/var/bill/config

примонтированная директория системы /var/bill/mbadmin/<version>/config

chroot/<version>/var/bill/logs

примонтированная директория системы /var/bill/logs/mbadmin

chroot/<version>/var/www/mbadmin

примонтированная директория системы /var/bill/mbadmin/<version>/public

/var/bill/mbadmin/<version>/add_to_chroot.sh

скрипт для добавления программ в изолированную chroot среду
модуль mbadmin

файл/директория

описание

/var/bill/mbadmin

домашняя директория модуля

/var/bill/mbadmin/production

production версия модуля

/var/bill/mbadmin/testing

testing версия модуля

/var/bill/backup/mbadmin

директория для бекапов

<version>/config/config.xml

файл конфига модуля

<version>/public

WWW директория модуля (подключается в chroot среду)

<version>/public/index.php

файл с кодом backend части модуля

<version>/public/index.html

файл с кодом frontend части модуля

<version>/public/MBPlatform

директория frontend модуля

<version>/public/cache.appcache

манифест кеша frontend

<version>/public/classic.json

файл с внутренней конфигурацией frontend

<version>/public/classic.jsonp

файл с внутренней конфигурацией frontend

<version>/updates

директория с файлами обновления

<version>/updates/mbadmin_backend_update.sh

загрузчик и установщик обновлений backend части модуля

<version>/updates/mbadmin_frontend_update.sh

загрузчик и установщик обновлений frontend части модуля

<version>/updates/mbadmin.current.checksum

файл с md5 суммой текущей версии обновлений backend части модуля

<version>/updates/mbadmin.downloaded.checksum

файл с md5 суммой загруженной версии обновлений backend части модуля

<version>/updates/mbfront.current.checksum

файл с md5 суммой текущей версии обновлений frontend части модуля

<version>/updates/mbfront.downloaded.checksum

файл с md5 суммой загруженной версии обновлений frontend части модуля

/var/bill/logs/mbadmin

директория логов модуля

/var/bill/logs/mbadmin/mbadmin.log

основной лог модуля

/var/bill/logs/mbadmin/mbadmin.debug

debug лог модуля

/var/bill/logs/mbadmin/update.log

лог обновлений модуля

Файл конфигурации

Файл расположен по пути /var/bill/mbadmin/<version>/config/config.xml

<config>
  <parameters>
    <mysql>
      <host>DATABASE_IP</host>
      <username>DATABASE_USER</username>
      <password>DATABASE_PASSWORD</password>
      <dbname>DATABASE_NAME</dbname>
    </mysql>
    <siteName>Multi-BiLLing</siteName>
    <timezone>Europe/Kiev</timezone>
    <partialUTF8>false</partialUTF8>
    <debug>false</debug>
    <error_log>/var/bill/logs/mbadmin.log</error_log>
    <debug_log>/var/bill/logs/mbadmin.debug</debug_log>
  </parameters>
</config>

параметр

описание

mysql секция

host

IP адрес базы данных

username

имя пользователя для подключения к базе данных

password

пароль пользователя

dbname

название базы данных биллинга

siteName

Название вкладки при работе в админке

timezone

Временная зона

partialUTF8

Частичное использование UTF8

debug

режим дебага, значения true/false

debug_log

лог файл куда будет записана информация из дебага

error_log

освнойно файл лога

Загрузщик обновлений

Варианты запуска файла /var/bill/mbadmin/<version>/updates/mbadmin_backend_update.sh

Ключ

Описание

Обычный запуск без параметров, скачает последнюю доступную версию обновления

-f

Режим принудительного повторного обновления (игнорирует md5 проверку)

-t

Произвести загрузку testing версии обновления

Варианты запуска файла /var/bill/mbadmin/<version>/updates/mbadmin_frontend_update.sh

Ключ

Описание

Обычный запуск без параметров, скачает последнюю доступную версию обновления

-f

Режим принудительного повторного обновления (игнорирует md5 проверку)

-t

Произвести загрузку testing версии обновления

Задания cron

  • Файл с заданиями модуля расположен по пути /etc/cron.d/mbadmin и содержит задания

    • запуск обновления production backend версии модуля

    • запуск обновления production frontend версии модуля

# For details see man 4 crontabs

# Example of job definition:
# .---------------- minute (0 - 59)
# |  .------------- hour (0 - 23)
# |  |  .---------- day of month (1 - 31)
# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
# |  |  |  |  |
# *  *  *  *  * user-name  command to be executed

# update
05 6 * * * root /var/bill/mbadmin/production/updates/mbadmin_backend_update.sh
05 6 * * * root /var/bill/mbadmin/production/updates/mbadmin_frontend_update.sh

При возникновении проблем, сообщите о них в нашем CRM или Telegram канале.