Serial buffer SS100 per BI4Data

Transcript

1 Serial buffer SS100 per BI4Data Guida introduttiva SS100 v / 12

2 Serial buffer SS100 per BI4Data Il serial buffer SS100 è un dispositivo configurabile per l'acquisizione e la bufferizzazione di dati provenienti da un centralino telefonico mediante interfaccia seriale, socket IP (client o server) o FTP. Il dispositivo SS100 dispone di una capacità di memorizzazione massima di 2 MByte ed è configurabile per la trasmissione ad intervalli regolari via FTP, verso un PC server del Cliente, o via SCP, verso i server per la raccolta dati legati al servizio BI4Data. È possibile impostare due tipi di soglie, superate le quali, viene effettuato il trasferimento: dimensione minima dei dati acquisiti per il trasferimento e periodo massimo per il trasferimento. Il primo parametro ritarda la trasmissione dei dati finché la dimensione degli stessi non abbia raggiunto o superato il valore impostato. Il secondo parametro forza la trasmissione dei dati se è trascorso il tempo indicato rispetto all'ultimo trasferimento dati, indipendentemente dal fatto che sia stata raggiunta la soglia relativa alla quantità minima di dati. Il raggiungimento di una delle condizioni indicate viene periodicamente controllato in base al periodo impostato per il controllo del trasferimento dati. Specifiche porta seriale SS100 La porta seriale del dispositivo SS100 è conforme agli standard RS232, RS422 e RS485. Nella tabella successiva è illustrata l'assegnazione dei PIN nel connettore DB9. PIN RS232 RS424 RS TX- Data- 2 RX 3 TX RX- 4 DTR RX+ 5 GND 6 DSR 7 RTS 8 CTS 9 - TX+ Data+ Connessione Il buffer SS100 può essere configurato sia mediante interfaccia seriale, conforme agli standard RS232/RS424/RS485, che mediante una porta Ethernet 10/100. Si consiglia di utilizzare la procedura di configurazione seriale solo per configurare i parametri relativi al protocollo TCP/IP nel caso in cui non siano noti e configurare i rimanenti parametri mediante l'interfaccia web. Per la connessione via seriale attenersi alla seguente procedura: 1. Collegare l'alimentatore al buffer SS Collegare il cavo seriale di console (incluso nella confezione) alla porta seriale DB9 del buffer SS Attendere che i LED Power e Ready siano accesi. 4. Collegare l'altro capo del cavo seriale di console alla porta seriale del PC e assicurarsi di posizionare lo switch Data/Console di colore rosso in posizione Console. Ricordarsi di riportarlo in posizione Data al termine dell'operazione di configurazione. 2 / 12

3 Posizione Console Posizione Data Layout del connettore DB9 seriale dell'ss100 Configurazione mediante console seriale 1. Avviare un applicativo di emulazione terminale (p. es. HyperTerminal) ed impostare i parametri di configurazione seriale come segue: Bit per secondo = 9600, Bit di dati = 8, parità = Nessuna, Bit di stop = 1, Controllo di flusso = nessuno. 2. Premere il tasto Invio per attivare la connessione verso il buffer SS Immettere Username e Password. I valori di default sono admin per lo username e bi4data per la password, eventualmente modificabili. 4. Attraverso l'interfaccia a caratteri è possibile, ad esempio, modificare l'impostazione di default dell'indirizzo IP mentre le altre impostazioni è consigliabile modificarle mediante interfaccia web in quanto più semplice ed intuitiva login as: admin Password: Welcome to SS-100 configuration page Current time: 11/20/ :29:19 F/W REV.: v1.4.1 Serial No.: SS MAC address: ff-ff-ff IP mode: Static IP IP address: Select menu: 1. Network configuration 2. Serial port configuration 3. System administration 4. Save changes 5. Exit without saving 6. Exit and apply changes 7. Exit and reboot <Enter> Refresh ---> Per procedere alla modifica delle impostazioni è necessario premere il tasto corrispondente alle funzionalità che si desidera modificare. Configurazione indirizzo IP Le impostazioni di rete di default del buffer SS100 sono: IP statico , 3 / 12

