安装 ArcGIS Web Adaptor

ArcGIS Web Adaptor 可通过提供的安装程序进行安装，该程序可以通过名为 Setup.exe 实用程序运行，或通过 Windows Installer 命令行参数静默安装。

ArcGIS Web Adaptor 可通过提供的安装程序进行安装，该程序可以通过名为 Setup.sh 的实用程序运行，或通过命令行参数静默安装。

安装要求

ArcGIS Web Adaptor 的版本必须与服务器站点或门户的版本相匹配。
ArcGIS Web Adaptor 可以与其他版本并行安装。除非升级到较新版本，否则无需卸载 ArcGIS Web Adaptor。
每个 ArcGIS Web Adaptor 必须拥有唯一名称；单个 web 服务器上不能有两个名称相同的 Web Adaptor。若在安装过程中检测到命名冲突，则将显示警告消息。若要解决此冲突，您必须卸载同名的较早版本。或者，可以更改其中一个 Web Adaptor 的名称，然后继续安装。
如果您通过浏览器使用服务器站点或门户配置 Web Adaptor，则 ArcGIS Web Adaptor 和 Tomcat 无需安装在同一台计算机上。但是，如果您使用 configurewebadaptor.exe 工具配置 Web Adaptor，则 Web Adaptor 必须和 Tomcat 安装在同一台计算机上。

注:

确保使用管理权限启动 Tomcat 或者要在其中部署 ArcGIS Web Adaptor 实例的任何应用程序服务器。否则，将 ArcGIS Web Adapter 注册到 ArcGIS Server 的操作将失败。

如果您通过浏览器使用服务器站点或门户配置 Web Adaptor，则 ArcGIS Web Adaptor 和 Tomcat 无需安装在同一台计算机上。但是，如果您使用 configurewebadaptor.sh 工具配置 Web Adaptor，则 Web Adaptor 必须和 Tomcat 安装在同一台计算机上。

注:

确保使用管理权限启动 Tomcat 或者要在其中部署 ArcGIS Web Adaptor 实例的任何应用程序服务器。否则，将 ArcGIS Web Adapter 注册到 ArcGIS Server 的操作将失败。
在应用程序服务器上部署 ArcGIS Web Adaptor 时，Web Adaptor 配置将写入用户主目录。确保已为用户分配了主目录，且用户具有该目录的读写权限，然后继续操作。

在安装 ArcGIS Web Adaptor 之前

在安装 ArcGIS Web Adaptor 之前，请执行以下操作：

验证系统是否满足所有系统要求。您只能为服务器站点或门户配置一个 Web Adaptor。
启用 IIS 和所需组件。

注意：

要成功安装并配置 ArcGIS Web Adaptor，您必须在安装下一步中指定的先决条件之前启用 IIS 和所需组件。
确保在将要安装 ArcGIS Web Adaptor 的计算机上安装以下先决条件：
- Microsoft Web Deploy 4.0
- ASP.NET Core Runtime - Windows Hosting Bundle 10.x
注:

必须安装 ASP.NET Core Runtime - Windows Hosting Bundle，其中包含 .NET Runtime 和 IIS 支持。

注意：

如果在启用 IIS 和所需组件之前已安装 ASP.NET Core Runtime - Windows Hosting Bundle，则必须使用包安装程序修复包安装。
登录要安装 ArcGIS Web Adaptor 的计算机。

注:

必须以具有管理权限的用户身份登录。
验证您拥有在端口 80 上运行的网站，并在端口 443 启用了 HTTPS。这是为了应对各种加密和未加密的 ArcGIS Enterprise 调用。有关如何创建网站的说明，请参阅 IIS 产品文档。有关设置和使用 HTTPS 的详细信息，请参阅在 Web 服务器上启用 HTTPS。

注:

使用默认 HTTPS 端口 443 适用于绝大多数用户。在极少数情况下，由于组织特定原因，ArcGIS Web Adaptor 实例无法在其 web 服务器上使用端口 443。如果您的组织存在上述问题，请参阅使用门户 ArcGIS Web Adaptor 的非默认端口，其中详细介绍了配置解决方法的其他步骤。
关闭所有应用程序。
浏览至包含 ArcGIS Web Adaptor 安装程序的下载文件夹。也可以将 ArcGIS Server 或 Portal for ArcGIS 介质插入相应的驱动器以自动启动安装程序。

接下来即可开始执行 ArcGIS Web Adaptor 安装。

注意：

