Guida all installazione dei nuovi driver di database per prodotti Crystal 10

Transcript

1 Guida all installazione dei nuovi driver di database per prodotti Crystal 10 Crystal Decisions, Inc. 895 Emerson St. Palo Alto California, USA 94301

2 Copyright 2003 Crystal Decisions, Inc., 895 Emerson St., Palo Alto, California, USA Tutti i diritti riservati. Issue 2. Nessuna parte di questa documentazione può essere memorizzata su sistemi di distribuzione, trasmessa o riprodotta in qualsiasi forma, se non in conformità alle condizioni della licenza d uso del software. Questa documentazione contiene informazioni di proprietà di Crystal Decisions, Inc. e/o dei suoi fornitori. Marchi registrati 2003 Crystal Decisions, Crystal Reports, Crystal Enterprise, Crystal Analysis, Crystal Services, Crystal Care, Crystal Assist, Crystal Applications, Info e Holos sono marchi o marchi registrati di Crystal Decisions, Inc. negli Stati Uniti e/o in altri paesi. Tutti gli altri marchi o marchi registrati a cui viene fatto riferimento appartengono ai rispettivi proprietari.

3 Sommario Chapter 1: Introduzione ai Nuovi driver di database per prodotti Crystal 10 Informazioni sui driver di database presenti nei prodotti Crystal... 2 Destinatari del Manuale... 2 Informazioni sul Manuale... 2 Registrazione dei prodotti... 2 Customer Handbook... 3 Assistenza tecnica per Crystal Care... 3 Formazione Crystal... 4 Consulenza Crystal... 4 Convenzioni del documento... 4 Chapter 2: Installazione dei Nuovi driver di database per prodotti Crystal 10 Nuovi driver di database per prodotti Crystal Panoramica sull installazione... 6 Requisiti di sistema... 7 Installazione in Windows o UNIX... 7 Personalizzazione dell installazione... 9 Aggiornamento dei driver di database... 9 Installazione invisibile all utente... 9 Esecuzione dell installazione invisibile all utente in Windows Esecuzione dell installazione invisibile all utente in UNIX Indice analitico Guida all installazione dei nuovi driver di database per prodotti Crystal 10 iii

4 iv Guida all installazione dei nuovi driver di database per prodotti Crystal 10

5 Introduzione ai Nuovi driver di database per prodotti Crystal 10 1 Benvenuti! In questo capitolo vengono presentati i Nuovi driver di database per prodotti Crystal 10. Guida all installazione dei nuovi driver di database per prodotti Crystal 10 1

6 Informazioni sui driver di database presenti nei prodotti Crystal I driver di database di Crystal Decisions sono fondamentali sia per Crystal Reports che per Crystal Enterprise. Crystal Reports è progettato per l utilizzo del database al fine di analizzare e interpretare informazioni importanti. Crystal Enterprise rappresenta una soluzione scalabile per la distribuzione agli utenti finali dei report creati in Crystal Reports. Crystal Reports e Crystal Enterprise vengono forniti con diversi driver di database. È possibile, tuttavia, installare altri driver, come i driver ODBC di DataDirect o i nuovi driver di Crystal Decisions. Destinatari del Manuale Questo manuale di rivolge agli amministratori di sistema o agli esperti IT che hanno la necessità di installare i Nuovi driver di database per prodotti Crystal 10. È utile avere dimestichezza con l ambiente di rete globale e l ambiente di database in uso. Se si esegue l installazione in UNIX, è necessario disporre di privilegi amministrativi e principali per eseguire alcune delle procedure di installazione. Per ulteriori informazioni su Crystal Reports e Crystal Enterprise, consultare i documenti inclusi nelle directory doc delle distribuzioni di tali prodotti. Informazioni sul Manuale In questo manuale sono riportate informazioni e procedure per l installazione dei Nuovi driver di database per prodotti Crystal 10. Il manuale include anche istruzioni dettagliate relative alle diverse modalità di installazione disponibili. Registrazione dei prodotti Sono disponibili diverse opzioni per la registrazione del prodotto: Compilare il modulo di registrazione del prodotto all interno del sito Web di Crystal Decisions all indirizzo: Stampare il modulo di registrazione del prodotto e inviarlo via fax al numero fax di registrazione più vicino. Crystal Decisions invierà quindi all utente un fax con il numero di registrazione che potrà essere immesso nel prodotto al successivo utilizzo. Numeri di fax per la registrazione USA/Canada +1 (604) Regno Unito +44 (0) Australia Guida all installazione dei nuovi driver di database per prodotti Crystal 10

