翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Snowball Edge クライアントの設定と使用
Snowball Edge Client は、Snowball Edge または Snowball Edge のクラスターを操作するために AWS 使用できる のコマンドラインインターフェイス (CLI) ツールです。クライアントを使用して、Snowball Edge またはデバイスのクラスターのロック解除、Snowball Edge のセットアップ、デバイスでのサービスの起動と停止、デバイスとの間でのデータ転送を行うことができます。Snowball Edge クライアントは、Linux、macOS および Windows オペレーティングシステムで動作するコンピュータと互換性があります。
**Topics**
+ [Snowball Edge クライアントのダウンロードとインストール](#download-the-client)
+ [Snowball Edge クライアント用プロファイルの設定](#client-configuration)
+ [Snowball Edge クライアントバージョンの検索](#cli-version)
+ [Snowball Edge の認証情報の取得](#client-credentials)
+ [Snowball Edge でサービスを開始する](#edge-start-service)
+ [Snowball Edge でのサービスの停止](#edge-stop-service)
+ [Snowball Edge からのログの表示とダウンロード](#logs)
+ [Snowball Edge のステータスの表示](#client-status)
+ [Snowball Edge で実行されているサービスのステータスの表示](#client-service-status)
+ [Snowball Edge の機能のステータスの表示](#snowball-edge-describe-features)
+ [Snowball Edge のタイムサーバーの設定](#client-set-ntp)
+ [Snowball Edge NFC タグを検証するための QR コードの取得](#client-qr-code)
+ [MTU サイズの更新](#update-mtu-size)
## Snowball Edge クライアントのダウンロードとインストール
Snowball Edge クライアントは「[AWS Snowball Edge リソース](https://aws.amazon.com/snowball/resources/)」からダウンロードできます。そのページに、お使いのオペレーティングシステムに適したインストールパッケージが用意されています。
以下の手順に従って、クライアントをインストールして設定します。
------
#### [ Linux ]
**注記**
Snowball Edge クライアントは、64 ビット Linux ディストリビューションでのみサポートされます。
1. `snowball-client-linux.tar.gz` ファイルを抽出します。`/snowball-client-linux-build_number/bin` フォルダ構造が作成され、そこにファイルが抽出されます。
1. 以下のコマンドを実行してフォルダを設定します。
```
chmod u+x snowball-client-linux-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-linux-build_number/jre/bin/java
```
1. オペレーティングシステムの \$1PATH 環境変数に `/snowball-client-linux-build_number/bin` を追加して、どのディレクトリからでも Snowball Edge クライアントのコマンドを実行できるようにします。詳細については、デバイスのオペレーティングシステムまたはシェルに関するドキュメントを参照してください。
------
#### [ macOS ]
1. `snowball-client-mac.tar.gz` ファイルを抽出します。`/snowball-client-linux-build_number/bin` フォルダ構造が作成され、そこにファイルが抽出されます。
1. 以下のコマンドを実行してフォルダを設定します。
```
chmod u+x snowball-client-mac-build_number/bin/snowballEdge
```
```
chmod u+x snowball-client-mac-build_number/jre/bin/java
```
1. オペレーティングシステムの \$1PATH 環境変数に `/snowball-client-mac-build_number/bin` を追加して、どのディレクトリからでも Snowball Edge クライアントのコマンドを実行できるようにします。詳細については、デバイスのオペレーティングシステムまたはシェルに関するドキュメントを参照してください。
------
#### [ Windows ]
クライアントは Microsoft Software Installer (MSI) ファイルとしてパッケージ化されます。ファイルを開き、インストールウィザードのプロンプトに従います。クライアントをインストールすると、追加の準備なしにどのディレクトリからでも実行できます。
------
## Snowball Edge クライアント用プロファイルの設定
Snowball Edge Client のコマンドを実行するたびに、Snowball Edge のマニフェストファイル、ロック解除コード、IP アドレスを指定します。コマンドを実行するたびにこれらを指定する代わりに、 `configure` コマンドを使用して、マニフェストファイル、29 文字のロック解除コード、エンドポイント (Snowball Edge の IP アドレス) へのパスをプロファイルとして保存できます。設定後、コマンドにプロファイル名を含めることで、コマンドごとにこれらの値を手動で入力することなく Snowball Edge クライアントのコマンドを使用できます。Snowball Edge クライアントの設定後、その情報はプレーンテキストの JSON 形式で `home directory/.aws/snowball/config/snowball-edge.config` に保存されます。このファイルを作成できるように環境が設定されていることを確認してください。
**重要**
設定ファイルにアクセスできるユーザーは誰でも、Snowball Edge デバイスまたはクラスター上のデータにアクセスできます。このファイルのローカルアクセスコントロールを管理することは、管理者の責任の 1 つです。
AWS OpsHub を使用してプロファイルを作成することもできます。で作成されたプロファイル AWS OpsHub は Snowball Edge クライアントで使用でき、 で作成されたプロファイル AWS OpsHub は Snowball Edge クライアントで使用できます。詳細については、「[Managing profiles](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-device.html#manage-profile)」を参照してください。
**プロファイルを作成するには**
1. オペレーティングシステムのコマンドラインインターフェイスにコマンドを入力します。`profile-name` パラメータの値は、プロファイルの名前です。今後、Snowball Edge クライアントコマンドを実行するときに指定します。
```
snowballEdge configure --profile profile-name
```
1. Snowball Edge クライアントは、各パラメータについてプロンプトを表示します。プロンプトが表示されたら、環境と Snowball Edge の情報を入力します。
**注記**
`endpoint` パラメータの値は、Snowball Edge の IP アドレスで、 の先頭に が付きます`https://`。Snowball Edge デバイスの IP アドレスは、デバイス前面の LCD 画面で確認できます。
**Example `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
```
Snowball Edge クライアントは、マニフェストファイルのロック解除コードが正しいことを確認します。一致しない場合、コマンドは停止し、プロファイルは作成されません。ロック解除コードとマニフェストファイルを確認し、コマンドを再度実行します。
プロファイルを使用するには、コマンド構文の`--profile profile-name`後に を含めます。
複数のスタンドアロン Snowball Edge を使用している場合は、それぞれにプロファイルを作成できます。別のプロファイルを作成するには、`configure` コマンドを再度実行し、`--profile` パラメータに別の値を指定し、別のデバイスの情報を指定します。
**Example `snowball-edge.config` ファイルの例**
この例は、`SnowDevice1profile`、`SnowDevice2profile`、`SnowDevice3profile` の 3 つのプロファイルを含むプロファイルファイルを示しています。
```
{"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":[]
}
}
```
プロファイルを編集または削除するには、テキストエディタでプロファイルファイルを編集します。
**プロファイルを編集するには**
1. テキストエディタで `home directory\.aws\snowball\config` から `snowball-edge.config` を開きます。
**注記**
このファイルの読み取りと書き込みにアクセスできるように環境が設定されていることを確認してください。
1. 必要に応じてファイルを編集します。たとえば、プロファイルに関連付けられた Snowball Edge の IP アドレスを変更するには、 `defaultEndpoint`エントリを変更します。
1. ファイルを保存して閉じます。
**プロファイルを削除するには**
1. テキストエディタを使用して、`home directory\.aws\snowball\config` から `snowball-edge.config` を開きます。
**注記**
このファイルの読み取りと書き込みにアクセスできるように環境が設定されていることを確認してください。
1. プロファイル名を含む行、プロファイル名の後に続く中括弧 `{``}`、括弧内の内容を削除します。
1. ファイルを保存して閉じます。
## Snowball Edge クライアントバージョンの検索
`version` コマンドを使用して、Snowball Edge コマンドラインインターフェイス (CLI) クライアントのバージョンを確認します。
**使用方法**
```
snowballEdge version
```
**出力例**
```
Snowball Edge client version: 1.2.0 Build 661
```
## Snowball Edge の認証情報の取得
`snowballEdge list-access-keys` および `snowballEdge get-secret-access-key` コマンドを使用して、Snowball Edge AWS アカウント で の管理ユーザーの認証情報を取得できます。これらの認証情報を使用して、 AWS Identity and Access Management (IAM ユーザー) とロールを作成し、 AWS CLI または AWS SDK で を使用するときにリクエストを認証できます。これらの認証情報は、Snowball Edge の個々のジョブにのみ関連付けられ、デバイスまたはデバイスのクラスターでのみ使用できます。デバイスには、 AWS クラウドの IAM アクセス許可はありません。
**注記**
Snowball Edge AWS CLI で を使用している場合は、 CLI を設定するときにこれらの認証情報を使用する必要があります。の認証情報の設定については AWS CLI、*AWS Command Line Interface 「 ユーザーガイド*[」の「 の設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration)」を参照してください。
**使用法 (Snowball Edge クライアント設定済み)**
```
snowballEdge list-access-keys
```
**Example Output**
```
{
"AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ]
}
```
**使用法 (Snowball Edge クライアント設定済み)**
```
snowballEdge get-secret-access-key --access-key-id Access Key
```
**Example Output**
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
## Snowball Edge でサービスを開始する
Snowball Edge デバイスは複数のサービスをサポートします。これには、コンピューティングインスタンス、ネットワークファイルシステム (NFS) インターフェイス、Snowball Edge Device Management、 が含まれます AWS IoT Greengrass。Amazon S3 アダプターサービス、Amazon EC2 AWS STS、および IAM はデフォルトで起動され、停止または再起動することはできません。ただし、NFS インターフェイス、Snowball Edge Device Management、および は、 `start-service` コマンドでサービス ID を使用して開始 AWS IoT Greengrass できます。各サービスのサービス ID を取得するには、`list-services` コマンドを使用できます。
このコマンドを実行する前に、1 つの仮想ネットワークインターフェイスを作成して、開始するサービスに結合します。詳細については、「[Snowball Edge での仮想ネットワークインターフェイスの作成](using-ec2-edge-client.md#ec2-edge-create-vnic)」を参照してください。
```
snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn --profile profile-name
```
**Example `start-service` コマンドの出力例**
```
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 で実行されているサービスを停止するには、 `stop-service` コマンドを使用できます。
Amazon S3 アダプター、Amazon EC2 AWS STS、IAM サービスは停止できません。
**警告**
バッファされたデータの残りがデバイスに書き込まれる前に、ネットワークファイルシステム (NFS) サービスが停止すると、データ損失が発生する可能性があります。NFS サービスの使用方法の詳細については、「[Snowball Edge での NFS インターフェイスの管理](shared-using-nfs.md)」を参照してください。
**注記**
Snowball Edge サービスで Amazon S3 互換ストレージを停止すると、デバイスまたはクラスター上の S3 バケットに保存されているデータへのアクセスが無効になります。Snowball Edge の Amazon S3 互換ストレージが再び起動されると、アクセスが復元されます。Snowball Edge で Amazon S3 互換ストレージが有効になっているデバイスの場合、Snowball Edge デバイスの電源を入れた後にサービスを開始することをお勧めします。本ガイドの「[Snowball Edge のセットアップ](https://docs.aws.amazon.com/snowball/latest/developer-guide/s3compatible-on-snow.html#setting-up-s3-on-snow-cluster)」を参照してください。
```
snowballEdge stop-service --service-id service_id --profile profile-name
```
**Example `stop-service` コマンドの出力例**
```
Stopping 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 間でデータを転送すると、自動的にログが生成されます。デバイスへのデータ転送中に予期しないエラーが発生した場合は、次のコマンドを使用してログのコピーをローカルサーバーに保存できます。
ログに関連するコマンドは、以下の 3 つです。
+ `list-logs` – JSON 形式でログのリストを返します。このリストには、ログのサイズ (バイト単位)、ログの ARN、ログのサービス ID、およびログのタイプが報告されます。
**使用方法**
```
snowballEdge list-logs --profile profile-name
```
**Example `list-logs` コマンドの出力例**
```
{
"Logs" : [ {
"LogArn" : "arn:aws:snowball-device:::log/s3-storage-JIEXAMPLE2f-1234-4953-a7c4-dfEXAMPLE709",
"LogType" : "SUPPORT",
"ServiceId" : "s3",
"EstimatedSizeBytes" : 53132614
}, {
"LogArn" : "arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709",
"LogType" : "CUSTOMER",
"ServiceId" : "fileinterface",
"EstimatedSizeBytes" : 4446
}]
}
```
+ `get-log` – 特定のログのコピーを、Snowball Edge から、指定したパスにあるデバイスにダウンロードします。`CUSTOMER` ログは `.zip` 形式で保存されます。このタイプのログは抽出して内容を表示できます。`SUPPORT` ログは暗号化され、 AWS サポートだけが読み取ることができます。ログの名前とパスを指定するオプションがあります。
**使用方法**
```
snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709 --profile profile-name
```
**Example `get-log` コマンドの出力例**
```
Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin
```
+ `get-support-logs` – Snowball Edge から、`SUPPORT` タイプのすべてのログのコピーを指定したパスのサービスにダウンロードします。
**使用方法**
```
snowballEdge get-support-logs --profile profile-name
```
**Example `get-support-logs` コマンドの出力例**
```
Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
```
**重要**
`CUSTOMER` タイプには、お客様独自のデータに関する機密情報が含まれている可能性があります。個の機密情報を保持するために、これらのログが不要になったら削除することを強くお勧めします。
## Snowball Edge のステータスの表示
`describe-device` コマンドを使用して、Snowball Edge のステータスと全般的な状態を判断できます。
```
snowballEdge describe-device --profile profile-name
```
**Example `describe-device` コマンドの出力例**
```
{
"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"
}
]
}
```
## Snowball Edge で実行されているサービスのステータスの表示
`describe-service`コマンドを使用して、Snowball Edge デバイスで実行中のサービスのステータスと全般的なヘルスを判断できます。最初に `list-services` コマンドを実行して、実行中のサービスを確認します。
+ `list-services`
**使用方法**
```
snowballEdge list-services --profile profile-name
```
**Example `list-services` コマンドの出力例**
```
{
"ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}
```
+ `describe-service`
このコマンドは、サービスのステータス値が返されます。また、サービスで発生した問題を解決するのに役立つ状態情報も含まれています。これらの状態は次のとおりです。
+ `ACTIVE` – このサービスは実行されており、使用できます。
+ `ACTIVATING` – このサービスは起動しますが、まだ使用することはできません。
+ `DEACTIVATING` – このサービスはシャットダウン処理の途中です。
+ `DEGRADED` – Snowball Edge 上の Amazon S3 互換ストレージの場合、このステータスはクラスター内の 1 つ以上のディスクまたはデバイスがダウンしていることを示します。Snowball Edge サービスの Amazon S3 互換ストレージは中断なく実行されていますが、クラスタークォーラムが失われる前に、影響を受けるデバイスを復旧または交換して、データ損失のリスクを最小限に抑える必要があります。本ガイドの「[クラスタリングの概要](https://docs.aws.amazon.com/snowball/latest/developer-guide/ClusterOverview.html)」を参照してください。
+ `INACTIVE` – このサービスは実行されておらず、使用することはできません。
**使用方法**
```
snowballEdge describe-service --service-id service-id --profile profile-name
```
**Example `describe-service` コマンドの出力例**
```
{
"ServiceId": "s3",
"Status": {
"State": "ACTIVE"
},
"Storage": {
"TotalSpaceBytes": 99608745492480,
"FreeSpaceBytes": 99608744468480
},
"Endpoints": [
{
"Protocol": "http",
"Port": 8080,
"Host": "192.0.2.0"
},
{
"Protocol": "https",
"Port": 8443,
"Host": "192.0.2.0",
"CertificateAssociation": {
"CertificateArn": "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
}
}
]
}
```
**Example Snowball Edge サービス出力の Amazon S3 互換ストレージ**
`describe-service` コマンドは、`service-id` パラメータの *s3-snow* 値に対して次の出力を提供します。
```
{
"ServiceId" : "s3-snow",
"Autostart" : false,
"Status" : {
"State" : "ACTIVE"
},
"ServiceCapacities" : [ {
"Name" : "S3 Storage",
"Unit" : "Byte",
"Used" : 640303104,
"Available" : 219571981512
} ],
"Endpoints" : [ {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.123",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.202",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.63",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.243",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.220",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.55",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.213",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.144",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.2.143",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow bucket API endpoint",
"DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2",
"Status" : {
"State" : "ACTIVE"
}
}, {
"Protocol" : "https",
"Port" : 443,
"Host" : "10.0.3.224",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456"
},
"Description" : "s3-snow object API endpoint",
"DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2",
"Status" : {
"State" : "ACTIVE"
}
} ]
}
```
## Snowball Edge の機能のステータスの表示
Snowball Edge で使用できる機能のステータスを一覧表示するには、 `describe-features` コマンドを使用します。
`RemoteManagementState` は Snowball Edge Device Management のステータスを示し、次のいずれかの状態を返します。
+ `INSTALLED_ONLY` – 機能はインストールされていますが、有効になっていません。
+ `INSTALLED_AUTOSTART` – この機能が有効で、デバイスは電源が入っている AWS リージョン ときに への接続を試みます。
+ `NOT_INSTALLED` – デバイスはこの機能をサポートしないか、起動前に既にフィールドに入っていました。
**使用方法**
```
snowballEdge describe-features --profile profile-name
```
**Example `describe-features` コマンドの出力例**
```
{
"RemoteManagementState" : String
}
```
## Snowball Edge のタイムサーバーの設定
Snowball Edge クライアントのコマンドを使用して、現在の Network Time Protocol (NTP) 設定を表示し、時間を提供するサーバーまたはピアを選択できます。Snowball Edge クライアントのコマンドは、デバイスがロック状態とロック解除状態の両方の場合に使用できます。
セキュリティで保護された NTP タイムサーバーは、お客様が用意する必要があります。デバイスを接続する NTP タイムサーバーを設定するには、`update-time-servers` コマンドを使用します。
### Snowball Edge の時間ソースの確認
デバイスが現在接続されている NTP タイムソースを確認するには、`describe-time-sources` コマンドを使用します。
```
snowballEdge describe-time-sources --profile profile-name
```
**Example `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` フィールドを含みます。これらのフィールドの意味は以下のとおりです。
+ `Address` – タイムソースの DNS 名/ IP アドレス。
+ `State` – デバイスとそのタイムソース間の現在の接続ステータス。5 つの状態が想定されます。
+ `CURRENT` – タイムソースは現在、時刻の同期に使用されている。
+ `COMBINED` – タイムソースは現在のソースと結合されている。
+ `EXCLUDED` – タイムソースが結合アルゴリズムによって除外された。
+ `LOST` – タイムソースとの接続が切断された。
+ `UNACCEPTABLE` – 結合アルゴリズムが偽ティッカーであるか、ばらつきが多すぎるとみなされた無効なタイムソース。
+ `Type`— NTP タイムソースは、サーバーまたはピアのいずれかになります。サーバーは、`update-time-servers` コマンドにより設定できます。ピアは、クラスター内の他の Snowball Edge デバイスにのみ使用でき、クラスターが関連付けられると自動的に設定されます。
+ `Stratum` – このフィールドには、ソースの階層が表示されます。階層 1 は、ローカルでアタッチされたリファレンスクロックを持つソースを示します。階層 1 のソースに同期されたソースは、階層 2 にあります。階層 2 のソースに同期されたソースは、階層 3 などにあります。
NTP タイムソースは、サーバーまたはピアのいずれかになります。サーバーは `update-time-servers` コマンドを使用してユーザーが設定できますが、ピアはクラスター内の他の Snowball Edge デバイスのみに設定できます。出力例では、 `describe-time-sources` は 5 のクラスターにある Snowball Edge で呼び出されます。出力には、4 つのピアと 1 台のサーバーが含まれます。ピアの階層は 10 で、サーバーの階層は 1 であるため、サーバーが現在のタイムソースとして選択されます。
### タイムサーバーの更新
`update-time-servers` コマンドとタイムサーバーアドレスを使用して、NTP に NTP サーバーまたはピアを使用するように Snowball Edge を設定します。
```
snowballEdge update-time-servers time-server-address --profile profile-name
```
**注記**
`update-time-servers` コマンドは、以前の NTP タイムサーバーの設定を上書きします。
**Example `update-time-servers` コマンドの出力例**
```
Updating time servers now.
```
## Snowball Edge NFC タグを検証するための QR コードの取得
このコマンドを使用して、 AWS Snowball Edge の検証アプリケーションで使用するデバイス固有の QR コードを生成することができます。NFC 検証の詳細は、[NFC タグの検証](data-protection.md#nfc-validation) を参照してください。
**使用方法**
```
snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png --profile profile-name
```
**Example Output**
```
QR code is saved to ~/downloads/snowball-qr-code.png
```
## MTU サイズの更新
`update-mtu-size` コマンドを使用して、Snowball Edge デバイスの物理インターフェイスの最大送信単位 (MTU) のバイト単位のサイズを変更します。この物理ネットワークインターフェイスに関連付けられたすべての仮想ネットワークインターフェイスとダイレクトネットワークインターフェイスは、同じ MTU サイズで設定されます。
**注記**
最小 MTU サイズは 1,500 バイト、最大サイズは 9,216 バイトです。
`describe-device` コマンドを使用して、物理ネットワークインターフェイス ID とインターフェイスの現在の MTU サイズを取得できます。詳細については、「[Snowball Edge のステータスの表示](#client-status)」を参照してください。
`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 --profile profile-name
```
**Example `update-mtu-size` の出力**
```
{
"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"
}
}
```