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) 참조하세요.

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

# Amazon EC2에서 메인프레임 런타임에 대한 AWS 변환 업그레이드
<a name="ba-runtime-maint-ec2"></a>

이 가이드에서는 Amazon EC2에서 메인프레임 런타임의 AWS 변환을 업그레이드하는 방법을 설명합니다.

**Topics**
+ [사전 조건](#ba-runtime-maint-prereq)
+ [Amazon EC2 인스턴스에서 메인프레임 런타임에 대한 AWS 변환 업그레이드](#ba-runtime-maint-copy-files)
+ [컨테이너에서 메인프레임 런타임에 대한 AWS 변환 업그레이드](#ba-runtime-maint-copy-files)

## 사전 조건
<a name="ba-runtime-maint-prereq"></a>

시작하기 전에 다음 사전 조건을 충족하는지 확인합니다.
+ 버전에 대한 특정 지침이 있는지 확인하려면 [메인프레임용 AWS 변환 지침 업그레이드](ba-migration-notes.md) 섹션을 참조하세요.
+ [AWS 메인프레임 런타임 사전 조건에 대한 변환](ba-runtime-setup-prereq.md) 및 [메인프레임 런타임에 대한 온보딩 AWS 변환](ba-runtime-setup-onboard.md)를 완료합니다.
+ 메인프레임 런타임 설치를 위한 기존 AWS 변환이 있는 Amazon EC2 인스턴스가 있는지 확인합니다. 자세한 내용은 [Amazon EC2 Linux 인스턴스 시작하기](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)를 참조하세요.
+ 예를 들어 SSM을 사용하여 Amazon EC2 인스턴스에 성공적으로 연결할 수 있는지 확인하세요.
+ 업그레이드하려는 메인프레임 런타임 버전의 AWS 변환을 다운로드합니다. 프레임워크는 `gapwalk-x.y.z.zip` 및 라는 두 개의 아카이브 파일로 구성됩니다`aws-bluage-webapps-x.y.z.zip`. 자세한 내용은 [AWS 메인프레임 런타임 아티팩트에 대한 변환](ba-runtime-artifacts.md) 단원을 참조하십시오.

## Amazon EC2 인스턴스에서 메인프레임 런타임에 대한 AWS 변환 업그레이드
<a name="ba-runtime-maint-copy-files"></a>

메인프레임 런타임의 AWS 변환을 업그레이드하려면 다음 단계를 완료하세요.

1. Amazon EC2 인스턴스에 연결하고 다음 명령을 실행하여 사용자를 **su**로 변경합니다.

   ```
   sudo su
   ```

   이 자습서의 명령을 실행하려면 최고 사용자 권한이 필요합니다.

1. 바이너리를 추출하려면 다음 명령을 사용합니다. 각 폴더에서 명령을 실행합니다.

   ```
   unzip gapwalk-x.y.z.zip
   unzip aws-bluage-webapps-x.y.z.zip
   ```

1. 다음 명령을 사용하여 Tomcat 서비스를 중지합니다.

   ```
   systemctl stop tomcat.service
   systemctl stop tomcat-webapps.service
   ```

1. `<your-tomcat-path>/shared/`의 내용을 `gapwalk-x.y.z/shared/`의 내용으로 바꾸세요.

1. `<your-tomcat-path>/webapps/gapwalk-application.war`를 `gapwalk-x.y.z/webapps/gapwalk-application.war`로 바꿉니다.

1. `<your-tomcat-path>/webapps/`의 war 파일, 즉 `bac.war` 및 `jac.war`를 `aws-bluage-webapps-x.y.z/velocity/webapps/`의 같은 파일로 바꾸세요.

1. 다음 명령을 실행하여 Tomcat 서비스를 시작합니다.

   ```
   systemctl start tomcat.service
   systemctl start tomcat-webapps.service
   ```

1. 로그를 확인합니다.

다음 명령을 실행하여 배포된 애플리케이션의 상태를 확인합니다.

```
curl http://localhost:8080/gapwalk-application/
```

다음 메시지가 나타납니다.

```
Jics application is running
```

```
curl http://localhost:8181/jac/api/services/rest/jicsservice/
```

다음 메시지가 나타납니다.

```
Jics application is running
```

```
curl http://localhost:8181/bac/api/services/rest/bluesamserver/serverIsUp
```

응답은 비워 두어야 합니다.

메인프레임 런타임에 대한 AWS 변환이 성공적으로 업그레이드되었습니다.

## 컨테이너에서 메인프레임 런타임에 대한 AWS 변환 업그레이드
<a name="ba-runtime-maint-copy-files"></a>

메인프레임 런타임의 AWS 변환을 업그레이드하려면 다음 단계를 완료하세요.

1. 메인프레임 런타임 버전에 대해 원하는 AWS 변환을 사용하여 도커 이미지를 다시 빌드합니다. 지침은 [Amazon EC2에서 메인프레임 런타임에 대한 AWS 변환 설정](ba-runtime-deploy-ec2.md) 섹션을 참조하세요.

1. Docker 이미지를 Amazon ECR 리포지토리에 푸시합니다.

1. Amazon ECS 또는 Amazon EKS 서비스를 중지했다가 다시 시작합니다.

1. 로그를 확인합니다.

메인프레임 런타임에 대한 AWS 변환이 성공적으로 업그레이드되었습니다.