跳转至

Install a Remote Agent for 4.6C/620/640（安装 4.6C/620/640 版本的远程代理）

The Palantir Foundry Connector 2.0 for SAP Applications ("Connector") Remote Agent for 4.6C/620/640 is shipped as an SAP Request to be transported via the SAP Transport Management System. You can follow these steps in order to import the requests to an SAP system.

Installation steps

  1. Download the installation packages.

  2. Extract the Connector Remote Agent for 4.6c, 4.70 (620/640) into a folder. If the SAP system is Unicode, then Unicode requests should be used; otherwise non-Unicode requests should be used. The files will be as follows (request numbers may vary depending on the version to be installed):

  3. Connector files

  4. K900xxx.C46
  5. R900xxx.C46
  6. Remote Agent files
  7. K900xxx.C46

  8. R900xxx.C46

  9. Filenames that start with an "R" are data files; filenames starting with "K" are cofiles. Copy files accordingly to their corresponding folder listed below on the SAP Application Server:

    /usr/sap/trans/cofiles
    /usr/sap/trans/data
  1. Log into the SAP system with a user authorized to use STMS (SAP Transport Management System).
  2. Run the STMS transaction.
  3. Select the target system for the transport.
  4. From the toolbar menu, select Extras > Other Requests > Add then type the request number. (The request number is as follows: C46K9000xx. The first 3 digits are for the request file extension; the remaining digits are the K filename as seen in the extracted files.)
  5. The request is listed on the import queue. Now select the request by clicking the request number and then select Import on the toolbar.
  6. Go to the Options tab, select Leave Transport Request in Queue for Later Import and Ignore Invalid Component Version. Then start the transport.
  7. Check the import logs by clicking the logs button on the toolbar.
  8. Check if there are any error messages. A successful import should complete with no errors.
  9. Go to PFCG transaction code and generate authorization profiles for the following roles:
    • /PALAGT47/SERVICE_USER
    • /PALAGT47/CONTENT_RTABLE_ALL

Configuration

The Connector and the Connector Remote Agent communicate via SAP remote function calls (RFCs). Therefore, two RFC connections are needed: one from the Connector to the Remote Agent, and one from the Remote Agent to the Connector. The next section details how to create these RFC connections.

RFC configuration

The RFC configuration requires four steps:

  1. Create an RFC connection to the SAP system.
  2. Create an RFC from the Connector to the remote SAP system (SOURCE).
  3. Create an RFC from the remote SAP system to the Connector (TARGET).
  4. Test the Connector Remote Agent via a web browser.

Create an RFC destination connection to the source/target system

In this section, two RFC Connects are needed: one from Connector to Remote Agent, and another from Remote Agent to Connector. Review the Create RFC connection guide.

:::callout{theme="neutral"} Repeat the same steps for the target RFC definition from the remote SAP system to the Connector. Instead of calling it SAP\_SOURCE, you may call it SAP\_TARGET. (These names can be freely defined.) :::

Configure Remote Agent and register the Connector

  1. Log into the primary Connector system.
  2. Run transaction /n/PALANTIR/PARAM_A1.
  3. Enter the following parameter values:
  4. Agent ID: AGENT Identifier (also known as CONTEXT)
  5. Is 4.7 or older: AGENT Version Flag
  6. Agent Desc: AGENT Description (for reference use)
  7. Run transaction /n/PALANTIR/PARAM_A2 and enter the following parameters:
  8. Agent ID: AGENT ID (as defined in the previous step)
  9. Param ID: PARAM ID (a classification of parameters)
  10. Param Name: Parameter name (used by the AGENT)
  11. Param Value: Parameter value (used by the AGENT)
Param Id Param Name Param Values Description
RFC SOURCE RFC Connection from Connector to remote SAP system.
RFC TARGET RFC Connection from remote SAP system to Connector.
SYSTEM CPU_CHECK TRUE / FALSE Enables or disables CPU checks.
SYSTEM MEMORY_CHECK TRUE / FALSE Enables or disables MEMORY checks.
SYSTEM RESOURCE_CHECK TRUE / FALSE Enables or disables RESOURCE checks. If FALSE, all checks are disabled; if TRUE, other parameters (CPU_CHECK and MEMORY_CHECK) are checked.
SYSTEM CONTINUOUS_RESOURCE_CHECK TRUE / FALSE Enables resource checks for all requests (init and all paging requests). If FALSE, resource checks are only carried out for the init request.
SYSTEM PROCESS_CHECK TRUE / FALSE Enables checks on the minimum number of permitted work processes; works in conjunction with PROCESS_MIN_BG and PROCESS_MIN_DIA.
SYSTEM_THRESHOLD PROCESS_MIN_BG numeric Minimum required number of background process available on the SAP Application Server.
SYSTEM_THRESHOLD PROCESS_MIN_DIA numeric Minimum required number of dialog process available on the SAP Application Server.

Limitations

The Connector Remote Agent for 4.6C/620/640 has the following limitations:

  • Only table interface is supported.
  • Only single incremental type is supported.
  • useTsvFormat:true should be set in the Data Connection source configuration in Foundry. Therefore, a separate source is recommended for 4.6C/620/640 even if there is already an existing source available in Foundry for the main Connector instance.

中文翻译

安装 4.6C/620/640 版本的远程代理

适用于 SAP 应用的 Palantir Foundry Connector 2.0（以下简称"连接器"）的 4.6C/620/640 远程代理以 SAP 请求（SAP Request）形式提供，需通过 SAP 传输管理系统（SAP Transport Management System）进行传输。请按照以下步骤将请求导入 SAP 系统。

