maildocpro Manuale Installazione

Transcript

1 maildocpro Manuale Installazione versione 3.4 maildocpro Manuale Installazione - Versione 3.4 1

2 Indice Indice... 2 Creazione database... 3 Database: MAILDOCPRO... 3 Database: SILOGONWEB... 5 Configurazione Utenza SQL... 6 maildocpro Web App... 7 Installazione Tipica... 9 Installazione Personalizzata MainFeature Global Address List Rubrica PA Corrispondenza On Line Invio Massivo Certificati INPS e Grandi Contribuenti Servizio Invio e Ricezione Mail Evoluto Altri Servizi Web Services Configurazione IIS maildocpro Manuale Installazione - Versione 3.4 2

3 Creazione database Prima di installare l applicativo maildocpro è necessario creare e valorizzare i database necessari, i quali conterranno i dati salvati e gestiti dall applicativo stesso. Per fare ciò è necessario utilizzare alcuni script che vengono eseguiti grazie a Microsoft SQL Server Management Studio. Per ogni database da creare è previsto un apposito script: Database: MAILDOCPRO Scaricare l apposito script di creazione del database interessato al seguente link: se.maildocpro.db_34.zip Aprire lo script appena scaricato con SQL Server Management Studio: maildocpro Manuale Installazione - Versione 3.4 3

4 Le variabili da valorizzare sono quelle presenti nell immagine sopra (riquadro in verde): AMBIENTE: impostare il tipo di ambiente di installazione (collaudo o produzione ad esempio, consigliabile mantenere PRODUZIONE) DatabaseName: impostare il nome che si vuole assegnare al nuovo database (consigliabile utilizzare MAILDOCPRO) DefaultDataPath: impostare il percorso fisico in cui il database verrà allocato (ad es: C:\Program Files\Microsoft SQL Server\MSSQL10.SQLEXPRESS\MSSQL\DATA) DefaultLogPath: impostare il percorso fisico in cui il file di log del database verrà scritto (ad es: C:\Program Files\Microsoft SQL Server\MSSQL10.SQLEXPRESS\MSSQL\LOG) A questo punto selezionare la modalità SQLCMD Mode dalla tab Query, come da immagine sottostante: Impostare poi l attributo master (necessario per la creazione di un nuovo database): Infine premere il pulsante dell operazione. per eseguire la query ed attendere il corretto completamento maildocpro Manuale Installazione - Versione 3.4 4

5 Database: SILOGONWEB Lo stesso procedimento va seguito per la creazione e valorizzazione del db SILOGONWEB, cioè il database di autenticazione contenente i dati per l accesso all applicativo (tra cui in particolare user e password). Scaricare l apposito script di creazione del database interessato al seguente link: se.silogonweb.db_8.zip Aprire lo script appena scaricato con SQL Server Management Studio: Le variabili da valorizzare sono quelle presenti nell immagine sopra (riquadro in verde): DatabaseName: impostare il nome che si vuole assegnare al nuovo database (consigliabile utilizzare SILOGONWEB) DefaultDataPath: impostare il percorso fisico in cui il database verrà allocato (ad es: C:\Program Files\Microsoft SQL Server\MSSQL10.SQLEXPRESS\MSSQL\DATA) DefaultLogPath: impostare il percorso fisico in cui il file di log del database verrà scritto (ad es: C:\Program Files\Microsoft SQL Server\MSSQL10.SQLEXPRESS\MSSQL\LOG) Come per il database creato in precedenza, selezionare la modalità SQLCMMode e quindi cliccare sul pulsante Execute. Attendere infine il corretto completamento dell operazione. maildocpro Manuale Installazione - Versione 3.4 5

6 Configurazione Utenza SQL Dopo aver creato i database assicurarsi che agli stessi sia associata una utenza SQL che abbia i privilegi di db_owner e public (come da immagine). Questa è la stessa utenza che (come verrà spiegato più avanti, a pag. di questo manuale) dovrà essere configurata all interno dell applicativo in modo che quest ultimo possa avere accesso ai dati contenuti nei database: Nella sezione Security\Logins creare una nuova utenza SQL (o utilizzare una utenza già esistente) ed associarla ai due database creati in precedenza. N.B: Assicurarsi inoltre, come già accennato, che tale utenza abbia i permessi db_owner e public su entrambi i database (frecce verdi). maildocpro Manuale Installazione - Versione 3.4 6

7 maildocpro Web App Si tratta del pacchetto di installazione dell applicazione web vera e propria. Il setup fornito da Studio Informatica prevede una serie di wizard intuitivi grazie ai quali è facilmente possibile installare l applicativo su di un server dedicato (N.B: è importante leggere attentamente il documento tecnico elencante prerequisiti necessari ai fini dell installazione). Dopo aver verificato la presenza di tutti i prerequisiti necessari, scaricare il pacchetto di installazione al seguente link: WebApp.zip Eseguendo il setup, la prima schermata di presentazione ci dà il benvenuto all interno della procedura guidata. E sufficiente cliccare sul tasto Avanti. maildocpro Manuale Installazione - Versione 3.4 7

8 La schermata successiva presenta il Contratto di licenza software : è necessario leggerlo e successivamente selezionare l opzione Accetto i termini e condizioni di licenza. Cliccare quindi sul tasto Avanti. La terza schermata permette di scegliere il tipo di installazione desiderato. maildocpro Manuale Installazione - Versione 3.4 8

9 Nello specifico è possibile optare tra: Installazione Tipica Installazione Personalizzata Installazione Tipica Selezionando il tipo di installazione Tipica sarà sufficiente inserire i dati di connessione ai database in quanto per tutti gli altri parametri verranno utilizzate le configurazioni standard. Questo tipo di installazione è consigliato per gli utenti meno esperti o che non desiderano impostare personalizzazioni particolari all interno dell applicativo. Con questa opzione viene ad esempio utilizzato, per il posizionamento delle cartelle e dei relativi files su filesystem, il path di default: C:\Program Files\Studio Informatica\mailDocPRO. I dati di Connessione SQL Server vanno compilati nel modo illustrato: Istanza SQL: istanza completa del server SQL Nome utente: utenza SQL associata ai database di maildocpro Password: password dell utenza di cui sopra DB Applicazione: nome del DB dati di maildocpro (es: MAILDOCPRO) DB Utenti: nome del DB di autenticazione (es: SILOGONWEB) Terminato l inserimento dei dati cliccare infine sul tasto Installa. maildocpro Manuale Installazione - Versione 3.4 9

10 Installazione Personalizzata Selezionando il tipo di installazione Personalizzata sarà invece possibile configurare a piacimento alcuni parametri selezionando le Feature da personalizzare dall apposito elenco. MainFeature Selezionando soltanto l opzione MainFeature si possono impostare i parametri principali di installazione. In particolare: Percorso di installazione: maildocpro Manuale Installazione - Versione

11 Parametri standard: o Autenticazione: attraverso questo combo è possibile definire innanzitutto il tipo di autenticazione desiderata: Standard, Single SignOn oppure Personalizzata 8per una definizione più dettagliata si rimanda al Manuale Amministratore). o Periodo su filesystem delle PEC: periodo (in giorni) in cui mantenere le PEC all interno di una apposita cartella del disco rigido in cui è installato l applicativo (percorso che viene definito più sotto in Salvataggio Mail). o Mail da scaricare per connessione: numero massimo di PEC che vengono scaricate ad ogni ciclo di thread del Servizio Invio e Ricezione Mail. o Timeout connessione gestore PEC: secondi di timeout del sistema. o Salvataggio mail: percorso filesystem in cui salvare temporaneamente le mail (vedi periodo su filesystem). Selezionare il percorso di installazione del servizio mail, ad es: C:\Program Files\Studio Informatica\mailDocPRO Servizio Mail\Store o Log connessione: percorso di salvataggio dei log tracciati dall applicativo. Selezionare il percorso di installazione di maildocpro, ad es: C:\Program Files\Studio Informatica\mailDocPRO\Log maildocpro Manuale Installazione - Versione

12 Global Address List Selezionando, oltre a MainFeature, anche l opzione Global Address List è possibile configurare i dati necessari ad impostare, all interno dell applicativo, la propria Global Address List (GAL). Si tratta di una rubrica condivisa, che di solito contiene i riferimenti di tutte le persone di una determinata organizzazione (azienda, scuola, ecc). A questa rubrica si accede attraverso la rete aziendale di computer usando il protocollo LDAP. La rubrica GAL è di solito di sola lettura per gli utenti, solo gli amministratori possono aggiungere o aggiornare le voci. Gli utenti possono accedervi, ricercare altre persone (lavoratori, studenti, soci, ecc) e ottenere informazioni su di loro, come l'indirizzo e mail, il numero di telefono, la posizione di lavoro, la sede di uffici e altri. L'uso comune della GAL è se l'utente sta scrivendo una e mail, conosce il nome del destinatario, ma non il suo indirizzo e mail, può ricercare l'indirizzo e mail all interno della stessa scrivendo solo una parte del nome del destinatario. I campi sopra illustrati vanno compilati inserendo i dati di accesso al proprio server LDAP: o Server LDAP: nome del server o Porta: porta di accesso (se standard, 389) o Username: user di accesso al server o Password: password dello user di cui sopra o Root: root del dominio del nodo LDAP maildocpro Manuale Installazione - Versione

