Manuale installazione KNOS

Manuale installazione KNOS 1. PREREQUISITI... 3 1.1 PIATTAFORME CLIENT... 3 1.2 PIATTAFORME SERVER... 3 1.3 PIATTAFORME DATABASE... 3 1.4 ALTRE APPLICAZIONI LATO SERVER... 3 1.5 ALTRE APPLICAZIONI LATO CLIENT... 3 1.6 INCOMPATIBILITÀ... 3 1.7 PREREQUISITI HARDWARE... 3 2. CONFIGURAZIONE SOFTWARE PRE-INSTALLAZIONE... 4 2.1 LATO SERVER DATABASE... 4 2.2 LATO SERVER WEB... 4 3. INSTALLAZIONE LATO SERVER...19 3.1 INSTALLAZIONE DATA BASE... 19 3.2 INSTALLAZIONE SITO WEB... 23 4. CONFIGURAZIONE SOFTWARE POST-INSTALLAZIONE...28 4.1 LATO SERVER: CONFIGURARE UTILIZZO.NET 4.0.X.... 28 4.2 LATO SERVER: INSTALLAZIONE SERVIZI KNOSSERVICEMANAGER E ICMAILSERVICE.... 29 4.3 LATO CLIENT: CONFIGURARE LA SICUREZZA DI INTERNET EXPLORER.... 29 5. ESECUZIONE DI KNOS E ATTIVAZIONE DELLA LICENZA...31 6. INSTALLAZIONE LATO CLIENT...34 7. AGGIORNAMENTO DI VERSIONI PRECEDENTI 6.X...37 8. RISOLUZIONE PROBLEMI NOTI...38 8.1 KNOSSERVICEMANAGER... 38 8.2 CONFLITTO CON EXCHANGE O ALTRE APPLICAZIONI... 39 8.3 APERTURA FILE CON ESTENSIONE.P7M... 39 Pagina 2

1. Prerequisiti 1.1 Piattaforme Client - Microsoft Windows XP Professional SP3 o successivo (X86 o X64) - Microsoft Windows Vista Business, Ultimate o Enterprise SP1 o successivo (X86 o X64) - Microsoft Windows 7 Professional, Ultimate o Enterprise (X86 o X64) - Microsoft Windows 8 e 8.1 1.2 Piattaforme Server - Microsoft Windows Server 2003 SP2 o successiva (X86 o X64) - Microsoft Windows Server 2003 R2 SP2 o successiva (X86 o X64) - Microsoft Small Business Server 2008 (X86 o X64) - Microsoft Windows Server 2008 (X86 o X64) - Microsoft Windows Server 2008 R2 1.3 Piattaforme DataBase - MS-SQL 2005 SP3 (32 e 64 bit) - MS-SQL 2008 SP1 (32 e 64 bit) - MS-SQL 2008 R2 - MS-SQL 2008 express R2 with advanced service (32 e 64 bit) - MS-SQL 2012 (32 e 64 bit) 1.4 Altre Applicazioni lato server - IIS6 internet information service - Net Framework 4.0 (o superiore) - SQL Native Client - IE 6 Internet Explorer o superiore - Silverlight 4.0 1.5 Altre Applicazioni lato client -.Net Framework 4.0 (o superiore) - IE 6 o superiore - Silverlight 4.0 1.6 Incompatibilità Abbiamo accertato l incompatibilità con Microsoft Search 1.7 Prerequisiti Hardware 1 CPU Intel Pentium-compatibile da 1 gigahertz (GHz) o maggiore 2 gigabyte (GB) di RAM 20 gigabyte (GB) di hard disk. I prerequisiti minimi Lato Client prevedono: Internet Explorer 6 (o superiore) qualsiasi versione di Windows in grado di supportare Internet Explorer 6 (o superiore). Pagina 3

