Manuel d'administration > Installation > Nouvelle installation > Installation d'un Agent pour SAP - Détails

Installation d'un Agent pour SAP - Détails

Vous trouverez ici des indications pour la nouvelle installation d'un agent SAP.

	1.	Installation de Microsoft Visual C++ 2010 Redistributable Package (Windows)

Cette étape n'est nécessaire que lors de l'installation de l'agent SAP sur Windows.

En commençant par Jco 3.0.0, l'exécution de Jco sur Windows exige les bibliothèques Runtime Visual Studio 2005 C/C++. Reportez-vous à la note SAP 684106 pour des détails sur leur installation.

Si le package est déjà installé dans la version nécessaire, vous pouvez passer cette étape de l'installation. Pour savoir si cette version est présente, et si oui dans quelle version, consultez Panneau de configuration -> Logiciels.

Hôte
Installez le package à partir du répertoire IMAGE:CRTS.

	2.	Installation de Java Runtime Environment (JRE)

Si JRE est déjà installé dans la version nécessaire, vous pouvez passer cette étape de l'installation.

Ordinateur administrateur et/ou ordinateur utilisateur
Vérifiez la version de la machine virtuelle Java (VM) du système à l'aide de la commande suivante :

java -version

Si plusieurs versions de JRE ou de Java SDK sont installées sur l'ordinateur, l'ordre des répertoires donnés est important. Faites-y attention lorsque vous paramétrez %PATH% et $PATH. L'environnement Java Runtime à utiliser est le premier trouvé dans la liste des répertoires.

Téléchargez le Java Runtime Environment nécessaire depuis le site http://java.sun.com et installez-le. Le processus d'installation comprend l'installation automatique du plug-in Java pour les navigateurs Web. Comme AE n'en a pas besoin, vous pouvez le désactiver dans le panneau de configuration.

	3.	Installation de l'agent (UNIX)

Hôte
Connexion à l'aide de l'utilisateur "AE".
Transférez le fichier tar UCXJR3X.tar.gz via FTP dans un répertoire (par exemple sap).
Allez au répertoire sap :
cd sap
Décompression du fichier tar :
gzip -d UCXJR3X.tar.gz
tar xvfo UCXJR3X.tar
Vous obtenez ainsi les fichiers livrés. Le fichier tar peut être supprimé après la décompression.
Remarque : Attention : tenez bien compte des messages de tar qui peuvent par exemple s'afficher via différents propriétaires et vérifiez que tous les fichiers ont bien été décompressés.
Vérifiez que tous les fichiers possèdent les éléments Propriétaire et Groupe qui conviennent. AE doit être propriétaire. Le groupe doit correspondre à l'utilisateur AE. La modification doit être effectuée sous un utilisateur privilégié, par exemple root.
chown UC4 * remplace les propriétaires de tous les fichiers par AE.
chgrpNom du groupe* modifie le groupe d'utilisateurs pour tous les fichiers.
Renommez le fichier INI fourni UCXJR3X.ori.ini d'UCXJR3X.ini.
Adaptez le fichier INI à l'environnement système.

	4.	Installation de l'agent (Windows)

Allez au sous-répertoire IMAGE:AGENTS\SAP\WINDOWS.
Démarrez le programme SETUP.EXE.
Adaptez le fichier INI à l'environnement système.
Adaptez éventuellement les fichiers HEADER.SAP, TRAILER.SAP, RESTART.SAP ou. HEADER.SAPBW, TRAILER.SAPBW, RESTART.SAPBW. Voir : Job - Exécution.
L'agent SAP est un programme d'arrière-plan d'AE. Il est en général démarré via le gestionnaire de services.

	5.	Installation de SAP JAVA Connector

Hôte
Vous trouverez les instructions précises pour l'installation et la configuration dans l'archive de SAP Java Connector (<sapjco-install-path>/docs/jco/intro.html). Lisez cette description avec attention pour garantir un fonctionnement correct.
Pour connaitre la version de connecteur java supportée, reportez-vous au prérequis de l'agent SAP.
Si vous disposez de Java 32 bits, installez la version 32 bits du SAP Java Connector. De même pour Java 64 bits.
Téléchargez le SAP Java Connector de SAP Service Marketplace et installez-le (Support Portal -> Downloads -> SAP Connectors -> SAP Java Connector -> Tools & Services).
Copiez les fichiers du connecteur java de SAP dans le répertoire BIN de l'agent.
La remarque SAP 636912 contient des informations sur la façon de vérifier si Java Connector a été installé correctement.

	6.	Importation de l'interface AE

Hôte
Cette étape d'installation n'est nécessaire qu'en cas d'utilisation de l'interface AE !
Copiez les fichiers de transport.
Importez le transport.
Rubriques connexes : Transport de l'interface AE.

	7.	Créer un utilisateur CPIC

