알려진 문제

1. 다음 명령을 실행하여 버전 2024.12의 patch.py cognito_sign_up_email_fix.patch 경우 및를 다운로드하고 버전 2024.12.01의 cognito_sign_up_email_fix.patch 경우 <output-directory>를 패치 스크립트 및 패치 파일을 다운로드할 디렉터리<environment-name>로 바꾸고를 RES 환경의 이름으로 바꿉니다.

   1. 패치는 RES 2024.12 및 2024.12.01에 적용됩니다.

   2. 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   3. RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   ENVIRONMENT_NAME=<environment-name>
   RES_VERSION=<res-version> # either 2024.12 or 2024.12.01
   
   mkdir -p ${OUTPUT_DIRECTORY}
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/${RES_VERSION}/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/${RES_VERSION}/patch_scripts/patches/cognito_sign_up_email_fix.patch --output ${OUTPUT_DIRECTORY}/cognito_sign_up_email_fix.patch 

2. 패치 스크립트와 패치 파일이 다운로드된 디렉터리로 이동합니다. 다음 패치 명령을 실행합니다.

   python3 ${OUTPUT_DIRECTORY}/patch.py --environment-name ${ENVIRONMENT_NAME} --res-version ${RES_VERSION} --module cluster-manager --patch ${OUTPUT_DIRECTORY}/cognito_sign_up_email_fix.patch
   

3. 환경의 Cluster Manager 인스턴스를 다시 시작합니다. Amazon EC2 Management Console에서 인스턴스를 종료할 수도 있습니다.

   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-cluster-manager \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

4. 이름으로 시작하는 Auto Scaling 그룹의 활동을 확인하여 Cluster Manager 인스턴스 상태를 확인합니다<RES-EnvironmentName>-cluster-manager-asg. 새 인스턴스가 성공적으로 시작될 때까지 기다립니다.

1. EC2 콘솔로 이동합니다. 이름이 인 인스턴스가 있는 경우 인스턴스를 CertificateRenewalNode-종료합니다.

2. Lambda 콘솔로 이동합니다. 라는 Lambda 함수의 소스 코드를 엽니다-CertificateRenewalLambda-. 로 시작하는 줄을 식별하고 --ocsp-must-staple 인수를 ./acme.sh --issue --dns dns_aws --ocsp-must-staple --keylength 4096 제거합니다.

3. 배포를 선택하고 코드 변경이 적용될 때까지 기다립니다.

4. Lambda 함수를 수동으로 트리거하려면 테스트 탭으로 이동한 다음 테스트를 선택합니다. 추가 입력은 필요하지 않습니다. 그러면 Secret Manager에서 인증서 및 PrivateKey 암호를 업데이트하는 인증서 EC2 인스턴스가 생성되어야 합니다. 보안 암호가 업데이트되면 인스턴스가 자동으로 종료됩니다.

5. 기존 dcv 게이트웨이 인스턴스를 종료<env-name>-vdc-gateway하고 Auto Scaling 그룹이 새 인스턴스를 자동으로 배포할 때까지 기다립니다.

1. EC2 콘솔에서 Bastion Host 인스턴스에 연결합니다.

2. IDEA_CLUSTER_NAME에서를 편집/etc/environment하고 새 줄environment_name=<res-environment-name>로 추가합니다.

3. 인스턴스에서 다음 명령을 실행합니다.

   source /etc/environment
   sudo service supervisord restart
   sudo systemctl restart supervisord 

4. RES 웹 포털의 지침에 따라 Bastion Host에 다시 연결해 보세요.

1. 아래 명령에서 를 패치 스크립트 및 패치 파일을 다운로드할 디렉터리로 바꾸고를 RES 환경의 이름으로 바꾸어 patch.py 및 graphic_enhanced_instance_types_fix.patch를 다운로드합니다. <output-directory> <environment-name>

   1. 패치는 RES 2024.10에만 적용됩니다.

   2. 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   3. RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   ENVIRONMENT_NAME=<environment-name>
   
   mkdir -p ${OUTPUT_DIRECTORY}
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.10/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.10/patch_scripts/patches/graphic_enhanced_instance_types_fix.patch --output ${OUTPUT_DIRECTORY}/graphic_enhanced_instance_types_fix.patch 

2. 패치 스크립트와 패치 파일이 다운로드된 디렉터리로 이동합니다. 다음 패치 명령을 실행합니다.

   python3 ${OUTPUT_DIRECTORY}/patch.py --environment-name ${ENVIRONMENT_NAME} --res-version 2024.10 --module virtual-desktop-controller --patch ${OUTPUT_DIRECTORY}/graphic_enhanced_instance_types_fix.patch

3. 환경의 가상 데스크톱 컨트롤러(vdc-controller) 인스턴스를 종료하려면 다음 명령을 실행하여 표시된 대로 RES 환경의 이름을 바꿉니다.

   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-vdc-controller \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID}

