Installazione DexGateMicro sotto windows

Da DexWiki.

Indice

Installazione DexgateMicro su Windows XP

Procedura d'installazione

Accertarsi di aver già installato sulla macchina windows che si utilizzerà come server una versione del pacchetto Java Development Kit (JDK) superiore o uguale alla 1.6.0 (anche detta 6.0). Nel caso in cui il pacchetto JDK non sia ancora installato sul sistema scaricare l'ultima versione direttamente dal sito http://java.sun.com/j2se/corejava/index.jsp ed installarla. Una volta scaricato il pacchetto d'installazione del DexgateMicro (Dexgate-ver-win-install.zip), estrarlo in una cartella temporanea1. Spostarsi nella cartella di destinazione e fare doppio click sull'eseguibile d'installazione SetUp.exe per lanciare l'installazione del DexgateMicro.
Startup.jpg
Scegliere una lingua per le istruzioni d'installazione e premere il tasto “OK” per continuare e visualizzare la schermata di benvenuto:
Benvenuto.jpg
Cliccare sul tasto “Avanti” per visualizzare la schermata relativa al path del pacchetto JDK sul sistema:
Jdk1.5.jpg
Cliccare su tasto “Browse...” e selezionare la cartella d'installazione del pacchetto JDK. Immaginando di aver preventivamente installato il pacchetto JDK 1.6.0 update 6 nella cartella “C:\Programmi\Java\jdk1.6.0_05” avremo:
Selectedjdk1.5.jpg
Cliccare sul tasto “Avanti” per passare alla schermata relativa alla licenza di utilizzo:
License.jpg
Leggere attentamente la licenza d'uso del software, accettarla e cliccare sul tasto “Avanti” per passare alla schermata di selezione del percorso d'installazione:
Pathinstallation.jpg
Di defaut viene proposto come path di destinazione il percorso “C:\Programmi\DexgateMicro”, cambiare eventualmente tale destinazione, premere il tasto “Avanti” ed accettare la creazione della cartella d'installazione DexgateMicro cliccando su “OK” nella successiva schermata. CDC S.p.A.
Cliccare sul tasto “Avanti” nella successiva schermata di dettaglio dei pacchetti da installare ed attendere la fine del processo d'installazione:
Javacore1.jpg
Javacore2.jpg
Cliccare quindi sul tasto “Avanti” per concludere l'installazione del servizio Dexgate sul server:
Elaborzione.jpg
Cliccare, quindi, sul tasto “Avanti” per concludere il processo d'installazione del software:
Finishedinstallation.jpg
Cliccare infine sul tasto “Fatto”. A questo punto il DexgateMicro sarà stato aggiunto tra i servizi di sistema.

Procedura di avvio del servizio

Se non lo si è già fatto settare l'interfaccia di rete del server con l'indirizzo IP e la netmask desiderati.
Startare, quindi, il DexgateMicro nel seguente modo:

  • Aprire l'interfaccia utente di gestione dei servizi di sistema (Pannello di Controllo → Strumenti di

Sistema → Servizi):
Winservices.jpg

  • Cliccare col tasto destro sul servizio Dexgate presente tra l'elenco dei servizi di sistema e

scegliere dal menù contestuale “Proprietà”:
Winservicesprop.jpg

  • Impostare il “Tipo di avvio” del servizio come Automatico dal menù a tendina in modo che il

sistema operativo restarti automaticamente il servizio ad ogni riavvio della macchina:
Winserviceavvio.jpg

  • Cliccare sul tasto “Avvia” per startare il servizio, quindi sui tasti “Applica” ed “OK”.
  • Chiudere, infine, l'interfaccia utente di gestione dei servizi di sistema.

L'interfaccia web del DexgateMicro sarà visionabile dopo pochi minuti dall'avvio del servizio collegandosi mediante un browser web; nel caso in cui non si riesca a collegarsi a tale interfaccia si controlli che tale porta non sia già occupata da qualche altro servizio attivo sul server. In quest'ultimo caso fare riferimento al paragrafo “Settaggio della porta del server web DexgateMicro” per modificare le impostazioni di default.

