Préparation de l'installation de Crystal Reports Server 2008 V1
Configuration d'un compte de base de données pour
Crystal Reports Server 2008 V1
Le CMS (Central Management Server) utilise une base de données pour stocker les informations système. Si vous choisissez d'installer MySQL lors de l'installation de Crystal Reports Server 2008 V1, une base de données
CMS MySQL est créée automatiquement. Si vous envisagez d'utiliser votre propre base de données, vous devez suivre les étapes ci-après avant d'installer Crystal Reports Server 2008 V1.
Pour créer des tables et écrire des données dans votre nouvelle base de données CMS, le programme d'installation doit établir une connexion au serveur de base de données. Lorsque vous vous connectez au compte utilisé pour installer Crystal Reports Server 2008 V1, l'environnement doit inclure les variables et les pilotes de base de données appropriés pour accéder à la base de données choisie. Dans le cas contraire, le programme d'installation ne pourra pas accéder à la base de données CMS à l'aide du logiciel client de votre base de données.
1.
Créez ou sélectionnez un compte utilisateur qui accorde à
Crystal Reports Server 2008 V1 les privilèges appropriés pour accéder
à votre serveur de base de données.
2.
Vérifiez que ce compte utilisateur vous permet de vous connecter à votre base de données et que vous disposez des droits nécessaires pour ajouter ou supprimer des tables de base de données et pour ajouter, supprimer ou modifier des lignes de table.
Configuration d'une base de données vide pour le CMS
Le programme d'installation vous demandera les détails de connexion et d'authentification si vous choisissez d'utiliser votre propre base de données lors de l'installation de Crystal Reports Server 2008 V1. Les serveurs de base de données suivants sont pris en charge pour les base de données système du CMS et d'audit :
• Oracle
31
32
Préparation de l'installation de Crystal Reports Server 2008 V1
• DB2
• MySQL
• Sybase
Remarque :
Pour en savoir plus sur les configurations logicielles et les versions requises, consultez le document en ligne relatif aux plateformes prises en charge par
Crystal Reports Server 2008 V1 à l'adresse :
https://service.sap.com
Pour intégrer votre base de données existante dans
Crystal Reports Server 2008 V1, vous devez la configurer. Les points suivants récapitulent les étapes de configuration de votre base de données :
• Créez un espace de table, un schéma ou une base de données (la terminologie exacte dépend de la plateforme de base de données que vous utilisez) qui servira de base de données CMS. Créez-en un deuxième pour la base de données d'audit si vous prévoyez d'activer la fonction d'audit.
• Créez un nouveau compte utilisateur et un nouveau mot de passe à utiliser par Crystal Reports Server 2008 V1 pour accéder à la base de données CMS. Créez un deuxième nom d'utilisateur et un deuxième mot de passe si vous prévoyez d'activer la fonction d 'audit.
• Indiquez que le nouveau compte utilisateur dispose des autorisations nécessaires pour créer, modifier et supprimer des tables et pour créer des procédures permettant de modifier la base de données, le cas
échéant.
• Notez les noms des bases de données, les comptes utilisateur et les mots de passe créés afin de pouvoir saisir ces informations lorsque vous exécuterez le programme d'installation de Crystal Reports Server 2008 V1.
Pendant l'installation, vous pouvez choisir de réinitialiser la base de données existante. Dans ce cas, de nouvelles tables seront créées dans votre base de données existante. Consultez la documentation de votre serveur de base de données spécifique si vous ne connaissez pas la procédure de création d'un espace de table, d'un schéma ou d'une base de données. Vérifiez que votre serveur de base de données est configuré pour utiliser l'encodage
Unicode (comme UTF-8).
Préparation de l'installation de Crystal Reports Server 2008 V1
Remarque :
Si vous disposez d'une version précédente de
Crystal Reports Server 2008 V1, vous ne pouvez pas utiliser la base de données de la version précédente. Vous devez créer une nouvelle base de données, sinon, les données existantes de la version précédente seront détruites. Pour effectuer une migration depuis une version précédente, créez une nouvelle base de données et faites y migrer les données de l'ancienne une fois l'installation terminée.
Configuration requise pour la base de données DB2
Si vous utilisez DB2 pour la Central Management Console (CMC) ou la base de données d'audit :
• Vérifiez que la base de données du CMS n'est pas partitionnée.
Remarque :
La base de données d'audit peut être partitionnée.
• Créez la base de données avec les paramètres suivants :
Collating Sequence = “Identity”
Codeset = “UTF-8”
Territory = “XX”
Si votre base de données DB2 ne possède pas le paramètre Collating
Sequence adéquat, les objets utilisateurs et groupes d'utilisateurs risquent de ne pas être correctement triés dans la CMC.
Remplacez
XX par le code approprié pour votre emplacement. Pour en savoir plus, consultez votre documentation DB2.
• Si vous utilisez DB2 8.1, un compilateur C installé et configuré pour créer des procédures stockées SQL est nécessaire. Cette exigence ne s'applique pas aux versions DB2 8.2 à 9.1.
Crystal Reports Server 2008 V1 utilise les procédures stockées lorsque des utilisateurs sont ajoutés à des groupes. Pour obtenir des informations sur la configuration du compilateur C pour les procédures stockées SQL, consultez votre documentation DB2.
Une fois la base de données créée, vous devez la configurer pour l'installation de Crystal Reports Server 2008 V1.
33
Préparation de l'installation de Crystal Reports Server 2008 V1
Rubriques associées
•
Préparation d'un serveur de base de données existant
page 45
Test des variables d'environnement DB2
Si vous choisissez une connexion native à DB2, la variable d'environnement
DB2INSTANCE est recherchée dans le shell actuel au cours de l'installation.
Cette variable d'environnement DB2 standard doit être définie pour que le script install utilise le logiciel client DB2.
Si vous utilisez une base de données existante, vous devez définir la source du client de base de données.
La définition de la source du script permettant d'identifier les variables d'environnement de la base de données peut se faire de deux façons :
• L'utilisateur effectuant une installation système peut modifier le script setupint.sh
de Crystal Reports Server 2008 V1 pour ajouter la commande permettant de définir la source du client de base de données.
Un accès root est toutefois requis pour l'exécution de ce script. Ce script est disponible à l'emplacement suivant :
<répertoire installation>/bobje/init/setupint.sh
. Cette méthode indique la source de la base de données pour tous les utilisateurs.
• Chaque personne ayant effectué une installation utilisateur peut modifier son propre profil et ajouter la commande qui permet d'indiquer la source de son environnement de base de données. Cette opération peut être effectuée n'importe quand.
Par exemple, si une base de données DB2 est requise, une entrée est ajoutée au profil utilisateur pour définir la source du script d'environnement utilisé par DB2 (profil db2). Consultez la documentation de votre base de données pour connaître le nom de son script d'environnement.
Remarque :
Au lieu de définir la source du script permettant d'identifier les variables d'environnement de la base de données, vous pouvez définir manuellement les variables d'environnement requises par la base de données. Toutefois, dans ce cas, vous devrez à nouveau définir les variables d'environnement en cas de redémarrage du système.
Consultez la documentation de votre base de données et/ou votre administrateur de base de données si l'environnement shell du compte sous lequel vous allez installer Crystal Reports Server 2008 V1 n'a pas encore
34
Préparation de l'installation de Crystal Reports Server 2008 V1
été configuré pour votre logiciel client de base de données, ou si vous ne parvenez pas à vous connecter à la base de données.
Rubriques associées
•
Définition de la source du script permettant d'identifier les variables d'environnement de la base de données
page 29
Vérification d'une connectivité native à DB2 en utilisant un alias de base de données
Exécutez les étapes suivantes pour tester si les variables d'environnement requises sont définies :
1.
Connectez-vous au serveur Linux avec le compte utilisateur et le mot de passe utilisés pour l'installation de Crystal Reports Server 2008 V1.
Remarque :
Assurez-vous que ce compte est configuré avant de vous connecter.
Pour en savoir plus sur la configuration d'un compte Linux qui sera utilisé pour installer Crystal Reports Server 2008 V1, voir
Création d'un compte, d'un répertoire de base et d'un environnement de connexion
page 20.
2.
Effectuez un test d'écho avec les variables d'environnement suivantes et veillez à ce que leurs valeurs correspondent à l'installation de votre logiciel client de base de données.
Variable Valeur
DB2INSTANCE
Cette variable définit l'instance de la base de données DB2 en cours.
INSTHOME
Cette variable contient le chemin d'accès au répertoire racine de votre installation client DB2.
35
36
Préparation de l'installation de Crystal Reports Server 2008 V1
Variable
DB2DIR
Valeur
Cette variable contient le chemin d'accès au répertoire racine de votre installation DB2 (un niveau au-dessus des répertoires DB2 bin et lib
) chemin de la bibliothèque
Le chemin de recherche de bibliothèque (
LD_LIBRARY_PATH sous
Linux) doit comprendre le répertoire lib de votre installation client
DB2
PATH
Le chemin de recherche doit comprendre le répertoire bin de votre installation client DB2
Cet exemple vérifie les variables requises et illustre des valeurs de sortie.
$ echo $DB2INSTANCE db2inst1
$ echo $DB2DIR
/opt/IBMdb2/V7.1
$ echo $LD_LIBRARY_PATH
/export/home/db2inst1/sqllib/lib
$ echo $PATH
/usr/bin:/usr/ucb:/etc:.:/export/home/db2inst1/sqllib/adm:/ex port/home/db2inst1/sqllib/misc
3.
Exécutez la commande suivante pour exécuter l'outil DB2 SQL : db2
4.
Exécutez la commande suivante pour vous connecter à l'alias de base de données souhaité : connect to db_alias user accountname using password
Préparation de l'installation de Crystal Reports Server 2008 V1
Remplacez les variables alias_db et mot_de_passe par les valeurs appropriées. Si l'environnement shell a été configuré correctement, vous
êtes connecté à DB2.
5.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de créer des tables : create table sampletable (col_fld char(10) not null)
6.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de supprimer des tables : drop table sampletable
7.
Tapez terminate
.
Configuration requise pour la base de données Oracle
Si vous utilisez Oracle pour la base de données du CMS ou d'audit :
• Utilisez un jeu de caractères Unicode, tel que UTF-8.
Une fois la base de données créée, vous devez la configurer pour l'installation de Crystal Reports Server 2008 V1.
Rubriques associées
•
Préparation d'un serveur de base de données existant
page 45
Test des variables d'environnement Oracle
Si vous choisissez une connexion native à Oracle, la variable d'environnement
ORACLE_HOME est recherchée dans le shell actuel au cours de l'installation.
Cette variable d'environnement Oracle standard doit être définie pour que le script install utilise le logiciel client Oracle.
Si vous utilisez une base de données existante, vous devez définir la source du client de base de données.
Vous pouvez définir la source du client de base de données de deux manières :
• L'utilisateur effectuant une installation système peut modifier le script setupint.sh
de Crystal Reports Server 2008 V1 pour ajouter la
37
Préparation de l'installation de Crystal Reports Server 2008 V1 commande permettant de définir la source du client de base de données.
Un accès root est toutefois requis pour l'exécution de ce script. Ce script est disponible à l'emplacement suivant :
<répertoire installation>/bobje/init/setupint.sh
. Cette méthode indiquera la source de la base de données pour tous les utilisateurs.
• Chaque personne ayant effectué une installation utilisateur peut modifier son propre profil et ajouter la commande qui permet d'indiquer la source de son environnement de base de données. Cette opération peut être effectuée n'importe quand.
Par exemple, si une base de données Oracle est requise, une entrée est ajoutée au profil utilisateur pour définir la source du script d'environnement utilisé par Oracle ( oraXXenv.csh
ou oraXXenv.sh
où XX est remplacé par le numéro de version). Consultez la documentation de votre base de données pour connaître le nom de son script d'environnement.
Remarque :
• Au lieu de définir la source du script permettant d'identifier les variables d'environnement de la base de données, vous pouvez définir manuellement les variables d'environnement requises par la base de données. Toutefois, dans ce cas, vous devrez à nouveau définir les variables d'environnement en cas de redémarrage du système.
• Consultez la documentation de votre base de données ou votre administrateur de base de données si l'environnement shell du compte sous lequel vous allez installer Crystal Reports Server 2008 V1 n'a pas encore été configuré pour votre logiciel client de base de données, ou si vous ne parvenez pas à vous connecter à la base de données.
Rubriques associées
•
Définition de la source du script permettant d'identifier les variables d'environnement de la base de données
page 29
Vérification d'une connectivité native à Oracle en utilisant un TNS
Exécutez les étapes suivantes pour vérifier une connectivité native à Oracle via TNS :
1.
Connectez-vous au serveur Linux avec le compte utilisateur et le mot de passe qui seront utilisés pour l'installation.
38
Préparation de l'installation de Crystal Reports Server 2008 V1
Remarque :
Ce compte doit être configuré avant de lancer l'installation. Pour en savoir plus sur la configuration d'un compte Linux qui sera utilisé pour installer
Crystal Reports Server 2008 V1, voir
Création d'un compte, d'un répertoire de base et d'un environnement de connexion
page 20.
2.
Effectuez un test d'écho avec les variables d'environnement suivantes et veillez à ce que leurs valeurs correspondent à l'installation de votre logiciel client de base de données.
Variable Valeur
ORACLE_HOME
Cette variable contient le chemin d'accès au répertoire racine de votre installation client Oracle (un niveau au-dessus des répertoires
Oracle bin et lib
).
chemin de la bibliothèque
Le chemin de recherche de bibliothèque (
LD_LIBRARY_PATH sous
Solaris et Linux,
LIBPATH sous AIX et SHLIB_PATH sous HPUX) doit comprendre le répertoire lib32 de votre installation client Oracle.
PATH
Le chemin de recherche doit comprendre le répertoire bin de votre installation client Oracle.
Cet exemple vérifie les variables requises et illustre des valeurs de sortie.
$ echo $ORACLE_HOME
/home/dbclient/oracle/10.1.0.3
$ echo $LD_LIBRARY_PATH
/home/dbclient/oracle/10.1.0.3/lib32
$ echo $PATH
/usr/local/bin:/home/dbclient/oracle/10.1.0.3/bin
39
Préparation de l'installation de Crystal Reports Server 2008 V1
3.
Passez la commande suivante pour exécuter l'outil Oracle SQL et vous connecter au nom de service approprié : sqlplus accountname/password@tnsname
Remplacez accountname, password et tnsname par les valeurs appropriées. Si l'environnement shell a été configuré correctement, vous
êtes connecté à Oracle.
4.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de créer des tables : create table sampletable (field1 char(10));
5.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de supprimer des tables : drop table sampletable;
6.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de créer des procédures :
CREATE PROCEDURE test_proc (foo_in VARCHAR, bar_in VARCHAR)
IS
BEGIN
INSERT INTO test_table (foo, bar) VALUES (foo_in, bar_in);
END;
7.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de supprimer des procédures :
DROP PROCEDURE TEST_PROC;
8.
Tapez exit
.
Configuration requise pour la base de données Sybase
Si vous utilisez Sybase pour la base de données du CMS ou d'audit :
• Créez une base de données avec une taille de page de 8 Ko. La taille de page par défaut de la base de données Sybase est de 2 Ko, ce qui est trop petit pour permettre à la base de données système du CMS de s'exécuter efficacement. La taille de page est définie lors de la création de la base de données et ne peut pas être modifiée par la suite.
40
Préparation de l'installation de Crystal Reports Server 2008 V1
• Utilisez un jeu de caractères Unicode, tel que UTF-8.
Une fois la base de données créée, vous devez la configurer pour l'installation de Crystal Reports Server 2008 V1.
Rubriques associées
•
Préparation d'un serveur de base de données existant
page 45
Test des variables d'environnement Sybase
Si vous choisissez une connexion native à Sybase, les variables d'environnement
SYBASE et
SYBASE_OCS sont recherchées dans le shell actuel au cours de l'installation. Ces variables d'environnement Sybase standard doivent être définies pour que le script install utilise le logiciel client Sybase.
Si vous utilisez une base de données existante, vous devez définir la source du script permettant d'identifier les variables d'environnement de la base de données.
La définition de la source du script permettant d'identifier les variables d'environnement de la base de données peut se faire de deux façons :
• L'utilisateur effectuant une installation système peut modifier le script setupint.sh
de Crystal Reports Server 2008 V1 pour ajouter la commande permettant de définir la source du client de base de données.
Un accès root est toutefois requis pour l'exécution de ce script. Ce script est disponible à l'emplacement suivant :
<répertoire installation>/bobje/init/setupint.sh
. Cette méthode indiquera la source de la base de données pour tous les utilisateurs.
• Chaque personne ayant effectué une installation utilisateur peut modifier son propre profil et ajouter la commande qui permet d'indiquer la source de son environnement de base de données. Cette opération peut être effectuée n'importe quand.
Par exemple, si une base de données Sybase est requise, une entrée est ajoutée au profil utilisateur pour définir la source du script d'environnement utilisé par Sybase (
SYBASE.sh
ou
SYBASE.csh
).
Consultez la documentation de votre base de données pour connaître le nom de son script d'environnement.
41
Préparation de l'installation de Crystal Reports Server 2008 V1
Remarque :
• Au lieu de définir la source du script permettant d'identifier les variables d'environnement de la base de données, vous pouvez définir manuellement les variables d'environnement requises par la base de données. Toutefois, dans ce cas, vous devrez à nouveau définir les variables d'environnement en cas de redémarrage du système.
• Consultez la documentation de votre base de données ou votre administrateur de base de données si l'environnement shell du compte sous lequel vous allez installer Crystal Reports Server 2008 V1 n'a pas encore été configuré pour votre logiciel client de base de données, ou si vous ne parvenez pas à vous connecter à la base de données.
Rubriques associées
•
Définition de la source du script permettant d'identifier les variables d'environnement de la base de données
page 29
Vérification d'une connectivité native à Sybase en utilisant un nom de serveur
Exécutez les étapes suivantes pour vérifier une connectivité native à Sybase via un nom de serveur :
1.
Connectez-vous au serveur Linux avec le compte utilisateur et le mot de passe qui seront utilisés pour l'installation.
Remarque :
Ce compte doit être configuré avant de lancer l'installation. Pour en savoir plus sur la configuration d'un compte Linux qui sera utilisé pour installer
Crystal Reports Server 2008 V1, voir
Création d'un compte, d'un répertoire de base et d'un environnement de connexion
page 20.
2.
Effectuez un test d'écho avec les variables d'environnement suivantes et veillez à ce que leurs valeurs correspondent à l'installation de votre logiciel client de base de données.
42
Préparation de l'installation de Crystal Reports Server 2008 V1
Variable
SYBASE
Valeur
Cette variable contient le chemin d'accès au répertoire racine de votre installation client Sybase (un niveau au-dessus du répertoire de version SYBASE_OCS).
SYBASE_OCS
PATH
Cette variable contient le nom du répertoire de version Sybase (un niveau au-dessus des répertoires
Sybase bin et lib).
chemin de la bibliothèque
Le chemin de recherche de bibliothèque (
LD_LIBRARY_PATH sous
Solaris et Linux,
LIBPATH sous AIX et
SHLIB_PATH sous HPUX) doit comprendre le répertoire lib de votre installation client Sybase.
Le chemin de recherche doit comprendre le répertoire bin de votre installation client Sybase.
Cet exemple de code vérifie les variables requises et illustre des valeurs de sortie :
$ echo $SYBASE
/opt/sybase/12.0
$ echo $SYBASE_OCS
OCS-12_O
$ echo $LD_LIBRARY_PATH
/export/home/sybase/12.0/OCS-12_0/lib
$ echo $PATH
43
Préparation de l'installation de Crystal Reports Server 2008 V1
/usr/bin:/usr/ucb:/etc:.:/export/home/sybase/12.0/OCS-
12_0/bin
3.
Exécutez la commande suivante pour lancer l'outil SQL Sybase et vous connecter au serveur de base de données : isql -U user -P password -S servername
Remplacez les variables utilisateur, motdepasse et nomserveur par les valeurs appropriées. Si l'environnement shell a été configuré correctement, vous êtes connecté à Sybase.
4.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de créer des tables : use aps go create table sampletable (def_field char(10)) go sp_help sampletable go
5.
Exécutez la commande suivante pour vous assurer que le compte dispose du droit de supprimer des tables : drop table sampletable go sp_help sampletable go
6.
Tapez quit
.
Rubriques associées
•
Création d'un compte, d'un répertoire de base et d'un environnement de connexion
page 20
Configuration requise pour la base de données MySQL
Si vous utilisez votre propre installation MySQL pour la base de données du
CMS ou d'audit :
• Utilisez un jeu de caractères Unicode, tel que UTF-8.
44
