Installation du serveur de rapports WebFOCUS

Le serveur de rapports WebFOCUS est installé via un programme d'installation qui vous invite à saisir les paramètres. L'utilitaire installe les composants qui fournissent l'accès aux données, la traduction, le calcul, et le formatage, entre autres processus centraux.

Le serveur de rapports WebFOCUS devrait être installé avant WebFOCUS client. Si vous effectuez une mise à jour de WebFOCUS et que vous souhaitez migrer les rapports et les paramètres d'une version précédente, consultez le manuel Migration.

Instructions installation préliminaires

Avant de lancer l'utilitaire d'installation, effectuez les tâches suivantes :

Révisez les prérequis d'installation dans Prérequis Installation WebFOCUS et ReportCaster.
Si aucun n'existe, créez un ID utilisateur et un groupe pour le Serveur de Rapports WebFOCUS. Le nom iadmin est utilisé dans la documentation serveur pour faire référence à cet utilisateur et à ce groupe. Pour les prérequis ID utilisateur, consultez Prérequis Installation WebFOCUS et ReportCaster.
Assurez-vous que vous avez quatre ports TCP/IP consécutifs disponibles pour le serveur. Les numéros de port doivent être uniques et supérieurs à 3000. Par défaut, WebFOCUS utilise les ports 8120 à 8123. Vous pouvez utiliser la commande netstat pour voir si un port est en cours d'utilisation. Par exemple :
```
netstat -a | grep 8120
```
Si vous ne recevez pas de réponse, le port 8120 n'est pas utilisé par un processus. Vérifiez les quatre ports. Si vous recevez une réponse semblable à la suivante, le port est utilisé par un autre processus :
```
tcp      0    0 *:8120                *:*                   LISTEN
```
Remarque : si vous installez plusieurs instances du serveur, assurez-vous que chaque instance dispose d'un port unique.
Si un Java JDK est installé sur votre système, renseignez une variable d'environnement $JDK_HOME pointant sur le répertoire d'installation. Vous pouvez définir ceci dans le .profile de l'ID utilisateur chargé de démarrer et d'exécuter le serveur de rapports WebFOCUS. Par exemple :
```
export JDK_HOME=/usr/j2sdk1.8_45
```
Le serveur utilise ces variables pour localiser certains fichiers natifs dans les répertoires Java JRE. Il a besoin de ces fichiers pour exécuter l'écouteur JSCOM3. Le serveur utilise JSCOM3 à la création des graphiques, lorsqu'il accède aux sources de données via JDBC, ou encore au lancement d'autres processus Java. Les processus WebFOCUS n'exigent pas forcément JSCOM3. Il est toutefois conseillé de l'activer. Si Java JDK 6 ou supérieur n'est pas installé sur votre système, il est recommandé dans l'installé un.

Étapes de l'installation du serveur

Comment :

Le serveur peut être installé de deux façons différentes :

Installation Texte. L'installation par défaut basée sur texte vous invite à renseigner les paramètres. Ceci est expliqué ci-dessous.
Installation silencieuse. Dans une installation silencieuse, vous lancez l'installation et vous spécifiez un fichier texte. Le fichier texte contient les paramètres d'installation, aucune invite n'apparaît. Les installations automatisées sont expliquées dans Installation automatisée du serveur de rapports WebFOCUS, mais c'est une bonne idée d'exécuter une installation texte la première fois que vous installez le serveur.

Haut de page

Comment : Installer le serveur de rapports WebFOCUS