尝试配置 ArcGIS Web Adaptor 以使 URL 包括其他级别不受支持，并可能导致客户端应用程序出现问题。

验证系统是否满足所有系统要求。您只能为服务器站点或门户配置一个 Web Adaptor。
登录要安装 ArcGIS Web Adaptor 的计算机。

注:

必须以具有管理权限的用户身份登录。
验证您拥有在端口 80 上运行的网站，并在端口 443 启用了 HTTPS。这是为了应对各种加密和未加密的 ArcGIS Enterprise 调用。有关如何创建网站的说明，请参阅特定于您的 Java 应用程序服务器的产品文档。有关设置和使用 HTTPS 的详细信息，请参阅在 Web 服务器上启用 HTTPS。

注:

使用默认 HTTPS 端口 443 适用于绝大多数用户。在极少数情况下，由于组织特定原因，ArcGIS Web Adaptor 实例无法在其 web 服务器上使用端口 443。如果您的组织存在上述问题，请参阅使用门户 ArcGIS Web Adaptor 的非默认端口，其中详细介绍了配置解决方法的其他步骤。
关闭所有应用程序。
浏览至包含 ArcGIS Web Adaptor 安装程序的下载文件夹。也可以将 ArcGIS Server 或 Portal for ArcGIS 介质插入相应的驱动器以自动启动安装程序。

接下来即可开始执行 ArcGIS Web Adaptor 安装。

验证系统是否满足所有系统要求。您只能为服务器站点或门户配置一个 Web Adaptor。
登录要安装 ArcGIS Web Adaptor 的计算机。

注:

必须以具有管理权限的用户身份登录。
验证您拥有在端口 80 上运行的网站，并在端口 443 启用了 HTTPS。这是为了应对各种加密和未加密的 ArcGIS Enterprise 调用。有关如何创建网站的说明，请参阅特定于您的 Java 应用程序服务器的产品文档。有关设置和使用 HTTPS 的详细信息，请参阅在 Web 服务器上启用 HTTPS。

注:

使用默认 HTTPS 端口 443 适用于绝大多数用户。在极少数情况下，由于组织特定原因，ArcGIS Web Adaptor 实例无法在其 web 服务器上使用端口 443。如果您的组织存在上述问题，请参阅使用门户 ArcGIS Web Adaptor 的非默认端口，其中详细介绍了配置解决方法的其他步骤。
浏览至包含 ArcGIS Web Adaptor 安装程序的下载文件夹。也可以将 ArcGIS Server 或 Portal for ArcGIS 介质插入相应的驱动器以自动启动安装程序。

接下来即可开始执行 ArcGIS Web Adaptor 安装。

使用安装程序安装 ArcGIS Web Adaptor

要使用安装程序安装 ArcGIS Web Adaptor，请完成以下步骤：

ArcGIS Web Adaptor 安装程序应在下载完成后自动启动。如果安装程序未自动启动，请浏览至已下载的安装程序文件的位置，并双击 Setup.exe。
阅读主协议，如果同意则接受。单击下一步继续安装。
针对 ArcGIS Web Adaptor 选择一个运行于端口 80 的网站。可用网站将以**<网站名称（端口）>的形式列出。如果未显示选择网站对话框，则这意味着您当前只有一个网站。如果您的计算机上只存在一个网站，则 ArcGIS Web Adaptor 将被自动放置在该网站中，而不会显示选择网站**对话框。
为 Web Adaptor 提供名称。默认值为 arcgis。实例名称中不能包含空格。

注:

如果所选网站中已存在与 Web Adaptor 同名的虚拟目录，则将显示一条消息。单击确定关闭此消息，然后为 Web Adaptor 提供一个不同的名称。
要完成安装，请按照屏幕上的说明执行后续操作。

注:

每个 Web Adaptor 安装都会创建一个应用程序池，其默认命名约定为 ArcGISWebAdaptorAppPool<web adaptor name>。

启动 ArcGIS Web Adaptor 安装程序 Setup.exe，然后阅读欢迎界面和使用条款。准备就绪后请单击下一步继续。
阅读主协议，如果同意则接受。单击下一步继续安装。
单击更改指定安装文件夹或单击下一步接受默认位置。
单击安装开始安装。
单击完成关闭向导。
浏览至 ArcGIS Web Adaptor 安装文件夹。将 arcgis.war 文件部署到运行于端口 80 的网站上的 Java 应用程序服务器上。有关如何部署 .war 文件的说明，请参阅 Java 应用程序服务器的文档。
或者，如果要在主机上部署多个 Web Adaptor，应根据需要重新部署 arcgis.war 文件。请注意，如果在同一个网站（端口）部署多个 Web Adaptor，则它们必须使用不同的名称。例如，名为 arcgis 的两个 Web Adaptor 不能存在于同一个网站中。如果需要多个同名 Web Adaptor，则需在不同的网站（端口）安装它们。
将 ArcGIS Web Adaptor 与服务器站点或门户连接。

