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 地址。您可以找到的 IP 地址Amazon Snowcone上的设备Amazon Snowcone设备 LCD 显示屏。当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 代码

您可以使用此命令生成特定于设备的 QR 代码，以便与Amazon Snowcone验证应用。您可以从 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或者用AmazonSDK。这些凭证仅与 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 文件接口、Amazon EC2 和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 设备下载它们：

Amazon Snowcone 日志

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

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

获取设备状态

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

获取服务状态

您可以 Snowcone 用describe-service命令。可以首先运行 list-services 命令来查看哪些服务正在运行。

启动Amazon DataSyncAMI

启动Amazon DataSync关于 Snowcone 的 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 服务的服务 ID，您可以使用snowballEdge list-services命令。

运行此命令之前，请创建一个虚拟网络接口以绑定到您要启动的服务。有关更多信息，请参阅 创建虚拟网络接口。您可以限制对 Amazon S3 存储桶中的文件共享和数据的访问，并查看当前有哪些限制。为此，您可以为允许的主机分配 CIDR 块，这些主机可以在启动 NFS 服务时访问文件共享和 S3 存储桶。

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

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

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

/buckets/bucket-name.

启用 LocalAmazon操作员调试

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

snowballEdge enable-local-aws-operator-debugging

禁用 LocalAmazon操作员调试

用法（已配置的 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 设备管理设置为以下状态：

用法（已配置的 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选项。请注意，您可以使用snowballEdge上的 CLIAmazon Snowcone边缘和Amazon Snowcone.

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

用量

snowballEdge update-time-servers time.google.com

Updating time servers now.

检查时间来源

要查看设备当前连接到的 NTP 时间源，请使用describe-time-sourcesSnowball 边缘 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命令，而 Peer 节点只能是群集中的其他 Snowball Edge 设备。在示例输出中，describe-time-sources被称为在 5 个集群中的 Snowball Edge。输出包含 4 个 Peer 节点和 1 台服务器。Peer 节点的层为 10，而服务器的层级为 1；因此，服务器被选为当前时间源。