Exigences du portail des services pour les développeurs

Portail des services pour les développeurs v. 4.16.09

Voici les exigences matérielles et logicielles pour l'installation.

Exigences concernant la base de données MySQL

Si vous choisissez d'installer le serveur MySQL sur la même machine que les services de canal de développement (topologie à machine unique), le programme d'installation des services de canal de développement vous invite à saisir le nom de la base de données et l'utilisateur de la base de données, puis installe le serveur MySQL et crée le schéma de base de données pour vous. La version installée est la dernière version disponible pour votre OS.

Si vous souhaitez installer le serveur MySQL sur un système distinct, vous devez déjà avoir installé le serveur MySQL sur ce système avant de lancer le programme d'installation de Developer Channel Services. Vous devez avoir installé MySQL 5.0.15 ou une version ultérieure.

Le programme d'installation de Developer Channel Services nécessite que le serveur MySQL contienne une base de données avec un schéma de base de données vide. Le programme d'installation de Developer Channel Services vous invite à saisir le nom d'hôte de la base de données, le nom de la base de données et l'utilisateur de la base de données. Le programme d'installation se connecte ensuite à la base de données pour créer les tables et les données de base de données par défaut.

L'utilisateur de la base de données est utilisé par Developer Channel Services pour se connecter à la base de données et doit disposer des droits suivants : SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

Par exemple, pour créer une base de données nommée devportal et un utilisateur nommé devportal :

1. Installez le serveur MySQL sur le système.
2. Connectez-vous à MySQL en tant qu'utilisateur racine à l'aide de la commande suivante :
   > mysql -u root -p
3. Saisissez le mot de passe racine lorsque vous y êtes invité.
4. À l'invite mysql>, saisissez ce qui suit pour créer l'utilisateur devportal :
   mysql>create user 'devportal'@'localhost' identified by 'devportal';
   mysql> grant all privileges on *.* to 'devportal'@'localhost';
   mysql> flush privileges;
   mysql> quit
5. À l'invite du système, créez la base de données devportal :
   > mysqladmin -u devportal -p create devportal
   
   Saisissez le mot de passe devportal.
6. Connectez-vous à MySQL et accordez l'accès à devportal à partir de l'adresse IP du serveur du portail :
   mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
   
   où portalIP est l'adresse IP du serveur du portail et devportalPW est le mot de passe de l'utilisateur devportal.
7. Modifiez /etc/my.cnf pour définir bind-address sur l'adresse IP du serveur MySQL.
8. Redémarrez MySQL :
   > /etc/init.d/mysqld restart
9. Assurez-vous que le port 3306 est ouvert sur le serveur MySQL. Cette procédure est basée sur votre système d'exploitation. Par exemple, sous Linux, utilisez la commande suivante :
   > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Lorsque vous installez Developer Channel Services, spécifiez que vous ne souhaitez pas installer MySQL Server localement. Vous serez ensuite invité à saisir l'adresse IP, le nom d'utilisateur et le nom de la base de données distante.

Exigences pour Red Hat Enterprise Linux (RHEL)

RHEL est soumis à des exigences supplémentaires, car un abonnement est nécessaire pour accéder aux téléchargements de logiciels depuis Red Hat. Le serveur doit pouvoir se connecter à Internet pour télécharger des RPM via yum. Si vous utilisez RHEL, le serveur doit être enregistré sur le réseau Red Hat (RHN) et sur le canal facultatif du serveur.

Les exigences Red Hat sont vérifiées lors de l'installation, et le programme d'installation du portail vous invite à vous inscrire si RHEL n'est pas déjà enregistré. Si vous disposez déjà d'identifiants de connexion Red Hat, vous pouvez utiliser la commande suivante pour enregistrer RHEL avant de commencer le processus d'installation :

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Remplacez my_username et my_password par vos identifiants Red Hat.

Si vous disposez d'une version d'essai de RHEL, vous pouvez obtenir une licence d'essai de 30 jours. Pour en savoir plus, consultez la page https://access.redhat.com/solutions/32790.

Exigences SMTP