安装后，ArcGIS Web Adaptor 将以 Java 应用程序服务器指定的语言显示。要更改语言，请参阅 Java 应用程序服务器的产品文档。

启动 ArcGIS Web Adaptor 安装程序，并评估简介对话框。准备就绪后请单击下一步继续。
阅读主协议，如果同意则接受。单击下一步继续安装。
单击下一步接受默认位置，或单击选择指定安装文件夹。

注:

建议您不要将 ArcGIS Web Adaptor 安装到远程网络驱动器上。如果卸载时远程驱动器无法访问，那么卸载过程可能会失败并导致文件残留在磁盘上。
单击安装开始安装。
安装完成后，请单击完成关闭向导。
浏览至 ArcGIS Web Adaptor 安装文件夹。将 arcgis.war 文件部署到运行于端口 80 的网站上的 Java 应用程序服务器上。有关如何部署 .war 文件的说明，请参阅适用于 Java 应用程序服务器的文档。
或者，如果要在主机上部署多个 Web Adaptor，应根据需要重新部署 arcgis.war 文件。请注意，如果在同一个网站（端口）部署多个 Web Adaptor，则它们必须使用不同的名称。例如，名为 arcgis 的两个 Web Adaptor 不能存在于同一个网站中。如果需要多个同名 Web Adaptor，则需在不同的网站（端口）安装它们。
将 ArcGIS Web Adaptor 与服务器站点或门户连接。

安装后，ArcGIS Web Adaptor 将以 Java 应用程序服务器指定的语言显示。要更改语言，请参阅 Java 应用程序服务器的产品文档。

重复同样步骤，在同一台计算机上同时或在不同计算机上安装多个 ArcGIS Web Adaptor 实例。要在同一个网站（端口）上安装多个 Web Adaptor，它们必须使用不同的名称。例如，名为 arcgis 的两个 Web Adaptor 不能存在于同一个网站中。如果需要多个同名 Web Adaptor，则需在不同的网站（端口）安装它们。

注:

安装程序将检测并防止与 Web Adaptor 名称发生任何冲突。如果显示一条消息，提示虚拟目录已存在，请为 Web Adaptor 指定不同的名称，或选择一个不同的站点。

注:

要应用 Web Adaptor 补丁包，则不能移除基础实例。

静默安装 ArcGIS Web Adaptor

以下命令行是静默安装 ArcGIS Web Adaptor 时要使用的参数。如果在静默安装过程中未调用这些命令行参数，则 ArcGIS Web Adaptor web 应用程序将以默认名称 arcgis 在默认站点下创建。

ACCEPTEULA=yes

在静默安装过程中，需要提供此属性才能接受“最终用户许可协议”。指定“是”将同意 EULA 并安装软件。指定“否”或忽略此属性将导致安装失败。下载内容中包含最终用户许可协议 (EULA) 的 PDF 版本。 EULA.pdf 文件位于 \Documentation 文件夹中。
WEBSITE_ID=<站点的数字值>

WEBSITE_ID 参数用于指定将创建 ArcGIS Web Adaptor web 应用程序的站点。 WEBSITE_ID 的值是特定于服务器上每个站点的数字，该值由 IIS 指定。您可在 IIS 管理器中找到服务器上各站点的 ID。默认网站的网站 ID 为 1。默认情况下，WEBSITE_ID 参数设置为默认站点（即使存在多个站点）。参数 WEBSITE_ID 区分大小写。
PORT=<端口号>

此外，如果站点存在多个端口，请使用 PORT 参数将其安装到 WEBSITE_ID 的指定端口。

例如，路径为 <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb VDIRNAME=arcgis_external WEBSITE_ID=4059640 PORT=82。
VDIRNAME=<ArcGIS Web Adaptor 的名称>

此命令行参数为可选项。默认情况下，VDIRNAME 属性设置为 arcgis。如果命令行中未调用 VDIRNAME 参数，则 Web Adaptor 将以名称 arcgis 创建。参数 VDIRNAME 区分大小写。 Web Adaptor 名称中不能包含空格。