7 Germania +49 (0) Hong Kong Singapore La registrazione è necessaria per poter accedere all assistenza tecnica in linea o telefonica. Inoltre, garantisce aggiornamenti costanti sul prodotto. Customer Handbook Per dettagli aggiornati sulla registrazione, la manutenzione, il supporto e i servizi relativi ai prodotti, visitare il sito di Crystal Decisions e scaricare il documento Customer Handbook corrispondente alla propria area geografica: Nord America: (informazioni in lingua inglese) Europa: (informazioni in lingua inglese) (informazioni in lingua tedesca) (informazioni in lingua francese) Se per la propria area geografica non è disponibile un documento Crystal Decisions Customer Handbook specifico, fare riferimento alla restante parte del presente capitolo di introduzione o rivolgersi al rappresentante di vendita o del servizio clienti per informazioni dettagliate. Assistenza tecnica per Crystal Care Per accedere al servizio di supporto tecnico di Crystal, è necessario: registrare il software in linea all'indirizzo: Per ulteriori informazioni sui programmi di assistenza tecnica disponibili per Crystal Reports: Visitare il sito Web del supporto tecnico all indirizzo: Contattare l ufficio di zona. Per ulteriori dettagli, recarsi all indirizzo: Guida all installazione dei nuovi driver di database per prodotti Crystal 10 3

8 Formazione Crystal Per gli sviluppatori, gli esperti IT o gli utenti aziendali, è disponibile un ampia gamma di corsi di formazione su Crystal Reports progettati per creare nuove competenze o ottimizzare quelle esistenti. I corsi possono essere seguiti in linea, presso centri di formazione certificati o presso la propria sede: Per un elenco completo dei corsi e delle offerte speciali attualmente disponibili, visitare il sito Web all indirizzo: Oppure contattare l ufficio di zona. Per ulteriori dettagli, recarsi all indirizzo: Consulenza Crystal Il team internazionale Crystal di consulenti certificati e partner di consulenza è in grado di supportare l utente nello sviluppo e nell attuazione di una soluzione aziendale, attraverso le varie fasi di elaborazione della strategia, progettazione, integrazione e distribuzione, in modo da conseguire i risultati nel più breve tempo possibile, ottimizzare le prestazioni e accrescere la produttività. Per maggiori informazioni, visitare il sito Web all indirizzo: Oppure contattare l ufficio di zona. Per ulteriori dettagli, recarsi all indirizzo: Convenzioni del documento In questo Manuale sono state utilizzate le convenzioni riportate di seguito: Comandi e pulsanti Per facilitare il riconoscimento all interno delle procedure, le funzioni dell interfaccia utente sono visualizzate in grassetto. Ad esempio: Nel menu File, fare clic su Nuovo. Scelte rapide da tastiera Cancella indica il tasto Canc della tastiera o il tasto Canc del tastierino numerico. Invio indica il tasto Invio, Ritorno a capo o CR, a seconda di quale tasto è presenta sulla tastiera. Combinazioni di tasti CTRL+TASTO, MAIUSC+TASTO e ALT+TASTO sono esempi di combinazioni di tasti. Tenere premuto il primo tasto della combinazione e, al contempo, premere il secondo (designato sopra come TASTO). Ad esempio: CTRL+C significa tenere premuto il tasto Ctrl e premere la lettera C sulla tastiera (CTRL+C corrisponde al comando Copia di Windows). Il tipo di carattere monospazio indica percorsi e nomi di file, righe di codice e dati immessi utilizzando la tastiera, ad esempio: Nell Editor delle formule digitare If Sales > 1000 Then crred). 4 Guida all installazione dei nuovi driver di database per prodotti Crystal 10

9 Installazione dei Nuovi driver di database per prodotti Crystal 10 2 Questo capitolo illustra come installare i Nuovi driver di database per prodotti Crystal 10 in Windows o UNIX. Vengono indicati i requisiti generali di sistema nonché le procedure relative a diversi scenari di installazione. Guida all installazione dei nuovi driver di database per prodotti Crystal 10 5

