q
Pagina 1 di 16
INSTALLAZIONE E UTILIZZO
CONVERTITORE PDF – WSO2PDF 1.00
1
SCOPO
Lo scopo di questo documento è di fornire supporto tecnico per l’installazione e
la configurazione del prodotto Convertitore PDF (WSO2PDF).
2
DESCRIZIONE
2.1 MODULI DELL’APPLICAZIONE
L’applicazione WSO2PDF è un’applicazione composta da diversi moduli.
L’ambiente operativo minimo richiesto è WindowsNT 4.0 (service pack 6), è
raccomandabile l’uso con Window 2000.
I moduli applicativi sono:
‰
UTIL-OBJECT 2 PDF NT SERVICE (WSO2PDF.exe): modulo installabile
come servizio di NT.
UTIL-OBJECT 2 PDF CONVERTER (WSX2PDF.exe) : modulo ausiliario per
‰
l’esecuzione delle “stampe” PDF.
‰
UTIL-OBJECT 2 PDF MONITOR (WSO2PDFMON.exe): modulo per la
gestione e il monitoraggio dei servizi di sistema.
‰
UTIL-OBJECT 2 PDF TRAY (WSO2PDFTRAY.exe): modulo master per la
gestione (start-stop) dei servizi.
2.2 Requisiti
- Per poter utilizzare questo convertitore PDF è necessario aver installato i
seguenti programmi.
- WebSPI
- Pacchetto Office con almeno Word ed Excel
- Adobe Reader (ver. 6.0 o superiore)
- Internet Explorer 6 o superiore
- Si ricorda inoltre che il programma interagisce con il desktop, è quindi
sconsigliata l’installazione su una WorkStation dove normalmente lavora un
utente.
- Nel caso il convertitore sia installato su una macchina poco prestante, è
consigliabile settare la memoria virtuale della stessa nel modo seguente:
Dimensione Iniziale = dimensione RAM * 3
Dimensione massima = Dimensione Iniziale + dimensione della RAM
esempio:
se il PC ha 512 Mb di RAM,
la Dimensione Iniziale va impostata a 512 * 3, cioè a 1536 Mb.
la Dimensione Massima è uguale a 1536 (Dimensione Iniziale) + 512
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 2 di 16
(dimensione RAM), cioè 2048.
3
INSTALLAZIONE
L’installazione di WSO2PDF può essere effettuata in due modi diversi, tramite
compact disk o tramite l’application handler.
L’installazione da cd prevede solo l’esecuzione del file Setup32.exe, a quel
punto in modo automatico verranno installati tutti i componenti. Tuttavia può
essere eseguita solo se sul computer è presente il Runtime. La directory di
installazione deve obbligatoriamente essere C:\EDMAPP.
Per eseguire l’installazione dall’ Application Handler seguite le istruzioni
riportate di seguito:
1) Selezionate il prodotto “Runtime Windows NT4.0/2000” e il prodotto
“Modulo di Conversione PDF - WSO2PDF”:
2) premete il tasto installa e confermate l’inizio dell’installazione:
Quando l’installazione risulta terminata chiudete il software d’installazione.
3.1 WSO2PDF Service
L’installazione di questo servizio permette tra le altre cose di impostare una
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 3 di 16
stampante virtuale (PSG PS Virtual Printer).
Per effettuare l’installazione di questo programma come servizio è necessario:
1) Aprire una sessione Prompt di Dos, posizionarsi sulla cartella C:\EDMAPP
tramite il comando cd edmapp:
2) Digitare il comando “WSO2PDF.exe –i”, l’opzione –i sta a significare che
volete installare il servizio. (-u per effettuare la disinstallazione).
3) Dall’opzione “Strumenti di Amministrazione” del Pannello di Controllo
selezionate “Servizi”
4) Selezionate il servizio “WSObject 2 PDF Service” facendo un doppio
click:
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 4 di 16
5) Sull’opzione tipo avvio slezionate “Automatico”.
6) Spostatevi sul tab “Connessione”:
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 5 di 16
7) Configurate le proprietà di connessione selezionando il Ceck box “Account
di sistema locale” e il ceck box “Consenti al servizio di interagire col
desktop”.
Quest’ultimo, è molto importante perché permette a WSO2PDF di interagire con gli altri programmi già
installati sul PC che lui sfrutta ed utilizza, ad esempio WORD.
Per questo motivo WSO2PDF deve essere installato e deve funzionare
utilizzando lo stesso utente che ha effettuato l’installazione dei programmi
da lui sfruttati.
8) Premete “Applica” e “OK” per uscire.
E’ necessario specificare l’utenza che sarà utilizzata dal servizio per lavorare,
immettendo i seguenti dati nella SezioneUtente presente nel file WSO2PDF.ini
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 6 di 16
che viene creato dopo la prima esecuzione dell’interfaccia WSO2PDFMON.exe:
Parametro UtenteLocale: Il nome dell’utente loggato che sarà utilizzato dal
servizio “WSObject 2 PDF Service” per lavorare (in genere è lo stesso utente
che ha effettuato anche l’installazione di WSObject 2 PDF Service).
Parametro PasswordUtenteLocale: Password dell’utente locale
Parametro DominioUtenteLocale: Il dominio a cui appartiene l’utente, se
l’utente non appartiene ad alcun dominio di rete, significa che è un utente della
macchina locale, ragion per cui il dominio sarà il nome della macchina stessa.
N.B. il parametro EpasswordUtenteLocale non deve essere compilato
dall’utente, verrà invece compilato dal servizio di conversione PDF alla prima
esecuzione; il dato che verrà successivamente aggiunto, corrisponde alla
password criptata dell’utente.
3.2 Configurazione tramite interfaccia WSO2PDFMON
La configurazione dei Sistemi e delle Connessioni viene effettuata tramite
l’applicazione Wso2PDFMon.exe. L’applicazione viene utilizzata non solo per
configurare il sistema ma anche per monitorare servizi e conversioni di più
sistemi.
L’applicazione ha questa interfaccia utente:
3.2.1 Sezione Utente
I parametri citati in questa sezione, non riguardano le connessioni As400 bensì
la macchina locale che esegue la conversione dei documenti in PDF.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 7 di 16
I parametri:
Percorso di lavoro: E’ il percorso dove vengono posizionati i documenti
durante la conversione; solitamente si crea una directory di lavoro di nome
\WATCH all’interno di C:\EDMAPP.
Configurazioni Attive: Visualizza il numero di connessioni configurate.
Utente Locale: Il nome dell’utente loggato che sarà utilizzato dal servizio
“wso2pdf” per lavorare (in genere è lo stesso utente che ha effettuato anche
l’installazione di WSO2PDF).
Password: Password dell’utente locale
Dominio Utente Locale: Il dominio a cui appartiene l’utente, se l’utente non
appartiene ad alcun dominio di rete, significa che è un utente della macchina
locale, ragion per cui il dominio sarà il nome della macchina stessa.
Numero Max Secondi Retry: secondi entro cui la conversione di un
documento deve essere terminata, in caso contrario il convertitore interrompe il
lavoro sul documento che stava elaborando e dichiara per quella conversione lo
stato di ERRORE.
Config. Attive: Sono elencati gli ID degli As400 collegati e configurati per
questo servizio.
Ecco un esempio di configurazione della Sezione Utente.
3.2.2 Configurazione Sistemi
I parametri citati in questa sezione riguardano le connessioni As400. Sono
specificati i dati di connessione e la libreria da utilizzare durante la conversione
di documenti.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 8 di 16
Per aggiungere un “sistema” seguire la procedura:
1. Inserire nel campo “Nome Sistema” l’ID della macchina AS400 che volete
collegare e premete il pulsante “Aggiungi”
2. Confermare l’aggiunta del nuovo sistema.
3. Appariranno ora i dati di default riguardanti il sistema aggiunto.
I parametri di questa sezione:
Host: Indirizzo IP della macchina AS400.
Utente: Utente per la connessione AS400
NetBios Host: Il nome corrispondente alla macchina AS400 configurato nel file
“lmhost”.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 9 di 16
Porta http: deve sempre essere “4400”.
Password: Password per l’utente utilizzato per la connessione AS400
DBLinks Lib: Il nome della libreria utilizzata durante le operazioni di
conversione; solitamente il nome è “DBLFIxx” dove le “xx” indicano il suffisso
della ditta configurata su AS400, ad esempio “DBLFIEP”.
Scrivi file di Log: Se selezionato questo parametro, durante il lavoro di
conversione di WSO2PDF, verranno tracciate le varie operazioni effettuate in un
file di Log di nome OBJ2PDF.log, quest’ultimo si trova nella cartella
C:\EDMAPP\LOG\.
Ecco un esempio di configurazione della Sezione Configurazione Sistemi.
4. Una volta inseriti i dati, premere il pulsante “Salva” per mantenere le
impostazioni.
3.3 Configurazione della stampante virtuale
1. Dal menu Start di Windows selezionare Impostazioni – Stampanti.
2. Cliccare con il tasto destro del mouse su PSG PS Virtual Printer e
selezionare la voce Proprietà dal menu contestuale.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 10 di 16
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 11 di 16
3. Selezionare Impostazioni periferica e impostare la voce Assegnazione
dei fogli a cassetti al valore: A4.
4. Confermare il dato premendo il tasto OK.
5. Sempre dalla cartella stampanti cliccare con il tasto destro del mouse la voce
PSG PS Virtual Printer e selezionare la voce Preferenze di stampa dal
menu contestuale.
6. Selezionare Qualità Carta e quindi premere il tasto Avanzate.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 12 di 16
7. Impostare il campo Carta/Output al valore A4.
8. Premere OK per confermare.
4
UTILITA’ PER LA CONVERSIONE
4.1 Segnalazione conversione bloccata
E’ possibile che la conversione di un documento non vada a buon fine. I motivi
possono essere molteplici, l’utente ha tentato di convertire documenti protetti
da password o documenti con particolari componenti non supportate.
Per monitorare il buon funzionamento del servizio di conversione c’è a
disposizione un sistema di messaggistica che permette in tempo reale di inviare
una segnalazione ad un utente della situazione critica creatasi.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 13 di 16
Per attivare la funzione Message Timeout, è necessario compilare due parametri
presenti nella Sezione Utente del file WSO2PDF.ini :
- AdminMessageTimeout: espresso in secondi, è il tempo ipoteticamente
concesso ad un processo di conversione per eseguire il proprio lavoro,
oltre il quale sarà inviata una notifica. L’impostazione di questo tempo
deve essere fatta considerando alcuni fattori che pregiudicheranno la
velocità di conversione, ad esempio:
o la velocità della macchina
-
o
la dimensione media dei documenti che normalmente si convertono
o
l’attivazione o meno della creazione dei Bookmark
Normalmente in 120 secondi vengono convertiti documenti di discrete
dimensioni.
AdminAccount: qui vanno specificati i destinatari del messaggio che
possono essere:
o Il nome di un singolo utente (registrato al Dominio in uso)
o
Il nome di una macchina presente in rete
o
Il nome di un gruppo di lavoro presente a livello di Dominio su
Windows Server
Durante il processo di conversione quindi se verranno superati i secondi
specificati al parametro AdminMessageTimeout, verrà visualizzato un
messaggio di avvertimento al destinatario specificato al parametro
AdminAccount.
Ovviamente se dovesse essere convertito un documento di dimensioni
sostenute e il tempo di conversione dovesse superare i secondi specificati, le
segnalazioni di Time Out verranno spedite ma la conversione proseguirà senza
problemi.
N.B. Per poter utilizzare i Messaggi di Timeout, deve essere installato e attivo
nella rete aziendale, Windows NT (o 2000) Server.
4.2 Selezione creazione Bookmark
E’ possibile abilitare o meno la conversione e creazione dei Bookmark.
Questa opzione è stata inserita per facilitare il lavoro di conversione al
WSO2PDF.exe; accade infatti che in presenza di alcune particolari componenti
all’interno del documento da convertire, il processo di creazione dei Bookmark
risulti molto lento.
La presenza ad esempio all’interno del documento di molte tabelle, rallenta
molto la conversione del documento stesso.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 14 di 16
Per ovviare a questo problema è possibile disabilitare la conversione dei Titoli
del documento in Bookmark fissando il parametro DoBookmarkAnalisys al
valore FALSE.
Il parametro si trova anch’esso nel file WSO2PDF.ini in ogni singola sezione con
il nome del Sistema installato.
5
ESECUZIONE E STATO DEL SERVIZIO WSO2PDF
Da questa sezione, possiamo gestire l’accensione / spegnimento del servizio.
Possiamo inoltre visualizzare lo stato del servizio stesso.
1. Premere “Avvia Servizio” per avviare la conversione PDF.
2. Premere “Interrompi Servizio” per arrestare la conversione PDF.
Durante il funzionamento il programma può interagire con il Desktop, è quindi
consigliabile effettuare l’installazione su una macchina Server o che comunque
non viene utilizzata normalmente da un utente.
6
NOTE PER LE INSTALLAZIONI SU O.S. DI TIPO SERVER
(WIN SERVER 2000 O 2003)
6.1 Posizione file di configurazione Wso2pdf.ini
Considerare durante l’installazione che il file WSO2PDF.ini viene messo
automaticamente nella cartella WINDOWS personalizzata dell’utente per cui si
effettua l’installazione. Una volta effettuata la configurazione in modo corretto,
copiare il file anche nella cartella C:\windows.
6.2 Utilizzo e impostazione del modulo Wso2PdfTray.
Normalmente Wso2PdfTray monitorizza la situazione del desktop fornendo
informazioni al servizio Wso2Pdf sullo stato del desktop, se bloccato o in uso da
un utente.
Ad ogni passaggio di “stato” del desktop Wso2PdfTray.exe provvede a resettare
il servizio e a fare in modo che lo stesso acquisisca la nuova situazione desktop.
Dipendentemente da questo “stato” desktop, il servizio funziona in un modo
piuttosto che in un altro.
In particolare su macchine con Windows Server può accadere che
l’amministratore o gli amministratori si colleghino tramite un desktop remoto.
Questa particolare situazione rende Wso2PdfTray incapace di conoscere quale è
la situazione reale sul desktop principale presente direttamente sul server.
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 15 di 16
Accade infatti che collegandosi in remoto, Wso2PdfTray resetta il servizio
facendo credere allo stesso che un utente sia loggato sul desktop reale del
server, ma in questo caso non è vero perché sul desktop locale del server
nessuno è loggato e il desktop è bloccato. Il servizio si trova quindi in uno stato
anomalo e non riesce a lavorare in modo corretto.
Per ovviare al problema è necessario fare in modo che Wso2PdfTray funzioni
solo quando il desktop locale del server viene sbloccato e utilizzato da un
utente.
Seguire quindi la seguente procedura:
1. Avviare il Registro di Sistema
2.
Posizionarsi
alla
chiave
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Ru
3. Eliminare la stringa “Wso2PdfTray” che dovrebbe corrispondere al
valore “C:\Edmapp\WsO2PdfT.exe”.
4. Un collegamento allo stesso eseguibile WsO2PdfT.exe deve essere
posizionato nell’Esecuzione Automatica dell’utente che normalmente si
logga alla consolle del server (normalmente Administrator).
6.3 Primo Lancio Applicazioni con Utente Configurato
E’ molto importante che l’utente che viene configurato per l’utilizzo del servizio
Wso2Pdf si sia loggato almeno una volta sulla macchina su cui è montato il
convertitore. L’utente configurato deve anche aver avviato almeno una volta i
programmi d’appoggio sfruttati dal convertitore (WebSPI, Word, Excel, Adobe
Reader, etc.)
Per qualsiasi problema che possa essere riconducibile all’utenza utilizzata,
eseguire dei test controllando il Task Manager, da dove è possibile vedere
l’utente utilizzato dal modulo Wsx2Pdf.exe mentre esegue il lavoro di
conversione.
7
NOTE
La configurazione effettuata con WSO2PDFMON viene salvata nel file
wso2pdf.ini presente nella directory del sistema operativo, normalmente
C:\WINNT o C:\WINDOWS .
Esempio di configurazione:
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007
q
Pagina 16 di 16
http://217.133.51.133:4400/WGHDBLINK/6002/AttivazioneServerPDF-Id(20051202... 15/06/2007