...
- На клиентском компьютере должна быть установлена виртуальаная машина Java (JRE)
- Загрузить архив с BGClientRunner на клиентский компьютер (например отсюда ftp://ftp.bgbilling.ru/pub/bgbilling/7.2/)
- Распаковать архив в домашнем каталоге пользователя или на сетевом диске если клиент будет запускать несколько пользователей.
- Убедиться, что установлена и корректно настроена системная переменная JAVA_HOME
- При необходимости настроить адреса сервера(ов) биллинга по умолчанию, которые будут использоваться при запуске BGClientRunner. Доступно несколько способов задания списка доступных серверов:
- в файле config.json из архива BGClientRunner
- на локальном сервере, при запуске BGClientRunner пытается загрузить список серверов с сайта http://billing.local/servers.json (пример файла config_http.json см. архиве BGClientRunner). Адрес сайта и имя файла могут быть заданы в файле config.json, парметр "configURL" : "none". Значение "none" отключает загрузку с сайта.
- ручной ввод данных сервера в интерфейсе BGClientRunner.
- Запустить BGClientRunner с помощью скрптов запуска runner.sh(Linux) или runner_w2k.bat(Windows)
Выбрать неодходимый необходимый сервер, ввести ни необходимсти необходимости логин и пароль и Войти на сервер.
Примечание title Внимание При установке базы биллинга в ней создаётся единственный пользователь admin c паролем admin. После первого входа желательно поменять пароль в целях безопасности.
...
После запуска BGClientRunner, выбора сервера, и ввода логина и пароля, BGClientRunner обращается к серверу биллинга за списком библиотек необходимых для запуска клиента биллинга. Сервер возращает список библиотек и их контрольные суммы. BGClientRunner проверяет наличие запрашиваемых библиотек в локальном кеше клиента (в домашнем каталоге пользователя, каталог ./bgbilling/libs). Отсутствующие библиотеки или отличающиеся по контрольной сумме, загружаются с сервера и сохраняются в кешекэше. При наличие в кеше всех необходимых библиотек, BGClientRunner запускает клиент биллинга в виде отдельно java процесса. Кроме списка библиотек, с сервера загружает контрольная сумма всех библиотек, которая передается клиенту биллинга при запуске и используется в процессе работы клиента для контроля совпадения версии клиента и сервера, в случае обновления сервера, его контрольная сумма меняется и в клиенте выводится сообщение о необходимости перезапуска (обновления) клиента.
...
В BGClientRunner встроен механизм очистки кеша кэша от редко используемых библиотек. По умолчанию библиотеки не использованные для запуска клиента более 15 дней удаляются из кеша. Данный срок может быть изменен с помощью ключа запуска -Dbg.client.runner.cache.period=15. Дата последнего использования библиотеки хранится, в домашнем каталоге пользователя, в файле ./bgbilling/cache.json
...
- Сервер биллинга не поддерживает данный способ запуска, необходимо обновить сервер до более поздних версий
- Сервер биллинга находится например за nginx, на котором не настроен доступ к сервлету http://host[:port]/[bgbilling/]clientUpdate/*
- Если подключаетесь к только что . установленному серверу биллинга, необходимо выполнить процедуру обновления сервера (загрузить в каталог сервера архив, например https://bgbilling.ru/v7.2/download/kernel/update_7.2.zip, после чего на остановленном сервере запустить скрипт "./bg_installer.sh update_7.2.zip")
...