10 Nuovi driver di database per prodotti Crystal 10 Questo programma di installazione aggiunge i nuovi driver di database riportati di seguito a una distribuzione esistente di Crystal Reports 10 (qualsiasi edizione ad esclusione di quella Standard) o Crystal Enterprise 10: Driver JDBC Driver DB2 Unicode nativo Driver XML nativo Ognuno dei driver riportati viene descritto più dettagliatamente nel documento new_drivers.pdf incluso nella distribuzione del prodotto. Una volta installati, è possibile accedere ai nuovi driver mediante l Esperto database di Crystal Reports o l SDK presente in Crystal Enterprise. In genere, non è necessario configurare i nuovi driver per accedervi; se è richiesta la configurazione, la procedura da seguire è descritta nel documento new_drivers.pdf. Nota: prima di poter utilizzare uno dei nuovi driver per accedere a un origine dati, è necessario installare e configurare il client di database corretto. Per ulteriori informazioni, fare riferimento al documento new_drivers.pdf incluso nella distribuzione del prodotto. Panoramica sull installazione Prima di installare i Nuovi driver di database per prodotti Crystal 10, valutare i seguenti scenari: Installazione in Windows o UNIX a pagina 7 In questo scenario i Nuovi driver di database per prodotti Crystal 10 vengono installati in un solo computer su cui è già in esecuzione un prodotto Crystal 10. Ciò garantisce i tempi di installazione più brevi. Personalizzazione dell installazione a pagina 9 L installazione personalizzata consente di scegliere esattamente quali driver di database installare. È consigliabile eseguire questo tipo di installazione solo se si è certi di quali siano i driver di database specifici necessari per i prodotti Crystal. Nota: non è possibile selezionare specifici driver di database durante l installazione in UNIX. Aggiornamento dei driver di database a pagina 9 L installazione dei nuovi driver di database è possibile solo se sul computer non sono stati installati i driver in questione o se sono stati installati e poi rimossi. In caso contrario, un messaggio avviserà l utente che i driver esistenti verranno aggiornati. Installazione invisibile all utente a pagina 9 Per gli amministratori esperti, l installazione invisibile all utente consente di installare i driver dalla riga di comando. È consigliabile eseguire questo tipo di 6 Guida all installazione dei nuovi driver di database per prodotti Crystal 10

11 Requisiti di sistema installazione se è necessario installare i driver in modo rapido su più computer. È anche possibile incorporare il comando di installazione invisibile all utente nei propri script di creazione. Per un elenco dettagliato degli ambienti collaudati, consultare il file platforms.txt incluso nella distribuzione del prodotto. Questo file contiene i requisiti di versione e Service Pack specifici per server Web, browser Web, server di applicazioni Web, database e sistemi operativi. Per ulteriori informazioni importanti che potrebbero riguardare una specifica distribuzione, è consigliabile consultare le Note sulla versione, incluse nella distribuzione del prodotto (release.htm). Privilegi amministrativi Quando si installano i Nuovi driver di database per prodotti Crystal 10 è necessario accedere al computer locale come Amministratore. Installazione in Windows o UNIX Questo scenario di installazione rappresenta il modo più rapido di installare i Nuovi driver di database per prodotti Crystal 10. Una volta stabilito che sul computer in cui si desidera eseguire l installazione è presente una versione di Crystal Reports 10 o Crystal Enterprise 10, è possibile completare la procedura. In Windows il processo di installazione crea voci di registro e, sia in Windows che in UNIX, può aggiornare alcuni file di sistema che richiedono diritti Amministratore. Quando si installano i Nuovi driver di database per prodotti Crystal 10 chiudere tutti i programmi in esecuzione e interrompere il maggior numero possibile di servizi. Nota: occorre installare i driver di database necessari su ciascun computer in cui vengano eseguiti i report. Quindi, eseguire il programma di installazione su ogni computer in cui sia presente un Crystal Enterprise Job Server, Page Server o Report Application Server (RAS). Se si dispone di computer server dedicati all esecuzione di tipi specifici di report, ad esempio i report DB2, è possibile installare solo i tipi di driver necessari. Per eseguire l installazione su un computer Windows locale 1 Eseguire setup.exe dalla directory win32 della distribuzione del prodotto. 2 Nella finestra di dialogo Scegli lingua di installazione selezionare la lingua del sistema operativo e fare clic su OK. 3 Seguire le istruzioni visualizzate per passare alle successive schermate. Guida all installazione dei nuovi driver di database per prodotti Crystal 10 7

