Performing a Microsoft Windows Workstation Capture

Use the following procedures to capture data by using a Microsoft Windows workstation. For supported versions of Microsoft Windows, see supported operating systems.

Prerequisites

You need to know the following information so that you can connect to Google Transfer Appliance from a workstation:

  • The URL for Transfer Appliance. This is displayed on the Transfer Appliance console.
  • The password for the capture user credentials provided to you by Google.

Also, before proceeding, make sure you have read Preparing for Data Transfer and performed any necessary data or network preparation.

Install the capture utility on a Microsoft Windows workstation

Use the following procedure to install the capture utility on a Microsoft Windows workstation.

  1. On a workstation, connect to the Transfer Appliance web interface.
  2. Select Download Windows Capture Utility in the Operations pane to download the capture utility installer.
  3. Unzip the Windows capture utility download. This creates the CaptureUtility directory containing the installer TACaptureUtilitySetup.exe.
  4. Double click the installer to start the installation process.
  5. Click Next.
  6. On the Choose Install Location screen, Destination Folder defaults to C:\Program Files\TA. To change the destination folder, click Browse and browse to the folder where you want to install the capture utility.
  7. Click Install.
  8. Click Finish to close the install wizard.
  9. Click OK to close the install confirmation dialog.

Test connectivity to the Transfer Appliance

Before running your first data capture job, check to make sure the workstation can connect to the Transfer Appliance.

  1. To run the capture utility, locate the Transfer Appliance Capture Utility icon on your Windows desktop, right-click it, and choose Run as administrator. This opens a command prompt.
  2. Test connectivity with the Transfer Appliance by running TACapture.exe with the -t option.

    C:\Program Files\TA>TACapture.exe -t

  3. You are prompted to enter the capture user password provided to you by Google.

    Enter Transfer Appliance <Transfer Appliance IP address> "cuser" password for SSH

    The workstation pings Transfer Appliance and returns results similar to the following:

    Test: Ping Transfer Appliance (123.456.78.90)...OK Test: SSH to Transfer Appliance (123.456.78.90:6422)...OK Test: Control connection with Transfer Appliance (123.456.78.90:25025)...OK Test: Return connection from Transfer Appliance to this workstation, (could take several minutes)...OK

    If the connection test fails, refer to the error message returned to determine the cause. The most common reason for connectivity test failure is a firewall blocking the ports needed for data capture. Refer to Prepare the Network for details on which ports need to be open and instructions for opening them.

Perform a workstation capture from a Microsoft Windows workstation

After checking connectivity, use the capture utility to start a data capture job.

  1. Run TACapture.exe and specify a job name and capture target to run a data capture job:

    C:\Program Files\TA>TACapture.exe [JOB NAME] [CAPTURE DIRECTORY]

    where [JOB NAME] is the name of the data capture job and [CAPTURE DIRECTORY] is the directory that contains the data to capture. The capture utility recursively captures all data in the directories under the one specified.

  2. Enter the capture user password provided to you by Google when prompted:

    Enter Transfer Appliance <Transfer Appliance IP address> "cuser" password for SSH

    The capture job runs and displays a completion message when it is finished. Don't close the terminal window while the capture job is running or the job will be terminated.

For example, the following command creates a job named data-capture to capture the data in the directory D:\Data and all subdirectories.

C:\Program Files\TA>TACapture.exe data-capture D:\Data

Use a specific port range for data capture

By default, a data capture job on Microsoft Windows dynamically chooses a port range between 49152 and 65535 to use. If those ports aren't open on your network or you prefer to use a different port range, you can specify a port to start the port range from by using the -p option. Each data capture task in the job requires its own data streaming port and chooses one from the range between the specified port number and ([port number] + [data capture tasks] - 1).

For example, the following command creates a job named dataFactory that uses 8 parallel data capture tasks on ports 65000 - 65007 to capture the data in the directory D:\Data and all subdirectories.

C:\Program Files\TA>TACapture.exe dataFactory D:\Data -p 65000

For more information about the options for the capture utility, see Capture Utility Reference.

Use a specified number of data capture tasks

By default, a data capture job uses 8 parallel data capture tasks for optimal throughput. To use fewer parallel capture tasks, use the -m option with TACapture.exe. You might want to do this if you want to use fewer ports or if you have poor network bandwidth.

For example, the following command creates a job named dataFactory that uses 6 parallel data capture tasks to capture the data in the directory D:\Data and all subdirectories.

C:\Program Files\TA>TACapture.exe dataFactory D:\Data -m 6

For more information about the options for the capture utility, see Capture Utility Reference.

Use a file specification to identify data for capture

By default, a job captures data from a single directory that you specify. To capture data from one or more files instead, create a text file containing a file specification and use the -f option with TACapture.exe. The text file must contain one absolute path to a target data file on each line, as illustrated below:

C:\Documents\finances.csv D:\App\archive\data.json C:\Program Files\Acme\logs\log_001.log

For example, the following command creates a job named dataFactory that captures the data identified in the file filespec.txt.

C:\Program Files\TA>TACapture.exe dataFactory -f C:\Documents\filespec.txt

For more information about the options for the capture utility, see Capture Utility Reference.

Next steps

To perform parallel data capture tasks, follow these instructions on a separate workstation or the Transfer Appliance:

To monitor data capture jobs, use the procedures in Monitoring Capture Jobs.

If you are done capturing data, use the procedures in Preparing and Shipping Transfer Appliance.

Enviar comentários sobre…

Google Transfer Appliance