开发者服务门户 v. 4.16.09
安装前,请确保:
- 您要在受支持版本的 Red Hat Enterprise Linux、CentOS 或 Oracle 的 64 位版本上执行安装。如需查看支持的版本列表,请点击此处。
- 已安装 Yum。
- 备份现有安装。如果您修改了 Drupal 核心或任何非自定义模块中的任何代码,您的修改将被覆盖。其中包括您对 .htaccess 所做的任何更改。您应假定 /sites 目录之外的所有内容都归 Drupal 所有。robots.txt 是此规则的例外情况;如果该文件位于网络根目录中,系统会为您保留该文件。在继续安装之前,请备份您的整个 Drupal 网页根目录。默认安装位置为 /var/www/html,但您可能在安装时已更改了该位置。执行下述安装步骤后,您就可以从备份中恢复您的自定义设置。
请按以下步骤安装开发者渠道服务门户。
1. 获取开发者渠道服务套装
请转到 http://community.apigee.com/content/apigee-customer-support,然后选择“登录支持门户”,从而通过以下两种方式之一请求开发者渠道服务 .tar 文件:
- 请求访问适用于私有云的 Edge 下载目录。
- 请求获取开发者渠道服务 .tar 文件的网址。
2. 测试与 Apigee Edge 的连接
通过在门户服务器上的命令提示符执行以下 c网址 命令,测试您与边缘管理服务器的连接:
> curl -u
{EMAIL}:{PASSWORD}
https://{hostname}:8080/v1/organizations/{ORGNAME}
其中 ORGNAME 和 PASSWORD 的 EMAIL
确保指定特定于 Edge 安装的主机名和端口号。端口 8080 是 Edge 使用的默认端口。如果您要连接到云组织,则请求网址为:https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
, <last 8, g8 g2 >
3. 移除 7.0 之前的 PHP 版本
在开始安装之前,安装脚本会检查系统中是否存在 7.0 之前的 PHP 版本。如果存在 7.0 之前的 PHP 版本,则会显示以下警告消息:
The following packages present on your system conflict with software we are about to install. You will need to manually remove each one, then re-run this install script. php php-cli php-common php-gd php-mbstring php-mysql php-pdo php-pear php-pecl-apc php-process php-xml
对于 CentOS 和 Red Hat Enterprise Linux (RHEL),请使用以下命令移除 PHP 软件包:
yum remove <package-name>
4. 使用自动安装脚本安装开发者渠道服务
根据您是安装在已连接互联网的服务器上还是没有互联网连接的服务器上,使用以下任一过程安装门户。
在连接到互联网的服务器上:
要在连接到互联网的服务器上安装开发者渠道服务,请执行以下操作:
- 以 root 或超级用户身份登录服务器。
- 为安装文件创建目录,例如 portal。
- 前往新的 portal 目录,然后下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件,其中 x.y.z 对应于门户版本号。x.y.zx.y.z
您可以从 Apigee 在浏览器中发送给您的链接下载文件,也可以复制该文件并将其添加到以下 c网址 命令中:
> curl -kOL <paste link here> - 使用以下命令提取开发者渠道服务 .tar 文件的内容:
> tar -xvf <tar file> - 将 CD 更改为 DeveloperServices-4.x.y.z。
- 使用以下命令运行安装脚本:
> ./networked-install.sh - 对提示做出回应。
在未连接互联网的服务器上:
首先,在具有互联网连接的系统上创建一个非联网安装脚本:
- 以 root 或超级用户的身份登录到具有互联网连接的系统。
- 为安装文件创建目录,例如 portal_tar。
- 前往 portal_tar 目录,然后下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件,其中 x.y.z 对应于门户版本号。
- 使用以下命令提取开发者渠道服务 .tar 文件的内容:
> tar -xvf <tar file> - 将 CD 更改为 DeveloperServices-4.x.y.z。
- 使用以下命令创建门户 .tar.gz 文件:
> ./non-networked-install.sh
系统会为非网络安装创建一个新的 .tar.gz 文件。
若要在无法连接互联网的服务器上安装开发者渠道服务,请执行以下操作:
- 以 root 或超级用户身份登录服务器。
- 为安装文件创建目录,例如 portal。
- 将 CD 复制到 portal 目录。
- 将(在上述步骤中为非网络安装)创建的 .tar.gz 文件复制到 portal 目录中。
- 使用以下命令提取 .tar.gz 文件的内容:
> tar -xvf <tar file> - 将 CD 复制到 tar 命令创建的目录。
- 在 install-from-rpm-bundle.sh 脚本中设置权限:
> chmod 755 install-from-rpm-bundle.sh - 使用以下命令运行 install-from-rpm-bundle.sh 脚本:
> ./install-from-rpm-bundle.sh - 对提示做出回应。
5. 配置开发者门户
大多数门户配置(例如,Drupal 模块安装和默认内容创建)都是无需您参与即可完成的。系统会提示您设置数据库、配置 Edge 端点,并创建新的管理员用户。
如需配置开发者门户,请执行以下操作:
- 在浏览器中前往服务器网址,例如:
http://localhost。或者,如果您已配置特定的 IP 或 DNS,请转到 http://IP_address 或 http://DNS_name。
系统会将您重定向至 Apigee 配置文件数据库配置页面。
注意:通常,您已经配置了一个主机名并向 DNS 服务器注册该主机名,这样您就不必使用 http://localhost 了。 - 配置与数据库的连接。如果数据库在远程机器上,请展开高级选项部分,输入该机器的连接信息,然后选择保存并继续。
- 输入以下信息配置与 Apigee 端点的连接,然后选择保存。
如需详细了解这些值,请参阅开发者服务门户要求中的“安装前需要提供的信息”。- Management API 组织
- Management API 端点网址
- 通过端点身份验证的用户
- 通过身份验证的用户的密码
- 输入以下信息配置管理员用户,然后选择“保存”。请注意,Drupal 默认创建一个名为“admin”的管理员用户,因此请勿使用“admin”作为用户名。
如果您跳过此步骤,仍然可以使用 Drush 创建管理员,具体如下文第 4 部分所述。创建管理员用户。- 开发者的名字和姓氏
- 开发者的门户用户名
- 密码
- 电子邮件地址
- 安装完成后,在 settings.php 文件上设置权限:
> chmod 640 /var/www/html/sites/default/settings.php - 前往门户首页(网址为 http://localhost/)或门户的 DNS 名称。
- 使用管理员凭据登录门户。
6. 创建管理员用户(可选)
使用 Drush 为您的开发者渠道服务安装创建管理员用户。 默认情况下,Drupal 会自动创建名为“admin”的管理员用户,因此请勿使用“admin”作为用户名。
- CD 复制到您的 drupal_root/sites/default 目录。Drupal 根目录的标准位置是 /var/www/html:
> cd <drupal_root>/sites/default - 确保您对专用 Drupal 文件拥有写入权限:
> drush vget file_private_path
此命令会返回专用 Drupal 文件的路径,例如:
file_private_path: 'sites/default/private'
对应于 /var/www/html/sites/default/private/。使用以下命令确保所有者和群组可以写入此目录:
chmod -R g+w dirPathAndName
chmod -R o+r dirPathAndName - 输入以下命令以创建管理员用户,并将“< >”中的命令替换为您的值:
> drush user-create <username> --mail="<email-address>" --password="<password>"
> drush user-add-role Administrator <username> - 使用上面指定的用户名和密码以管理员身份登录开发者门户。
5. 设置 MySQL 根密码
如果您在门户安装过程中安装了 MySQL,则安装脚本会将 MySQL 根密码保留为默认值(该值为空)。
使用以下命令设置 root 密码:
> mysqladmin -u root password NEWPASSWORD
如果您之前已设置 root 密码并想要更改该密码,请使用以下命令:
> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD
您还必须在 /var/www/html/sites/default/settings.php 文件中更新密码。
6. 确保已启用更新管理器模块
如需接收 Drupal 更新通知,请确保已启用 Drupal 更新管理器模块。从 Drupal 菜单中,选择模块,然后向下滚动到更新管理器模块。如果未启用,请将其启用。
启用后,您可以使用报告 > 可用更新菜单项查看可用的更新。您还可以使用以下 Drush 命令:
> drush pm-info update
使用报告 > 可用更新 > 设置菜单项将模块配置为在有可用更新时向您发送电子邮件,并设置检查更新的频率。
7. 在生产服务器上部署(可选)
如果要在生产服务器上部署门户,则应执行额外的安全步骤,包括:
- 运行以下脚本以确保 MySQL 安装的安全性:
> /usr/bin/mysql_secure_installation
此脚本会设置 root 密码,并允许您选择仅允许访问 localhost 以及移除默认创建的测试数据库和匿名用户。强烈建议生产服务器运行此脚本。 - 如果贵公司的政策要求,请启用并配置 SELinux。
8. 配置 Apache Solr 搜索引擎(可选)
默认情况下,安装该门户时,连接到 Apache Solr 搜索引擎的 Drupal 模块处于停用状态。大多数门户都使用内部 Drupal 搜索引擎,因此不需要 Drupal Solr 模块。
如果您决定将 Solr 用作搜索引擎,则必须在服务器上本地安装 Solr,然后在门户上启用和配置 Drupal Solr 模块。
如需启用 Drupal Solr 模块,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中选择 Modules。
- 启用 Apache Solr Framework 模块和 Apache Solr Search 模块。
- 保存更改。
- 按照 https://drupal.org/node/1999280 中的说明配置 Solr。
9. 安装 mod_ssl 以支持 HTTPS(可选)
Apache HTTP Server 使用 mod_ssl 模块通过 HTTPS 提供网页。如果您想使用 HTTPS,请使用以下命令安装 mod_ssl:
> yum install mod_ssl
如需详细了解如何将门户配置为使用 SSL,请参阅 http://apigee.com/docs/developer-services/content/using-ssl-portal。
10. 安装 SmartDocs(可选)
借助 SmartDocs,您可以在开发者服务门户上记录 API,从而使 API 文档具有完全互动性。但是,如需通过门户使用 SmartDocs,您必须先在 Edge 上安装 SmartDocs。
- 如果要将门户连接到 Edge Cloud 安装,SmartDocs 已安装,无需进一步配置。
- 如果要将门户连接到 Edge 以进行私有云安装,则必须确保 SmartDocs 已安装在 Edge 上。如需详细了解如何安装 Edge 和 SmartDocs,请参阅安装 SmartDocs。
如需详细了解 SmartDocs,请参阅使用 SmartDocs 编写 API 文档。
11. 下一步做什么?
安装开发者服务门户后,您需要根据自己的特定要求对其进行配置和自定义。Apigee 网站上的文档包含有关如何配置、设置和管理门户的所有信息。如需查看相关文档,请访问 http://apigee.com/docs/developer-services/content/what-developer-portal。
下表列出了您在安装后执行的一些最常见的任务,并添加了指向 Apigee 文档的链接,您可以在其中找到更多信息:
任务 |
说明 |
主题定义了门户的外观,包括颜色、样式和其他视觉方面。 |
|
首页包括主菜单、欢迎辞、页眉、页脚和标题。 |
|
注册流程用于控制新开发者在该门户上注册帐号的方式。例如,新开发者是能够立即访问门户,还是必须经过管理员的验证?此过程还可控制在创建新帐号时通知门户管理员的方式。 |
|
该门户网站会针对特定事件发送电子邮件,以响应特定事件。例如,当新开发者在该门户上注册时以及开发者丢失密码时。 |
|
添加“条款及条件”页面,开发者必须先接受该页面,然后才能访问门户。 |
|
门户实现基于角色的授权模型。在允许开发者注册之前,请定义该门户使用的权限和角色。 |
|
该门户网站内置了对博客和消息串式论坛的支持。定义查看、添加、修改和删除博客和论坛帖子所需的权限。 |
|
确保执行数据库备份 |
确保您备份了 Drupal 数据库。请注意,由于每次安装都是不同的,因此您可以自行确定数据库的最佳备份方式。 |
设置主机名 |
如果您不在 DNS 服务器中设置主机名,则可以随时通过该服务器的 IP 地址访问网站。如果要使用主机名,您可以为服务器配置 DNS,无需对基本设置进行任何其他配置,即可正常运行。 如果您设置了负载平衡器,或者由于其他某种原因在您的网站上获得错误的网址,则可以在开发者门户 settings.php 文件中设置 $base_url,该文件默认位于 /var/www/html/sites/default 目录中。 |