开发者服务门户安装

开发者服务门户 v. 4.16.05

请按照以下步骤安装开发者渠道服务门户。

在继续安装之前，请备份您的整个 Drupal 网络根目录 目录。默认安装位置为 /var/www/html，但您可能更改了它 。执行下述安装步骤后，您就可以恢复 备份中的自定义设置。

1. 获取开发者渠道服务包

请访问 http://community.apigee.com/content/apigee-customer-support 然后选择“登录支持门户”以请求在 使用以下两种方法之一：

• 请求访问 Edge for Private Cloud 下载目录。
• 请求开发者渠道服务 .tar 文件的网址。

。

2. 确保您的系统与系统相连接 要求

在安装门户之前，您的服务器必须满足以下要求：

1. 请确保您在支持的 64 位版本的 Red Hat Enterprise Linux、CentOS 或 Oracle。如需查看受支持版本的列表，请点击此处。
2. 确保已安装 Yum。
3. （要在没有互联网连接的服务器上安装）您必须 首先将所有必需的文件下载到 一台具有互联网连接的服务器上，将 .tar.gz 文件。然后将该 .tar.gz 文件复制到没有互联网连接的服务器 执行安装。
   1. 以根用户或超级用户身份登录连接到互联网的服务器。
   2. 为安装文件创建目录，例如 portal_tar。
   3. CD 到新目录并下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件中，其中 x.y.z 对应于门户版本号。
   4. 使用 命令：
      &gt;tar -xvf <tar file&gt;
   5. CD 复制到 DeveloperServices-4.x.y.z。
   6. 使用以下命令创建门户 .tar.gz 文件：
      &gt; ./non-networked-install.sh
      
      该命令会将所有必需的文件下载至单个 .tar.gz 文件。您 然后将该 .tar.gz 文件复制到没有互联网连接的服务器，以完成 安装。
4. 执行以下 c网址 命令，测试与边缘管理服务器的连接 运行以下命令提示：
   &gt;curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   其中，EMAIL 和 PASSWORD 是电子邮件地址 ORGNAME 管理员的地址和密码。
   
   请务必指定专用于 Edge 安装的主机名和端口号。端口 8080 是 Edge 使用的默认端口。如果您要连接到云端的组织 请求网址为：
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   如果成功，此命令将返回如下所示的响应：
   {
   “ createdAt”：1348689232699、
   “ createdBy”：“USERNAME”,
   &quot;displayName&quot;: "cg",
   "环境": [ "测试", "生产"],
   “lastModifiedAt”：1348689232699、
   “lastModifiedBy”: "foo@bar.com",
   “名称”: "cg",
   "属性": {
   “媒体资源”：[ ]
   },
   "类型"：“trial”
   }

3. 安装开发者版 使用自动安装脚本的渠道服务

请按照以下步骤，使用自动安装脚本安装门户。这个 适用于有或没有外部互联网连接的服务器。

1. 以根用户或超级用户身份登录服务器。
2. 为安装文件创建目录，例如 portal。
3. 在连接到互联网的服务器上： <ph type="x-smartling-placeholder">
   </ph>
   1. CD 添加到新门户 目录并下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件，其中 x.y.z 对应门户版本号。
      
      您可以在浏览器中通过 Apigee 发送给您的链接下载文件，也可以复制文件 然后将其添加到以下 c网址 命令中：
      &gt;curl -kOL <粘贴链接 here&gt;
   2. 使用 命令：
      &gt;tar -xvf <tar file&gt;
   3. CD 复制到 DeveloperServices-4.x.y.z。
   4. 使用以下命令运行安装脚本：
      &gt; ./networked-install.sh
4. 在无法连接到互联网的服务器上： <ph type="x-smartling-placeholder">
   </ph>
   1. 复制您在上文第 2 部分中创建的 .tar.gz 文件。确保您的系统符合 系统需求
   2. 使用以下命令解压缩 .tar.gz 文件的内容：
      &gt;tar -xvf <tar file&gt;
   3. CD 到 tar 命令创建的目录。
   4. 对 install-from-rpm-bundle.sh 脚本设置权限：
      &gt;chmod 755 install-from-rpm-bundle.sh
   5. 运行以下命令，以运行 install-from-rpm-bundle.sh 脚本 请使用以下命令：
      &gt; ./install-from-rpm-bundle.sh
5. 回答提示。
6. 安装完成后，在浏览器中导航到服务器网址，如 身份：
   http://localhost.或者，如果您有特定的 IP 或 DNS 转到 http://IP_address 或 http://DNS_name。
   
   您会被重定向到 Apigee 配置文件数据库配置页面。
   
   注意：通常情况下，您应该已经配置并注册了主机名 与 DNS 服务器相关联，这样就不必使用 http://localhost。
