Installare Filenet Image Services 4.0

Articolo: Installazione di FileNet Image Services 4.0

Introduzione

In questo articolo vedremo come installare Filenet Image services
4.0 (IS 4.0) con un database sql server installato su un server
diverso da quello in cui viene installato il servizio di Filenet.

Requisiti

Il software va installato su un server dotato di sistema
operativo Windows 2000 server o windows 2003 server. Va ricordato
che sul sistema operativo operativo Windows 2003, dev’essere
instalalto il service pack 1 , mentre per la versione 2000 il
service pack 4. Il server deve avere un indirizzio Ip-statico ed il
client di sql server 2000 con la service pack 4.0. L’installazione
deve esere effettuata con una utenza amministrativa. Se effettuata
da remoto, la sessione deve essere eseguito con l’opzione /console.

Architettura di riferimento

Di seguito si riporta in forma grafica,L'achitettura di
installazione del servizio FileNet .

Il servizio Image Services 4.0 si trova su un server differente
dalla macchina in cui è installato Sql server 2000 . Di seguito
riportiamo una rappresentazione grafica dell'architettura di
installazione, nella parte destra, si trova il server per il
servizio Filenet mentre in quello di sinistra, il server database.

Figura 1

Creazione del database Sql server

Dopo aver verificato i requisiti d’ installazione, ed aver
configurato il Server, procedere alla creazione di un database su
sql server. Il nome del database è a piacere . Nel nostro esempio si
chiamerà IndexDb.

Opzionale:

Aggiungere il file dati: Fnsys_Fg (nome a piacere) ; nel percorso :
…\mssql\data\Fnsys_Fg_data.Ndf nel file group FNSYS_FG.

Verifica utenze

Quando si installa il servizio Image service, il programma tenta
di creare sul server Filenet utenze e gruppi, in particolare le
utenze fnsw e ORACLE. Tali utenze hanno come password il rispettivo
nome utenza. Se le policy dell’azienda non permette la password di
questo tipo (per esempio la password dev’essere composta da
maiuscole e caratteri alfanumerici) verrà visualizzato un messaggio
di errore durante il setup (user oracle…) e la procedura di
installazione verrà interrotta e le utenze e i gruppi mancanti
dovranno essere creati manualmente (con password arbitraria
preferibilmente non soggetta a scadenza).



Di seguito si riportano le utenze e gruppi da creare sul server.

Le utenze da creare sono: fnsw e ORACLE, e devono far parte dei
gruppi sotto elencati e del gruppo Administrators.



Gruppi:



DBA

FNADMIN

FNOP

FNUSER

ORA_DBA



Utenti:

fnsw

ORACLE

A questo punto, dopo aver creato l'utenze, bisogna fare il login
sul server, con l'utenza fnsw.

Installazione IS 4.0

Prima di procedere all’installazione di FileNet Image Services,
autenticarsi sul Server, con l’utenza di filenet (FNSW) .

Eseguire il setup di installazione, se non parte automaticamente
lanciare nuovamente setup.exe.

La prima schermata (figura 2) chiede il percorso degli eseguibili
(FNSW) ed il percorso dei file di configurazione (FNSW_LOC).

Non cambiare le folders preimpostate.

Ignoare il pulsante Addition Datasets.

Figura 2

La prima casella indica il percorso in cui risiederà il servizio
di IS 4.0,mentre la seconda casella, quella con l’etichetta IS
Shared Files, indica la cartella in cui saranno salvati i file di
configurazione.

Durante l’installazione verrà richiesto se effettuare una
installazione combined( si intende combined una installazione in cui
il Permament il Transient, Security e la Cache risiedono sullo
stesso server).

(figura 3) digitare il pulsante yes, se risiede tutto sullo
stesso server.

figura 3

L’ultima finestra (figura 4) ci chiede di impostare il SSN
(system serial Number) e NCH Domain Name.

Nel SSN, va inserito un valore numerico, composto da 10 numeri, di
cui i primi 4 devono sempre iniziare per 1100 gli altri 6 sono il
SID (Site Identification--Cenci). Non deve essere mai duplicato
nella stessa rete.



La casella NCH DOMAIN NAME deve essere composta da due stringhe
separate dai due punti (:)

Es.: MioTesto:FileNet la prima stringa è un valore che siamo noi a
decidere è preferibile che non superi gli otto (8) caratteri e che
non contenga caratteri speciali, mentre la seconda stringa è fissa
con il seguente valore : FileNet .

Per i restanti parametri lasciare i valori impostati

Figura 4

Alla richiesta di Licence, selezionare il file UISSQL.Key (nel
caso SQL senza Visual Work...)sotto la folder SLAC del CD di
installazione.

PreConfigurazione del Server IS

In caso in cui il database server è differente dal server filenet
(scenario 1), e non si disponga delle utenze di dominio FNSW, ORACLE
effettuare le seguenti configurazioni:

creare o modificare la seguente chiave di registro tipo String
Value:
/HKEY_LOCAL_MACHINE/SOFTWARE/FileNet/IMS/CurrentVersion/MSSQL_OS_AUTH


Il valore da impostare a tale chiave dev’esser OFF.

Inoltre va creato in windows, una variabile di ambiente (Proprietà
di risorse di computer->avanzate->variabili d’ambiente) essa va
chiamata:

MSSQL_SA_PW

