Snowball Edge 클라이언트에 대한 명령

아래에서 사용 예와 샘플 출력을 비롯하여 Snowball Edge 클라이언트 명령에 대한 정보를 확인할 수 있습니다.

Snowball Edge 클라이언트의 프로필 구성

Snowball Edge 클라이언트에 대해 명령을 실행할 때마다 매니페스트 파일, 잠금 해제 코드 및 IP 주소를 입력합니다. 이 중 처음 두 개는 AWS Snow 패밀리 관리 콘솔 또는 작업 관리에서 가져올 수 있습니다. API 매니페스트 및 잠금 해제 코드 가져오기에 대한 자세한 내용은 자격 증명 받기 섹션을 참조하세요.

snowballEdge configure 명령을 사용하여 엔드포인트, 29자 잠금 해제 코드 및 매니페스트 경로를 프로필로 저장할 수 있습니다. 구성 후 특정 작업에 대해 이러한 값을 수동으로 입력하지 않고도 다른 Snowball Edge 클라이언트 명령을 사용할 수 있습니다. Snowball Edge 클라이언트를 구성하면 정보가 일반 텍스트 JSON 형식으로 저장됩니다. home directory/.aws/snowball/config/snowball-.config

엔드포인트는 https://가 추가된 IP 주소입니다. 디바이스 디스플레이에서 AWS Snowcone 디바이스의 IP 주소를 찾을 수 있습니다. AWS Snowcone LCD AWS Snowcone 장치를 네트워크에 처음 연결하면 DHCP 서버를 사용할 수 있는 경우 자동으로 DHCP IP 주소를 가져옵니다. 다른 IP 주소를 사용하려는 경우 LCD 디스플레이에서 변경할 수 있습니다. 자세한 내용은 에서 AWS 서비스 사용 AWS Snowcone 단원을 참조하십시오.

사용량

이 명령을 '인라인' 또는 '프롬프트 시'라는 두 가지 방법으로 사용할 수 있습니다. 이 사용 예시는 프롬프트된 방법을 보여 줍니다.

snowballEdge configure

Configuration will be stored at home directory\.aws\snowball\config\snowball-.config
Snowcone  Manifest Path: Path/to/manifest/file
Unlock Code: 29 character unlock code
Default Endpoint: https://192.0.2.0

한 번에 여러 작업이 있는 경우 프로필을 여러 개 가질 수 있습니다. 여러 AWS CLI 프로필에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 명명된 프로필을 참조하십시오.

NFC검증을 위한 QR 코드 받기

이 명령을 사용하여 AWS Snowcone Verification 앱에 사용할 디바이스 고유의 QR 코드를 생성할 수 있습니다. 이 앱은 Apple App Store 또는 Google Play 스토어에서 다운로드할 수 있습니다. NFC검증에 대한 자세한 내용은 을 참조하십시오NFC 태그 검증.

사용량

snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png

QR code is saved to ~/downloads/snowball-qr-code.png

장치 잠금 해제 AWS Snowcone

독립형 AWS Snowcone 장치의 잠금을 해제하려면 명령을 실행합니다. snowballEdge unlock-device 이 명령은 장치에 대한 액세스를 인증합니다. AWS Snowcone

이러한 잠금 해제 명령 중 하나를 실행하면 매니페스트 파일의 경로, 29자의 잠금 해제 코드, 독립형 디바이스의 IP 주소를 수동으로 입력할 수 있습니다. 이 프로세스는 지루할 수 있으므로 대신 Snowball Edge 클라이언트를 구성하는 것이 좋습니다. Snowball Edge 클라이언트를 이미 구성한 경우에는 매니페스트 경로, 잠금 해제 코드 또는 IP 주소 없이 명령 자체만 입력하면 됩니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge unlock-device

Your AWS Snowcone device is unlocking. You may determine the unlock state of your device using the describe-device command. Your AWS Snowcone device will be available for use when it is in the UNLOCKED state.

Snowcone 업데이트

다음 명령은 Snowcone 디바이스에 대한 업데이트를 다운로드 및 설치하는 데 사용할 수 있습니다. 이 명령을 사용하는 절차는 Snowcone 업데이트 섹션을 참조하십시오.