例如，路径为 <path to ArcGIS Web Adaptor (IIS) setup download>\setup.exe /qb ACCEPTEULA=yes VDIRNAME=arcgis_external WEBSITE_ID=4059640。
CONFIGUREIIS=TRUE

此可选参数将允许安装程序以静默方式配置和安装 ArcGIS Web Adaptor 所需的所有缺失 Microsoft IIS 组件。

以下是静默安装 ArcGIS Web Adaptor 时将使用的 Windows Installer 命令行参数：

ACCEPTEULA=yes

在静默安装过程中，需要提供此属性才能接受“最终用户许可协议”。指定“是”将同意 EULA 并安装软件。指定“否”或忽略此属性将导致安装失败。下载内容中包含最终用户许可协议 (EULA) 的 PDF 版本。 EULA.pdf 文件位于 \Documentation 文件夹中。
INSTALLDIR=<安装位置>

该属性用于通过命令行指定 ArcGIS Web Adaptor 的安装位置。如果您没有设置此属性，则使用默认安装位置 C:\Program Files\ArcGIS\WebAdaptor12.0\java\。

例如：

<path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes INSTALLDIR="C:\NewInstallDir" /qb
使用下列命令静默安装 ArcGIS Web Adaptor，而不指定安装位置：

<path to ArcGIS Web Adaptor (Java Platform) setup download>\setup.exe ACCEPTEULA=yes /qb

在安装 ArcGIS Web Adaptor 后，可使用服务器站点或门户对其进行配置。

注:

安装后，ArcGIS Web Adaptor 将以 Java 应用程序服务器指定的语言显示。要更改语言，请参阅 Java 应用程序服务器的产品文档。

要静默安装 ArcGIS Web Adaptor，请完成以下步骤：

在开始安装前，请阅读位于 <CD_ROOT or untar directory>/Documentation/EULA.pdf 的主协议，如果您同意，请接受条款。
在提示符处静默运行安装程序。示例语法：

<CD_ROOT or untar directory>/Setup -m silent -l yes

用法：Setup [选项]

选项	描述
-m; --模式 MODE	可选。默认为 GUI。 MODE 为 silent 或 gui。
-l; --许可协议 CHOICE	静默模式时必须指定。 CHOICE 为 Yes 或 No。Yes 表示您已阅读并同意 Esri 主协议（E204、E300）。要阅读协议，请参阅 https://www.esri.com/legal/licensing-translations。
-d; --目录 DIRECTORY	可选。默认情况下，ArcGIS Web Adaptor 将安装在 $HOME 目录中。 DIRECTORY 可指定其他安装目录。路径 /arcgis/webadaptor12.0/ 追加到安装目录。安装目录的名称应为小写形式。所安装的示例和数据要求数据路径使用小写字母。建议您不要将 ArcGIS Web Adaptor 安装到远程网络驱动器上。如果卸载时远程驱动器无法访问，那么卸载过程可能会失败并导致文件残留在磁盘上。
-v; --详细	安装程序在详细模式下运行。
-h; --帮助	显示命令行帮助并退出。
-e; --示例	显示这些选项的使用说明示例并退出。

浏览至 ArcGIS Web Adaptor 安装文件夹并将相应 .war 文件部署到在端口 80 上运行的网站上的 Java 应用程序服务器。如果您使用的是 Apache Tomcat 10.1.x，则必须部署 arcgis_tomcat10.war 文件。对于 Tomcat 9.0.x 和所有其他 Java 应用程序服务器，必须部署 arcgis.war 文件。有关如何部署 .war 文件的说明，请参阅适用于 Java 应用程序服务器的文档。
或者，如果要在主机上部署多个 Web Adaptor，应根据需要重新部署 .war 文件。如果您正在相同的网站（端口）上部署多个 Web Adaptor，则这些 Web Adaptor 必须使用不同的名称；例如，同一网站上不能有两个名为 arcgis 的 Web Adaptor。如果需要多个同名 Web Adaptor，则需在不同的网站（端口）安装它们。
在安装 ArcGIS Web Adaptor 后，可使用服务器站点或门户对其进行配置。

安装后，ArcGIS Web Adaptor 将以 Java 应用程序服务器指定的语言显示。要更改语言，请参阅 Java 应用程序服务器的产品文档。

通过使用命令行参数运行安装程序，可以安装多个 Web Adaptor。安装多个 Web Adaptor 无需其他命令行参数。