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 アドレスを指定します。これらのうち最初の 2 つは、 AWS Snow ファミリーマネジメントコンソール またはジョブ管理 API から取得できます。マニフェストとロック解除コードの取得の詳細については、「Snow Family デバイスにアクセスするための認証情報の取得」を参照してください。

snowballEdge configure コマンドを使用して、マニフェストへのパス、29 文字のロック解除コード、およびエンドポイントをプロファイルとして保存するオプションがあります。設定すると、特定のジョブ用にこれらの値を手動で入力することなく、他の Snowball Edge クライアントのコマンドを使用できます。Snowball Edge クライアントの設定後、その情報はプレーンテキストの JSON 形式で home directory/.aws/snowball/config/snowball-edge.config に保存されます。

エンドポイントは IP アドレスで、https:// が追加されます。 AWS Snowball Edge デバイス LCD ディスプレイで AWS Snowball Edge デバイスの IP アドレスを見つけることができます。 AWS Snowball Edge デバイスが初めてネットワークに接続されると、DHCP サーバーが使用可能な場合、DHCP IP アドレスが自動的に取得されます。別の IP アドレスを使用する場合は、LCD ディスプレイから変更できます。詳細については、「AWS Snowball エッジデバイスの使用」を参照してください。

使用方法

このコマンドは 2 つの方法で (インライン、または求められたとき) 使用できます。この使用例は、求められたときの方法を示しています。

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

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 コマンドを使用して、 AWS アカウント Snowball Edge 上の の管理者ユーザーの認証情報を取得できます。これらの認証情報を使用して、 AWS Identity and Access Management (IAM ユーザー) とロールを作成し、 AWS CLI または AWS SDK で を使用するときにリクエストを認証できます。これらの認証情報は、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 コマンドを使用できます。

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

使用法 (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 AWS STS、IAM サービスは停止できません。

使用法 (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 コマンドを使用します。

このコマンドを実行する前に、1 つの仮想ネットワークインターフェイスを作成して、開始するサービスに結合します。詳細については、仮想ネットワークインターフェイスの作成を参照してください。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 間でデータを転送すると、自動的にログが生成されます。デバイスへのデータ転送中に予期しないエラーが発生した場合は、次のコマンドを使用してログのコピーをローカルサーバーに保存できます。

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

デバイスステータスの取得

以下の 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-compatibleを変更すると、インターフェイスはデタッチされます。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-compatibleコンピューティングインスタンスに関連付けられた 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 Device Management のステータスを表示し、次のいずれかの状態を返します。

使用法 (Snowball Edge クライアント設定済み)

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

出力例

{
  "RemoteManagementState" : String
}
            

タイムサーバーの設定

外部ネットワークタイムプロトコル (NTP) サーバーを設定できます。NTP CLI コマンドは、デバイスがロック状態とロック解除状態の両方の場合に使用できます。マニフェストと解除コードが必要です。これらは、snowballEdge configure コマンド、または --manifest-file および --unlock-code オプションを使用して設定できます。 AWS Snowcone Edge と の両方で snowballEdge CLI を使用できることに注意してください 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 デバイスのみとなります。出力例では、describe-time-sources は、5 のクラスター内にある Snowball Edge で呼び出されます。出力には、4 つのピアと 1 台のサーバーが含まれます。ピアの階層は 10 で、サーバーの階層は 1 であるため、サーバーが現在のタイムソースとして選択されます。

MTU サイズの更新

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

describe-device コマンドを使用して、物理ネットワークインターフェイス IDsとそれらのインターフェイスの現在の 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"
    }
}