Connectez-vous avec l'D que vous souhaitez utiliser pour installer et démarrer le serveur. Ceci ne doit pas être root.
Vérifiez que vous avez les fichiers d'installation :
- Si vous recevez l'installation sur CD, montez le. Pour cela, vous aurez peut-être à être root. Contactez votre administrateur système si vous avez besoin d'assistance.
- Si vous recevez l'installation sur CD et que vous n'avez pas de lecteur, placez le CD dans une machine qui en possède un. Ensuite, transmettez les fichiers en mode binaire, via FTP, vers un répertoire temporaire sur la machine UNIX.
- Si vous recevez l'installation via un téléchargement, placez le dans un répertoire temporaire sur la machine UNIX. Si vous recevez un fichier TAR, ouvrez-le avec :
```
tar xvf filename.tar
```
Attention : n'installez pas dans un répertoire dont le nom contient des espaces.
Assurez-vous que les fichiers d'installation ont la casse correcte et sont exécutables en les listant. Par exemple :
```
ls -l
```
Tous les noms de fichiers devraient être en minuscules. Les fichiers isetup et inu.out doivent être exécutables. Par exemple :
```
-r-xr-xr-x    1 wf77     wf77      1402297 Jan 22 10:47 inu.out
-r-xr-xr-x    1 wf77     wf77    166574080 Jan 22 10:47 iserver.tar
-r-xr-xr-x    1 wf77     wf77       505818 Jan 22 10:47 isetup
-r-xr-xr-x    1 wf77     wf77          268 Jan 22 10:47 version.cfg
```
Remarque : si vous installez pas à partir d'un CD, vous pouvez rendre les fichiers exécutables en entrant :
```
chmod 755 isetup inu.out
```
Assurez-vous que vous utilisez l'ID utilisateur correct, pas le root. Pour ceci, entrez ce qui suit :
```
whoami
```
ou
```
who am i
```
N'installez pas le serveur en tant que root.
Définissez le masque de protection par défaut pour que les fichiers soient créés avec des permissions 755. Par exemple :
```
umask 022
```
Exécutez isetup pendant que vous êtes dans le répertoire pour lequel vous avez des droits d'écriture, mais pas dans le même répertoire que celui des fichiers d'installation. Si vous recevez les fichiers d'installation serveur sur CD, invoquez les depuis votre répertoire d'accueil (home). Par exemple :
```
/cdrom/isetup
```
où :
cdrom
Est le point de montage de votre CD.
L'invite suivante s'affiche :
```
Select an option:
   1. Install and Configure
   2. Add Additional Configuration Instance
   3. Refresh Installation (Reinstall, Keep Configurations)
   4. Install Debuggables to the Installation Directory
```
Entrez 1 puis appuyez sur entrée.
L'invite Clé Licence s'affiche:
```
Enter your License Key
(Format 999-999-9999-99) :
```
Entrez votre clé licence sur 10 ou 12 chiffres, puis appuyez sur Entrée.
La licence est imprimée sur la pochette, incluse dans la livraison WebFOCUS. N'oubliez pas de le saisir en utilisant le format :
```
nnn-nnn-nnnn-nn
```
ou
```
nnn-nnn-nnnn
```
L'information de licence est affichée, et vous êtes invités à renseigner le fichier iserver.tar.
```
Please enter the full path name of the media for the product.
```
Si le défaut est correct, appuyez sur Entrée. Sinon, entrez le chemin complet du fichier iserver.tar à partir duquel vous allez installer WebFOCUS Reporting Server, puis appuyez sur Entrée. Si vous installez à partir du CD, il s'agit de :
```
/cdrom/iserver.tar
```
L'invite mot de passe admin serveur s'affiche :
```
Enter the Server Administrator (current_account) Password:
```

Tapez le mot de passe pour l'administrateur serveur. Par défaut, l'administrateur serveur initial est l'utilisateur qui exécute l'utilitaire d'installation. Ce mot de passe est chiffré pour le stockage par le serveur, et est utilisé pour la sécurité PTH.

Les paramètres par défaut sont :

Please review the default settings.
EDAHOME = /install_directory/ibi/srv81/home
EDACONF = /install_directory/ibi/srv81/wfs
EDAPRFU = /install_directory/ibi/profiles
APPROOT = /install_directory/ibi/apps
HTTP_BASE_PORT = 8121
TCP_BASE_PORT = 8120
If you are satisfied with the default settings you may proceed to 
final confirmation else you will be prompted for individual values. 
Proceed with defaults? (Y/N Default=Y)       :

Entrez Y ou N en conséquence.
Si les paramètres sont corrects et vous répondez Y, l'installation commence. Lorsque vous êtes invités à démarrer le serveur, sélectionnez N et passez à Activer la Sécurité.

Si vous entrez N, l'invite EDAHOME s'affiche :
```
Supply the location on the disk in which to install the software.
This location is also known as EDAHOME.
(Default=/install_directory/ibi/srv81/home)
Please supply the location or <Enter>:
```

Pour accepter l'emplacement par défaut, appuyez sur Entrée. Pour changer le défaut, entrez le chemin absolu, puis appuyez sur Entrée.

L'invite EDACONF s'affiche :

Supply the location on the disk in which to configure the software.
This location is also known as EDACONF.
(Default=/install_directory/ibi/srv81/wfs)
Please supply the location or <Enter>:

Pour accepter l'emplacement par défaut, appuyez sur Entrée. Pour changer le défaut, entrez le chemin absolu, puis appuyez sur Entrée.

L'invite EDAPRFU s'affiche :

Supply the location on disk where the product will look for user 
profiles and the admin.cfg file. This location is also known as 
EDAPRFU.
(Default=/install_directory/ibi/profiles)
Please supply location or <Enter>:

Pour accepter l'emplacement par défaut, appuyez sur Entrée. Pour changer le défaut, entrez le chemin absolu, puis appuyez sur Entrée.

L'invite APPROOT s'affiche :

Supply the location on the disk where the product will look for 
applications. This location is also known as APPROOT.
(Default=/install_directory/ibi/apps)
Please supply the location or <Enter>:

Pour accepter l'emplacement par défaut, appuyez sur Entrée. Pour changer le défaut, entrez le chemin absolu, puis appuyez sur Entrée.
L'invite Fichiers Démo s'affiche :
```
Would you like to install New Century Demo files 
(Y/N Default=Y)?        :
```

Pour accepter le défaut est installé les Fichiers Démo New Century, appuyez sur Entrée.

L'invite Port écouteur HTTP s'affiche :

Enter HTTP Listener Port (HTTP_BASE_PORT). This is the first of three 
consecutive port numbers that are open and dedicated to the HTTP Listener
and other IP based services.
(Default=8121) :

Pour accepter le défaut, appuyez sur Entrée. Pour changer le défaut, entrez le deuxième des quatre numéros de port que le serveur utilise, puis appuyez sur entrée.
L'invite Port écouteur TCP s'affiche :
```
Enter TCP Listener Port (TCP_BASE_PORT). The TCP Listener Port 
number must be outside the selected HTTP range (8121 - 8123).
(Default=8120) :
```
Pour accepter le défaut, appuyez sur Entrée. Pour changer le défaut, entrez un numéro de port, puis appuyez sur Entrée. Il est recommandé que le numéro de port TCP soit égal au numéro de port HTTP - 1.
L'invite Serveur de messagerie SMTP (optionnel) s'affiche :
```
Enter SMTP Mail Server (Optional)        :
```
Entrez le nom d'hôte du serveur de messagerie SMTP. Cette saisie est facultative.

Un écran de synthèse s'affiche avec vos paramètres d'installation, et vous êtes invités à les confirmer :
```
Please confirm these values with one of the following responses ...
    Y = Accept and Proceed
    N = Start Over
    Q = Quit
```

Entrez Y et appuyez sur Entrée pour installer le serveur.

A la fin de l'installation, vous verrez l'information suivante :

ISETUP: Configuration Step completed
-------------------------------------------------------------
Would you like to start the Server Workspace (Y/N Default=Y)?:

Entrez N puis appuyez sur entrée.

Si vous recevez l'erreur suivante, vous pouvez l'ignorer :

inu: There was an error in opening the file 
/install_directory/ibi/srv81/home/etc/version.cfg

Haut de page

Comment : Activer la Sécurité

Pour activer le serveur en démarrage avec sécurité OPSYS, vous devrez effectuer la procédure suivante. Lorsque le serveur démarre avec la sécurité OPSYS, les utilisateurs sont authentifiés contre le système d'exploitation. Après avoir effectué cette procédure, vous pouvez toujours démarrer le serveur avec sécurité OFF ou PTH, mais la sécurité OPSYS n'est disponible qu'après avoir suivi ces étapes.

Pour une description des niveaux de sécurité, consultez ID Utilisateur et Sécurité pour WebFOCUS et ReportCaster.

Connectez-vous en tant que root.
Placez votre répertoire courant sur EDAHOME/bin. L'emplacement par défaut pour ce répertoire est le suivant :
```
/install_directory/ibi/srv81/home/bin
```
Changez les permissions fichiers en saisissant les commandes suivantes, puis en appuyant sur Entrée.
```
chown root tscom300.out
chmod 4555 tscom300.out
```
Vérifiez vos changements à l'aide de la commande suivante :
```
ls -l tscom300.out
```
La sortie devrait être similaire à :
```
-r-sr-xr-x    1 root     iadmin   750687 Jan 16 17:05 tscom300.out
```
Notez les permissions et les propriétaires. La taille est susceptible de varier.
Déconnectez-vous en tant que root.