Indice

DocWay4 - Applicativo FCA - File Conversion Agent

Il “File Conversion Agent” è un modulo sviluppato in Java che fa da ponte tra il server eXtraWay ed il “File conversion Service”(FCS) e cioè si preoccupa di prendere in carico le richieste di elaborazione/conversione degli allegati fatte dal server eXtraWay, richiama l'FCS per processarle e ottenuta risposta provvede ad aggiornare i record eXtraWay interessati. L'FCA è incluso nel pacchetto platform di eXtraWay (ultima release ad oggi è la 6.0.0). Le cartelle principali sono :

Start, stop e status del servizio

Operando con sistemi operativi linux lanciando il binario extraway-fca si debbono usare parametri che sono:

Il comando status fornisce informazioni inerenti all'esecuzione o meno del servizio e il Pid.

File Conversion Agent is running PID [14564]

Queste Informazioni non sono utilizzabile su piattaforme Windows. In questi casi si utilizza la gestione dei servizi di Windows.

Istallazione e configurazione

L'FCA viene distribuito in un pacchetto completo sia per Linux che per Windows. Analizzeremo uno alla volta gli scenari e le procedure.

Linux

Nel pacchetto di installazione della piattaforma eXtraWay è già presente l'FCA. Nel direttorio “/opt/3di.it/platform/fca” troviamo la cartella radice del servizio.

Windows

Come per il sistema operativo linux anche per Windows il pacchetto della piattaforma comprende l'FCA. Troveremo in più due script nella cartella bin per installare il servizio e rimuoverlo.

Preparazione per entrambi gli scenari

Prima di poter eseguire correttamente il primo avvio è necessario analizzare i file di configurazione e completarli correttamente. E' indispensabile avere e conoscere:

Queste informazioni vanno inserite nei file di configurazione come da esempi presenti nel pacchetto.

In windows compilare correttamente tutte le configurazioni prima di installare il servizio lanciando da prompt di dos lo script install.bat . In mancanza di configurazioni o avendo configurazioni errate il servizio non si avvierà correttamente.

Il linux invece non è necessario lanciare una installazione, sarà sufficiente sollecitare il file binario come indicato in precedenza. Anche in questo caso in mancanza di configurazioni o in presenza di configurazioni errate il servizio non si avvierà correttamente.

Possibili scenari

Primo scenario

Sulla stessa macchina sono installati il sever eXtraWay, l'FCA e l'FCS. Non vi sono particolari indicazione se non il rispetto di quanto detto prima.

Secondo scenario

Su una prima macchina sono installati il server eXtraWay e lFCA mentre l'FCS è installato su un'altra macchina. Anche in questo caso non ci sono particolari indicazioni se non nell'indicazione dell'ip della seconda macchina e porta socket d'ascolto dell'FCS.

Terzo Scenario

Più macchine con installato il server eXtraWay e l'FCA e una o più macchine con installato l'FCS. In questo caso bisogna indicare ad ogni FCA l'ip del server su cui è installato l'FCS e porta socket scelta.

Quarto Scenario

Sulla stessa macchina sono avviate due o più istanze di eXtraWay con relativo FCA. L'FCS può essere installato sulla stessa macchina o su una macchina differente. In questo scenario è importante la scelta delle porte socket utilizzate dai server ExtraWay e dagli FCA. Da ricordarsi che per ogni server ExtraWay dovrà essere presente l'FCA dedicato. L'FCS può essere anche unico per entrambi gli FCA.