7. 配置与 MySQL 的连接。如果 MySQL 位于远程机器上，请展开 Advanced Options（高级选项）部分，然后输入该计算机的连接信息。 然后选择保存并继续。
8. 输入以下信息，配置与 Apigee Endpoint 的连接 然后选择保存：
   有关这些值的详细信息，请参阅“开始安装前需要提供的信息” 请访问开发者服务门户 要求。
   1. 开发门户组织
   2. 开发门户端点网址
   3. 通过端点进行身份验证的用户
   4. 通过身份验证的用户的密码
9. 出现提示时，选择安装示例 SmartDocs WADL 按钮进行安装 示例 SmartDocs WADL。如果您跳过此步骤，则示例 SmartDocs API 不会 。
   注意：如果您的门户连接到安装的 Apigee Edge for Private 并且 Edge 的安装没有外部互联网连接，则必须执行 。有关 如需了解 SmartDocs，请参阅 http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis。
10. 配置 SMTP 服务器设置。Apigee 要求您配置 SMTP 服务器以从该门户发送电子邮件。
    如需了解详情，请参阅 http://apigee.com/docs/developer-services/content/configuring-email。
11. 通过输入以下信息来配置管理员用户，然后选择 保存。请注意，Drupal 会创建一个名为“admin”的管理员用户因此请勿使用“admin”为 用户名。
    如果跳过此步骤，您仍然可以使用 Drush 创建管理员（如下所述）。 4.创建管理员用户。
    1. 开发者的名字和姓氏
    2. 开发者的门户用户名
    3. 密码
    4. 电子邮件地址
12. 安装完成后，请在 settings.php 文件中设置权限：
    &gt;chmod 640 /var/www/html/sites/default/settings.php
13. 前往 http://localhost/ 前往门户首页，或前往 你的门户
14. 使用管理员凭据登录门户。

4. 创建管理员用户

使用 Drush 创建管理员用户，以便安装开发者渠道服务。 Drupal 会自动创建名为“admin”的管理员用户因此请勿使用“admin”用作 用户名。

1. CD 复制到您的 drupal_root/sites/default 目录。Drupal 根的标准位置 目录为 /var/www/html：
   &gt;cd &lt;drupal_root&gt;/sites/default
2. 确保您对私有 Drupal 文件具有写入权限：
   &gt;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
3. 输入以下命令以创建管理员用户，并将“< >”值为：
   &gt;drush 用户创建 <用户名>--mail=&quot;&lt;email-address&gt;&quot;--password=&quot;&lt;password&gt;&quot;
   &gt;drush 用户添加角色管理员 <用户名>
4. 使用指定的用户名和密码以管理员身份登录开发者门户 。

5. 设置 MySQL root 密码

如果您在门户安装过程中安装了 MySQL，则安装脚本会将 MySQL root 密码已设置为默认值（留空）。

使用以下命令设置 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 菜单中选择 Modules 并向下滚动到 更新管理器模块。如果未启用，请启用。

启用后，您可以使用报告 >可用 更新菜单项。您还可以使用以下 Drush 命令：

> drush pm-info update

使用报告 >可用更新 >Settings 菜单项进行配置 该模块在有可用更新时向您发送电子邮件，并设置检查 更新。

7. 可选 - 在生产环境中部署 服务器

如果您要在生产服务器上部署门户，则应执行额外的安全措施 包括：

1. 运行以下脚本以保护您的 MySQL 安装：
   &gt; /usr/bin/mysql_secure_installation
   
   此脚本会设置 root 密码，并允许您选择将 root 访问权限限制为仅限 localhost 以及默认创建的测试数据库和匿名用户。运行 脚本。
2. 如果贵公司政策有相关要求，请启用并配置 SELinux。

8. 可选 - 配置 Apache Solr 搜索引擎

默认情况下，在以下情况下，连接到 Apache Solr 搜索引擎的 Drupal 模块处于停用状态 您需要安装该门户大多数门户都使用内部 Drupal 搜索引擎，因此不使用 需要使用 Drupal Solr 模块。

如果您决定使用 Solr 作为搜索引擎，必须在服务器本地安装 Solr 然后在该门户上启用并配置 Drupal Solr 模块。

如需启用 Drupal Solr 模块，请执行以下操作：

1. 以拥有管理员或内容创建权限的用户身份登录门户。
2. 在 Drupal 菜单中选择 Modules。
3. 启用 Apache Solr Framework 模块和 Apache Solr Search 模块。
4. 保存更改。
5. 按照 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 目录。