Support    >    User Guides & Training Materials    >    Tutorials

Tutorial: Scope Action

How to retrieve a data file from a group of machines and copy them into a central directory

This tutorial describes how to configure a Scope Action to retrieve a data file generated locally on a group of machines and copy each file into a central location. Since the data file name is the same for each machine, the destination file name must include the originating computer name within it.

Solution

 

 

Let's assume that each client computer is equipped with a process which generates the following log file: %SystemDrive%\Temp\AppData.txt and that we need to copy this file from a group of machines to the central location:  \\MADOCO\GoverlanLOGS.

The destination files must have the name format:  AppData_MACHINENAME.txt where MACHINENAME is the name of the computer from which the file originated.

  1. Create a new scope action, define its name and click on Next.

  2. Under Scope, select the Computers object type and define the list of machines to process (see: Defining the Scope). Click on Next.

  3. Under Actions, double click on Add New to start the Action Module property window.

  4. Under Execute the following Action(s), click on 
    Add/Remove > Execute Computer Action > File & Directory Actions > Copy Move or Rename a File

  5. In the Set Arguments window:

    1. Set the Source File Local Path to:  %SystemDrive%\Temp\AppData.txt

    2. Click within the Destination File Local Path cell and then click on the Dynamic Value Definition link located in the left pane of the window.

    3. In the Dynamic Value Definition window, type:  \\MADOCO\GoverlanLOGS\AppData_ then press the [INSERT] key.

    4. From the menu, select the NT Account Name attribute.

    5. Complete the value string with .txt
      You should see this:

      Dynamic Value Definition Window
       

    6. Click on Ok.

    7. Set the Run As Type to 3 and configure a domain account User ID / Password in the Run As User ID and Run As Password fields respectively.
      Note that these user credentials must have enough privileges to access both the local hard drive of your client computers as well as the central network resource.

    8. Set the Overwrite Existing File and Delete Source File according to your needs.
      You should see this:

      Argument Window
       

    9. Click on Ok. Then Ok again.

  6. Complete your scope action and run.

Goverlan will then visit each computer as defined in the Scope, copy the AddData.txt file and save it into the central directory with a computer identifier in the file name.