2. Configurazione Software pre-installazione 2.1 Lato Server Database Installare il servizio SQL Full Text Filter e configurarlo con partenza automatica. Per vedere se il servizio è attivo basta fare la seguente query sul DB: SELECT SERVERPROPERTY( IsFullTextInstalled ); Se il valore è 1, il servizio è attivo. 2.2 Lato Server Web - Installare Sql Native client fornito a corredo dell installazione - Verificare se il server web accede al server database, se questi non coincidono, utilizzare per il test un client SQL (es. SQLDBX, fornito a corredo dell installazione) - Installare e configurare IIS. - Installare il servizio Indicizzazione Vedremo ora nel dettaglio a seconda del sistema operativo, come procedere nell attivazione delle funzionalità indispensabili al funzionamento di KnoS. Le seguenti videate possono cambiare leggermente a seconda della versione del medesimo sistema operativo installata ed anche in funzione di eventuali service pack e aggiornamenti di sistema. Occorre prestare la massima attenzione nell abilitazione di tutte le funzionalità qui descritte; in caso contrario si potrebbe compromettere il corretto funzionamento di Knos. Nota: KnoS utilizza unicamente la SQL Server authentication, perciò SQL Server deve essere configurato in modo da accettare autenticazioni miste (SQL Server e autenticazione integrata) Windows 2003 Server - Verificare se installato con IIS il Server Side Includes - Installare il servizio indicizzazione - Devono essere aggiunte le seguenti estensioni al servizio web All Unknown ISAPI Extension Active Server Pages ASP.NET v4.0.x Pagina 4

Windows 2008 Server Aprire Server Manager dal menu Windows, aggiungere i seguenti ruoli e configurarli nel modo seguente - Server Application - Server Web - Servizi File Pagina 5

Pagina 6

Pagina 7

Pagina 8

Windows 7 ATTENZIONE! Nelle configurazioni seguenti, le funzionalità da attivare, sono tutte obbligatorie (compresa la compatibilità con IIS 6), ed è obbligatorio disattivare Windows Search. Nel caso di sistema operative Windows 7 occorre andare nel Pannello di Controllo, scegliere Programmi e funzionalità e successivamente Attivazione/Disattivazione Funzionalità di Windows. Pagina 9

Pagina 10

Windows 8 Pagina 11

Pagina 12

Windows 2012 Pagina 13

Pagina 14

Pagina 15

Pagina 16

Pagina 17

Server Cognos L utilizzo del server Cognos comporta tipicamente anche l installazione del web server Apache. Questo apre due possibili scenari per chi volesse installare KnoS e Cognos sullo stesso server: Coesistenza di IIS e Apache sullo stesso server Utilizzo di IIS al posto di Apache per Cognos. Coesistenza di IIS e Apache sullo stesso server Vanno effettuate le seguenti modifiche: - Su file httpd.conf di Apache va modificata la porta di ascolto (ad es. da 80 a 81): la stringa Listen 80 seguendo l esempio va modificata in Listen 81 - Nella Cognos Configuration la porta specificata nell URI Gateway e nell URI Controller per Gateway deve essere modificata (ad es. da 80 a 81): Seguendo l esempio gli indirizzi diventano rispettivamente i seguenti http://localhost:81/ibmcognos/cgi-bin/cognos.cgi http://localhost:81/ibmcognos/controllerserver Seguendo queste indicazioni l URL del portale Cognos diventa il seguente: http://<ip_del_server>:81/ibmcognos Utilizzo di IIS al posto di Apache per Cognos Vanno seguite le indicazioni specificate nel seguente Technote IBM: http://www.ibm.com/developerworks/data/library/cognos/infrastructure/web_servers/page599.html?ca= drs- Seguendo queste indicazioni l URL del portale Cognos rimane invariata: http://<ip_del_server>/ibmcognos Pagina 18

3. Installazione lato server 1) Eseguire il log on sulla macchina Server Database come Administrator o come membro di un gruppo di Amministratori locali 2) Eseguire il package di installazione KnoSXXsetupGamma.exe o KnoSXXsetupMetodo.exe o KnoSXXsetupACG.exe o KnoSXXsetup.exe a seconda che debba essere integrato con i Gestionali Gamma o Metodo Evolus o ACG oppure si tratti di un installazione id KnoS come autonoma. 3) Installare i componenti Database e/o Sito WEB, insieme o separati in base alla configurazione server scelta. Di seguito dettaglieremo le installazioni separate. 3.1 Installazione Data Base 1) Selezionare la casella corrispondente e premere avanti Pagina 19