4 subnet mask default gateway Per modificare le impostazioni procedere come segue Network configuration Select menu: 1. IP configuration 2. SNMP configuration 3. Dynamic DNS configuration 4. SMTP configuration 5. IP filtering configuration 6. SYSLOG configuration 7. NFS configuration 8. Web server configuration 9. Ethernet configuration 10. TCP service configuration <ESC> Back, <Enter> Refresh ---> 1. Selezionare il menu 1. Network configuration nel menu principale digitando il tasto Selezionare il sottomenu 1. IP configuration dal menu Network configuration digitando il tasto Modificare i parametri in base alle impostazioni della rete in cui deve essere installato il buffer SS Network configuration --> IP configuration Select menu: 1. IP mode: Static IP 2. IP address: Subnet mask: Default gateway: Primary DNS: Secondary DNS: <ESC> Back, <Enter> Refresh ---> 1 Select mode: 1. Static IP 2. DHCP 3. PPPoE ---> Network configuration --> IP configuration Select menu: 1. IP mode: Static IP 2. IP address: Subnet mask: Default gateway: Primary DNS: Secondary DNS: <ESC> Back, <Enter> Refresh ---> I casi più comuni sono Static IP, se la rete dispone di indirizzi IP fissi, e DHCP, se nella rete è presente un DHCP server. Nel primo caso sarà necessario impostare correttamente i parametri relativi a IP address, Subnet mask, Default gateway e DNS server. In entrambi i casi prendere nota dell'indirizzo IP impostato sul dispositivo SS100 (si noti che 4 / 12

