Database Download Manager Guide

5.9.0
- 6.7.0
- 6.6.0
- 6.5.0
- 6.4.0
- 6.3.0
- 6.2.0
- 6.1.0
- 6.0.0
- 5.8.1
- 5.8.0
- 5.16.2
- 5.16.1
- 5.16.0
- 5.15.0
- 5.14.0
- 5.13.0
- 5.12.0
- 5.11.0
- 5.10.0

Back Next

Download Options on the Command Line

To download databases on the command line, run the

java

-jar

Downloadtool.jar

command.

You can use the following options with the

Downloadtool.jar

command:

-DownloadType or -dt: Specifies whether to download all the databases that your Informatica Passport user profile is authorized to download or only those databases that are listed in the
download.xml
file. The available options are
all
and
custom
. For example:
java -jar Downloadtool.jar -un:admuser@yourdomain.com
-o:yes
-dt:all
If you set the download type parameter to
all
, the Database Download Manager updates the download file to specify all of the databases that you are authorized to download and downloads all of the databases. If you set the download type parameter to
custom
, the Database Download Manager downloads only the databases that are listed in the
download.xml
file.
-Engine or -eg: Specifies the on-premises AddressDoctor version for which you want to download the databases. For example:
java -jar Downloadtool.jar -un:admuser@yourdomain.com
-o:yes

-dt:all
-eg:5.13.0
If you set the option, the Database Download Manager downloads only those databases that are compatible with the engine version that you specify.
-Help, -h, or -?: Displays command-line help. For example:

java -jar Downloadtool.jar -h
-NoGui or -ng: Downloads database files according to the details that the configuration properties file specifies. When you use the
-NoGui
option, enter a password if the configuration properties file does not include a token value. Otherwise, do not set any option on the command line.

The configuration properties file includes values that you can otherwise set on the command line. For example, the configuration properties file includes a
DownloadType
option that you can use to download all available databases or to download the databases that the
download.xml
file specifies. Before you use the
-NoGui
option, verify the properties in the configuration properties file.

If the download file is not present in the directory to which you installed the Database Download Manager client application, the Download Manager generates the download file with information about all the databases that your user profile is authorized to download and starts to download the databases.

The Download Manager returns an error message and terminates the session in the following instances:

The configuration properties file is not present in the directory to which the Database Download Manager client application is installed.
The configuration properties file is present in the directory but it does not contain a token, and you do not include user credentials on the command line.
-OverWrite or -o: Indicates whether to overwrite any database file in the download directory with a file of the same name. The available options are
yes
and
no
. The default is
no
. For example:
java -jar Downloadtool.jar -un:admuser@yourdomain.com -o:yes
If you set the overwrite parameter to
yes
, the Database Download Manager overwrites any file with the same name.
-PassWord or -pd: Specifies the password for your Informatica Passport user name. For example:
java -jar Downloadtool.jar -un:admuser@yourdomain.com -pd:Pwd#1234
Enter a user name and a password if the
config.properties
file does not contain a token.; To protect the integrity of your password, you can omit the password parameter from the command and enter the password at the password prompt. The password that you enter for the
-PassWord
parameter appears on the screen as plaintext, whereas the password you enter at the password prompt is hidden.
-ReleaseDate or -rd: Filters the available reference database files by age.

You can use one of the following values:

all. Download databases regardless of age.
current. Download the current version of the databases.
last2. Download any database that Informatica updated in the last two months.
last3. Download any database that Informatica updated in the last three months.
-Remember or -rm: Specifies whether to save the current command-line options to the
config.properties
file. The available options are
yes
and
no
. Default is
yes
. For example:
java -jar Downloadtool.jar -un:admuser@yourdomain.com
-s:yes

-dt:all
-rm:yes
If you set the
-Remember
parameter to
no
, the options that you specify for the current download are discarded when you end the current session.
-Smart or -s: Specifies whether to enable smart download. The available options are
yes
and
no
. Default is
yes
. For example:
java -jar Downloadtool.jar -un:admuser@yourdomain.com
-s:yes

-dt:all
When smart download is set to
yes
, the Database Download Manager checks the
downloadhistory.xml
file to identify the files that you last downloaded and only downloads any newer or absent version of each file. When smart download is set to
no
, the Database Download Manager downloads all the database files that the FileType and Country properties define.
-Token or -tk: Specifies a token that you can use in place of a user name and password when you run the command. When you log in with a username and password, Database Download Manager saves the token to the
config.properties
file. The token is valid for one year.

To create a token, enter the following command:

java -jar Downloadtool.jar un:admuser@yourdomain.com -pd:****

The following sample code shows a token in the system response to the command:

#Tue Nov 21 17:27:09 CET 2017 DownloadDirectory=C\:Downloadtool\Downloads ReleaseDate=all token=adb871e4fe734a53a9f35364res45z4
DownloadType=ALL OverWrite=no UserName=admuser@yourdomain.com EngineVersion=5.12.0 Smart=yes FileType=ALL Country=ALL;

The system response replicates the parameters in the
config.proerties
file.

You can use the token in subsequent logins. For example:

java -jar Downloadtool.jar -tk:adb871e4fe734a53a9f35364res45z4
-UserName or -un: Specifies the Informatica Passport user name. For example, enter the following command:
java -jar Downloadtool.jar -un:admuser@yourdomain.com
Enter a user name and an Informatica Passport password if the
config.properties
file does not contain a token. If you do not enter a password, the Database Download Manager prompts you to enter a valid password for the user name.

The Database Download Manager applies an AND relationship to the command line options and downloads the files that meet all of the criteria that you specify. For example, if you run a command that sets

-OverWrite

and

-DownloadType

all

, the Database Download Manager downloads absent files only and does not overwrite any file that it finds in the download directory.

Rename Saved Search

Table of Contents

Database Download Manager Guide

Database Download Manager Guide

Download Options on the Command Line

Download Options on the Command Line