Deve contenere il valore della password dell’utente SA di Sql
Server.

Di seguito si riporta la dicitura del manuale di installazione di
Image Services 4.0.



The fn_mssql.exe tool uses OS Authentication conditionally, based on

the registry information. The fn_mssql.exe tool looks for the
following

registry entry:

/HKEY_LOCAL_MACHINE/SOFTWARE/FileNet/IMS/

CurrentVersion/MSSQL_OS_AUTH

If the registry value does not exist - or exists and is set to ON -
OS

Authentication is used.

If the registry variable exists and is set to OFF or FALSE, OS

Authentication is turned off and a password is required for isql. If
the

password is not in the MSSQL_SA_PW environment variable, you are

prompted for the password.

Configurazione.

Terminata la fase di installazione, dobbiamo avviare il programma
per la gestione delle impostazioni di Filenet. Tale editor, si avvia
tramite riga di comando (Cmd) digitare il seguente comando
Fn_edit.

Qualora è la prima volta, verrà visualizzato un wizard.



Enter the base directory vuole la folder di installazione dei
datasets.



Tape Drive :NO



Printer :NO



Configurare la Storage Library: NO

Scheda Services Server Application Services - Cache:

Le prime due colonne non devono eccedere il valore di 90 – 95 %, la
figura 5 mostra una tipica configurazione di sviluppo.

Preferibilmente lasciare le colonne seguenti come di default o
consultare FileNet.

Figura 5

SCHEDA Relational Database - MS-SQL

Impostare il parametro Remote Server Name con il nome del server Sql
Server.

Impostare il parametro Instance Name, con eventuale nome dell’instanza
sql.

Nel dubbio impostare gli altri parametri come mostrato in figura 6

Figura 6

Scheda Relational Database – RDB Objects:

Impostare per il parametro db_Name il nome del database creato in
precedenza (Es.: Indexdb).

Impostare le voci tmp_data, usr_data, fn_data, con il valore del
file group creato in precedenza (es.: fnsys_fg). Figura 7

Figura 7

SCHEDA DATASETS:

Impostare la dimensione dei dataset come opportuno.

Una tipica configurazione di sviluppo.

E’ buona norma dividere i recovery da i datasets.

E’ buona norma separare la Cache.

Limiti per la Cache:

255 x 16 Gb (Cache)

8 x 2 Gb (Permanent)



ATTENZIONE i volumi definiti vengono allocati all’inizializzazione.



Queste configurazioni vanno valutate con FileNet.

figura 8

Chiudere il programma di editor, salvando le impostazioni.

Build della configurazione

Per creare i file di configurazione a partire dal file
C:\fnsw_LOK\sd\IMS.cdb eseguire il seguente comando da dos
(cmd) fn_build –a (all)

Per inizializzare i datasets ed il database eseguire il seguente
comando da dos.



Inizializzazione



Verificare lo stato dei servizi : Solo imsservice deve essere in
stato Started.



Se stesse Stopped eseguire:



net start imsservice (con flag off) -> initfnsw –y stop



Se non parte probabilmente va cambiata la password



fn_util init (il commando comprende la serie di
comandi (fn_util initrdb + fn_util initperm + ....) )

Attenzione è distruttivo e non è recuperabile





Verificare che i percorsi dei dataset listati siano effettivamante
stati creati.

Verificare che il Database sia stato inizializzato.



Se SQL non è stato inizializzato eseguire:



SET MSSQL_SA_PW=<sa password>



E rilanciare:



fn_util initrdb



Verificare che il Database sia stato inizializzato.



Installazione della Service Pack 4

Verificare lo stato dei servizi Filenet: devono essere completamente
stoppati.

initfnsw –y stop

killfnsw –ySD

net stop imsservice



controllare che la folder c:\fnsw\procs sia vuota (contattare
FileNet)



Avviare il setup ed seguire il wizard.

Eventualmente in questa fase è impostabile tramite voce di menu:

Start->Programmi->Filenet->setup il parametro: Autostart IS
Processes

Al termine dell’installazione avviare i servizi con il comando



initfnsw –y start



Per visualizzare il file di Log corrente eseguire il comando da
prompt:



vl –t

Definizioni classi ed indici

Da RUN eseguire il comando xapex.

Effettuare il login, con utenza SysAdmin e password SysAdmin (case
sensitive)

Creare il family, gli indici, le classi documentali e gli utenti
come richiesto dal contesto.

Installazione client IDM Desktop 4.0

Eseguire il setup ed seguire il wizard.

Tramite il configure, creare la libreria per il collegamento ad IS.

Library Name : a piacere

Domain : prima parte del parametro NCH Domain Name

Organization : seconda parte del parametro NCH Domain Name

Figura 9

Per eventuali firewall tra client e IS service verificare che il
client possa risolvere la seguente stringa: Ping --nch-server
tutto in lower case In caso contrario impostare il file HOST o il
DNS in modo da far restituire l’IP del server IS.

Conclusioni:

In questo articolo, si è visto come installare il servizio
Filenet Imaga Services, a differenza del Content Services, richiede
maggiore attenzione e configurazione.

I
siti web di riferimento:

http://www.filenet.com/Italiano/index.asp Italia

http://www.filenetinfo.com/mk/get/feis_ita_reg Per richiedere
gratuitamente il cd "FileNet is Essential"

http://www.filenet.com/ (Inglese)