snowballEdge check-for-updates - 클라우드에서 사용 가능한 Snowball 소프트웨어 관련 버전 정보와 디바이스에 설치된 현재 버전을 반환합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge check-for-updates

Latest version: 102
Installed version: 101

snowballEdge describe-device-software - 디바이스에 대한 현재 소프트웨어 버전을 반환합니다. 추가로 업데이트가 다운로드 중인 경우 다운로드 상태 또한 표시됩니다. 소프트웨어 업데이트가 진행 중인 경우 업데이트의 버전 매니페스트와 설치 상태 또한 표시됩니다. 다음은 가능한 출력 목록입니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge describe-device-software

Installed version: 101
Installing version: 102
Install State: Downloading

snowballEdge download-updates - Snowcone 디바이스에 대한 최신 소프트웨어 업데이트 다운로드를 시작합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge download-updates

Download started. Run describe-device-software API for additional information.

snowballEdge install-updates - 이미 다운로드한 Snowcone 디바이스에 대한 최신 소프트웨어 업데이트 설치를 시작합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge install-updates

Installation started.

snowballEdge reboot-device - 디바이스를 재부팅합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge reboot-device

Rebooting device now.

snowballEdge configure-auto-update-strategies - 자동 업데이트 방식을 구성합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge configure-auto-update-strategy --auto-check autoCheck [--auto-check-frequency
autoCheckFreq] --auto-download autoDownload
[--auto-download-frequency autoDownloadFreq]
--auto-install autoInstall
[--auto-install-frequency autoInstallFreq]
--auto-reboot autoReboot [--endpoint
endpoint]

Successfully configured auto update strategy. Run describe-auto-update-strategies for additional information.

snowballEdge describe-auto-update-strategies - 현재 구성된 자동 업데이트 방식을 반환합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge describe-auto-update-strategies

auto-update-strategy {[
auto-check:true,
auto-check-frequency: "0 0 * * FRI", // CRON Expression String, Every Friday at midnight
auto-download:true,
auto-download-frequency: "0 0 * * SAT", // CRON Expression String, Every Saturday at
midnight
auto-install:true,
auto-install-frequency: "0 13 * * Sun", // CRON Expression String, Every Saturday at
midnight
auto-reboot: false;
]}

자격 증명 받기

snowballEdge list-access-keys 및 snowballEdge get-secret-access-key 명령을 사용하여 로컬 자격 증명을 가져올 수 있습니다. 또는 와 함께 사용할 때는 이를 사용하여 요청을 인증합니다. AWS CLI AWS SDK 이러한 자격 증명은 Snowcone에 대한 개별 작업에만 연결되고, 디바이스에서만 사용할 수 있습니다. 장치에는 어떤 AWS Identity and Access Management (IAM) 권한도 없습니다. AWS 클라우드

자세한 내용은 AWS 자격 증명 및 Amazon EC2 엔드포인트 사용을 참조하십시오.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge list-access-keys

