{info}Помощь по внедрению пользовательских схем и тюнингу стандартных схем оказывается только на уровнях подписки "*Сопровождение*" и "*Аутсорсинг*".
На подписках "*Стандарт*" и "*Бизнес*" предлагается использовать [стандартные схемы внедрения|CarbonBilling:Стандартные схемы].{info}
Интеграция пользовательской схемы состоит из трёх этапов:
{toc}
h1. Добавьте NAS в список
# В меню "*Оборудование*" \-> "*NAS*" нажмите кнопку "*Добавить*"
\\
\\ !nas_list.png|border=0,width=500!\\
\\
# В открывшейся форме заполните поля *Название*, *IP адрес*, выберите *OSS схему* "*Пользовательская*", укажите *версию "1"* и нажмите "*Сохранить*"
\\
\\ !nas_add_form.png|border=0,width=350!\\
\\
# Обратите внимание, что после сохраненя автоматический должно запониться поле "*OSS Каталог управления*"
\\
\\ !nas_created.png|border=0,width=350!\\
\\
# Перейдите на вкладку "*Управление*" и нажмите кнопку "*rtsh cfg init default v1*"
\\
\\ !nas_management_tab.png|border=0,width=550!\\
\\
# Должно появиться всплывающее окно, через несколько секунд появится надмись "/usr/local/bin/rtsh cfg init default_v1 \[8032\] is finished"
\\
\\ !nas_initiated.png|border=0,width=400!
\\
\\
# Подключитесь к серверу по SSH и проверьте что файлы схемы создались: посмотрите какой указан путь до OSS каталога в настройках NAS и подставьте в команду:
\\
\\
{code:title=Пример команды, путь до Вашего NAS уточните в его настройках}chroot /app/asr_billing/ ls -l /var/oss/core/MyNAS/{code}
Вывод должен быть приблизительно следующий:
\\
\\ !nas_list_files.png|border=1!
h1. Кастомизируйте скрипт
# Зайдите в контейрнер биллинга
{code}chroot /app/asr_billing{code}
Перейдите в каталог со файлами схемы, каталог можно посмотреть в интерфейсе биллинга в настройках NAS. В нашем примере это "/var/oss/core/MyNAS/"
{code}cd /var/oss/core/MyNAS/{code}
# Скопируйте шаблон скрипта управления session
{code}cp bin/session ubin/{code}
# Откройте файл для редактирования. Например, это можно сделать редактором VIM
{code}vim ubin/session{code}
или MC
{code}mcedit ubin/session{code}
# Добавьте в скрипт ссылку на основной скрипт session. Это нужно чтобы правильно работала [синхронизация|CarbonBilling:Синхронизация абонентов на оборудовании]. Первые две строки в скрипте должны выглядеть так:
{code}#!/bin/bash
. $(dirname $BASH_SOURCE)/../bin/session
{code}
# Добавьте команды необходимые для управления Вашим оборудованием. Например событие user_accept, которое проходит при любой разблокировке пользователя.
{code}user_accept(){
__coa_send ip forward_allow add $ip
__coa_send ip snat add $ip $snatip
}
{code}
Обязательными обычно являются следующие состояния (их описания есть в [статье|http://docs.carbonsoft.ru/pages/viewpage.action?pageId=51708843]):
#* user_add
#* user_del
#* user_accept
#* user_drop
# Выставьте права на выполнение скрипта
{code}
chmod +x ubin/session
{code}
h1. Проверьте что получилось
Выполните несколько команд, которые добавили в скрипте, например:
{code}
rtsh session 10.100.1.2 accept
rtsh session 10.100.1.2 drop
{code}
На подписках "*Стандарт*" и "*Бизнес*" предлагается использовать [стандартные схемы внедрения|CarbonBilling:Стандартные схемы].{info}
Интеграция пользовательской схемы состоит из трёх этапов:
{toc}
h1. Добавьте NAS в список
# В меню "*Оборудование*" \-> "*NAS*" нажмите кнопку "*Добавить*"
\\
\\ !nas_list.png|border=0,width=500!\\
\\
# В открывшейся форме заполните поля *Название*, *IP адрес*, выберите *OSS схему* "*Пользовательская*", укажите *версию "1"* и нажмите "*Сохранить*"
\\
\\ !nas_add_form.png|border=0,width=350!\\
\\
# Обратите внимание, что после сохраненя автоматический должно запониться поле "*OSS Каталог управления*"
\\
\\ !nas_created.png|border=0,width=350!\\
\\
# Перейдите на вкладку "*Управление*" и нажмите кнопку "*rtsh cfg init default v1*"
\\
\\ !nas_management_tab.png|border=0,width=550!\\
\\
# Должно появиться всплывающее окно, через несколько секунд появится надмись "/usr/local/bin/rtsh cfg init default_v1 \[8032\] is finished"
\\
\\ !nas_initiated.png|border=0,width=400!
\\
\\
# Подключитесь к серверу по SSH и проверьте что файлы схемы создались: посмотрите какой указан путь до OSS каталога в настройках NAS и подставьте в команду:
\\
\\
{code:title=Пример команды, путь до Вашего NAS уточните в его настройках}chroot /app/asr_billing/ ls -l /var/oss/core/MyNAS/{code}
Вывод должен быть приблизительно следующий:
\\
\\ !nas_list_files.png|border=1!
h1. Кастомизируйте скрипт
# Зайдите в контейрнер биллинга
{code}chroot /app/asr_billing{code}
Перейдите в каталог со файлами схемы, каталог можно посмотреть в интерфейсе биллинга в настройках NAS. В нашем примере это "/var/oss/core/MyNAS/"
{code}cd /var/oss/core/MyNAS/{code}
# Скопируйте шаблон скрипта управления session
{code}cp bin/session ubin/{code}
# Откройте файл для редактирования. Например, это можно сделать редактором VIM
{code}vim ubin/session{code}
или MC
{code}mcedit ubin/session{code}
# Добавьте в скрипт ссылку на основной скрипт session. Это нужно чтобы правильно работала [синхронизация|CarbonBilling:Синхронизация абонентов на оборудовании]. Первые две строки в скрипте должны выглядеть так:
{code}#!/bin/bash
. $(dirname $BASH_SOURCE)/../bin/session
{code}
# Добавьте команды необходимые для управления Вашим оборудованием. Например событие user_accept, которое проходит при любой разблокировке пользователя.
{code}user_accept(){
__coa_send ip forward_allow add $ip
__coa_send ip snat add $ip $snatip
}
{code}
Обязательными обычно являются следующие состояния (их описания есть в [статье|http://docs.carbonsoft.ru/pages/viewpage.action?pageId=51708843]):
#* user_add
#* user_del
#* user_accept
#* user_drop
# Выставьте права на выполнение скрипта
{code}
chmod +x ubin/session
{code}
h1. Проверьте что получилось
Выполните несколько команд, которые добавили в скрипте, например:
{code}
rtsh session 10.100.1.2 accept
rtsh session 10.100.1.2 drop
{code}