Enginframe | 技术参数说明

## 1. **简介和架构**

EF Portal 是一个启用网格（grid\-enabled）的应用程序门户，旨在为用户提供友好、便捷的 HPC 作业提交、控制和监控界面。它集成了复杂的数据管理功能，涵盖了作业生命周期的所有阶段。EF Portal 与大多数重要的作业调度器和中间件工具集成，以实现作业的提交、监控和管理。它采用模块化系统设计，允许用户轻松添加新功能，例如应用程序集成、认证源和许可证监控，并提供了一个复杂的 Web 服务接口，可用于增强现有应用程序和开发定制解决方案。

EF Portal 的架构分为三个层次：

**客户端层 (Client Tier)**：通常由用户的 Web 浏览器组成，提供直观的软件界面，使用如 XHTML 和 JavaScript® 等既定的 Web 标准。该层独立于最终用户使用的特定软件和硬件环境。此外，客户端层还可以集成如 NICE DCV 等远程可视化技术。

**服务器层 (Server Tier)**：包含一个 **EF Portal Server**，负责与 EF Portal Agent 交互并管理用户互动。EF Portal Server 是一个 Java™ Web 应用程序，部署在 Java Servlet 容器（例如自带的 Apache Tomcat® 9\.0\.86）中，并向用户公开服务。

**资源层 (Resource Tier)**：由部署在后端基础设施上的一个或多个 **Agent** 组成。Agent 是一种独立的 Java™ 应用程序，代表用户管理计算资源，并与底层操作系统、作业调度器或网格基础设施交互以运行 EF Portal 服务，例如启动作业、移动数据和检索集群负载。

这种架构抽象了计算资源和数据管理（资源层），并通过服务器层向用户公开服务，用户直接从浏览器访问这些服务（客户端层）。

![](/media/202512/20251215092233138999.png)

![图形用户界面AI 生成的内容可能不正确。](/media/202512/20251215092233148621.png)

![图形用户界面AI 生成的内容可能不正确。](/media/202512/20251215092233154791.png)

## 2. **详细技术参数**

### **2\.1 支持的分布式资源管理器（DRM）**

EF Portal 支持多种分布式资源管理器 (DRM)，并且单个 EF Portal 实例可以同时访问多个 DRM。

| DRM 名称 | 支持版本 | 备注 |
| --- | --- | --- |
| **IBM® Platform™ LSF®** | 10\.1\.x | 需要在 EF Portal Agent 主机上安装 LSF 客户端软件。 |
| **Altair® PBS Professional®** | 19\.2\.x \- 2020\.1\.x | 需要在 EF Portal Agent 主机上安装 PBS Professional® 客户端软件。 |
| **OpenPBS®** | 19\.1\.x \- 20\.0\.x | 需要在 EF Portal Agent 主机上安装 OpenPBS® 客户端软件。 |
| **SLURM™** | 19\.05\.x \- 23\.0\.x | 需要在 EF Portal Server 主机上安装 SLURM™ 二进制文件。 |
| **Sun® Grid Engine (SGE)** | 8\.1\.x | 需要在 EF Portal Agent 主机上安装 Grid Engine 客户端软件。 |
| **Univa® Grid Engine® (UGE)** | 8\.6\.x | 需要在 EF Portal Agent 主机上安装 Grid Engine 客户端软件。 |
| **Son of Grid Engine (SoGE)** | 8\.1\.x | 需要在 EF Portal Agent 主机上安装 Grid Engine 客户端软件。 |
| **Gridware** | 9\.x | 需要在 EF Portal Agent 主机上安装 Gridware 客户端软件。 |
| **AWS Batch** | 使用 AWS ParallelCluster 3\.x 及 AWS ParallelCluster Batch CLI 1\.0\.0 | 需要创建 AWS Batch 集群并配置用户权限。 |

**集成现状但不受支持的 DRM** ：

AWS HPC Connector 的集成保持现状（as\-is）且不受支持。它要求 AWS ParallelCluster 版本为 3\.0\.2 或更高。

![](/media/202512/20251215092233162785.png)

### **2\.2 支持的认证方式**

EF Portal 的认证框架支持多种认证方法，用户也可以创建自己的自定义认证模块。

