AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 安装文件传输代理
<a name="m2-agent-installation"></a>

您可以使用本文档作为 step-by-step指南，在源主机上安装代理。

**注意**  
本指南仅面向大型机系统程序员。

**Topics**
+ [

## 步骤 1：为 M2 代理创建一个 zFS 数据集
](#allocate-dataset)
+ [

## 步骤 2：将数据集格式化为 zFS
](#format-dataset)
+ [

## 步骤 3：挂载文件系统
](#mount-filesystem)
+ [

## 步骤 4：验证挂载
](#verify-mount)
+ [

## 步骤 5：输入 OMVS
](#enter-omvs)
+ [

## 步骤 6：设置代理安装目录环境变量
](#agent-directory)
+ [

## 步骤 7：设置工作目录环境变量
](#work-directory)
+ [

## 步骤 8：创建工作目录
](#create-work-directory)
+ [

## 步骤 9：复制代理 tar 文件并复制工作目录
](#agent-tar-package)
+ [

## 步骤 10：完成代理安装
](#finish-agent-installation)

## 步骤 1：为 M2 代理创建一个 zFS 数据集
<a name="allocate-dataset"></a>

使用下面的 JCL（作业控制语言）为 M2 代理安装创建一个 zFS：

```
DEFINE   EXEC   PGM=IDCAMS
SYSPRINT DD     SYSOUT=A
SYSIN    DD     *
 DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
 VOLUMES(*) -
 LINEAR CYL(1000 200))
```

## 步骤 2：将数据集格式化为 zFS
<a name="format-dataset"></a>

创建数据集后，将其格式化为 zFS 文件系统。

一种方法是使用以下 JCL：

```
FORMAT  EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD  SYSOUT=*
```

提交此作业并检查其是否成功完成。

## 步骤 3：挂载文件系统
<a name="mount-filesystem"></a>

要挂载文件系统，请使用 `MOUNT` 命令。您可以在 ISPF 的命令行中或批量挂载文件系统。

例如：

```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```

您将在步骤 6 中使用此挂载点。

**注意**  
定义挂载路径是可选的，您应该使用现有目录来定义挂载路径。

## 步骤 4：验证挂载
<a name="verify-mount"></a>

使用 `D OMVS,F` 命令或在 Unix 系统服务（USS）中进行检查，来验证文件系统是否已正确挂载。

## 步骤 5：输入 OMVS
<a name="enter-omvs"></a>

使用以下命令输入 OMVS：

```
TSO OMVS
```

## 步骤 6：设置代理安装目录环境变量
<a name="agent-directory"></a>

使用以下命令设置代理安装目录环境：

```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```

**注意**  
挂载点在步骤 3 中定义。

## 步骤 7：设置工作目录环境变量
<a name="work-directory"></a>

使用以下命令设置工作目录环境变量：

```
export WORK_DIR=$AGENT_DIR/tmp
```

## 步骤 8：创建工作目录
<a name="create-work-directory"></a>

使用以下命令设置工作目录环境：

```
mkdir -p $WORK_DIR
```

## 步骤 9：复制代理 tar 文件并复制工作目录
<a name="agent-tar-package"></a>

使用 [M2 代理链接](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar)从 AWS 下载代理 tar 文件。

传输机制取决于您的环境，但请确保以二进制模式传输该 tar 文件。

## 步骤 10：完成代理安装
<a name="finish-agent-installation"></a>

按照以下步骤完成代理安装。

1. 使用以下命令将 m2 代理版本环境变量设置为当前正在安装的版本：

   ```
   export M2_AGENT_VERSION=1.0.0
   ```

1. 使用以下命令解压缩代理 tar 软件包：

   ```
   tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
   ```

1. 使用以下命令创建指向当前代理安装目录的 `current-version` 符号链接：

   ```
   ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
   ```

1. 更新并提交 `CPY#PDS` 以创建文件传输代理数据集。
**注意**  
JCL 使用 `SYS2.AWS.M2 HLQ`。

   要创建文件传输代理，请更新稍后将在 JCL 中使用的三个符号变量 HLQ（高级限定符）、`VOLSER` 和 `AGNTPATH`：

   ```
   oedit $AGENT_DIR/current-version/installation/CPY#PDS 
   ```

**注意**  
此 JCL 专为在大型机上设置代理安装的某些方面而量身定制。它分配必要的数据集，然后将特定文件从 Unix 文件系统复制到这些数据集。