{
  "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge get-secret-access-key --access-key-id Access Key

[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Snowcone 디바이스에서 서비스 시작하기

Snowcone은 컴퓨팅 인스턴스, NFS 파일 인터페이스EC2, Amazon 등을 포함한 여러 서비스를 지원합니다. AWS DataSyncsnowballEdge start-service 명령으로 이러한 서비스를 시작할 수 있습니다. 각 서비스의 서비스 ID를 가져오려면 snowballEdge list-services 명령을 사용하면 됩니다.

이 명령을 실행하기 전에 가상 네트워크 인터페이스를 하나 생성하여 시작하려는 서비스에 바인딩합니다. 자세한 내용은 가상 네트워크 인터페이스 생성 단원을 참조하십시오.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn

Starting the AWS service on your Snowball Edge . You can determine the status of the AWS service using the describe-service command.

Snowcone 디바이스에서 서비스 중지하기

Snowcone 디바이스에서 실행 중인 서비스를 중지하려면 snowballEdge stop-service 명령을 사용할 수 있습니다. Amazon EC2 서비스는 중지할 수 없습니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge stop-service --service-id service_id

Stopping the AWS service on your Snowball . You can determine the status of the AWS service using the describe-service command.

데이터를 전송하기 위해 인증서 가져오기

Snowcone 장치로 데이터를 전송하려면 NFS 인터페이스 또는 를 사용하십시오. AWS DataSync다른 IP 주소를 사용하는 Snowcone 디바이스를 잠금 해제하면, 새 인증서가 생성되고 이전 인증서는 해당 엔드포인트에서 더 이상 사용할 수 없게 됩니다. get-certificate 명령을 사용하면 업데이트된 새 인증서를 Snowcone 디바이스에서 다시 가져올 수 있습니다.

다음 명령을 사용하여 Snowcone 디바이스에서 이러한 인증서를 나열하고 다운로드할 수 있습니다.

AWS Snowcone 로그

온프레미스 데이터 센터와 Snowcone 디바이스 간에 데이터를 전송하면 로그가 자동으로 생성됩니다. 디바이스에 데이터를 전송하는 동안 예기치 않은 오류가 발생할 경우 다음 명령을 사용하여 로그 사본을 로컬 서버에 저장할 수 있습니다.

다음은 로그와 관련된 세 가지 명령입니다.

디바이스 상태 가져오기

다음 Snowball Edge 클라이언트 명령을 사용하여 Snowcone 디바이스의 상태 및 일반 상태를 확인할 수 있습니다.

서비스 상태 가져오기

describe-service 명령을 사용하여 Snowcone 디바이스에서 실행되는 서비스의 상태 및 일반 상태를 확인할 수 있습니다. 먼저 list-services 명령을 실행하여 실행 중인 서비스를 볼 수 있습니다.

실행 AWS DataSync AMI

AWS DataSync AMISnowcone에서 실행하십시오.

사용량(구성된 Snowball Edge 클라이언트)

AWS DataSync snc1.medium인스턴스 유형으로 시작해야 합니다. 다른 인스턴스 유형으로 시작하면 DataSync 운영이 불안정해지고 데이터 손실이 발생할 수 있습니다. describe-images 명령을 사용하여 인스턴스를 시작할 이미지를 찾을 수 있습니다. 출력은 다음과 같습니다.

{
  "ImageId": "s.ami-0c046f119de4f752f",
  "Public": false,
  "State": "AVAILABLE",
  "BlockDeviceMappings": [
    {
      "DeviceName": "/dev/sda",
      "Ebs": {
        "DeleteOnTermination": true,
        "Iops": 0,
        "SnapshotId": "s.snap-0d7558ce444ab09bf",
        "VolumeSize": 20,
        "VolumeType": "sbp1"
      }
    }
  ],
  "Description": "AWS DataSync AMI for online data transfer",
  "EnaSupport": false,
  "Name": "scn-datasync-ami",
  "RootDeviceName": "/dev/sda"
}

aws ec2 describe-instances --endpoint http://${snowcone_ip}:8008

{
    "Reservations": [
        {
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "s.image id",
                    "InstanceId": "s.instance id",
                    "InstanceType": "snc1.medium",
                    "LaunchTime": "2020-03-06T18:58:36.609Z",
                    "PrivateIpAddress": "ip address",
                    "State": {
                        "Code": 16,
                        "Name": "running"
                    },
                    "BlockDeviceMappings": [
                        {
                            "DeviceName": "/dev/sda",
                            "Ebs": {
                                "AttachTime": "2020-03-06T19:14:21.336Z",
                                "DeleteOnTermination": true,
                                "Status": "attached",
                                "VolumeId": "s.volume id"
                            }
                        }
                    ],
                    "EbsOptimized": false,
                    "EnaSupport": false,
                    "RootDeviceName": "/dev/sda",
                    "SecurityGroups": [
                        {
                            "GroupName": "default",
                            "GroupId": "s.security group id"
                        }
                    ],
                    "SourceDestCheck": false,
                    "CpuOptions": {
                        "CoreCount": 2,
                        "ThreadsPerCore": 1
                    }
                }
            ],
            "ReservationId": "s.r-80c8ee6b041b29eb4"
        },
    ]
}

인스턴스를 실행합니다.