| 认证方式 | 先决条件/备注 |
| --- | --- |
| **PAM** (可插拔认证模块) | Linux® PAM 必须正确配置。这是最常用的认证方法。 |
| **LDAP** | ldapsearch 命令必须安装并能在 EF Portal Agent 主机上正常工作。用于针对 LDAP 服务器进行认证。 |
| **Active Directory** (AD) | 用于针对 Active Directory 服务器进行认证。 |
| **HTTP 认证** | 依赖于外部 HTTP 认证系统，该系统向用户请求添加 HTTP 认证头。EF Portal 信任此 HTTP 认证头。 |
| **证书认证** | 需要在 EF Portal Server 和客户端之间安装和交换 SSL 证书。在 Web 服务器上完成认证。 |

所有内置的认证模块都支持用户映射功能，即允许用户使用与底层计算环境账户名不同的用户名登录门户。

![图形用户界面, 文本, 应用程序AI 生成的内容可能不正确。](/media/202512/20251215092233171351.png)

### **2\.3 REST API (EF Portal 2025\.0\)**

EF Portal 2025\.0 引入了**尖端、功能丰富的 REST API**，旨在简化和增强集成体验，取代了传统的基于 Java 的 Web Services 方法。

**关键特性：**

• **JSON 输出**：数据交换简化为 JSON 格式，便于集成到脚本、命令行工具和第三方应用程序中。

• **编程作业提交**：支持直接通过脚本或命令行实现作业提交的自动化。

• **全面的作业管理**：提供查询作业信息、控制作业状态（取消、暂停、恢复）和实时监控进度的能力。

• **集群节点洞察**：可收集有关集群节点的详细信息，以改进资源管理。

• **文件管理能力**：支持将文件直接上传到 EF Portal，以及高效地监控和下载 HPC 作业的输出文件。

• **用户监控**：支持监控已登录用户，以便更好地进行监督、安全管理和许可证使用分析。

• **集成简便性**：基于 OpenAPI/Swagger 标准构建，支持跨调度器和跨平台兼容性。

**API 结构：**

EF Portal API 被组织为三个主要类别，便于导航和使用：

1\. **HPC Schedulers (HPC 调度器)**：管理主机、作业和队列。

2\. **Monitor (监控)**：访问用户信息和管理许可证（仅限管理员操作）。

3\. **System (系统)**：处理服务、Spooler 和文件操作。

**客户端工具：**

新的 EF Portal 客户端 **efpclient** 使用 Python 实现，提供了对 REST API 功能的简易消费，可通过 PyPi 获取或pip install下载安装。

![图形用户界面, 文本, 应用程序AI 生成的内容可能不正确。](/media/202512/20251215092233179267.png)

### **2\.4 功能插件和扩展**

EF Portal 采用插件（Plugins）来扩展功能。插件可以扩展到多个领域，包括核心系统、认证、数据、网格连接和实用工具。

• **Interactive Plugin (交互式插件)**：从 EF Portal 2021\.0 开始包含，作为一个可扩展且可靠的会话代理（Session Broker）运行，主要目的是简化应用程序交付和管理交互式会话。

◦ **远程可视化技术支持**: 支持 NICE DCV 2017\.x 或更高版本。

◦ **会话管理器支持**: 从版本 2020\.0 开始支持 NICE DCV Session Manager 作为会话代理。

• **VDI Plugin (Virtual Desktop)**：提供 Virtual Desktop 视图，供用户创建、管理和提交交互式服务。

• **Applications Plugin (Workspace)**：提供 Workspace 视图，用于创建、管理和提交批处理和交互式服务，用户可监控数据、会话、作业和主机状态。

• **Job History Service (作业历史服务)**：可在 Operational Dashboard 中启用，用于在数据库中存储长期作业历史数据。

• **MOTD integration (每日消息集成)**：EF Portal 2025\.2 版本新增易用插件，支持可配置的新闻（包括样式）。

• **Operational Dashboard (操作仪表板)**：为管理员提供了监控和管理操作的 Web 界面，包含服务器负载、使用统计、已安装组件、已登录用户、触发器和 ACL 参与者等服务。2025\.2 版本更新了仪表板，具有现代图形和全面的 EF Portal 状态监控功能。

![](/media/202512/20251215092233186080.png)