Untitled

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................................................................................................................................. 9
3.1 INSTALLAZIONE DATA BASE ........................................................................................................................................... 11
3.2 INSTALLAZIONE SITO WEB .............................................................................................................................................. 15
4. CONFIGURAZIONE SOFTWARE POST-INSTALLAZIONE ............................................................................................20
4.1 LATO SERVER: CONFIGURARE UTILIZZO .NET 4.0.X . ........................................................................................................... 20
4.2 LATO SERVER: INSTALLAZIONE SERVIZI KNOSSERVICEMANAGER E ICMAILSERVICE. .................................................................... 21
4.3 LATO CLIENT: CONFIGURARE LA SICUREZZA DI INTERNET EXPLORER........................................................................................ 21
5. ESECUZIONE DI KNOS E ATTIVAZIONE DELLA LICENZA ...........................................................................................23
6. INSTALLAZIONE LATO CLIENT .................................................................................................................................27
7. AGGIORNAMENTO DI VERSIONI PRECEDENTI 6.X ..................................................................................................31
8. RISOLUZIONE PROBLEMI NOTI ...............................................................................................................................32
8.1 KNOSSERVICEMANAGER .............................................................................................................................................. 32
8.2 CONFLITTO CON EXCHANGE O ALTRE APPLICAZIONI ............................................................................................................ 33
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
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
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 all’abililtazione di tutte le funzionalità qui descritte per poter
procedere all’installazione di KnoS. SI SCONSIGLIA DI PROCEDERE ATTIVANDO TUTTE LE FUNZIONALITA’
IN QUANTO QUESTA MODALITA’ PUO’ IN ALCUNI CASI PRECLUDERE IL FUNZIONAMENTO CORRETTO DI
KNOS
Windows 2003 Server
-
Verificare se installato con IIS il “Server Side Includes”
Installare il servizio indicizzazione
Devono essere aggiunte le seguenti estensione al servizio web
All Unknown ISAPI Extension
Active Server Pages
ASP.NET v4.0.x
Pagina
4
Windows 2008 Server
Occorre 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
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
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 “KnoSXXsetup.exe” a seconda che debba essere integrato con i Gestionali Gamma o
Metodo Evolus 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 casella corrispondente e premere avanti
Pagina
11
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
12
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
13
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
14
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
15
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
16
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. Normalmente si può lasciare il valore di default
80.
-
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
17
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
Pagina
18
name utilizzato es:
# 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
19
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
Pagina
20
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:
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
21
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
22
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
23
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 o eseguendo “Invia richiesta
licenza”, che avvia il client di posta presente sul PC.
Qualsiasi modo venga usato dovrà essere inviata ad Italcom una e-mail come la seguente.
Pagina
24
11) Italcom risponderà con l’invio del codice di attivazione licenza.
12) Ricevuto il codice è necessario attivare la licenza scegliendo il Tab “Attivazione licenza” ed
inserendo nell’apposita casella il codice ricevuto, come si vede nella seguente schermata:
13) Premere “Controlla licenza” e poi “Attiva licenza”. La licenza verrà attivata e comparirà la pagina
seguente:
Pagina
25
A questo punto KnoS è utilizzabile in tutte le sue parti per le quali è stata acquisita la licenza.
Pagina
26
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
27
4) Viene eseguita l’installazione. Premere “Close” alla schermata seguente:
Pagina
28
5) Premendo “Plug-In” viene visualizzata la pagina seguente:
6) Eseguire l’istallazione dei Plug-in necessari.
Nel dettaglio:
Pagina
29
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
30
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
31
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
32
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.
Pagina
33

Download Report