Exigences du portail des services pour les développeurs

Portail des services pour les développeurs v. 4.16.09

Vous trouverez ci-dessous les exigences matérielles et logicielles requises 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 listés sur la page https://apigee.com/docs/api-services/reference/supported-software.

RAM

1 Go

Disque dur

10 Go

Interface réseau

Connexion Internet active requise.

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

Par exemple, une demande à 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é de la redirection.

Pour les installations SAP, si votre environnement est configuré pour proxyer les demandes HTTPS sortantes, votre proxy doit alors prendre en charge TLSv1.0. OpenSSL 0.9.8 ne prend pas en charge TLSv1.1 ni TLSv1.2, uniquement TLSv1.0.

Exigences concernant la base de données MySQL

Si vous choisissez d'installer le serveur MySQL sur la même machine que les services du canal de développement (topologie à une seule machine), l'installateur des services du canal de développement 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 la base de données à votre place. La version installée est la dernière version disponible pour votre OS.

Si vous souhaitez que le serveur MySQL soit installé sur un système distinct, vous devez l'avoir déjà installé sur ce système avant de lancer le programme d'installation des services de chaînes pour les développeurs. Vous devez avoir installé MySQL 5.0.15 ou version ultérieure.

L'installateur des services du canal de développement nécessite que le serveur MySQL contienne une base de données avec un schéma de base de données vide. L'installateur des services de canal de développement vous demande le nom d'hôte, le nom et l'utilisateur de la base de données. L'installateur 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 les services du canal de développement 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 devportal:

  1. Installez le serveur MySQL sur le système.
  2. Connectez-vous à MySQL en tant qu'utilisateur racine à l'aide de la commande:
    > mysql -u root -p
  3. Saisissez le mot de passe racine lorsque vous y êtes invité.
  4. À l'invite "mysql>", saisissez la commande suivante pour créer l'utilisateur du portail de développement:
    mysql>create user 'devportal'@'localhost' shared by 'devportal';
    mysql> accordez tous les droits sur *.* à 'devportal'@'localhost';
    mysql> flush functions;
    mysql> quit
  5. Lorsque l'invite système s'affiche, 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 à devportal à partir de l'adresse IP du serveur du portail:
    mysql> GRANT ALL ON devportal.* À devportal@'portalIP IDENTIFIÉ PAR 'devportalPW'

    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:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Lorsque vous installez les services de chaîne pour les développeurs, spécifiez de ne pas installer le serveur MySQL en local. Vous êtes alors invité à saisir l'adresse IP, le nom d'utilisateur et le nom de la base de données distante.

Exigences concernant Red Hat Enterprise Linux (RHEL)

RHEL a des exigences supplémentaires en raison d'un abonnement 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 RHN (Red Hat Network) et enregistré 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 mon_nom_utilisateur et mon_mot_de_passe 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. Voir https://access.redhat.com/solutions/32790 pour plus d'informations.

Exigences SMTP

Par défaut, le portail envoie des e-mails à 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 vous demande de configurer un serveur SMTP pour envoyer des messages électroniques à partir du 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 avec TLS, il s'agit souvent d'une erreur 465. Contactez 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 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 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 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 qui dessert les pages Web du portail. Dans ce cas, n'installez pas MySQL localement. Si vous voulez une installation simple avec tout sur la même machine, installez MySQL localement.
  3. Si vous souhaitez 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 du serveur MySQL distant. Le serveur MySQL distant doit déjà être configuré avant que vous ne commenciez l'installation.
  4. Quel est le nom de domaine complet du serveur Web ? (Cette information sera ajoutée à /etc/hosts.) Cela doit être une adresse IP ou 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. Voici les informations requises :
    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 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 pour le cloud privé, l'URL se présente sous la forme:
      http://EdgeIp:8080/v1

      ou:
      https://EdgeIp:SSLport/v1

      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 définirez l'organisation par défaut lorsque vous configurerez 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 entreprise et ne doit être utilisé que pour la connexion à Edge à partir du portail. Par exemple, si vous spécifiez les identifiants 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 sur votre organisation uniquement pour cette connexion.

      Par exemple:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd