开发者服务门户要求

开发者服务门户 4.16.09 版

以下是安装所需的硬件和软件要求。

硬件

要求

操作系统

这些安装说明和提供的安装文件已在 https://apigee.com/docs/api-services/reference/supported-software 上列出的操作系统上进行了测试。

RAM

1 GB

硬盘

10 GB

网络接口

需要有效的互联网连接。

在安装过程中，安装程序会从网络下载资源。 如果您的环境设置为代理出站 HTTP 和 HTTPS 请求，则必须配置代理，以正确处理下载期间可能发生的重定向请求。

例如，对 https://drupal.org/ 的请求会返回 HTTP 301 状态代码，并重定向到 https://www.drupal.org/。

您的代理应配置为从重定向返回 HTTP 200 状态代码和请求的内容。

对于 SAP 安装，如果您的环境设置为代理传出的 HTTPS 请求，则代理必须支持 TLSv1.0。OpenSSL 0.9.8 不支持 TLSv1.1 或 TLSv1.2，而仅支持 TLSv1.0。

MySQL 数据库要求

如果您选择在与开发者渠道服务同一台机器上安装 MySQL 服务器（单机拓扑），开发者渠道服务安装程序会提示您输入数据库名称和数据库用户，然后安装 MySQL 服务器并为您创建数据库架构。安装的版本是适用于您操作系统的最新版本。

如果您想将 MySQL 服务器安装在单独的系统上，则必须先在该系统上安装 MySQL 服务器，然后才能启动开发者渠道服务安装程序。您必须已安装 MySQL 5.0.15 或更高版本。

开发者渠道服务安装程序要求 MySQL 服务器包含数据库架构为空的数据库。开发者渠道服务安装程序会提示您输入数据库主机名、数据库名称和数据库用户。然后，安装程序会连接到数据库以创建默认数据库表和数据。

开发者渠道服务会使用数据库用户连接到数据库，并且该用户必须拥有以下权限：SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、INDEX、ALTER、CREATE TEMPORARY TABLES、LOCK TABLES。

例如，若要创建名为 devportal 的数据库和名为 devportal 的用户，请执行以下操作：

  1. 在系统上安装 MySQL 服务器。
  2. 使用以下命令，以 root 用户身份登录 MySQL：
    > mysql -u root -p
  3. 出现提示时，输入 root 密码。
  4. 在 mysql> 提示符处，输入以下命令以创建 devportal 用户：
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. 在系统提示时，创建 devportal 数据库：
    > mysqladmin -u devportal -p create devportal

    输入 devportal 密码。
  6. 登录 MySQL，并从门户服务器的 IP 地址授予对 devportal 的访问权限：
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    其中 portalIP 是门户服务器的 IP 地址，devportalPW 是 devportal 用户的密码。
  7. 修改 /etc/my.cnf ，将 bind-address 设置为 MySQL 服务器的 IP 地址。
  8. 重启 MySQL：
    > /etc/init.d/mysqld restart
  9. 确保 MySQL 服务器上已打开端口 3306。此过程取决于您的操作系统。例如，对于 Linux，请使用以下命令：
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

安装开发者渠道服务时，指定不在本地安装 MySQL Server。然后，系统会提示您输入远程数据库的 IP 地址、用户名和数据库名称。

Red Hat Enterprise Linux (RHEL) 要求

RHEL 有额外的要求，因为您需要订阅才能访问 Red Hat 提供的软件下载内容。服务器必须能够连接到互联网，才能通过 yum 下载 RPM。如果使用 RHEL，则该服务器必须在 Red Hat Network (RHN) 上注册，并注册到服务器可选通道。

系统会在安装过程中检查 Red Hat 要求，如果 RHEL 尚未注册，门户安装程序会提示您。如果您已经有 Red Hat 登录凭据，则可以在开始安装流程之前使用以下命令注册 RHEL：

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

将 my_username 和 my_password 替换为您的 Red Hat 凭据。

如果您使用的是 RHEL 试用版，则可以获得 30 天的试用许可。如需了解详情，请参阅 https://access.redhat.com/solutions/32790。

SMTP 要求

默认情况下，门户使用 PHP mail() 函数发送邮件。PHP 会尝试使用本地系统上的 sendmail 发送电子邮件（可以在 PHP 的 php.ini 文件中配置）。

在生产环境中，Apigee 要求您配置 SMTP 服务器，以便从门户发送电子邮件。因此，您必须确保 Drupal 可以访问 SMTP 服务器上的必要端口。对于非 TLS SMTP，端口号通常为 25。对于启用了 TLS 的 SMTP，该值通常为 465，但请与您的 SMTP 提供商确认。

其他要求

如需执行安装，安装软件的用户必须拥有 root 访问权限。

部署架构要求

开发者渠道服务通过 REST API 与 Apigee 管理服务器有一个接口，用于存储和检索用户应用的相关信息。开发者渠道服务需要能够通过 HTTP 或 HTTPS 连接到管理服务器，具体取决于您的安装方式。

开始安装前所需的信息

在开始安装之前，您必须准备好以下信息：

  1. 您要配置的是哪个平台：Red Hat 还是 CentOS？如果这是 Red Hat 安装，则必须在 Red Hat Network 上注册计算机，才能下载 RPM。
  2. 您是否计划在本地机器上安装 MySQL？某些高可用性安装要求 MySQL 位于与提供门户网页的机器不同的机器上。如果是这种情况，请勿在本地安装 MySQL。如果您希望在同一机器上轻松安装所有内容，请在本地安装 MySQL。
  3. 如果您打算访问远程 MySQL 服务器，请提供远程 MySQL 服务器的主机名、端口、数据库名称、用户名和密码。在开始安装之前，远程 MySQL 服务器应该已经完成配置。
  4. Web 服务器的完全限定域名是什么？（此信息将添加到 /etc/hosts。）它应该是 IP 地址或主机名，例如 portalserver.example.com。默认值为 localhost。
  5. 是否要为 Apache 的虚拟主机使用 Apigee 的默认配置？ 系统会使用您在上文第 7 步中指定的主机名创建一个虚拟主机。
  6. 您的门户需要具备以下三项信息，才能与 Apigee Edge 管理服务器通信。具体信息如下：
    1. Apigee Management API 端点的网址：这将是主机名或 IP 地址。这是用于创建应用和为开发者注册应用密钥的所有调用的 REST 端点。默认端点为 https://api.enterprise.apigee.com/v1。

      对于 Edge for Private Cloud 安装，网址的格式为：
      http://EdgeIp:8080/v1

      或：
      https://EdgeIp:SSLport/v1

      其中 EdgeIp 是 Edge 管理服务器的 IP 地址，SSLport 是 Edge 管理 API 的 SSL 端口。例如 8443。
    2. Apigee 组织名称：门户与 Apigee Edge 组织之间存在关系。您将在设置 Management API 端点时设置默认组织。默认值为 my-org。
    3. 管理 API 端点的用户名和密码：从门户向 Edge 进行调用必须由贵组织的管理员执行。

      此用户名/密码仅供贵组织的管理员使用，仅用于从门户连接到 Edge。例如，如果您指定了用户的凭据，而该用户在 Edge 中被删除，则该门户将无法再连接到 Edge。因此，请在贵组织中创建一个仅用于此关联的管理员。

      例如：
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd