С версии 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 производиться не будет.
...
Для отключение проверки валидности сертификата в 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.