5 l'indirizzo IP assegnato nel caso DHCP potrebbe comunque variare nel tempo, per esempio il server DHCP potrebbe modificare l'indirizzo IP alla scadenza del tempo di lease). 4. Ritornare al menu principale premendo Esc. 5. Selezionare la voce 6. Exit and apply change per salvare ed applicare le modifiche alla configurazione del buffer SS100. Configurazione mediante Browser Internet La configurazione mediante interfaccia seriale è particolarmente utile per poter configurare l'indirizzo IP desiderato sul dispositivo o per sapere qual è l'indirizzo IP corrente del dispositivo, mentre per tutte le altre impostazioni è conveniente usare l'interfaccia utente accessibile attraverso un browser Internet. Per potersi collegare con questa modalità è necessario che il PC e il buffer SS100 siano connessi mediante un cavo Ethernet incrociato o siano collegati, sulla stessa rete dati, usando un hub o uno switch, e che gli indirizzi IP di entrambi siano all'interno della stessa sottorete (potrebbe essere necessario modificare temporaneamente l'indirizzo IP del PC in o simile). Una volta impostati correttamente i parametri per la connessione via rete LAN potrà essere possibile configurare il dispositivo SS100 mediante la seguente procedura: 1. Avviare un browser Internet (Internet Explorer o Mozilla Firefox) ed inserire nella barra dell'url l'indirizzo IP del buffer SS100 (p. es Immettere Username e Password. I valori di default sono admin per lo username e bi4data per la password e premere sul pulsante Login 3. Nella pagina Network->IP Configuration è possibile impostare i parametri desiderati relativamente alla configurazione IP. 4. Nel caso di acquisizione da porta seriale è possibile configurare i parametri di acquisizione mediante la pagina Serial port->configuration->serial port parameters. 5 / 12

6 La velocità massima consigliata (baud rate), per il collegamento seriale ad un centralino, è Assicurarsi che i parametri impostati sul centralino siano esattamente gli stessi di quelli impostati sul dispositivo SS100 in modo da evitare perdita di dati o acquisizioni errate. Sarà possibile verificare la corretta ricezione dei CDR (Call Data Record) trasmessi dal centralino al dispositivo SS100 attraverso il link View collected data. 5. Nel caso di acquisizione da porta IP in modalità server è possibile configurare i parametri di acquisizione mediante la pagina Serial port->configuration->host mode configuration configurando i parametri Host mode, che deve essere impostato su TCP, e TCP listening port su cui il dispositivo SS100 dovrà rimanere in ascolto e ricevere i dati. 6 / 12

7 Gli altri parametri devono essere lasciati con i valori di default, mentre sul dispositivo che trasmette dovrà essere impostato l'indirizzo IP assegnato all'ss100 e la porta su cui quest'ultimo è in ascolto per ricevere i dati. 6. Nel caso di acquisizione da porta IP in modalità client è possibile configurare i parametri di acquisizione mediante la pagina Serial port->configuration->remote host configuration configurando i parametri Primary host address, che è l'indirizzo del centralino a cui è necessario collegarsi via IP, Primary host port su cui il dispositivo SS100 dovrà connettersi per ricevere i dati. 7. La Customer page consente di configurare le impostazioni per l'acquisizione dei dati ed il relativo trasferimento verso il server su cui è installato BI4Data. Si noti che tutti i campi sono case sensitive. Il parametro Data collection mode dispone di tre modalità: Serial port, IP port e FTP. In base alla scelta fatta saranno mostrate le opzioni relative. Nel caso di acquisizione da porta seriale è disponibile il parametro ACOM che se abilitato permette di acquisire correttamente i dati provenienti dai centralini che supportano tale parametro, mentre gli altri parametri di configurazione, relativi alla velocità, parità, bit dati e bit di stop della porta seriale potranno essere configurati mediante il link SS100 Serial port configuration page come descritto nel punto 4. 7 / 12

8 Nel caso di acquisizione da porta IP sarà possibile configurare i parametri della porta IP (indirizzo IP, porta IP, accesso in modalità client o server, ecc...) mediante il link SS100 IP port configuration page come già indicato ai punti 5 e 6. Nel caso di acquisizione in modalità FTP sarà necessario specificare i necessari parametri affinché sia possibile l'acquisizione dal centralino in questa modalità. Sarà infatti necessario specificare il Device FTP address[:port] ovvero l'indirizzo IP ed eventualmente la porta IP (port), nel caso sia diversa dalla porta 21, a cui connettersi per la lettura dei call data record (nel formato indirizzo:porta). Inoltre è necessario specificare i campi relativamente a Device FTP username, a Device FTP password e Device FTP filename, completo di percorso, per il file da trasferire. Il nome del file può essere eventualmente completo di percorso (p. es. dati/addebiti.txt o /dati/addebiti.txt o anche \dati\addebiti.txt) o può utilizzare un carattere jolly posto alla fine del nome del file (p. es. addebiti.* o dati/addebiti* o \dati\addebiti.*). In quest'ultimo caso il carattere jolly (*) può comparire una sola volta e deve essere l'ultimo carattere del campo. Il parametro Device FTP check period (m) esprime l'intervallo di tempo minimo tra un trasferimento e l'altro. 8. Il parametro Transfer mode permette di impostare la modalità con cui saranno trasferiti i dati bufferizzati dall'ss100. Nel caso di trasmissione dati via FTP è necessario specificare il Remote host address [:port] (indirizzo IP) ed opzionalmente la porta IP (port), nel caso sia diversa dalla porta 21, da utilizzare per il trasferimento FTP (nel formato indirizzo:porta). Inoltre è necessario specificare i campi relativamente a Remote FTP username, a Remote FTP password e Destination filename, completo di percorso per il file da trasferire (p. es. /datitel/addebiti.txt o addebiti.txt), il Chek period for transfer (s) (periodo di controllo per trasferimento dati), la Minimum file size for transfer (Kb) (dimensione minima del file contenente i dati affinché venga trasferito) ed il Maximum period for transfer (m) (intervallo di tempo massimo tra due trasferimenti). 8 / 12

9 Nel caso il dispositivo SS100 venga utilizzato per il trasferimento dati per il servizio BI4Data sarà utilizzata la modalità di trasferimento via SCP. In generale i valori da impostare per i parametri sono i seguenti: Remote host address:[port] = cdr.bi4data.com:1022, Remote backup host address:[port] = cdrbak.bi4data.com:1022. Come per il trasferimento in modalità FTP è possibile personalizzare i parametri per la gestione delle tempistiche di trasferimento, il Chek period for transfer (s) (periodo di controllo per trasferimento dati), la Minimum file size for transfer (Kb) (dimensione minima del file contenente i dati affinché venga trasferito) ed il Maximum period for transfer (m) (intervallo di tempo massimo tra due trasferimenti). Dal punto di vista del router attraverso cui avviene connessione ad Internet della rete del Cliente, i prerequisiti per un corretto funzionamento della trasmissione dati sono i seguenti: - la porta IP 1022 deve essere aperta verso gli indirizzi IP pubblici con il protocollo TCP per consentire il trasferimento dati verso i server BI4Data; - la porta IP 123 deve essere aperta verso gli indirizzi IP pubblici con il protocollo UDPper consentire la sincronizzazione dell'orologio interno dell'ss100. Se la connessione di rete è disponibile, il dispositivo SS100 cercherà di trasmettere i dati in base a quanto impostato. Nel caso in cui la connessione non fosse disponibile o per qualche motivo il server verso cui si tenta di trasmettere non sia disponibile in linea, il dispositivo SS100 continuerà ad acquisire dati fino al raggiungimento della sua capacità massima (2 Mbyte) e tenterà periodicamente di effettuare il trasferimento secondo quanto specificato nel parametro Check period for transfer. Dalla schermata di configurazione del trasferimento dati è possibile ritornare all'interfaccia per la configurazione della porta seriale attraverso il link SS100 Serial port configuration page mentre si può accedere agli altri parametri del dispositivo SS100 tramite il link SS100 configuration page. Funzionalità aggiuntive dell'ss100 Dalla schermata principale di configurazione del dispositivo SS100 è anche possibile accedere a delle funzionalità aggiuntive: Visualizzazione dei dati acquisiti e presenti nella memoria del buffer. Trasferimento forzato dei dati Aggiornamento del software del dispositivo stesso Visualizza dati acquisiti Cliccando sul link View collected data sarà visualizzata una schermata che mostra la memoria attualmente occupata ed i primi byte di dati presenti in memoria o in attesa di trasferimento verso il server FTP. Da questa interfaccia è anche possibile aggiornare la visualizzazione dei dati presenti in modo da verificare la costante ricezione dei dati, o cancellare i dati memorizzati nel caso, ad esempio, fossero stati acquisiti ad una velocità non corretta. 9 / 12

10 Nel caso in cui i dati vengano cancellati al termine dell'operazione verrà visualizzato un messaggio di conferma. Trasferimento forzato Attraverso il link Transfer data now è possibile effettuare un trasferimento di prova, a prescindere dai parametri impostati nella schermata di configurazione principale, che permette di verificare se il dispositivo SS100 è in condizioni di eseguire un trasferimento dati corretto. Il trasferimento non è istantaneo. Attendere almeno un paio di minuti e, nel caso di trasferimento dati andato a buon fine, comparirà una schermata riportante la dicitura Data transfer OK, mentre nel caso in cui il trasferimento non vada a buon fine, trascorso il tempo di time out di 5 minuti, il messaggio riporterà la dicitura Data transfer failed. Nel caso di trasferimento dati in modalità FTP verificare che: l'indirizzo IP del server FTP verso cui viene eseguito il trasferimento sia corretto. 10 / 12

11 il servizio FTP sia opportunamente configurato sul server. il firewall del server FTP sia opportunamente configurato in modo da consentire l'apertura delle porte IP necessarie al trasferimento dati via FTP in modalità passiva, se possibile, o almeno in modalità attiva. i parametri immessi relativamente ad username e password siano corretti il server FTP sia effettivamente connesso alla rete LAN Per verificare se il server è effettivamente raggiungibile provare ad effettuare una connessione via ftp dalla shell di Windows collegando un PC al posto dell'ss100 con la stessa configurazione IP. Nel caso di trasferimento in modalità SCP verificare che: l'indirizzo IP del server BI4Data verso cui viene eseguito il trasferimento sia corretto. il dispositivo SS100 sia effettivamente connesso alla rete LAN e sia abilitato ad uscire verso la rete Internet sulla porta Per verificare se il server è effettivamente raggiungibile dal dispositivo SS100 provare ad effettuare una connessione via telnet dalla shell di Windows collegando un PC al posto dell'ss100 con la stessa configurazione IP. Il comando da digitare è il seguente: telnet cdr.bi4data.com 1022 Nel caso in cui la connessione non abbia successo comparirà un messaggio di errore che indica la necessità di verificare la configurazione della rete del Cliente: potrebbe essere necessario aprire delle porte sul router/firewall del Cliente. Nel caso in cui la connessione viene stabilita con successo, mentre il dispositivo SS100 non riesce a trasferire dati, ricontrollare la configurazione IP dell'ss100. Aggiornamento software Attraverso il link Data filter update è possibile aggiornare il software di gestione delle funzionalità di data transfer del dispositivo SS100. La maschera propone già i dati relativi al server ftp di BI4Data, ma è possibile modificarli nel caso si voglia utilizzare un altro server FTP. Al termine della procedura di update sarà necessario eseguire il reboot del dispositivo. Si noti che i dati di configurazione saranno reimpostati al valore di default per cui, se necessario, prendere nota delle impostazioni dell'ss100 prima di procedere all'upgrade. 11 / 12

12 In generale è necessario ricaricare il file di configurazione attraverso.l'apposita funzionalità disponibile nel menu System administration->configuration management->configuration import. 12 / 12