+
Cisco Network attivo Guida per l'utente di astrazione BQL, 3.6 Che cosa è BQL? Cisco BQL (Broadband Query Language) è un linguaggio di interfaccia macchina generica, attuato dal ANA Gateway di Cisco, per l'integrazione in direzione nord general-purpose. BQL copre tutte le funzionalità di Cisco ANA: • la comunicazione delle informazioni (ad esempio, l'inventario, la topologia, colpa, e così via.) L'interfaccia è basata su messaggi XML oltre i socket TCP. Tutti i dati inviati da e restituite dal sistema vengono formattati come messaggi XML, contenente IMO (informazioni modello interno di Cisco) oggetti di dati. Quick Start-BQL Basics Questa sezione descrive brevemente l'interfaccia BQL e fornisce un esempio di come usarlo per l'integrazione. Ciascuno degli argomenti cui si fa riferimento in questa sezione è elaborato nelle sezioni successive. La sezione descrive brevemente: • Come collegare all'interfaccia BQL. • Come formattare un comando. • Come eseguire un comando. • Come interpretare il risultato di un comando. • Come limitare il campo di applicazione di un comando. • Come registrarsi per le notifiche di modifica dei dati. Le spiegazioni di questa sezione sono accompagnati con i programmi software campione, scritto in Perl. Tuttavia, BQL non è limitato a qualsiasi linguaggio di programmazione specifico. Collegamento a BQL L'interfaccia BQL sta usando un trasporto socket TCP. L'ANA Gateway Cisco in ascolto per i tentativi di connessione in ingresso su una porta ben nota, come segue: Per aprire una sessione BQL, l'applicazione di collegamento deve autenticare la sessione utilizzando un nome utente e una password (che è stato precedentemente definito all'interno del sistema di Cisco). Il comando di autenticazione è: Di seguito è riportato un esempio di Perl di apertura e l'autenticazione di una sessione BQL, con l'ANA Gateway Cisco cui indirizzo IP è 192.168.2.110: Nota Il. \ N EOT (end-of-text) sequenza \ n, alla fine dei comandi, che saranno spiegate nella prossima sezione. Per scollegare dall'interfaccia BQL, digitare il comando: Quindi chiudere la connessione al ANA Gateway Cisco. Connessione a BQL tramite SSL L'interfaccia BQL sta usando il trasporto presa SSL. L'ANA Gateway Cisco in ascolto per i tentativi di connessione in ingresso su una porta ben nota, come segue: Quindi aprire una sessione BQL, vedere il collegamento alla sezione BQL. Comandi BQL Dopo la sessione BQL è autenticato, tutti i comandi e le risposte sono formattati come messaggi XML di solo testo. Ogni comando ha il seguente formato: Ogni comando deve terminare con un (EOT) sequenza di fine-di-testo, che è un & lt; NewLine & gt; carattere (& quot; \ n & quot;) seguito da un punto in una linea vuota, come segue: EOT: & quot; \ N \ n. & Quot; Pertanto, ogni comando avrà il seguente formato: La sequenza EOT è anche terminato tutte le risposte BQL. Tuttavia, quando si ricevono le notifiche non richieste, la sequenza EOT si trasforma in formato Notifica EOT: & quot; \ N $ \ n & quot; Le notifiche vengono ulteriormente spiegati nella sezione Definizione delle proprietà vs. aspetti. L'esempio seguente mostra un comando BQL che recupera l'elenco di tutti gli Nes gestite dal sistema. Il comando viene chiamato DEVICELIST e non ha parametri: Dopo aver inviato il comando precedente alla presa BQL, i blocchi di connessione presa fino al ANA Gateway Cisco termina l'elaborazione della query. Una volta terminato, l'ANA Gateway Cisco risponderà con la lista di tutti i dispositivi del sistema, e libererà la connessione per ulteriori domande. La risposta al comando DEVICELIST sarà, per esempio, come segue: La risposta XML sopra rappresenta una lista di due dispositivi (due interruttori Lucent CBX, con indirizzo IP 192.168.2.60 e 30.30.30.70). Gli oggetti di dati nella risposta si basano sul modello di informazioni IMO, che è Cisco il, informazioni generiche modello interno. L'elenco è un array di oggetti di tipo IMO IManagedElement (l'oggetto IMO che rappresenta un NE). Ogni tipo di entità di dati nel sistema Cisco ha un corrispondente tipo di oggetto IMO, che viene serializzato BQL in stringhe XML. Il set completo di tutti gli oggetti IMO è descritta nel Manuale di riferimento IMO. Vedere & quot; Understanding IMO & quot; e & quot; IMO Specifica & quot; Per ulteriori descrizioni di IMO. Dispositivo-List rapporto Esempio Di seguito è riportato l'esempio completo Perl per il recupero di un elenco dei dispositivi: La risposta al comando BQL viene restituito dalla presa di Cisco ANA Gateway come un flusso di dati. Pertanto, il programma deve eseguire un ciclo di lettura dalla presa in temporanea $ Recv variabile. e concatenare in il risultato $ risultato variabile. Il comando GET BQL Il comando più comunemente usato BQL è il comando GET. Si specifica l'OID (identificatore di oggetto) di una entità di dati nel sistema e restituisce le informazioni su questo oggetto. Il OID identifica in modo univoco qualsiasi entità dati nel sistema. Il comando GET può essere utilizzato non solo per segnalare un singolo oggetto, ma anche per la segnalazione di un costrutto di oggetti, che è una gerarchia di oggetti dati correlati (ad esempio un NE con tutte le sue carte e porte, un percorso servizio end-to-end eccetera.). Quando si recuperano i costrutti di dati, l'OID specificato funge da & quot; radice & quot; del costrutto, da cui sono attraversati gli oggetti correlati. Di seguito è riportato un esempio di un semplice comando GET: La query in questo esempio recupera le proprietà dell'elemento di rete (NE) identificata dal OID. Ha un ulteriore parametro, il recupero Specification (RS). La RS definisce la portata informazioni della query, specificando quale tipo di IMO oggetti da recuperare, quale oggetto i rapporti di attraversare, e ciò che oggetti da includere / escludere per ogni oggetto restituito. La specifica di recupero è una stringa XML con il seguente formato: In questo esempio, la RS specifica il recupero delle sole proprietà del dispositivo (indirizzo IP, tipo, Venditore, uptime, ecc). L'uscita di quanto sopra BQL GET esempio (proprietà del dispositivo dell'elemento di rete la cui chiave è & quot; Fore251Lab & quot;) si presenterà nel modo seguente: La specifica di recupero consente la registrazione per le notifiche di modifica sugli oggetti specificati. Quando si specifica registro = true nella RS, la piattaforma ANA monitorerà cambiamenti in tutti gli oggetti definiti nell'ambito RS. Ogni volta che rileva un cambiamento in uno qualsiasi degli oggetti invia una notifica non richiesta di cambiamento. Si consideri, ad esempio, la notifica seguente: Questa notifica indica che la SysName proprietà è cambiata, nell'oggetto IMO di tipo IManagedElement. del NE & quot; ASAMLab & quot ;. Ulteriori dettagli sul recupero specifiche e le notifiche possono essere trovati in sezioni specifiche di recupero e specificare le proprietà vs. aspetti. Integrazione Sequenza riassume i passi di integrazione utilizzando il BQL. I passi sono: Passo 1 socket aperto TCP all'interfaccia BQL. Passo 2 Autenticarsi utilizzando username e password. comandi Fase 3 Invia BQL al ANA Gateway Cisco. Fase 4 ricevere e analizzare i risultati restituiti. Fase 5 opzionale: Registrati e ricevere le notifiche di modifica. Passo 6 chiudere la connessione con l'interfaccia BQL. Figura 1-1 Integrazione Sequence
No comments:
Post a Comment