Install a Support Package（安装支持包(Support Package)）¶
Support packages are collections of bug fixes and new features delivered after the initial installation package.
The standard support package installation procedure should be followed for the Palantir Foundry Connector 2.0 for SAP Applications ("Connector") via SPAM (Support Package Manager).
:::callout{theme="warning"} During support package installation, suspend the housekeeping job schedule and all Foundry data syncs that use the Connector. Failing to do so may cause the installation to fail due to database locks held by background processes. :::
Use the installation file in SAR format (FOUNDRY-SAPCONN-INST-SP00SPXX.SAR). XX represents the support package level. Depending on the support package level installed on the system, SPAM will load the necessary files to perform the upgrade.
- Download the installation packages.
- Log into the SAP system client 000 with a user authorized to use SPAM.
- Run the SPAM transaction.
- Import packages from the application server.
- To import, select Installation package > Load Packages > From Front End from the toolbar menu.
- Define the queue for support package installation.
:::callout{theme="neutral"}
All Connector components should be upgraded together. Upgrade PALCONN and PALANTIR or PALANTIR and PALAGENT components together.
:::
- Select the application component. To upgrade PALANTIR components together, select All Components, then only select PALANTIR components to the desired support package level. Ensure no other component is selected for the upgrade process.
- On the SPAM: Import: Queue dialog, set Preparation as Start in Dialog and all other steps as Continue in Background.
:::callout{theme="neutral"} Should warnings be flagged during the installation, follow steps as described in the warning message to resolve. In most cases, warning messages can be ignored for Connector and Remote Agent installations. In particular, the warning message with the heading "Open Data Extraction Requests" can be safely ignored. :::
- After import completes successfully, confirm the queue.
Keeping SPAM/SAINT SP level and tp/R3Trans patches up-to-date is critical. In case an issue arises during DDIC_ACTIVATION, use mass activation program (RADMASG0) from SAP and enable the Force Activation Flag.
:::callout{theme="danger"}
There may be SAP security updates between support packages, leading to new authorization objects being added. Therefore, if custom roles are being used, it is highly recommended to compare the content of the /PALANTIR/* roles with the custom roles. If /PALANTIR/* roles are in use, ensure that all user comparisons are completed, authorization profiles are generated and green.
:::
中文翻译¶
安装支持包(Support Package)¶
支持包(Support Package)是在初始安装包之后交付的包含错误修复和新功能的集合。
对于适用于SAP应用的Palantir Foundry Connector 2.0（简称"连接器(Connector)"），应通过SPAM（支持包管理器(Support Package Manager)）遵循标准支持包安装流程。
:::callout{theme="warning"} 在支持包安装期间，请暂停所有使用该连接器的后台作业调度和Foundry数据同步。若未执行此操作，后台进程持有的数据库锁可能导致安装失败。 :::
使用SAR格式的安装文件（FOUNDRY-SAPCONN-INST-SP00SPXX.SAR）。其中XX代表支持包级别。根据系统上已安装的支持包级别，SPAM将加载执行升级所需的必要文件。
- 下载安装包
- 使用具有SPAM授权权限的用户登录SAP系统客户端000
- 运行SPAM事务代码
- 从应用服务器导入包
- 要执行导入，请从工具栏菜单中选择安装包(Installation package) > 加载包(Load Packages) > 从前端(From Front End)
- 定义支持包安装队列
:::callout{theme="neutral"}
所有连接器组件应一同升级。请同时升级PALCONN和PALANTIR，或PALANTIR和PALAGENT组件。
:::
- 选择应用组件。要同时升级PALANTIR组件，请选择所有组件(All Components)，然后仅选择PALANTIR组件至所需支持包级别。确保未选择其他组件进行升级。
- 在SPAM: 导入: 队列(SPAM: Import: Queue)对话框中，将准备(Preparation)设置为在对话框中启动(Start in Dialog)，其他所有步骤设置为在后台继续(Continue in Background)。
:::callout{theme="neutral"} 若安装过程中出现警告，请按照警告消息中的描述步骤进行解决。在大多数情况下，连接器和远程代理(Remote Agent)安装的警告消息可以忽略。特别是标题为"开放数据提取请求(Open Data Extraction Requests)"的警告消息可以安全忽略。 :::
- 导入成功完成后，确认队列。
保持SPAM/SAINT支持包级别和tp/R3Trans补丁为最新版本至关重要。如果在DDIC_ACTIVATION过程中出现问题，请使用SAP的批量激活程序（RADMASG0）并启用强制激活标志(Force Activation Flag)。
:::callout{theme="danger"}
支持包之间可能存在SAP安全更新，导致新增授权对象。因此，如果正在使用自定义角色，强烈建议将/PALANTIR/*角色与自定义角色进行内容比较。如果正在使用/PALANTIR/*角色，请确保完成所有用户比较，生成授权配置文件并显示为绿色状态。
:::