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-and-drop the components into the Jobs section.
  3. In the Job configuration section, check whether the upload type FTP is being displayed.

  4. Configure the settings for the following sections: General, Notification, Upload and compare, 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 dropdown list.
  3. The FTP client library is set to WodFtp by default.
    As FTP is an old protocol, there is a possibility that not all possible FTP servers can be covered by the default library WodFtp. There are however many different possibilities. If your variant is not listed in octoplant, contact our support team for more information.
  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. Check the checkbox Follow symlinks to back up files in directories that can be reached via symlinks (symbolic links).

  7. 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.
  8. 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. octoplantsupports 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 the check is not successful, the job will also fail.
    If necessary, you may have to enable the port (set in step 4) in your firewall.

Advanced section

Enter Sleep interval between data packets (in ms) and the Maximum size of data packets (in KB) to throttle the bandwidth to the device. This helps to prevent the device or network from becoming overloaded.

Enable the Upload only when timestamp is different (reduces network load) checkbox if you wish to verify 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 behaviour.

  1. Check 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 dialog.

When I create a backup using a backup job with the upload class FTP, an error arises. How can this be resolved?

 

There are two solutions to solve the problem mentioned above:

  1. Activate passive mode

    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.

    Refer to your own product's documentation for more information. Enter the following searches in your search engine:

    • <product name, name of firewall> exception
    • <product name, name of firewall> configure exception
    • <product name, name of firewall> allow exception
    • <product name, name of firewall> insert exception

To FAQ list

 

Related topics

INI files

Job configuration