Snowball Edge 客户端的命令

在下文中，您可找到有关 Snowball Edge 客户端命令的信息，包括使用示例和示例输出。

为 Snowball Edge 客户端配置配置文件

每次为 Snowball Edge 客户端运行命令时，都要提供您的清单文件、解锁代码和 IP 地址。你可以从 Amazon Snow 系列管理控制台 或任务管理中获得其中的前两个API。有关获取您的清单和解锁代码的更多信息，请参阅获取凭证。

您可以选择使用 snowballEdge configure 命令将清单的路径、29 个字符组成的解锁代码和端点存储为一个配置文件。配置完成后，您可以使用其他 Snowball Edge 客户端命令，而不必为特定作业手动输入这些值。配置 Snowball Edge 客户端后，信息将以纯文本JSON格式保存到。home directory/.aws/snowball/config/snowball-.config

端点为附加了 https:// 的 IP 地址。您可以在设备LCD显示屏上找到 Amazon Snowcone 设备的 IP 地址。 Amazon Snowcone 当 Amazon Snowcone 设备首次连接到您的网络时，如果DHCP服务器可用，它会自动获取 DHCP IP 地址。如果要使用不同的 IP 地址，可以在LCD显示屏上进行更改。有关更多信息，请参阅 在上使用 Amazon 服务 Amazon 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

如果您同时拥有多个作业，则可以拥有多个配置文件。有关多个 Amazon CLI 配置文件的更多信息，请参阅《Amazon Command Line Interface 用户指南》中的命名配置文件。

获取二维码进行NFC验证

您可以使用此命令生成特定于设备的 QR 代码，以便与 Amazon Snowcone Verification App 一起使用。您可以从 Apple 应用商店或 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

解锁设备 Amazon Snowcone

要解锁独立 Amazon Snowcone 设备，请运行snowballEdge unlock-device命令。这些命令会验证您对 Amazon Snowcone 设备的访问权限。

当您运行其中一个解锁命令时，您可以手动输入清单文件的路径、29 个字符的解锁代码以及独立设备的 IP 地址。此过程可能会较为繁琐，因此我们建议您改为配置 Snowball Edge 客户端。如果您已经配置了 Snowball Edge 客户端，则只需输入命令本身，无需输入清单路径、解锁码或 IP 地址。

用法（已配置 Snowball Edge 客户端）

snowballEdge unlock-device

Your Amazon Snowcone device is unlocking. You may determine the unlock state of your device using the describe-device command. Your Amazon 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 命令，可以获取您的本地凭证。将 Amazon CLI 或与一起使用时，您可以使用它们来验证您的请求 Amazon SDK。这些凭证仅与 Snowcone 的单个作业相关联，且仅可在设备上使用。设备在中没有任何 Amazon Identity and Access Management (IAM) 权限 Amazon Web Services 云。

有关更多信息，请参阅Amazon 凭证和使用 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 和。 Amazon DataSync您可以使用 snowballEdge 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 Amazon service on your Snowball Edge . You can determine the status of the Amazon service using the describe-service command.

在 Snowcone 设备上停止服务

要停止正在 Snowcone 设备上运行的服务，您可以使用 snowballEdge stop-service 命令。无法停止 Amazon EC2 服务。

用法（已配置 Snowball Edge 客户端）

snowballEdge stop-service --service-id service_id

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

获取您的证书以传输数据

要将数据传输到 Snowcone 设备，请使用NFS接口或。 Amazon DataSync如果您解锁具有其他 IP 地址的 Snowcone 设备，则会生成新证书，旧证书不再可用于端点。您可以再次使用 get-certificate 命令从 Snowcone 设备获取新的已更新证书。

可以使用以下命令列出这些证书并从您的 Snowcone 设备下载它们：

Amazon Snowcone 日志

当您在本地数据中心和 Snowcone 设备之间传输数据时，系统将会自动生成日志。如果您在将数据传输到设备的过程中遇到意外错误，则可以使用以下命令将日志副本保存到本地服务器。

有三个与日志相关的命令：

获取设备状态

可以使用以下 Snowball Edge 客户端命令确定 Snowcone 设备的状态和整体运行状况：

获取服务状态

您可以使用 describe-service 命令确定 Snowcone 设备上运行的服务的状态和整体运行状况。可以首先运行 list-services 命令来查看哪些服务正在运行。

启动 Amazon DataSync AMI

在 Snowcone Amazon DataSync AMI 上启动。

用法（已配置 Snowball Edge 客户端）

Amazon 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": "Amazon 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和限制访问

从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 存储桶中的文件共享和 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

获取 Amazon S3 存储桶的导出路径

没有用于获取 Amazon S3 存储桶导出路径的特定 Snowcone 命令。导出路径的格式如下所示。

/buckets/bucket-name.

启用本地 Amazon 操作员调试

用法（已配置 Snowball Edge 客户端）

snowballEdge enable-local-aws-operator-debugging

禁用本地 Amazon 操作员调试

用法（已配置 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]                                 

检查特征状态

要列出设备上可用功能的状态 Amazon Snow Device Management，包括允许您远程管理 Snowcone 设备和本地 Amazon 服务的功能，请使用命令。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
}
            

更改特征状态

要更改 Amazon Snowcone 设备上可用功能的状态，请使用set-features命令。要启用或禁用 Amazon Snow Device Management（允许您远程管理 Snowcone 设备和本地 Amazon 服务），请使用参数。--remote-management-state在运行此命令之前，您必须先解锁设备。

您可以将 Snow Device Management 设置为以下状态：

用法（已配置 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) 服务器。当设备处于锁定和解锁状态时，您可以使用这些NTPCLI命令。清单和解锁代码是必需的。您可以使用 snowballEdge configure 命令或使用 --manifest-file 和 --unlock-code 选项设置这些内容。请注意，您可以同时使用 E snowballEdge CLI d Amazon Snowcone ge 和 Amazon Snowcone。

您有责任提供安全NTP的时间服务器。要设置设备连接到哪些NTP时间服务器，请使用update-time-serversCLI命令。

用法

snowballEdge update-time-servers time.google.com

Updating time servers now.

检查时间源

要查看设备当前连接到哪些NTP时间源，请使用 S describe-time-sources nowball 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。因此，服务器被选为当前时间源。