Patch nella procedura di configurazione del servizio

Abbiamo riscontrato un problema con il wrapper (applicazione esterna che utilizziamo per lanciare Dexgate come servizio di Windows) utilizzato, che di default ha problemi di autorizzazione nell'accesso a qualche risorsa di sistema si Windows.

La procedura risolutiva, nell'attesa che il problema sia risolto definitivamente dal produttore di tale applicazione esterna, e' la seguente:

- Aprire Pannello di Controllo/Strumenti di amministrazione/Servizi
- nella lista dei servizi individuare Dexgate, selezionarlo, cliccare col tasto destro del mouse e scegliere Proprieta'
- Cliccare sul Tab "Connessione"
- Togliere la spunta dall'OptionBox "Account di sistema locale" selezionando invece "Account".
- Cliccare su "Sfoglia..."
- Cliccare su "Avanzate..."
- Cliccare su "Trova"
- Selezionare un utente qualsiasi, solitamente "Administrator" e premere "OK"
- Premere ancora "OK"
- Inserire nei campi "Password" e "Conferma password" la password dell'utente selezionato, quindi premere "OK"

E' ora possibile avviare il servizio sia manualmente che automaticamente all'avvio di Windows

Procedura di arresto del servizio

Qualora fosse necessario fermare momentaneamente il servizio Dexgate si potranno seguire due distinti metodi:

  • si potrà seguire una procedura simile a quella di avvio con l'unica differenza che in questo caso

sarà necessario cliccare sul tasto “Arresta” dal menù Proprietà relativo al servizio stesso.

  • oppure ci si potrà loggare sul server web del DexgateMicro come amministratore, quindi,

cliccare sul link “Arresta il sistema” nella sezione Gestione Avanzata.

Settaggio del prefisso telefonico locale

Per realizzare un corretta computazione delle telefonate locali sarà necessario, a servizio non attivo, editare il file kernel.properties nella cartella prop della directory d'installazione4 e modificare il prefisso 0587 nel proprio prefisso telefonico locale all'interno della riga:

 commkernel.resolver.filters.pattern.call.local=virtual:///00587.*

Nel caso in cui, per esempio, il prefisso telefonico locale fosse quello di Roma si dovrà cambiare la riga come segue:

 commkernel.resolver.filters.pattern.call.local=virtual:///006.*

Nel caso in cui, invece, vi siano più prefissi corrispondenti a telefonate locali (es 0963, 0964, 0965) si dovrà cambiare la riga come segue:

 commkernel.resolver.filters.pattern.call.local=virtual:///((00963)|(00964)|(00965)).*

Settaggio della porta del server web DexgateMicro

Di default l'interfaccia web del DexgateMicro partirà sulla porta 80 dell'interfaccia di rete primaria del server. Qualora fosse necessario modificare questa porta si dovrà a servizio non attivo modificare la riga default.web.port=80 nel file default.properties della cartella prop della directory d'installazione in default.web.port=nuovo_numero_porta, quindi restartare il servizio.

Disinstallazione del DexgateMicro

Ci si sposti nella directory d'installazione del DexgateMicro (di default tale cartella ha il seguente path: C:\Programmi\DexgateMicro). Spostarsi, quindi, nella sottocartella “Uninstaller” e fare doppio click sul file UninstallDexgate.bat presente al suo interno. Così facendo si sarà eliminato il servizio Dexgate dall'elenco dei servizi di sistema; controllare, comunque che l'interfaccia utente di gestione dei servizi di sistema (Pannello di Controllo → Strumenti di Sistema → Servizi) non mostri più tra i servizi presenti la voce Dexgate.
Fatto ciò, sarà possibile rimuovere la directory d'installazione del DexgateMicro con tutto il suo contenuto.

Strumenti personali