2) Nella successiva form Verifica prerequisiti premere Avanti. 3) Nella successiva form sceglie il percorso in cui andare a posizionare la cartella KnoS Questa cartella conterrà l applicazione KnoS con le sottocartelle utilizzate per la creazione del sito Web di KnoS e le sottocartelle che per ciascun sito id KnoS installato ne conterranno i file. E quindi importante prestare attenzione a tale parametro di installazione, andando a impostare il percorso ove si è ragionevolmente sicuri di avere lo spazio sufficiente per i file che si intendono gestire con KnoS. Pagina 20

4) Nella successiva form Creazione database, introdurre I parametri per la connessione a SQL Server. - Istanza SQL Server da utilizzare: nome (es. KNOSSERVER) o indirizzo IP (es. 192.168.0.1) della macchina su cui è installato SQL Server. Può essere local se SQL Server è installato sulla stessa macchina su cui è installato IIS. - Nome Database: nome del database che si vuole creare alla fine del setup - Login di un utente amministratore: è un login valido di SQL Server login che abbia permessi di amministratore (creazione database, creazione login, ) - Password: password abbinata al login precedentemente indicato. - Directory database: directory in cui si vuole salvare il file del database di KnoS, lasciare vuoto se si vuole utilizzare il default di MSSQL. Nota: KnoS utilizza unicamente la SQL Server authentication, perciò SQL Server deve essere configurato in modo da accettare autenticazioni miste (SQL Server e autenticazione integrata) Pagina 21

5) premere avanti per eseguire l installazione L installazione di KnoS integrato con Metodo Evolus o Gamma Enterprise prevede il ripristino del database prototipo a seconda del gestionale con cui è integrato. Tale operazione può richiedere l attesa di qualche decina di secondi. Al termine il setup si chiude. Pagina 22

3.2 Installazione sito web 1) Aprire il setup di KnoS, selezionare casella corrispondente a Sito Web e premere avanti 2) La form Verifica prerequisiti lancia l installazione di alcuni componenti necessari (se non sono già installati): Microsoft XML Parser 4.0 SP2 e Adobe PDF IFilter. 3) Se i prerequisiti non sono presenti viene visualizzata la seguente form. Premere Installa. Pagina 23

I prerequisiti addizionali sono solitamente assenti ed il setup li propone come da installare. Premendo avanti tali prerequisiti addizionali vengono automaticamente installati in sequenza dal setup di KnoS 4) Nella form Scelta della cartella di Installazione, scegliere la root directory per i file di KnoS (se non esiste verrà creata) Nota. Questa richiesta non viene fatta se si è già installato il database sullo stesso server. 5) Nella form Database KnoS, scegliere il nome dell istanza ed il nome del database relativi al database precedentemente installato. Cambiare l utente predefinito per l accesso al database di Knos se diverso da quello di default creato dall installazione database Pagina 24

6) Nella form Creazione Sito Web, introdurre I parametri di configurazione di IIS: - Nome Sito Web: descrizione del nuovo sito Web - Indirizzo IP: indirizzo IP utilizzato da IIS per rispondere alle richieste HTTP dirette verso KnoS. Deve essere uno degli indirizzi IP assegnati alla macchina su cui è installato IIS. Si può lasciare vuoto questo campo per utilizzare un qualsiasi indirizzo IP valido tra quelli assegnati alla macchina - Porta TCP: è la porta HTTP utilizzata da IIS. E consigliabile lasciare il valore di default 80 per evitare problemi con il firewall. Nel caso però sia già occupata sceglierne una alternativa. - Host Header name: nome dell Host Header, cioè del dominio di KnoS a cui accedere via http. Per esempio se si ha un Host Header = KNOSSETUP e la Porta TCP è la 80 (come riportato nell esempio sottostante), si dovrà digitare http://knossetup/knos/web in Internet Explorer per accedere alla home page di KnoS. NOTA IMPORTANTE: l host header name è normalmente un nome di dominio risolto da DNS o mappato nel file hosts (es. knos.italcomspa.com) oppure il nome del server su cui è eseguita l installazione. In questo ultimo caso però il nome del server deve contenere solo caratteri validi per per un nome di dominio e vale a dire: lettere, numeri e (meno), non sono ammessi altri caratteri (ad esempio _ (underscore) NON E AMMESSO. Se il nome del server contiene un underscore, ad esempio MET_SERVER non va utilizzato come host header. In questi casi se non è disponibile un nome di dominio l unica alternativa è utilizzare come host header l indirizzo IP del server. - SMTP server address: nome (o l indirizzo IP) assegnato al server SMTP da utilizzare per le notifiche via e-mail (è un parametro opzionale). Pagina 25

