Skip To Content

配置 ArcGIS Web Adaptor

ArcGIS Web Adaptor 安装完成之后,您必须对其进行配置,以使其与 ArcGIS Enterprise 门户配合使用。 您可以从随 ArcGIS Web Adaptor 安装的配置 Web 页面或命令行实用程序来执行相关操作。 作为一项安全性措施,您只能通过托管 ArcGIS Web Adaptor 的计算机访问配置页面。

打开配置页面时,会显示 ArcGIS Web Adaptor 的当前状态。 这将指示之前是否已对 ArcGIS Web Adaptor 进行配置。 要查看 ArcGIS Web Adaptor 的平台类型和版本号,请在配置页面上单击关于

如果您已使用 ArcGIS Enterprise 门户配置 Web Adaptor 并且想要更新门户以使用其他 Web Adaptor,则必须首先注销当前的 Web Adaptor。 只能通过 Portal Directory 执行该操作;注销功能在配置页面或门户网站上不可用。 有关详细说明,请参阅取消将 ArcGIS Web Adaptor 注册到 Portal for ArcGIS

警告:

尽管您可以通过注册新的 Web Adaptor 来修改门户的 Web Adaptor,但是请注意,这样做可能会影响门户内的用户内容(例如,地图注释或其他项目)。

有关如何配置 ArcGIS Web Adaptor 的完整说明,请按照以下步骤执行操作。

注:

使用默认 HTTPS 端口 443 适用于大多数用户。 在极少数情况下,由于组织特定原因,ArcGIS Web Adaptor 实例无法在其 web 服务器上使用端口 443。 如果您的组织存在上述问题,请参阅使用门户 ArcGIS Web Adaptor 的非默认端口,其中详细介绍了配置解决方法的其他步骤。

通过配置 Web 页面配置 ArcGIS Web Adaptor

要通过随软件安装的配置 Web 页面配置 ArcGIS Web Adaptor,请执行以下步骤:

警告:

不支持在将 ArcGIS Server 站点与您的门户联合后添加 DNS 别名或反向代理。 如果需要在组织 URL 中更改主机名,请联系 Esri 专业服务或其他受信任的咨询合作伙伴以获取指导。

  1. 如果您未执行过此操作,请在 Web 服务器上启用 HTTPS
  2. 使用 HTTPS URL(如 https://webadaptorhost.domain.com/webadaptorname/webadaptor)在 web 浏览器中打开配置页面。 如果将 DNS 别名与门户配合使用,则应使用 https://<dnsalias.domain.com>/<webadaptorname>/webadaptor 等 URL 通过 DNS 别名配置 Web Adaptor。
    注:

    如果您在安装了 ArcGIS Web Adaptor 的 Web 服务器上运行了转发代理,则请在注册 Web Adaptor 时将其禁用。 否则,您将无法访问 Web Adaptor 配置页面。

  3. 选择 Portal for ArcGIS,然后单击下一步
  4. 输入托管 Portal for ArcGIS 的计算机的名称。 包括完全限定域名,例如,portal.domain.com
  5. 为具有 Portal for ArcGIS 管理权限的帐户提供一个用户名和密码。 通常,需要使用设置门户时定义的初始管理员帐户用户名和密码。 如果您已降级或删除初始管理员帐户,则必须指定具有门户网站管理权限的帐户。
  6. 单击配置

ArcGIS Web Adaptor 已被配置为与托管 Portal for ArcGIS 的计算机配合使用。 现在,您将通过 ArcGIS Web Adaptor URL 而非端口 7443 访问门户。 URL 为以下格式:https://webadaptorhost.domain.com/webadaptorname/home

如果已将门户配置为在所有通信中使用 HTTPS,则应将安装的门户网站和帮助快捷方式 URL 更新为使用 https 而不是 http; 否则在尝试访问原始快捷方式 URL 时浏览器会显示失败。

如果要为 Portal for ArcGIS 配置组织的反向代理服务器,则必须向门户提供代理服务器的一些相关信息。 有关完整说明,请参阅在门户中配置反向代理服务器

从命令行配置 ArcGIS Web Adaptor

您可以使用 <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools 中的命令行实用程序 (configurewebadaptor.sh) 配置 ArcGIS Web Adaptor。 如果托管 ArcGIS Web Adaptor 的计算机不具有图形用户界面 (GUI),则这种方法尤其有用。

可用参数包括:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

  • <Mode> - 用于配置 ArcGIS Web Adaptor 的组件。 默认情况下,此参数被设置为 server,表示将 ArcGIS Web Adaptor 配置为与 GIS Server、Image Server 或 GeoAnalytics Server 配合使用。 由于您想将 ArcGIS Web Adaptor 配置为与 Portal for ArcGIS 配合使用,请将此参数指定为 portal

  • <WebAdaptorURL> - 您想从命令行配置的 ArcGIS Web Adaptor 的 URL。 此 URL 与在 Web 浏览器中访问配置页面使用的 URL 相同。 您需要指定 ArcGIS Web Adaptor 的 HTTPS URL,例如,https://webadaptorhost.domain.com/webadaptorname/webadaptor。 如果将 DNS 别名与门户配合使用,则应使用 https://<dnsalias.domain.com>/<webadaptorname>/webadaptor 等 URL 通过 DNS 别名配置 Web Adaptor。

  • <MachineName|URL> - 托管 Portal for ArcGIS 的计算机的名称。 在计算机名称中加入计算机的完全限定域名,例如 portal.domain.com。 您还可以使用托管 Portal for ArcGIS 的计算机的 URL 来代替计算机名称。

  • <Username> - 具有 Portal for ArcGIS 管理权限的帐户用户名。 该帐户可以是首次设置门户时输入的初始管理员帐户,也可以是分配了管理权限的帐户。

  • <Password> - 具有 Portal for ArcGIS 管理权限的帐户的密码。

  • <ReindexPortal> - 指示是否在注册 Web Adaptor 时为门户中的默认内容重新构建索引。 如果打算使用反向代理或负载均衡器配置部署,此选项将十分有用。 Web Adaptor 注册花费时间较少,无需构建索引。 配置 webContextURL 后,内置内容将引用 webContextURL

例如:ConfigureWebAdaptor.sh -m portal -w https://webadaptorhost.domain.com/webadaptorname/webadaptor -g portal.domain.com -u initialadmin -p secret -r true

执行命令后,ArcGIS Web Adaptor 已被配置为与托管 Portal for ArcGIS 的计算机配合使用。 现在,您将通过 ArcGIS Web Adaptor URL 而非端口 7443 访问门户。 URL 为以下格式:https://webadaptorhost.domain.com/webadaptorname/home

如果要为 Portal for ArcGIS 配置组织的代理服务器,则必须向门户提供代理服务器的一些相关信息。 有关完整说明,请参阅在门户中配置代理服务器