С версии 7.10+ (в сборках от 15 января 01 декабря 2019 и позднее) доступен новый способ запуска клиента биллинга BGBilling Runner. Данный вариант является рекомендуемым способом запуска клиента биллинга.
...
- На клиентском компьютере должна быть установлена виртуальаная машина Java (JRE)
- Загрузить архив с BGBilling Runner на клиентский компьютер (например отсюда ftphttps://ftp.bgbilling.ru/pubdownload/bgbilling/runner/)
- Распаковать архив в домашнем каталоге пользователя или на сетевом диске если клиент будет будут запускать несколько пользователей.
- Убедиться, что установлена и корректно настроена системная переменная JAVA_HOME
- При необходимости настроить адреса сервера(ов) биллинга по умолчанию (что то типа http[s]://host[:port][/bgbilling]/executer), которые будут использоваться при запуске BGBilling Runner. Доступно несколько способов задания списка доступных серверов:
- в файле config.json из архива BGBilling Runner
- на локальном сервере, при запуске BGBilling Runner пытается загрузить список серверов с сайта http://billing.local/servers.json (пример файла config_http.json см. архиве BGBilling Runner). Адрес сайта и имя файла могут быть заданы в файле config.json, парметр "configURL" : "none". Значение "none" отключает загрузку с сайта.
- ручной ввод данных сервера в интерфейсе BGBilling Runner.
- Запустить BGBilling Runner с помощью скрптов скриптов запуска runner.sh(Linux) или runner_w2k.bat(Windows)
Выбрать необходимый сервер, ввести ни необходимости логин и пароль и Войти на сервер.
Примечание title Внимание При установке базы биллинга в ней создаётся единственный пользователь admin c паролем admin. После первого входа желательно поменять пароль в целях безопасности.
...
После запуска BGBilling Runner, выбора сервера, и ввода логина и пароля, BGBilling Runner обращается к серверу биллинга за списком библиотек необходимых для запуска клиента биллинга. Сервер возращает возвращает список библиотек и их контрольные суммы. BGBilling Runner проверяет наличие запрашиваемых библиотек в локальном кеше кэше клиента (в домашнем каталоге пользователя, каталог ./bgbilling/libs). Отсутствующие библиотеки или отличающиеся по контрольной сумме, загружаются с сервера и сохраняются в кэше. При наличие в кеше кэше всех необходимых библиотек, BGBilling Runner запускает клиент биллинга в виде отдельно java процесса. Кроме списка библиотек, с сервера загружает контрольная сумма всех библиотек, которая передается клиенту биллинга при запуске и используется в процессе работы клиента для контроля совпадения версии клиента и сервера, в случае обновления сервера, его контрольная сумма меняется и в клиенте выводится сообщение о необходимости перезапуска (обновления) клиента.
...
При первом запуске BGBilling Runner, если в домашнем каталоге пользователя есть файл ~/./bgbilling/config, то программа попытается загрузить из него данные о серверах, и сохраненных логинах и паролях. Данные будут сохранены в файле ~/./bgbilling/servers.json. При последующих запусках если существует файл ~/./bgbilling/servers.json, то загрузка данных из ~/./bgbilling/config производиться не будет.
...
Для обновления BGBilling Runner необходимо запустить скрипт update_runner.sh (можно периодически запускать скрипт из планировщика) который проверит наличии новой версии на сервере ftp://ftp.bgbilling.ru/pub/bgbilling/runner/ и при наличии, загрузит ее на сервер биллинга в каталог runner. Далее при запуске BGBilling Runner на рабочей станции, происходит сравнение версии на рабочей станции и на сервере, если версия на сервере больше версии на рабочей станции, версия с сервера копируется на рабочую станцию в папку BGBillingRunner/lib.update. При следущем запуске BGBillingRunner файлы из папки BGBillingRunner/lib.update переносятся в папку BGBillingRunner/lib.
Параметры запуска BGBilling Runner
При запуске скриптов runner.sh(Linux) или runner_w2k.bat(Windows) можно задать параметр autostart=default|<server_key>, где default - ключевое слово обозначающее сервер по умолчанию заданный в конфигурационных файлах (параметр "defaultServerKey"); <server_key> - значение параметра "key" из конфигураций сервера. При наличии этого параметра запуск указанного клиента биллинга будет происходит автоматически.
Часто задаваемые вопросы
1. При подключение выдается ошибка
...
Для отключение проверки валидности сертификата в config.json или config.json загружаемого с сервера, нужно указать параметр "anySSL" : "true". Это работает только для новых пользователей, тех кто в первый раз запускает BGBilling Runner. Для тех кто уже запускал BGBilling Runner ранее необходимо данные настройки сделать в конфиге пользователя, в домашнем каталоге пользователя, в папке .bgbilling файл servers.json.
3. Запуск клиента биллинга в debug режиме
Если перед нажатием кнопки Войти в BGBilling Runner щелкнуть по ссылке по "показать дополнительные параметры" и установить галочку режим отладки, то в этом случае после запуска клиента биллинга, в домашнем каталоге пользователя будет создан файл debug_XXXXXXXXXX.log с логами обмена запросами клиента и сервера.
4. Смена иконки приложения BGBilling
В случае одновременного запуска нескольких копий клиента биллинга можно для разных копий задать разные иконки с помощью ключа -Dbgbilling.frame.icon.url=<url> в конфигурации запуска в разделе VM arguments.