12 Nota: l installazione dei Nuovi driver di database per prodotti Crystal 10 richiede un codice di attivazione di prodotto valido per un edizione di Crystal Reports 10 (qualsiasi edizione ad esclusione di quella Standard) o Crystal Enterprise 10 configurata sul computer locale. Se non viene rilevato alcun codice di attivazione valido, l installazione viene interrotta dopo la visualizzazione di un messaggio in cui si avvisa l utente di installare un prodotto Crystal concesso in licenza. 4 Nella schermata Tipo di installazione scegliere il tipo di installazione che si desidera eseguire: Personalizzata consente di scegliere i driver di database da installare. Consente, inoltre, di controllare lo spazio su disco richiesto per ciascuna funzione. Completa installa tutti i driver di database disponibili. 5 Fare clic su Avanti. Se si sceglie l installazione personalizzata, viene visualizzata la schermata Selezione componenti. Per informazioni sull uso di questa schermata, vedere Personalizzazione dell installazione a pagina 9. Se si sceglie l installazione completa, viene visualizzata la schermata Inizia a copiare i file. 6 Fare clic su Avanti per iniziare a copiare i file nell unità locale. Prima della copia dei file vengono interrotti alcuni servizi. Al termine della copia viene richiesto di riavviare i servizi. 7 Fare clic su Fine per chiudere il programma. Per eseguire l installazione su un computer UNIX 1 Interrompere il server Web e qualsiasi server di applicazioni Web Java connesso a Crystal Enterprise. 2 Interrompere tutti i server Crystal Enterprise. 3 Verificare che l account in uso nel sistema UNIX abbia l autorizzazione a scrivere nelle directory necessarie. 4 Copiare tutti i file inclusi nella distribuzione del prodotto nella directory di lavoro. Nella tabella che segue sono indicate le sottodirectory per ciascun sistema UNIX: Sistema UNIX Sottodirectory File Solaris \solaris_sparc installnewdriversv10.sh readme silent.sh AIX \aix_rs6000 installnewdriversv10.sh readme silent.sh 8 Guida all installazione dei nuovi driver di database per prodotti Crystal 10

13 Nota: se si trasferiscono i file mediante FTP nel computer UNIX, assicurarsi di specificare la modalità binaria per il trasferimento. 5 Aprire la directory di lavoro: cd $WORKING 6 Eseguire lo script di installazione:./installnewdriversv10.sh 7 Seguire le istruzioni riportate nelle schermate di informazioni visualizzate. Dopo che è stato specificato il percorso della directory crystal, lo script installa i driver di database. Personalizzazione dell installazione Quando si esegue l installazione in Windows, se si seleziona l opzione di installazione Personalizzata viene visualizzata la schermata Seleziona componenti, che consente di installare driver di database specifici e di controllare lo spazio su disco richiesto da ciascun driver. Non è possibile deselezionare la casella di controllo dell elemento denominato Base. Questo elemento include una serie di DLL e dei file di supporto che devono essere installati con qualsiasi driver si selezioni. Allo stesso modo, sebbene sia possibile espandere qualsiasi elemento per visualizzare le DLL e i file di supporto necessari per un particolare driver, non è possibile deselezionare le caselle di controllo dei singoli file di un nodo del driver. Nota: non è possibile selezionare specifici driver di database durante l installazione in UNIX. Aggiornamento dei driver di database Il programma di installazione dei Nuovi driver di database per prodotti Crystal 10 aggiunge nuovi driver di database solo se sul computer non sono installate altre versioni dei driver in questione o se sono state installate ma poi rimosse. In caso contrario l utente viene avvisato che i driver esistenti verranno aggiornati. Installazione invisibile all utente L installazione invisibile all utente viene eseguita dalla riga di comando, per installare automaticamente il software (nel caso specifico, i driver di database) su qualsiasi computer del sistema, senza che, durante il processo, vengano richieste informazioni. L installazione invisibile all utente dei driver di database è particolarmente utile nei casi in cui è necessario eseguire più installazioni e non si desidera interrompere Guida all installazione dei nuovi driver di database per prodotti Crystal 10 9

