安装后

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

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

请注意,这些只是您在安装 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-provisionapigee-validate 组件调用 apigee-service

例如,要重启边缘路由器,请执行以下命令:

/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.propertiesmanagement-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