...
1) Загрузите клиент биллинга BGBillingClient_X.X_Y.zip (X.X - номер версии, Y - билда)и распакуйте его в произвольное место. На машине, где установлен клиент должна стоять JDK (допускается JRE);
...
| Блок кода | ||||
|---|---|---|---|---|
| ||||
cd ${0%${0##*/}}.
JAVA_HOME=/opt/java/jre |
4) В каталоге BGBillingClient найдите файл client.properties.
| Блок кода | ||||
|---|---|---|---|---|
| ||||
db.server.0.title=MyBilling db.server.0.url=http://127.0.0.1:8080/bgbilling/executer db.server.0.proxy.host= db.server.0.proxy.port= |
...
5) Запустите клиент с помощью пакетного файла bgbilling_w9x.bat для Win98/ME, bgbilling_w2k.bat для Windows2000/XP/2003, bgbilling.sh для Linux. Если клиент не стартует, либо после старта обнаруживаются проблемы, запустите DEBUG-версию bgbilling_debug.bat, либо bgbilling_debug.sh, при этом в каталоге BGBillingClient должен появится файл log, который вы можете передать разработчикам при разборе проблемы.
...
При установке базы биллинга в ней создаётся единственный пользователь admin c паролем admin. После первого входа желательно поменять пароль в целях безопасности.
Обратите внимание на опцию загружать обновления с этого сервера, её необходимо установить, чтобы библиотеки установленных на сервере модулей могли быть получены клиентом. Опцию можно снимать при подключении к сторонним серверам для предотвращения получения нежелательных обновлений.
При выборе в списке позиции Создать новое подключение и нажатии кнопки ... открывается редактор подключений где вы можете создать подключение к новому серверу биллинга.
...
Созданные таким методом подключения, также как и сохранённые логины и пароли запоминаются в файле HOME_DIR/.bgbilling/config, где HOME_DIR - домашний каталог пользователя.
| Примечание | |||||||
|---|---|---|---|---|---|---|---|
Вы можете изменить файл, в котором сохраняются пароли и дополнительные соединения установив опцию -Dlocal.setting.file.name=<имя отличное от config> в скрипте запуска клиента, например так:
Это может быть полезно, если на одной машине запускается несколько клиентов для разных версий биллинга. |
Если ошибок авторизации не выдаётся, а просто происходит очистка окошек ввода логина и пароля, то, скорее всего, проблема в сервере.
Проверьте лог C:\BGBilling\log\server.out на наличие ошибок (Exception). Вероятнее всего, сервер не может соединиться с базой данных. Попробуйте взять логин и пароль из файла data\data.properties и с их помощью соединиться с БД. Для этого используйте консольный клиент mysql, расположенный в директории C:\mysql\bin. Наберите в командной строке
...
Если после логина требуется сменить текущий сервер биллинга (в случае, если у вас их несколько, см. выше как можно их добавлять) вы можете воспользоваться выпадающим списком расположенным справа от надписи БД: на панели инструментов. При первом входе на новый сервер биллинга будет запрошен логин и пароль, при последующих переключениях авторизация не требуется. Открытые вкладки клиента при переключении на другой сервер и возврате на исходный сохраняются.
Запуск клиента через Java Web Start
Данная возможность реализована, если сервер биллинга установлен на машине с ОС Linux.
По умолчанию библиотеки клиента для Java Web Start подписываются самоподписанным сертификатом. Поэтому необходимо в контрольной панели Java (jcontrol) на машине, где будет запускаться клиент, добавить URL к серверу биллинга (например, http://x.x.x.x:8080 или http://billing.internal.provider.ru:8080) в список сайтов-исключений.
Или же Вы можете использовать подписанный сертификат, для этого его нужно импортировать в BGBillingServer/.bgclient_keystore:
| Блок кода | ||
|---|---|---|
| ||
# Создание PKCS12-хранилища их приватного ключа и публичного сертификата
openssl pkcs12 -export -name bgbilling -in public.crt -inkey private.key -out bgclient.p12
# Конвертирование PKCS12-хранилища в JKS-хранилище
keytool -importkeystore -destkeystore .bgclient_keystore -srckeystore bgclient.p12 -srcstoretype pkcs12 -alias bgbilling
# Проверка
keytool -list -v -keystore .bgclient_keystore |
Необходимо отредактировать файл BGBillingServer/webroot/client/bgclient.jnlp указав правильное значение codebase и db.server.0.url в зависимости от URL доступа к биллингу, затем запустить bgclient_javawebstart.sh.
Теперь при открытии URL http://x.x.x.x:8080/bgbilling/client/bgclient.jnlp запустится клиент биллинга.