Studi di Settore. Nota Operativa 22/4/2013

Transcript

1 Nota Operativa Studi di Settore 22/4/2013 Sommario Valutazione casistiche... 2 Errore di connessione... 2 Sistema operativo non aggiornato... 2 File non installato client... 2 File non installato server... 2 Servizio non attivo, Aggiornamento del servizio in corso... 2 Timeout diagnostico... 2 Problematiche Server... 3 Servizio studi non attivo... 3 Impossibilità di attivare il servizio studi... 5 Problematiche di connessione legate a Firewall/antivirus... 8 Installazione del servizio in un percorso lungo o con spazi... 8 Processi utilizzati dal servizio... 9 File di log legati al servizio File non sovrascritti sul server Problematiche Client Installazione client Problematiche di connessione con il server Blocchi legati agli antivirus/firewall Gestione file di log client Esecuzione test Diagnostico Sistema operativo XP non aggiornato Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 1/17

2 Valutazione casistiche In questo capitolo sono elencate le possibili verifiche da effettuare suddivise per casistica. Errore di connessione Problematiche di connessione con il server Blocchi legati agli antivirus/firewall Gestione file di log client Problematiche di connessione legate a Firewall/antivirus Sistema operativo non aggiornato Sistema operativo XP non aggiornato Processi utilizzati dal servizio File non installato client Reinstallare la postazione client, verificare inoltre Installazione client File non installato server Verificare i corretti percorsi di installazione e il corretto puntamento al server: Servizio studi non attivo Servizio non attivo, Aggiornamento del servizio in corso Problematiche di connessione con il server Blocchi legati agli antivirus/firewall Problematiche di connessione legate a Firewall/antivirus Processi utilizzati dal servizio Timeout diagnostico Come primo controllo, verificare esclusioni antivirus Blocchi legati agli antivirus/firewall Verificare l esecuzione degli studi di settore tramite interfaccia utente accedendo all applicativo tramite DF Unico, successivamente verificare il funzionamento tramite diagnostico ( Esecuzione test Diagnostico ). In caso di mancato funzionamento verificare: File non sovrascritti sul server. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 2/17

3 Problematiche Server Servizio studi non attivo Il servizio studi per la suite Ipsoa si trova nel seguente path : [pathserver]\..\studi\sti\prg\com\cosimi\bin\studisrv.exe se il percorso di condivisione server della Suite risulta come il default [Mappatura] \Ipsoware, in caso la condivisione sia differente (es. R:\ipsoa\ipsoware) il percorso di installazione degli studi sarà sulla root della condivisione (es. R:\Studi). La medesima logica vale anche per la suite Pragma, con la differenza della cartella pragmaw anziché ipsoware. E necessario verificare tramite Pannello di Controllo > Strumenti di amministrazione, la presenza del Servizio di attivazione Studi WKI, che sia avviato e che punti al file corretto. Figura 1 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 3/17

4 Il servizio puo essere installato, avviato ed arrestato da riga di comando oppure tramite l apposito eseguibile installaserviziostudi.exe presente nel percorso [pathserver]\ipsoware. Per effettuare questa operazione è necessario essere posizionati sul sever. Installazione da riga di comando : [pathserver]\..\studi\sti\prg\com\cosimi\bin\studisrv.exe s i Avvio da riga di comando : [pathserver]\..\studi\sti\prg\com\cosimi\bin\studisrv.exe s start Arresto da riga di comando : [pathserver]\..\studi\sti\prg\com\cosimi\bin\studisrv.exe s stop Installazione servizio da eseguibile : Eseguire [pathserver]\..\installaserviziostudi.exe N.B. In caso il servizio fosse già installato l eseguibile potrebbe restituire dei messaggi di errore che saranno comunque ininfluenti per il buon esito dell operazione. Figura 2 Il servizio utilizza l utente Local System Account ed e attivata la possibilita di interagire con il desktop Figura 3 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 4/17

5 Impossibilità di attivare il servizio studi Il servizio dipende dalle seguenti relazioni di dipendenza: Server, Workstation e TCP/IP Figura 4 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 5/17

6 Il comando netstat a b p TCP visualizza tutte le porte TCP utilizzate sul server ed il nome del processo che le impegna. Figura 5 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 6/17

7 I comandi del Service Control Manager possono essere utilizzati per interrogare lo stato del servizio ( sc query studisrv ), avviare ( sc start studisrv ) ed arrestare ( sc stop studisrv ) il servizio e rimuovere il servizio ( sc delete studisrv ) Figura 6 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 7/17

8 Problematiche di connessione legate a Firewall/antivirus All atto dell installazione il servizio imposta l eccezione sul firewall di Windows, in caso sia presente un firewall di terze parti, sarà necessario procedere manualmente all impostazione delle dovute eccezioni: - Esclusione della cartella di rete in cui risiede il servizio (cartella Ipsoware o PragmaW in caso di installazione standard) - In presenza, sul server, anche della parte client, deve essere gestita anche l esclusione della cartella locale C:\Programmi\WKICOSIMI Figura 7 Il servizio utilizza, di default, la porta socket 2000, oppure quella indicata nel file [pathserver]\..\studi\sti\prg\etc\studisrv.cfg (se non presente, la porta in uso è la 2000). Se attivato il Windows Firewall, benché presenti le eccezioni, occorre disattivare quello d dominio. Figura 8 Installazione del servizio in un percorso lungo o con spazi In presenza di percorsi di installazione [pathserver] contenenti spazi oppure più lunghi di 15 caratteri il servizio crea una Junction Point denominata ip_1stu. In questa casistica è necessario verificare la presenza del seguente collegamento, C:\ ip_1stu. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 8/17

