Skip to main content

配置 ArcGIS Web Adaptor

安装 ArcGIS Web Adaptor 后，必须对其进行配置以与服务器站点和 ArcGIS Enterprise 门户配合使用。 您可以从随 Web Adaptor 一起安装的配置网页或命令行实用程序来执行相关操作。

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

注:

自 ArcGIS Enterprise 11.5 起，默认启用通过 Web Adaptor 访问 ArcGIS Server 站点的管理权限，并且无法禁用。 对于面向 Internet 的 ArcGIS Enterprise 部署，请考虑使用启用了生产级 Web 应用程序防火墙 (WAF) 的负载均衡器作为前端，而不是 Web Adaptor。 有关详细信息，请参阅 ArcGIS Enterprise 强化指南。

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

注意：

尽管您可以通过注册新的 Web Adaptor 来修改门户的 Web Adaptor，但是执行此操作可能会影响门户内的用户内容（例如，地图注释或其他项目）。

注:

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

使用服务器站点配置 ArcGIS Web Adaptor

以下部分描述如何通过服务器站点从配置页面和命令行实用程序配置 ArcGIS Web Adaptor。

通过配置 Web 页面配置

要通过服务器站点从随软件安装的配置 web 页面配置 ArcGIS Web Adaptor，请执行以下步骤。

注:

此时，还应该检查 ArcGIS Mission Server、ArcGIS Notebook Server 和 ArcGIS Video Server 的其他注意事项。

  1. 在 web 浏览器中打开配置页面。

    URL 格式为 https://webadaptorhost.example.com/webadaptorname/webadaptor。

    注:

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

  2. 选择您要通过 Web Adaptor 配置的服务器类型。 单击下一步。

  3. 输入您在站点中注册的服务器之一的计算机名称。

    该计算机名称将用于查找参与到您的服务器站点中的所有计算机，并将 Web Adaptor 注册到这些计算机中。 计算机名称应采用以下格式 server.example.com。

  4. 为具有服务器站点管理权限的账户提供一个用户名和密码。 通常，您将使用创建站点时定义的主站点管理员账户的用户名和密码。 如果您禁用了主站点管理员账户，则需要指定具有站点管理权限的账户。

  5. 单击配置，将您的设置应用于 Web Adaptor。

配置成功后，Web Adaptor 识别的计算机将列于配置页面的底部（以绿色突出显示）。 您可随时返回到此页面来查看已识别的计算机列表以及调整 Web Adaptor 设置。

从命令行配置

您可以使用 C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools 中的命令行实用程序 (ConfigureWebAdaptor.exe) 将 ArcGIS Web Adaptor 与服务器站点进行配置。

可用参数包括：

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password>

您可以使用 <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools 中的命令行实用程序 (ConfigureWebAdaptor.bat) 将 ArcGIS Web Adaptor 与服务器站点进行配置。

可用参数包括：

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

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

可用参数包括：

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

  • <Mode> - 用于配置 Web Adaptor 的组件。 默认情况下，此参数设置为 server，表示将 Web Adaptor 配置为与服务器站点配合使用。 以下是可用于配置其他组件的参数。

    • Portal for ArcGIS - portal

    • ArcGIS Mission Server - mission

    • Notebook Server - notebook

    • Video Server - video

    • ArcGIS Monitor - monitor

    • ArcGIS Data Pipelines - datapipelines

  • <WebAdaptorURL> - 您想从命令行配置的 Web Adaptor 的 URL。 如果您要在 Web 浏览器中访问 Web Adaptor 配置页面，则使用此 URL。 如果 Web Adaptor 安装在默认 80 之外的其他端口上，则需要在 URL 中指定端口。

  • <MachineName|URL> - 服务器站点中一台计算机的计算机名称，例如 server.example.com。 您也可以使用服务器计算机 URL 来替代计算机名称。 如果您正在使用 ArcGIS Server 配置 Web Adaptor，计算机名称或 URL 将用于查找参与您的站点的所有计算机。

  • <Username> - 拥有服务器站点管理权限的账户的用户名。 对于 ArcGIS Server，此账户可以是首次创建站点时输入的主站点管理员账户，也可以是已分配了管理权限的账户。 对于 ArcGIS Mission Server、Notebook Server 和 Video Server，输入创建站点时使用的主站点管理员账户的用户名。

  • <Password> - 具有服务器站点管理权限的账户的密码。

请参阅以下示例：ConfigureWebAdaptor.exe /m server /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g server.example.com /u siteadmin /p secret

请参阅以下示例：ConfigureWebAdaptor.bat -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

请参阅以下示例：$ ./configurewebadaptor.sh -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

注:

要运行命令行实用程序，托管 Web Adaptor 的计算机上必须存在 Java Runtime Environment (JRE)。 如果计算机上没有 JRE，则运行该实用程序时将会出错。 有关如何下载并在计算机上安装 JRE 的说明，请参阅 Java SE 下载站点。

为门户配置 ArcGIS Web Adaptor

以下部分描述了如何通过配置页面和命令行实用程序为 ArcGIS Enterprise 门户配置 ArcGIS Web Adaptor。

