eXplorer 2 - MPS Monitor
Transcript
eXplorer 2 - MPS Monitor
eXplorer 2 Manuale dell’ Installatore e Technical Reference Ver. 2.2.6 del 14 Dicembre 2012 1 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Indice 1. Descrizione del sistema e Requisiti hardware e software per l’installazione ....................................... 4 1.1 Descrizione del sistema MPS Monitor ........................................................................................... 4 1.2 Caratteristiche tecniche del modulo eXplorer .............................................................................. 4 1.3 Requisiti hardware......................................................................................................................... 5 1.4 Requisiti software .......................................................................................................................... 5 2 Dati necessari per l’installazione ........................................................................................................... 6 2.1 Codice di attivazione cliente .......................................................................................................... 6 2.2 Dati relativi alla rete da scansionare ............................................................................................. 6 3 Esecuzione dell’installazione ................................................................................................................. 7 4 Verifica della correttezza dell’installazione ......................................................................................... 12 4.1 Eseguire manualmente il task di scansione e verificare i dati raccolti: ....................................... 12 4.2 Eseguire manualmente il task di invio dei dati raccolti al portale. .............................................. 13 4.3 Verificare che il registro eventi applicazioni sia sempre scrivibile .............................................. 14 5 Eseguire l’aggiornamento di eXplorer 2 .............................................................................................. 16 6 Modifica dei risultati di scansione tramite i file di controllo ............................................................... 17 6.1 – File “exclusions.txt”. ................................................................................................................. 17 6.2 – File “overrides.csv”. .................................................................................................................. 17 7 Ottenere supporto remoto per l’installazione .................................................................................... 19 Appendice A – Verifica problemi più comuni .............................................................................................. 20 1. Mancata generazione del file di output .......................................................................................... 20 2. Mancato invio del file di output al portale. ..................................................................................... 23 3. Le stampanti rilevate sono meno del previsto .................................................................................... 24 Appendice B – Utilizzare il portale MPS Monitor per la risoluzione di problemi sull’ eXplorer .................. 25 Appendice C – Cosa fare quando non arrivano i dati delle printer ............................................................. 27 1. Verifiche sul PC/Server eXplorer ..................................................................................................... 27 2 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 2. Verifiche sulle printer non raggiunte o non rilevate ....................................................................... 29 3. Come essere avvisati automaticamente via mail di eventuali problemi su eXplorer 2 .................. 30 Appendice D – Tipologie di installazione di eXplorer 2 ............................................................................... 32 Installare eXplorer 2 su clienti che hanno più reti non connesse fra loro ............................................... 32 Installare eXplorer 2 su una singola sede in cui si trova più di un cliente ............................................... 33 Appendice E – Job di lettura printer USB .................................................................................................... 34 Descrizione del processo di scansione di una stampante USB ................................................................ 34 Versioni di eXplorer LA e procedure di installazione/disinstallazione .................................................... 35 Il file di configurazione INI ....................................................................................................................... 39 Appendice F – Linea di comando ................................................................................................................. 40 1. Scansione delle stampanti ............................................................................................................... 40 2. Invio del file csv prodotto: ............................................................................................................... 40 3. Parametri avanzati........................................................................................................................... 40 4. Parametri per lettura dati stampanti USB ....................................................................................... 41 Riferimenti AB Asset Management srl Per maggiori informazioni e supporto tecnico potete contattare: www.abasset.it www.mpsmonitor.it/supporto.shtml Sede Legale: Via Borromei 2 – 20123 Milano Posta Certificata: [email protected] Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 Centro di Sviluppo Software : Via dei Pelati, 16 – Castel Mella (BS) Tel. 030.25.50.164 | Fax. 030.40.77.046 Centro di Supporto eXplorer : Via Iazzitiello, 15/c – 70090 Santeramo in Colle (BA) Tel. 080.20.44.330 3 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Per ottenere supporto remoto sull’ eXplorer: effettuare il Download del modulo eXplorer Quick Support: www.abasset.it/docs/explorerQS.exe comunicare l’ ID che compare a video alla casella [email protected] 1. Descrizione del sistema e Requisiti hardware e software per l’installazione 1.1 Descrizione del sistema MPS Monitor Il sistema MPS Monitor si compone di 2 parti: • Agente di rete eXplorer: questa componente va installata su un PC o server nella LAN del Cliente ed effettua le operazioni di lettura seguendo le indicazioni fornite dalla componente server e/o inserite in fase di installazione. Le informazioni sono trasmesse verso le componenti Server utilizzando il protocollo http o https. Il software Client utilizza, per la lettura, il protocollo SNMP. E' requisito essenziale per l' espletamento del servizio che il Client abbia accesso Internet via http alle componenti Server. • Server MPS Monitor: La componente Server è residente presso una Server Farm remota in modalità Cloud presso un Data Center che garantisce i migliori requisiti di affidabilità e sicurezza. Il Server in Cloud rende disponibile un sito Web dedicato, accessibile tramite protocollo HTTP/HTTPS ed autenticazione con utenza e password, con differenti profili di sicurezza degli accessi. Mediante l' accesso al Server è possibile effettuare tutte le operazioni di gestione delle printer e degli Alert, e produrre tutte le reportistiche disponibili sia in formato Excel che PDF 1.2 Caratteristiche tecniche del modulo eXplorer La raccolta dei dati delle printer viene effettuata utilizzando il software eXplorer 2.0, che ha le seguenti caratteristiche tecniche e funzionalità: 1. Viene installato su un server / PC interno alla rete del cliente, che abbia accesso ad Internet (http) e che possa raggiungere via rete le stampanti utilizzando il protocollo SNMP (porta 161 / UDP) 2. Effettua ad orari prefissati e configurabili (generalmente due/tre volte al giorno) una scansione delle sottoreti dove possono essere presenti le printer 3. Identifica tutti i dispositivi di tipo Stampante, mentre tralascia completamente tutti gli altri dispositivi di rete 4. La raccolta dati dura generalmente pochi secondi o pochi minuti, a seconda della complessità della rete e del numero di dispositivi. 5. Non genera alcun impatto avvertibile sulla rete e sui dispositivi, in quanto il traffico generato è minimale, grazie all’ uso di UDP. 6. I dati raccolti dalle stampanti vengono memorizzati in un file di testo formato CSV, che viene memorizzato in chiaro nella cartella \send del percorso di installazione dell’ eXplorer 2.0; in questo modo il cliente può avere accesso ai file e verificare quali informazioni vengono rilevate ad ogni lettura. 4 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 7. In casi particolari in cui vengono riscontrati problemi nella lettura dei dati di un modello di stampante, il sistema genera dei file aggiuntivi con le informazioni sull’ intero MIB della stampante in questione, utilizzando il comando SNMPWalk; tali file, aventi estensione .WLK, ci permettono di identificare e risolvere problemi nella lettura dei dati. 8. I file CSV e WLK vengono trasferiti ai server MPS Monitor in Cloud via https. Tutte le comunicazioni tra eXplorer 2 ed il portale internet di MPS avvengono unicamente su protocollo https. 9. I dati presenti nei file vengono utilizzati per aggiornare il Database che gestisce le printer del Cliente. Nessun accesso può essere effettuato, in nessun caso, dall’ esterno verso l’ interno della rete del Cliente, dopo il completamento dell’ installazione. Di conseguenza, l’ installazione dell’ eXplorer 2.0 all’ interno della rete del Cliente non comporta alcun rischio per la sicurezza della rete stessa. 1.3 Requisiti hardware I requisiti hardware minimi per il PC/Server dove risiede l’ eXplorer 2.0 sono i seguenti: RAM: 1GB CPU: Pentium 4 Spazio HD: circa 50 MB I requisiti hardware consigliati sono: RAM: 2 GB CPU: Dual core Spazio HD: 100 MB Il Server deve avere accesso stabile ad Internet tramite http e poter raggiungere via rete le printer da gestire. NOTA: nel caso si abbiano molte stampanti da scansionare e si vogliano tempi di scansione ridotti vale la regola maggior hardware -> migliori prestazioni . eXplorer 2 infatti ha una velocità di scansione proporzionale all’hardware messo a disposizione e alla misura in cui si intende utilizzarlo. 1.4 Requisiti software Va bene qualunque sistema operativo da Windows 2003/XP in su. E’ necessario installare il Microsoft .Net Framework 4.0 scaricabile al seguente indirizzo: http://www.microsoft.com/downloads/it-it/details.aspx?FamilyID=0a391abd-25c1-4fc0-919fb21f31ab88b7 5 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Sui sistemi Windows Server 2003 ed XP non aggiornati e’ possibile che l’installazione del .NET Framework 4.0 fallisca, in quanto non e’ installato l’aggiornamento di Windows WIC (Windows Imaging Component). Ove necessario, potete scaricare questo aggiornamento da qui: http://www.microsoft.com/downloads/en/details.aspx?FamilyID=8e011506-6307-445b-b950215def45ddd8&displaylang=en 2 Dati necessari per l’installazione 2.1 Codice di attivazione cliente Per procedere all’installazione occorre innanzi tutto procurarsi il codice di attivazione cliente. Il codice viene fornito tramite l’ apposita funzione del sito MPS Monitor – Creazione nuovo Cliente, oppure direttamente dal nostro supporto tecnico, inviando una richiesta alla casella mail [email protected] , ed indicando il nominativo, ragione sociale e/o codice con cui si vuole identificare il cliente. Il codice fornito ha valore di licenza e verrà utilizzato dal software per controllare la validità della stessa ad ogni avvio. La licenza può essere verificata solo in presenza di una connessione internet via http. Il software non funzionerà in assenza di un codice di attivazione cliente valido. 2.2 Dati relativi alla rete da scansionare Per poter procedere all’installazione occorre conoscere i seguenti dati relativi alla rete da scansionare : La lista di ip o di intervalli di rete in cui si trovano le stampanti (nel caso vengano forniti intervalli il software si occupera’ di trovare automaticamente le stampanti). Eventuali credenziali di un proxy autenticato, qualora fosse presente, per accedere ad internet (il software si collega ad internet per verificare la validita’ della licenza e per inviare i dati raccolti al portale). Eventuali credenziali di un utente con diritti amministrativi sulla macchina locale, qualora si intenda eseguire il software con un account dedicato. 6 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 3 Esecuzione dell’installazione Per installare eXplorer 2 , eseguire i seguenti passaggi dopo aver raccolto i dati indicati nel precedente capitolo. 1. Scaricare il setup di eXplorer 2 dal seguente link: http://www.abasset.it/docs/explorer2setup.zip NOTA: scaricate sempre il setup dal sito ad ogni installazione per essere sicuri di utilizzare l’ultima versione! Il software infatti è in costante aggiornamento. 2. Estrarre dal pacchetto scaricato il file explorer2setup.msi ed eseguirlo con privilegi di amministratore. 3. Nella seguente finestra cliccare su Avanti: 4. Accettare le condizioni di licenza e cliccare su Avanti: 7 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 5. Verificare il percorso di installazione e cliccare su Avanti: 6. Cliccare su Avanti: 8 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 7. Inserire nella seguente schermata tutte le informazioni necessarie secondo le istruzioni di seguito riportate: 1) Codice di attivazione cliente All’interno della casella di testo “Customer” occorre digitare il codice di attivazione cliente. Tale codice e’ essenziale per il funzionamento di eXplorer 2.0 in quanto viene utilizzato per rilevare sul server centrale su internet la validita’ della licenza. Un errore di sintassi in questa casella provochera’ il mancato funzionamento di eXplorer 2.0. Il codice viene fornito tramite l’ apposita funzione del sito MPS Monitor – Creazione nuovo Cliente, oppure direttamente dal supporto tecnico, inviando una richiesta alla mail [email protected]. 2) Autenticazione proxy Nel caso il server acceda ad internet tramite un proxy con autenticazione utente, occorre attivare il flag “Use proxy authentication”. Inserire nei riquadri “User” e “Password” rispettivamente l’utente e la password per autenticarsi al proxy. L’indirizzo ip del proxy viene prelevato direttamente dalla configurazione di internet explorer. 9 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 3) Numero massimo processi e thread (performance). Selezionare il numero massimo di processi paralleli da avviare durante la scansione tramite “MAX Processes” , e il numero massimo di thread paralleli per processo tramite “MAX Threads”. Si consiglia di lasciare i valori di default durante l’installazione. In seguito sara’ possibile modificare tali parametri se sono richiesti tempi di esecuzione piu’ rapidi (ad esempio quando si scansionano centinaia di stampanti per piu’ volte durante la giornata). Per la modifica successiva di questi paramentri fare riferimento al punto successivo “d” per determinare il file batch da modificare, e alla guida “Linea di comando” per i parametri da utilizzare. 4) Creazione del file batch per la scansione Cliccare sul pulsante “Crea CMD”. Cliccando su questo pulsante viene creato all’interno della directory di installazione di eXplorer 2.0 il file batch “runagent.cmd” contenente la riga di comando utilizzata per lanciare le scansioni. Questa riga fa uso dei parametri inseriti nei punti precedenti. Il pulsante “Crea CMD” va premuto quindi solo dopo aver inserito i giusti parametri. E’ possibile modificare manualmente il file “runagent.cmd”. Si raccomanda la lettura di “Linea di Comando” per modificare il file batch. 5) Inserimento lista reti da scansionare Inserire nella casella di testo “Lan” la lista di intervalli di rete, o indirizzi ip, sulle quali verranno ricercate le stampanti. Utilizzare la sintassi della riga di esempio per inserire le reti. 6) Creazione file .def per la lista di reti da scansionare Cliccare sul pulsante “Crea DEF”. Cliccando su questo pulsante viene creato all’interno della directory di installazione di eXplorer 2.0 il file “<CODICE_CLIENTE>.def” , contenente cio’ che e’ stato inserito nella casella al punto precedente 5 . Cliccare quindi su questo pulsante solo dopo aver inserito la lista di reti da scansionare nella casella “Lan” . E’ possibile inserire le reti secondo le seguenti sintassi: Scansione di un’intera sottorete: 192.168.1.1-254 192.168.1.xxx 192.168.1.xxx 255.255.255.0 Nota: la subnet mask è opzionale; ha solo una funzione di organizzazione visiva dei dati nel file risultante di output ma non viene interpretata in nessun modo dal software. Scansione di un intervallo o più intervalli di indirizzi IP: 192.168.1.10-40 scansione dell’intervallo di ip compreso tra 192.168.1.10 e 192.168.1.40 10 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 192.168.15-25.60-100 scansione di tutte le sottoreti comprese tra 192.168.15.60-100 e 192.168.25.60100 . In ciascuna di queste sottoreti viene scansionato l’intervallo di ip compreso tra 60 e 100 come valore finale Scansione di un solo indirizzo IP o di una lista: 192.168.1.56 192.168.1.76 vengono scansionati in questo modo solamente gli ip indicati nella lista Considerare che l’inserimento della subnet mask è opzionale in tutti i casi e ha solo una funzione organizzativa dei dati. Infatti il file di output creato dalla lista di indirizzi ha formato testuale e può essere modificato con qualunque editor di testo. Nel caso venga inserita anche la subnet mask questa dovrà essere separata da uno o più spazi o dal carattere TAB. 7) Schedulazione orari scansioni Inserire nella casella “Ora schedulazione SNMPAgent “HH”” l’ora in cui si intende lanciare la scansione delle reti. Cliccare quindi sul pulsante “Crea” per creare il task schedulato di Windows che lancera’ la scansione in automatico. Se si intende avviare piu’ scansioni nell’arco della giornata, ad ogni inserimento dell’ora di esecuzione cliccare sempre su “Crea”. Per visualizzare ulteriori dettagli del task creato (utente di esecuzione, minuto di esecuzione, ecc.) cliccare su “Mostra”. 8) Schedulazione orari per upload dei dati al server centrale In “Ora schedulazione Data upload “HH”” inserire l’ora desiderata per l’invio al server centrale dei dati raccolti durante la scansione. Per l’esecuzione di piu’ invii giornalieri e l’inserimento di ulteriori opzioni valgono le stesse considerazioni al punto 7. Cliccare su “chiudi” e terminare il setup. Al termine di questa procedura è altamente consigliato eseguire una verifica della correttezza dell’installazione, descritta al successivo capitolo. 11 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 4 Verifica della correttezza dell’installazione Dopo ogni installazione è bene assicurarsi che tutto il processo di scansione e di invio dei dati raccolti al portale funzioni senza alcun problema. Varie possono essere le cause per le quali il processo non va a buon fine, ad esempio problemi di permessi di esecuzione dei task o di accesso ad internet. Per eseguire una verifica della correttezza dell’avvenuta installazione procedere come segue: 4.1 Eseguire manualmente il task di scansione e verificare i dati raccolti: 1. Cliccare su Start -> Programmi -> Accessori -> Utilità di sistema -> Utilità di pianificazione (Start -> All Programs -> Accessories -> System Tools -> Task Scheduler) 2. Cliccare con il pulsante destro sul task SNMPAgentScan e poi su Esegui (Run): 3. Nella colonna Stato (Status) verrà visualizzato il messaggio Esecuzione (Running). Attendere il completamento del task, dimostrato dal fatto che lo stato del task non sarà più Esecuzione (running) ma Pronto (Ready). Nota: purtroppo questa finestra di Windows non viene aggiornata in tempo reale dal sistema operativo, per cui per sapere se effettivamente il task è ancora in corso oppure no occorre premere il taso F5 per forzare l’aggiornamento della finestra. 4. Solamente dopo che il task è terminato si puo’ procedere alla verifica dei dati raccolti. Portarsi ora nella cartella di installazione di eXplorer 2, di default situata in: c:\programmi\abasset\explorer2.0 12 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 5. Trovare all’interno della cartella indicata al punto precedente il file di output generato: sarà un file con estensione “csv” il cui nome inizia con il codice cliente utilizzato. Un esempio di questo file può essere: ABCDE543_EncUTF8_110530_141040.csv Se in questa cartella non è presente un file con questa descrizione significa che c’è qualche problema nella procedura di scansione. Prima di contattare il nostro supporto tecnico è possibile individuare risolvere i casi più noti di problemi in questa fase. Fare riferimento a Appendice A - Verifica Problemi più comuni – Mancata generazione del file di output. 6. Aprire con un editor di testo il file appena creato ed assicurarsi che il numero delle stampanti sia quello atteso. Su ogni riga vi è una stampante. Qualora il numero di stampanti sia inferiore al numero previsto fare riferimento a Appendice A – Verifica Problemi più comuni- 3 – Le stampanti rilevate sono meno del previsto. 7. Dopo aver creato il file csv di output ed aver verificato che i dati raccolti sono quelli attesi è possibile inviare i dati al portale; procedere con il punto 8. 4.2 Eseguire manualmente il task di invio dei dati raccolti al portale. 8. Nella finestra al punto 1 (Utilità di pianificazione), eseguire manualmente il task SNMPAgentDataUpload. Fare riferimento ai punti 2 e 3 per sapere come fare per eseguire il task e verificare che venga terminato. Al termine del task portarsi nella directory di installazione di eXplorer 2 indicata al punto 4. 9. Dopo l’esecuzione del task al punto precedente occorre verificare che il file csv prodotto sia stato spostato nella sottocartella Send. Se ciò è avvenuto significa che i dati raccolti sono stati correttamente inviati al portale. Se il file csv non è stato spostato nella sottocartella send vuol dire che ci sono stati problemi in questa fase. Potete fare riferimento a Appendice A – Verifica Problemi più comuni - 2 – Mancato invio del file di output al portale. 10. Arrivati a questo punto, se tutti i punti precedenti sono stati seguiti con successo, la verifica dell’installazione può dirsi conclusa. Tuttavia dovete effettuare un ultimo controllo; fate riferimento alla sezione successiva. 13 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 4.3 Verificare che il registro eventi applicazioni sia sempre scrivibile eXplorer 2 si avvale del registro eventi applicazioni per il suo funzionamento, purtroppo però molto spesso questo registro è configurato in modo da non essere sempre scrivibile. Se eXplorer 2 non riesce a scrivere in questo registro non riuscirà a produrre dati, pertanto è bene seguire i seguenti punti per evitare ciò: 1. Cliccare su Start -> Pannello di controllo -> Strumenti di amministrazione -> Registro eventi (Start -> Control Panel -> Administrative Tools -> Event Viewer). Si aprirà una finestra simile alla seguente: 2. Cliccare con il pulsante destro sul registro Applicazioni (Application) e poi cliccare su Proprietà (Properties): 14 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 3. Se è selezionata l’opzione Non sovrascrivere eventi (Do not overwrite events) allora dobbiamo cambiarla poichè il registro eventi non è sempre scrivibile. Possiamo selezionare Sovrascrivi eventi se necessario (Overwrite events as needed) ed impostare il buffer a 20480 KB (cioè 20 MB). In questo modo il registro sarà sempre scrivibile e la sua dimensione molto ampia: 4. Cliccare su OK e chiudere il registro eventi. 15 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 5 Eseguire l’aggiornamento di eXplorer 2 Il software eXplorer 2 viene aggiornato continuamente con le informazioni che permettono di leggere i dati di un numero sempre maggiore di modelli di printer. In caso di segnalazioni di problemi nella lettura dei dati di una printer, ed a seguito della risoluzione di questi problemi, viene pubblicata una versione di eXplorer aggiornata; per applicare questa versione al cliente è necessario effettuare un aggiornamento dell’ eXplorer installato sul suo PC/Server. Il pacchetto di installazione di eXplorer 2.0, scaricabile da http://www.abasset.it/docs/explorer2setup.zip, è sempre aggiornato alla versione più recente e quindi contiene le ultime funzioni ed implementazioni, e può essere utilizzato sia per l’ installazione ex-novo che per l’ aggiornamento di una installazione esistente. Per conoscere in dettaglio le modifiche e correzioni presenti nelle varie versioni di eXplorer 2, è possibile consultare le “Note di Release”, raggiungibili al link: http://www.abasset.it/docs/releasenotes.txt La procedura di aggiornamento di eXplorer 2 è estremamente semplice: 1. Se si è sicuri che in fase di installazione non si è modificato il percorso di installazione di default procedere direttamente al punto 2. Altrimenti verificare il percorso di installazione attuale come segue: a. Cliccare su Start -> Tutti i programmi -> Accessori -> Utilità di Sistema -> Utilità di Pianificazione. b. Cliccare col pulsante destro sul task “SNMPAgentScan” e poi su “Proprietà”. c. Annotare il percorso del programma eseguito. Sui sistemi Windows XP/2003 si trova nella casella “Esegui”; sui sitemi Windows 7/2008 si trova nel Tab “Action”. Il percorso quì annotato è quello da usare per la nuova installazione. 2. Aprire il Pannello di Controllo di Windows e cliccare su Disinstallazione Programmi. Individuare nella lista dei programmi da disinstallare la dicitura “eXplorer 2 by AB Asset Management srl”. Eseguire quindi doppio click su di essa e cliccare su Yes per dare conferma per la disinstallazione. 3. Installare il nuovo eXplorer 2 eseguendo la normale procedura al capitolo “4 Esecuzione dell’installazione”, con 2 sole differenze: a. Se il percorso di installazione della vecchia versione non era quello di default, inserire il percorso annotato al punto 1 nella schermata “Selezione cartella di installazione”, altrimenti cliccare semplicemente su avanti in questa schermata. b. Nella schermata “eXplorer 2.0 setup configuration” cliccare semplicemente su “Chiudi” senza inserire alcun dato. Se il percorso di installazione inserito al punto precedente è corretto non verranno mostrati messaggi di errore di nessun genere. Se dovessero comparire messaggi di errore va di nuovo disinstallato il software e reinstallato, verificando stavolta che il percorso di installazione sia corretto. 4. Terminare l’installazione ed eseguire una verifica di funzionamento tramite la procedura descritta al capitolo “4 - Verifica della correttezza dell’installazione”. 16 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 6 Modifica dei risultati di scansione tramite i file di controllo In eXplorer 2 è possibile manipolare i risultati finali delle scansioni creando e popolando opportunamente dei file specifici. I file che è possibile creare sono 2: “exclusions.txt” e “overrides.csv”. Il modo in cui utilizzare ciascuno di questi file è indicato nei prossimi 2 paragrafi. 6.1 – File “exclusions.txt”. Il file “exclusions.txt” va creato manualmente nella directory di installazione di eXplorer 2, e popolato con la lista degli IP che non si intende inserire nel file CSV con i risultati delle scansioni. L’utilizzo più comune di questo file si ha quando si stanno scansionando dei range di indirizzi IP, ed eXplorer 2 cerca automaticamente le stampanti in rete. In questi casi può risultare complicato impedire che una certa stampante non venga scansionata. Il file “exclusions.txt” serve appunto a questo. Istruzioni per l’utilizzo 1. Creare manualmente in file “exclusions.txt” nella directory di installazione di eXplorer 2. 2. Editare il file inserendo su ogni riga l’IP della stampante che non si vuole che venga inserita nel CSV finale. Poi salvare e chiudere. 3. Editare il file “runagent.cmd”, presente nella directory di installazione di eXplorer 2, ed aggiungere alla fine della prima riga il seguente parametro: -activateexclusionsfile:yes 4. Salvare il file “runagent.cmd” e lanciare una scansione. Verificare che l’IP che non si voleva inserire nel CSV non sia stato effettivamente inserito. 6.2 – File “overrides.csv”. Il file “overrides.csv” va creato manualmente nella directory di installazione di eXplorer 2, e serve per indicare per una determinata stampante i nomi della marca e del modello, di modo che nel CSV finale questi vengano effettivamente applicati. Va fatto notare che in eXplorer 2, i nomi della marca e del modello non sono semplici stringhe indipendenti da tutti gli altri valori rilevati sulla stampante. Dalla marca e dal modello dipendono infatti tutte le logiche che eXplorer 2 applica, in quanto queste sono completamente personalizzate sulla base appunto della marca e del modello. Ad esempio il file “overrides.csv” può essere usato quando la scansione normalmente eseguita genera come risultato una stampante i cui nomi della marca e del modello non coincidono con quelli reali. Di conseguenza eXplorer 2 applica anche delle logiche errate, e i risultati ottenuti sui consumabili sono anch’essi errati. In questo caso è possibile ricorrere al file “overrides.csv”, il cui utilizzo pratico è descritto al paragrafo successivo. 17 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Istruzioni per l’utilizzo 1. Creare manualmente nella directory di installazione di eXplorer 2 il file “overrides.csv”. 2. Aprire questo file con notepad ed inserire i dati necessari per modificare la marca e il modello rilevati, attenendosi alle seguenti regole: a. Su ogni riga inserire i dati di una sola stampante, secondo la seguente sintassi: <mac address stampante>;<marca da impostare>;<modello da impostare> ad esempio: 00-00-74-F6-FD-DA;SAMSUNG;C820 Si noti che la sintassi utilizza tre valori separati dal carattere “;”. I tre valori sono mac address, nuova marca, e nuovo modello. E’ anche possibile inserire solamente la marca, o solamente il modello, popolando solo il rispettivo campo. Nel CSV verrà modificato solamente il campo richiesto. Queste modifiche possono essere anche effettuate tramite excel, che supporta questo formato. 3. Salvare il file “overrides.csv”. 4. Editare il file “runagent.cmd” ed aggiungere alla fine del comando di scansione: -activateoverridesfile:yes 5. Salvare il file “runagent.cmd” e lanciare una scansione. Verificare che per le stampanti che si intendeva modificare siano state effettivamente applicati i nuovi nomi di marca e modello. 18 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 7 Ottenere supporto remoto per l’installazione Una volta pronta la macchina che ospiterà eXplorer 2, se si vuole richiedere il nostro servizio di installazione remota oppure ottenere supporto per eventuali problemi, occorre eseguire il nostro client Teamviewer e comunicarci l’id mostrato a video: http://www.abasset.it/docs/explorerQS.exe Al ricevimento dell’ ID, un nostro operatore del supporto si connetterà al PC/Server del cliente ed effettuerà le operazioni richieste. Per richiedere il servizio di installazione remota, è necessario inoltrarci una richiesta attraverso l’ apposita pagina del sito MPS Monitor oppure via mail all’ indirizzo [email protected], indicando: - Codice di Attivazione Cliente (se già rilasciato) - Riferimento tecnico del cliente, da contattare per eventuali problemi o chiarimenti tecnici - Le informazioni sulla rete del cliente indicate al par. 2.2 del presente manuale 19 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Appendice A – Verifica problemi più comuni Riportiamo di seguito alcune delle problematiche più comuni che si possono verificare in fase di installazione oppure a distanza di tempo, con le relative verifiche e soluzioni. 1. Mancata generazione del file di output 1.1 Permessi non sufficienti per l’utente che esegue il task L’utente che di default viene impostato per l’esecuzione dei task schedulati è SYSTEM, ma talvolta i permessi di questo utente sono inibiti da policy di dominio. Per verificare che il problema sia questo occorre eseguire la scansione da linea di comando: se in questo modo la scansione viene eseguita correttamente (se quindi il processo termina con la creazione del csv) allora significa che l’utente con cui siamo loggati sulla macchina ha i permessi per eseguire la scansione, al contrario invece dell’utente impostato nelle proprietà del task schedulato, di default SYSTEM, che invece non ha permessi sufficienti per eseguire il task schedulato. Per eseguire la scansione da linea di comando procedere come segue: 1. Aprire il prompt dei comandi cliccando su Start -> Programmi -> Accessori -> Prompt dei comandi. 2. Portarsi nella cartella di installazione di eXplorer 2, disolito c:\programmi\abasset\explorer2.0. 3. Esegure il file Runagent.cmd: Il messaggio nel prompt sopra riportato indica che è stato prodotto il file csv di output. In tal caso abbiamo verificato che l’utente con cui siamo loggati ha i permessi per eseguire il task, e pertanto dobbiamo eseguire il task schedulato con questo utente, o un altro utente creato ad hoc con permessi simili. Per fare ciò procedere con il punto 4. Qualora non venga prodotto il file csv passare al capitolo 1.2 dell’appendice A. In tal caso infatti il problema non riguarda i permessi dell’utente che esegue i task. 20 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 4. Cliccare su Start -> Programmi -> Accessori -> Utilità di sistema -> Utilità di pianificazione (Start -> All Programs -> Accessories -> System Tools -> Task Scheduler) 5. Cliccare con il pulsante destro sul task SNMPAgentScan e poi su Proprietà (Properties): 6. Per cambiare l’utente di esecuzione del task utilizzare il pulsante Cambia Utente o Gruppo (Change User or Group) sui sistemi Windows 2008/7: Windows 2008/7 Utilizzare invece il campo Run as e per settare la password il pulsante Set password sui sistemi Windows XP/2003 21 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Windows 2003/XP NOTA: il tasto Set password sui sistemi Windows XP/2003 imposta la password in modo statico. Ciò significa che se la password di questo utente dovesse cambiare il task non verrà eseguito. Assicurarsi quindi di usare un utente la cui password non venga modificata o ricordarsi sempre di cambiare la password di questo task quando l’utente cambia password. 7. Cliccare su OK ed eseguire manualmente il task di scansione come indicato nel capitolo 5.1 . Dopo il completamento del task verificare che il file csv sia stato creato. 8. Tenete ben presente che le credenziali valide trovate per eseguire questo task dovranno essere riportate con la stessa procedura nel task di upload, ovvero SNMPAgentUpload. 1.2 Utente proxy non impostato o errato Se eseguendo manualmente dal prompt dei comandi il file runagent.cmd , presente nella directory di installazione di eXplorer 2, viene mostrato uno dei seguenti messaggi allora il problema di mancata generazione del csv è dovuto ad un errato utente del proxy, altrimenti passate al capitolo successivo: - The remote server returned an error: (407) Proxy Authentication Required - The underlying connection was closed: An unexpected error occurred on a receive. In questi casi occorre aprire il file runagent.cmd con un qualunque editor di testo e verificare quanto segue: le credenziali di autenticazione al proxy sono indicate dai parametri –U:<nome utente> e –s:<password> (è corretto anche se trovate “-U:<nome utente>” e “-s:<password>” , ovvero con gli apici agli estremi). Se si è in presenza di un proxy autenticato verificare che il nome utente e la password inseriti siano corretti. Se sono corretti ma il problema persiste passare al punto successivo. Il server proxy che eXplorer 2 utilizza è quello impostato nelle opzioni di Internet Explorer, ovvero quello che viene utilizzato dal sistema operativo. Per controllare che il server proxy utilizzato sia quello giusto portarsi nelle Opzioni di Internet Explorer. Aprite la scheda Connessioni e cliccate su 22 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Impostazioni LAN. Verificate qui che sia inserito correttamente un proxy, anche tramite script di configurazione. Se anche questo dato risulta corretto passate al punto successivo. Se i punti precedenti sono stati verificati con successo è probabile che eXplorer non trova il server a cui spedire il file csv per eventuali problemi legati alla rete. Il server a cui vengono inviati i file è monitoring.abassetmanagement.com, verificate quindi che questo server venga correttamente raggiunto al suo ip tramite il comando ping. Nel caso ci sono ancora problemi contattate il nostro supporto tecnico. Tenete presente che una volta trovate le giuste credenziali per eseguire la scansione dovrete riportare queste credenziali anche nel task di upload, secondo la procedura descritta in Appendice A – Troubleshooting, 2 – Mancato invio del file di output al portale. 1.3 Errori di licenza Se eseguendo manualmente dal prompt dei comandi il file runagent.cmd , presente nella directory di installazione di eXplorer 2, viene mostrato il seguente messaggio allora il problema di mancata generazione del csv è dovuto ad un errato codice cliente impostato, o alla terminazione delle scansioni consentite con la vostra licenza: Licence Actvation Error Occurred. Per risolvere il problema aprite con un editor di testo il file runagent.cmd e cercate la stringa di testo affianco al parametro –P . Verificate che questa stringa corrisponde effettivamente al vostro codice cliente (il server di autenticazione distingue tra maiuscole e minuscole!). Se il codice cliente inserito è giusto è probabile che sia terminato il numero di scansioni consentite con quel codice. Contattate il nostro supporto tecnico. 2. Mancato invio del file di output al portale. Le cause del mancato invio del file csv al portale sono esattamente le medesime della mancata generazione del file csv. Ciò che dovete tener presente però è che mentre per generare il csv bisogna eseguire il file runagent.cmd , per spedire il file csv al portale invece bisogna eseguire un altro comando, vediamo come ricavarlo: nelle proprietà del task schedulato di upload SNMPAgentDataUpload (che potete aprire seguendo i passaggi al punto 1.1 dell’appendice A, facendo attenzione a selezionare il task di upload e non quello di scansione) copiate il comando presente nella casella di testo Esegui (Run). Un esempio di questo comando è il seguente: C:\Program Files\ABAsset\eXplorer2.0\eXplorer.data.exe http "C:\Program Files\ABAsset\eXplorer2.0" http://monitoring.abassetmanagement.com/file *.csv "-U:ProxyUser" "-s:ProxyPassword" dovrete eseguire questo comando nel prompt dei comandi per osservare l’errore che viene generato e quindi ricorrere alla soluzione appropriata. Ovviamente il comando di esempio sopra riportato contiene anche i parametri per le eventuali (-U e -s) credenziali del proxy. Le casistiche possono essere: 23 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Il comando viene eseguito senza alcun problema ed il file csv viene spedito al portale. Ciò significa che l’utente impostato nelle proprietà del task di upload non ha permessi sufficienti, al contrario dell’utente con cui siete loggati sulla macchina, che è lo stesso usato per eseguire l’upload tramite il prompt. Quindi per risolvere il problema dovete sostituire l’utente che esegue il task; fate riferimento al punto 1.1 del’appendice A – Permessi non sufficienti per l’utente che esegue il task. Viene visualizzato uno dei seguenti errori: - The remote server returned an error: (407) Proxy Authentication Required - The underlying connection was closed: An unexpected error occurred on a receive. In presenza di questi messaggi significa che si è in presenza di un proxy autenticato e non avete inserito le credenziali, oppure avete inserito le credenziali sbagliate. Seguite le istruzioni al punto 1.2 dell’appendice A – Utente proxy non impostato o errato. Tenete presente che per settare le credenziali dell’autenticazione proxy nella fase di upload dovete modificare il comando lanciato dal task schedulato di upload: i parametri –U:<nome utente> e –s:<password> vanno in questo caso aggiunti al comando di upload (cioè nella casella “Esegui” delle proprietà del task schedulato di upload). Verificate anche che il server a cui i dati vengono inviati, ovvero monitoring.abassetmanagement.com, sia raggiungibile e che il traffico http (porta 80) non sia bloccato da alcun firewall. Se volete potete utilizzare anche il protocollo https (porta 443) sostituendo https a http nel comando di upload impostato nel task. 3. Le stampanti rilevate sono meno del previsto Se dopo aver eseguito la scansione vi rendete conto che il file csv di output manca di alcune stampanti verificate innanzi tutto che gli ip di queste stampanti, o gli intervalli di rete in cui si trovano, sono stati correttamente impostati nel file DEF. Il file DEF è un file testuale che ha come nome il codice cliente come estensione DEF. Si trova nella cartella di installazione di eXplorer 2 e contiene la lista degli ip, o intervalli, da scansionare. Se gli ip delle stampanti si trovano in questo file ma le printer non risultano nel file CSV risultante dalla scansione, il motivo del mancato rilevamento può essere dovuto a varie cause, tra cui anche problemi di configurazione delle printer. Per verificare questi aspetti, eseguite le procedure indicate in Appendice C) punto 2. Verifiche sulle printer non raggiunte o non rilevate. 24 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Appendice B – Utilizzare il portale MPS Monitor per la risoluzione di problemi sull’ eXplorer E’ possibile utilizzare il portale MPS Monitor per visualizzare alcuni dati sulla configurazione del software eXplorer 2, e modificare il file DEF contenente la lista dei range IP e/o delle printer. Sul portale aprire la scheda di un cliente e portarsi nella sezione “Anagrafiche”. Cliccare quindi su “Dati Explorer”. Verrà visualizzata una schermata come la seguente: Nella schermata sopra è possibile visualizzare i seguenti dati, non modificabili, sulla configurazione corrente per il cliente: Numero Build e Data Build Questi due dati sono molto importanti per capire se la versione attuale installata è aggiornata e se vi sono versioni più aggiornate. E’ possibile consultare anche le “Note di Release”, raggiungibili sia da questa pagina che direttamente al link: http://www.abasset.it/docs/releasenotes.txt Se ad esempio si possiede una versione vecchia di eXplorer, e si hanno problemi su un particolare modello di stampante, è possibile controllare nelle note di release se il problema è stato risolto da una versione successiva. IP e System Name Nella sezione “IP” ci sono tutti gli IP assegnati al server che esegue eXplorer 2. Nella sezione “System Name” c’è il nome fisico della macchina Questo dato è utile quando occorre identificare il server di eXplorer 2 nella rete del cliente, qualora il cliente stesso non fosse in grado di farlo. 25 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Ultimo Run Questo campo indica la data e l’ora dell’ultima scansione effettuata da eXplorer 2. Può essere utile in fase di verifica nel caso in cui i dati delle stampanti sul portale risultano non aggiornati da diversi giorni. Si può controllare quando è avvenuta l’ultima scansione: se questa è avvenuta recentemente significa che i dati sulle stampanti continuano ad essere raccolti quotidianamente, tuttavia i file CSV prodotti non vengono inviati al portale. Si tratta in tal caso unicamente di un problema in fase di invio, ed è quì che bisognerà intervenire quando ci si collega al server del cliente per l’assistenza. Schedulazioni In questo campo ci sono gli orari in cui vengono eseguiti i task di scansione (SNMPAgentScan) e di upload (SNMPAgentDataUpload). Si tratta di dati utili nel caso ad esempio è stata effettuata una modifica nella rete del cliente, e si vuole sapere quando ci si aspetta che verranno aggiornati i relativi dati delle stampanti sul portale. Può essere anche utile per controllare che gli orari settati siano compatibili con gli orari di accensione/spegnimento delle stampanti. Elenco dei file di definizione Questo è l’unica sezione contenente dati modificabili. Da questa sezione è infatti possibile visualizzare e modificare i file “DEF”, ovvero i file usati da eXplorer 2 per ricavare la lista di indirizzi IP, o di intervalli di indirizzi IP, che si intende scansionare. Per procedere con la modifica cliccare sul nome del file che si interessa modificare; si aprirà una schermata come la seguente: Per effettuare modifiche inserire i nuovi dati e cliccare su “Aggiorna”. Altrimenti chiudere semplicemente. eXplorer 2 utilizzerà i dati modificati alla scansione successiva. 26 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Appendice C – Cosa fare quando non arrivano i dati delle printer 1. Verifiche sul PC/Server eXplorer Se da più giorni su un cliente non si ricevono dati di nessuna printer, oppure se arriva una mail con il testo indicato a seguito, è altamente probabile che siano avvenuti cambiamenti sul server ove il software eXplorer è installato: “La presente mail per informare che il software di monitoraggio Explorer presente presso il cliente ABC0055; installato sulla macchina con indirizzo ip 10.20.30.40; e system name ABC01 non invia dati al portale dalla data 02/01/2012. Verificare che il pc sia acceso e che sia connesso a internet” In questi casi, è necessario innanzi tutto verificare che eXplorer 2 sia installato. Talvolta può succedere che i clienti disinstallano al software o spengono il server. Verificare anche eventuali messaggi dell’antivirus che compaiono durante l’esecuzione delle verifiche; molto spesso i virus compromettono il funzionamento di eXplorer 2 o del servizio di pianificazione di Windows, usato da eXplorer 2 per lanciare automaticamente i task di scansione e di upload. Se eXplorer 2 è installato sul PC/Server, procedere con le seguenti verifiche: 1) Generazione file di dati delle stampanti (CSV): - Eseguire manualmente il task di windows SNMPAgentScan (come indicato al precedente par. 5.1) e verificare che al termine venga prodotto un nuovo file con estensione CSV. In questa fase possono comparire errori relativi al funzionamento del servizio di pianificazione di windows. Può capitare che tale servizio sia corrotto. In tal caso occorre ripristinare il funzionamento del servizio di Windows o cambiare macchina. - Se il file CSV non viene creato, lanciare manualmente dal prompt dei comandi il file “runagent.cmd” presente nella cartella di installazione di eXplorer 2. In questa fase possono comparire errori come: o Registro eventi pieno -> impostare le proprietà del registro applicazioni in modo che sia sempre scrivibile (sovrascrivi se necessario), come descritto al precedente par. 5.3 . o Framework 4 non presente -> installare il Framework 4 versione Full da circa 48 MB, come descritto al precedente par. 1.4. o License activation error occurred -> verificare al parametro “-P:” sulla prima riga del file “runagent.cmd” che il codice cliente sia inserito correttamente: i caratteri devono essere tutti maiuscoli e non ci devono essere spazi agli estremi. Il codice deve concidere con quello fornito. o Proxy authentication error/required -> verificare che i parametro “–U:” e “–s:” contengano rispettivamente nome utente e password per l’autenticazione al proxy. Se l’utente è di dominio il nome utente va inserito nella forma DOMINIO\NomeUtente. o Altri errori di sistema utili per capire la soluzione. Leggere sempre bene il messaggio di errore: ci possono essere errori relativi al sistema operativo, che nulla hanno a che vedere con il eXplorer 2. Per questi errori occorre intervenire sul sistema operativo. 27 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 - Se il problema persiste: o Verificare che la macchina sia collegata ad internet. o Verificare che la password dell’utente impostato per eseguire il task schedulato (nelle proprietà del task) non sia stata cambiata e che l’utente sia corretto. o Se la scansione eseguita manualmente dal prompt dei comandi tramite runagent.cmd va a buon fine, mentre quella eseguita lanciando i task schedulati non va a buon fine, impostare come utente che esegue il task (nelle proprietà del task) l’utente loggato sulla macchina o un utente con permessi amministrativi sulla macchina. 2) Invio dei CSV al server: - Eseguire manualmente il task schedulato “SNMPAgentDataUpload”. Al termine del task tutti file CSV presenti nella cartella di installazione di eXplorer 2 vengono spostati in una sottocartella “Send” solo se il task va a buon fine. - Se i CSV non vengono spostati nella sottocartella “Send” occorre aprire le proprietà del task e copiare l’intero comando eseguito con tutti i parametri. Questo comando va eseguito nel prompt dei comandi nella directory di installazione di eXplorer 2. - Se eseguendo l’invio dei dati, tramite il comando eseguito dal prompt al punto precedente, va a buon fine, impostare come utente che esegue il task (nelle proprietà del task) l’utente loggato sulla macchina o un utente con permessi amministrativi sulla macchina. Se non va a buon fine possono comparire i messaggi di errore: o Proxy authentication error/required -> verificare che i parametro “–U:” e “–s:” contengano rispettivamente nome utente e password per l’autenticazione al proxy. Se l’utente è di dominio il nome utente va inserito nella forma DOMINIO\NomeUtente. o Altri errori di sistema utili per capire la soluzione. Leggere sempre bene il messaggio di errore: ci possono essere errori relativi al sistema operativo, che nulla hanno a che vedere con il eXplorer 2. Per questi errori occorre intervenire sul sistema operativo. Si segnala inoltre che tutti gli errori del tipo “Index was outside the bounds of the array” identificano nella stragrande maggioranza dei casi errori di sintassi nei comandi eseguiti. Verificare in tal caso il comando sulla prima riga del file “runagent.cmd”, presente nella cartella di installazione di eXplorer 2, prestando attenzione ad eventuali spazi di troppo tra un parametro e l’altro. Di regola deve esserci sempre uno spazio solamente. Qualora dopo queste verifiche di base il problema persista, è sempre possibile rivolgersi al supporto tecnico eXplorer, scrivendo una mail all’ indirizzo [email protected] e riportando una descrizione dettagliata del problema riscontrato. 28 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 2. Verifiche sulle printer non raggiunte o non rilevate Se da più giorni su un cliente non si ricevono dati di alcune printer, oppure se si è a conoscenza dell’ esistenza presso il cliente di printer connesse in rete che non risultano tra quelle visibili in MPS Monitor, è necessario effettuare le seguenti verifiche: 1) Identificare l’ indirizzo o gli indirizzi IP della/e printer non raggiungibili 2) Verificare che tali indirizzi siano presenti nei range previsti nel file .DEF di configurazione dell’ eXplorer; nel caso gli indirizzi non siano compresi, possono essere aggiunti tramite la finestra “Dettaglio Range IP” descritta in Appendice B. In questo caso le printer verranno rilevate alla successiva scansione. 3) Digitare ciascun indirizzo IP nella casella dell’ URL di un qualsiasi browser di un PC connesso alla rete del cliente; se la printer relativa ad ogni indirizzo IP è connessa in rete e raggiungibile, il browser visualizzerà la pagina web di configurazione della printer stessa. Ove la pagina non compaia o il browser restituisca un errore, verificare il collegamento e la configurazione in rete della printer. 4) Se la printer è raggiungibile via web, effettuare una copia della pagina web che riporta la configurazione di rete (TCP/IP ed SNMP) della printer; salvare la pagina in un file ed inviarla via mail alla casella [email protected], indicando: - Codice cliente - Seriale ed indirizzo IP della printer - Problema riscontrato (es. printer non più raggiunta dal XX/YY, oppure printer non raggiungibile da eXplorer) 29 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 3. Come essere avvisati automaticamente via mail di eventuali problemi su eXplorer 2 E’ possibile ricevere una notifica via mail automaticamente, ogni giorno, che informi il destinatario che l’ eXplorer non sta effettuando rilevazioni oppure che alcune printer non sono raggiungibili Per attivare l’ invio della notifica printer non raggiunte / problemi eXplorer, è sufficiente inserire il vostro indirizzo email nel campo Indirizzi mail di notifica allarmi della pagina Anagrafiche del sito MPS Monitor: Questa operazione va fatta per ciascun Cliente per cui si vuole ricevere la notifica; se si vuole inserire lo stesso indirizzo email per tutti i clienti è possibile richiederci un inserimento massivo inviando una richiesta via mail ad [email protected], indicando l’ indirizzo mail da inserire su tutti. Per i clienti dove è popolato questo campo, il sistema invierà quotidianamente due tipi di notifiche mail: 1) Notifica Server eXplorer non funzionante: verrà inviata solo nel caso in cui il campo Ultimo Run nei Dati Explorer (vedi Appendice B) non venga aggiornato per oltre due giorni; in questo caso il testo della mail sarà: “La presente mail per informare che il software di monitoraggio Explorer presente presso il cliente ABC0055; installato sulla macchina con indirizzo ip 10.20.30.40; e system name ABC01 non invia dati al portale dalla data 02/01/2012. Verificare che il pc sia acceso e che sia connesso a internet” Nel caso in cui si riceva questa mail, prima di richiederci supporto, è necessario eseguire le verifiche indicate nel paragrafo 1. Verifiche sul PC/Server eXplorer 2) Notifica printer non raggiunte: riporterà un elenco delle printer che non sono raggiungibili da almeno due giorni; in questo caso il testo della mail sarà: 30 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 “ Gentile Cliente, da una verifica effettuata dal nostro sistema di monitoraggio esistono XX dispositivi non contattati da almeno 2 giorni: ****Elenco delle printer non raggiunte***** La preghiamo di verificare ed attuare le necessarie azioni correttive per permetterci di continuare ad erogare in modo efficace il servizio di fornitura proattiva dei consumabili. Grazie Il team di supporto” Nel caso in cui si riceva questa mail, prima di richiederci supporto è necessario eseguire le verifiche indicate nel paragrafo 2. Verifiche sulle printer non raggiunte o non rilevate 31 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Appendice D – Tipologie di installazione di eXplorer 2 Oltre alla consueta installazione di eXplorer 2, che avviene su un solo PC e per un singolo cliente, esistono altri 2 tipi di installazioni: - Installazione su clienti che hanno più reti non connesse tra loro - Installazione su una singola sede in cui si trova più di un cliente Queste 2 tipologie di installazione sono spiegate nei prossimi 2 capitoli. Installare eXplorer 2 su clienti che hanno più reti non connesse fra loro Quando si hanno sedi differenti non in grado di comunicare tra loro via rete, è necessario effettuare un’installazione di eXplorer 2 in ciascuna delle sedi: ogni installazione effettuerà la scansione delle sole stampanti della relativa sede. Ogni installazione può essere eseguita tramite la consueta procedura spiegata al capitolo 3 “Esecuzione dell’installazione”; per tutte le installazioni si può utilizzare lo stesso codice cliente, di modo che sul portale le stampanti scansionate si trovino sotto lo stesso cliente. Durante l’installazione del software andranno indicati i relativi indirizzi IP dei dispositivi da scansionare e in automatico verranno storicizzati nella cartella di installazione eXplorer in file con estensione .DEF Modifica dei file DEF tramite il portale Nel portale, nella sezione Anagrafica è presente un link alla maschera “Dati eXplorer” dove per ogni rete vengono indicati i dati del software installato e un elenco dei file DEF. I file DEF possono essere modificati direttamente dal portale e vengono sincronizzati sulla macchina locale dove è installato il software , alla successiva scansione dei dispositivi. Esempio della maschera “Dati explorer” per un cliente con 3 reti: 32 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Installare eXplorer 2 su una singola sede in cui si trova più di un cliente Vi sono casi in cui più clienti occupano la stessa sede ed usano quindi la stessa infrastruttura di rete. In questi casi, anche se i clienti sono diversi, è possibile tramite un’unica installazione di eXplorer 2 scansionare tutte le stampanti presenti, anche se queste appartengono a clienti diversi. L’unico requisito affinchè questo tipo di installazione sia possibile è che tutte le stampanti da scansionare risultino raggiungibili dalla macchina che ospiterà eXplorer 2. Per realizzare questo tipo di installazione procedere come segue: 6. Installare eXplorer 2 come descritto al capitolo 3 “Esecuzione dell’installazione”, in modo che sia perfettamente funzionante. Come codice cliente utilizzare uno qualunque dei clienti della sede. Eseguire i test necessari per verificare che l’installazione sia funzionante, come indicato al capitolo 4 "Verifica della correttezza dell’installazione". 7. Portarsi nella cartella di installazione di eXplorer 2 ed aprire con notepad il file “runagent.cmd”. Il file conterrà 2 righe, di cui la seconda comincia con “REM”. 8. Copiare interamente il contenuto della prima riga subito sotto di questa. La riga che inizia con “REM” verrà spostata così una rigo sotto, finendo quindi in terza riga. 9. Sulla riga appena copiata, cioè la seconda, modificare i seguenti 2 parametri, evidenziati in giallo: snmpagent.exe -P:ABCDE -D:ABCDE.def MaxPathsNum 1 /pf:False /mp:1 I 2 parametri evidenziati costituiscono nell’ordine - Codice cliente Ciò che segue il parametro –P: è il codice cliente. Eliminare il codice presente (questo infatti viene utilizzato già sulla prima riga) ed inserire il codice del nuovo cliente. - File “DEF” contenente la lista delle stampanti Ciò che segue il parametro –D: è il nome del file con estensione “DEF” che contiene la lista delle stampanti da scansionare. Va creato, necessariamente nella cartella di installazione di eXplorer 2, un nuovo file di testo tramite notepad. Il nuovo file deve avere come nome il codice del cliente già impostato al punto precedente al parametro –P:, e come estensione “DEF”. Ad esempio se il codice di questo nuovo cliente è TEST, il file di testo da creare si deve chiamare “TEST.DEF”. Tramite notepad editare questo file inserendo la lista delle stampanti da scansionare, cioè solo quelle che sono da associare al cliente “TEST”. Ora che il nuovo file DEF è stato correttamente creato occorre quindi impostare il suo nome accanto al parametro –D: presente nel file runagent.cmd sulla riga che si sta creando. 10. Salvare il file runagent.cmd ed eseguirlo. Verificare che al completamento dell’intero processo di scansione siano presenti nella directory di installazione di eXplorer 2 un file CSV per ciascuno dei clienti che si intende scansionare. Ogni file CSV avrà un nome che inizia con il giusto codice cliente. All’interno di questi file CSV devono essere presenti solo le stampanti del relativo cliente. 11. Ripetere i passi precedenti per ciascun cliente che si intende scansionare. Nel file runagent.cmd sarà presente un numero di righe uguale al numero dei clienti, escludendo ovviamente la riga che inizia con “REM” che va ignorata. Al termine eseguire una verifica del funzionamento come descritto al capitolo 4. 33 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Appendice E – Job di lettura printer USB Descrizione del processo di scansione di una stampante USB La lettura di printer USB si avvale di un software dal nome “eXplorer LA” (eXplorer Local Agent) da installare sulle macchine con la printer USB collegata. Questo software si occupa di analizzare i dati delle stampanti collegate in USB fino ad un massimo di 5 stampanti connesse ad un PC. Il software si occupa anche di abilitare il servizio SNMP sul computer locale e di inserire i dati raccolti all’interno di una nuova sezione SNMP che ha le seguenti caratteristiche: - - - La nuova sezione SNMP che conterrà i dati delle stampanti avrà il seguente nodo OID come radice: .1.3.6.1.5.1.87233.1.1.2 L’OID radice ha 29 OID figli corrispondenti ai 29 campi di un normale CSV creato da eXplorer 2. Gli OID figli sono i seguenti: .1.3.6.1.5.1.87233.1.1.2.1 .1.3.6.1.5.1.87233.1.1.2.2 ............... .1.3.6.1.5.1.87233.1.1.2.29 Per ogni nodo OID figlio corrispondenti a un particolare campo da analizzare (ad esempio il seriale, oppure il livello del toner) vi sono altri 5 OID figli, uno per ciascuna delle 5 stampanti al massimo che è possibile analizzare. Questi OID hanno i seguenti valori: .1.3.6.1.5.1.87233.1.1.2.1.1 .1.3.6.1.5.1.87233.1.1.2.1.2 ............. .1.3.6.1.5.1.87233.1.1.2.1.5 I dati scritti su questi OID sono tutti cifrati. Per poter effettuare la raccolta dei dati creati da eXplorer LA va utilizzato eXplorer 2, da installare su una macchina capace di raggiungere in rete i PC interessati. Solo eXplorer 2 è in grado di decifrare i dati scritti da eXplorer LA. Gli IP da far scansionare ad eXplorer 2 per la raccolta dei dati delle stampanti USB sono gli IP dei PC su cui è installato eXplorer LA. Affinchè eXplorer 2 sia in grado di leggere i dati delle stampanti dal servizio SNMP di un PC è necessario modificare il file runagent.cmd, presente nella cartella di installazione di eXplorer 2, aggiungendo alla fine della prima riga il seguente parametro: /scanpc:1 34 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Versioni di eXplorer LA e procedure di installazione/disinstallazione IMPORTANTE: Verificare la compatibilità della stampante locale con eXplorerLA Prima di installare explorerLA, è necessario verificare che la stampante connessa al PC tramite porta USB sia compatibile con il prodotto. Per fare ciò, consultare la tabella di compatibilità di eXplorerLA presente all’ indirizzo https://docs.google.com/spreadsheet/ccc?key=0Asp5uYmBUBTYdDBLNUh1cGlnSEpKTXBpaDQ0dG53ZFE#gid=0 E verificare che la printer sia presente e che la tabella riporti l’ indicazione “Supportato” sui dati che interessa gestire. ATTENZIONE: nel caso in cui la stampante non sia presente nella Tabella, oppure riporti alcuni dati come NON SUPPORTATO, si consiglia di NON procedere all’ installazione, e contattare il Supporto eXplorer all’ indirizzo [email protected]. La certificazione di nuovi modelli di stampanti per la lettura tramite USB con eXplorerLA va specificamente concordata con AB Asset Management, in quanto potrebbe non essere tecnicamente possibile, oppure potrebbe comportare dei costi aggiuntivi. 35 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Prerequisito di Installazione: servizio SNMP di Windows Affinchè sia possibile utilizzare eXplorer LA è necessario che sul computer sia installato e opportunamente configurato il servizio SNMP di Windows. La procedura differisce tra Windows XP/2003 e Windows 7/2008. Dopo l’installazione del servizio occorrerà configurarlo correttamente; fare riferimento al capitolo “Configurazione del servizio SNMP di Windows per eXplorer LA” alla pagina successiva. Installazione servizio SNMP di Windows su Windows XP/2003 Per installare il servizio SNMP su Windows XP/2003 è necessario il CD del sistema operativo. In alternativa è possibile utilizzare la cartella “i386” per sistemi a 32 bit, o “amd64” per sistemi a 64 bit. Tale cartella può essere prelevata da un CD di installazione e conservata su chiavetta o share di rete. In questo modo è possibile semplificare l’installazione del servizio quando i PC da configurare sono molti. Una volta entrati in possesso dei CD di installazione, o dei file in esso contenuti, procedere come segue: 12. 13. 14. 15. 16. 17. 18. Cliccare su Start -> Pannello di controllo. Cliccare Installazione Applicazioni. Cliccare su Installazione Componenti di Windows. Cliccare su Strumenti di Gestione e Controllo. Spuntare la casella affianco SNMP e cliccare su OK. Cliccare su Avanti. Quando verrà richiesto fornire il percorso al CD o ai files del sistema operativo e cliccare su OK. Installazione servizio SNMP di Windows su Windows 7/2008 Per i sistemi Windows 7/2008 non è richiesto il DVD di installazione. Procedere come segue: 1. 2. 3. 4. 5. Cliccare su Start e poi su Pannello di Controllo. Cliccare su Programmi e Funzionalità. Cliccare su Attivazione o Disattivazione delle funzionalità di Windows. Selezionare la casella accanto SNMP Service (o Servizio SNMP). Cliccare su OK. Attendere il completamento dell’installazione. 36 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Configurazione del servizio SNMP di Windows per eXplorer LA Per la configurazione del servizio SNMP corretta per il funzionamento di eXplorer LA procedere come segue: 1. Cliccare su Start e poi su Esegui. 2. Digitare services.msc e premere invio. 3. Nella lista dei servizi trovare SNMP Service (o Servizio SNMP), cliccare col pulsante destro sul servizio e poi su Proprietà. 4. Posizionarsi nella scheda Sicurezza. 5. Le impostazioni importanti per il funzionamento di eXplorer 2 sono quelle cerchiate in rosso nell’immagine seguente: In questa schermata verificare che: i. In Nomi comunità Accettati (Accepted Community Names) è importante che sia presente la community “public”, impostata su READ ONLY (funziona anche con READ WRITE ma per eXplorer LA è sufficiente READ ONLY). ii. Deve essere selezionato Accetta pacchetti SNMP da qualunque host (Accept SNMP packets from any host). E’ anche possibile impostare l’altra opzione purchè venga specificato tra gli host validi l’IP del server su cui è installato eXplorer 2. 37 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Installazione/disinstallazione di eXplorer LA Seguire la procedura di installazione di eXplorer LA solo dopo aver terminato l’installazione e la configurazione del servizio SNMP di Windows, descritta al capitolo precedente. Esistono due versioni di eXplorer LA, una con setup completo di interfaccia grafica, che chiamiamo “normale”, ed una che non necessita di intervento manuale per l’installazione chiamata “silent”. In entrambi i casi il programma di installazione copierà i file nella cartella Programmi, e installerà il servizio eXplorerLA. Tale servizio si può trovare e gestire nella lista dei servizi di sistema. Nella cartella di installazione si trovano anche altri file, oltre all’eseguibile con cui le stampanti vengono scansionate: una Dll, che carica nell’SNMP del computer la lista degli OID sopracitati; il file CSV, dove verranno memorizzate le informazioni relative alle stampanti lette; ed un file INI, che contiene le opzioni di configurazione del servizio. Installazione/disinstallazione di eXplorer LA “Normale” Installazione Eseguire il file di setup con permessi di amministratore sulla macchina locale. Durante il setup non sono richiesti particolari dati all’utente. Assicurarsi che il percorso di installazione sia quello voluto e procedere sempre cliccando su “avanti”. Disinstallazione Portarsi nella cartella di installazione di eXplorer LA, che di default si trova al seguente percorso: C:\Program Files\ABAsset\eXplorerLA Fare doppio click sul file unins000.exe, e dare quindi conferma per la disinstallazione. Al termine della stessa è possibile cancellare la cartella eXplorerLA. Installazione/disinstallazione di eXplorer LA “Silent” Installazione Il software deve essere lanciato dal command-prompt con il seguente comando: eXplorerLA_v1.1_setup_silent.exe Seguito da uno spazio e da uno dei seguenti parametri, che rappresentano rispettivamente 3 modalità di Installazione: /I /F Installazione con sovrascrittura del file .ini, se già esistente. Questa modalità va usata sempre nel caso si tratta della prima installazione di eXplorer LA su un PC. /I Installazione senza sovrascrittura del file .ini Il setup dura circa un minuto durante il quale non appare alcun messaggio sullo schermo. Disinstallazione Per la disinstallazione è necessario munirsi del setup di installazione di eXplorer LA. Dal command-prompt portarsi nella cartella del setup e lanciare il seguente comando: eXplorerLA_v1.1_setup_silent.exe /U 38 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Verifica correttezza installazione - - - Sui sistemi Windows 7/2008 cliccare su Start e digitare services.msc nella casella di ricerca. Sui sistemi Windows XP/2003 cliccare su Start -> Esegui , inserire quindi services.msc e cliccare su OK. Nella lista che appare dovranno essere presenti le seguenti voci e lo stato deve essere Started: o eXploreLA o SNMP Service Verificare le proprietà del servizio SNMP seguendo la procedura indicata a pagina 31 al capitolo “Configurazione del servizio SNMP di Windows per eXplorer LA”. Qualora dovessero risultare mancanti uno o entrambi i servizi: - Nel caso il servizio eXplorer LA non sia presente occorre disinstallare eXplorer LA secondo le procedure indicate alla pagina precedente e procedere alla reinstallazione. Nel caso il servizio mancante sia SNMP Service portarsi a pagina 30 del presente manuale e seguire la procedura indicata al capitolo “Installazione prerequisito: servizio SNMP di Windows”. Se dopo aver seguito tutti i passaggi mostrati vi sono ancora problemi contattare il supporto tecnico. Il file di configurazione INI Il file INI è gestibile nella seguente maniera: Sezione [SETTING] SERVICE_ACTIVE=true/false (Attiva/Disattiva il processo di scansione delle stampanti locali); SESSION_LOGON=true/false (Richiede/Non richiede che nel computer non sia loggato nessun utente); DEBUG_FILE=true/false (Abilita/Disabilita l’output del servizio su di un file LOG); CSV_APPEND=true/false (Non sovrascrive/Sovrascrive le nuove righe sulle precedenti, nel file CSV); IO_USB=true/false (Abilita/Disabilita la scansione di stampanti usb); IO_LPT=true/false (Abilita/Disabilita la scansione di stampanti parallele); IO_REG=true/false (Abilita/Disabilita la scansione di chiavi di registro usate per memorizzare dati di stampanti); Sezione [EXECUTION] TIME1=HH:MM (Orario di scansione numero 1) TIME2=HH:MM (Orario di scansione numero 2) Possono esistere un numero indefinito di orari di scansione, basta che abbiano il numero progressivo corretto dopo la sequenza “TIME”, e che siano distanziati l’uno dall’altro di almeno 5 minuti. Il servizio eXplorerLA lancerà, agli orari stabiliti, la procedura di lettura verso gli apparecchi abilitati (da IO_USB, IO_LPT, IO_REG), con le modalità stabilite. A livello di processi, non è lo stesso eXplorerLA che si attiva per comunicare con le stampanti e generare l’output, ma il lavoro è eseguito da un processo esterno, lanciato dallo stesso eXplorerLA, che per l’appunto si chiama eXplorerLA.exe (rintracciabile dal Task Manager di windows, quando è in fase di esecuzione). 39 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Appendice F – Linea di comando 1. Scansione delle stampanti Sintassi: snmpagent –P:<CUSTOMER NAME> -D:<DEFINITION FILE PATH> /mp: <PROCESSES NUMBER> MaxPathsNum <THREADS NUMBER> /pf:<ENABLE PREFETCH> U:<PROXY USER NAME> -s:<PROXY PASSWORD> -P:<CUSTOMER NAME> Codice cliente -D:<DEFINITION FILE PATH> File delle reti da scansionare /mp:<PROCESSES NUMBER> Numero massimo dei processi snmpagent.exe. Si consiglia una volta e mezzo il numero di core. MaxPathsNum <THREADS NUMBER> Numero dei thread per processo /pf:<ENABLE PREFETCH> ES: /pf:False . Determina se utilizzare la funzione prefetch, ovvero la memorizzazione degli OID utilizzati su ogni stampante. Tale funzioni velocizza le successive scansioni . NOTA: questa funzione e’ beta e richiede ulteriori test. -U:<PROXY USER NAME> Nome utente per l’accesso al proxy eventualmente utilizzato (opzionale). 2. Invio del file csv prodotto: Sintassi: explorer.data.exe http <EXPLORER INSTALL DIRECTORY> http://monitoring .abassetmanagement.com/file *.csv *.log –U:<PROXY USER NAME> -s:<PROXY PASSWORD> 3. Parametri avanzati PARAMETRI TIMEOUT /scantimeout:<ms> Timeout per la fase di discovery. Esempio: /scantimeout:1000 40 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 /walktimeout:<ms> Timeout per il commando walk, ovvero l’intervallo di tempo tra un retry e l’altro. Esempio: /walktimeout:1000 /gettimeout:<ms> Timeout per il comando get, ovvero l’intervallo di tempo tra un retry e l’altro. Esempio: /gettimeout:1000 ALTRI PARAMETRI AVANZATI -disablewalks:yes Disabilita la creazione dei file con estensione .WLK, attivabili dal portale sulle singole stampanti e contenenti i dati necessari al supporto di eXplorer 2 per le analisi. -activateexclusionsfile:yes Attiva l’utilizzo del file “exclusions.txt” che deve essere presente nella cartella di installazione di eXplorer 2 e contenere la lista delle stampanti che si intende escludere dalla scansione. Maggiori informazioni al capitolo 6.1: File “exclusions.txt”. -activateoverridesfile:yes Attiva l’utilizzo del file “overrides” che deve essere presente nella cartella di installazione di eXplorer 2 e contenere la lista delle modifiche alla marca e al modello rilevati. Maggiori informazioni al capitolo 6.2: File “overrides.csv”. 4. Parametri per lettura dati stampanti USB /scanpc:1 Questo parametro va usato solo quando nel file DEF sono specificati gli IP dei PC su cui è installato eXplorer LA, per la lettura dei dati delle stampanti USB ad essi collegate. 41 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145 Riferimenti AB Asset Management srl Per maggiori informazioni e supporto tecnico potete contattare: www.abasset.it www.mpsmonitor.it/supporto.shtml Sede Legale: Via Borromei 2 – 20123 Milano Posta Certificata: [email protected] Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 Centro di Sviluppo Software : Via dei Pelati, 16 – Castel Mella (BS) Tel. 030.25.50.164 | Fax. 030.40.77.046 Centro di Supporto eXplorer : Via Iazzitiello, 15/c – 70090 Santeramo in Colle (BA) Tel. 080.20.44.330 Per ottenere supporto remoto sull’ eXplorer: effettuare il Download del modulo eXplorer Quick Support: www.abasset.it/docs/explorerQS.exe comunicare l’ ID che compare a video alla casella [email protected] 42 AB Asset Management Srl Sede Legale: Via Borromei 2 – 20123 Milano Sede Commerciale: c/o Oberon Service - Via Meda, 28 - 20141 Milano Tel. 02.84.800.612 | Fax. 02.84.800.538 mail: [email protected] - P.Iva / CF: 03122040987 – REA: MI 1946145