Indice generale

S4Net – Componenti Client – Requisiti e note
Società
Note
1/7
: ICE S.r.l. – Seriate BG
: da intendersi riservata al personale tecnico e agli amministratori di rete
Indice generale
Requisiti per la parte Client ....................................................................................................1
Aggiornamento automatico .............................................................................................1
Servizi di stampa e supporto alle componenti Web ........................................................2
Registrazione dinamica delle stampanti da computer client ...........................................3
Requisiti minimi - sintesi .......................................................................................................3
Requisiti di sistema ................................................................................................................4
Segnalazioni di errore - OCX .................................................................................................4
Segnalazioni di errore – modulo di avvio update/installazione .............................................5
Appendice A – versioni di windows problematiche ..............................................................6
Appendice B – configurazioni particolari di Internet Explorer e software proxy ..................7
Requisiti per la parte Client
Il sistema S4Net si compone di una parte server (non trattata in questo documento), che è
responsabile del dialogo funzionale con i programmi gestionali in HTML, e di una parte client che
deve risiedere e funzionare sul computer remoto dell'utente. Quest'ultima ha necessità di interagire
con le componenti server per fornire le funzionalità di:
–
–
aggiornamento automatico (ogni qual volta vengono apportate modifiche a questa componente)
servizi di stampa e supporto alle componenti WEB (HTML)
registrazione dinamica delle stampanti del computer client
–
Aggiornamento automatico
–
Questa funzionalità (del tutto simile a quella degli antivirus) consiste nell'avvio di un programma
che controlla la versione attualmente installata e la confronta con quella che figura nella prima
pagina caricata dal browser (all'indirizzo http://s4net.icesoftware.it). Se queste differiscono (cosa
che può succedere anche se il software client non è mai stato installato) viene avviato il download
del nuovo package di installazione. Se invece le due versioni coincidono viene avviata la
componente S4NIOS che si occupa di gestire la comunicazione di servizio con il server S4Net e di
gestire le stampe e le richieste speciali. Per poter eseguire questa funzione si è dotata la prima
pagina di un oggetto ActiveX in tutto simile alla tecnologia Flash di ShockWave. Quindi perchè
questa fase abbia esito positivo deve essere assicurato che:
–
ActiveX: deve essere concesso il diritto di download ed esecuzione del componente dal sito
s4net.icesoftware.it (questo componente è firmato da ICE quindi non vi è alcun pericolo in
questa concessione) ed inoltre bisogna che il componente sia autorizzato a:
1) leggere il registro (HKEY_CURRENT_USER)
2) scrivere nel registro (HKEY_CURRENT_USER)
3) avviare altri programmi
4) accedere alla porta 8000 di s4net.icesoftware.it da cui scarica gli aggiornamenti (*)
(*) si vedrà in seguito il perchè di questa scelta
S4Net – Componenti Client – Requisiti e note
2/7
Perchè questi requisiti siano assicurati sarà, probabilmente, necessario porre s4net.icesoftware.it tra
i siti attendibili di internet explorer ed, inoltre, almeno nella fase di installazione iniziale del
componente ActiveX, abbassare la protezione a bassa o media. Se questo componente non si
installa correttamente l'intera infrastruttura per le stampe è invalidata.
Fig.1 – richiesta di installazione dell'ActiveX alla prima connessione
–
Servizi di stampa e supporto alle componenti Web
Queste componenti fanno capo al già citato S4NIOS.
Fig 2 – componente S4Nios in visualizzazione, il simbolo rosso figura normalmente nella taskbar durante il funzionamento regolare
Perchè questa parte funzioni ha necessità di:
–
poter effettuare collegamenti alla porta 8000 di s4net.icesoftware.it, da cui preleva i files binari
delle immagini e dei documenti di cui effettuare la stampa o la visualizzazione
– poter effettuare collegamenti alla porta 8009 di s4net.icesoftware.it, che utilizza per ricevere
comandi e messaggi operativi dal server (i quali scaturiscono da elaborazioni batch o richieste
on-line degli utenti)
Se questi requisiti non vengono rispettati il sistema di stampa e di delivery automatica dei risultati
di elaborazioni batch non funzionerà.
S4Net – Componenti Client – Requisiti e note
–
3/7
Registrazione dinamica delle stampanti da computer client
Questa funzionalità fa strutturalmente parte di S4NIOS, ma è logicamente separata da esso, tanto è
vero che il sistema sta in piedi anche se questa fallisce. Si tratta di un side-service che viene
invocato all'avvio di S4NIOS (ossia alla apertura di s4net.icesoftware.it) che esegue l'invio della
lista aggiornata delle stampanti presenti sul computer dell'utente. Questo meccanismo è stato
pensato per consentire la maggiore libertà possibile all'amministratore/utente locale di variare il
numero e il tipo dei dispositivi di stampa. Il sistema recepirà ad ogni avvio (o su richiesta) le
variazioni non richiedendo alcuna azione da parte dell'utente.
Perchè questa opzione funzioni bisogna che:
–
–
siano configurati in Internet Explorer i dati di accesso ad un server proxy
oppure:
sia consentita la connessione alla porta 80 di s4net.icesoftware.it, con la quale verranno
scambiati dati crittografati ma in formato HTML (similmente a quanto avviene ccon il protocollo
SOAP dei web services)
Requisiti minimi - sintesi
Riassumendo, è necessario che ogni computer client possa:
–
–
–
–
installare ed eseguire correttamente un componente ActiveX attraverso Internet Explorer
server proxy http/https configurato in Internet Explorer (o accesso diretto alla porta 80)
accedere alla porta 8000 di s4net.icesoftware.it
accedere alla porta 8009 di s4net.icesoftware.it
Le ragioni principali perchè uno o più di questi requisiti possa essere disatteso sono:
–
–
–
–
–
presenza di un firewall tra il computer locale e internet (o un personal firewall sul computer)
presenza di un antivirus che controlla anche le connessioni eseguite da programmi locali verso
internet
valore del parametro “gateway” nella scheda TCP/IP delle proprietà della connessione di rete
non impostato correttamente per uscire su internet (NAT) oppure se si usa DHCP i parametri
dinamici non contengono un valore corretto per qusto parametro (*)
particolari settaggi restrittivi su Internet Explorer a tutela della sicurezza (in particolare verso
componenti ActiveX)
problemi particolari e localizzati nell'esecuzione/installazione/gestione di componenti
COM/COM+ che siano estensione di Internet Explorer (**)
(*) si noti che la versione attuale del software (come dovrebbe essere chiaro da quanto detto in precedenza) NON
è in grado di passare attraverso i proxy SOCKS, ma ha bisogno di poter inoltrare le richieste al server di ICE su
internet DIRETTAMENTE. Ciò significa che se c'è un firewall di mezzo questo deve consentire al computer locale
di uscire in NAT o secureNAT. Questa operazione viene svolta automaticamente dai routers ADSL o DSL di
Telecom (o altri providers) e basta impostare il suddetto parametro “gateway” nelle proprietà TCP/IP della
connessione di rete utilizzando l'apposita icona “rete” nel pannello di controllo di windows.
(**) questa condizione può essere evidenziata anche in particolari malfunzionamenti di componenti come Flash
di ShockWave.
S4Net – Componenti Client – Requisiti e note
4/7
Requisiti di sistema
Il sistema minimo per far funzionare S4Net è:
–
–
–
–
–
–
–
Processore Pentium 200 o superiore
Sistema operativo Windows 95/98/2000/NT/XP/2003 o successivo
Memoria RAM di 32 Mb o superiore
Spazio su disco fisso di almeno 10Mb
Connessione ad internet
Scheda di rete (non strettamente necessaria)
Utilizzare SOLO il browser Internet Explorer versione 6.0 (meglio se SP1) o successiva
Nota: particolari configurazioni con browsers diversi o dotati di plug-ins particolari (es. download accellerators) non sono stati testati
e quindi non sono, in generale, ritenuti compatibili. Si applica, inoltre, qualsiasi altra limitazione stabilita dalla documentazione
microsoft relativa alla tecnologia .Net sul lato client.
Segnalazioni di errore - OCX
Gli errori che possono essere mostrati durante la fase di installazione/invocazione della componente
ActiveX (nella pagina caricata dal browser) sono introdotti da “ERR=” (possono inoltre essere
preceduti da EXECCMD) e sono qui catalogati.
Codice
01
02
03
04
05
06
07
08
09
10
11
ABORT
WAIT!
Significato
la directory (OBJECT_DIR) di installazione dell'OCX non esiste
impossibile creare un mutex (una istanza precedente sta già operando)
errore disallocando il mutex (le prossime istanze non funzioneranno)
errore tentando di leggere il valore della chiave di registro “StatoCmd”
chiave di registro “StatoCmd” assente o conteneva “0”
chiave “TimeCmd” non trovato o conteneva un valore scorretto
chiave “TimeCmd” trovata ma si riferisce ad un installatore sconosciuto
errore nella lettura della chiave “Esito” (quando “StatoCmd” = “2”)
errore nella scrittura della chiave “StatoCmd”
“StatoCmd” conteneva un valore inatteso – nessuna azione possibile
impossibile avviare il modulo di download del package di installazione
Su “StatoCmd” = “1” (installazione in corso) errore grave
Su “StatoCmd” = “1” installazione in corso attendere
Le azioni possibili per tentare di risolvere questi errori sono:
Errore
01
02-03
04-09
10
ABORT, WAIT!
Azione
ripristinare le chiavi di registro di S4Net (**)
riavviare il computer e ritentare, se fallisce ancora disinstallare l'ActiveX
a) controllare che la porta 8000 sia disponibile verso s4net.icesoftware.it
b) riavviare il computer locale
c) disinstallare la componente ActiveX e riprovare
d) verificare l'integrità della installazione di windows
rivolgersi ad ICE
Questi sono errori trattati internamente e non dovrebbero mai comparire
(**) Questo tipo di errore si può verificare se si è installato S4Net come un certo utente e poi ci si
collega con un altro utente e si usa la procedura. In tal caso, le chiavi di registro sotto
S4Net – Componenti Client – Requisiti e note
5/7
HKEY_CURRENT_USER\ICE (che sono legate all'utente) non saranno presenti. Per Risolvere
questo problema: esportare le chiavi di registro dal vecchio utente e importarle nel nuovo utente o
disinstallare l'oggetto “S4NIOSUP0Ctl Class” (attraverso il menù di internet explorer “Strumenti”,
poi “Opzioni internet”, poi tasto “Impostazioni”, tasto “Visualizza oggetti” nella nuova schermata e
poi selezionare l'oggetto e con il tasto destro usare la voce “Elimina” del menù che appare).
Segnalazioni di errore – modulo di avvio update/installazione
Questo modulo viene avviato dall'OCX e svolge le operazioni di verifica della versione, eventuale
download e installazione di un update, e avvio del modulo di gestione stampe locali. Sono previsti i
seguenti codici di errore:
Codice
ERR-01
ERR-02
ERR-03
ERR-04
ERR-05
ERR-06-n
ERR-07
ERR-08
ERR-09
ERR-10
ERR-11
ERR-12
ERR-13
Significato
comando non riconosciuto (non inizia con CMD=S4N)
sintassi errata del comando S4N
errore in lettura da registro (della chiave: VersioneS4nios)
errore in lettura da registro (della chiave: ModuloS4nios)
impossibile avviare modulos4nios (S4NIOS.exe)
trasferimento del file S4NIOSSETUP.EXE fallito con codice di ritorno n (*)
impossibile avviare setup trasferito (S4NIOSSETUP.EXE)
errore in lettura da registro (della chiave: RC_SetUp)
chiave RC_SetUp non contiene OK => S4NIOSSETUP.EXE fallito
errore in scrittura registro (della chiave: VersioneS4nios)
errore in lettura da registro (della chiave: ModuloS4nios)
impossibile avviare modulos4nios (S4NIOS.exe ID=13242433333)
problemi con generazione ID univoco client (GetNuovoID fallito)
Note sugli errori:
ERR-05 una possibile causa è che si è cancellata la directory C:\S4\NIOS (o la sua sottodirectory
S4TOOLS) eliminando gli eseguibili del sistema NIOS ma non si è cancellata la chiave di registo
relativa (HKEY_CURRENT_USER\ICE sottochiave S4NIOS e S4NIOSUP)
ERR-06 indica, probabilmente, un problema nel contattare il server S4Net sulla porta 8000. Vedi
note equipollenti per gli errori dell'OCX (vedi sotto per codici dettagliati).
ERR-07 e ERR-12 indicano una possibile corruzione della installazione di S4Net, si deve procedere
ad una rimozione delle chiavi di registro e dell'ActiveX (contattare ICE).
ERR-13 indica che probabilmente sul computer non è installata una scheda di rete, o non funziona
correttamente, a fronte di una richiesta di generazione autormatica del MAC ID del client. Usare il
link nella pagina index per avviare comunque il sistema S4NET.
Gli altri codici sono errori gravi che richiedono l'intervento di ICE.
Codici di ritorno per ERR-06:
1 SOCKET ERROR durante fase di GET_BYTES
2 non trovata WSOCK32.dll versione 1.1. o superiore
3 nessun server transfer file presente/connesso (alla porta 8000)
4 apertura socket TCP/IP fallita
5 Connect a s4net.icesoftware.it fallita
6 Risposta del server non in protocollo (server sconosciuto/versione ignota)
7 mandato INFO: risposta NOFILE (o altro)
8 Impossibile aprire file destinazione su computer locale
10 File a zero bytes (flusso binario vuoto)
S4Net – Componenti Client – Requisiti e note
6/7
Appendice A – versioni di windows problematiche
–
windows XP – tutte le versioni
Attenzione: windows XP ha introdotto un componente firewall di default. Questo componente, se
attivato, consente di monitorare tutte le connessioni di rete (quindi anche verso e da internet)
eseguite dal computer. Potrebbe succedere che questo componente blocchi le componenti di S4Net
che si occupano delle stampe e dell'update del software di ICE. Ci si riferisca alla documentazione
fornita da Microsoft per “aprire” delle specifiche porte TCP/IP in “uscita” (in particolare per quanto
riguarda la porta numero 8000 e 8009). Questa necessità si verifica se (pur avendo contattato
l'amministratore di rete per consentire di accedere a internet dalla propria postazione su queste
porte) si ricevono errori del tipo ERR-06 (vedi precedenti paragrafi relativi agli errori).
–
windows XP con Service Pack 2
Con il rilascio del service pack 2, Microsoft, ha introdotto notevoli modifiche al modello di
sicurezza di windows XP. Tutto ciò nella speranza di proteggere maggiormente l'utente e di
aumentare il controllo su ciò che questi può o non può fare. Da più fonti sono stati sollevati dubbi
sulla efficacia di questo approccio e sulla possibilità che alcune componenti permettano, di fatto, di
monitorare gli utenti (es. il nuovo media player che introduce la gestione dei diritti dei produttori e
fornitori di contenuti multimediali a scapito della libertà dell'utente). In base a queste
considerazioni, si sconsiglia in generale di installare questo service pack, continuando comunque a
installare le patch relativa a internet explorer e a componenti di sistema di XP, proposte da windows
update.
In generale, con le impostazioni di internet explorer proposte in questo documento, non ci
dovrebbero essere problemi notevoli nel funzionamento delle componenti di S4Net. Potrebbero
verificarsi casi particolari in cui la fase di installazione della componente OCX potrebbe non
giungere a buon fine. In tal caso riferirsi a questi documenti di Microsoft:
http://support.microsoft.com/kb/843017
http://support.microsoft.com/?kbid=843022
–
Windows NT 4.0 (tutte le versioni)
Questa versione di windows non era nella matrice di testing e quindi non è certificata per il
funzionamento con S4NIOS. Comunque, da test successivi risulta che il componente OCX ha
difficoltà ad installarsi correttamente per una incompatibilità di questa piattaforma microsoft con
tutte le altre versioni. Per risolvere questo problema:
1) andare sull'icona “my computer”, premere il tasto destro del mouse e poi selezionare
“properties” dal menù che appare
2) copiare il valore relativo al ProductID (un numero molto lungo mostrato in una nuova finestra,
che si apre in seguito alle azioni svolte nel punto 1)
3) utilizzando l'utility di sistema regedit, creare una nuova chiave stringa di nome ProductId in:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
esempio:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion]
"ProductId"="52329-ICE-3308266-09471"
S4Net – Componenti Client – Requisiti e note
7/7
Appendice B – configurazioni particolari di Internet Explorer e software proxy
–
IE 6.0.x.x SP1 (forse anche precedenti)
Se collegandosi al sito ICE attraverso un servizio proxy si riscontrano problemi o anomalie con
qualche maschera, eseguire il seguente settaggio:
Menù: Strumenti -> Opzioni internet -> Avanzate (TAB)
poi raggiungere la sezione: Impostazioni HTTP 1.1, e porre:
[x] Usa HTTP 1.1 con connessione via proxy
Inoltre, verificare sempre che in:
1) Strumenti -> Opzioni internet -> Generale (TAB), poi bottone: “Impostazioni” sia sempre
selezionato: “All'apertura della pagina” (per la sezione: “Ricerca versioni più recenti per le
pagine memorizzate”)
2) Il sito: https://s4net.icesoftware.it sia presente tra i siti attendibili e che l'apertura di “popup” da
parte di questo sito sia sempre CONSENTITA.
–
IE 7
Rimangono comunque valide anche le impostazioni descritte sopra per IE 6.0.
Questa versione di Internet Explorer, rilasciata nel 2007, introduce ulteriori restrizioni al fine di
rendere il browser più sicuro. Queste nuove politiche di sicurezza bloccano alcune funzionalità di
S4Net. In particolare: l'installazione del controllo activeX di gestione S4NiosUp e il sistema di
transfert file (TF) per il download dei files dal sito (esempio i file excel o le stampe).
Per risolvere questi problemi sarà necessario impostare nelle “Opzioni internet” di IE i seguenti
valori:
1) sezione “Controlli e plug-in ActiveX” impostare “Scarica controlli ActiveX senza firma
elettronica” al valore “Chiedi conferma”
2) sezione “Download” impostare “Richiesta automatica download id file” al valore “Attiva”
In fase di installazione del controllo S4NiosUp, verrà visualizzata una barra gialla in cima alla
pagina corrente che avverte del tentativo di installare un controllo ActiveX. Posizionare il puntatore
del mouse su questa barra e con il tasto destro aprire il menù contestuale: scegliere “installa
ActiveX”. Verrà mostrata una finestra che consentirà di confermare la richiesta di installazione.