Job configuration for upload type UNC (UNC jobs)

Jobs with the upload type Network (UNC) perform data uploads from shared network resources using the UNC (Uniform Naming Convention) protocol.

  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. Check in the section Job configuration, if the upload type Network (UNC) is being displayed.

  4. Make sure the desired settings are in place 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. For more information on configuring the general sections, please refer to Configuring general job settings.

Section Network (UNC) settings

  1. In the Username and Password fields, enter the user credentials for the person that will be used to access the network resources. The user will need to have the necessary access rights.
  2. Under Resources, enter the computer name or IP address of the computer you want to access over the network. You can check if the user can access the computer or the entered combination of computer and subfolder by clicking the Check button. If the check is not successful, the job will also fail.
  3. If these details are already saved in the FTP server's subdirectory, enter the subdirectory's path in the field Subdirectory.
  4. With these login details, you should be able to access the subdirectory.

    versiondog supports up to 10 sub-directories per job.

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

    Example:

    Path on the server: /folder1/subdirectory1/*

    Composition of backup: Archive.zip/*

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

    Example:

    Path on the server: /Directory1/subdirectory1/subdirectory2 and /directory1/subdirectory1/1234

    Composition of backup: Archive.zip/directory1/subdirectory1/subdirectory2 and archive.zip/directory1/subdirectory1/1234

Section Additional

  1. You can reduce the network traffic, that caused by the job, by increasing the sleep between packets and reducing the maximum size of data packets.
    Higher values for the sleep and lower values for the maximum packet size will result in longer times for job execution.
  2. Activate the Upload only when timestamp is different (reduces network load) checkbox. The time stamp instead of the content of the files will be checked. 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.
  3. The checkbox Make offline project available to scripting interface enables upload scripts, that were started by the job, to access the latest checked in version.

Section file specifications and compare settings

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

The table shows set compare and save behavior.

Activate the Enable custom configuration for this job checkbox and click on Edit. 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 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 Job settings.
  3. The window Upload specific configuration will then open.
  4. Select the upload type in the navigation bar on the left.
  5. Select the checkbox Use specific timeout for this upload type.
  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 checkbox Use specific timeout for this upload type, 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 (..\<vdArchive>\VD$A\Configuration\Upload\Classes.ini). For more information, see the INI files section, located in the AdminClient tutorial.

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

FAQ: UNC Job: how can I correct the error message “Error connecting to target system” [ID384]"?

When setting up a UNC job, errors can arise under the following circumstances:

  • Upload source: PC with operating system WinXP SP3 or older
  • Resource:..\\OlderXP-PC\Docfile
  • Upload target: versiondog Agent/Server with Windows 10 Version 1709 or Windows Server 2016 and newer

The cause for this is that the operating system WINXP SP3 uses the SMBv1 protocol. The SMBv2 protocol was introduced in Windows Vista and Windows Server 2008. The SMBv3 protocol was introduced in Windows 8 and Windows Server 2012. When you reinstall windows, the SMBv1 protocol will be deactivated as standard for security reasons. Vulnerabilities in SMBv1 allow attacks via the network and the execution of malicious code on machines that can be reached via the network.

Microsoft has discontinued support for SMBv1. For more information, please refer to the microsoft website.

Potential solutions:

  • Updating the source computers operating system to Windows 7 or newer.
  • If this should not be doable for technical reason, you have the option to activate the SMBv1 Protocol on the versiondog server / agent. This will ensure that the old and insecure SMBv1 protocol will once again be supported and will be able to carry an upload.

Proceed as follows:

1. Open Windows features and functions:

2. Activate SMB1 protocol:

3. Download the necessary files from the internet:

4. Restart is required.

For the UNC Upload, it is recommended that you create a user on the source PC that is the only one who has reader rights to the source folder. This user should not have any further rights on this computer and certainly no administrative rights under any circumstances.

To FAQ list