Create Your First Amazon EBS Import Job

To create an Amazon EBS import job

1. Verify that your valid AWS credentials are in the correct location.

   For more information, refer to the previous procedure: To save your access credentials to a file.

2. Create a manifest:

   1. Open a new file in any text editor and copy the following manifest text as a new file.

      The manifest options shown are the minimum suggested set of options.

      manifestVersion: 3.0
      accessKeyId: ***Enter Your Access Key ID***
      deviceId: SomeDeviceSerialNumber
      eraseDevice: no
      logBucket: ***An existing Amazon S3 Bucket Name***
      generator: AWS Import Export Docs
      operations:
         - destination: ebs-snapshot
           source: device
           region: us-east-1
           deviceCapacityGreaterThan1TB: no
      returnAddress:
        name: ***Your Name***
        street1: ***Your Street***
        city: ***Your City***
        stateOrProvince: ***Your State***
        postalCode: ***Your Postal/Zip Code***
        phoneNumber: ***Your Number***
        country: ***Your Country***

   2. Update the manifest by providing your Access Key Id, your existing Amazon S3 logBucket name for logging. For the logBucket option, provide only the name of your bucket, for example s3examplebucket.

   3. The operations option specifies that the data is imported into an Amazon EBS snapshot. Change the region parameter to specify the correct region. For more information on how to specify the operations option, see Import to Amazon EBS Manifest File Options.

      	Note
      	You can also change many other items in the manifest. For more information, see Manifest File Options.

   4. If you are sending a storage device after creating this job, you must also provide your address.

   5. Save the file as MyManifest.txt, in the same folder as your AWSCredentials.properties file.

3. Send the Request:

   1. Open a command prompt, change to the directory where you downloaded the AWS Import/Export tool.

   2. Enter the following CreateJob request.

      CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import MyManifest.txt .  

      At the command prompt, you must provide a directory name for where you want the PDF packing slip file saved. The closing period (.) at the end of the preceding command refers to the current directory where you issue the command. If there are no errors in the request, AWS Import/Export returns a job created response. Following is a sample response.

      JOB CREATED 
      
      JobId: ABCDE 
      JobType: Import
      
      Shipping instructions saved to C:\DirectoryName\.\shipping-instructions-ABCDE.pdf
      
      SHIPPING INSTRUCTIONS:
      
      1. Open the Shipping Instructions file with a PDF reader.
      2. Print out the Shipping Instructions which includes the AWS Shipping Address 
      and Signature barcode.
      3. Follow the directions in the PDF file, which includes cutting out and securely
       attaching the Signature barcode to your device.
      
      *IMPORTANT* - Failure to attach the Signature barcode to your device will prevent 
      AWS from loading your data.  This barcode can only be used with 1 device. 

4. Print the PDF with shipping instructions with barcode.

   After the CreateJob request completes successfully, AWS places the shipping instructions as a PDF file in the directory where you're currently running the command line tool. A copy of the PDF is also placed in the Amazon S3 bucket you specified with the logBucket manifest option. The name of the PDF file is shipping-instruction-YOURJOBID.pdf where the YOURJOBID is the name of the job for your request.

   The shipping instructions contain information about how and where to ship your device. The instructions include a barcode that uniquely associates your device with your job request.

   	Note
   	If an error occurs during the CreateJob process, an error message will indicate the cause. You can then either get the shipping instructions from the Amazon S3 bucket, or you can retry the download using the GetShipInfo operation. For more information, see Getting Shipping Information.

5. Attach the barcode to your device.

   Follow the shipping instructions and attach the barcode to your device. You are ready to send your storage device to AWS to upload your data to an Amazon EBS snapshot.

   Note

   If your storage device is less than or equal to the maximum volume size of 1TB, its contents are loaded directly into an Amazon EBS snapshot. If your storage device’s capacity exceeds 1TB, a device image is stored within your specified Amazon S3 log bucket. You can then create a RAID of Amazon EBS volumes using software such as Logical Volume Manager, and copy the image from Amazon S3 to this new volume.