Exigences du portail des services pour les développeurs

Portail des services pour les développeurs version 4.16.09

Vous trouverez ci-dessous la configuration matérielle et logicielle requise pour l'installation.

Matériel

Exigence

Système d'exploitation

Ces instructions d'installation et les fichiers d'installation fournis ont été testés sur les systèmes d'exploitation répertoriés ici: https://apigee.com/docs/api-services/reference/supported-software

Mémoire RAM

1 Go

Disque dur

10 GB

Interface réseau

Connexion Internet active requise.

Dans le cadre du processus d'installation, le programme d'installation télécharge des ressources depuis le Web. Si votre environnement est configuré pour rediriger les requêtes HTTP et HTTPS sortantes, votre proxy doit être configuré pour gérer correctement les requêtes redirigées pouvant se produire lors d'un téléchargement.

Par exemple, une requête envoyée à https://drupal.org/ renvoie un code d'état HTTP 301 et redirige vers https://www.drupal.org/.

Votre proxy doit être configuré pour renvoyer un code d'état HTTP 200 avec le contenu demandé par la redirection.

Pour les installations SAP, si votre environnement est configuré pour proxyer les requêtes HTTPS sortantes, votre proxy doit être compatible avec TLSv1.0. OpenSSL 0.9.8 n'est pas compatible avec TLSv1.1 ou TLSv1.2, mais uniquement TLSv1.0.

Exigences concernant les bases de données MySQL

Si vous choisissez d'installer le serveur MySQL sur la même machine que celle des services pour les développeurs (topologie à machine unique), le programme d'installation de Developer Channel Services vous invite à saisir le nom 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 disponible pour votre système d'exploitation.

Si vous souhaitez que le serveur MySQL soit installé sur un système distinct, vous devez avoir installé MySQL Server sur ce système avant de lancer le programme d'installation de Developer Channel Services. Vous devez avoir installé MySQL 5.0.15 ou 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, le nom 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. Il 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. Dans l'invite mysql>, saisissez la commande suivante pour créer l'utilisateur devportal:
    mysql>create user 'devportal'@'localhost' étiqueté by 'devportal';
    mysql> évoque tous les privilèges sur *.* sur "devportal'@'localhost';
    mysql> flushapplication;
    mysql> quit
  5. Lorsque le système vous y invite, créez la base de données devportal:
    > mysqladmin -u devportal -p create devportal

    Saisissez le mot de passe du devportal.
  6. Connectez-vous à MySQL et accordez l'accès au devportal à partir de l'adresse IP du serveur du portail:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP IDENTIFIED BY 'portalIP';

    portalIP correspond à l'adresse IP du serveur du portail et portalIP le mot de passe de l'utilisateur du portail de développement.
  7. Modifiez /etc/my.cnf pour définir "binding-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 les services de canaux pour développeurs, indiquez de ne pas installer le serveur MySQL en local. Vous êtes ensuite invité à saisir l'adresse IP, le nom d'utilisateur et le nom de base de données de la base de données distante.

Configuration requise pour Red Hat Enterprise Linux (RHEL)

RHEL a des exigences supplémentaires en raison d'un abonnement requis pour accéder aux téléchargements de logiciels depuis Red Hat. Le serveur doit être en mesure de 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 de Red Hat sont vérifiées lors de l'installation et le programme d'installation du portail vous invite 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'évaluation de 30 jours. Pour en savoir plus, consultez la page https://access.redhat.com/solutions/32790.

Exigences SMTP

Par défaut, le portail envoie les messages à l'aide de la fonction PHP mail(). PHP tente d'envoyer des e-mails à 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 exige que vous configuriez un serveur SMTP pour envoyer des e-mails à partir du portail. Vous devez donc 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 serveur SMTP sur lequel TLS est activé, il s'agit souvent de 465. Veuillez vérifier 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 root.

Exigences concernant l'architecture de déploiement

Les services de canaux pour les développeurs disposent d'une interface unique avec Apigee Management Server via une API REST afin de stocker et de récupérer des informations sur les applications d'un utilisateur. Les services Developer Channel Services 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 Red Hat Network pour pouvoir 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 desservant les pages Web du portail. Dans ce cas, n'installez pas MySQL localement. Si vous souhaitez une installation simple avec tout sur la même machine, installez MySQL localement.
  3. Si vous avez l'intention d'accéder à un serveur MySQL distant, indiquez le nom d'hôte, le port, le nom de la base de données, le nom d'utilisateur et le mot de passe de ce serveur. 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 Apache ? Un hôte virtuel est créé avec le nom d'hôte que vous avez spécifié ci-dessus à l'étape 7.
  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'agira d'un nom d'hôte ou d'une adresse IP. Il s'agit du point de terminaison REST auquel tous les appels sont effectués pour créer des applications et enregistrer les 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 se présente sous la forme suivante:
      http://EdgeIp:8080/v1

      ou:
      https://EdgeIp:SSLport/v1

      EdgeIp est l'adresse IP du serveur de gestion Edge et SSLport est le port de gestion de l'API pour Edge. (8443, par exemple).
    2. Nom de l'organisation Apigee: il existe une relation entre les portails et les organisations Apigee Edge. Vous configurez l'organisation par défaut lorsque vous configurez le point de terminaison de l'API de gestion. La valeur par défaut est my-org.
    3. Nom d'utilisateur et mot de passe pour le point de terminaison de l'API de gestion: 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 informations d'identification d'un utilisateur et que cet utilisateur est jamais supprimé sur Edge, le portail ne pourra plus se connecter à Edge. Par conséquent, créez un administrateur dans votre organisation uniquement pour cette connexion.

      Exemple:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd