Snowball Edge 클라이언트 명령 사용

아래에는 Snow Family 디바이스와 함께 사용할 수 있는 Snowball Edge 클라이언트 명령에 대한 정보가 나와 있습니다. 각 명령에는 사용 예와 샘플 출력이 포함되어 있습니다. Snowball Edge 클라이언트는 디바이스에서 실행하여 Snow Family 디바이스를 잠금 해제하고 구성 및 제어하는 독립 실행형 명령줄 애플리케이션입니다. Snow Family 디바이스 클러스터와 함께 클라이언트를 사용할 수도 있습니다. Snowball Edge 클라이언트를 사용하는 동안 snowballEdge help 명령을 실행하여 추가 지원 정보를 얻을 수 있습니다.

Snowball Edge 클라이언트를 다운로드하려면 을 참조하십시오. Snowball Edge 클라이언트 다운로드 및 설치

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

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

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

엔드포인트는 https://가 추가된 IP 주소입니다. 장치 LCD 디스플레이에서 AWS Snowball Edge AWS Snowball Edge 장치의 IP 주소를 찾을 수 있습니다. AWS Snowball Edge 장치가 네트워크에 처음 연결되면 DHCP IP 주소를 자동으로 가져옵니다 (DHCP 서버를 사용할 수 있는 경우). 다른 IP 주소를 사용하고 싶은 경우 LCD 디스플레이에서 변경할 수 있습니다. 자세한 내용은 AWS Snowball 에지 디바이스 사용 섹션을 참조하세요.

사용량

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

snowballEdge configure

Configuration will stored at home directory\.aws\snowball\config\snowball-edge.config
Snowball Edge 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 Snowball Edge Verification 앱에 사용할 디바이스 고유의 QR 코드를 생성할 수 있습니다. NFC 검증에 대한 자세한 내용은 NFC 태그 검증 섹션을 참조하세요.

사용량

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

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

Snowball Edge 클라이언트 버전

version 명령을 사용하여 Snowball Edge 명령줄 인터페이스(CLI) 클라이언트의 버전을 확인합니다.

사용량

    snowballEdge version                
            

출력 예시

    Snowball Edge client version: 1.2.0  Build 661                
            

Snowball Edge 디바이스 잠금 해제

독립형 AWS Snowball Edge 장치의 잠금을 해제하려면 snowballEdge unlock-device 명령을 실행합니다. 클러스터를 잠금 해제하려면 snowballEdge unlock-cluster 명령을 사용합니다. 이러한 명령은 AWS Snowball Edge 디바이스에 대한 사용자의 액세스를 인증합니다.

사용량

snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234

snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file /usr/home/manifest.bin --unlock-code 01234-abcde-ABCDE-01234

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

클러스터 사용

클러스터를 잠금 해제하는 경우, 노드 중 하나의 엔드포인트와 클러스터 내 다른 디바이스의 모든 IP 주소를 제공해야 합니다.

snowballEdge unlock-cluster --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234 --device-ip-addresses 192.0.2.0 192.0.2.1 192.0.2.2 192.0.2.3 192.0.2.4

Your Snowball Edge Cluster is unlocking. You may determine the unlock state of your cluster using the describe-device command. Your Snowball Edge Cluster will be available for use when your Snowball Edge devices are in the UNLOCKED state.

Snowball Edge 업데이트

다음 명령은 Snowball Edge 디바이스에 대한 업데이트를 다운로드 및 설치하는 데 사용할 수 있습니다. 이 명령을 사용하는 절차는 Snowball Edge 디바이스의 소프트웨어 업데이트 섹션을 참조하세요.

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

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

snowballEdge check-for-updates

Latest version: 102
Installed version: 101

snowballEdge describe-device-software - 디바이스의 SSL 인증서의 현재 소프트웨어 버전과 만료 날짜를 반환합니다. 추가로 소프트웨어 업데이트가 다운로드 중인 경우 다운로드 상태 또한 표시됩니다. 다음은 가능한 출력 목록입니다.

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

snowballEdge describe-device-software

Installed version: 101
Installing version: 102
Install State: Downloading
CertificateExpiry: Thur Jan 01 00:00:00 UTC 1970

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

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

snowballEdge download-updates

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

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

사용량(구성된 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 명령을 사용하여 Snowball Edge의 관리자 자격 증명을 얻을 수 있습니다 AWS 계정 . 이러한 자격 증명을 사용하여 AWS Identity and Access Management (IAM 사용자) 및 역할을 생성하고 SDK를 AWS CLI 사용하거나 SDK와 함께 사용할 때 요청을 인증할 수 있습니다. AWS 이러한 자격 증명은 Snowball Edge에 대한 개별 작업에만 연결되고, 디바이스 또는 디바이스 클러스터에서만 사용할 수 있습니다. 디바이스 한 대 또는 여러 대는 AWS 클라우드내에서 IAM 권한이 없습니다.

사용량(구성된 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

Snowball Edge에서 서비스 시작

Snowball Edge 디바이스는 Amazon S3 외에도 여러 가지 서비스를 지원합니다. 여기에는 컴퓨팅 인스턴스, 파일 인터페이스 등이 포함됩니다 AWS IoT Greengrass. Amazon S3와 Amazon EC2는 기본적으로 항상 켜져 있으며, Snowball Edge 클라이언트를 사용하여 중지하거나 다시 시작할 수 없습니다. 하지만 파일 인터페이스는 snowballEdge start-service 명령으로 시작할 AWS IoT Greengrass 수 있습니다. 각 서비스의 서비스 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.

Snowball Edge에서 서비스 중지

Snowball Edge에서 실행 중인 서비스를 중지하려면 snowballEdge stop-service 명령을 사용할 수 있습니다.

Amazon S3 어댑터, Amazon EC2 및 IAM 서비스는 중지할 수 없습니다. AWS STS

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

snowballEdge stop-service --service-id service_id

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

NFS 시작 및 액세스 제한

snowballEdge start-service 명령으로 NFS를 시작합니다. NFS 서비스의 서비스 ID를 가져오려면 snowballEdge list-services 명령을 사용하면 됩니다.

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

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

사용량(구성된 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

AWS Snowball Edge 로그

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

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

디바이스 상태 가져오기

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

서비스 상태 가져오기

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

클러스터에서 노드 제거

disassociate-device 명령을 사용하면 Snowball Edge 클러스터에서 노드가 제거됩니다. 비정상 노드를 바꾸려면 이 명령을 사용합니다. 클러스터에 대한 자세한 내용은 이 설명서의 클러스터링 개요를 참조하세요.

이 명령을 사용하여 실수로 전원이 꺼졌거나 네트워크에서 연결 해제되어 클러스터 나머지에서 일시적으로 사용할 수 없게 된 노드를 제거하면 안 됩니다. 이 명령으로 제거된 노드는 어떤 클러스터에도 추가할 수 없으므로 AWS로 반환해야 합니다.

노드가 실수로 전원이 꺼졌거나 네트워크 연결이 해제된 경우에는 해당 노드를 전원 및 네트워크에 다시 연결하고 associate-device 명령을 사용하면 됩니다. 노드의 전원이 켜져 있고 정상인 경우 disassociate-device 명령을 사용하여 노드를 연결 해제할 수 없습니다.

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

snowballEdge disassociate-device --device-id Job ID for the Device

Disassociating your Snowball Edge device from the cluster. Your Snowball Edge device will be disassociated from the cluster when it is in the "DISASSOCIATED" state. You can use the describe-cluster command to determine the state of your cluster.

클러스터에 노드 추가

associate-device 명령을 사용하면 Snowball Edge 디바이스의 클러스터에 노드가 추가됩니다. 노드의 전원을 끄면 잠금 해제에서 잠금 상태로 되돌아갑니다. 노드를 잠금 해제하려면 이 명령을 사용하면 됩니다. 이 명령을 사용하여 대체품으로 주문한 새 노드에 사용할 수 없는 노드를 교체할 수 있습니다. 클러스터에 대한 자세한 내용은 이 설명서의 클러스터링 개요를 참조하세요.

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

snowballEdge associate-device --device-ip-address IP Address

Associating your Snowball Edge device with the cluster. Your Snowball Edge device will be associated with the cluster when it is in the ASSOCIATED state. You can use the describe-cluster command to determine the state of your cluster.

디바이스에 대한 태그 생성

디바이스에 지정된 태그를 추가하거나 덮어씁니다. 최대 50개의 태그를 생성할 수 있습니다. 각 태그는 키-값 페어로 이루어져 있습니다. 값은 선택 사항입니다.

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

snowballEdge create-tags --tag Key=Name,Value=user-test --tag Key=Stage,Value=beta

자세한 내용을 보려면 describe-tags 명령을 실행하세요.

Tag(s) [Key=Name,Value=test, Key=Stage,Value=beta] created.

디바이스에서 태그 삭제

delete-tags 명령은 Snowball Edge 디바이스에서 지정된 태그를 삭제합니다.

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

snowballEdge delete-tags --tag Key=Stage,Value=beta
    Tag(s) [Key=Stage,Value=beta] deleted.

자세한 내용을 보려면 describe-tags 명령을 실행하세요.

디바이스의 태그 설명

describe-tags 명령은 Snowball Edge 디바이스의 태그를 설명합니다.

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

snowballEdge describe-tags

자세한 내용을 보려면 describe-tags 명령을 실행하세요.

{
  "Tags" : [ {
    "Key" : "Name",
    "Value" : "user-test"
  }, {
    "Key" : "Stage",
    "Value" : "beta"
  } ]
}

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

create-direct-network-interface명령을 사용하여 Snow Family 디바이스에서 다이렉트 네트워크 인터페이스를 생성합니다. 직접 네트워크 인터페이스 (DNI) 는 AMI 인스턴스와 연결되어야 합니다. vlan파라미터를 사용하여 인터페이스에 가상 근거리 통신망 (VLAN) ID를 할당하여 인터페이스의 모든 트래픽에 해당 VLAN ID로 태그를 지정할 수 있습니다. 또한 파라미터를 사용하여 미디어 액세스 제어 (MAC) 주소를 DNI에 할당할 수 있습니다. mac mac매개 변수와 값을 제공하지 않으면 MAC 주소가 자동으로 할당됩니다.

describe-device명령을 사용하여 물리적 네트워크 인터페이스 ID를 검색할 수 있습니다. 자세한 정보는 디바이스 상태 가져오기을 참조하세요.

snowballEdge create-direct-network-interface --instance-id AMI-instance-id --physical-network-interface-id physical-network-interface-id --vlan vlan-id --mac MAC-address

{
    "DirectNetworkInterface" : {
        "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o",
        "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w",
        "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q",
        "Driver" : "mlx5 core",
        "MacAddress" : "1A:2B:3C:4D:5E:6F",
        "MtuSize": "1500"
    }
}
                

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

describe-direct-network-interface명령을 사용하여 Snow Family 장치의 다이렉트 네트워크 인터페이스에 대한 정보를 볼 수 있습니다.

snowballEdge describe-direct-network-interfaces --endpoint https://snow-device-ip-address --manifest-file path/to/manifest/file.bin --unlock-code unlock-code

{
    "DirectNetworkInterface" : {
        "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o",
        "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w",
        "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q",
        "Driver" : "mlx5 core",
        "MacAddress" : "1A:2B:3C:4D:5E:6F",
        "MtuSize": "1500"
    }
}
                

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

update-direct-network-interface를 사용하여 다이렉트 네트워크 인터페이스 (DNI) 의 속성을 변경할 수 있습니다. Amazon EC2 호환 인스턴스에 연결된 DNI를 변경하면 인터페이스가 분리됩니다. DNI가 사용하는 물리적 인터페이스의 최대 전송 단위 (MTU) 를 변경하려면 명령을 사용합니다. update-mtu-size 자세한 정보는 MTU 크기 업데이트을 참조하세요.

snowballEdge update-direct-network-interface --direct-network-interface-arn directNetworkInterfaceArn // 
  --endpoint https://snow-device-ip-address [--mac macAddress] // 
  --manifest-file path/to/manifest/file.bin --unlock-code unlock-code //
  [--vlan vlanId] [--attach-instance-id instanceId | --detach]

{
    "DirectNetworkInterface" : {
        "DirectNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-x8a3b6k1e9n4r2s7o",
        "PhysicalNetworkInterfaceId : "s.ni-p5d2q8r3s9t4u7v1w",
        "InstanceId" : "s.i-g9h2j4k6l8m1n3p5q",
        "Driver" : "mlx5 core",
        "MacAddress" : "2A:3B:5C:5D:6E:7F",
        "MtuSize": "1500"
    }
}                
            

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

delete-direct-network-interface명령을 사용하여 다이렉트 네트워크 인터페이스 (DNI) 를 삭제합니다. Amazon EC2 호환 컴퓨팅 인스턴스와 연결된 DNI를 삭제하려면 먼저 update-direct-network-interface 명령의 detatch 파라미터를 사용하여 인스턴스에서 DNI를 분리합니다. 자세한 정보는 다이렉트 네트워크 인터페이스 업데이트을 참조하세요.

snowballEdge delete-direct-network-interface --direct-network-interface-arn directNetworkInterfaceArn // 
  --endpoint https://snow-device-ip-address --manifest-file path/to/manifest/file.bin //
             [--profile profile] --unlock-code unlock-code
            

The direct network interface has been deleted from your Snowball Edge. You can determine the direct network interfaces available on your Snowball Edge using the describe-direct-network-interfaces command.                    
                

가상 네트워크 인터페이스 (VNI) 생성

create-virtual-network-interface명령을 사용하여 Snowball Edge 디바이스에 가상 네트워크 인터페이스를 생성합니다. describe-device명령을 사용하여 물리적 네트워크 인터페이스 ID를 검색할 수 있습니다. 자세한 정보는 디바이스 상태 가져오기을 참조하세요.

snowballEdge create-virtual-network-interface --endpoint https://ip-address-of-snow-device --manifest-file /path/to/manifest/file.bin --unlock-code unlock-code --ip-address-assignment DHCP or STATIC --physical-network-interface-id [physical network interface id] --static-ip-address-configuration IpAddress=IP-address,NetMask=netmask

{
    "VirtualNetworkInterface": {
        "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf",
        "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd",
        "IpAddressAssignment": "DHCP",
        "IpAddress": "192.0.2.0",
        "Netmask": "255.255.255.0",
        "DefaultGateway": "192.0.2.1",
        "MacAddress": "EX:AM:PL:E1:23:45",
        "MtuSize" : "1500"
    }
}                    
                

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

describe-virtual-network-interface명령을 사용하여 Snow Family 장치의 가상 네트워크 인터페이스에 대한 정보를 볼 수 있습니다.

snowballEdge describe-direct-network-interfaces --endpoint https://ip-address-of-snow-device --manifest-file path/to/manifest/file.bin --unlock-code unlock-code

{
    "VirtualNetworkInterface": {
        "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf",
        "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd",
        "IpAddressAssignment": "DHCP",
        "IpAddress": "192.0.2.0",
        "Netmask": "255.255.255.0",
        "DefaultGateway": "192.0.2.1",
        "MacAddress": "EX:AM:PL:E1:23:45",
        "MtuSize" : "1500"
    }
}                    
                

가상 네트워크 인터페이스 업데이트

update-virtual-network-interface명령을 사용하여 Snow Family 디바이스의 가상 네트워크 인터페이스를 업데이트합니다. DNI가 사용하는 물리적 인터페이스의 최대 전송 단위 (MTU) 를 변경하려면 명령을 사용합니다. update-mtu-size 자세한 정보는 MTU 크기 업데이트을 참조하세요.

snowballEdge update-virtual-network-interface --direct-network-interface-arn directNetworkInterfaceArn --endpoint https://ip-address-of-snow-device // 
    --unlock-code unlock-code [--mac macAddress] --manifest-file path/to/manifest/file.bin //
    [--vlan vlanId] [--attach-instance-id instanceId | --detach]

{
    "VirtualNetworkInterface": {
        "VirtualNetworkInterfaceArn": "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf",
        "PhysicalNetworkInterfaceId": "s.ni-8EXAMPLEaEXAMPLEd",
        "IpAddressAssignment": "DHCP",
        "IpAddress": "192.0.2.9",
        "Netmask": "255.255.255.0",
        "DefaultGateway": "192.0.2.1",
        "MacAddress": "EX:AM:PL:E1:23:45",
        "MtuSize" : "1500"
    }
}                      
            

가상 네트워크 인터페이스 삭제

delete-direct-network-interface명령을 사용하여 가상 네트워크 인터페이스 (VNI) 를 삭제합니다.

snowballEdge delete-virtual-network-interface --virtual-network-interface-arn virtual-network-interface-ARN --endpoint https://endpoint  // 
    --manifest-file path/to/manifest/file.bin] [--profile profile] --unlock-code unlock-code]

The virtual network interface has been deleted from your Snowball Edge. You can determine the virtual network interfaces available on your Snowball Edge using the describe-virtual-network-interfaces command.                
            

기능 상태 확인

장치에서 사용할 수 있는 기능의 상태를 나열하려면 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
}
            

타임 서버 설정

외부 NTP(Network Time Protocol) 서버를 설정할 수 있습니다. 디바이스가 잠긴 상태와 잠금 해제된 상태 모두에 있을 때 NTP CLI 명령을 사용할 수 있습니다. 매니페스트 및 잠금 해제 코드가 필요합니다. 이러한 설정은 snowballEdge configure 명령을 사용하거나 --manifest-file 및 --unlock-code 옵션을 사용하여 설정할 수 있습니다. 참고로 snowballEdge CLI는 Edge와 AWS Snowcone Edge 모두에서 사용할 수 있습니다. AWS Snowcone

안전한 NTP 시간 서버를 제공하는 것은 사용자의 책임입니다. 디바이스가 연결되는 NTP 시간 서버를 설정하려면 update-time-servers CLI 명령을 사용합니다.

지원되는 NTP 디바이스 유형 및 소프트웨어 버전

NTP는 모든 버전 2 스토리지 및 컴퓨팅 디바이스 유형에서 사용할 수 없습니다. 하지만 소프트웨어 버전 77 이상의 Snowball Edge 버전 3 스토리지 및 컴퓨팅 디바이스 유형은 NTP를 지원합니다. NTP가 활성화되었는지 확인하려면 Snowball Edge CLI 명령 describe-time-sources을 사용하세요.