安装步骤

  1. 下载安装包。

  2. 将 4.6c、4.70 (620/640) 版本的连接器远程代理解压至文件夹。若 SAP 系统为 Unicode 系统，则应使用 Unicode 请求；否则使用非 Unicode 请求。文件列表如下（请求编号可能因安装版本不同而异）：

  3. 连接器文件

  4. K900xxx.C46
  5. R900xxx.C46
  6. 远程代理文件
  7. K900xxx.C46

  8. R900xxx.C46

  9. 文件名以"R"开头的为数据文件（data files）；以"K"开头的为协同文件（cofiles）。请将相应文件复制到 SAP 应用服务器（SAP Application Server）的以下对应文件夹中：

    /usr/sap/trans/cofiles
    /usr/sap/trans/data
  1. 使用具有 STMS（SAP 传输管理系统）权限的用户登录 SAP 系统。
  2. 运行 STMS 事务代码。
  3. 选择传输的目标系统。
  4. 在工具栏菜单中选择 附加 > 其他请求 > 添加，然后输入请求编号。（请求编号格式为：C46K9000xx。前三位数字为请求文件扩展名，其余数字为解压文件中 K 文件的文件名。）
  5. 该请求将显示在导入队列中。点击请求编号选中该请求，然后在工具栏中选择 导入。
  6. 进入 选项 标签页，勾选 将传输请求保留在队列中以备后续导入 和 忽略无效组件版本。然后开始传输。
  7. 点击工具栏上的日志按钮，检查导入日志。
  8. 检查是否存在错误信息。成功导入应无任何错误。
  9. 进入 PFCG 事务代码，为以下角色生成权限配置文件（authorization profiles）：
    • /PALAGT47/SERVICE_USER
    • /PALAGT47/CONTENT_RTABLE_ALL

配置

连接器与连接器远程代理通过 SAP 远程函数调用（RFCs）进行通信。因此，需要建立两个 RFC 连接：一个从连接器到远程代理，另一个从远程代理到连接器。下一节将详细介绍如何创建这些 RFC 连接。

RFC 配置

RFC 配置包含四个步骤：

  1. 创建到 SAP 系统的 RFC 连接。
  2. 创建从连接器到远程 SAP 系统（源系统，SOURCE）的 RFC。
  3. 创建从远程 SAP 系统到连接器（目标系统，TARGET）的 RFC。
  4. 通过网页浏览器测试连接器远程代理。

创建到源/目标系统的 RFC 目标连接

本节需要创建两个 RFC 连接：一个从连接器到远程代理，另一个从远程代理到连接器。请参阅创建 RFC 连接指南。

:::callout{theme="neutral"} 对于从远程 SAP 系统到连接器的目标 RFC 定义，请重复相同步骤。您可以将此连接命名为 SAP\_TARGET 而非 SAP\_SOURCE。（这些名称可自由定义。） :::

配置远程代理并注册连接器

  1. 登录主连接器系统。
  2. 运行事务代码 /n/PALANTIR/PARAM_A1。
  3. 输入以下参数值：
  4. Agent ID（代理 ID）： 代理标识符（也称为 CONTEXT）
  5. Is 4.7 or older（是否为 4.7 或更早版本）： 代理版本标志
  6. Agent Desc（代理描述）： 代理描述（供参考使用）
  7. 运行事务代码 /n/PALANTIR/PARAM_A2 并输入以下参数：
  8. Agent ID（代理 ID）： 代理 ID（与上一步定义一致）
  9. Param ID（参数 ID）： 参数 ID（参数的分类）
  10. Param Name（参数名称）： 参数名称（由代理使用）
  11. Param Value（参数值）： 参数值（由代理使用）
参数 ID 参数名称 参数值 描述
RFC SOURCE 从连接器到远程 SAP 系统的 RFC 连接。
RFC TARGET 从远程 SAP 系统到连接器的 RFC 连接。
SYSTEM CPU_CHECK TRUE / FALSE 启用或禁用 CPU 检查。
SYSTEM MEMORY_CHECK TRUE / FALSE 启用或禁用内存检查。
SYSTEM RESOURCE_CHECK TRUE / FALSE 启用或禁用资源检查。若设为 FALSE，则所有检查均被禁用；若设为 TRUE，则检查其他参数（CPU_CHECK 和 MEMORY_CHECK）。
SYSTEM CONTINUOUS_RESOURCE_CHECK TRUE / FALSE 对所有请求（初始请求及所有分页请求）启用资源检查。若设为 FALSE，则仅对初始请求执行资源检查。
SYSTEM PROCESS_CHECK TRUE / FALSE 启用对允许的最小工作进程数的检查；需与 PROCESS_MIN_BG 和 PROCESS_MIN_DIA 配合使用。
SYSTEM_THRESHOLD PROCESS_MIN_BG 数值 SAP 应用服务器上所需的最小后台进程数。
SYSTEM_THRESHOLD PROCESS_MIN_DIA 数值 SAP 应用服务器上所需的最小对话进程数。

限制

4.6C/620/640 版本的连接器远程代理存在以下限制：

  • 仅支持 table 接口。
  • 仅支持 single 增量类型。
  • 在 Foundry 的数据连接源配置中，应将 useTsvFormat:true 设置为启用。因此，即使 Foundry 中已存在主连接器实例的源，也建议为 4.6C/620/640 单独创建一个源。