aws ec2 run-instances --image-id s.ami id \--instance-type snc1.medium --endpoint http://${snowcone_ip}:8008

{
    "Instances": [
        {
            "AmiLaunchIndex": 0,
            "ImageId": "s.ami-0623310b494365cc5",
            "InstanceId": "s.i-80c8ee6b041b29eb4",
            "InstanceType": "snc1.medium",
            "State": {
                "Code": 0,
                "Name": "pending"
            },
            "EbsOptimized": false,
            "EnaSupport": false,
            "RootDeviceName": "/dev/sda",
            "SecurityGroups": [
                {
                    "GroupName": "default",
                    "GroupId": "s.sg-80c8ee6b041b29eb4"
                }
            ],
            "SourceDestCheck": false,
            "CpuOptions": {
                "CoreCount": 2,
                "ThreadsPerCore": 1
            }
        }
    ],
    "ReservationId": "s.r-80c8ee6b041b29eb4"
}

액세스 시작 NFS 및 제한

NFSsnowballEdge start-service명령으로 시작하세요. 서비스의 서비스 ID를 가져오려면 snowballEdge list-services 명령을 사용할 수 있습니다. NFS

이 명령을 실행하기 전에 가상 네트워크 인터페이스를 하나 생성하여 시작하려는 서비스에 바인딩합니다. 자세한 내용은 가상 네트워크 인터페이스 생성 단원을 참조하십시오. Amazon S3 버킷의 파일 공유 및 데이터에 대한 액세스를 제한하고 현재 적용되는 제한 사항을 확인할 수 있습니다. 서비스를 시작할 때 파일 공유 및 S3 버킷에 액세스할 수 있는 허용된 호스트에 CIDR 블록을 할당하면 됩니다NFS.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge start-service --service-id nfs --virtual-network-interface-arns arn:aws:snowball-device:::interface/s.ni-12345fgh45678j --service-configuration AllowedHosts=ip address-1/32,ip address-2/24

Starting the service on your Snowball Edge. You can determine the status of the service using the describe-service command.

실행 시 NFS 공유에 대한 액세스 제한 NFS

시작한 NFS 후 Amazon S3 버킷의 파일 공유 및 데이터에 대한 액세스를 제한할 수 있습니다. 현재 어떤 제한이 적용되고 있는지 확인하고 각 버킷에 다른 액세스 제한을 부여할 수 있습니다. 서비스를 시작할 때 파일 공유 및 S3 버킷에 액세스할 수 있는 호스트에 CIDR 블록을 할당하면 됩니다. NFS 다음은 예시 명령입니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge start-service \
    --service-id nfs \
    --virtual-network-interface-arns virtual-network-interface-arn --service-configuration AllowedHosts=ip-address-1/32,ip-address-1/24

현재 제한 사항을 보려면 describe-service 명령을 사용하십시오.

 snowballEdge describe-service --service-id nfs

Amazon S3 버킷의 내보내기 경로 가져오기

Amazon S3 버킷의 내보내기 경로를 가져오기 위한 특정 Snowcone 명령은 없습니다. 내보내기 경로의 형식은 다음과 같습니다.

/buckets/bucket-name.

로컬 운영자 디버깅 AWS 활성화

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge enable-local-aws-operator-debugging

로컬 운영자 디버깅 AWS 비활성화

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge disable-local-aws-operator-debugging

다이렉트 네트워크 인터페이스 생성

사용량(구성된 Snowball Edge 클라이언트)

create-direct-network-interface [--endpoint endpoint] [--instance-id instanceId] [--mac macAddress]
                                [--manifest-file manifestFile] [--physical-network-interface-id physicalNetworkInterfaceId] 
                                [--profile profile] [--unlock-code unlockCode] [--vlan vlanId]

다이렉트 네트워크 인터페이스에 대한 정보 가져오기

사용량(구성된 Snowball Edge 클라이언트)

describe-direct-network-interfaces [--endpoint endpoint] [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode]

다이렉트 네트워크 인터페이스 업데이트

사용량(구성된 Snowball Edge 클라이언트)

update-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] 
                                [--mac macAddress]
                                [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode] 
                                [--vlan vlanId] [--attach-instance-id instanceId | --detach]