4. 이름으로 시작하는 대상 그룹이 정상 상태가 <RES-EnvironmentName>-vdc-ext된 후 새 인스턴스를 시작합니다. 그래픽 인스턴스에 등록하는 새 소프트웨어 스택에는 50GB 이상의 스토리지가 있는 것이 좋습니다.

1. 업데이트된 res-installation-scripts.tar.gz 파일을 다운로드합니다.

2. 사전 조건 페이지의 Amazon 머신 이미지(AMIs) 준비에 나열된 단계를 따릅니다.

1. 업데이트된 res-installation-scripts.tar.gz 파일을 다운로드합니다.

2. EC2 Image Builder → 구성 요소 → RES AMIs 준비를 위해 생성된 구성 요소를 클릭합니다.

3. 콘텐츠 → DownloadRESInstallScripts 단계 → 입력 → 소스에 나열된 S3 위치를 기록해 둡니다.

4. 위에 있는 S3 위치에는 이전에 사용된 종속성 파일이 포함되어 있습니다.이 파일을 첫 번째 단계에서 다운로드한 파일로 바꿉니다.

1. 패치 스크립트 및 패치 파일(patch.py 및 s3_mount_custom_prefix_fix.patch)을 다운로드하려면 다음 명령을 실행하여 <output-directory>를 패치 스크립트 및 패치 파일을 다운로드할 디렉터리<environment-name>로 바꾸고를 RES 환경의 이름으로 바꿉니다.

   1. 패치는 RES 2024.08에만 적용됩니다.

   2. 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   3. RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 Amazon S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   ENVIRONMENT_NAME=<environment-name>
   
   mkdir -p ${OUTPUT_DIRECTORY}
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.08/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.08/patch_scripts/patches/s3_mount_custom_prefix_fix.patch --output ${OUTPUT_DIRECTORY}/s3_mount_custom_prefix_fix.patch 

2. 패치 스크립트와 패치 파일이 다운로드되는 디렉터리로 이동합니다. 다음 패치 명령을 실행합니다.

   python3 ${OUTPUT_DIRECTORY}/patch.py --environment-name ${ENVIRONMENT_NAME} --res-version 2024.08 --module virtual-desktop-controller --patch ${OUTPUT_DIRECTORY}/s3_mount_custom_prefix_fix.patch
   

3. 환경의 가상 데스크톱 컨트롤러(vdc-controller) 인스턴스를 종료하려면 다음 명령을 실행합니다. (이미 첫 번째 단계에서 ENVIRONMENT_NAME 변수를 RES 환경의 이름으로 설정했습니다.)

   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-vdc-controller \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

   참고

   프라이빗 VPC 설정의 경우 아직 설정하지 않은 경우 <RES-EnvironmentName>-vdc-custom-credential-broker-lambda 함수의 경우 이름과 AWS_STS_REGIONAL_ENDPOINTS 값이 Environment variable 인를 추가해야 합니다regional. 자세한 정보는 격리된 VPC 배포를 위한 Amazon S3 버킷 사전 조건을 참조하세요.

4. 이름으로 시작하는 대상 그룹이 정상 <RES-EnvironmentName>-vdc-ext 상태가 되면 루트 버킷 ARN 및 사용자 지정 접두사가 있는 읽기/쓰기 S3 버킷을 올바르게 마운트하는 새 VDIs를 시작해야 합니다.

1. 패치 스크립트 및 패치 파일( patch.py 및 groupname_regex.patch)을 다운로드하려면 다음 명령을 실행하여를 파일을 넣을 디렉터리<output-directory>로 바꾸고 <environment-name>를 RES 환경의 이름으로 바꿉니다.

   1. 패치는 RES 2024.06에만 적용됩니다.

   2. 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   3. RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

      OUTPUT_DIRECTORY=<output-directory>
      ENVIRONMENT_NAME=<environment-name>
      
      mkdir -p ${OUTPUT_DIRECTORY}
      curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.06/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
      curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.06/patch_scripts/patches/groupname_regex.patch --output ${OUTPUT_DIRECTORY}/groupname_regex.patch 

2. 패치 스크립트와 패치 파일이 다운로드되는 디렉터리로 이동합니다. 다음 패치 명령을 실행합니다.

   python3 patch.py --environment-name ${ENVIRONMENT_NAME} --res-version 2024.06 --module cluster-manager --patch ${OUTPUT_DIRECTORY}/groupname_regex.patch 

3. 환경의 Cluster Manager 인스턴스를 다시 시작하려면 다음 명령을 실행합니다. Amazon EC2 Management Console에서 인스턴스를 종료할 수도 있습니다.

   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-cluster-manager \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

