=====Migration=====

В этой секции описывается процеc перехода с других билинговых систем на ABillS

=====Как лучше мигрировать ?=====

   - Тестируете новый биллинг (с тестовыми данными)
   - Делаете выгрузку из старого биллинга
   - Загружаете данные старого биллинга в новый для предварительного теста
   - Тестируете работу
   - Делаете окончательную выгрузку из старого и загружаете в новый
   - Запускаем в работу



====2abills.pl====
 [[https://github.com/nabat/2abills|2abills.pl]]\\
Для быстрого переноса данных из других систем была разработана программа 2abills.pl .\\
Программа формирует файл для импорта акаунтов через модуль [[http://abills.net.ua/wiki/doku.php?id=abills:docs:modules:cards:ru|Cards]].\\
Файл импорта загружается через меню ''/ Клиенты/ Логины/ Internet/ Интернет карточки/''
\\
После импорта аккаунты имеют вид заведённых администратором. При положительном балансе деньги ставятся на счёт и делается отметка 'MIGRATION' в журнале платежей, а при отрицательно снимаются и  делается отметка 'MIGRATION' в журнале начислений.\\
**Возможности**\\
  * Программа экспортирует данные из поточной билинговой системы в файл импорта для ABillS Cards Modules.\\
  * Есть возможность установить пароль по умолчанию 
  * Добавить дополнительные данные для импорта в ABillS
  * Создавать HTML файл для более удобного просмотра импортируемых данных перед загрузкой в ABIllS
  * Создавать почтовые аккаунты 
  * Создать таблицу соотношения  старых тарифных (старой билинговой системы) и AbillS

====Описание====
  Опции:
    DEBUG               - debug
    DEFAULT_PASSWORD    - стандартный пароль для пустых полей
    PASSSWD_ENCRYPTION_KEY - ключ шифрования
    EMAIL_CREATE        - создать email аккаунты
    EMAIL_DOMAIN        - ABillS почтовый домен ( подробнее '/ System configuration/ E-MAIL/ Domains/' )
    DEBUG               - Включить debug
    NO_DEPOSIT          - Не переносить депозит
    FROM                - Миграция с:
                            freenibs
                            mabill
                            utm4
                            utm5
                            utm5pg
                            file      - Tab delimiter 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
                            carbon4
    IMPORT_FILE=[file]  - Файл импорта с разделителем табуляция
    FILE_FIELDS=[list,.]- Список полей в файле (FILE_FIELDS=LOGIN,PASSWORD,3.FIO...)
    TP_MIGRATION=[file] - Файл тарифными планами. в первом параметре приводиться старый ТП в втором новый
                          Формат: 
                           old_tp=abills_tp_id
    SYNC_DEPOSIT=[file] - Файл с полями логин, депозит разделены табуляциями 
    DB_HOST             - Хост
    DB_USER             - Пользователь базы данных
    DB_PASSWORD         - Пароль пользователя
    DB_CHARSET          - кодировка базы данных
    DB_NAME             - Имя базы данных
    HTML                - Показать экспортируемый файл в виде HTML
    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_файл_с_карточками

====ISBS -> AbillS ====
 [[http://www.onlinebilling.ru|Online BIlling]] \\
 
Перенос логинов, балансов, персональной информации.
 [[http://abills.net.ua/soft/migration/isbs2abills.pl|isbs2abills.pl]]



====LMS -> AbillS ====
 [[http://www.lms.org.pl|LMS]] \\

Перенос логинов, балансов, персональной информации:

  # ./2abills.pl FROM=lms

Перенос IP и MAC адресов:

  # ./2abills.pl FROM=lms_nodes

==== Carbon Billing 4 ====
[[http://abills.net.ua/misc/2abills_.pl|Скачать тестовый вариант скрипта с поддержкой carbon4]]

  # ./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/)





====Миграция с файла====
Для миграции используется файл с полями разделёнными табуляцией, первых два поля обязательно должны быть логин и пароль.\\
  # ./2abills.pl  FROM=file  IMPORT_FILE=[название файла] FILE_FIELDS=[последовательность полей разделённых запятой]
\\ Поля  подписываются как описано в документации по модулю [[abills:docs:modules:cards:ru|Сards]] в графе **"Формат файла логинов"**\\ 
Пример :\\
  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