Studi di Settore - Willies Corporation

Transcript

Studi di Settore - Willies Corporation
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 .....................................................................................10
File non sovrascritti sul server .................................................................................10
Problematiche Client ...............................................................................................11
Installazione client ...............................................................................................11
Problematiche di connessione con il server .................................................................12
Blocchi legati agli antivirus/firewall ..........................................................................14
Gestione file di log client .......................................................................................14
Esecuzione test Diagnostico ....................................................................................16
Sistema operativo XP non aggiornato .........................................................................16
Wolters Kluwer Italia – Tutti i diritti riservati
MAN-96VB5M48304
Pag. 1/17
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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 http://en.wikipedia.org/wiki/NTFS_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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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
Studi di Settore
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 6.0.2900.6242.
La versione richiesta è distribuita in un patch MS del Luglio 2012 su Xp SP3 :
http://support.microsoft.com/kb/2691442/it
Wolters Kluwer Italia – Tutti i diritti riservati
MAN-96VB5M48304
Pag. 16/17
Studi di Settore
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