13 Rubrica PA Tramite questa scheda è possibile configurare l accesso alla rubrica PA, cioè l'indice degli indirizzi della pubblica amministrazione e dei gestori di pubblici servizi. Nei campi sottostanti è necessario inserire i dati ottenuti a seguito dell accreditamento al sito Indice delle Pubbliche Amministrazioni ( ). Riportare le informazioni di accesso, ottenute in seguito all accreditamento, nei due campi Username e Password. Infine cliccare su Avanti. maildocpro Manuale Installazione - Versione

14 Corrispondenza On Line In questa schermata è necessario scegliere quali credenziali utilizzare per l invio della Corrispondenza on Line. Se viene selezionata l opzione Test verranno inseriti all interno dei file di configurazione i parametri di test di Poste Italiane, mentre selezionando Produzione verranno inserirti i parametri ufficiali di produzione grazie ai quali sarà possibile effettuare invii reali. La seconda opzione va utilizzata soltanto nel caso in cui, a seguito di accreditamento ai servizi H2H di Poste Italiane, si abbia già la disponibilità dei dati di produzione che andranno inseriti negli appositi campi in fase di creazione degli Account COL (Username e Password, questa parte è successiva, riguarda la configurazione dell applicativo). N.B: utilizzando il tipo di installazione Tipica verranno di default inseriti i parametri di collaudo. Selezionare l opzione desidera quindi cliccare su Avanti. maildocpro Manuale Installazione - Versione

15 Invio Massivo In questa schermata è possibile impostare i parametri riguardanti la funzionalità di Invio Massivo di Posta Elettronica Certificata. In particolare è possibile configurare le cartelle in cui verranno salvati gli allegati degli invii massivi, sia quelli riguardanti gli invii Massivi di Posta Elettronica Certificata (Allegati Massivi) sia quelli riguardanti gli invii di Lotti PEC (Allegati Lotti). Terminata l impostazione dei campi, cliccare su Avanti. maildocpro Manuale Installazione - Versione

16 Certificati INPS e Grandi Contribuenti Selezionando, infine, le opzioni Certificati INPS e\o Grandi Contribuenti è possibile attivare anche le funzionalità GRACO e CELINE all interno dell applicativo. Per la spiegazione più dettagliata di queste funzionalità rimandiamo alla lettura dei documenti relativi Non è necessario compiere altre attività di inserimento dati in quanto queste opzioni permettono semplicemente di attivare o disattivare tali funzionalità all interno dell applicativo. Ognuna di queste due funzioni prevede la creazione di una database dedicato, che viene fornito su specifica richiesta. Per le configurazioni sarà necessario attendere il termine dell installazione e d operare all interno del prodotto maildocpro. maildocpro Manuale Installazione - Versione

17 Servizio Invio e Ricezione Mail Evoluto Il Servizio Invio e Ricezione Mail Evoluto è il servizio Windows che permette all applicativo di ricevere ed inviare posta elettronica certificata. Anche in questo caso è possibile scegliere tra i due tipi di installazione. Le uniche personalizzazioni possibili però, scegliendo la modalità di installazione Personalizzata, riguardano il percorso di installazione ed il percorso di Salvataggio mail e Log connessione. Mentre nella Web App il percorso di salvataggio mail si riferiva al servizio mail e i log di connessione alla cartella maildocpro, in questo caso entrambi i percorsi faranno riferimento alla cartella di installazione del servizio mail: o Salvataggio Mail: C:\Program Files\Studio Informatica\mailDocPRO Servizio Mail\Store o Log connessione: C:\Program Files\Studio Informatica\mailDocPRO Servizio Mail\Log Per il resto è necessario compilare i dati di Connessione SQL Server come visto nel paragrafo precedente. Infine cliccare sul tasto Avanti. maildocpro Manuale Installazione - Versione

18 Altri Servizi Gli altri servizi windows collegati all applicativo maildocpro sono i seguenti: Servizio COL: servizio windows necessario per ricevere e spedire Corrispondenza on Line tramite i servizi offerti da Poste Italiane. Servizio Lotti: servizio windows che permette di effettuare invii massivi di posta elettronica certificata. Servizio SMS: servizio windows che permette di utilizzare la funzionalità di invio di sms. Servizio Archiviazione: servizio windows che permette di utilizzare la funzionalità di archiviazione della Posta Elettronica Certificata su filesystem. Anche questi servizi sono dotati di apposito setup allo stesso modo del Servizio Invio e Ricezione Mail. Per l installazione fare riferimento quindi alla sezione dedicata a tale servizio. maildocpro Manuale Installazione - Versione

