В этой секции описывается процесс перехода с других билинговых систем на ABillS.
Для перехода лучше всего использовать утилиту 2abills
Внимание!
Перед началом миграции убедитесь что :
- есть лицензия для необходимого количества мигрируемых пользователей
проверить присутствие лицензии : ls -al /usr/abills/libexec/license.key - логины пользователей соответствуют правилам биллинговой системы
grep -i username /usr/abills/libexec/config.pl - при импорте большого количества пользователей возможна ситуация превышения ожидания ответа вебсервера (timeout), тогда рекомендуется его увеличить
grep -R Timeout /etc/apache2
Как лучше мигрировать?
Тестируете новый биллинг (с тестовыми данными).
Делаете выгрузку из старого биллинга.
Загружаете данные старого биллинга в новый для предварительного теста.
Тестируете работу.
Делаете окончательную выгрузку из старого и загружаете в новый.
Запускаем в работу.
2abills.pl
2abills.pl
Для быстрого переноса данных из других систем была разработана программа 2abills.pl. Программа формирует файл для импорта акаунтов через модуль Cards. Файл импорта загружается через меню Клиенты>Логины>Интернет+>Карточки пополнения.
После импорта аккаунты имеют вид заведённых администратором. При положительном балансе деньги ставятся на счёт и делается отметка 'MIGRATION' в журнале платежей, а при отрицательном - снимаются и делается отметка 'MIGRATION' в журнале начислений.
Возможности
Программа экспортирует данные из текущей билинговой системы в файл импорта для ABillS Cards Modules
Есть возможность установить пароль по умолчанию
Добавить дополнительные данные для импорта в ABillS
Создавать HTML файл для более удобного просмотра импортируемых данных перед загрузкой в ABIllS
Создавать почтовые аккаунты
Создать таблицу соотношения старых тарифных (старой билинговой системы) и AbillS
Описание
Опции:
DEFAULT_PASSWORD - стандартный пароль для пустых полей
PASSSWD_ENCRYPTION_KEY - ключ шифрования
EMAIL_CREATE - создать email аккаунты
EMAIL_DOMAIN - ABillS почтовый домен ( подробнее '/ System configuration/ E-MAIL/ Domains/' )
DEBUG - Включить debug
ADDRESS_DELIMITER= - Addreess delimeter for field 3.ADDRESS_FULL (Address delimiter street_name[delimeter1]build[delimiter2][flat])
ADDRESS_DELIMITER="[delimiter1],[delimiter2]"
SKIP_ERROR_PARAM=1 - Игнорировать ошибки, не снимать абонплату (Add: SKIP_ERRORS=1 4.DV_SKIP_FEE=1)
ADD_PARAMS= - Add ext params with coma delimeter (ADD_PARAMS="1.GID=1000,5.STATUS=5")
NO_DEPOSIT - Не переносить депозит
FROM - Миграция с:
freenibs
mabill
utm4
utm5
utm5pg
file - Файл с разделителем табуляция
utm5cards - require IMPORT_FILE paraments with utm cards
abills - экспортирует пользователей с abills
mikbill - get users from mikbill
mikbill_deleted - get deleted users from mikbill
mikbill_blocked - get blocked users from mikbill
nodeny
traffpro
stargazer - MySQL DB
stargazer_pg - stargazer Postgre DB
carbon4
carbon5
lms
lms_nodes (IP, MAC adresses for lms users)
odbc
nika
SYNC_DEPOSIT - Файл для синхронизации депозита ( ./2abills.pl FROM=file SYNC_DEPOSIT=/usr/deposits )
IMPORT_FILE=[file] - Файл импорта с разделителем табуляция или CEL_DELIMITER=...
CEL_DELIMITER - Разделитель для файла
FILE_FIELDS=[list,.]- Список полей в файле (FILE_FIELDS=LOGIN,PASSWORD,3.FIO...)
TP_MIGRATION=[file] - Файл с тарифными планами. В первом параметре приводится старый ТП, во втором новый
Формат:
old_tp=abills_tp_id
LOGIN2UID - Convert login to uid for digit logins
ADD_NAS - Добавить NAS-сервера из файла. Поля определяются опцией FILE_FIELDS=...
DB_HOST - Хост базы данных
DB_USER - Пользователь базы данных
DB_PASSWORD - Пароль пользователя
DB_CHARSET - Кодировка базы данных
DB_NAME - Имя базы данных
DB_PATH - Путь к файлу БД при импорте с carbon
HTML - Показать экспортируемый файл в виде HTML
win2utf - Конвертировать данные из win1251 в utf8
help - Помощь
Файл миграции тарифов. Служит для указания переноса тарифов со старой системы в новую.
Формат:
Старый тариф=новый тариф
Stargazer -> ABillS
./2abills.pl FROM=stargazer
Traffpro -> ABillS
./2abills.pl FROM=traffpro
Nodeny -> ABillS
./2abills.pl FROM=nodeny
Mikbill -> ABillS
./2abills.pl FROM=mikbill ./2abills.pl FROM=mikbill_deleted > deleted_users.txt ./2abills.pl FROM=mikbill_blocked > blocked_users.txt
FreeNIBS -> ABillS
./2abills.pl FROM=freenibs
Mabill -> ABillS
./2abills.pl FROM=mabill
UTM 4 -> ABillS
./2abills.pl FROM=utm4
UTM 5 -> AbillS
./2abills.pl FROM=utm5
UTM 5 Postgres -> AbillS
./2abills.pl FROM=utm5pg
UTM 5 Internet cards
Перенос карточек из UTM в ABillS. Система автоматически переносит карточки.
Внимание: при каждом запуске карточки будут вносится повторно.
./2abills.pl FROM=utm5cards IMPORT_FILE=XML_файл_с_карточками
LMS -> AbillS
Перенос логинов, балансов, персональной информации:
./2abills.pl FROM=lms
Перенос IP и MAC адресов:
./2abills.pl FROM=lms_nodes
Carbon Billing 4
./2abills.pl FROM=carbon4 DB_HOST=192.168.0.64 DB_PASSWORD=servicemode > import_logins.txt
Для импорта нужно установить клиент к Firebird и ODBC драйвер базы данных (http://www.firebirdsql.org/en/odbc-driver/)
Carbon Billing 5
./2abills.pl FROM=carbon5 DB_HOST=192.168.0.64 DB_PASSWORD=servicemode > import_logins.txt
Для импорта нужно установить клиент к Firebird и ODBC драйвер базы данных (http://www.firebirdsql.org/en/odbc-driver/)
Миграция с файла
Для миграции используется файл с полями разделёнными табуляцией, первых два поля обязательно должны быть логин и пароль.
./2abills.pl FROM=file IMPORT_FILE=[название файла] FILE_FIELDS=[последовательность полей разделённых запятой]
Поля подписываются как описано в документации по модулю Cards в графе «Формат файла логинов»
Пример :
FROM=file IMPORT_FILE=clients.txt FILE_FIELDS=LOGIN,PASSWORD,3.FIO,3.PHONE,4.TP_ID,4.IP,5.SUM,4.CID > clients_converted.txt
Параметры
IMPORT_FILE=[название файла] | Название файла |
| CEL_DELIMITER=';' | Разделитель полей. По умолчанию табуляция |
FILE_FIELDS | Список полей в файле |