14 le persone che stanno lavorando sui computer del sistema. È possibile utilizzare il comando di installazione invisibile all utente anche nei propri script. Ad esempio, se l organizzazione utilizza script per installare il software sui computer, è possibile aggiungere il comando di installazione invisibile all utente dei driver di database agli script. Nota: Occorre installare i driver di database necessari su ciascun computer in cui vengano eseguiti i report. Quindi, eseguire l installazione invisibile all utente su ogni computer in cui sia presente un Crystal Enterprise Job Server, Page Server o Report Application Server (RAS). Se si dispone di computer server dedicati all esecuzione di tipi specifici di report, ad esempio i report DB2, è possibile installare solo i tipi di driver necessari. L installazione invisibile all utente non è disponibile dal programma di installazione dei driver di database ed è pensata solo per gli amministratori esperti di Crystal Reports o Crystal Enterprise. Non si consiglia di eseguire installazioni invisibili all utente per gli aggiornamenti. Esecuzione dell installazione invisibile all utente in Windows In Windows, l esecuzione dell installazione invisibile all utente è costituita dal comando setup, seguito da una delle diverse opzioni elencate nella seguente tabella. Per utilizzare un opzione, inserirla nella riga di comando dopo il comando di installazione. Ad esempio, digitare setup /s se si desidera eseguire setup.exe in modalità invisibile all utente. Nota: l installazione invisibile all utente si basa su un file di installazione (setup.iss). È possibile creare il proprio file.iss utilizzando l opzione /r descritta nella tabella che segue, oppure si può utilizzare il file setup.iss di esempio fornito con la distribuzione del prodotto. Se si utilizza il file.iss di esempio, personalizzarlo per scegliere i driver da installare. Per personalizzare il file, aprirlo in Blocco note, o un editor simile, e rimuovere le righe che fanno riferimento ai driver non desiderati. Ad esempio, per rimuovere il driver DB2 Unicode dall installazione invisibile all utente, modificare setup.iss e rimuovere le seguenti righe: Native_Unicode_DB2_Driver-type=string Native_Unicode_DB2_Driver-count=1 Native_Unicode_DB2_Driver-0=Native_Unicode_DB2_Driver\crdb_db2.dll Non rimuovere le seguenti righe dal file setup.iss o i driver di database non funzioneranno come previsto: Qualsiasi riga associata all elemento denominato Core. Qualsiasi riga interna a un elemento (ovvero qualsiasi componente di un driver). 10 Guida all installazione dei nuovi driver di database per prodotti Crystal 10

15 Opzioni per Windows /r (o -r): modalità di registrazione /s (o -s): modalità invisibile all utente /f1 (o -f1): specificare il nome del file di risposta alternativo Descrizione Quando si esegue il programma di installazione in modalità invisibile all utente, è prima necessario eseguire setup.exe con l opzione /r per creare un file di risposta. Un file di risposta memorizza le informazioni sui dati immessi e le opzioni selezionate in fase di esecuzione. Se si utilizza questa opzione (con il comando setup.exe /r), viene visualizzata l interfaccia utente del programma di installazione da cui è possibile selezionare le opzioni che si desidera utilizzare per l esecuzione di ulteriori installazioni invisibili all utente. I dati generati vengono memorizzati in un file denominato setup.iss, che viene creato nella cartella Windows del sistema. Per specificare il nome e il percorso di un file di risposta alternativo, utilizzare l opzione /f1 descritta in basso. Senza un file di risposta l installazione invisibile all utente avrà esito negativo. Il comando setup.exe /s esegue un installazione in modalità invisibile all utente in base alle risposte contenute nel file di risposta, ovvero setup.iss. Il file di risposta deve trovarsi nella stessa cartella da cui si esegue l installazione invisibile all utente oppure occorre utilizzare l opzione /f1 (descritta in basso) per specificare il nome e il percorso di un file di risposta alternativo. Se si utilizza il comando setup.exe /s, durante l esecuzione dell installazione vengono eliminate tutte le interfacce utente e viene creato un file denominato setup.log, che contiene i messaggi di riuscita e/o errore. Per ulteriori informazioni sul file registro e i relativi messaggi, vedere l opzione /f2, descritta in basso. L opzione /f1 consente di specificare dove si trova (o dove deve essere creato) il file di risposta e qual è il nome; ad esempio, setup.exe /s / f1"c:\temp\setup.iss". L opzione /f1 è disponibile quando si crea (opzione /r) e quando si utilizza un file di risposta (opzione /s). Guida all installazione dei nuovi driver di database per prodotti Crystal 10 11