1. patch.py 스크립트 및 group_member_sync_bug_fix.patch 파일을 다운로드하려면 다음 명령을 실행하여 <output-directory>를 파일을 다운로드할 로컬 디렉터리<res_version>로 바꾸고를 패치할 RES 버전으로 바꿉니다.

   참고

   • 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   • RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   • 패치는 RES 버전 2024.04.02 및 2024.06만 지원합니다. 2024.04 또는 2024.04.01를 사용하는 경우 패치를 적용마이너 버전 업데이트하기 전에 먼저에 나열된 단계에 따라 환경을 2024.04.02로 업데이트할 수 있습니다.

     • RES 버전: RES 2024.04.02

       패치 다운로드 링크: 2024.04.02_group_member_sync_bug_fix.patch

     • RES 버전: RES 2024.06

       패치 다운로드 링크: 2024.06_group_member_sync_bug_fix.patch

   OUTPUT_DIRECTORY=<output-directory>
   RES_VERSION=<res_version>
   mkdir -p ${OUTPUT_DIRECTORY}
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/${RES_VERSION}/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/${RES_VERSION}/patch_scripts/patches/${RES_VERSION}_group_member_sync_bug_fix.patch --output ${OUTPUT_DIRECTORY}/${RES_VERSION}_group_member_sync_bug_fix.patch 

2. 패치 스크립트와 패치 파일이 다운로드되는 디렉터리로 이동합니다. 다음 패치 명령을 실행<environment-name>하여를 RES 환경의 이름으로 바꿉니다.

   cd ${OUTPUT_DIRECTORY}
   ENVIRONMENT_NAME=<environment-name>
   
   python3 patch.py --environment-name ${ENVIRONMENT_NAME} --res-version ${RES_VERSION} --module cluster-manager --patch $PWD/${RES_VERSION}_group_member_sync_bug_fix.patch 

3. 환경의 cluster-manager 인스턴스를 다시 시작하려면 다음 명령을 실행합니다.

   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-cluster-manager \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

기존 VDIs 패치

1. 기존 Ubuntu 및 RHEL9 VDIs를 모두 패치하는 다음 명령을 실행합니다.

   1. 패치 스크립트에는 AWS CLI v2가 필요합니다.

   2. RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 AWS Systems Manager Run Command를 전송할 수 있는 Systems Manager 권한이 있는지 확인합니다.

      aws ssm send-command \
          --document-name "AWS-RunRemoteScript" \
          --targets "Key=tag:res:NodeType,Values=virtual-desktop-dcv-host" \
          --parameters '{"sourceType":["S3"],"sourceInfo":["{\"path\":\"https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.06/patch_scripts/scripts/patch_openssh.sh\"}"],"commandLine":["bash patch_openssh.sh"]}' 

2. 명령 실행 페이지에서 스크립트가 성공적으로 실행되었는지 확인할 수 있습니다. 명령 기록 탭을 클릭하고 최신 명령 ID를 선택한 다음 모든 인스턴스 IDs에 성공 메시지가 있는지 확인합니다.

패치 미래 VDIs

1. 패치 스크립트 및 패치 파일( patch.py 및 update_openssh.patch)을 다운로드하려면 다음 명령을 실행하여 <output-directory>를 파일을 다운로드할 디렉터리<environment-name>로 바꾸고를 RES 환경의 이름으로 바꿉니다.

   참고

   • 패치는 RES 2024.06에만 적용됩니다.

   • 패치 스크립트에는 AWS CLI v2), Python 3.9.16 이상 및 Boto3가 필요합니다.

   • RES가 배포된 계정 및 리전에 대해 AWS CLI 사본을 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   ENVIRONMENT_NAME=<environment-name>
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.06/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.06/patch_scripts/patches/update_openssh.patch --output ${OUTPUT_DIRECTORY}/update_openssh.patch 

2. 다음 패치 명령을 실행합니다.

   python3 ${OUTPUT_DIRECTORY}/patch.py --environment-name ${ENVIRONMENT_NAME} --res-version 2024.06 --module virtual-desktop-controller --patch ${OUTPUT_DIRECTORY}/update_openssh.patch 

3. 다음 명령을 사용하여 환경의 " 컨트롤러 인스턴스를 다시 시작합니다.

   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-vdc-controller \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

1. 패치 스크립트 및 패치 파일( patch.py 및 vdi_host_role_permission_boundary.patch)을 다운로드하려면 다음 명령을 실행하여를 파일을 넣을 로컬 디렉터리<output-directory>로 바꿉니다.

   1. 패치는 RES 2024.04.02에만 적용됩니다. 버전 2024.04 또는 2024.04.01를 사용하는 경우 마이너 버전 업데이트에 대한 퍼블릭 문서에 나열된 단계에 따라 환경을 2024.04.02로 업데이트할 수 있습니다.

   2. 패치 스크립트에는 AWS CLI v2), Python 3.9.16 이상 및 Boto3가 필요합니다.

   3. RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.04.02/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.04.02/patch_scripts/patches/vdi_host_role_permission_boundary.patch --output ${OUTPUT_DIRECTORY}/vdi_host_role_permission_boundary.patch 

