JD/NC-95/4 ABS - PABX-fr

COMMUNICATION TECHNIQUE
N° TC0868
Ed. 01
OmniPCX Enterprise
Nb de pages : 16
Date : 20-12-2006
URGENTE
NON URGENTE
TEMPORAIRE
DEFINITIVE
OBJET : TAXATION AU FIL DE L'EAU SUR ETHERNET
Veuillez trouver ci-après la description de la taxation au fil de l'eau sur Ethernet conçue pour
transmettre des tickets vers une application de taxation externe.
1
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
SOMMAIRE
1.
PRÉSENTATION ...........................................................................3
1.1.
Conditions de fonctionnement .................................................................. 3
1.2.
Gestion du PCX ......................................................................................... 4
2.
ÉCHANGE ENTRE PCX ET APPLICATION EXTERNE........................5
2.1.
Dialogue : principe ................................................................................... 5
2.2.
Connexion avec l'application .................................................................... 5
2.3.
Initialisation du dialogue .......................................................................... 5
2.3.1.
Identification de la CPU rôle .............................................................................5
2.3.2.
Initialisation du serveur ....................................................................................5
2.4.
Maintien du dialogue de connexion (keep alive)....................................... 6
2.5.
Ticket de taxation...................................................................................... 6
3.
INTERFACE & ARCHITECTURE ......................................................6
4.
OUTILS ........................................................................................7
4.1.
eaccclt....................................................................................................... 7
4.2.
Simulateur du ticket taxation sur Ethernet ................................................ 9
5.
AIDE AU DIAGNOSTIC...............................................................10
5.1.
Alarmes .................................................................................................. 10
5.2.
Si aucun ticket n'est envoyé vers l'application externe............................. 10
5.3.
Contrôle si les demandes keep alive sont envoyés toutes les 30 secondes11
6.
LIMITES......................................................................................12
7.
PROTOCOLE DE L'APPLICATION TAXATION ETHERNET..............12
7.1.
Exemple.................................................................................................. 12
Ed. 01 / 20-12-2006
1
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
TC0868
2
Ed. 01 / 20-12-2006
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
1.
PRÉSENTATION
La taxation au fil de l'eau sur Ethernet a été conçue pour transmettre des tickets vers une application
de taxation externe.
Ces tickets peuvent être masqués au niveau du numéro émis en fonction du type de communication
(normale, affaires et personnelle). Le type de tickets (public, privé, départ, arrivée, etc.) peut être
filtré.
Le format des tickets est identique à ceux stockés au format compressé (/usr4/account/*.DAT).
IMPORTANT
L'utilisation de la taxation au fil de l'eau est exclusive : la sélection des tickets via Ethernet interdit
l'édition des tickets sur interface V24 et inversement.
Pour s'assurer de la gestion correcte de la taxation au fil de l'eau, les éléments suivants doivent être
pris en compte :
•
Conditions de fonctionnement
•
Gestion du PCX
Réseau
commuté
LAN client
Tickets
Application
Taxation
1.1.
Conditions de fonctionnement
Les licences suivantes doivent être disponibles :
−
V24MeteringOnFly (N° 51)
−
AccountingEthernet (N° 83)
−
TicketsABCNetCalls (N° 99) nécessaire si les tickets doivent être renvoyés au nœud de
l'abonné
Ed. 01 / 20-12-2006
3
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
1.2.
Gestion du PCX
Configurer les objets taxation comme suit :
Applications > Taxation
Attributs :
Taxation Interne = Oui
Sortie Temps réel = Ethernet
ATTENTION
Les filtres de taxation peuvent être gérés pour que seuls les tickets nécessaires soient transmis.
Parmi la liste ci-dessous, sélectionner uniquement le type de tickets exploités par l'application
externe:
Applications > Taxation
Attributs: Param.Sortie temps réel
Filtres:
App. publics-locaux sortants (Le ticket sortant principal quand le PCX stand alone)
App.publics-réseau sortants
Appels réseau local (2)
App. privés-locaux sortants
App.privés-réseau sortant
App.publics-locaux entrants
App.publics-réseau entrants
App.privés-locaux entrants
App.privés-réseau entrants
App.prioritaires entrants
Data entrants/sortants
App.publ.sortants coût nul (1)
Usagers non justifiés
Appels local-local (2)
Appels transit local (2)
Tickets tax. locale/réseau Durée 0
Tickets Administration (2)
Notes
1
Si aucune taxe n'est calculée par le PCX ou reçue de l'opérateur public, tous les tickets ayant 0
unité seront bloqués. Il est préférable d'ajouter ce filtre quand aucun ticket n'est envoyé vers
l'application de taxation externe.
2
ATTENTION: Ces tickets peuvent être sélectionnés à partir d'une liste mais ne peuvent pas être
ajoutés après validation car les tickets 'interne', 'en transit' et 'administration' ne sont pas
disponibles pour la fonctionnalité 'Taxation au fil de l'eau sur Ethernet'.
TC0868
4
Ed. 01 / 20-12-2006
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
2.
ÉCHANGE ENTRE PCX ET APPLICATION EXTERNE
L'échange est décrit ci-dessous :
−
Dialogue : principe
−
Connexion avec l'application
−
Initialisation du dialogue
−
Maintien du dialogue de connexion (keep alive)
−
Ticket de taxation
2.1.
Dialogue : principe
L'OmniPCX Enterprise est considéré être un serveur et l'application externe un client.
La machine externe initialise la connexion, le PCX assure la transmission des tickets disponibles.
Note
Si l'application externe n'est pas disponible ou que le lien est cassé, les tickets sont stockés dans un
buffer du PCX jusqu'à un maximum de 2500. Passée cette limite, tous les tickets sont perdus.
2.2.
Connexion avec l'application
Comme le PCX est en écoute permanente sur le port 2533, l'application externe envoie une trame
'Connect' avec le numéro du port réservé pour le dialogue dans le sens PCX -> application externe.
La trame 'Connect' est inversée et renvoyée à l'application externe.
Dès que la connexion est établie, le dialogue peut commencer.
2.3.
Initialisation du dialogue
2.3.1. Identification de la CPU rôle
"S" (Start) est le premier message devant être envoyé au PCX :
00H 01H 53H
["S" message used to select the accounting server (SvTSE) through Ethernet]
Le PCX répond :
00H 01H 50H if the CPU is Main
(when duplicated CPU, the external application must always address the main CPU)
2.3.2. Initialisation du serveur
L'application externe envoie le message :
00H 02H 00H 00H ("INIT_REQ")
Le PCX répond :
03H 04H ("INIT_RSP")
Ed. 01 / 20-12-2006
5
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
2.4.
Maintien du dialogue de connexion (keep alive)
Pour contrôler que l'application distante est toujours présente, le PCX envoie des trames de test
toutes les 30 secondes .
Le PCX envoie le message:
54H 45H 53H 54H 5FH 52H 45H 51H ("TEST_REQ"")
L'application externe doit répondre avec le message :
00H 08H 54H 45H 53H 54H 5FH 52H 53H 50H("TEST_RSP")
Si deux messages 'TEST_REQ' restent sans réponse, le PCX considère que l'application externe ne
peut plus être jointe. Il coupe la connexion et libère les ressources associées.
Comme l'application externe est cliente, le dialogue doit être redémarré par l'envoi du message "S".
2.5.
Ticket de taxation
Quand un ticket est disponible, le PCX envoie le message :
TICKET_INFO avec data 772 octets
Un accusé réception est attendu du client via un message Ticket- ACK :
00H 02H 00H 03H
3.
INTERFACE & ARCHITECTURE
Netaccess est un process Unix (MIX) dans OmniPCX Enterprise. Il est l'interface entre le stack
TCP/IP les applications du PCX (CMIS, ABC-A, incidents et SvTSE*).
*SvTSE: server taxation via Ethernet.
Application 1
Application 2
Application 3
SvTSE
Serveur Netaccess
Stack TCP/IP
Pilote Ethernet
OmniPCX Enterprise
LAN
Application Client externe
ou
Simulateur ticket taxation Ethernet
TC0868
Figure 1
6
Ed. 01 / 20-12-2006
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
4.
OUTILS
4.1.
eaccclt
eaccclt est un utilitaire embarqué pour une aide au diagnostic ou pour obtenir des informations
sur le format du ticket.
Les tickets au fil de l'eau peuvent être affichés mais ne sont pas envoyés à ce stade sur le LAN.
Il est impératif de déconnecter l'application externe lors de l'utilisation de eaccclt.
> eaccclt
eaccclt - ethernet accounting client
eaccclt -[aelv]
-a attribute number
list of attributes to print.
-ascii
one ticket per line and ascii printing.
-cpu hostname|IP address
list of cpu.
-e accounting|mao
lists all known ticket editions.
-help
this help.
-l accounting|mao
meanings of the enumerated and bitstring attributes.
-time time limit
time limit in case of connection failure (default=15mn).
-v
prints the values of the attributes (default is meaning).
-waiting waiting time
waiting time after a connection failure (default=30s).
Les tickets générés peuvent être affichés au fil de l'eau :
Exemple
302)xa003002> eaccclt -cpu 10.41.3.53
connected to 10.41.3.53
---[10.41.3.53:1]------------------------------------------TicketVersion = ED5.1
CalledNumber = 0155666400
ChargedNumber = 6410
ChargedUserName = M Tailor
ChargedCostCenter =
ChargedCompany =
ChargedPartyNode = 302
Subaddress =
CallingNumber =
CallType = PublicNetworkCall (0)
CostType = 2
EndDateTime = 20051206 12:59:36
ChargeUnits = 2
CostInfo = 24
Ed. 01 / 20-12-2006
7
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
Duration
TrunkIdentity
TrunkGroupIdentity
TrunkNode
PersonalOrBusiness
AccessCode
SpecificChargeInfo
BearerCapability
HighLevelComp
DataVolume
UserToUserVolume
ExternalFacilities
InternalFacilities
CallReference
SegmentsRate1
SegmentsRate2
SegmentsRate3
ComType
X25IncomingFlowRate
X25OutgoingFlowRate
Carrier
InitialDialledNumber
WaitingDuration
EffectiveCallDuration
RedirectedCallIndicator
StartDateTime
ActingExtensionNumber
CalledNumberNode
CallingNumberNode
InitialDialledNumberNode
ActingExtensionNumberNode
TransitTrunkGroupIdentity
NodeTimeOffset
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
4
15
10
302
Normal (2)
PBXGeneratedChargeUnits (2)
Speech (2)
Telephony (1)
0
0
CallingLineIdentificationPresentation (0)
BasicCall (23)
33
0
0
0
Voice (1)
Unspecified (0)
Unspecified (0)
0
0
0
0
20051206 12:59:32
6410
9999
9999
9999
302
32767
0
Taper Ctrl C pour quitter l'utilitaire.
Les champs de chaque version de ticket peuvent être affichés :
Note
Édition du ticket = 5.1 à partir de la Release 3.2
(302)xa003002> eaccclt -e accounting
ED5.1
(00) TicketVersion..............[001-005]
(01) CalledNumber...............[006-035]
(02) ChargedNumber..............[036-065]
(03) ChargedUserName............[066-085]
(04) ChargedCostCenter..........[086-095]
(05) ChargedCompany.............[096-111]
(06) ChargedPartyNode...........[112-116]
(07) Subaddress.................[117-136]
(08) CallingNumber..............[137-166]
(09) CallType...................[167-168]
(10) CostType...................[169-169]
(11) EndDateTime................[170-186]
(12) ChargeUnits................[187-191]
(13) CostInfo...................[192-201]
(14) Duration...................[202-211]
TC0868
8
Ed. 01 / 20-12-2006
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
(15)
(16)
(17)
(18)
(19)
(20)
(21)
(22)
(23)
(24)
(25)
(26)
(27)
(28)
(29)
(30)
(31)
(32)
(33)
(34)
(35)
(36)
(37)
(38)
(39)
(40)
(41)
(42)
(43)
(44)
(45)
(46)
4.2.
TrunkIdentity..............[212-216]
TrunkGroupIdentity.........[217-221]
TrunkNode..................[222-226]
PersonalOrBusiness.........[227-227]
AccessCode.................[228-243]
SpecificChargeInfo.........[244-250]
BearerCapability...........[251-251]
HighLevelComp..............[252-253]
DataVolume.................[254-263]
UserToUserVolume...........[264-268]
ExternalFacilities.........[269-308]
InternalFacilities.........[309-348]
CallReference..............[349-358]
SegmentsRate1..............[359-368]
SegmentsRate2..............[369-378]
SegmentsRate3..............[379-388]
ComType....................[389-389]
X25IncomingFlowRate........[390-391]
X25OutgoingFlowRate........[392-393]
Carrier....................[394-395]
InitialDialledNumber.......[396-425]
WaitingDuration............[426-430]
EffectiveCallDuration......[431-440]
RedirectedCallIndicator....[441-441]
StartDateTime..............[442-458]
ActingExtensionNumber......[459-488]
CalledNumberNode...........[489-493]
CallingNumberNode..........[494-498]
InitialDialledNumberNode...[499-503]
ActingExtensionNumberNode..[504-508]
TransitTrunkGroupIdentity..[509-513]
NodeTimeOffset.............[514-519]
Simulateur du ticket taxation sur Ethernet
Cet utilitaire permet de simuler le dialogue avec l'OmniPCX Enterprise. Il peut être demandé par le
Support Technique Alcatel si nécessaire. Entrer la cpu@adresse et cliquer sur le bouton Connect.
Toutes les 30 secondes, vous devez voir 'Keep alive ACK' puis 'Keep alive demande'.
Le numéro de port du PCX destinataire est toujours 2533 et le numéro de port source est alloué
automatiquement à chaque nouvelle connexion.
Note
Cet utilitaire n'est pas vendu et est fourni comme tel. Alcatel-Lucent ne fournit pas de Support
Technique officiel pour cet utilitaire. Alcatel-Lucent ne s'engage pas à effectuer des corrections ou
modifications logicielles en cas de problèmes techniques.
Ed. 01 / 20-12-2006
9
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
5.
AIDE AU DIAGNOSTIC
5.1.
Alarmes
Dès que l'application externe est déconnectée, l'alarme suivante est affichée :
07/12/05 13:27:21 003002M|--/--/-/---|=0:2663=Erreur IPC Chorus : appli
SERV_APL oper 7 err -1
Quand l'application externe est déconnecté depuis longtemps, l'alarme suivante est affichée :
06/12/05
05:25:51
003002M|--/--/-/---|=2:0276=External
application ??? : NO RECOVERY
accounting
Cet incident est cyclique (toutes les 4 heures).
5.2.
Si aucun ticket n'est envoyé vers l'application externe
Si aucun ticket n'est envoyé vers l'application externe, la procédure suivante est suggérée :
Pour afficher les tickets, lancer l'utilitaire eaccclt avec les arguments suivants : (si l'application
externe est restée connectée, aucun ticket ne transitera sur le lien Ethernet).
1
Lancer les commandes :
eaccclt –cpu <adresse IP> (main @adresse ip est requise en cas de CPU dupliquée)
Ctrl C pour quitter.
2
Générer quelques tickets à partir d'une session telnet dans une autre fenêtre. Pour ce faire, vous
pouvez utiliser l'utilitaire account justif . Il est très utile de pouvoir générer quelques tickets.
Il n'est pas nécessaire d'effectuer des tickets départs à partir d'un poste téléphonique. Il suffit de
saisir le numéro taxé sur la première ligne et de faire des retours chariots sur les autres.
TC0868
10
Ed. 01 / 20-12-2006
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
3
Si aucun ticket n'est généré, vérifier la gestion de la taxation et les verrous. Sec reporter aux
paragraphes 1.1 & 1.2 .
Si les tickets sont correctement générés, cela signifie que la gestion de la taxation et les verrous sont
corrects. Aller au point 4 .
RAPPEL
Dans le cas d'un réseau PCX sans faisceau sur le nœud où la taxation au fil de l'eau est gérée, les
tickets doivent être renvoyés par l'exploitation 'Taxation sur le Nœud de l'usager' à partir du nœud où
est situé le faisceau.
Installation > Autres param.install.> Paramètres Taxation
Attribut: Ticket De Tax. Vers Nœud Usager = Tout ou Administratif ou Client
Tickets renvoyés si CPN # TN
TN = 201
Noeud 1
Lien ABC-F
Noeud 2
Numéro Réseau = 2
CPN = 201
Poste A avec CPN = 1
LAN client
CPN = 202
Application
Taxation
Poste B avec CPN = 2
Figure 2
CPN: Charged Party Node
TN : Trunk Node
Dans cet exemple (Figure 2), le paramètre Ticket De Tax. Vers Nœud Usager doit être
paramétré sur le nœud 1.
5.3.
4
Contrôle si les demandes keep alive sont envoyés toutes les 30 secondes
L'application externe ou le simulateur doit être connecté sur le PCX (si l'application externe était
restée connectée au point 1, les déconnecter puis les connecter à nouveau).
L'application externe est un client pour le PCX. Donc le client prend l'initiative en envoyant
TEST_REQ.
Les demandes keep alive font redémarrer le process netaccessd.
Ed. 01 / 20-12-2006
11
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
Le process netaccesd dépend lui-même du process xinetd.
Contrôler leur fonctionnement avec les commandes ci-après :
(302)xa003002> ps
root
597
mtcl
13779
(302)xa003002> ps
root
13665
root
13666
root
13669
root
13670
mtcl
13781
(302)xa003002>
-edf |grep xint*
1 0 Jan31 ?
00:00:00 xinetd -stayalive -reuse -pidfil
1912 0 08:53 ttyS0 00:00:00 grep xint*
-edf |grep netac*
597 0 08:40 ?
00:00:00 netaccessd
13665 0 08:40 ?
00:00:00 netaccessd
13665 0 08:40 ?
00:00:00 netaccessd
13665 0 08:40 ?
00:00:00 netaccessd
1912 0 08:53 ttyS0 00:00:00 grep netaccessd
Si les demandes keep alive TCP/IP fonctionnent correctement mais aucun ticket n'est toujours
pas transmis à l'application externe, le routage IP est peut être mauvais. Connecter directement
le simulateur ou l'application externe à l'accès Ethernet du PCX pour éviter un possible filtre
firewall ou un mauvais routage sur le LAN du client.
6.
LIMITES
Les tickets sont perdus dès que le buffer est plein ou si le lien est coupé.
7.
PROTOCOLE DE L'APPLICATION TAXATION ETHERNET
7.1.
Exemple
Note
Les demandes Keep alive ne sont pas représentées.
TC0868
12
Ed. 01 / 20-12-2006
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
SERVER
CLIENT
Write :
- 3 bytes length
- ‘S’
HEX >00 01 53
Read
Write :
- 3 bytes length
- ‘P’
HEX >00 01 50
Read
Write :
- 4 bytes length
- DEST_4400
- INIT_REQ
HEX >00 02 00 00
Read
Write :
- 2 bytes length
- DEST_EXT
- INIT_RSP
HEX >03 04
Read
Write :
- 772 bytes length
- DEST_EXT
- TICKET_INFO
HEX >XY ZW 01 02_ _ _ …
Read
Write :
- 4 bytes length
- DEST_4400
- TICKET_ACK
HEX >00 02 00 03
Read
Close
Close
Ed. 01 / 20-12-2006
13
TC0868
OmniPCX Enterprise
TAXATION AU FIL DE L'EAU SUR ETHERNET
TC0868
14
Ed. 01 / 20-12-2006