사용량

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이므로 서버가 현재 시간 소스로 선택됩니다.

MTU 크기 업데이트

update-mtu-size명령을 사용하여 Snow Family 장치 물리적 인터페이스의 최대 전송 단위 (MTU) 크기를 바이트 단위로 수정합니다. 이 물리적 네트워크 인터페이스와 연결된 모든 가상 네트워크 인터페이스 및 다이렉트 네트워크 인터페이스는 동일한 MTU 크기로 구성됩니다.

describe-device명령을 사용하여 해당 인터페이스의 물리적 네트워크 인터페이스 ID와 현재 MTU 크기를 검색할 수 있습니다. 자세한 정보는 디바이스 상태 가져오기을 참조하세요.

descibe-direct-network-interface및 describe-virtual-network-interface 명령을 사용하여 해당 인터페이스의 현재 MTU 크기를 검색할 수 있습니다. 자세한 내용은 다이렉트 네트워크 인터페이스에 대한 정보 가져오기 및 가상 네트워크 인터페이스에 대한 정보 가져오기 섹션을 참조하세요.

사용량

snowballEdge update-mtu-size --physical-network-interface-id physical-network-interface-id --mtu-size size-in-bytes

{
    "PhysicalNetworkInterface": {
        "PhysicalNetworkInterfaceId": "s.ni-8c1f891d7f5b87cfe",
        "PhysicalConnectorType": "SFP_PLUS",
        "IpAddressAssignment": "DHCP",
        "IpAddress": "192.0.2.0",
        "Netmask": "255.255.255.0",
        "DefaultGateway": "192.0.2.255",
        "MacAddress": "8A:2r:5G:9p:6Q:4s",
        "MtuSize": "5743"
    }
}