16 Opzioni per Windows /f2: specificare il nome del file registro alternativo Descrizione Quando si esegue il programma di installazione in modalità invisibile all utente (mediante l opzione /s), il file registro setup.log viene creato nella stessa directory del file di risposta. L opzione /f2 consente di specificare il percorso e il nome di un file registro alternativo; ad esempio, setup.exe /s /f2"c:\setup.log". Il file setup.log contiene due sezioni. La prima sezione, [InstallShield Silent], mostra la versione di InstallShield Silent utilizzata nell installazione invisibile all utente; identifica inoltre il file come file registro. La seconda sezione, [ResponseResult], contiene il codice dei risultati che indica se l installazione invisibile all utente ha avuto o meno esito positivo: 0 Riuscita. 1 Errore generale. 2 Modalità non valida. 3 Dati richiesti non trovanti nel file setup.iss. 4 Memoria insufficiente. 5 Il file non esiste. 6 Impossibile scrivere nel file di risposta. 7 Impossibile scrivere nel file registro. 8 Percorso del file di risposta InstallShield Silent non valido. 9 Tipo di elenco non valido (stringa o numero). 10 Tipo di dati non valido. 11 Errore sconosciuto durante l installazione. 12 Finestre di dialogo non funzionanti. 51 Impossibile creare la cartella specificata. 52 Impossibile accedere ai file o alla cartella specificata. 53 Opzione selezionata non valida. Esecuzione dell installazione invisibile all utente in UNIX Nota: quando la si esegue in UNIX, non è possibile configurare l installazione personalizzata per selezionare nuovi driver di database specifici. Per eseguire un installazione invisibile all utente in UNIX 1 Accedere al sistema UNIX con un account amministratore. 2 Copiare tutti i file inclusi nella distribuzione del prodotto nella directory di lavoro. Nota: se si trasferiscono i file mediante FTP nel computer UNIX, assicurarsi di specificare la modalità binaria per il trasferimento. 3 Aprire la directory di lavoro: cd $WORKING 4 Modificare lo script silent.sh (utilizzando vi o un altro editor UNIX) per aggiungere il percorso della directory crystal. 12 Guida all installazione dei nuovi driver di database per prodotti Crystal 10

17 Ad esempio, è possibile modificare il percorso predefinito in silent.sh come segue: CHOICE="/home/dirname/crystal" 5 Eseguire lo script di installazione invisibile all utente:./silent.sh Viene creato un file registro denominato patchinstall.log che include un messaggio di riuscita o errore. Guida all installazione dei nuovi driver di database per prodotti Crystal 10 13

18 14 Guida all installazione dei nuovi driver di database per prodotti Crystal 10

19 Indice analitico A aggiornamento dei driver... 9 assistenza sito Web... 3, 4 tecnica... 3, 4 assistenza tecnica... 3, 4 C combinazioni di tasti... 4 componenti, singola selezione... 9 convenzioni comandi... 4 D destinatari, specifici... 2 G guida assistenza... 3 consulenza... 4 formazione... 4 I installazione aggiornamento dei driver... 9 da una distribuzione del prodotto... 7 in UNIX... 8 in Windows... 7 installazione in UNIX... 8 installazione in Windows... 7 installazione invisibile all utente... 9 installazione personalizzata... 9 N numeri di fax, registrazione... 2 P panoramica sull installazione... 6 pulsanti, convenzioni... 4 R registrazione numeri di fax... 2 sito Web... 2 registrazione dei prodotti, metodi... 2 requisiti... 7 requisiti minimi... 7 S scelte rapide da tastiera... 4 scelte rapide, tastiera... 4 siti Web assistenza... 3 consulenza... 4 formazione... 4 registrazione... 2 Guida all installazione dei nuovi driver di database per prodotti Crystal 10 15