

AWS Mainframe Modernization Service(관리형 런타임 환경 환경 환경)는 더 이상 신규 고객에게 공개되지 않습니다. AWS Mainframe Modernization Service(관리형 런타임 환경 환경)와 유사한 기능은 AWS Mainframe Modernization Service(자체 관리형 환경)를 참조하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS Mainframe Modernization 가용성 변경을](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html) 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# File Transfer 에이전트 설치
<a name="m2-agent-installation"></a>

이 문서를 단계별 가이드로 사용하여 소스 메인프레임에 에이전트를 설치할 수 있습니다.

**참고**  
이 안내서는 메인프레임 시스템 프로그래머 전용입니다.

**Topics**
+ [1단계: M2-agent에 대한 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-agent에 대한 zFS 데이터 세트 생성
<a name="allocate-dataset"></a>

아래 JCL(작업 제어 언어)을 사용하여 M2-agent 설치를 위한 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>

데이터 세트를 만든 후 z/FS 파일 시스템으로 포맷합니다.

이를 위한 한 방법은 다음과 같은 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-agent 버전 환경 변수를 현재 설치 중인 버전으로 설정합니다.

   ```
   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`를 업데이트하고 제출하여 File Transfer 에이전트 데이터 세트를 생성합니다.
**참고**  
JCL은 `SYS2.AWS.M2 HLQ`를 사용합니다.

   File Transfer 에이전트를 생성하려면 JCL에서 나중에 사용할 세 가지 기호 변수 HLQ(고수준 한정자), `VOLSER` 및 `AGNTPATH`를 업데이트합니다.

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

**참고**  
이 JCL은 메인프레임에 에이전트 설치의 특정 측면을 설정하는 데 맞게 조정되었습니다. 필요한 데이터 세트를 할당한 다음, Unix 파일 시스템의 특정 파일을 해당 데이터 세트로 복사합니다.