安装后

成功安装 Edge 后,您可能需要执行一些常见任务来验证安装、调整设置和自定义配置。这些任务包括:

任务 说明
在 Edge 组件上调用命令 使用 apigee-service 实用程序启动、停止、重启每个 Edge 组件并获取其状态。
配置 Edge 组件 使用属性文件更改默认 Edge 组件设置。
运行 apigee-validate 调用测试脚本,确保每个组件都已成功安装。
调整 JVM 堆设置 为每个节点优化 Java 内存设置。
管理 LDAP 密码政策 更改默认 LDAP 密码并配置各种身份验证设置。
在节点上安装 apigee-monit 安装并使用一个工具来监控节点上的组件,并在组件发生故障时尝试重启它们。
设置 PostgreSQL 清除作业 删减分析服务收集的多余数据。
设置 Cassandra nodetool 修复 您应该在 Cassandra 环上执行定期维护,以确保所有节点的一致性。
启用自动启动 指示 Edge for Private Cloud 在重启期间自动重启。
安装新版 Edge 界面 Apigee 建议您安装新的 Edge 界面,这是面向 Apigee Edge for Private Cloud 开发者和管理员的增强型界面。

请注意,这些只是您在安装 Edge 后通常执行的一些较常见的任务。如需了解其他操作和管理任务,请参阅如何配置 Edge 和操作。

对 Edge 组件调用命令

Edge 会在 /opt/apigee/apigee-service/bin 下安装管理实用程序,您可以使用这些实用程序来管理 Edge 安装。例如,您可以使用 apigee-all 实用程序启动、停止、重启节点上的所有 Edge 组件或确定其状态:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

使用 apigee-service 实用程序来控制和配置各个组件。apigee-service 实用程序的格式如下:

/opt/apigee/apigee-service/bin/apigee-service component_name action

其中,component_name 用于标识组件。该组件必须位于您执行 apigee-service 的节点上。根据您的配置,component_name 的值可能包括:

  • apigee-cassandra(卡桑德拉)
  • apigee-openldap(打开 LDAP)
  • apigee-postgresql(PostgreSQL 数据库)
  • apigee-qpidd(Qpidd)
  • apigee-sso(边缘单点登录)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server(管理服务器)
  • edge-management-ui(新版 Edge 界面)
  • edge-message-processor(消息处理器)
  • edge-postgres-server(Postgres 服务器)
  • edge-qpid-server (Qpid Server)
  • edge-router(边缘路由器)
  • edge-ui(传统版界面)

除了这些组件之外,您还可以根据配置在 apigee-provision 和 apigee-validate 组件上调用 apigee-service。

例如,如要重启 Edge Router,请执行以下命令:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

您可以通过检查 /opt/apigee 目录来确定节点上安装的组件列表。该目录包含节点上安装的每个 Edge 组件的子目录。每个子目录都带有以下前缀:

  • apigee:Edge 使用的第三方组件。例如:apigee-cassandra。
  • edge:Apigee 的 Edge 组件。例如:edge-management-server。
  • edge-mint:变现组件。例如 edge-mint-management-server。

组件的完整操作列表取决于组件本身,但所有组件都支持以下操作:

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

配置 Edge 组件

如需在安装后配置 Edge,您需要结合使用 .properties 文件和 Edge 实用程序。例如,如需在 Edge 界面上配置 TLS/SSL,您需要修改 .properties 文件以设置必要的属性。对 .properties 文件的更改需要您重启受影响的 Edge 组件。

.properties 文件位于 /opt/apigee/customer/application 目录中。 每个组件在该目录中都有自己的 .properties 文件。 例如,router.properties 和 management-server.properties。

如需为组件设置属性,请修改相应的 .properties 文件,然后重启该组件:

/opt/apigee/apigee-service/bin/apigee-service component restart

例如:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

更新 Edge 时,系统会读取 /opt/apigee/customer/application 目录中的 .properties 文件。这意味着更新会保留您在组件上设置的所有属性。

如需详细了解 Edge 配置,请参阅如何配置 Edge。

在节点上安装 apigee-monit

在节点上完成组件安装后,您可以选择添加 apigee-monit 实用程序。apigee-monit 将监控节点上的组件,并在组件发生故障时尝试重启。 如需了解详情,请参阅使用 apigee-monit 进行自我修复。

将 OpenLDAP 服务器配置为只读

如果您的 Edge 安装包含不需要将流量切换到它的 OpenLDAP 服务器,我们建议您将该服务器配置为只读。为此,请执行以下操作:

  1. 在服务器上创建一个包含以下内容的 mark_readonly.ldif 文件:
    dn: olcDatabase={2}bdb,cn=config
    changetype: modify
    replace: olcReadOnly
    olcReadOnly: TRUE
  2. 在服务器上执行以下命令,将其标记为只读:
    ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

如果主服务器发生故障,您可以切换回使用备用服务器作为主服务器,如下所示:

  1. 在备用服务器上创建一个包含以下行的文件 mark_writable.ldif:
    dn: olcDatabase={2}bdb,cn=config
    changetype: modify
    replace: olcReadOnly
    olcReadOnly: FALSE
  2. 在备用服务器上执行以下命令:
    ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif