Skip to main content

常见部署问题

本主题解答有关 ArcGIS Enterprise 安装与升级的常见部署问题。 以下附加主题包含常见规划与管理问题。

部署问题

ArcGIS Server

以下是有关 ArcGIS Server 的常见问题。

Portal for ArcGIS

以下是有关 Portal for ArcGIS 的常见问题。

ArcGIS Data Store

ArcGIS Enterprise Builder

以下疑难解答提示可帮助您解答一些常见的 ArcGIS Enterprise Builder 安装问题。

当尝试安装 ArcGIS Server、ArcGIS Data Store 或 Portal for ArcGIS 时，我看到一条错误消息，该消息指示“解压文件时出现意外错误。 请检查是否缺少卷文件。 错误代码 1 -2147467259。”

ArcGIS Server、ArcGIS Data Store 和 Portal for ArcGIS 组件使用自解压包，这些包由两个扩展名分别为 .exe 和 .exe.001 的文件组成。 要提取这些安装程序包，请确保两个文件位于同一文件夹中。

为何会在卸载完成之后遗留一些文件夹？

卸载 ArcGIS Server 时，一些文件夹和文件会保留在磁盘中。 这些文件便于重新安装或进行产品升级时使用。 如果不打算重新安装，可删除这些文件。

您可能会注意到位于 <ArcGIS Server installation directory>/arcgis/server/usr 的永久文件，其中包括以下内容：

您可能会注意到位于 <ArcGIS Server installation directory>\arcgisserver 的永久文件，其中包括以下内容：

  • 服务器目录

  • 配置存储

  • 日志文件

留下这些文件夹可保留地图缓存、安装配置以及其他在执行重新安装时可能希望保留的服务器资源。 自行创建和注册的服务器目录同样不会受到卸载操作的影响。

在配置数据存储时，我收到了消息无法连接到计算机上的服务器。 此时该计算机上的 ArcGIS Data Store 或 GIS Server 可能未在运行或该计算机不可访问。

ArcGIS Data Store 无法使用提供的 URL 连接到 GIS Server 站点。 检查以下各项并再次尝试：

  • 确保 URL 是正确的。 URL 格式必须为 https://gisserver.example.com:6443。

  • 确认 GIS Server 站点正在运行。

在配置数据存储时，我收到了消息无法配置数据存储计算机。 ArcGIS Data Store 和 ArcGIS Server 必须是同一发行版本。

ArcGIS Server 和 ArcGIS Data Store 必须处于同一版本。 您可以将 GIS Server 站点升级到与 ArcGIS Data Store 相同的版本，或者安装并配置与 GIS Server 站点相匹配的 ArcGIS Data Store 版本。

当升级使用 Webhook 的 ArcGIS Enterprise 部署的所有部分后，ArcGIS Data Store 日志文件中将显示以下一条或多条消息，并且 Webhook 也无法正常运行：

  • Severe Webhook log: Error in Webhook Processor. init WebhookProcessors failed. FS Webhook processor init failed Connecting to queue : <ID>

  • Could not create a queue with id : <ID>

  • SEVERE Failed to configure queue store.

您可能需要在关系存储计算机上运行修复操作。 如需帮助，请联系 Esri 技术支持（美国）或者您所在地区的当地分销商（美国境外）。

启动 ArcGIS Server 时，系统发出警告，内容是此计算机的 /etc/hosts 条目与计算机的 IP 地址不匹配。

ArcGIS Server 具有多个进程，相互之间进行通信。 因此，计算机的 IP 地址必须正确，以保证那些组件正常工作。

该问题有两种解决方法：

  • 从计算机的 hosts 文件中移除该条目。

  • 如果该条目在您所在的组织中具有其他用途，请更新 IP 地址。 要进行这些更改，需要超级用户访问权限。 要获取当前 IP 地址，请运行 ifconfig 命令。 然后，在文本编辑器中打开 /etc/hosts，删除或修改该行。

是否会创建安装日志文件？

是。 将在 <ArcGIS Server 安装目录>/.Setup/ 目录中生成安装日志文件。 安装过程中生成的安装日志文件为 ArcGISServer_InstallLog.log。

安装 ArcGIS Server 之前是否需要备份任何内容？

升级至 ArcGIS Server 时，计算机会保留所有服务、站点信息和安全设置。 但是，建议您在安装软件之前备份数据。

注:

如果升级 ArcGIS Server，则将保留之前在 init_user_param.sh 脚本中定义的信息。 但是，不会列出在更新的软件中脚本提供的新参数。 为包括所有新功能，请查看为 ArcGIS Server 设置环境变量中所列信息，并将变量手动添加到现有脚本。

注:

如果与正在升级的服务器连接的活动目录部署包含多个域控制器，但不是所有的域控制器都配置为全局目录服务器，则需要在执行安装后手动指定 ArcGIS Server 使用的域控制器。 有关完整说明，请参阅配置 ArcGIS Server 使用的域控制器。

在启动安装程序时，收到一条提示消息：“由于 ArcGIS Server 不支持计算机名称中带有下划线 (_) 的计算机，因此无法进行安装。”

多个广泛应用的 Internet 主机名规范已将下划线指定为非标准字符。 虽然 Windows 允许将下划线用于计算机名，但当您与其他服务器和平台进行交互时，仍会产生问题。 因此，如果服务器的主机名中含有下划线，则 ArcGIS Server 将不会继续进行安装。

弹出一个对话框，告知缺少依赖项。

.NET 扩展模块支持功能需要相应版本的 Microsoft .NET。

如果未找到相应版本的 Microsoft .NET，则无法安装 .NET 扩展模块支持功能。

如果您的操作系统包含相应版本的 Microsoft .NET，请确保已使用 Windows 功能将其启用。 如果您的操作系统不包含 Microsoft .NET，则可从安装介质上进行下载并使用 Windows 功能将其启用。

有关当前支持的 Microsoft .NET 版本，请参阅 ArcGIS Server 系统要求。

如何创建安装日志？

您可在本地计算机的任意位置创建日志。 以下示例会在 C 盘上创建安装日志。

msiexec /I <path to the ArcGIS Server media or download folder>setup.msi /L*V C:\ArcGIS_Server.log

注:

Windows Installer 要求“系统”账户具有完全控制系统驱动器和目标驱动器的能力。

如何安装用于 ArcGIS Server 的自定义字体？

ArcGIS Server 仅支持 TrueType 字体和 OpenType 字体。 为使字体在 GIS 服务内成功使用，字体必须位于服务器上或嵌入 GIS 资源中。 例如，大部分字体可嵌入地图文档，但有时可能会遇到图层使用的字体无法嵌入的情况。 发布时，ArcGIS Pro 中将显示一条警告消息 (20025)，表示图层使用的字体无法嵌入且不在服务器上。

要解决此问题，请直接在 ArcGIS Server 站点的计算机上安装字体。 要执行此操作，请复制要使用的字体并将其置于 <ArcGIS Server 安装目录>/arcgis/server/fonts 目录中。 确保运行 ArcGIS Server 的账户对字体文件具有读取权限。 要使更改生效，必须重新启动 ArcGIS Server。

安装 ArcGIS Server 后，发现在搜索[用户\角色]:[IP 地址]:3268 时出错。

如果将 ArcGIS Server 配置为使用 Microsoft 活动目录中管理的用户和角色实施安全性保护，它可使用活动目录全局目录获取用户和角色的信息。 但是，如果 ArcGIS Server 与绑定的域控制器未同时用作全局目录，则 ArcGIS Server 无法实施安全性保护。 这种情况下，需要在安装完成后手动指定 ArcGIS Server 使用的域控制器。 有关完整说明，请参阅配置 ArcGIS Server 使用的域控制器。

如何更改 ArcGIS Server 账户？

安装 ArcGIS Server 后，可以通过使用 configureserviceaccount 实用程序更改账户。 此实用程序随 ArcGIS Server 安装程序提供，可通过单击开始 > ArcGIS > ArcGIS Server > 配置 ArcGIS Server 账户启动。

不应使用操作系统工具手动更改 ArcGIS Server 账户。 该实用程序旨在对部署中的所有计算机上的各个目录应用权限。 手动更改账户可能会引起服务器故障，从而导致系统停止运行。

有关如何使用实用程序更改 ArcGIS Server 账户的完整说明，请参阅更改 ArcGIS Server 账户。

我担心主站点管理员密码重置 (PasswordReset.bat) 脚本的安全影响。 关于此问题，我该怎么做？

如果处于高度安全的环境下，应该限制对配置存储的文件权限并禁用主站点管理员账户。 执行这两项任务可确保主站点管理员账户密码重置脚本不会对站点的安全性产生影响。

有关详细信息，请参阅配置安全环境的最佳做法。

如何设置对 ArcGIS Server 在运行时创建的文件的访问权限？

只有运行 ArcGIS Server 的账户才能访问 ArcGIS Server 在运行时生成的文件。 要更改运行时生成的文件（如服务器日志）的访问权限，必须在 init_user_param.sh 脚本中设置用户文件模式创建掩膜 (umask)。 要编辑此脚本，请导航至 <ArcGIS Server 安装目录>/arcgis/server/usr 目录。

  • 默认情况下，将 umask 设置为 077，这意味着其他用户无法读取或将数据写入运行时文件。 这对于大多数私有 ArcGIS Server 系统来说已足够。

  • 如果将 umask 设置为 022，则仅允许运行 ArcGIS Server 的账户读取和写入数据。 但是，系统中的任何人均可读取数据。

  • 当运行 ArcGIS Server 的账户与同组中的其他用户共享数据时，最好将 umask 设置为 002。 请注意，运行 ArcGIS Server 的账户所属组的成员也可以创建和修改数据文件。 不允许组外的用户创建和修改数据文件。

  • 将 umask 设置为 007 时，可完全排除非运行 ArcGIS Server 的账户组成员的用户。

修改访问权限后，必须立即重新启动 ArcGIS Server 才能使更改生效。 请注意，将 umask 设置修改为 077 以外的值之后，即改变了 ArcGIS Server 在运行时创建的所有文件的访问权限。

如何在我的 ArcGIS Server 站点中查看计算机的当前硬件规格？

ArcGIS Server Administrator Directory 中的硬件配置资源将显示 ArcGIS Server 站点中指定计算机的硬件信息，提供 CPU 和操作系统的规格、系统内存量以及物理和逻辑处理器数量。 当该资源检测到计算机配置发生变化时以及每次重新启动计算机时，它会更新信息。

当尝试将数据库注册到 ArcGIS Server 时，收到错误消息数据库连接无效或数据项无法访问。

如果在服务器计算机上找不到数据库客户端软件或库，可能会出现这些错误。 ArcGIS Server 站点中的每台计算机必须安装 64 位版本的数据库客户端软件，才能允许 ArcGIS Server 访问数据库。 必须安装这些客户端才能在 ArcGIS Server 中注册数据库。 有关详细信息，请参阅数据库客户端。 安装数据库客户端软件后，重启 ArcGIS Server 服务。

ArcGIS Web Adaptor 无法识别不可用的计算机或之前添加到站点的新计算机。

默认情况下，ArcGIS Web Adaptor 每分钟都会检查站点中是否存在新计算机或不可用计算机。 如果自添加、移除或禁用计算机后等待已超过一分钟，Web Adaptor 仍无法识别这些变化，则可能是因为您更改了最初将 Web Adaptor 注册到站点的用户的属性。

例如，如果已禁用将 ArcGIS Web Adaptor 注册到站点时所用的账户、更改了密码或已将角色类型降级为不具有管理权限的角色，则 Web Adaptor 将无法检查站点的新计算机或不可用计算机的状态。 要解决此问题，需要重新配置 Web Adaptor。 有关完整说明，请参阅使用服务器站点配置 ArcGIS Web Adaptor。

如何更改 ArcGIS Server 使用的临时目录？

临时目录的默认位置是 <ArcGIS Server installation directory>/arcgis/server/temp。 要指定不同的临时目录，请在 init_user_param.sh 脚本中设置 SERVER_TEMP_DIR 变量。 要编辑此脚本，请浏览至 <ArcGIS Server installation directory>/arcgis/server/usr 目录。 移除 SERVER_TEMP_DIR 环境变量前的 # 符号，然后指定新临时目录的位置。 指定的位置必须可供用于安装 ArcGIS Server 的账户访问。

# -----------------------------------------------------------------------
# Modify this section to change the temp directory
#
# The default location for the temp directory is at
# <ArcGIS Server installation directory>/arcgis/server/temp.
# The specified directory needs to be accessible by the account
# that was used to install ArcGIS Server.
# -----------------------------------------------------------------------
#SERVER_TEMP_DIR=<Location_to_temp_directory>

为使您的设置在 init_user_param.sh 脚本中生效，必须重新启动 ArcGIS Server。 要重新启动，请在站点中的每台计算机上运行 startserver.sh 脚本。

在安装用户的文件句柄限制少于 65,535 的情况下，为什么安装程序阻止安装 Portal for ArcGIS？

为使门户能够正常运行，安装用户需要将文件句柄限制设置为 65535。 安装诊断工具将检查这些限制在 /etc/security/limits.conf 文件中是否设置正确。 如果限制设置错误，则诊断检查将失败。

Linux 上有文件句柄的软限制和硬限制。 要确定这些限制，请使用以下命令：

  • 软限制：ulimit -Sn

  • 硬限制：ulimit -Hn

要增加软限制和硬限制，您需要使用超级用户访问权限编辑 /etc/security/limits.conf 文件。 例如，可在该文件中添加两个行，如下所示：

<Portal for ArcGIS installation user> soft nofile 65535

<Portal for ArcGIS installation user> hard nofile 65535

做出此更改后，需要登出并以特定用户信息的身份重新登录，以便新值生效。 要验证限制是否已正确修改，可以使用上述 ulimit -Sn 和 ulimit -Hn 命令。

如果安装文件夹名称超过 34 个字符，则在安装或升级 Portal for ArcGIS 时不会创建门户服务。 如何解决这一问题？

下载以下 Esri 知识库文章中提供的转换文件 (.mst)，并在静默安装或升级过程中使用以下 TRANSFORMS 命令行参数应用该文件：

<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes TRANSFORMS=<path to the transform file>\portalfix.mst

升级之后，组织无法正确显示、显示错误消息或无法登录。 这是什么原因？

清除您的浏览器缓存（包括 cookie）。 这些错误通常是由于浏览器中存在先前版本网站的信息所导致的。 如果仍无法登录，请确认您使用的是初始管理员账户或具有组织管理权限的账户。

升级之后，没有显示门户中的所有项目、群组和用户。 这是怎么回事？

安装软件并指定初始管理员账户后，您必须为门户重新构建索引。 完成此步骤后，门户即升级完毕。 最初可能无法显示所有项目、群组以及用户，这是因为索引重新构建尚未完成。 完成索引的重新构建可能会花费一些时间，具体取决于组织中的用户数量和内容体积。 例如，在 8 核计算机上运行 Portal for ArcGIS 的小型组织（包含数百个用户及内容项目）可能需要花费 15 分钟来重新构建索引。 而在 8 核计算机上运行 Portal for ArcGIS 的大型组织（包含数万个用户及内容项目）可能需要花费 3 个小时以上来重新构建索引。

通过以下步骤可检查重新构建索引的状态。 当存储与索引计数相等时，即完成索引重新构建以及升级过程。

  1. 打开 Portal Administrator Directory 并使用初始管理员账户进行登录。 URL 地址格式为 https://portal.example.com:7443/arcgis/portaladmin。

  2. 单击系统 > 索引器 > 索引状态。

  3. 刷新页面获取最新状态。

升级 Portal for ArcGIS 并尝试创建初始管理员账户时，收到消息创建初始管理员账户时出错。 如何解决这一问题以完成升级？

门户日志中的信息可以帮助您解决此问题。 如果创建账户时网络连接暂时丢失，则会发生此错误。 要访问日志，请浏览至日志目录并打开最近的日志文件（例如 C:\arcgisportal\logs\<machine name>\portal\portal-20141201.095803-8596-0.0.log）。 如有必要，美国境内用户可以联系 Esri 支持，国际用户可以联系其分销商以获取更多帮助。

升级 Portal for ArcGIS 并尝试创建初始管理员账户时，收到消息创建初始管理员账户时出错。 如何解决这一问题以完成升级？

门户日志中的信息可以帮助您解决此问题。 如果创建账户时网络连接暂时丢失，则会发生此错误。 要访问日志，请浏览至日志目录并打开最近的日志文件（例如 <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20141201.095803-8596-0.0.log）。 如有必要，美国境内用户可以联系 Esri 支持，国际用户可以联系其分销商以获取更多帮助。

升级后，当我打开组织 > 设置 > ArcGIS Online 以更新订阅者和高级 ArcGIS Living Atlas of the World 内容时，我看到一条错误消息，指示凭据无效或 ArcGIS Online 无法访问。 出现了什么问题，我应如何解决这些问题？

组织必须验证您的 ArcGIS Online 凭据，才能更新订阅者和高级 ArcGIS Living Atlas 内容。 否则，将在接口和托管服务器的日志中返回以下消息之一：

  • 用于访问订阅者和/或高级 Living Atlas 内容的凭据无效。 升级 Living Atlas 内容前，请使用有效 ArcGIS Online 组织账户凭据更新凭据。- ArcGIS Enterprise 已连接到 ArcGIS Online 组织，并已确定您的现有凭据无效。 确保您的 ArcGIS Online 账户密码未更改并且该账户仍有可用配额（适用于高级内容）。

    如果密码已更改，或者您需要提供一个新账户从 ArcGIS Online 访问订阅者和高级 ArcGIS Living Atlas 内容，则需要更新凭据。 如果您已更新凭据作为升级 Portal for ArcGIS 的一部分，请单击升级内容以完成 ArcGIS Living Atlas 内容升级。

  • 无法从此门户访问 ArcGIS Online。 升级 Living Atlas 内容前，请检查您的防火墙设置或门户代理设置。- ArcGIS Enterprise 无法连接到与您的凭据相关联的 ArcGIS Online 账户。 在大多数情况下，这是由于您的网络上存在阻止与 ArcGIS Online 进行通信的问题。

  • 无法验证用于访问订阅者和/或高级 Living Atlas 内容的凭据，因此，您无法升级内容。 请联系 Esri 技术支持或您的国际分销商。- 在极少数情况下，Portal for ArcGIS 升级过程中出现的问题可能会阻止您升级 ArcGIS Living Atlas 内容。 如果您看到此消息，请联系 Esri 技术支持（美国境内）或您的国际 Esri 分销商（美国境外）以识别并解决该问题。

我在安装 Portal for ArcGIS 后访问门户组织时，看到一则通知，指示组织中分配的许可数量超过可用的许可数量。 如何解决这一问题？

您可分配许可的用户数量不得超过 ArcGIS Enterprise 的许可范围。 此通知显示您分配的加载项许可或用户类型是否超过可用范围。 如果为用户分配的许可超过可用许可数量，则该用户可能无法访问组织。 要解决此问题，请转至许可选项卡并重新分配处于透支状态的许可。 或者，要添加许可，获取新门户许可文件。 有关在组织中分配许可的详细信息，请参阅管理许可。

我无法将 ArcGIS Data Store 安装到同一台计算机上的第二个位置。

每台计算机仅支持安装一次 ArcGIS Data Store。

安装软件时，您可以选择要安装的数据类型。 在 Microsoft Windows 服务器上，您可以多次运行 ArcGIS Data Store 安装以添加数据存储类型，但不能更改安装位置。 在 Linux 服务器上，您无法在同一台计算机上再次运行安装程序。

在配置数据存储时，我收到了消息数据存储（“<主数据存储计算机名称>”）中已配置了一台备用计算机。 数据存储不能具有多台备用计算机。

只允许两台计算机参与关系存储：一台主计算机和一台备用计算机。 要添加一台新的备用计算机，首先您必须移除现有备用计算机。

我收到了消息无法创建目录。

您会看到该消息的可能原因如下：

  • 指定的内容目录已被使用。

    如果您指定现有目录，则该目录不能包含任何文件。

  • 您没有在指定位置创建目录的权限。 确认您是否具有足够的权限。

  • 您指定的目录在远程计算机上。 ArcGIS Data Store 内容目录不能存储在远离 ArcGIS Data Store 安装所在位置的远程计算机上。

配置关系存储时，我收到消息启动关系存储数据库失败。

