Job configuration for

Local, UNC, FTP and SSH

upload types
© AUVESY GmbH

Last updated: 20 June 2018

Fichtenstrasse 38 B
D-76829 Landau
Germany
TOC

Job configuration for Local, UNC, FTP and SSH upload types 3

Configuring the type-specific settings of a Local job 4

Configuring the type-specific settings of an UNC job 5

Configuring the type-specific settings of a FTP job 7

Configuring the type-specific settings of a SSH job 10

2
Job configuration for Local, UNC, FTP and SSH upload types

versiondog allows you to create jobs for upload and compare of the data of a wide range of different
devices. Besides these device-specific upload types, there are also the following general upload types:

l Local directory:
Configuring the type-specific settings of a Local job

l Network (UNC):
Configuring the type-specific settings of a UNC job

l FTP:
Configuring the type-specific settings of an FTP job

l SSH:
Configuring the type-specific settings of an SSH job

3
Configuring the type-specific settings of a Local job

Local jobs are used for files that are present on the versiondog server (or on a computer on which an
agent is installed, if an agent is being used).

For information on how to configure the sections General, Upload and compare in Job configuration,
see AdminClient Basics > 5. Jobs

Configure the Local directory settings section

1. Enter the path to the data that you want to back up.

The files are accessed via the master service or agent service. The service in question

requires the necessary access right.

Configure the "Advanced" section

1. You can reduce the network load of the job by increasing the Sleep interval between data
packets and decreasing their Maximum size if needed.

A longer sleep interval and a lower maximum packet size means that the job will take longer

to execute.

2. Activate the check box Use timestamp check to reduce network traffic to check the
timestamp of files during upload instead of their content. This means that only new and mod-
ified files are uploaded for a backup; files without changes are copied from the last backup. This
reduces the network load.

Configure the File specifications and compare settings section

Normally comparisons are executed using the compare settings of the component. In this section you
can make job specific modifications.

The table shows the compare and save behaviour that is set. To modify these options, check the box
Enable custom configuration for this job and click on Edit. Use the window that opens afterwards to
set new parameters for the compare process and the save process.

4
Configuring the type-specific settings of an UNC job

Jobs with the upload type Network (UNC) upload files from shared network resources via the UNC (Uni-
form Naming Convention) protocol.

For information on how to configure the sections General, Upload and compare in Job configuration,
see AdminClient Basics > 5. Jobs

Configure the Network (UNC) settings section

1. Enter the log in information (Username and Password) of the user who will access the network
resource. This user needs to have the necessary access rights.

2. In Resource, enter the IP-address or computer name of the computer that you want to access
over the network. You can check if the computer or the combination of computer and sub-dir-
ectory is accessible to the user by clicking on Check. If the check action is not successful, the job
will not work either.

Configure the Advanced section

1. You can reduce the network load of the job by increasing the Sleep interval between data
packets and decreasing their Maximum size if needed.

A longer sleep interval and a lower maximum packet size means that the job will take longer

to execute.

2. Activate the check box Use timestamp check to reduce network traffic to check the
timestamp of files during upload instead of their content. This means that only new and mod-
ified files are uploaded for a backup; files without changes are copied from the last backup. This
reduces the network load.

3. Activate the check box Make offline project available to scripting interface to allow an upload
script triggered by the job to access the newest version.

Configure the File specifications and compare settings section

Normally comparisons are executed using the compare settings of the component. In this section you
can make job specific modifications.

5
The table shows the compare and save behaviour that is set. To modify these options, check the box
Enable custom configuration for this job and click on Edit. Use the window that opens afterwards to
set new parameters for the compare process and the save process.

6
Configuring the type-specific settings of a FTP job

Jobs with the upload type FTP upload files from an FTP server.

For information on how to configure the sections General, Upload and compare in Job configuration,
see AdminClient Basics > 5. Jobs

Configure the FTP Settings section

1. Enter the IP address of the FTP server you want to connect to

2. Choose the Connection type used for the communication from the drop-down menu

3. Set the Port used for the communication

The default port is 21