다이렉트 네트워크 인터페이스 삭제

사용량(구성된 Snowball Edge 클라이언트)

delete-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] 
                                [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode]                                 

기능 상태 확인

Snowcone 장치 및 로컬 AWS 서비스를 원격으로 관리할 수 있는 기능을 포함하여 AWS Snow Device Management장치에서 사용할 수 있는 기능의 상태를 나열하려면 명령을 사용하십시오. describe-features

RemoteManagementState는 Snow 디바이스 관리의 상태를 나타내며 다음 상태 중 하나를 반환합니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge describe-features 
--manifest-file manifest.bin path 
--unlock-code unlock-code 
--endpoint https://device-local-ip:9091

출력 예

{
  "RemoteManagementState" : String
}
            

기능 상태 변경

AWS Snowcone 기기에서 사용할 수 있는 기능의 상태를 변경하려면 set-features 명령을 사용합니다. Snowcone 장치 및 로컬 AWS 서비스를 원격으로 관리할 수 있는 기능을 활성화하거나 비활성화하려면 AWS Snow Device Management파라미터를 사용하십시오. --remote-management-state 이 명령을 실행하기 전에 디바이스를 잠금 해제해야 합니다.

Snow 디바이스 관리를 다음 상태로 설정할 수 있습니다.

사용량(구성된 Snowball Edge 클라이언트)

snowballEdge set-features
--remote-management-state INSTALLED_AUTOSTART
--manifest-file ./JID2bf11d5a-fict-414a-b5b1-3bf7e6a6e83d_manifest.bin
--unlock-code 73bb0-f8ke1-69a4a-f4288-4f88d
--endpoint https://10.0.0.25

출력 예

{
  "RemoteManagementState" : "INSTALLED_AUTOSTART"
}
            

타임 서버 설정

외부 네트워크 타임 프로토콜 (NTP) 서버를 설정할 수 있습니다. 장치가 잠긴 상태와 잠금 해제된 상태 모두에 있을 때 NTP CLI 명령을 사용할 수 있습니다. 매니페스트 및 잠금 해제 코드가 필요합니다. 이러한 설정은 snowballEdge configure 명령을 사용하거나 --manifest-file 및 --unlock-code 옵션을 사용하여 설정할 수 있습니다. AWS Snowcone Edge와 AWS Snowcone Edge snowballEdge CLI 모두에서 사용할 수 있다는 점에 유의하십시오.

보안 NTP 타임 서버를 제공하는 것은 사용자의 책임입니다. 장치를 연결할 NTP 시간 서버를 설정하려면 update-time-servers CLI 명령을 사용합니다.

사용량

snowballEdge update-time-servers time.google.com

Updating time servers now.

시간 소스 확인

디바이스가 현재 연결되어 있는 NTP 시간 소스를 확인하려면 describe-time-sources Snowball Edge CLI 명령을 사용하십시오.

사용량

snowballEdge describe-time-sources

{
  "Sources" : [ {
    "Address" : "172.31.2.71",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "172.31.3.203",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "172.31.0.178",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "172.31.3.178",
    "State" : "LOST",
    "Type" : "PEER",
    "Stratum" : 10
  }, {
    "Address" : "216.239.35.12",
    "State" : "CURRENT",
    "Type" : "SERVER",
    "Stratum" : 1
  } ]
}

이 describe-time-sources 명령은 시간 소스 상태 목록을 반환합니다. 각 시간 소스 상태에는Address, State, Type, Stratum 필드가 포함됩니다. 이러한 필드의 의미는 다음과 같습니다.

NTP시간 소스는 서버 또는 피어일 수 있습니다. 서버는 사용자가 update-time-servers 명령으로 설정할 수 있지만, 피어는 클러스터의 다른 Snowball Edge 디바이스만 설정할 수 있습니다. 예시 출력에서는 클러스터가 5개인 Snowball Edge에서 describe-time-sources가 호출됩니다. 출력에는 피어 4개와 서버 1개가 포함됩니다. 피어의 계층은 10이고 서버의 계층은 1이므로 서버가 현재 시간 소스로 선택됩니다.