9 Il comando Dir /al /s c: o può essere utilizzato per visualizzare tutti i Junction Point presenti nel disco C: Figura 9 Processi utilizzati dal servizio Il processo wginpo3.exe viene attivato dal servizio studi in risposta ad una connessione proveniente da un client che richiede l elaborazione di uno studio ed esegue i programmi cobol che elaborano la posizione inviata dal client. Il processo chksogei.exe si occupa del lancio dell elaborazione di Gerico sul server. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 9/17

10 In alcune casistiche è possibile che il processo wginpo3.exe rimanga in esecuzione sul server impedendo l avvio dell aggiornamento del servizio, in questo caso è necessario verificare che l applicativo non sia in esecuzione su nessun client e terminare il processo appeso tramite il Task Manager. Figura 10 File di log legati al servizio Il servizio studi scrive il file di log studisrv.log nella cartella locale c:\wsiotemp\log, diversamente nella cartella [pathserver]\..\studi\sti\prg\com\cosimi\bin Figura 11 File non sovrascritti sul server Nei casi in cui, durante l installazione server, alcuni processi del servizio siano attivi, è possibile che alcuni file non siano stati sovrascritti, di conseguenza nel percorso di installazione server degli studi saranno presenti dei file con estensione.tmp. In questa casistica sarà necessario reinstallare la parte server o più semplicemente copiare l intera cartella STUDI, da altra installazione (il percorso è ininfluente) contenente i file corretti, avendo preventivamente stoppato il servizio e riattivandolo successivamente. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 10/17

11 Problematiche Client Installazione client La parte client degli studi é installata nella cartella locale Programmi \wkicosimi. Il processo che colloquia con il server degli studi é il wkiterm.exe presente nella cartella Programmi \wkicosimi\clientgrafico\bin. Figura 12 Figura 13 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 11/17

12 Nella cartella Programmi \wkicosimi è posizionato il file di configurazione wkisuite.config.xml contenente tutte le impostazioni di connessione al server. Figura 14 Tale file viene modificato dinamicamente all accesso del client al servizio, impostando i riferimenti al server lettii dal file, [PathServer]\..\Studi\Prg\Etc\IndIpServer.cfg; a partire dalla versione 4.2, tale file viene generato dal servizio al suo avvio. E possibile creare manualmente il file con le corrette impostazioni in caso lo stesso non sia presente. Problematiche di connessione con il server In caso di mancata connessione tracciata nel file C:\wsiotemp\log\wkiterm.log di log come gethostbyname nome host sconosciuto, la possibile risoluzione è il riavvio del servizio sul server e la relativa creazione del file [PathServer]\Ipsoware\Studi\Prg\Etc\IndIpServer.cfg dalla versione 4.2 in poi. Una volta presente tale file i client utilizzeranno le informazioni in esso contenute per poter accedere all applicativo. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 12/17

13 Verifica raggiungibilità servizio Ove presente il comando telnet nome server numero porta può essere un metodo utile per verificare la comunicazione tra la macchina client e il server degli studi Figura 15 Figura 16 Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 13/17

14 Il comando ping nome server puo essere utilizzato per verificare se avviene correttamente la risoluzione del nome del server. Figura 17 Blocchi legati agli antivirus/firewall In alcune casistiche il client potrebbe non riuscire a connettersi al servizio a causa di antivirus che bloccano l applicativo, è quindi necessario verificare che siano state gestite le opportune esclusioni negli antivirus installati. Le esclusioni da impostare riguardano: Lato Server - [pathserver]\ipsoware/pragma, eventualmente anche direttamente il [pathserver]\..\studi\prg\com\cosimi\bin\studisrv.exe Lato client - La cartella C:\Programmi\WKICOSIMI - La cartella C:\WSIOTEMP Gestione file di log client Nella cartella c:\wsiotemp\log sono presenti i seguenti file: Pdlsti.log contiene la traccia delle operazioni eseguite durante il setup della Stazione degli studi; Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 14/17

15 Figura 18 Wkiterm.log contiene l eventuale errore di connessione al servizio generato dal diagnostico light Figura 19 Start.log contiene la traccia delle operazioni eseguite dal programma Start.exe che si occupa di lanciare il wkiterm.exe. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 15/17

16 Figura 20 Esecuzione test Diagnostico All interno della Suite > Utilità Suite è presente il Diagnostico Studi di Settore che permette di simulare l elaborazione di una posizione per verificare la corretta configurazione dell intera procedura. I file contenenti la posizione da elaborare sono contenuti nella cartella %APPDATALOCAL%. Figura 21 Sistema operativo XP non aggiornato Per i sistemi xp affinché venga raggiunta correttamente la cartella di scambio tra la Suite e gli studi occorre che il sistema operativo sia aggiornato tramite il Microsoft windows update, ovvero abbia una shell32.dll di versione uguale o superiore a La versione richiesta è distribuita in un patch MS del Luglio 2012 su Xp SP3 : Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 16/17

17 N.B. In base allo stato di aggiornamento del client potrebbe essere necessario rilanciare la procedura Windows update più volte per allineare la workstation all ultima versione disponibile. Wolters Kluwer Italia Tutti i diritti riservati MAN-96VB5M48304 Pag. 17/17