4. If needed, check the box Use FTP passive mode

5. Enter the log in information (username and password) of the user who will access the FTP
server. This user needs to have the necessary access rights

6. If the data is stored in a subdirectory of the FTP server, specify the path to the sub-directory.
The user with the entered log in information needs to be able to access this subdirectory

7. You can check if the user can access the FTP server by clicking on Check. If the check action is
not successful, the job will not work either

You may have to open the port set in step 3 in your firewall

Configure the Advanced section

Activate the check box Use timestamp check to reduce network traffic to check the timestamp of
files during upload instead of their content. This means that only new and modified files are uploaded
for a backup; files without changes are copied from the last backup. This reduces the network load.

Configure the File specifications and compare settings section

Normally comparisons are executed using the compare settings of the component. In this section you
can make job specific modifications.

7
The table shows the compare and save behaviour that is set. To modify these options, check the box
Enable custom configuration for this job and click on Edit. Use the window that opens afterwards to
set new parameters for the compare process and the save process.

FAQ: When creating a backup with a backup job of upload class “FTP” an error occurs. What do I
have to change to eliminate the error?

Two possibilities can be considered to solve this problem:

a) Switch on "Passive mode"

1. Start AdminClient

2. Open module "Jobs"

3. Select tab "Home"

4. In the project tree select the component of the FTP job which terminated with errors

Configure the job

5. Select upload type FTP (dropdown menu "Uploadtype")

6. Select the job in the Jobs list, in which errors occurred when it was executed

7. Go to "FTP settings"

8. Set option "Use FTP passive mode"

9. Save changes

Run job manually (for testing purposes)

10. Go to Execute in the toolbar and click on the button "Execute selected jobs once"

11. Wait until execution of job completed

12. Reset type of execution to "Automatic" or "Not active" if necessary

If enabling "Passive mode" has no effect and errors still occur, disable "Passive mode" and pro-

ceed with b.

8
b) Add VDogUpload.exe to firewall exceptions

File "VDogUpload.exe" is (also) executed when uploading via FTP. If the transfer of data which is a
result of the above file being executed is blocked by the firewall, timeout errors are likely to occur.

To make sure that these errors do not occur in the future, file/program "VDogUpload.exe" has to be
added to the firewall exceptions.

Since it can be assumed that not all customers use the same firewall (software) at this point no
information can be given regarding a correct procedure.

For information regarding a correct procedure you should consult the documentation of the
product you use. The internet is another source of information. Please enter one of the following
search strings into the text box of the search engine you use:

l <Product name/name of firewall> exception

l <Product name/name of firewall> add exception

l <Product name/name of firewall> allow exception

l <Product name/name of firewall> configure exception

9
Configuring the type-specific settings of a SSH job

Jobs with the upload type SSH upload files from an SSH server.

For information on how to configure the sections General, Upload and compare in Job configuration,
see AdminClient Basics > 5. Jobs

Configure the SSH Settings section

1. Enter the IP address of the SSH server, you want to connect to

2. Set the Port used for the communication

The default port is 22

3. Enter the log in information (username and password) of the user who will access the SSH
server. This user needs to have the necessary access rights

4. If the data is stored in a subdirectory of the SSH server, specify the path to the sub-directory.
The user with the entered log in information needs to be able to access this subdirectory

5. You can check if the user can access the FTP server by clicking on Check. If the check action is
not successful, the job will not work either

You may have to open the port set in step 2 in your firewall

Configure the Advanced section of a SSH job:

Activate the check box Use timestamp check to reduce network traffic to check the timestamp of
files during upload instead of their content. This means that only new and modified files are uploaded
for a backup; files without changes are copied from the last backup. This reduces the network load.

Configure the File specifications and compare settings section of a SSH job:
Normally comparisons are executed using the compare settings of the component. In this section you
can make job specific modifications.

The table shows the compare and save behaviour that is set. To modify these options, check the box
Enable custom configuration for this job and click on Edit. Use the window that opens afterwards to
set new parameters for the compare process and the save process.

10
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit.
(http://www.openssl.org/)

11