Provisionamiento Linksys SPA9XX
Miércoles, Enero 16th, 2008Hace poco he necesitado hacer un poco de mass-deployment de teléfonos Linksys SPA922. La verdad es que son terminales que me gustan mucho. He probado los Thompson,los Grandstream y Snom de gama baja/media y la verdad es que para terminales comunes, no de operadora, me quedo con los Linksys: son bonitos y fiables.
El problema me llega cuando busco en Google ficheros de ejemplo sobre el provisionamiento de Linksys. No encuentro ningún ejemplo y tampoco explicaciones claras sobre cómo hacerlo. Bien, esto me pasa por no leerme completito el manual de administrador de los terminales donde en un párrafo se explica bien claro. El motivo de este post es que otro no pierda el tiempo que he perdido yo buscando en google algo tan sencillo.
Un fichero de provisionamiento de Linksys SPA9XX no es más que un fichero XML y es bastante sencillo de hacer. Voy a poner el ejemplo de un SPA922 pero es bastante generalizable a toda la gama.
Lo primero es saber que toda la configuración va en un fichero al que llamaremos spa922.cfg. El fichero admite todas las opciones que vemos normalmente en el interfaz web del terminal sin más que respetar algunas convenciones:
- Los espacios en las opciones se sustituyen por guiones bajos
- Las opciones asociadas a una línea han de llevar _X_ al final del nombre de la opción. X hace referncia al número de línea.
- El fichero empieza y termina con las etiquetas <flat-profile></flat-profile>.
Pongo aquí un ejemplo de fichero. En realidad de dos porque las opciones comunes a todos los teléfonos se ponen en un único fichero y después las opciones particulares, tales como los datos de acceso, se ponen en ficheros individuales para cada teléfono. El genérico es el antes mencionado “spa922.cfg” y el particular es “spa922-${MAC}.cfg”
-
-
<flat-profile>
-
-
<!– PROVISIONING –>
-
<resync_periodic>10</resync_periodic>
-
<resync_error_retry_delay>20</resync_error_retry_delay>
-
<profile_rule>/spa922-MAC/spa922-$MA.cfg</profile_rule>
-
-
<!– SYSTEM –>
-
<enable_web_server>yes</enable_web_server>
-
<enable_web_admin_access>yes</enable_web_admin_access>
-
<dhcp>yes</dhcp>
-
<primary_ntp_server>10.10.10.1</primary_ntp_server>
-
<enable_vlan>no</enable_vlan>
-
<enable_cdp>no</enable_cdp>
-
-
<!– SIP –>
-
<max_forward>70</max_forward>
-
<max_redirection>5</max_redirection>
-
<max_auth>2</max_auth>
-
<sip_user_agent_name>$VERSION</sip_user_agent_name>
-
<sip_reg_user_agent_name>$VERSION</sip_reg_user_agent_name>
-
<dtmf_relay_mime_type>application/dtmf-relay</dtmf_relay_mime_type>
-
<use_compact_header>no</use_compact_header>
-
<rtp_port_min>8000</rtp_port_min>
-
<rtp_port_max>11000</rtp_port_max>
-
<symmetric_rtp>yes</symmetric_rtp>
-
<stun_enable>no</stun_enable>
-
-
<!– REGIONAL –>
-
<time_zone>GMT+01:00</time_zone>
-
-
<!– PHONE –>
-
<voice_mail_number>451</voice_mail_number>
-
<text_logo>Irontec%0ai::voz</text_logo>
-
<extension_1_>1</extension_1_>
-
<share_call_appearance_1_>private</share_call_appearance_1_>
-
-
<!– EXT 1 –>
-
<line_enable_1_>yes</line_enable_1_>
-
<subscription_expires_1_>3600</subscription_expires_1_>
-
<sip_port_1_>5060</sip_port_1_>
-
<proxy_1_>10.10.10.1</proxy_1_>
-
<use_outbound_proxy_1_>no</use_outbound_proxy_1_>
-
<register_1_>yes</register_1_>
-
<make_call_without_reg_1_>no</make_call_without_reg_1_>
-
<register_expires_1_>3600</register_expires_1_>
-
<use_dns_srv_1_>no</use_dns_srv_1_>
-
<use_auth_id_1_>No</use_auth_id_1_>
-
<preferred_codec_1_>G711a</preferred_codec_1_>
-
<use_pref_codec_only_1_>no</use_pref_codec_only_1_>
-
<g729a_enable_1_>yes</g729a_enable_1_>
-
<g723_enable_1_>no</g723_enable_1_>
-
<g726-16_enable_1_>no</g726-16_enable_1_>
-
<g726-24_enable_1_>no</g726-24_enable_1_>
-
<g726-32_enable_1_>no</g726-32_enable_1_>
-
<g726-40_enable_1_>no</g726-40_enable_1_>
-
<dtmf_tx_method_1_>auto</dtmf_tx_method_1_>
-
<dial_plan_1_ ua="na">(1xxS0|2xxS0|6xxxxxxxxS0|9xxxxxxxxS0|xx.)</dial_plan_1_>
-
<enable_ip_dialing_1_ ua="na">No</enable_ip_dialing_1_>
-
-
<!– User –>
-
<time_format>24hr</time_format>
-
-
</flat-profile>
-
<flat-profile>
-
-
<display_name_1_>Jon Bonilla</display_name_1_>
-
<user_id_1_>205</user_id_1_>
-
<password_1_>secretillo</password_1_>
-
-
</flat-profile>
Una vez tenemos los dos ficheros, sólo necesitamos que el terminal sepa dónde encontrarlos. Hay varias maneras de hacerlo; la que he escogido es tener un servidor tftp en mi asterisk que sirva los ficheros al teléfono. Para ellos debemos instalar un servidor tftp. Para ellos como root instalamos atftp:
apt-get install atftpd
Editamos /etc/default/atftpd para decirle dónde estará nuestro directorio de tftp. En mi caso /tftpboot:
USE_INETD=true
OPTIONS="--daemon --port 69 --tftpd-timeout 300 --retry-timeout 5 --mcast-port 1758 --mcast-addr 239.239.239.0-255 --mcast-ttl 1 --maxthread 100 --verbose=5 /tftpboot"
Creamos el directorio /tftpboot y ponemos ahí el fichero general spa922.cfg. Después creamos el directorio “/tftpboot/spa922-MAC” donde irán los ficheros particulares de cada teléfono. Por ejemplo el “spa922-000e08de2995.cfg”
Ahora ya tenemos todo preparado. Sólo queda hacer saber al terminal dónde ha de buscar el servidor tftp. Para ello, lo que hacemos es pasarle una option desde el servidor dhcp cuando el terminal hace una petición. En el fichero de configuración del servidor dhcp /etc/dhcp3/dhcpd.conf tendríamos algo así:
subnet 10.10.10.0 netmask 255.255.255.0
{
range 10.10.10.100 10.10.10.254;
option domain-name-servers 212.55.8.132;
option routers 10.10.10.1;
option subnet-mask 255.255.255.0;
option broadcast-address 10.10.10.255;
option tftp-server-name "10.10.10.1";
}
Después de esto, tenemos que cuando enchufemos a la red el terminal nuevo éste cogerá la dirección de red del servidor, comprobará que hay un servidor tftp en el que encontrará sus ficheros de configuración y tendremos el terminal listo para usar sin haber tenido que tocar para nada el terminal o haber accedido a la configuración web. Esto es una gran ventaja en cuanto el número de terminales a implantar es mayor de unos pocos. Además si por alguna razón tenemos un usuario torpe y mete la pata, basta con reinicar el teléfono y éste se volvería a configurar con los valores correctos.
Para más parámetros a configurar en los terminales lo mejor es verlos todos detallados en el manual de linksys.
Verbio
En instalaciones de telefonía IP con un número considerable de teléfonos la posibilidad de autoconfiguración de los mismos se torna como una opción muy a tener en cuenta por las comodidades que brinda. No sólo porque minimiza el tiempo de configuración de todos los terminales, sino porque permite actualizaciones y cambios de parámetros bajo demanda.