Snowball Edge クライアントの設定と使用

Snowball Edge Client は、Snow Family デバイスまたは Snow Family デバイスのクラスターを操作するために AWS 使用できるコマンドラインインターフェイス (CLI) ツールです。クライアントを使用して、Snow Family デバイスまたはデバイスのクラスターのロック解除、Snow Family デバイスのセットアップ、デバイスのサービスの開始と停止、デバイスとの間でのデータ転送を行うことができます。Snowball Edge クライアントは、Linux、macOSおよび Windows オペレーティングシステムで実行されているコンピュータと互換性があります。

Snowball Edge クライアントのダウンロードとインストール

Snowball Edge クライアントは、 AWS Snowball Edge リソース からダウンロードできます。そのページに、お使いのオペレーティングシステムに適したインストールパッケージが用意されています。

以下の手順に従って、クライアントをインストールして設定します。

Snowball Edge クライアントのプロファイルの設定

Snowball Edge Client のコマンドを実行するたびに、Snow Family デバイスのマニフェストファイル、ロック解除コード、IP アドレスを指定します。コマンドを実行するたびにこれらを指定する代わりに、 configure コマンドを使用して、マニフェストファイル、29 文字のロック解除コード、エンドポイント (Snow Family デバイスの IP アドレス) へのパスをプロファイルとして保存できます。設定後、Snowball Edge Client コマンドは、 コマンドにプロファイル名を含めることで、各コマンドにこれらの値を手動で入力することなく使用できます。Snowball Edge Client を設定すると、情報はプレーンテキストJSON形式で に保存されますhome directory/.aws/snowball/config/snowball-edge.config。このファイルを作成できるように環境が設定されていることを確認してください。

AWS OpsHub を使用してプロファイルを作成することもできます。で作成されたプロファイル AWS OpsHub は Snowball Edge Client で使用でき、 で作成されたプロファイル AWS OpsHub は Snowball Edge Client で使用できます。詳細については、「プロファイルの管理」を参照してください。

プロファイルを使用するには、コマンド構文--profile profile-nameの前に を含めます。

複数のスタンドアロン Snow Family デバイスを使用している場合は、それぞれにプロファイルを作成できます。別のプロファイルを作成するには、configureコマンドを再度実行し、--profileプラメータに別の値を指定し、別のデバイスの情報を指定します。

{"version":1,"profiles":
    {
    "SnowDevice1profile":
        {
            "name":"SnowDevice1profile",
            "jobId":"JID12345678-136f-45b4-b5c2-847db8adc749",
            "unlockCode":"db223-12345-dbe46-44557-c7cc2",
            "manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-136f-45b4-b5c2-847db8adc749_manifest-1670622989203.bin",
            "defaultEndpoint":"https://10.16.0.1",
            "isCluster":false,
            "deviceIps":[]
        },
    },
    "SnowDevice2profile":
    {
        "name":"SnowDevice2profile",
        "jobId":"JID12345678-fdb2-436a-a4ff-7c510dec1bae",
        "unlockCode":"b893b-54321-0f65c-6c5e1-7f748",
        "manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-fdb2-436a-a4ff-7c510dec1bae_manifest-1670623746908.bin",
        "defaultEndpoint":"https://10.16.0.2",
        "isCluster":false,
        "deviceIps":[]
    },
    "SnowDevice3profile":
    {
        "name":"SnowDevice3profile",
        "jobId":"JID12345678-c384-4a5e-becd-ab5f38888463",
        "unlockCode":"64c89-13524-4d054-13d93-c1b80",
        "manifestPath":"C:\\Users\\Administrator\\.aws\\ops-hub\\manifest\\JID12345678-c384-4a5e-becd-ab5f38888463_manifest-1670623999136.bin",
        "defaultEndpoint":"https://10.16.0.3",
        "isCluster":false,
        "deviceIps":[]
    }
}
                        

プロファイルを編集または削除するには、テキストエディタでプロファイルファイルを編集します。

Snowball Edge クライアントバージョンの検索

version コマンドを使用して、Snowball Edge コマンドラインインターフェイス (CLI) クライアントのバージョンを確認します。

使用方法

    snowballEdge version                
            

出力例

    Snowball Edge client version: 1.2.0  Build 661                
            

Snow Family デバイスの認証情報の取得

snowballEdge list-access-keys および snowballEdge get-secret-access-key コマンドを使用すると、Snowball Edge AWS アカウント 上の の管理ユーザーの認証情報を取得できます。これらの認証情報を使用して AWS Identity and Access Management （IAM ユーザー) とロールを作成し、 AWS CLI または を で使用するときにリクエストを認証できます AWS SDK。これらの認証情報は、Snowball Edge の個々のジョブにのみ関連付けられ、デバイスまたはデバイスのクラスターでのみ使用できます。デバイスまたはデバイスには、 のIAMアクセス許可がありません AWS クラウド。

