Downloading Files

Parent Previous Next

Downloading Files

This step requires you to create a new Action Schedule. For information on creating an action schedule, click here.

Step 1: Fill in the Schedule Info

First, fill in the above schedule info. Make sure Is Active check box is not checked. We will run this schedule manually. If you are a global admin you will see a Company combo box. If you are a standard user, it will automatically select the company of the user you are logged in as.

Second, fill in the Schedule Date. We want this to run every Monday at 10:00pm. Make sure the Time From check box is checked. Metropolis will ignore any time that isn't checked. Enter 10:00 PM for the Time From.

Third, enter a description (optional) with any notes for this Action Schedule. You don't need to worry about the creation date or the user as this information is automatically logged.

Step 2: Add an FTP Download Action Node

Once that is done, right click in the Action Nodes area and click Add FTP Download. A dialog will pop up. Enter the following information.

Step 3: Create an FTP Site

Click the [FTP Site Maintenance] button to create the FTP Site, and FTP Site Maintenance will appear. FTP Sites can be reused for many Action Nodes, so this only needs to be done for new FTP Sites.

If there is already an FTP site, right click the FTP site list area and click Add New.

Enter US Census in the name. This can be anything and is only for your reference.

For the Host, enter This is an actual FTP site, so make sure you enter it correctly.

You can leave the port blank. When the port is left blank, it uses the standard port for the FTP mode you've chosen.

Enter anonymous for the user name and your email (or anything really) for the password. This particular site allows anonymous users to download files.

Select FTP for the FTP mode, and check Use Passive. This site uses the standard FTP protocol in passive mode.

Click the [Test] button and you should get the following results:

This is a successful test for our purposes. Since we are just downloading, the only thing we need is Read access. The Message is the server response of the last failed test. In this case, it would be Delete permissions. Click [OK].

Click [Save] and you will get a confirmation dialog with the new Id. In this example, the FTP Site was saved with the Id of 1. Yours may be different.

Click [Close] to exit the FTP Site Maintenance form and select your new site in the FTP Site drop down. This FTP site will appear in any new FTP Download and FTP Upload action nodes you create for any new Action Schedule.

Step 4: Configure the FTP Download Action Node

Now that we have created the FTP site we will be downloading from, we need to configure what we want to download.

For the Source Path Mask, enter /acs2002/*.*

At the time of this writing, this mask will download approximately 175K in four files:





Check "Overwrite Existing?" this will overwrite any files that already exist in your working folder with the same name with the files you are downloading.

Make sure "Delete Original Files?" is not checked. This will delete the files you just downloaded on the server after the entire mask is downloaded. This requires Delete permissions, which we don't have on this FTP Site.

Make sure "Include Subdirectories?" is not checked. This will download any subdirectories in the source path. This is not recommended as it will download several hundred megabytes of extra data. Any subdirectories downloaded will retain their structure in the workspace.

All files downloaded will be placed in a workspace or temp folder which is cleaned up after an action schedule is fully completed.

Click [OK] to close the action node property form. You will see the new action node in the Action Nodes list.

Step 5: Add an Configure A Disk Saver Action Node

Once the files have been downloaded to our workspace, the next step is to save them to a more permanent location.

Right click the Action Nodes area and select Add Disk Saver.

The Disk Saver action node properties window will appear. Notice the properties are different from the FTP Download action node. Each action node type has it's own set of properties.

Enter C:\Files\Us Census Data\ as the destination directory. If this doesn't exist on your file system, it will be created.

Check "Overwrite Existing?" this will overwrite any files that already exist in the destination directory.

Enter *.* in the file mask. With the Disk Saver action node, you can save a partial workspace, meaning you can only save the files ending in *.txt. If you need to split a download into several directories by a mask, you can add additional Disk Saver action nodes for each mask.

"Flatten Directory Structure?" is useful if you've selected "Include Subdirectories?" in any action nodes. Checking this will save all the files in a single directory, even if there were subdirectories included in your download. In this example, we are only downloading a few files and not including subdirectories, so this wouldn't do anything with our workspace since it is already flat.

Once the form is filled in, you can click [Test Disk Access] and it should return the following result. Click [OK] to close the test results.

When dealing with file system access, the user that was selected as the Metropolis Service account must have the necessary permissions. For more information on the Metropolis service account, see the Metropolis Installer guide here.

Click [OK] to close the action node property form. You will see the new action node in the Action Nodes list.

Click [Save] to save your new action schedule. Note that nothing is saved, including action node properties, until the action schedule is saved. You will get a save confirmation for your new action schedule.

Step 6: Run Your Schedule

If everything is working properly, you should be able to successfully run your new schedule. To manually process your schedule, right click it and click Process Now.

You will get a confirmation dialog. Click [OK].

You will get a second confirmation dialog notifying you that the schedule has successfully been started.

Depending on your bandwidth, this should take a few seconds to complete. If you click on the Server Status tab fast enough, you might be able to see it processing real time.

Step 7: Verify Your Results

Once your schedule is completed, or even during your schedule, you can right click the action schedule and view the process log. You can view the process log from the Server Status tab for processes that are currently running, or the Schedule tab. For more information on the schedule process log, click here.

Created with the Personal Edition of HelpNDoc: Full-featured multi-format Help generator