开发者服务门户要求

开发者服务门户 v. 4.16.05

以下是进行安装时需满足的硬件和软件要求。

硬件

要求

操作系统

这些安装说明和提供的安装文件已在下列操作系统上进行了测试: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 Server,则开发者渠道服务安装程序会提示您输入数据库名称和数据库用户,然后安装 MySQL Server 并为您创建数据库架构。安装的版本是您的操作系统可用的最新版本。

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

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

数据库用户可供开发者渠道服务用来连接到数据库,并且必须拥有以下权限:SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、INDEX、ALTER、CREATE TEMPORARY TABLES、LOCK TABLES。

举例来说,要创建一个名为 devportal 的数据库和名为 devportal 的用户,请使用以下命令:

  1. 在系统上安装 MySQL Server。
  2. 使用以下命令以根用户身份登录 MySQL:
    > mysql -u root -p
  3. 出现提示时,输入 root 密码。
  4. 在 mysql> 提示符处,输入以下命令以创建 devportal 用户:
    mysql>create user 'devportal'@'localhost' plug' by 'devportal';
    mysql> 将 *.* 的所有权限授予 'devportal'@'localhost';
    mysql> flush 权限;
    mysql> quit
  5. 在系统提示符处,创建 devportal 数据库:
    > mysqladmin -u devportal -p create devportal

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

    其中 portalIP 是门户服务器的 IP 地址,devportalPWdevportal 用户的密码。
  7. 修改 /etc/my.cnf 以将绑定地址设置为 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 服务器。然后,系统会提示您输入远程数据库的 IP 地址、用户名和数据库名称。

Red Hat Enterprise Linux (RHEL) 要求

由于需要订阅才能从 Red Hat 下载软件,RHEL 有额外的要求。服务器必须能连接到互联网,才能通过 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_usernamemy_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 Management Server 具有单一接口,用于存储和检索有关用户应用的信息。开发者渠道服务需要能够通过 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. 是否要将 Apigee 的默认配置用于 Apache 的虚拟主机?使用您在上面第 7 步中指定的主机名创建一个虚拟主机。
  6. 有三种信息可让您的门户与 Apigee Edge 管理服务器进行通信。具体信息如下:
    1. Apigee Management API 端点的网址:这将是主机名或 IP 地址。这是创建应用和注册开发者以获取应用密钥的所有调用的 REST 端点。默认端点为 https://api.enterprise.apigee.com/v1

      对于用于私有云的 Edge 安装,网址格式如下:
      http://EdgeIp:8080/v1

      或:
      https://EdgeIp:SSLport/v1

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

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

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