Tableau Server 安装和升级疑难解答

相关文章推荐

慷慨大方的风衣 · 配置RDS MySQL连接池_云数据库 ...· 6 月前 ·

独立的汉堡包 · 关于vue开始日期与结束日期的关系_vue开 ...· 1 年前 ·

打盹的木瓜 · 配置Jstl的Maven依赖_梦回沉沦的博客 ...· 1 年前 ·

知识渊博的匕首 · 在Vue ...· 1 年前 ·

一直单身的海豚 · 没有人比我更会使用集合！对, ...· 1 年前 ·

</noscript><div id="app" class="wrapper"><header id="tableau-help-article-header" class="container--full-width quick-help-header"><div class="container--centered"><div class="header__back-button"><back-button title="返回"/></div><div class="header__mobile-menu quick-help-hidden"><menu-tree-toggle/></div><div class="header__logo quick-help-hidden"><a href="https://www.tableau.com/zh-cn/"><img src="./Resources/tableau-logo.png" class="header__logo__img" alt="Tableau"/></a></div><div class="header__search"><search-header-help placeholder="搜索"/></div><div class="header__home-button"><home-button title="前往主页"/></div></div></header><div class="container--navigation-top quick-help-hidden content-only-hidden"><div id="help-subheader" class="subheader print-hidden"><div class="container--centered"><h4 class="heading--subheader">Windows 版 Tableau Server 帮助</h4></div></div><div class="container--top-links"><div class="container--centered container--breadcrumbs"><div><breadcrumb-links-help/></div></div><div id="help-container-menu-headings" class="container--menu-headings"><nav class="nav-medium-screen"><menu-heading-links-static-help menu-title="本文内容" :disabled="false" :headings="pageHeadings"/></nav></div></div></div><div class="section--main container--full-width"><div class="container--centered"><nav class="nav-side nav-side--left" role="navigation"><menu-tree-help menu-title="内容"/></nav><article role="main"><h1 id="contentH1">Tableau Server 安装和升级疑难解答</h1><div class="caption article__tags content-only-hidden quick-help-hidden"><span class="article__tags--applies-to"> </span><br/><span class="article__tags--role"> </span></div><div xmlns:madcap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" id="content-body">&#13; <div role="main" id="mc-main-content"><p>按照本主题中的建议来解决 Tableau Server 的常见问题。有关基于在“状态”页面上查看的进程状态的其他疑难解答步骤，请参见<a href="service_status_troubleshoot.htm" class="MCXref xref" xrefformat="{paratext}">服务器进程疑难解答</a>。</p><p> </p><div id="tsm"><h2 is="heading-item" :level="2" id="一般疑难解答步骤"><a name="GeneralTshooting"/>一般疑难解答步骤</h2><p>许多 Tableau Server 问题可通过某些基本步骤解决：</p><ol><li value="1"><p>确保运行 Tableau Server 的每台计算机上都有足够的磁盘空间。有限的磁盘空间可能会导致安装失败、升级失败或运行 Tableau Server 时出现问题。</p></li><li value="2"><p>重新启动 Tableau Server。与未完全启动的进程相关的问题可通过以受控方式重新启动 Tableau Server 解决。若要重新启动 Tableau Server，请使用 <a href="cli_restart_tsm.htm#restart"><code>tsm restart</code></a> 命令。这将停止与 Tableau Server 关联的所有进程，然后重新启动这些进程。</p></li><li value="3"><p>重建 Tableau Server 索引。与索引相关的问题可通过重建 Tableau Server 索引解决。若要重建 Tableau Server 索引，请使用 <a href="cli_maintenance_tsm.htm#tsmmaintenancereindex"><code>tsm maintenance reindex-search</code></a> 命令。有关详细信息，请参见下面的<a href="#Reindexing" class="MCXref xref" xrefformat="{paratext}">重建 Tableau Server 搜索和浏览索引</a>。</p></li><li value="4"><p>重新启动 Tableau Server 正在其上运行的计算机。可以通过重新启动服务器计算机来解决某些问题（例如与数据源连接相关的问题）。</p></li></ol><div><h2 is="heading-item" :level="2" id="tableau-server-安装常见问题"><a name="InstallingServer"/>Tableau Server 安装常见问题</h2><h3 is="heading-item" :level="3" id="安装日志位置">安装日志位置</h3><div data-mc-conditions="Product.serverwindows"><p>安装日志将写入正在运行安装程序的用户帐户的 <code>\Temp</code> 目录。大多数情况下，此目录位于 <code>C:\Users\&lt;user&gt;\AppData\Local\Temp</code>。</p><p>若要确定已登录用户的 <code>\Temp</code> 目录位置，请在 Windows 命令提示符中运行以下命令：<code>ECHO %Temp%</code>。</p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="安装程序未提示输入安装位置">安装程序未提示输入安装位置</h3><p>首次安装 Tableau Server 时，系统会提示您输入所需的安装位置。<em>如果未看到此提示，则可能有以前安装中的遗留文件或目录，即使您卸载了 Tableau 也是如此。</em>若要完全移除 Tableau 版本 2018.2 或更高版本的所有痕迹，请运行 <code>tableau-server-obliterate.cmd</code> 脚本，然后重新启动计算机并再次尝试安装。如果以前安装的版本早于 2018.2，请在重新运行安装程序之前手动删除所有 Tableau 相关文件夹。</p><p class="note"><strong>重要信息：</strong>如果创建了要保留的 Tableau 的备份 (<code>&lt;file&gt;.tsbak</code>)（举例来说，用于还原到新安装），请将该文件复制到另一台计算机上的安全位置，以保证其在您清理 Tableau 计算机时不会被移除。</p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="安装程序不会重新启动-windows">安装程序不会重新启动 Windows</h3><p>安装 Tableau Server 时，安装程序可能会提示您在安装结束时重新启动 Windows。在某些情况下，单击<span class="uicontrol">“重新启动”</span>不会重新启动计算机。当第三方组件安装程序请求重新启动 Windows 时，可能会发生这种情况。</p><p>如果单击<span class="uicontrol">“重新启动”</span>未重新启动 Windows，请通过手动重新启动 Windows 来完成安装。 </p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="tsm-安装失败，并出现“初始化失败”错误">TSM 安装失败，并出现“初始化失败”错误</h3><p>如果尝试安装 Tableau Server，并且安装失败且出现以下错误：</p><pre>Tableau server initialization failed<br/>See install log at C:\ProgramData\Tableau\Tableau Server\logs</pre><p>这可能与计算机上的一个权限问题相关。用户登录到 Windows，而安装 Tableau 必须具有对 C 驱动器、C:\Windows 和 C:\Windows\System32 文件夹以及 cmd.exe 文件的管理员权限。即使您未将 Tableau 安装在 C 驱动器上，情况也是如此。</p><p>有关详细信息，请参见 <a href="https://kb.tableau.com/articles/issue/errors-tableau-server-initialization-failed-and-initdb-could-not-execute-command?lang=zh-cn" target="_blank">Tableau 知识库<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="tsm-初始化屏幕不显示">TSM 初始化屏幕不显示</h3><p>安装或升级 Tableau Server 时，如果浏览器打开但未显示任何内容，则您可能需要将主机名添加到可信站点列表。或者，清除浏览器缓存或使用其他浏览器。有关详细信息，请参见 <a href="https://kb.tableau.com/articles/issue/tsm-initialization-window-does-not-render-in-server-side-web-browser-window?lang=zh-cn" target="_blank">Tableau Server 知识库<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></div> <div><h3 is="heading-item" :level="3" id="无法登录到-tsm-或-tableau-server（登录屏幕在输入凭据后重新显示）">无法登录到 TSM 或 Tableau Server（登录屏幕在输入凭据后重新显示）</h3><p>在使用 Internet Explorer 或 Edge 的情况下，如果您在 TSM 或 Tableau Server 登录屏幕中输入凭据，并且页面在未将您登录的情况下重新显示，请验证 URL 中的主机名或域是否未包括下划线 (_)。如果 Tableau Server 计算机的主机名或域包括下划线 (_)，Internet Explorer 或 Edge 浏览器将不会设置 Cookie，因此页面会在未将您登录的情况下重新显示。若要解决此问题，请在 URL 中使用“localhost”或计算机的 IP 地址。例如：<code>https://localhost:8850</code>。</p><p class="note" data-mc-conditions="Product.serverwindows"><strong>注意：</strong>如果为 Tableau Server 身份存储使用 AD，在尝试登录太多次的情况下，您可能无法进入 Active Directory。</p><p>有关详细信息，请参见 <a href="https://kb.tableau.com/articles/issue/infinite-redirect-to-login-page-during-installation-or-upgrade-to-tableau-server-2018-2-or-later?lang=zh-cn" target="_blank">Tableau Server 知识库<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></div><div><h3 is="heading-item" :level="3" id="多次尝试安装均失败">多次尝试安装均失败</h3><p>如果尝试安装 Tableau Server 并且安装失败，则任何后续的安装尝试都可能会失败，除非您运行 <code>tableau-server-obliterate</code><conditionaltext data-mc-conditions="Product.serverwindows"><code>.cmd</code></conditionaltext><code> </code>脚本将 Tableau 清理出计算机。</p><p class="note--important" data-mc-conditions="Product.serverwindows"><strong>重要信息：</strong>必须从 64 位命令提示符中运行 <code>tableau-server-obliterate.cmd</code> 脚本。例如，在 <code>C:\Windows\System32</code> 文件夹中运行 <code>cmd.exe</code>。如果从 32 位命令提示符中运行脚本，脚本将不会完全移除 Tableau，并且后续的安装可能会失败。若要确定您是否在运行 64 位命令提示符，请在命令窗口中键入 <code>echo %processor_architecture%</code>。如果结果包括“64”（例如 <code>AMD64</code>），则命令提示符为 64 位提示符。如果结果包括“x86”，则正在运行 32 位提示符。有关详细信息，请参阅适用于您的 Windows 版本的 Microsoft 文档。</p><p>失败的安装尝试可能会使计算机处于一种会导致后续尝试也失败的状态，而错误看起来似乎并不与以前的安装尝试直接相关。</p><p>若要修复此问题，请运行 <code>tableau-server-obliterate</code><conditionaltext data-mc-conditions="Product.serverwindows"><code>.cmd</code></conditionaltext> 脚本清理以前的安装尝试的任何遗留内容，然后重新启动计算机。有关详细信息，请参见<a href="remove_tableau.htm#RunObliterate" class="MCXref xref" xrefformat="{paratext}">运行 tableau-server-obliterate 脚本</a>。</p><p class="note"><strong>重要信息：</strong>如果创建了要保留的 Tableau 的备份 (<code>&lt;file&gt;.tsbak</code>)（举例来说，用于还原到新安装），请将该文件复制到另一台计算机上的安全位置，以保证其在您清理 Tableau 计算机时不会被移除。</p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="obliterate-脚本生成错误：“refreshenvironmentvariablescmd”不是内部或外部命令">Obliterate 脚本生成错误：“refresh-environment-variables.cmd”不是内部或外部命令</h3><p>如果使用控制面板来卸载 Tableau Server，然后运行 <code>tableau-server-obliterate.cmd</code> 脚本从计算机中完全移除 Tableau，脚本可能会生成有关 refresh-environment-variables 的错误。之所以出现此错误，原因是 obliterate 脚本调用的另一个脚本未移到 temp 目录。您可以忽略此错误。</p></div><div><h3 is="heading-item" :level="3" id="安装由于硬件要求而失败">安装由于硬件要求而失败</h3><p>如果要进行安装的计算机未满足最低硬件要求，则 Tableau Server 无法安装。这些要求适用于您在其上安装 Tableau Server 的所有计算机。有关最低硬件要求的详细信息，请参见 <a href="server_hardware_min.htm" class="MCXref xref" xrefformat="{paratext}">Tableau Server 的最低硬件要求和推荐配置</a>。</p></div><div><h3 is="heading-item" :level="3" id="安装由于-cpu-要求而升级失败"><a name="InstallCPUreq"/>安装由于 CPU 要求而升级失败</h3><p>从版本 2020.4.0 开始，Tableau Server 要求有支持 SSE4.2 和 POPCNT 指令集的 CPU。您无法在 CPU 不支持这些指令集的计算机上安装或升级 Tableau Server 2020.4.0 或更高版本。</p><p>在进行新安装时，或在准备升级现有安装时，可能会看到此错误消息： </p><pre>Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.</pre><p>SSE4.2 和 POPCNT 指令集已经流行了 10 多年，大多数较新的 CPU 都支持它们，但如果您在尝试在虚拟机 (VM) 上安装或升级 Tableau Server 时遇到与处理器最低要求相关的错误，则可能会在 VM 上启用处理器兼容模式。若要在 VM 上成功安装或升级 Tableau，请确保关闭处理器兼容模式。</p></div></div><div><h2 is="heading-item" :level="2" id="tableau-server-升级常见问题"><a name="UpgradingServer"/>Tableau Server 升级常见问题</h2><div><h3 is="heading-item" :level="3" id="升级日志位置">升级日志位置</h3><p data-mc-conditions="Product.serverwindows">默认情况下，升级日志 <code>app-upgrade.log</code> 会写入到 <code>C:\ProgramData\Tableau\Tableau Server\logs</code>。</p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="错误：未能与-active-directory-建立连接">错误：未能与 Active Directory 建立连接</h3><p>从 Tableau 版本 2021.2 开始，Tableau Server 不再允许与 Active Directory 的不安全连接。如果您当前的 Tableau Server 实例正在通过非加密通道与 Active Directory 通信，则升级将失败。</p><p>若要解决此问题，请执行以下步骤之一：</p><ul><li value="1">调查并解决失败的安全连接。请参见 Microsoft 主题 <a href="https://docs.microsoft.com/zh-cn/troubleshoot/windows-server/identity/ldap-over-ssl-connection-issues" target="_blank">LDAP over SSL 连接问题<span class="sr-only">(链接在新窗口中打开)</span></a>。</li><li value="2"><p>在升级之前，运行以下命令以允许在当前版本的 Tableau Server 上使用不安全的连接：</p><p><code>tsm configuration set -k wgserver.domain.allow_insecure_connection -v true --force-keys</code></p><p><code>tsm pending-changes apply</code></p><p>升级完成后，建议您保护通道，然后将此选项设置为 <code>false</code>。</p><p class="note"><b>注意</b>：默认情况下（当 <code>wgserver.domain.allow_insecure_connection</code> 设置为 <code>false</code> 时），如果与 Active Directory 的通信通道未加密，则 Active Directory 组同步将失败。</p></li></ul></div><div><h3 is="heading-item" :level="3" id="升级后地图不显示或显示不完整">升级后地图不显示或显示不完整</h3><p>从 Tableau 版本 2019.2 开始，地图的 Internet 访问要求发生了变化。如果要从版本 2019.1.x 或更低版本升级到版本 2019.2.x 或更高版本，并且地图未按预期显示，请确认您的环境已配置为在端口 443 上允许 <code>mapsconfig.tableau.com</code> 和 <code>api.mapbox.com</code>。</p><p>在版本 2019.1.x 或更低版本中，需要访问 <code>maps.tableausoftware.com</code>。</p><p>有关 Internet 访问要求的更多详细信息，请参见<a href="plan_network.htm" class="MCXref xref" xrefformat="{paratext}">与 Internet 通信</a>。</p></div><div><h3 is="heading-item" :level="3" id="升级脚本错误“tableau-server-version-change-validation-failed”（tableau-server-版本更改验证失败。）">升级脚本错误:“Tableau Server Version change validation failed.”（Tableau Server 版本更改验证失败。）</h3><p>进行升级时，如果从以前版本的 <code>scripts.&lt;version_code&gt;</code> 目录中运行 <code>upgrade-tsm</code> 脚本，升级将会失败，并出现错误：</p><pre xml:space="preserve">Tableau Server Version change validation failed.&#13; Tableau Server &lt;version&gt; is already installed.</pre><p>如果您遇到此错误，则更改为刚刚安装的版本的 <code> scripts.&lt;version_code&gt;</code> 目录，并从该目录中运行脚本。</p></div><div><h3 is="heading-item" :level="3" id="升级多节点，初始化附加节点失败，并出现“再次输入您的凭据”错误">升级多节点，初始化附加节点失败，并出现“再次输入您的凭据”错误</h3><p>如果在升级 Tableau Server 时尝试初始化附加节点并看到以下错误：</p><pre>Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.</pre><p>这表明节点无法连接到初始节点或与之通信。发生此错误的原因有多种：</p><ul><li value="1"><p>您输入的凭据无效或者凭据键入错误。凭据必须是在首次安装 Tableau Server 的计算机上具有管理权限的用户的凭据。您无需使用创建了引导程序的用户的凭据，但使用该凭据将确保您使用的是有效的凭据。</p></li><li value="2"><p>您尝试添加的计算机的本地防火墙不允许与初始节点通信。有关详细信息，请参见<a href="requ.htm#firewall" class="MCXref xref" xrefformat="{paratext}">本地防火墙配置</a>。</p></li></ul></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="升级在-12、78-或-92-处停止或失败">升级在 12%、78% 或 92% 处停止或失败</h3><p>在某些情况下，upgrade-tsm.cmd 脚本可能会在中途停止或失败。此错误的原因取决于脚本的停止位置。</p><ul><li value="1"><p>如果脚本在 12% 或 78% 处停止，这可能是与在启用 SSL 时升级相关的一个已知问题（已在版本 2018.2.1 中修复）导致的。有关详细信息，请参见 <a href="https://kb.tableau.com/articles/Issue/upgrade-to-tableau-server-2018-2-stalls-or-fails-around-12-or-78-with-ssl-enabled?lang=zh-cn" target="_blank">Tableau 知识库<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></li><li value="2"><p>如果脚本在 92% 处执行“启用建立索引所需的服务”步骤时停止，这可能是启动 Tableau 服务时的问题导致的。您可以手动重新启动 Tableau Server 服务管理器来解决此问题。有关详细信息，请参见 <a href="https://kb.tableau.com/articles/Issue/upgrade-to-tableau-server-2018-2-stuck-at-92?lang=zh-cn" target="_blank" title="“升级停滞”知识库文章" alt="Upgrade stalls Knowledge Base article">Tableau 知识库<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></li></ul></div><div><h3 is="heading-item" :level="3" id="升级由于缺少磁盘空间而失败">升级由于缺少磁盘空间而失败</h3><p>如果磁盘空间不足，使得 Tableau Server 安装程序无法运行和执行升级，则安装将失败。所需的磁盘空间量将取决于存储库数据库的大小以及数据提取的数量和大小。</p><p class="note" data-mc-conditions="Product.serverwindows"><strong>注意：</strong>从 TSM 之前的 Tableau Server 版本（2018.2.0 之前的版本）升级时，卸载 Tableau 会在数据目录中创建服务器备份文件。此备份文件具有 <code>.tsbak</code> 扩展名，是升级所必需的。成功升级<em>之后</em>，可以安全地删除此文件以释放空间（在不属于 Tableau Server 安装的计算机上创建副本，以防因任何原因需要该文件）。在完成升级并知道此文件正常工作之前，不要将其删除。</p><p>释放磁盘空间：</p><ol><li value="1"><p>使用 <a href="cli_maintenance_tsm.htm#tsm4ziplogs"><code>tsm maintenance ziplogs</code></a> 命令创建日志存档快照。</p><p>创建 ziplogs 文件之后，请将其保存到不是 Tableau Server 安装一部分的安全位置。</p></li><li value="2"><p>使用 <a href="cli_maintenance_tsm.htm#cleanup"><code>tsm maintenance cleanup</code></a> 命令清理不必要的文件。有关详细信息，请参见<a href="maintenance_cleanup.htm" class="MCXref xref" xrefformat="{paratext}">移除不需要的文件</a>。</p></li></ol></div><div><h3 is="heading-item" :level="3" id="升级在进行-rebuildsearchindex-作业时失败">升级在进行 RebuildSearchIndex 作业时失败</h3><p>从版本 2020.1.x 开始，升级的最后一步是重新生成搜索索引。此时，所有服务都已升级，因此，如果此作业失败，可以通过运行 <code>tsm maintenance reset-searchserver</code> 命令手动重置搜索服务器。您无需清除并重新开始。</p><p>错误将是：</p><pre xml:space="preserve">An error occurred while rebuilding search index.</pre><p>重置搜索服务器：</p><ol><li value="1"><p data-mc-conditions="Product.serverwindows">在初始节点上，以管理员身份打开命令提示符。</p><p>这必须是一个新的<conditionaltext data-mc-conditions="Product.serverwindows">命令提示</conditionaltext>，因为升级脚本针对新版本更新系统环境。</p></li><li value="2"><p>使用 <a href="cli_maintenance_tsm.htm#tsm_maint_reset_searchsvr" class="MCXref xref" xrefformat="{paratext}">tsm maintenance reset-searchserver</a> 命令重新生成搜索索引。</p></li></ol></div><div><h3 is="heading-item" :level="3" id="在-20221-及更高版本上升级失败">在 2022.1 及更高版本上升级失败</h3><p>升级 Tableau Server 2022.1（或更高版本）后，在升级过程中还原 Tableau Server 备份可能会导致以下错误：</p><p style="text-indent: 0.5in;"><i>“The backup cannot be restored because Tableau Server uses the new identity service tables by default.”（无法还原备份，因为 Tableau Server 默认使用新的身份服务表。）</i></p><p>出现此问题的原因是 Tableau Server 2022.1（及更高版本）使用的身份架构与备份使用的身份架构不同。若要解决此问题，请参见<a href="identity_migration_troubleshoot.htm" class="MCXref xref" xrefformat="{paratext}">对身份迁移问题进行故障排除</a>。</p></div><div><h3 is="heading-item" :level="3" id="升级在-202040-或更高版本上失败"><a name="CheckpointUpgradeTroubleshooting"/>升级在 2020.4.0 或更高版本上失败</h3><p>从版本 2020.4.0 开始，“检查点升级”功能允许您重试失败的升级。通常，这对于经验丰富的服务器管理员和 IT 专业人员来说最有用，他们熟悉 Tableau Server 日志文件并愿意搜索这些文件。但是，该功能可以帮助所有失败的升级，因为它允许您重新运行 upgrade-tsm 脚本，并且该脚本会从最后一个成功步骤运行，从而节省时间。对于有经验的用户，可以识别磁盘空间问题或权限问题等问题，更正它们，并重新运行升级。</p><p>如果要升级到版本 2020.4.0 或更高版本，并且升级失败，以下步骤可以帮助您完成升级：</p><ul><li value="1"><p>重新运行 <code>upgrade-tsm</code> 脚本。升级失败有时是升级过程中超时的结果，重新运行脚本可以允许升级越过间歇性或偶尔的计时问题。这也是一个安全易行的步骤。重新运行脚本不会造成任何损害，在最坏的情况下，升级将在同一点再次失败，但无需执行任何以前的步骤。</p><p>该脚本位于 <code>\scripts</code> 目录中：</p><p data-mc-conditions="Product.serverwindows">默认情况下，</p><p data-mc-conditions="Product.serverwindows"><code>C:\Program Files\Tableau\Tableau Server\packages\scripts.&lt;version_code&gt;\upgrade-tsm.cmd</code></p><p>如果在重新运行 upgrade-tsm 脚本时 Tableau Server 升级未成功，并且您熟悉 Tableau Server 日志，您可以执行以下附加故障排除步骤：</p></li><li value="2"><p>在命令窗口中查看脚本的输出<conditionaltext data-mc-conditions="Product.serverwindows">（如果不再有命令窗口打开，请重新运行脚本）。您需要使用管理员访问权限在命令窗口中运行脚本</conditionaltext>。有用的错误消息可以帮助您确定升级失败的原因，并为您提供一些有关如何更正问题的想法。</p></li><li value="3"><p>查看 <code>app-upgrade.log</code> 文件内容。命令行中显示的任何错误也会出现在 <code>app-upgrade.log</code> 文件中，通常包含更多详细信息。</p></li><li value="4"><p>查看 <code>tabadmincontroller.log</code> 文件内容。在上述两个实例中不容易识别的升级问题可能是作业中问题的结果。<code>tabadmincontroller.log</code> 文件可能包含有助于诊断问题的更多信息。</p><p><strong>注意</strong>：有关日志文件位置的信息，请参见<a href="logs_loc.htm" class="MCXref xref" xrefformat="{paratext}">Tableau Server 日志和日志文件位置</a>。</p></li></ul></div><div><h3 is="heading-item" :level="3" id="由于备份还原文件位置的权限问题，升级失败"><a name="UpgradeBackupPerms"/>由于备份/还原文件位置的权限问题，升级失败</h3><p>对于 2022.1.0 之前的 Tableau Server 版本，如果备份/还原文件的文件位置没有正确的权限，升级脚本将失败，并出现无法读取备份文件或无法还原存储库的错误。</p><p>从版本 2022.1 开始，升级脚本会在开始升级之前确认备份/还原文件的文件位置权限，以便在升级到新版本 Tableau Server 期间可以在该位置写入和读取文件。</p><div><p>备份/还原文件位置所需的权限：</p><ul><div data-mc-conditions="Product.serverwindows"><li value="1">NetworkService：读/写/执行权限</li><li value="2">运行身份服务帐户：读/写/执行权限</li></div></ul></div><p>错误将类似于以下内容：</p><pre xml:space="preserve" data-mc-conditions="Product.serverwindows">The runas user does not have permission to read the backup file: &lt;backup/restore basefilepath&gt;.&#13; Repository restore failed.&#13; An error occurred during installation.&#13; An error occurred while restoring repository.</pre><p>TSM 用于备份和还原的位置由 <code>basefilepath.backuprestore</code> 配置键定义，并具有安装程序使用正确权限设置的默认值，但这些可能会受到组织 IT 规则的影响，或在您将位置更改为自己创建的位置的情况下受到影响。从 2022.1 开始提供的新命令允许您在创建备份/还原文件位置后立即检查其权限，以避免任何与权限相关的问题。有关该命令的详细信息，请参见<a href="cli_maintenance_tsm.htm#tsmValidateBackupBasefilepath" class="MCXref xref" xrefformat="{paratext}">tsm maintenance validate-backup-basefilepath</a>。</p><p>有关备份/还原文件路径的详细信息，请参见<a href="cli_default_filepaths_tsm.htm" class="MCXref xref" xrefformat="{paratext}">tsm File Paths</a>。</p></div><div><h2 is="heading-item" :level="2" id="常见设置导入问题"><a name="SettingsImportServer"/>常见设置导入问题</h2><div><h3 is="heading-item" :level="3" id="导入设置文件由于缺少服务而导致“在任何节点上都不存在”验证错误"><a name="ImportValidationError"/>导入设置文件由于缺少服务而导致“在任何节点上都不存在”验证错误</h3><p>如果要通过安装新版本的 Tableau Server 和从早期版本导入设置文件进行升级，则在运行 <code>tsm settings import</code> 命令时可能会遇到拓扑验证错误。</p><p>当您从旧版本的 Tableau Server 导出设置文件并将其导入新版本时，可能会发生这种情况，并且在两个版本之间向 Tableau 添加了新服务。</p><p>错误将类似于如下（特定服务可能不同）：</p><pre xml:space="preserve"><conditionaltext data-mc-conditions="Product.serverwindows">c:\Users\mytableau\Desktop</conditionaltext>&gt;tsm settings import -f 20183-export.json<br/><br/>Pending topology set.<br/>There are 1 topology validation errors/warnings.<br/><br/>Service 'elasticserver' is not present on any node in the cluster.<br/>Service: Elastic Server</pre><p>若要解决此问题，请将任何缺少的服务添加到 Tableau Server：</p><ol><li value="1"><p>对于产生了验证错误的任何服务，请添加实例计数为 1 的服务。</p><p>举例来说，如果群集中不存在 Elastic Server，请使用验证错误消息第一行中出现的服务名称将进程实例计数设置为 1：</p><pre xml:space="preserve">tsm topology set-process -n node1 -pr elasticserver -c 1</pre><p>为导致错误的每个服务重复此步骤。</p></li><li value="2"><p>当不再有警告或错误时，应用待处理的更改：</p><pre>tsm pending-changes apply</pre></li></ol><p>您的设置应成功导入。</p></div><div><h3 is="heading-item" :level="3" id="导入设置文件会导致“configuration-value-you-specified-does-not-match”错误">导入设置文件会导致“configuration value you specified does not match”错误</h3><p>如果要安装新版本的 Tableau Server 和从早期版本导入设置文件，则在运行 <code>tsm settings import</code> 命令时可能会遇到配置验证错误。当设置文件包含已从 Tableau 中移除的配置值时，可能会发生这种情况。</p><p>错误将类似于如下（配置键可能不同）：</p><pre xml:space="preserve"><conditionaltext data-mc-conditions="Product.serverwindows">c:\Users\mytableau\Desktop</conditionaltext>&gt;tsm settings import -f 20183-export.json&#13; Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'&#13; Use this parameter to override unknown key error: --force-keys</pre><p>若要解决此问题，请编辑要导入的设置文件以移除对错误中一个或多个配置键的引用：</p><ol><li value="1"><p>复制 JSON 设置文件并保存备份副本。</p></li><li value="2"><p>在纯文本编辑器中打开 JSON 设置文件。</p></li><li value="3"><p>找到并删除包含该键的整个行。此示例中为 <code>features.TsmConfigFileService</code>：</p><pre xml:space="preserve">"configKeys" : {&#13; "config.version" : 19,&#13; "tabadmincontroller.port" : "8850",&#13; "endpoints.enabled" : false,&#13; "endpoints.health.enabled" : true,&#13; <span style="background-color: #ffff00;">"features.TsmConfigFileService" : true,</span>&#13; "tableau_projects.language" : "en",</pre><p>以上是导出设置文件的一小部分的示例，并不表示文件的全部内容。</p></li><li value="4"><p>保存设置文件并再次导入。</p></li></ol><p>您可能会遇到与拓扑验证相关的其他错误。有关解决这些错误的信息，请参见<a href="#ImportValidationError" class="MCXref xref" xrefformat="{paratext}">导入设置文件由于缺少服务而导致“在任何节点上都不存在”验证错误</a>。</p></div><div><h3 is="heading-item" :level="3" id="“you-cannot-directly-modify-instances-of-the-coordination-service”（无法直接修改协调服务的实例）错误">“You cannot directly modify instances of the Coordination Service”（无法直接修改协调服务的实例）错误</h3><p>在两种情况下可能会发生此错误：</p><ul><li value="1">将 Tableau Server 设置文件导入到与设置文件具有不同的协调服务拓扑的安装中时</li><li value="2">当您尝试使用 <code>tsm topology set-process</code> 命令配置协调服务时</li></ul><h4>如果在导入设置文件后看到此错误：</h4><p>Tableau Server 设置文件具有与目标服务器不同的协调服务拓扑。如果要通过安装新版本和从更低版本导入设置文件来升级 Tableau Server，可能会发生这种情况。如果尚未在目标服务器上显式部署协调服务整体，则它在初始节点上具有协调服务的单一实例。</p><p>若要更正此错误，可以通过命令行纠正不匹配情况，也可以通过编辑设置导入文件来进行。您还可以放弃待处理更改，在目标计算机上部署协调服务以匹配导入文件中的设置，然后重新导入设置文件。</p><p>若要更正命令行中的不匹配情况，对于生成错误的每个节点，请使用 tsm topology set-process 命令还原协调服务的实例计数。</p><ol><li value="1"><p>运行 <code>tsm pending-changes list</code> 命令。输出显示哪些节点有更改。</p></li><li value="2"><p>查找协调服务计数有变化的一个或多个节点。</p><p>举例来说，如果设置文件在节点 2 上具有协调服务实例，但目标系统在该节点上没有任何协调服务实例，则节点 2 的计数将显示为通过导入设置文件从 0 更改为 1：</p><pre xml:space="preserve">C:\Windows\system32&gt;tsm pending-changes list&#13; Configuration&#13; There are no pending configuration changes.&#13; Topology&#13;