此消息指示，无法创建关系存储所需的 PostgreSQL 数据库。 发生这种情况的原因有很多；但是最常见的原因是，数据存储配置应用程序或 configuredatastore 实用程序未能连接到 PostgreSQL 来创建数据库。 ArcGIS Data Store 账户对于 ArcGIS Data Store 内容目录没有足够的权限，或由于计算机上的安全设置，PostgreSQL 服务 (Windows) 或进程 (Linux) 无法启动。 确认 PostgreSQL 正在运行。 如果没有运行，检查域策略、防火墙设置或防病毒软件设置是否阻止其启动。 如果 PostgreSQL 正在运行，则请确认 ArcGIS Data Store 账户是否能够完全控制内容目录（读、写和执行权限）。

在 Windows 计算机上配置关系存储失败，并提示消息错误：您必须将最新的 ST_GEOMETRY 库复制到 PostgreSQL 软件位置。

在安装 ArcGIS Data Store 的计算机上可能未安装正确版本的 Microsoft Visual C++ Redistributable for Visual Studio。 查看 ArcGIS Data Store 系统要求以确定正在使用的 ArcGIS Data Store 版本所需的 Redistributable 版本。

当我在同一台计算机上配置另一种类型的 ArcGIS Data Store 时，我无法使用不同的 ArcGIS Data Store 内容目录。

这正是设计所要求的。 在同一台计算机上运行的所有 ArcGIS Data Store 类型都使用相同的 ArcGIS Data Store 内容目录。

如果我的 ArcGIS Data Store 失败，或我发现在测试升级部署后，我必须恢复到以前的软件版本，那么我如何将数据存储恢复到以前的 ArcGIS Data Store 版本？

ArcGIS Data Store 必须与基础部署中的其他组件运行相同版本。 如果您在升级前使用 webgisdr 实用程序备份了部署，可以安装旧版软件，并通过该备份恢复大部分组件。 如果部署中包含时空大数据存储，按以下步骤在将其余 ArcGIS Enterprise 部署恢复到先前版本后，将这些存储恢复到之前的 ArcGIS Data Store 版本：

  1. 从每台时空大数据存储计算机上卸载 ArcGIS Data Store。

  2. 在所有时空大数据存储计算机上安装您希望还原到的 ArcGIS Data Store 版本。 请勿继续进行配置。

  3. 使用 restoredatastore 实用程序和升级前创建的时空大数据存储备份文件，恢复时空大数据存储。

注:

根据您要还原到的版本，您可能还需要使用 restoredatastore 实用程序以恢复使用 webgisdr 实用程序创建的备份中未包含的其他类型数据存储。 例如，在 11.5 版本之前，图存储未包含在使用 webgisdr 实用程序创建的备份中；对象存储在 11.4 版本之前也未包含在使用 webgisdr 实用程序创建的备份中，且仅当您将 INCLUDE_OBJECT_STORE_CACHES 属性设置为 true 时才会包含在内。

如何创建安装日志？

ArcGIS Enterprise Builder 安装程序会自动在 ProgramData 目录中创建安装和卸载日志文件。

无法卸载安装程序。 安装程序中断，ArcGIS Enterprise Builder 仍安装在计算机上。

ArcGIS Enterprise Builder 要求提取文件位于要卸载的 ProgramData\ArcGISBuilder<版本> 目录中。

如果已删除这些文件，则需要将其提取到其他位置，然后重新复制到此位置。

安装过程中收到以下消息：“必须在端口 80 上配置并启动网站”。

ArcGIS Web Adaptor 要求在 Web 服务器上启动并运行端口 80。 有关要求的详细信息，请参阅规划基础部署。

在 ArcGIS Enterprise 账户安装对话框中，收到以下消息：“密码不符合密码策略要求。 请检查最小密码长度、密码复杂性和密码历史记录要求。”

如果要创建新的本地账户作为安装过程的一部分，则为该账户指定的密码必须遵守本地安全策略。

如果密码不符合设置策略的最小强度要求，则安装程序将返回此消息。 系统管理员可以为您提供密码策略要求，或者可通过执行以下操作查看要求说明：

  1. 在控制面板中，打开管理工具，搜索本地安全策略，然后展开账户策略。

  2. 选择密码策略文件夹，然后双击密码必须符合复杂性要求。

  3. 在密码必须符合复杂性要求属性对话框中，单击说明选项卡。