安装文档

您可以使用标准安装程序来安装文档。

此任务向您展示如何：

在 Windows 上安装文档
在 Windows 上卸载文档
在 Linux 上安装文档
在 Linux 上卸载文档

在开始之前：获取您的操作系统的文档介质 (DOC_Apps_3DEXP.AllOS) ，并按照 DS 安装指南中的说明启动安装。然后，使用本主题中的相关说明。有关在文本用户界面 (TUI) 模式或静默安装模式下安装文档的说明，请参阅 DS 安装指南。

在 Windows 上安装文档

继续安装。

3DEXPERIENCE R2022x 文档安装程序出现。

单击下一步.
选择安装目录。

默认的英文文档安装位置是C:\Program Files\Dassault Systemes\B424doc

若要选择不同的安装目录，请点击浏览... .
单击下一步.

所有文档组件的列表显示出来。
选择要安装的文档组件。

您可以安装的角色按行业分类。
- 使用筛选字段仅显示包含您筛选条件的组件进入。
- 点击展开树形结构或收起它。
- 点击选择所有角色或点击清除所有角色。。
- 显示可安装组件会列出所有可供安装的角色。
- 显示所选组件仅显示所选角色。
- 显示已安装的组件（如果可用）会列出已安装的角色。
组件通过角色名称来标识。某些组件需要选择额外的角色。

在您进行选择时，安装程序会更新有关可用空间和安装所需空间的信息。

当您选好要安装的组件后，点击下一步.
输入 Node.js 服务器的 HTTP 请求端口号，然后单击下一步.
Node.js 服务器托管文档。
清除设置邮件发送者属性以允许用户反馈，, 然后点击下一步.
选择使用反向代理, 然后单击下一步.

反向代理接收 HTTPS 请求，以将应用程序中的上下文帮助链接到已安装的文档。.

仅用于托管文档的 Node.js 服务器仅支持 HTTP 协议。3DEXPERIENCE 网页客户端仅接受 HTTPS 协议来定义应用程序上下文帮助的用户文档（此位置可在平台管理仪表板中更改）。需要反向代理将网页客户端的请求转发到 Node.js 服务器。
输入一个使用 https://myreverseproxyalias这种语法的 URL。

反向代理使用 https 协议，并将请求通过 http 协议转发给 Node.js 服务器。管理员必须在文档安装之外单独设置和安装反向代理。

重要提示： 已安装的语言不能作为反向代理别名的一部分，但在访问文档时必须包含在 URL 中。

例如，如果您在名为“myhostname”的主机上使用端口 4040 安装了英文文档，并且反向代理别名为 https://doc2022x, 则可以通过 https://doc2022x/English,访问英文文档，该地址会被转发到 Node.js 服务器的 http://myhostname:4040/English。
单击下一个.
输入 64 位 Java 运行时环境（JRE）的路径，然后单击下一个.
该文档使用 Java 服务器进行搜索。
输入一个可用的端口号以与 Java 服务器进行通信，然后单击下一个.
会出现一个列表，其中列出了将要安装文档的角色。
单击安装.
安装完成后，会显示一个列表，列出已安装文档的角色。
单击完成.

如果您指定 NativeApps 安装在默认安装文件夹中，则安装的环境文件中的 CATDocView 变量会更新为指向文档安装位置。否则，请使用 chcatenv 命令更新您环境中 CATDocView 变量的值，使其指向您为文档安装指定的位置。有关更多信息，请参阅《配置环境》。
要运行 Node.js 服务器，请打开 C:\Program Files\Dassault Systemes\B424doc\StartDocumentationUsingJavaSearch.txt 并按照说明操作。

在 Windows 上卸载文档

在 Windows 桌面，选择开始 > 控制面板 > 程序 > 卸载程序。
在程序列表中，双击 Dassault Systèmes Documentation 3DEXPERIENCE R2022x。

会弹出一个对话框，提示您确认是否要卸载该软件。
点击是以确认。

在 Linux 上安装文档

在开始之前：请确认您打算解压安装媒体的文件系统中有足够的可用磁盘空间。

获取文档介质 (DOC_Apps_3DEXP.AllOS) 并将其保存在所需的目录中。
在控制台中，导航至文档媒体位置。
运行以下命令： StartGUI.sh
安装程序出现了。

默认的安装位置是：
```
usr/DassaultSystemes/B424doc
```
选择要安装的文档组件。.

您可以安装的角色按行业分类。选择一个行业即包含该行业内的所有角色。
- 使用筛选字段仅显示包含您筛选条目的组件（仅适用于角色，不适用于行业）。
  符合筛选条件的角色数量会显示出来。
  如果移除筛选，已变更的选择不变。
- 点击开树形结构或收起它。
- 点击选择所有角色或点击 roles or 清除所有角色。
- 显示可安装组件会列出所有可供安装的角色。
- 显示所选组件仅显示所选角色。
- 显示已安装的组件（如果可用）会列出已安装的角色。
您可以将 “显示选定组件”与 “筛选器” 结合使用，以显示与筛选器匹配的选定角色。

组件通过角色名称来标识。某些组件需要选择额外的角色。

在您进行选择时，安装程序会更新有关可用空间和安装所需空间的信息。

当您选好要安装的组件后，点击下一步。
输入 Node.js 服务器的 HTTP 请求端口号，然后单击下一步。
Node.js 服务器托管文档。
取消定义邮件发送人的属性以允许发送用户反馈然后点击下一步。
选择使用反向代理, 然后单击下一步。

反向代理接收 HTTPS 请求，以将应用程序中的上下文帮助链接到已安装的文档。

仅用于托管文档的 Node.js 服务器仅支持 HTTP 协议。3DEXPERIENCE 网页客户端仅接受 HTTPS 协议来定义来自应用程序的上下文帮助的文档位置（此位置可在平台管理仪表板中更改）。需要一个反向代理来将网页客户端的请求转发到 Node.js 服务器。
输入一个URL 使用语法 https://myreverseproxyalias

反向代理使用 https 协议，并将请求通过 http 协议转发给 Node.js 服务器。管理员必须在文档安装之外单独设置和安装反向代理。

重要提示： 已安装的语言不能作为反向代理别名的一部分，但在访问文档时必须包含在 URL 中。

例如，如果您在名为“myhostname”的主机上使用端口 4040 安装了英文文档，并且反向代理别名为 https://doc2022x，则可以通过 https://doc2022x/English 访问英文文档，该地址会被转发到 Node.js 服务器的 http://myhostname:4040/English
单击下一步.
输入 64 位 Java 运行时环境（JRE）的路径，然后单击下一步。
帮助文档使用 Java 服务进行搜索。
输入一个可用的端口号以与 Java 服务器进行通信，然后单击下一步.
将要安装文档的角色列表会显示出来。
点击安装。
安装完成后，会显示一个列表，列出已安装文档的角色。
单击完成。
如果您指定 NativeApps 安装在默认安装文件夹中，则安装的环境文件中的 CATDocView 变量会更新为指向文档安装位置。否则，请使用 chcatenv 命令更新您环境中 CATDocView 变量的值，使其指向您为文档安装指定的位置。有关更多信息，请参阅《配置环境》。
要运行 Node.js 服务器，请打开 usr/DassaultSystemes/B424doc/StartDocumentationUsingJavaSearch.txt 并按照说明操作。说明中提到运行 node.exe 的地方，请改为运行 node-v14.16.0-linux-x64。

在 Linux 上卸载文档

在控制台中，转到文档介质的安装目录。
运行以下命令： Uninstall.sh
出现一条警告消息。请确认您想要卸载文档介质。
卸载开始，随后出现一条成功消息。