7) premendo Avanti partirà l installazione. Confermando la richiesta se si vuole accedere al sito, si aprirà IExplorer con il link del sito web creato. Se nell Host Header Name viene specificato un nome differente dal nome macchina e tale nome non è disponibile nell elenco DNS, l apertura del sito di Knos appena installato andrà in errore. Per risolvere localmente tale problema occorre specificare nel file C:\Windows\System32\drivers\etc\hosts l host header name utilizzato es: Pagina 26

# Copyright (c) 1993-2009 Microsoft Corp. # # This is a sample HOSTS file used by Microsoft TCP/IP for Windows. # # This file contains the mappings of IP addresses to host names. Each # entry should be kept on an individual line. The IP address should # be placed in the first column followed by the corresponding host name. # The IP address and the host name should be separated by at least one # space. # # Additionally, comments (such as these) may be inserted on individual # lines or following the machine name denoted by a '#' symbol. # # For example: # # 102.54.94.97 rhino.acme.com # source server # 38.25.63.10 x.acme.com # x client host # localhost name resolution is handled within DNS itself. # 127.0.0.1 localhost # ::1 localhost 127.0.0.1 Knos7 127.0.0.1 knos7setup Questa soluzione è praticamente obbligatoria nel caso di installazione di Knos su macchine virtuali demo o può essere d aiuto nel caso di installazione server utilizzati in modalità Terminal Server. Nel caso di una installazione aziendale, prima dell installazione occorre accertarsi che l Host Header Name che si vuole utilizzare sia raggiungibile, con un ping da linea di comando dai client che dovranno accedere al sito di Knos. Pagina 27

4. Configurazione Software post-installazione 4.1 Lato Server: configurare utilizzo.net 4.0.x. Configurare IIS il sito Knos appena creato per l utilizzo di.net 4.0.x. Per i server 2003 Per i server 2008 Se capita di aggiornare IIS o installarne delle componenti dopo aver installato.net 4.0 bisogna eseguire di nuovo il comando aspnet_regiis.exe -iru lanciandolo dalla cartella: Pagina 28

C:\Windows\Microsoft.NET\Framework\v4.0.30319 (per 32 bit) oppure C:\Windows\Microsoft.NET\Framework64\v4.0.30319 (per 64 bit) In generale è buona norma provare a farlo ogni volta che non funzionano pagine di tipo.net ovvero con estensione.aspx o.asmx 4.2 Lato Server: installazione servizi KnosServiceManager e icmailservice. Per installare eseguire da riga di comando dalla cartella dove installato knos: C:\KnoS7\bin>KnosServiceManager.exe -install C:\KnoS7\bin>KnosServiceManager.exe start C:\KnoS7\bin>icmailservice.exe install 4.3 Lato Client: configurare la sicurezza di Internet Explorer. Inserire il sito Knos creato nella intranet locale; nelle impostazioni di sicurezza attivare tutto e disabilitare solo il blocco pop-up 4.3.1 Workflow grafico Il workflow grafico richiede l installazione di Silverlight 4.0 o superiori. Se sui client il workfolw grafico non è visibile, occorre verificare che sul server dove è installato Knos, sia presente il mime-type per i file con estensione.xaml. Per farlo occorre aprire la console di gestione di IIS e sul sito di Knos andare ad aggiungere il mime-type mancante. Pagina 29