2. 패치 스크립트와 패치 파일이 다운로드되는 디렉터리로 이동합니다. 다음 패치 명령을 실행<environment-name>하여를 RES 환경의 이름으로 바꿉니다.

   python3 patch.py --environment-name <environment-name> --res-version 2024.04.02 --module cluster-manager --patch vdi_host_role_permission_boundary.patch 

3. 이 명령을 실행하여 환경에서 cluster-manager 인스턴스를 다시 시작하고 <environment-name>를 RES 환경의 이름으로 바꿉니다. Amazon EC2 Management Console에서 인스턴스를 종료할 수도 있습니다.

   ENVIRONMENT_NAME=<environment-name>
   
   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-cluster-manager \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

1. EC2 콘솔에서 문제 인스턴스로 SSH.

2. 인스턴스에서 다음 명령을 실행합니다.

   sudo su -
   /bin/bash /root/bootstrap/latest/virtual-desktop-host-linux/configure_post_reboot.sh
   sudo reboot 

3. 인스턴스가 재부팅될 때까지 기다립니다.

1. 패치 스크립트 및 패치 파일( patch.py 및 vdi_stuck_in_resuming_status.patch)을 다운로드하려면 다음 명령을 실행하여를 파일을 넣을 디렉터리<output-directory>로 바꿉니다.

   참고

   • 패치는 RES 2024.04.02에만 적용됩니다.

   • 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   • RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.04.02/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.04.02/patch_scripts/patches/vdi_stuck_in_resuming_status.patch --output ${OUTPUT_DIRECTORY}/vdi_stuck_in_resuming_status.patch 

2. 패치 스크립트와 패치 파일이 다운로드되는 디렉터리로 이동합니다. 다음 패치 명령을 실행<environment-name>하여를 RES 환경의 이름으로 바꾸고를 RES가 배포된 리전<aws-region>으로 바꿉니다.

   python3 patch.py --environment-name <environment-name> --res-version 2024.04.02 --module virtual-desktop-controller --patch vdi_stuck_in_resuming_status.patch --region <aws-region> 

3. 환경의 " 컨트롤러 인스턴스를 다시 시작하려면 다음 명령을 실행<environment-name>하여를 RES 환경의 이름으로 바꿉니다.

   ENVIRONMENT_NAME=<environment-name>
   
   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-vdc-controller \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID} 

1. 패치 스크립트 및 패치 파일( patch.py 및 samaccountname_regex.patch)을 다운로드하려면 다음 명령을 실행하여를 파일을 넣을 디렉터리<output-directory>로 바꿉니다.

   참고

   • 패치는 RES 2024.04.02에만 적용됩니다.

   • 패치 스크립트에는 AWS CLI v2, Python 3.9.16 이상 및 Boto3가 필요합니다.

   • RES가 배포된 계정 및 리전에 대해 AWS CLI를 구성하고 RES에서 생성한 버킷에 쓸 수 있는 S3 권한이 있는지 확인합니다.

   OUTPUT_DIRECTORY=<output-directory>
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.04.02/patch_scripts/patch.py --output ${OUTPUT_DIRECTORY}/patch.py
   
   curl https://research-engineering-studio-us-east-1.s3.amazonaws.com/releases/2024.04.02/patch_scripts/patches/samaccountname_regex.patch --output ${OUTPUT_DIRECTORY}/samaccountname_regex.patch 

2. 패치 스크립트와 패치 파일이 다운로드되는 디렉터리로 이동합니다. 다음 패치 명령을 실행<environment-name>하여를 RES 환경의 이름으로 바꿉니다.

   python3 patch.py --environment-name <environment-name> --res-version 2024.04.02 --module cluster-manager --patch samaccountname_regex.patch 

3. 환경에 대한 Cluster Manager 인스턴스를 다시 시작하려면 다음 명령을 실행<environment-name>하여를 RES 환경의 이름으로 바꿉니다. Amazon EC2 Management Console에서 인스턴스를 종료할 수도 있습니다.

   ENVIRONMENT_NAME=<environment-name>
   
   INSTANCE_ID=$(aws ec2 describe-instances \
       --filters \
       Name=tag:Name,Values=${ENVIRONMENT_NAME}-cluster-manager \
       Name=tag:res:EnvironmentName,Values=${ENVIRONMENT_NAME}\
       --query "Reservations[0].Instances[0].InstanceId" \
       --output text)
    
   aws ec2 terminate-instances --instance-ids ${INSTANCE_ID}