Hôte
Connectez-vous au système SAP avec l'administrateur des utilisateurs SAP.
Créez un profil d'autorisation, directement ou via un rôle.
Créez l'utilisateur CPIC et affectez le profil d'autorisation ou le rôle.
Attention : cet utilisateur CPIC doit être créé avec le même mot de passe dans chaque client SAP sur lequel vous voulez exécuter un Job !

	8.	Configuration des objets Connexion

Ordinateur administrateur ou ordinateur utilisateur

L'agent SAP requiert des données pour se connecter aux différents domaines de SAP.
Démarrez l'interface utilisateur et connectez-vous au client système 0000.
Créez pour chaque domaine SAP que vous désirez utiliser avec un Agent SAP un objet Connexion propre (voir tableau ci-dessous). Vous devez aussi absolument créer un objet Connexion pour SAP Basis. Vous y entrerez l'utilisateur CPIC. Tous les autres paramètres sont facultatifs.
Choisissez le type dans l'objet Connexion et saisissez les données de connexion.

SAP	Type de connexion
ABAP Basis	Remote Function Call
Java Basis	Internet
Intégration des processus	Internet
System Landscape Directory	Internet

Attention : SAP fait la différence entre les majuscules et les minuscules ! Entrez le mot de passe comme on l'écrit.

	9.	Configuration des objets Agent

Ordinateur administrateur ou ordinateur utilisateur
Allez dans le dossier "HOST".
Créez un objet Agent.
Utilisez pour le nom de l'agent le même nom que celui spécifié dans le paramètre name= du fichier INI de l'agent SAP.
Ouvrez l'objet Agent et allez sur l'onglet "Agent".
Choisissez l'objet Connexion créé auparavant.
Enregistrez et fermez l'objet Agent.
Vous pouvez choisir d'omettre cette étape de l'installation et démarrer l'agent immédiatement (étape suivante). Dans ce cas, un objet agent est créé automatiquement mais il est nécessaire de l'arrêter ensuite. Sélectionnez l'objet connexion et redémarrez-le.

	10.	Démarrage de l'agent

Ordinateur serveur
Le système AE doit être en cours d'exécution.
Hôte
Utilisez les commandes pour démarrer l'agent à partir de la ligne de commande du système d'exploitation.
- Windows :
- UNIX :

Si le SAP Java Connector ne peut pas charger sa bibliothèque native, le paramètre -Djava.library.path peut être utilisé pour indiquer un répertoire qui contient le libsapjco3.so.

L'agent peut également être démarré avec le gestionnaire de services.

Notez que la limite de stockage doit être définie au minimum à 256 Mo (ou 512 Mo) pour démarrer les agents Java (bases de données, RA, JMX, SAP). Vous pouvez spécifier la valeur limiter de stockage des applications Java en utilisant le paramètre de démarrage -XmX. Spécifier une valeur trop faible peut entraîner un blocage de l'agent. La valeur par défaut dépend de la version Java utilisée.

Le paramètre Java -Xrs permet de garantir l'arrêt correct de l'agent si une fin normale est demandée. Automic recommande d'utiliser ce paramètre. Vous trouverez plus d'informations à ce sujet dans la documentation de Java.

Un objet Agent est créé automatiquement dans le Client système 0000 et il est sauvegardé dans le dossier "HOST".
Ordinateur administrateur ou Serveur

Vérifiez que l'agent de SAP BW s'est connecté.
- Affichez les informations sur les Agents dans la Supervision Système. Comme un Agent nouvellement connecté n'est pas encore attribué à un Client, il est uniquement visible dans le Client 0000. Il est maintenant possible d'attribuer le nouvel agent aux clients avec les droits requis en utilisant l'objet agent.

	11.	Test de fonction

Ordinateur administrateur/hôte
Démarrez un Job de test.
L'ordinateur SAP est hôte. Attribuer des ID utilisateur valide. Activer la création de rapports de job dans AE
Le script contient les lignes suivantes :
R3_ACTIVATE_REPORT REP=RSM04000_ALV,COVERPAGE=YES
L'ABAP appelé crée une liste des utilisateurs actifs.
Surveiller le traitement dans l'interface utilisateur.
AE peut avoir besoin de plusieurs secondes pour remarquer que le job est terminé. L'agent vérifie périodiquement si le job s'exécute encore. Cet intervalle peut être défini dans la caractéristique de l'hôte.
Contrôlez le rapport de Job.
Contrôlez le logging de l'agent dans le fichier log.
Système SAP
Avec la transaction RZ15 (uniquement pour l'interface standard), vérifiez les entrées LOG de la période actuelle.
Arrêt de l'agent