Nota Bene: in generale, tutte le estensioni di file che Knos deve riconoscere devono essere opportunamente configurate nella console di IIS sul sito di Knos Pagina 30

5. Esecuzione di Knos e attivazione della licenza Dopo aver eseguito le configurazioni di Internet Explorer occorre: 1) Aprire Internet Explorer (IE) su una macchina client che possa accedere, via HTTP, al server web 2) Impostare l indirizzo HTTP di KnoS. E una stringa tipo http://<dominio>/knos/web. <Dominio> è l Host Header impostato durante l Installazione dell applicazione (per es.: http://knossetup/knos/web). Se durante l installazione si è lasciato vuoto Host Header Name, <Dominio> è il nome di rete della macchina server. Notare che si deve sempre digitare il path virtuale /knos/web. 3) Quando si accede all applicazione per la prima volta, non si è ancora autenticati. Impostare administrator come nome utente, non impostare password e premere Accedi. 4) Si entrerà nella home page dalla quale si potrà accedere alle varie funzionalità. 5) La prima volta che ci si collega apparirà la schermata seguente: 6) Occorre richiedere la licenza ad Italcom, procedendo come segue: 7) Premere Richiedi e attiva licenza. Comparirà la seguente schermata: 8) Premere il Tab Richiesta licenza. Comparirà la seguente schermata: Pagina 31

9) Compilare opportunamente i campi e premere Genera codice di richiesta licenza 10) Inviare il codice così costruito copiandolo e inserendolo in una e-mail indirizzata a helpdesk@knos.biz o eseguendo Invia richiesta licenza, che avvia il client di posta presente sul PC. 11) Ricevuto il codice con la mail di risposta, è necessario attivare la licenza scegliendo il Tab Attivazione licenza ed inserendo nell apposita casella il codice ricevuto, come si vede nella seguente schermata: Pagina 32

12) Premere Controlla licenza e poi Attiva licenza. La licenza verrà attivata e comparirà la pagina seguente: A questo punto KnoS è utilizzabile in tutte le sue parti per le quali è stata acquisita la licenza. Pagina 33

6. Installazione lato client 1) Dalla Home page di KnoS scegliere Utenti Preferenze 2) Nella pagina che viene visualizzata selezionare il Tab Plug-in 3) Premere Installa per eseguire l installazione del Plug-in di rilevazione dei componenti installati. Rispondere Run alle due schermate di avviso e Next a quella di Confirm Installation Pagina 34

4) Viene eseguita l installazione. Premere Close alla schermata seguente: Pagina 35

5) Premendo Plug-In viene visualizzata la pagina seguente: Nel caso in cui questa schermata non sia visibile, controllare le impostazioni di Internet Esxplorer. 6) Eseguire l istallazione dei Plug-in necessari. Nel dettaglio: 1. Edit place dei documenti, consente la modifica dei file legati alla pubblicazione con l editor impostato sull estensione del file aperto. Consente inoltre la notifica del file come allegato della mail. 2. Upload documenti da scanner: plugin che permette, attraverso interfaccia TWAIN, l acquisizione di immagini da scanner da allegare ad una pubblicazione, e conversione della scansione in PDF. 3. KnoS Framework: componente per l integrazione tra Metodo e KnoS 4. KnoS Client: client id integrazione con KnoS 5. Acquisizione documenti con OCR dei codici a barre 7) Nel menu servizi e moduli aggiuntivi configurare e far partire i servizi desiderati Pagina 36

