Job configuration upload type FTP (FTP jobs)

Jobs with the FTP upload type provide access to an FTP server.

  1. In the Project tree, select the component.

  2. In the menu tab, click on Create or drag & drop the components into the Jobs section.

  3. In the Job configuration section, check whether the upload type FTP is being displayed.

  4. Make sure the desired settings are in place for the following sections: General, Notification, Upload and compare, and Create a version automatically after job run. The Notification and Create a version automatically after job run sections are only displayed if the necessary settings have been implemented.

FTP settings


Image: Job Configuration, section: FTP Settings

  1. In FTP server, enter the IP address of the server that you want to use to create a connection.
  2. Go to Connection type and select the connection type from the drop-down list.
  3. The FTP client library is set to libcurl by default.
  4. In the Port field, select the port that you want to use for communication. Port 21 is automatically preselected.
  5. If you would like to use the FTP passive mode, you will need to activate the necessary checkbox.
  6. If necessary, enter the login data (Username and Password) of the user that will be used. Depending how your FTP server is configured, this step is optional. An upload can also be performed without a username or password.
  7. If the data is stored in a subdirectory of the FTP server, specify the path of the subdirectory in the Subdirectory field.

    With these login details, you should be able to access the subdirectory. versiondog supports up to 10 subdirectories per job.

    When you enter the subdirectory, not only will the entire path to the FTP server in the backup be displayed, but also the most recent directory in the path:

    Example:

    Path to the FTP server: /file1/subdirectory1/*

    Composition of the backup: Archive.zip/*

    If you enter multiple subdirectories, the entire directory structure will be included in the backup.

    Example:

    Path to the FTP server: /file1/subdirectory1/subdirectory2 and /file1/subdirectory1/1234

    Composition of the backup: Archive.zip/Folder1/Subfolder1/Subfolder2 and Archive.zip/Folder1/Subfolder1/1234

  1. You can check whether it is possible to log in to the FTP server with the specified login data by clicking the Check button. If this is not successful, the job will fail.
    If necessary, you may have to enable the port (set in step 3) in your firewall.

The Advanced section

Enable the Upload only when timestamp is different (reduces network load) checkbox if you wish to check the timestamp instead of the content of the files when carrying out an upload. This will ensure that only new and edited files are uploaded for the backup; files without changes will be taken over from the previous backup. This will further limit network traffic.

File specifications and compare settings section

Normally, comparisons are executed using the comparison settings of the component. Job specific modifications can be made in this section.

The table shows the set compare and save behavior.

  1. Activate the Enable custom configuration for this job checkbox.
  2. Click on Edit.
  3. Set new parameters for the comparison and save process in the new open window.

Configuring a timeout

When uploading large amounts of data, a timeout may occur despite the default time being preset at 30 minutes. This timeout can be adjusted globally for all upload types or for each upload type separately. To adjust the maximum time for job execution according to the upload type, proceed as follows:

  1. Start the AdminClient and open the Jobs module.
  2. In the menu, click on Global job settings.
  3. The Upload specific configuration window will then open.
  4. Select the upload type in the navigation bar on the left.
  5. Select the Use specific timeout for this upload type checkbox.
  6. In the Maximum time for job execution field, enter the time period in minutes. The maximum possible value is 540 minutes.

    7. If you do not select the Use specific timeout for this upload type checkbox, the next time you change the global timeout, the value set here will be overwritten by the global one.

Alternatively, you can adjust the timeout via the INI file Classes.ini . (Go to the path in the server or agent archive:..\VD$A\Configuration\Upload\Classes.ini).

The value entered in the Upload type specific configuration window will then be copied into the INI file.

FAQ: When I create a backup using a backup job via the upload class FTP, an error arises. What do I need to change to fix this error?

There are two solutions to solve the problem mentioned above:

  1. Activate passive mode

    Start the AdminClient

    1. Start the AdminClient.
    2. Enter your username and password.
    3. Go to the Jobs module.

    Job configuration

    1. Open the Start tab.
    2. In the Project tree, select the component, whose FTP jobs ended in errors.
    3. Select the upload type FTP.
    4. In the Jobs table, select the job in which errors occurred during execution.
    5. Under FTP settings, enable the Use FTP passive mode option.
    6. Save the changes.

    Executing job (for testing purposes) manually

    1. Click on Execute selected jobs once in Execute.
    2. Wait until the job has been executed.
    3. Specify how you wish the job to be executed: According to schedule or Not activated.

    If errors continue to reappear when you activate the passive mode, we request that you deactivate this and continue with section b).

  2. Include VDogUpload.exe in firewall exemptions

    The VDogUpload.exe file is (also) executed using FTP during the upload. If the data transfer (which took place due to the execution of the above file) is prevented by the firewall, timeout errors will occur.

    The VDogUpload.exe file needs to be added to the firewall's exception list to prevent this error from reoccurring.

    Not all customers employ the same firewall. It is therefore not possible for us to provide any information on this topic.

    Please refer to your own product's documentation for more information. The internet is another source of information. Enter the following searches in your search engine:

    • <product name/name of fire wall> exception
    • <product name/name of fire wall> configure exception
    • <product name/name of fire wall> allow exception
    • <product name/ name of fire wall> insert exception

To FAQ list

Related topics

INI files

Job configuration