使用法 (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

Snow Family デバイスでサービスを開始する

Snowball Edge デバイスは、複数のサービスをサポートしています。これには、コンピューティングインスタンス、ネットワークファイルシステム (NFS) インターフェイス、Snow Device Management、および が含まれます AWS IoT Greengrass。Amazon S3 アダプターサービス、Amazon EC2、および IAMはデフォルトで開始され AWS STS、停止または再起動することはできません。ただし、 NFSインターフェイス、Snow Device Management、および は、 start-service コマンドでサービス ID を使用して開始 AWS IoT Greengrass できます。各サービスのサービス ID を取得するには、list-services コマンドを使用できます。

このコマンドを実行する前に、1 つの仮想ネットワークインターフェイスを作成して、開始するサービスに結合します。詳細については、「Snow Family デバイスでの仮想ネットワークインターフェイスの作成」を参照してください。

snowballEdge start-service --profile profile-name --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.

Snow Family デバイスでのサービスの停止

Snow Family デバイスで実行されているサービスを停止するには、 stop-service コマンドを使用します。

Amazon S3 アダプター、Amazon EC2 AWS STS、および IAMサービスは停止できません。

snowballEdge stop-service --profile profile-name --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.

Snow Family デバイスからのログの表示とダウンロード

オンプレミスのデータセンターと Snow Family デバイス間でデータを転送した場合、ログが自動的に生成されます。デバイスへのデータ転送中に予期しないエラーが発生した場合は、次のコマンドを使用してログのコピーをローカルサーバーに保存できます。

ログに関連するコマンドは、以下の 3 つです。

Snow Family デバイスのステータスの表示

describe-device コマンドを使用して、Snow Family デバイスのステータスと全般的な状態を判断できます。

snowballEdge describe-device --profile profile-name

                            {
  "DeviceId": "JID-EXAMPLE12345-123-456-7-890",
  "UnlockStatus": {
    "State": "UNLOCKED"
  },
  "ActiveNetworkInterface": {
    "IpAddress": "192.0.2.0"
  },
  "PhysicalNetworkInterfaces": [
    {
      "PhysicalNetworkInterfaceId": "s.ni-EXAMPLEd9ecbf03e3",
      "PhysicalConnectorType": "RJ45",
      "IpAddressAssignment": "STATIC",
      "IpAddress": "0.0.0.0",
      "Netmask": "0.0.0.0",
      "DefaultGateway": "192.0.2.1",
      "MacAddress": "EX:AM:PL:E0:12:34"
    },
    {
      "PhysicalNetworkInterfaceId": "s.ni-EXAMPLE4c3840068f",
      "PhysicalConnectorType": "QSFP",
      "IpAddressAssignment": "STATIC",
      "IpAddress": "0.0.0.0",
      "Netmask": "0.0.0.0",
      "DefaultGateway": "192.0.2.2",
      "MacAddress": "EX:AM:PL:E0:56:78"
    },
    {
      "PhysicalNetworkInterfaceId": "s.ni-EXAMPLE0a3a6499fd",
      "PhysicalConnectorType": "SFP_PLUS",
      "IpAddressAssignment": "DHCP",
      "IpAddress": "192.168.1.231",
      "Netmask": "255.255.255.0",
      "DefaultGateway": "192.0.2.3",
      "MacAddress": "EX:AM:PL:E0:90:12"
    }
  ]
}

Snow Family デバイスで実行されているサービスのバイイングステータス

describe-serviceコマンドを使用して、Snowball Edge デバイスで実行中のサービスのステータスと全般的なヘルスを判断できます。最初に list-services コマンドを実行して、実行中のサービスを確認します。

Snow Family デバイスの機能のステータスの表示

Snow Family デバイスで使用可能な機能のステータスを一覧表示するには、 describe-features コマンドを使用します。

RemoteManagementState は、Snow Device Management のステータスを表示し、次のいずれかの状態を返します。

使用方法

snowballEdge describe-features --profile profile-name

{
  "RemoteManagementState" : String
}
            

Snow Family デバイスのタイムサーバーの設定

Snowball Edge Client コマンドを使用して、現在の Network Time Protocol (NTP) 設定を表示し、時間を提供するサーバーまたはピアを選択できます。Snowball Edge Client コマンドは、デバイスがロック状態とロック解除状態の両方にあるときに使用できます。

安全なNTPタイムサーバーを提供するのはお客様の責任です。デバイスが接続するNTPタイムサーバーを設定するには、 update-time-servers コマンドを使用します。

Snow Family デバイスの時間ソースの確認

デバイスが現在接続されているNTP時間ソースを確認するには、 describe-time-sources コマンドを使用します。

snowballEdge describe-time-sources --profile profile-name

{
  "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 デバイスのみとなります。出力例では、describe-time-sources は、5 のクラスター内にある Snowball Edge で呼び出されます。出力には、4 つのピアと 1 台のサーバーが含まれます。ピアの階層は 10 で、サーバーの階層は 1 であるため、サーバーが現在のタイムソースとして選択されます。

タイムサーバーの更新

update-time-servers コマンドとタイムサーバーアドレスを使用して、Snow Family デバイスを のNTPサーバーまたはピアを使用するように設定しますNTP。

snowballEdge update-time-servers --profile profile-name time-server-address

Updating time servers now.

Snowball Edge NFC タグを検証するための QR コードの取得

このコマンドを使用して、 AWS Snowball Edge Verification App で使用するデバイス固有の 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

MTU サイズの更新

update-mtu-size コマンドを使用して、Snow Family デバイスの物理インターフェイスの最大送信単位 (MTU) のバイト単位でサイズを変更します。この物理ネットワークインターフェイスに関連付けられたすべての仮想ネットワークインターフェイスと直接ネットワークインターフェイスは、同じMTUサイズで設定されます。

describe-device コマンドを使用して、物理ネットワークインターフェイスIDsとそのインターフェイスの現在のMTUサイズを取得できます。詳細については、「Snow Family デバイスのステータスの表示」を参照してください。

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"
    }
}