Par défaut, le portail envoie des e-mails à l'aide de la fonction PHP mail(). PHP tente d'envoyer un e-mail à l'aide de sendmail sur le système local, qui peut être configuré dans le fichier php.ini de PHP.

Dans un environnement de production, Apigee nécessite que vous configuriez un serveur SMTP pour envoyer des e-mails depuis le portail. Par conséquent, vous devez vous assurer que Drupal peut accéder au port nécessaire sur le serveur SMTP. Pour le protocole SMTP non TLS, le numéro de port est généralement 25. Pour le protocole SMTP compatible TLS, il s'agit souvent du port 465, mais vérifiez auprès de votre fournisseur SMTP.

Autres conditions requises

Pour effectuer l'installation, l'utilisateur qui installe le logiciel doit disposer d'un accès racine.

Exigences concernant l'architecture de déploiement

Developer Channel Services dispose d'une interface unique avec le serveur de gestion Apigee via une API REST pour stocker et récupérer des informations sur les applications d'un utilisateur. Les services de canal de développement doivent pouvoir se connecter au serveur de gestion via HTTP ou HTTPS, selon votre installation.

Informations requises avant de commencer l'installation

Avant de commencer l'installation, vous devez disposer des informations suivantes :

1. Quelle plate-forme configurez-vous : Red Hat ou CentOS ? S'il s'agit d'une installation Red Hat, la machine doit être enregistrée sur le réseau Red Hat pour télécharger les RPM.
2. Prévoyez-vous d'installer MySQL sur la machine locale ? Certaines installations haute disponibilité nécessitent que MySQL se trouve sur une machine différente de celle qui diffuse les pages Web du portail. Si tel est le cas, n'installez pas MySQL localement. Si vous souhaitez une installation simple avec tous les éléments sur la même machine, installez MySQL localement.
3. Si vous souhaitez accéder à un serveur MySQL distant, le nom d'hôte, le port, le nom de la base de données, le nom d'utilisateur et le mot de passe du serveur MySQL distant. Le serveur MySQL distant doit déjà être configuré avant de commencer l'installation.
4. Quel est le nom de domaine complet du serveur Web ? (Ces informations seront ajoutées à /etc/hosts.) Il doit s'agir d'une adresse IP ou d'un nom d'hôte, tel que portalserver.example.com. La valeur par défaut est localhost.
5. Voulez-vous utiliser la configuration par défaut d'Apigee pour l'hôte virtuel d'Apache ? Un hôte virtuel est créé avec le nom d'hôte que vous avez spécifié à l'étape 7 ci-dessus.
6. Trois informations permettent à votre portail de communiquer avec le serveur de gestion Apigee Edge. Ces informations sont les suivantes :
   1. URL du point de terminaison de l'API Apigee Management : il s'agit d'un nom d'hôte ou d'une adresse IP. Il s'agit du point de terminaison REST vers lequel tous les appels sont effectués pour créer des applications et enregistrer des développeurs pour les clés d'application. Le point de terminaison par défaut est https://api.enterprise.apigee.com/v1.
      
      Pour une installation Edge for Private Cloud, l'URL est au format suivant :
      http://EdgeIp:8080/v1
      
      ou :
      https://EdgeIp:SSLport/v1
      
      Où EdgeIp est l'adresse IP du serveur de gestion Edge et SSLport est le port SSL de l'API de gestion Edge. Par exemple, 8443.
   2. Nom de l'organisation Apigee : il existe une relation entre les portails et les organisations Apigee Edge. Vous allez configurer l'organisation par défaut lorsque vous configurerez le point de terminaison de l'API Management. La valeur par défaut est "my-org".
   3. Nom d'utilisateur et mot de passe du point de terminaison de l'API Management : les appels du portail vers Edge doivent être effectués par un administrateur de votre organisation.
      
      Ce nom d'utilisateur/mot de passe est destiné à un administrateur de votre organisation et ne doit être utilisé que pour se connecter à Edge à partir du portail. Par exemple, si vous spécifiez les identifiants d'un utilisateur et que cet utilisateur est supprimé sur Edge, le portail ne pourra plus se connecter à Edge. Par conséquent, créez un administrateur sur votre organisation uniquement pour cette connexion.
      
      Exemple :
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd