MANUAL DO USUÁRIO v.1.2.0 Copyright 2007-2009 Bichara Tecnologia Manual elaborado por: Bichara Tecnologia www.bichara.com.br VoIPzilla Media Gateway Bichara Tecnologia pág. 1
Índice 1. Introdução...3 1.1 O que é VoIPzilla Media Gateway?...3 1.2 Interface Gráfica...3 1.3 Navegação e Operação do Sistema...4 1.3.1 Menu Lateral...5 1.3.2 Área de dados...5 1.3.2.1 Edição de Dados...5 1.4 Configuração do Endereço IP...6 2. Fluxograma de Processos...7 2.1 Spans (menu Spans)...8 2.1.1 Spans SS7 (menu Spans)...8 2.1.2 Spans R2 / ISDN (menu Spans)...9 2.2 Trunks...11 2.2.1 Trunk SIP (menu Trunks / SIP)...11 2.2.2 Trunk Grupos SS7 (menu Trunks / SS7 Groups)...12 2.2.3 Trunk Grupos R2/ISDN (menu Trunks / R2/ISDN Groups)...12 2.3 Dial-Peer...13 2.3.1 Dial-Peer CallerID (menu Dial-Peer / CallerID)...14 2.3.2 Dial-Peer chamadas (menu Dial-Peer / nome do dial-peer)...15 2.4 Hangup Causes...17 2.4.1 Configuração Hangup Causes (menu Hangup Causes / código)...22 2.5 System...23 2.6 Debug / Monitor de Log...24 2.6.1 Log das Chamadas...24 2.6.2 Log das Chamadas com Filtro...24 2.6.3 Acompanhando o status das portas E1...24 VoIPzilla Media Gateway Bichara Tecnologia pág. 2
1. Introdução 1.1 O que é VoIPzilla Media Gateway? VoIPzilla Media Gateway é um produto da família VoIPzilla tipo conector universal IP PSTN de alta disponibilidade. A partir de um clique, é possível configurar enlaces físicos em protocolo SS7 ou R2/MFC ou ISDN-PRI, conexões SIP e até dial-peers para processamento das chamadas. A Media Gateway é composta por 5 (cinco) módulos: Console de Administração; Conversores; Codecs; Pilha de Protocolos; Debug. Gateway Front-End console administração Funções conversão codec conversão protocolo Codecs Voz g711a,u g723.1 g726 g729a Pilha Protocolos SIP v.2 SS7 isup R2/MFC ISDN-pri 1.2 Interface Gráfica O Sistema foi desenvolvido para interface gráfica Web (Internet), estando disponível para acesso a partir de qualquer Navegador (Browser) que atenda os seguintes requisitos: Suporte JavaScript versão 1.1 ou superior Suporte para DIVs e Frames O sistema foi testado nos seguintes navegadores: Internet Explorer versão 6.0 Mozilla (Netescape Navigator) versão 1.2 Firefox versão 2.0 VoIPzilla Media Gateway Bichara Tecnologia pág. 3
1.3 Navegação e Operação do Sistema A navegação é iniciada no Menu Lateral, organizado hierarquicamente, e as informações são apresentadas na Área de Dados. Área de Dados Menu Lateral VoIPzilla Media Gateway Bichara Tecnologia pág. 4
1.3.1 Menu Lateral O Menu Lateral apresenta 5 tópicos: Dial-Peer, Spans, Trunks, Hangup Causes e System. Para acessar um tópico do Menu, clique na opção desejada ou na pasta para acessar os submenus. 1.3.2 Área de dados Na Área de Dados são apresentadas as informações conforme seleção dos itens do Menu. As informações são organizadas por tópico e a situação e ferramentas de edição são apresentadas na barra de navegação. 1.3.2.1 Edição de Dados As informações são apresentadas na Área de Dados. Para editar as informações, posicione o cursor no campo desejado. Ao final, pressione OK para gravar. Para alguns itens, também está disponível a opção Delete. Esta opção removerá o registro e toda informação relacionada do banco de dados. Nota: Os campos marcados com * são obrigatórios. VoIPzilla Media Gateway Bichara Tecnologia pág. 5
1.4 Configuração do Endereço IP O endereço IP da Gateway pode ser configurado através de uma console (monitor + teclado) conectado às portas do equipamento. No prompt de login, digite usuário setup e senha setup (sem as aspas) para entrar no painel de configuração: Selecione a opção desejada e preencha os campos apresentados na tela. Nota: As alterações da configuração IP somente serão ativadas após o reboot. Nota: A senha padrão setup pode ser alterada na opção pwd Configurar Senha. VoIPzilla Media Gateway Bichara Tecnologia pág. 6
2. Fluxograma de Processos As informações foram distribuídas de forma a garantir flexibilidade na utilização dos recursos da Media Gateway, conforme quadros abaixo: Fluxo de Chamada Entrada Dial-Peer Modificador Trunk Saída Trunk Trunk E1 Inbound Span Port / CIC R2 / ISDN / SS7 Group Dial-Peer Trunk E1 Outbound Dial-Peer R2 / ISDN / SS7 Group Port / CIC Span O Trunk SIP trabalha de forma análoga mas considera os dados do Host (IP), Username (opcional) e Password (opcional) para definir o Inbound. As chamadas podem ser encaminhadas entre Trunks de tipos diferente, i.e., de SS7 para SIP, ou R2 para SS7, ou qualquer combinação. VoIPzilla Media Gateway Bichara Tecnologia pág. 7
2.1 Spans (menu Spans) a N. Os Spans definem as portas físicas (E1) disponíveis na Media Gateway, numerados de 1 O Span representa o enlace físico (camada HDLC) e também o enlace lógico (SS7 ou R2/ ISDN) da sinalização. Para SS7, cada Span pode ter um canal de sinalização (Siganaling Channel) próprio ou utilizar o canal de sinalização de outro Span. 2.1.1 Spans SS7 (menu Spans) Os Spans SS7 apresentam os seguintes atributos: a) Timing Source: origem do clock de enlace. Pode ser Master (principal) ou Slave (escravo). As fontes de clock escravo podem ser ordenadas por prioridade, entre 1 e 16. b) Line Build Out: atenuação decorrente do comprimento do cabo coaxial. c) Framing: sempre CCS. d) Coding: código de sinalização: AMI ou HDB3. No padrão brasileiro, sempre HDB3. e) CRC: selecione CRC 4 para incluir o método de verificação de erro de transmissão. f) Yellow Alarm: selecione Yes para transmitir um alarme Yellow sempre que não houver canal aberto. VoIPzilla Media Gateway Bichara Tecnologia pág. 8
g) Signaling Channel: canal de transmissão da sinalização SS7. f) Network Indicator: (NI) é parte do SIO (Signalling Information Octet) e contem o tipo de Sub Serviço da rede: National ou International. g) OPC: Origination Point Code. h) DPC: Destination Point Code. i) Adjacent PC: Point Code do ponto de sinalização adjacente. j) First CIC: número do primeiro CIC para o intervalo especificado em Range. k) Range: intervalo dos canais de áudio (entre 1 e 31), podendo ser definido no formatio [início]-[fim]. Exemplo: para definir o intervalo dos canais de 1 a 15, defina: 1-15. l) SS7 Group: Grupo SS7 definido em Trunk para o qual as chamadas devem ser encaminhadas para processamento. 2.1.2 Spans R2 / ISDN (menu Spans) Para sinalização R2-MFC ou ISDN-PRI, os Spans apresentam os seguintes atributos: a) Framing: CCS para ISDN ou CAS para R2. b) Timing Source: origem do clock de enlace. Pode ser Master (principal) ou Slave (escravo). As fontes de clock escravo podem ser a porta A (Slave A) ou a porta B (Slave B) do módulo. VoIPzilla Media Gateway Bichara Tecnologia pág. 9
c) CRC: selecione CRC 4 para incluir o método de verificação de erro de transmissão. d) R2 Min. Digits RX (apenas enlace R2): número mínimo de dígitos que devem ser esperados. e) R2 Max. Digits RX (apenas enlace R2): número máximo de dígitos que devem ser esperados. No caso de conexão com PABX, faça o número mínimo e máximo igual ao número de cifras esperadas para definição do ramal interno pela Operadora (MCDU). f) R2 Interdigit (apenas enlace R2): tempo (mili segundos) máximo de timeout para aguardar um dígito em overlap dial ou cifras do Grupo B. g) PRI Signalling (apenas enlace ISDN): Network ou CPE. h) PRI Switch Type (apenas enlace ISDN): tipo de switch ISDN conectado: National NI 1; National NI 2; DMS 100; AT&T 4ESS; Lucent 5E; EuroISDN; Q.Sig. O padrão brasileiro é EuroISDN. i) PRI Dial Plan (apenas enlace ISDN): indica o tipo de plano de discagem do enlace conectado: Local; National; International; Private; Unknow. j) Range: intervalo dos canais de áudio (entre 1 e 30), podendo ser definido no formatio [início]-[fim]. Exemplo: para definir o intervalo dos canais de 1 a 15, defina: 1-15. Diferentemente do SS7, o Range do R2/ISDN já desconsidera o canal de sinalização. k) R2/ISDN Group: Grupo R2/ISDN definido em Trunk para o qual as chamadas devem ser encaminhadas para processamento. VoIPzilla Media Gateway Bichara Tecnologia pág. 10
2.2 Trunks Em Trunks são definidos os canais das chamadas conforme a tecnologia: SIP ou SS7. 2.2.1 Trunk SIP (menu Trunks / SIP) Define os canais para chamadas SIP: a) ID: identificação do trunk SIP (alfanumérico). b) Username: nome do usuário para autenticação (pode ser autenticação para receber chamadas ou para realizar chamadas). c) Password: senha do usuário para autenticação. d) Dial Peer: ponto de processamento das chamadas entrantes por este trunk. e) Host: IP do host para enviar as chamadas ou de origem das chamadas. f) ReInvite: quando configurado para Yes, o sistema permitirá transmissão de Re Invite durante a sessão SIP. g) G723, G729, G726, G711 A law e G711 u law: codecs aceitos na negociação SIP. VoIPzilla Media Gateway Bichara Tecnologia pág. 11
2.2.2 Trunk Grupos SS7 (menu Trunks / SS7 Groups) Define o Grupo de CICs para envio de chamadas: a) ID: identificação do grupo SS7 (numérico). b) Calling NAI: (Network Address Indicator) do chamador. c) Called NAI: (Network Address Indicator) do chamado. d) Dial Peer: ponto de processamento das chamadas entrantes por este trunk. 2.2.3 Trunk Grupos R2/ISDN (menu Trunks / R2/ISDN Groups) Define o Grupo dos canais para envio de chamadas: a) ID: identificação do grupo R2/ISDN (numérico). b) A 3 Call Category (apenas enlace R2): define o valor do parâmetro A 3 Call Category (padrão = 1). c) B 6 Subscriber Idle (apenas enlace R2): define o valor do parâmetro B 6 Subscriber Idle (Brasil = 1 / Argentina = 6). d) Dial Peer: ponto de processamento das chamadas entrantes por este trunk. VoIPzilla Media Gateway Bichara Tecnologia pág. 12
2.3 Dial-Peer Dial-Peer define o ponto de processamento das chamadas encaminhadas pelos trunks. Também é definido um Dial-Peer especial, chamado CallerID, para tratamento do CallerID (CLI) das chamadas encaminhadas pelos outros Dial-Peer. Cada Dial-Peer pode ter uma ou mais expressões regulares (Pattern) para identificação do número de destino ou, no caso do Dial-Peer CallerID, do CLI. As expressões regulares são seqüências alfanuméricas que definem padrões numéricos e obedecem regras simples: X pode ser substituído por qualquer número entre 0 e 9. Z pode ser substituído por qualquer número entre 1 e 9. [123-7] pode ser substituído por qualquer número contido nos colchetes ou um intervalo, no exemplo: 1,2,3,4,5,6 e 7.. o ponto pode ser substituído por uma seqüência numérica com 1 ou mais caracteres. Exemplo: [7-9]XXXXXXX representa uma seqüência numérica começando com 7 ou 8 ou 9 e seguida de 7 dígitos. ZZ[2-6]. - representa uma seqüência numérica iniciada com dois dígitos numéricos entre 1 e 9 (poderia ser o código de área), seguido de um dígito entre 2 e 6 e depois um ou mais dígitos (entre 0 e 9). VoIPzilla Media Gateway Bichara Tecnologia pág. 13
2.3.1 Dial-Peer CallerID (menu Dial-Peer / CallerID) O Dial-Peer CallerID é utilizado para processar o número do chamador (A): a) Pattern: expressão regular conforme exposto no item 2.3 acima. Neste exemplo, um CallerID iniciado por um dígito entre 2 e 9 e seguido de sete algarismos. b) Ignore: número de dígitos a serem ignorados (zero para nenhum). c) Forward: número máximo de dígitos para serem considerados na tradução (zero para todos). d) Prefix: prefixo a ser adicionado na frente do número traduzido. Neste exemplo, incluir o prefixo 5511. e) Suffix: sufixo a ser adicionado ao final do número traduzido. f) Comments: comentários. No exemplo, quando o sistema receber um CallerID (número de A) iniciado com um dígito entre 2 e 9 e seguido de sete algarismos (um número local), este número receberá o prefixo 5511 e ficar no formato de telefone internacional. VoIPzilla Media Gateway Bichara Tecnologia pág. 14
2.3.2 Dial-Peer chamadas (menu Dial-Peer / nome do dial-peer) Os demais Dial-Peer (exceto CallerID) são utilizados para processar o número do destinatário (B): a) Pattern: expressão regular conforme exposto no item 2.3 acima. Neste exemplo, um destino exatamente igual a 11551149115001. b) Destination: trunk de destino das chamadas em que o destinatário corresponda ao Pattern especificado. c) Ignore: número de dígitos a serem ignorados (em branco para nenhum). d) Forward: número máximo de dígitos para serem considerados na tradução (em branco para todos). e) Prefix: prefixo a ser adicionado na frente do número traduzido. f) Suffix: sufixo a ser adicionado ao final do número traduzido. g) Set CLI: define o processamento do CallerID (número de A). Pode ser No para simplesmente repassar o número recebido, Proc.CLI para processar o CallerID segundo o Dial Peer CallerID ou Force To para forçar o CLI para o número definido no campo CLI to. h) CLI to: define o número do CallerID que deverá ser forçado quando a opção Set CLI estiver configurada em Force To. i) Caller Presentation / Screening (apenas enlace SS7): define o formato de apresentação do CallerID e sua origem. Quanto a apresentação:. Allowed: para apresentar o número de A no terminal destinatário;. Restricted: número privativo, deve ser suprimido no terminal destinatário. VoIPzilla Media Gateway Bichara Tecnologia pág. 15
Quanto a origem do CallerID:. Network Provided: número fornecido pela rede;. User Provided Verified: número fornecido pelo usuário e verificado pela rede;. User Provided Failed: número fornecido pelo usuário sem verificação;. Not Screened: não informado ou indisponível. j) Comments: comentários. No exemplo, a chamada com destino 11551149115001 será enviada para o Trunk SIP chamado Bichara sem alteração do número de destino ou do CallerID. VoIPzilla Media Gateway Bichara Tecnologia pág. 16
2.4 Hangup Causes Hangup Causes define o mapeamento dos códigos ISUP para a causa da desconexão da chamada e, se definido, uma mensagem de áudio para ser inserida no caso da ocorrência. A Media Gateway pode mapear todas os códigos ISUP de causa de desconexão: Código Cause Description 0 Undefined 1 2 Unallocated (unassigned) number [Q.850 value 1] No route to specified transit network (national use) 3 No route to destination 6 channel unacceptable 7 call awarded, being delivered in an established channel 16 normal call clearing Some Public Switches return code zero to unallocated number (code 1). This cause indicates that the called party cannot be reached because, although the called party number is in a valid format, it is not currently allocated (assigned). this cause has received a request to route the call through a particular transit network, which it does not recognize. The equipment sending this cause does not recognize the transit network either because the transit network does not exist or because that particular transit network, while it does exist, does not serve the equipment which is sending this cause. This cause indicates that the called party cannot be reached because the network through which the call has been routed does not serve the destination desired. This cause is supported on a network dependent basis. This cause indicates that the channel most recently identified is not acceptable to the sending entity for use in this call. This cause indicates that the user has been awarded the incoming call, and that the incoming call is being connected to a channel already established to that user for similar calls (e.g. packet-mode x.25 virtual calls). This cause indicates that the call is being cleared because one of the users involved in the call has requested that the call be cleared. Under normal situations, the source of this cause is not the network. 17 user busy This cause is used to indicate that the called party is unable to accept another call because the user busy condition has been encountered. This cause value may be generated by the called user or by the network. In the case of user determined user busy it is noted that the user equipment is VoIPzilla Media Gateway Bichara Tecnologia pág. 17
18 no user responding 19 no answer from user (user alerted) 20 subscriber absent 21 call rejected 22 number changed 27 destination out of order 28 invalid number format (address incomplete) 29 facilities rejected 30 response to STATUS INQUIRY compatible with the call. This cause is used when a called party does not respond to a call establishment message with either an alerting or connect indication within the prescribed period of time allocated. This cause is used when the called party has been alerted but does not respond with a connect indication within a prescribed period of time. Note - This cause is not necessarily generated by Q.931 procedures but may be generated by internal network timers. This cause value is used when a mobile station has logged off, radio contact is not obtained with a mobile station or if a personal telecommunication user is temporarily not addressable at any usernetwork interface. this cause does not wish to accept this call, although it could have accepted the call because the equipment sending this cause is neither busy nor incompatible. The network may also generate this cause, indicating that the call was cleared due to a supplementary service constraint. The diagnostic field may contain additional information about the supplementary service and reason for rejection. This cause is returned to a calling party when the called party number indicated by the calling party is no longer assigned, The new called party number may optionally be included in the diagnostic field. If a network does not support this cause, cause no: 1, unallocated (unassigned) number shall be used. This cause indicates that the destination indicated by the user cannot be reached because the interface to the destination is not functioning correctly. The term "not functioning correctly" indicates that a signal message was unable to be delivered to the remote party; e.g. a physical layer or data link layer failure at the remote party, or user equipment off-line. This cause indicates that the called party cannot be reached because the called party number is not in a valid format or is not complete. This cause is returned when a supplementary service requested by the user cannot be provide by the network. This cause is included in the STATUS message when the reason for generating the STATUS VoIPzilla Media Gateway Bichara Tecnologia pág. 18
31 normal, unspecified 34 no circuit/channel available 38 network out of order 41 temporary failure 42 43 44 45 50 switching equipment congestion access information discarded requested circuit/channel not available requested facility not subscribed [Q.850 52 outgoing calls barred 54 incoming calls barred 57 bearer capability not authorized message was the prior receipt of a STATUS INQUIRY. This cause is used to report a normal event only when no other cause in the normal class applies. This cause indicates that there is no appropriate circuit/channel presently available to handle the call. This cause indicates that the network is not functioning correctly and that the condition is likely to last a relatively long period of time e.g. immediately re-attempting the call is not likely to be successful. This cause indicates that the network is not functioning correctly and that the condition is no likely to last a long period of time; e.g. the user may wish to try another call attempt almost immediately. This cause indicates that the switching equipment generating this cause is experiencing a period of high traffic. This cause indicates that the network could not deliver access information to the remote user as requested, i.e. user-to-user information, low layer compatibility, high layer compatibility or subaddress as indicated in the diagnostic. It is noted that the particular type of access information discarded is optionally included in the diagnostic. This cause is returned when the other side of the interface cannot provide the circuit or channel indicated by the requesting entity. This cause indicates that the user has requested a supplementary service, which is available, but the user us not authorized to use. This cause indicates that although the calling party is a member of the CUG for the outgoing CUG call, outgoing calls are not allowed for this member of the CUG. This cause indicates that although the called party is a member of the CUG for the incoming CUG call, incoming calls are not allowed to this member of the CUG. This cause indicates that the user has requested a bearer capability that is implemented by the equipment which generated this cause but the user is not authorized to use. VoIPzilla Media Gateway Bichara Tecnologia pág. 19
58 63 65 66 69 79 81 88 95 96 97 bearer capability not presently available service or option not available, unspecified bearer capability not implemented channel type not implemented requested facility not implemented service or option not implemented, unspecified invalid call reference value incompatible destination invalid message, unspecified mandatory information element is missing message type non-existent or not implemented 98 message not compatible with call state or message type nonexistent or not implemented. This cause indicates that the user has requested a bearer capability which is implemented by the equipment which generated this cause but which is not available at this time. This cause is used to report a service or option not available event only when no other cause in the service or option not available class applies. this cause does not support the bearer capability requested. this cause does not support the channel type requested this cause does not support the requested supplementary services. This cause is used to report a service or option not implemented event only when no other cause in the service or option not implemented class applies. this cause has received a message with a call reference which is not currently in use on the usernetwork interface. this cause has received a request to establish a call which has low layer compatibility, high layer compatibility or other compatibility attributes (e.g. data rate) which cannot be accommodated. This cause is used to report an invalid message event only when no other cause in the invalid message class applies. this cause has received a message which is missing an information element which must be present in the message before that message can be processed. this cause has received a message with a message type it does not recognize either because this is a message not defined of defined but not implemented by the equipment sending this cause. this cause has received a message such that the procedures do not indicate that this is a permissible message to receive while in the call state, or a VoIPzilla Media Gateway Bichara Tecnologia pág. 20
99 100 101 102 103 111 127 Information element / parameter non-existent or not implemented Invalid information element contents message not compatible with call state recovery on timer expiry parameter non-existent or not implemented - passed on (national use) protocol error, unspecified Interworking, unspecified STATUS message was received indicating an incompatible call state. this cause has received a message which includes information element(s)/parameter(s) not recognized because the information element(s)/parameter name(s) are not defined or are defined but not implemented by the equipment sending the cause. This cause indicates that the information element(s)/parameter(s) were discarded. However, the information element is not required to be present in the message in order for the equipment sending the cause to process the message. this cause has received and information element which it has implemented; however, one or more fields in the I.E. are coded in such a way which has not been implemented by the equipment sending this cause. This cause indicates that a message has been received which is incompatible with the call state. This cause indicates that a procedure has been initiated by the expiration of a timer in association with error handling procedures. this cause has received a message which includes parameters not recognized because the parameters are not defined or are defined but not implemented by the equipment sending this cause. The cause indicates that the parameter(s) were ignored. In addition, if the equipment sending this cause is an intermediate point, then this cause indicates that the parameter(s) were passed unchanged. This cause is used to report a protocol error event only when no other cause in the protocol error class applies. This cause indicates that an interworking call (usually a call to SW56 service) has ended. VoIPzilla Media Gateway Bichara Tecnologia pág. 21
2.4.1 Configuração Hangup Causes (menu Hangup Causes / código) Os motivos de desconexão das chamadas (hangup causes) podem ser mapeados ou receber uma mensagem de áudio: a) Cause: descrição resumida do motivo de desconexão ISUP. b) Map to: código para o qual a causa original deve ser mapeada (em branco para não mapear). c) Sound Message: upload de arquivo de som com a mensagem a ser tocada sempre que ocorrer o código especificado. VoIPzilla Media Gateway Bichara Tecnologia pág. 22
2.5 System O menu System define operações do sistema: a) License: atualiza a licença de uso do sistema; b) Reboot: reinicializa o sistema; c) Shutdown: desliga o eqiupamento. VoIPzilla Media Gateway Bichara Tecnologia pág. 23
2.6 Debug / Monitor de Log O sistema dispõe de um serviço de monitoramento de log para depuração (debug). O Monitor de Log é uma interface para interação direta com o log do sistema através de uma conexão TCP/IP na porta 8081 da gateway. A estrutura do Monitor de comunicação é: [comando] [parâmetro]; sendo um comando por linha e, ao final da série de comandos, duas linhas em branco ("\n\n"). As duas linhas em branco sinalizam fim de envio, tanto do cliente quanto do servidor. Para conectar: [IP do servidor]:8081 Assim que conectar, você receberá o greeting. Digite o usuario e senha quando solicitado. Agora, você poderá utilizar os comandos: command e bye:. command inicia uma série de transmissão de informações para obter um retorno;. bye encerra a sessão. Para command, estão disponíveis: log e portmon; descritos abaixo: 2.6.1 Log das Chamadas Para ver o log das chamadas: command log [duas linhas em branco] 2.6.2 Log das Chamadas com Filtro Para ver o log e filtrar as mensagens por uma expressao: command log match [expressao] [duas linhas em branco] 2.6.3 Acompanhando o status das portas E1 Para acompanhar a alteração do status das portas E1: command portmon [duas linhas em branco] VoIPzilla Media Gateway Bichara Tecnologia pág. 24