19 Web Services In questa sezione è possibile installare i Web Services maildocpro. Definizione di web services: è un sistema software progettato per supportare l'interoperabilità tra diversi elaboratori su di una medesima rete ovvero in un contesto distribuito; tale caratteristica si ottiene associando all'applicazione un'interfaccia software che espone all'esterno il servizio/i associato/i e utilizzando la quale altri sistemi possono interagire con l'applicazione stessa attivando le operazioni descritte nell'interfaccia (servizi o richieste di procedure remote) tramite appositi "messaggi" di richiesta: tali messaggi di richiesta sono inclusi in una "busta" (la più famosa è SOAP), formattati secondo lo standard XML, incapsulati e trasportati tramite i protocolli del Web (solitamente HTTP), da cui appunto il nome web service. Il setup è strutturato in modo da installare anche il relativo sito su Internet Information Services. Non è necessaria quindi nessuna operazione aggiuntiva oltra all inserimento del percorso filesystem di installazione (vedi immagine sopra). Quindi cliccare su Avanti e poi su Installa. maildocpro Manuale Installazione - Versione

20 Configurazione IIS A seguito dell installazione di maildocpro WebApp, con relativo setup, sarà necessario creare e configurare il sito web utilizzando Internet Information Services. In questo manuale verrà fatto riferimento alla versione 7 di IIS, comunemente la più utilizzata. Avviare IIS da Administrative Tools (o con comando rapido cmd: inetmgr). Per prima cosa sotto Application Pools verificare l esistenza delle voci indicate nell immagine seguente: maildocpro Manuale Installazione - Versione

21 Qualora non fossero presenti le due voci, procedere nel seguente modo: Aprire Prompt dei comandi Posizionarsi sul percorso del Framework.NET bit (C:\Windows\Microsoft.NET\Framework64\v ) Eseguire il comando: aspnet_regiis.exe i maildocpro Manuale Installazione - Versione

22 Attendere conclusione del comando: Tale attività è necessaria per installare e registrare la versione di ASP.NET, indispensabile per il corretto funzionamento dell applicativo maildocpro. VERSIONE 7 Internet Information Services Selezionare sotto la cartella Sites il sito Default Web Site, tasto destro e quindi Add Application (cerchio verde): maildocpro Manuale Installazione - Versione

23 Completare la scheda Add Application inserendo i valori nei vari campi: Alias: indicare il nome da assegnare al sito web (consigliabile maildocpro) Application pool: associare l app pool desiderata (consigliata ASP.NET v4.0 Classic) Physical path: indicare il path in cui sono presenti i file di installazione maildocpro (es: C.\Program Files\Studio Informatica\mailDocPRO) Cliccare su OK. Il sito web è così creato. Posizionarsi poi sul livello più alto di IIS (il server) e cliccare su ISAPI and CGI Restrictions (cerchio verde): maildocpro Manuale Installazione - Versione

24 Nell elenco accertarsi che la versione necessaria (ASP.NET v ) sia abilitata (allowed). La prima riga fa riferimento ai sistemi a 32 bit mentre la seconda ai sistemi a 64 bit. Ora sarà necessario creare l estensione (.wgx) a cui punterà il sito web. Posizionarsi sul nuovo sito web creato (maildocpro) e selezionare Handler Mappings (cerchio rosso): maildocpro Manuale Installazione - Versione

25 Nella colonna Actions di sinistra cliccare Add Script Map: Completare la scheda compilando i vari campi: Request path: inserire come nell esempio *.wgx Executable: inserire il percorso dove è presente l eseguibile del Framework necessario per l estensione da creare (utilizzare il percorso come da esempio, C:\Windows\Microsoft.NET\Framework64\v \) Name: indicare il nome che si vuol dare all estensione maildocpro Manuale Installazione - Versione

26 Dopo aver terminato la creazione e configurazione del sito chiudere IIS. N.B: Aggiungere al percorso di root di installazione applicativa (ad es. C:\Program Files\Studio Informatica\mailDocPRO) i permessi in Modifica al gruppo di utenti dell application pool: IIS_IUSR. Al termine di tutto, se le configurazioni saranno state rispettate, l indirizzo web per accedere da browser all applicativo maildocpro sarà il seguente: macchina/maildocpro/mainform.wgx. Per il successivo e corretto utilizzo del prodotto leggere attentamente tutti i documenti e manuali collegati. maildocpro Manuale Installazione - Versione