7. Aggiornamento di Versioni precedenti 6.x 1) Fermare e disinstallare sulla parte server il servizio icmailservice : C:\KnoS\bin>icmailservice.exe uninstall 2) Fermare il sito web Knos esistente 3) Sul server SQL Fare un Backup del Data Base Knos della versione precedente. Se si vuole mantenere lo stesso nome, nella nuova installazione scollegare il database e spostarlo dalla cartella Dati in un altra 4) Effettuare un installazione standard knos7. In fase di installazione: -Cartella di destinazione assegnare un percorso differente a quella della precedente installazione. -Il nome DataBase, può coincidere con quello della precedente versione (vedi punto 3) -Assegnare un differente nome al sito web rispetto quello della versione precedente. -L indirizzo IP, la porta e l host name server possono rimanere uguali ai precedenti. 5) Ripristinare il backup del database versione precedente su quello creato dalla nuova installazione. Passare lo script di aggiornamento presente in SQL.ZIP, questo file è nella patch di aggiornamento UPDATE 7 6) Spostare il dati dalla parte server della versione precedente a quella nuova. la cartella da spostare\copiare è C:\KnoSx\Sites\KnoS7\files 7) Disinstallare sulla parte client i plug-in Edit in Place dei documenti Knos client 2 Eseguire i seguenti file.bat che si trovano nella cartella..\programmi\italcom\knos.framework : nooutlook.bat noexcel.bat noword.bat noexplorer.bat Pagina 37

8. Risoluzione Problemi Noti 8.1 KnosServiceManager Su installazioni Windows Server 2008, se il servizio KnosServiceManager genera un errore quando viene configurato all interno di un client knos verificare la gestione mapping in IIS, ci deve essere l autorizzazione all esecuzione: Pagina 38

8.2 Conflitto con Exchange o altre applicazioni In alcuni casi se presente in IIS il server exchange (o altre applicazioni server) potrebbe verificarsi il problema del mancato caricamento delle pagine di knos (una pagina bianca come se caricasse all infinito). Occorre verificare gli eventi di sistema se viene riportato un errore relativo alla kerbauth.dll che indica l impossibilità di caricarla in un ambiente a 32 bit. L applicazione Exchange (o talune applicazioni) installa a livello globale i seguenti due moduli nel file: C:\Windows\System32\inetsrv\config\applicationHost.config <globalmodules> <add name="kerbauth" image="c:\program Files\Microsoft\Exchange Server\V14\Bin\kerbauth.dll" /> <add name="exppw" image="c:\program Files\Microsoft\Exchange Server\V14\ClientAccess\Owa\auth\exppw.dll" /> </globalmodules> Anche se questi due moduli servono solo ad Exchange vengono caricati globalmente e vanno in conflitto con eventuali application pool a 32 bit. Per non farli caricare dagli application pool a 32 bit occorre aggiungere l attributo: precondition="bitness64" Per cui (facendo molta attenzione) le due righe sopra devo diventare: <add name="kerbauth" image="c:\program Files\Microsoft\Exchange Server\V14\Bin\kerbauth.dll" precondition="bitness64" /> <add name="exppw" image="c:\program Files\Microsoft\ExchangeServer\V14\ClientAccess\Owa\auth\exppw.dll" precondition="bitness64" /> Il percorso delle dll potrebbe essere diverso su alter machine ma quello che conta è l aggiunta dell attributo evidenziato. Può essere necessario riavviare IIS dopo la modifica. 8.3 Apertura file con estensione.p7m KnoS può prevedere la gestione di file firmati digitalmente che hanno estensione.p7m. Il file firmato può avere diverse estensioni, il file con estensione p7m contiene il file originale più i dati del certificato digitale che è stato apposto sul file originale. Quanto un allegato ha tale estensione vengono mostrate due icone : Pagina 39

Quella tradizionale col documento permette il download del file contenuto all interno del file con estensione p7m, l icona aggiuntiva (il pennino ) permette di scaricare il file p7m Può succedere che in alcuni casi, tentando di scaricare il file con la firma (quello con estensione p7m) il browser proponga di salvarlo come p7c. Per risolvere questo problema occorre intervenire nel modo seguente sui mime type del sito di KNoS sul server ove è installato: andare sul web server iis (sul web site di riferimento) aggiungere o modificare l'estensione.p7m con il seguente mime type: x-application/pkcs7-mime. riavviare l'application pool di riferimento. Pagina 40