====== Grandstream : Настройка ======
FIXME

Здесь описана практическая работа с оборудованием.

====== Обеспечение параметрами (Provisioning) ======

Подробное описание: [[grandstream:provisioning|Обеспечение параметрами (Provisioning)]]


SIP устройства Grandstream можно настраивать через:
  -  Встроенный ''HTTP сервер'' 
  - ''Конфигурационный файл'' загружаемый по протоколам ''TFTP'' или ''HTTP'' (параметры настройки находятся в разделе ''Config Server Path'' ''Конфигурационного файла'')

''Конфигурационный файл'' создается на основе изменения ''файла—шаблона'' устройства. Шаблоны устройств можно найти на странице [[http://www.grandstream.com/support/tools|Tools]] в разделе ''Configuration Template''


Для удобства работы общие для нескольких устройств параметры правильнее хранить в одном файле, а настройки конкретных устройств (каналы и пароли) в  отдельных файлах, например вот список файлов для двух телефонов ''GXP140x'':
|Основной (общий) файл|''{{:grandstream:GXP140x.txt|GXP140x.txt}}''|
|Файл настроек для устройства с именем ''t100''|''{{:grandstream:GXP140x_t100.txt|GXP140x_t100.txt}}''|
|Файл настроек для устройства с именем ''t101''|''{{:grandstream:GXP140x_t101.txt|GXP140x_t101.txt}}''|

Параметры серверов задаются в разделе ''Maintenance/Upgrade and Provisioning'' шаблона.

^  Тип (формат) конфигурационного файла  ^  Формат имени файла  ^
|Все SIP устройства поддерживают проприетарный бинарный формат |''cfgMAC''|
|Некоторые устройства дополнительно поддерживают ''XML''|''cfgMAC.xml''|

:!: ''MAC'' это MAC-адрес этого устройства, например ''cfg000b82000001''. Имя файла должно быть в нижнем регистре

При запуске устройство ищет ''конфигурационный файл'' на сервере, если файл найден, то устройство загружает его, применяет настройки (и при необходимости перезагружается).

====== Обновление прошивки ======

Параметры настройки находятся в разделе ''Firmware Server Path'' ''Конфигурационного файла''

----

[[https://www.grandstream.com/support/firmware|Прошивки (Firmware)]]

[[http://mailinglists.grandstream.com/lists/?p=subscribe&id=1|Subscribe to our Newsletters]]

====== НТТР сервер ======
НТТР сервер [[apache:apache|Apache]]

===== Файл настроек =====
<code ini /etc/apache2/conf.d/provisioning.conf>
<VirtualHost pbx:80>
    Alias /gs /var/www/provisioning/
    ServerAlias pbx
    ServerAlias pbx.domain.ru
    ServerAdmin admin@pbx.domain.ru
    DocumentRoot /var/www/

    <Directory /var/www/provisioning/>
        DirectoryIndex index.html
        Options FollowSymLinks
        AllowOverride Limit Options FileInfo
    </Directory>
</VirtualHost>
</code>
===== Пример списка файлов сервера =====
<code>
cfg000b82000001
cfg000b82000002
cfg000b82000003
gxp1400base.bin
gxp1400boot.bin
gxp1400core.bin
gxp1400fw.bin
gxp1400prog.bin
gxp2120aux.bin
gxp2120base.bin
gxp2120boot.bin
gxp2120core.bin
gxp2120fw.bin
gxp2120prog.bin
gxw4008base.bin
gxw4008basea.bin
gxw4008boota.bin
gxw4008core.bin
gxw4008corea.bin
gxw4008extraa.bin
gxw4008fw.bin
gxw4008proga.bin
</code>


====== Настройка оборудования ======

<WRAP center round important 60%>
Для работы факса важно, чтобы в всех шлюзах, через которые проходит сигнал ''T.38'' был установлен в режим ''Pass-though''
</WRAP>


===== Скрипт для создания файла с параметрами для конкретного устройства =====

{{:grandstream:create_config.sh|create_config.sh}}

Скрипт создает файл с параметрами конкретного устройства, для преобразования из формата текстового формата используется [[#Скрипт для преобразования в cfg|скрипт для преобразования в cfg]]


**Параметры**
|1|Основной файл|
|2|Файл паролей|
|3|MAC адрес|
|4|Режим:\\ 1 =Только основные параметры\\ 2=Только пароли и каналы\\ 3=Все параметры|

**Пример**

<code>create_config.sh GXP140x.txt GXP140x_t1.txt 000b82000001 1</code>



==== Скрипт для преобразования в cfg ====

{{:grandstream:config.pl|config.pl}}

**Параметры**
|1|MAC адрес в нижнем регистре, без разделителей|
|2|Имя исходного файла с параметрами|
|3|Имя выходного файла|

**Пример**
<code>
config.pl 000b82000001 config_000b82000001.txt cfg000b82000001
</code>


===== Перезагрузка =====

==== Шлюзы ====
Проверено на следующем оборудовании: 
  * [[grandstream:gxw400x|]]
  * [[grandstream:gxw410x|]]

{{:grandstream:reboot.sh|reboot.sh}}

**Параметры**
|1|Имя устройства или IP-адрес|
|2|Пароль|

Команда не перезагрузку устройства дается по протоколу ''Telnet'', для эмуляции сессии воспользуется пакет [[expect:expect|Expect]].

Пароль для устройства можно получить из файла с параметрами устройства, в данном примере пароль записан в поле ''P2''

Пример:
<code bash reboot_fxs.sh>
#!/bin/bash

FILE=GXW4008_fxs1.txt
HOST=fxs1
PASSWD=`echo \`cat $FILE | grep 'P2 = '\` | tr -d ' ' | tr -d 'P2='`

reboot.sh $HOST $PASSWD
</code>

==== Телефоны ====
Проверено на следующем оборудовании: 
  * [[grandstream:gxp21xx_14xx_116x|]]

Перезагрузка телефонов Grandstream работа по протоколу HTTP. Для работы нужно установить пакет [[curl:curl|]]

<code bash reboot2.sh>
#!/bin/bash

export http_proxy='';

sid=$(curl -s -c /tmp/cookies.txt -d"password=${2}" http://${1}/cgi-bin/dologin | sed -r 's|.*"sid" : "([0-9a-z]+)".*|\1|' )
curl -b /tmp/cookies.txt -d"request=REBOOT&sid=${sid}" http://${1}/cgi-bin/api-sys_operation

exit
</code>

**Параметры**
|1|Имя устройства или IP-адрес|
|2|Пароль|

Пример:
<code bash reboot_GXP140x.sh>
#!/bin/bash

FILE=GXP140x_t101.txt
HOST=t101
PASSWD=`echo \`cat $FILE | grep 'P2 = '\` | tr -d ' ' | tr -d 'P2='`

reboot2.sh $HOST $PASSWD
</code>
----

[[https://www.voip-info.org/bash-script-to-remote-reboot-some-grandstream-phones/|Bash script to remote reboot some Grandstream phones - VoIP-Info]]

====== Ссылки ======

<del>http://lists.digium.com/pipermail/asterisk-users/2004-September/063515.html</del>

{{tag>Hardware Network IP_Telephony Grandstream}}