以下为您在使用 ArcGIS Enterprise 门户时可能遇到的问题以及可能的解决方案。 如果未能找到您的特定问题,也可以访问 Esri 技术支持中心网站以搜索相关文章。
安装
正在升级
- 升级之后,门户网站无法正确显示、显示错误消息或无法登录。 这是什么原因?
- 升级之后,没有显示门户中的所有项目、群组和用户。 应该怎么办?
- 我在安装 12.0 后访问门户网站时,看到一则通知,指示组织中分配的许可数量超过可用的许可数量。 如何解决这一问题?
- 升级门户并尝试创建初始管理员账户时,收到消息创建初始管理员账户时出错。 如何解决这一问题以完成升级?
- 升级门户后,当我在门户网站中打开组织 > 设置 > ArcGIS Online 以更新订阅者和高级 ArcGIS Living Atlas of the World 内容时,我看到一条错误消息,指示凭据无效或 ArcGIS Online 无法访问。 出现了什么问题,我应如何解决这些问题?
管理
- 如何配置 Portal for ArcGIS 才能使其实现高可用性?
- 初始管理员账户的用途是什么? 能否将其降级或删除?
- 如何在 ArcGIS Server 站点与门户联合后连接该站点?
- 在尝试联合 ArcGIS Server 站点与门户时,添加 Add ArcGIS Server 对话框中将显示下述消息:与服务器进行通信时出错。 请检查 URL 和凭据,然后重试。
- 能否重命名已安装 Portal for ArcGIS 的计算机?
- 当我试图在 Internet Explorer 中打开门户网站时,网站无法加载或返回一条消息,提示网站无法显示。
- 如何使用组织的反向代理服务器配置 Portal for ArcGIS?
- 我可以将一个 ArcGIS Web Adaptor 配置为同时与 ArcGIS Server 和 Portal for ArcGIS 一起使用吗?
- 如果我的门户使用轻量级目录访问协议 (LDAP) 群组,门户的身份存储更新能否立即作为一个新的登录名添加到我的 LDAP 服务器?
- 如果我的门户使用 LDAP 群组,新的 LDAP 群组是否会在我将这些群组添加至我的 LDAP 服务器时自动添加至我的门户?
- 如果我的门户使用 LDAP 账户和群组,从我的 LDAP 服务器中删除用户时会发生什么?
- 如果我的门户使用 LDAP 群组,当在我的 LDAP 服务器中重命名或删除 LDAP 群组时,相应门户会发生什么?
- 我将组织的登录账户配置为仅使用 OpenID Connect 登录账户,并且关闭了成员使用其内置 ArcGIS 账户登录的选项。 如何重新启用此选项?
- 我将组织的登录账户配置为仅使用 SAML 登录账户,并且关闭了成员使用其内置 ArcGIS 账户登录的选项。 如何重新启用此选项?
- 在将门户的安全配置从 LDAP 切换到 SAML 后,将在每天夜间将所有 SAML 用户从其基于 SAML 的群组中移除。 发生了什么?
- 在 web 浏览器中加载 Map Viewer 需要很长时间。
- 新建 web 地图的缩略图未生成或者无法正确显示。
- 配置新的自定义 SSL 证书后,我的门户无法访问。 如何恢复访问?
- 当我在门户网站中打开组织 > 设置 > Living Atlas 时,我看到一条错误消息,指示凭据无效或 ArcGIS Online 无法访问。 出现了什么问题,我应如何解决这些问题?
备份
安装
为使门户能够正常运行,安装用户需要将文件句柄限制设置为 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 命令。
正在升级
清除您的浏览器缓存(包括 cookie)。 这些错误通常是由于浏览器中存在先前版本网站的信息所导致的。 如果仍无法登录,请确认您使用的是初始管理员账户或具有组织管理权限的账户。
安装软件并指定初始管理员账户后,您必须为门户重新构建索引。 完成此步骤后,门户即升级完毕。 最初可能无法显示所有项目、群组以及用户,这是因为索引重新构建尚未完成。 完成索引的重新构建可能会花费一些时间,具体取决于组织中的用户数量和内容体积。 例如,在含有 8 个内核的计算机上运行 Portal for ArcGIS 的小型组织(包含数百个用户及内容项目)可能需要花费 15 分钟来重新构建索引。 而在含有 8 个内核的计算机上运行 Portal for ArcGIS 的大型组织(包含数万个用户及内容项目)可能需要花费超过 3 个小时来重新构建索引。
通过以下步骤可检查重新构建索引的状态。 当存储与索引计数相等时,即完成索引重新构建以及升级过程。
- 打开 Portal Administrator Directory 并使用初始管理员账户进行登录。 URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin。
- 单击 System > Indexer > Index Status。
- 刷新页面获取最新状态。
门户日志中的信息可以帮助您解决此问题。 如果创建账户时网络连接暂时丢失,则会发生此错误。 要访问日志,请浏览至日志目录并打开最近的日志文件(例如,<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 在高度可用的环境中,是可配置并且受支持的。 有关详细信息,请参阅配置高可用性门户。
安装 Portal for ArcGIS 并进行配置后,您即可访问门户网站。 此时,您需要提供最初用于登录网站和管理门户的新账户的用户名、密码、电子邮件以及身份验证问题和答案。 此账户称为初始管理员账户。
初始管理员账户用户名和密码存储在 Portal for ArcGIS。 初始管理员账户不是操作系统账户,且与 Portal for ArcGIS 账户没有任何关联。 此后,您可以指定其他账户作为管理员、降级初始管理员至权限较低的角色,或者删除初始管理员账户。
在联合 ArcGIS Server 站点与门户后,门户的安全性存储可控制对服务器的所有访问权限。 之前用于 ArcGIS Server 的用户和角色对于访问此服务器不再有效;而您可使用门户账户建立与服务器的所有连接。
唯一的例外情况是 ArcGIS Server 的主站点管理员账户。 如果通过端口 6080 或 6443 直接连接,您始终可使用此账户登录 ArcGIS Server Administrator Directory。但在服务器与门户联合时,不能使用此账户登录 ArcGIS Server Manager。
要了解有关如何在 ArcGIS Server 站点与门户联合时连接到该站点的详细信息,请参阅管理联合服务器。
遇到此错误可能有以下几个原因:
- 为 ArcGIS Server 站点输入的服务器 URL 或管理员 URL 值不正确或无法访问。 请确认以下内容:
- 如果 ArcGIS Server 站点包含 ArcGIS Web Adaptor,则服务器 URL 值是 Web Adaptor 地址,例如,http://webadaptorhost.domain.com/webadaptorname。 如果不存在 Web Adaptor,则服务器 URL 值与管理员 URL 值相同,例如 http://gisserver.domain.com:6080/arcgis。
- 如果您的组织要求将 HTTPS 用于所有通信,则在 URL 中使用 https。
- URL 包括计算机的完全限定域名 (FQDN)。 FQDN 为必填内容。
- ArcGIS Server 站点的通信协议已更新为使用 HTTP 和 HTTPS 或仅 HTTPS。
- 此通信协议与门户的通信协议相匹配。 例如,如果要求门户中的所有通信都使用 HTTPS,则 ArcGIS Server 也应配置为仅使用 HTTPS。 反之,如果门户网站不要求使用 HTTPS,则服务器通信协议应为 HTTP 和 HTTPS。
- 如果 ArcGIS Server 站点包括 ArcGIS Web Adaptor,则在更新站点的通信协议之后,必须通过 ArcGIS Web Adaptor 重新配置 ArcGIS Server。
- 防火墙允许在 ArcGIS Server 和门户之间进行通信。 有关要打开的特定端口的信息,请参阅 ArcGIS Server 使用的端口和 Portal for ArcGIS 使用的端口。
- ArcGIS Server 站点上已禁用 Web 层身份验证且已启用匿名访问。 虽然这听起来可能有悖常理,但是必须如此站点才能自由与门户联合并读取门户中的用户和角色。
- 您输入的用户名或密码不正确:
- 对于用户名,输入用于初始登录到 ArcGIS Server Manager 和管理服务器的主站点管理员账户的名称。 如果该账户不可用,您必须重新启用它。 不能使用其他账户。
- 对于密码,提供主站点管理员账户的密码。
有关详细信息,请参阅联合站点。
要使用反向代理服务器配置 Portal for ArcGIS,需要提供有关代理服务器的信息。 有关完整说明,请参阅将您的门户与反向代理或负载均衡器相集成。
否。如果门户中已存在组织特定账户并且 LDAP 群组已链接到门户群组,则当新会员登录门户时将刷新身份存储,或者下一次自动刷新门户身份存储,以先发生者为准。 默认情况下,身份存储在每一天午夜更新。 门户管理员可通过使用门户管理 API 中的 Update Identity Store 操作改变 membershipRefreshIntervalHours 和 membershipRefreshStartTime 参数的值,来更改身份存储刷新的频率和时间。
如果组织特定账户不是门户的成员,则将登录账户添加至链接到门户群组的 LDAP 群组时,不会自动将账户添加到您的组织。 管理者不希望每个添加到 LDAP 服务器的登录账户都自动添加到您的组织。
如果 web 地图包含使用 HTTPS 的 ArcGIS Server 服务,则可能会遇到此类问题。 如果是这种情况,请检查门户是否配置了 ArcGIS Server 站点的打印实用程序服务。 运行打印服务的计算机可能不信任提供 HTTPS 服务的 ArcGIS Server 站点中的证书颁发机构 (CA) 签名证书。 需要在操作系统级别将每台运行打印服务的计算机配置为信任这些 CA 证书。 请参阅使用新 CA 签名证书启用 HTTPS 以获取如何执行此操作的详细信息。
如果您错误配置了 SSL 证书,并且无法登录到门户,请执行以下步骤来恢复访问。
- 停止 Portal for ArcGIS。
- 备份 \ArcGIS\Portal\framework\runtime\tomcat\conf\server.xml 文件。
- 在文本编辑器中打开 ArcGIS\Portal\framework\runtime\tomcat\conf\server.xml。
- 通过搜索 <Connector SSLEnabled="true" 字符串以定位 SSL 连接器。
- 将 keyAlias 参数的值更改回默认值 keyAlias="portal",并保存所做更改。
- 以具有管理权限的成员身份登录 Portal Administrator Directory。
- 选择安全性 > SSLCertificates并单击更新。 在下一页,确认更新即可,无需修改任何参数。
- 门户将自动重启。
门户要求使用有效 ArcGIS Online 凭据来访问订阅者和高级 ArcGIS Living Atlas。 如果门户无法使用您在启用 ArcGIS Living Atlas 订阅者和高级内容时使用的凭据来访问 ArcGIS Online,则门户网站和托管服务器的日志中将返回以下消息之一:
- 用于访问订阅者和/或高级 Living Atlas 内容的凭据无效。 请使用有效 ArcGIS Online 组织账户凭据更新凭据。- ArcGIS Enterprise 已连接到 ArcGIS Online 组织,并已确定您的现有凭据无效。 确保您的 ArcGIS Online 账户密码未更改并且该账户仍有可用配额(适用于高级内容)。
如果密码已更改,或者您需要提供一个新账户从 ArcGIS Online 访问订阅者和高级 ArcGIS Living Atlas 内容,则需要更新凭据。
- 无法从此门户访问 ArcGIS Online。 请检查您的防火墙设置或门户代理设置。- ArcGIS Enterprise 无法连接到与您的凭据相关联的 ArcGIS Online 账户。 在大多数情况下,这是由于您的网络上存在阻止与 ArcGIS Online 进行通信的问题。
- 无法验证用于访问订阅者和/或高级 Living Atlas 内容的凭据,因此,您无法更新内容。 请联系 Esri 技术支持或您的国际分销商。- 已出现一个不常见且无法识别的内部错误。 如果您看到此消息,请联系 Esri 技术支持(美国境内)或您的国际分销商(美国境外)以识别并解决该问题。
备份
门户将增量事务日志存储在门户内容目录的子目录中,以便您创建门户的增量备份。 默认位置是 /home/<user>/arcgis/portal/usr/arcgisportal/backup/walarchive)。
当您使用 webgisdr 工具创建 full 备份后,不再强制限制初始大小;但是每次运行该工具时,现有的事务日志都会被移除。 如果子目录大小超过 5GB,则会记录以下消息:
门户的事务日志占用超过 5GB 的磁盘空间。 使用 webgisdr 工具运行完整备份以清除这些日志。
默认情况下,备份的事务日志大小不能超过 50 MB。 如果您的环境不支持用于恢复至辅助数据中心的地理性备援,请将 BACKUP_RESTORE_MODE 设置为 backup 而不是 full。
要了解有关 webgisdr 工具的详细信息,请参阅创建 ArcGIS Enterprise 备份。
当门户的内部数据库中仍然存在某个项目但内容目录中不存在该项目时,将发生此错误。 这是项目删除不完整导致的结果。 通常,删除项目时,将从内部数据库以及内容目录中删除项目。 但是,有时项目无法从内部数据库中成功删除。
在这种情况下,创建备份时,将记录警告错误,指示必须手动删除此项目。 记录错误消息提供的一个或多个 itemID 值。 除非该项目为 Esri 所有,否则您可以按照以下步骤删除该项目。
提示:
您也可以与 Esri 技术支持部门联系以获取有关这些步骤的帮助。
- 以管理员身份登录 ArcGIS Portal Directory(Sharing API)(https://portal.domain.com/webadaptor/sharing/rest)。
- 使用 /search 端点来搜索 API 中的项目。 对于“搜索文本”参数,使用日志消息中的 itemID 输入 id:。
- 在搜索结果中,单击用于标识项目所有者的链接。 随即显示所有者的信息页面。
- 在相关资源下,单击用户内容。
- 在日志中单击 itemID。 随即显示一条消息,指示内部服务器错误。
- 将 /delete 附加到项目端点的 URL。 确认删除操作。
- 对日志消息中显示的每个项目重复步骤 2 - 6。
在 Portal Administrator Director 中,当您尝试使用导入站点操作时,将生成一个将在一小时后过期的令牌。 如果还原操作未在一小时内完成,则导入过程将失败。
如果恢复过程花费的时间超过 1 小时,使用 Sharing API 生成令牌,并指定比默认值长的到期时间。 使用此令牌访问 Portal Administrator Directory:
- 如果在 web 浏览器中使用目录,则需要将新令牌附加到用于“导入站点”操作的 Administrator Directory URL。
- 如果要通过脚本调用操作,请需要在此 API 调用中包括新令牌。