通过配置 Web 页面配置

要通过随软件安装的配置 Web 页面为门户配置 ArcGIS Web Adaptor，请完成以下步骤：

注意：

要在 ArcGIS Server 站点与您的门户关联后添加 DNS 别名或反向代理，请参阅更新组织 URL。

  1. 如果您未执行过此操作，请在 Web 服务器上启用 HTTPS。

  2. 使用 HTTPS URL（如 https://webadaptorhost.example.com/webadaptorname/webadaptor）在 web 浏览器中打开配置页面。 如果将 DNS 别名与门户配合使用，则应使用 https://<dnsalias.example.com>/<webadaptorname>/webadaptor 等 URL 通过 DNS 别名配置 Web Adaptor。

    注:

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

  3. 选择 Portal for ArcGIS，然后单击下一步。

  4. 输入托管 Portal for ArcGIS 的计算机的名称。 包括完全限定域名，例如 portal.example.com。

  5. 为拥有 Portal for ArcGIS 管理权限的账户提供用户名和密码。 通常，需要使用设置门户时定义的初始管理员账户用户名和密码。 如果您已降级或删除初始管理员账户，则必须指定具有门户网站管理权限的账户。

  6. 单击配置。

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

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

如果要使用组织的反向代理服务器配置 Portal for ArcGIS，则必须向门户提供代理服务器的一些相关信息。 有关完整说明，请参阅将您的门户与反向代理或负载均衡器相集成。

从命令行配置

您可以使用 C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools 中的命令行实用程序 (ConfigureWebAdaptor.exe) 通过门户配置 ArcGIS Web Adaptor。

可用参数包括：

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password> -r <ReindexPortal>

您可以使用 <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools 中的命令行实用程序 (ConfigureWebAdaptor.bat) 通过门户配置 ArcGIS Web Adaptor。

可用参数包括：

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

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

可用参数包括：

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

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

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

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

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

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

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

示例：ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g portal.example.com /u initialadmin /p secret -r true

示例：ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

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

在运行该命令后，ArcGIS Web Adaptor 配置为与托管 Portal for ArcGIS 的计算机一起使用。 现在，您将通过 ArcGIS Web Adaptor URL，而非端口 7443 访问门户。 URL 为以下格式：https://webadaptorhost.example.com/webadaptorname/home。

如果要使用组织的代理服务器配置 Portal for ArcGIS，则必须向门户提供代理服务器的一些相关信息。 有关完整说明，请参阅将您的门户与反向代理或负载均衡器相集成。

配置多个 ArcGIS Web Adaptor

配置使用 web 层身份验证的高可用性门户时，会需要多个 ArcGIS Web Adaptor。 要使用 Portal for ArcGIS 配置多个 Web Adaptor，必须使用单一端点来访问门户。 必须在 WebContextURL 属性中定义该 URL。 然后即可按照下列步骤使用门户对多个 Web Adaptor 进行配置。

  1. 使用您的门户配置第一个 ArcGIS Web Adaptor。

  2. 将 Portal for ArcGIS 添加至反向代理服务器。 按如下所示设置 WebContextURL 属性：

    1. 打开 web 浏览器并以组织管理员的身份登录到 Portal Administrator Directory。

      URL 地址格式为 https://portal.example.com:7443/arcgis/portaladmin。

    2. 单击系统 > 属性 > 更新属性。

      Portal for ArcGIS 服务会自动重新启动。 等待重新启动完成，然后继续操作。

    3. 在更新系统属性对话框中，插入以下 JSON，将您的反向代理服务器或 DNS 别名 URL 替换为组织防火墙以外的用户所看到的 URL：

       {
      "WebContextURL": "https://reverseproxy.example.com/myorg"
   }
    1. 单击更新属性。

  3. 配置附加 Web Adaptor。

通过门户配置的所有 Web Adaptor 都将在配置摘要页面中列出 用户可通过反向代理服务器或 DNS 别名 URL 访问门户。

注:

Portal for ArcGIS 仅支持单个组织 URL。

配置 ArcGIS Web Adaptor 之后

配置 ArcGIS Web Adaptor 进行使用后，请考虑以下项目。

添加或移除服务器计算机

如果在站点中添加或移除服务器计算机，Web Adaptor 需要 1 分钟的时间来识别站点的更改。 如果希望 Web Adaptor 立即识别已添加或移除的计算机，可以按照上述说明重新进行配置。

安装多个 Web Adaptor

您可以通过安装多个 Web Adaptor 来提供访问服务器站点的不同 Web 入口点。 这样做可以使站点对客户端具有更高的可用性，为传统应用程序提供支持，并允许在高度安全的环境中由特定用户发布。 有关详细信息，请参阅部署方案。

可以同时在同一台计算机上安装多个 Web Adaptor，或在多个单独的计算机上进行安装。 要在同一网站（端口）上安装多个 Web Adaptor，需要为其提供不同的名称。 例如，名为 arcgis 的两个 Web Adaptor 不能存在于同一个网站中。 如果需要多个同名 Web Adaptor，则需在不同的网站（端口）安装它们。