Skip to main content

Download Director - Frequently Asked Questions


What is Download Director?
Why should I use Download Director?
Why should I use Download Director for Common Criteria evaluated software downloads?
How do I start a download using Download Director?
What are the Download Director controls?
What does the Details window display?
How do I unpack files?
Does Download Director install on my computer?

Requirements
What are the browser and Java level requirements?

Troubleshooting
Why doesn't the Download Director window pop up?
Why doesn't Download Director load?
Why doesn't the Java Security Window pop up?
Why do I get an error "Can't save Properties File C:\DownloadDirector\dlmgr.pro"?
Why does the Download Director applet tell me that some files are "Already downloaded", yet those files don't appear in my download directory?


What is Download Director?

Download Director is a Java applet that provides enhanced download capability to IBM customers who download our products from the internet. It provides high-performance, reliable downloads with pause and resume capability. It starts in a separate browser window and provides a graphical user interface (GUI) to specify the download location, and view download status.

Download Director meets the standards set for Common Criteria evaluated software downloads.

We understand that some browsers no longer support Java applets. We are looking at alternatives such as a standalone Java application. In the meantime, use a browser that supports Java applets, or go back to the download web page that Download Director was launched from, and use the HTTP download option instead of Download Director.


Back to top



Why should I use Download Director?

Download Director provides advanced features not available with other download tools. Some key features include:

  • Resumable downloads from any type of interruption or lost connection
    When your internet connection is lost or your browser crashes, Download Director can save you download time by restarting the connection from the point of interruption with no loss of data. It automatically retries downloads when the connection is lost. It also lets you pause or resume the download at any time.
  • Guaranteed file delivery
    Download Director uses a secure hashing algorithm to check that files are transferred correctly. You will receive an error notification if the download was not completed successfully. This feature meets the requirements to support Common Criteria evaluated software downloads.
  • High speed transfer
    Multiple connections enhance transfer speeds for customers connected via high speed connections such as DSL, cable modem, T1 etc.
  • File access through a firewall
    Download Director allows you to access files through a firewall by using the proxy settings that you provide.
  • Large file downloads
    Download Director is able to download large files with increased reliability over FTP and HTTP. This eliminates the need to download files that are broken into multiple parts and must be reassembled by the user.
  • Small applet size
    The small size of Download Director applet (< 200KB) assures a reasonable startup time.
  • Multi-platform and multi-browser support
    Download Director is tested using multiple operating systems with Java enabled browsers such as Firefox, Microsoft Internet Explorer, and Safari.
  • Single user interface for multiple files
    Download Director supports a download queue so that multiple files can be downloaded through a single user interface.
  • Display download details
    Download Director shows you details of the current download list and previously downloaded files.
  • Unpack downloaded files
    Download Director supports unpacking of packed files for these file types: (.zip) (.tar) (.gz) (.tar.gz).

Back to top



Why should I use Download Director for Common Criteria evaluated Software downloads?

Download Director meets the download requirements established for Common Criteria evaluated software. This includes the ability for you to view the status of the download in the popup window and receive a notification if for any reason the download was not completely successful.


Back to top



How do I start a download using Download Director?

Files that are set up to use Download Director are noted on the download page.You can click the download button (or link) to start the download. Upon first use, two windows will be displayed to you:

  • Download Director Applet Window
  • Java Security Window

Follow these steps to start a download:

  1. Grant the applet privileges from the Java Security Window
    When the applet runs in the browser, you are prompted to grant additional privileges. If denied, the applet will not run. These privileges are required for Download Director to connect to a remote server, read and write local files, and set Java properties.

    To grant the applet privileges, you can click to run the Download Director applet when the Java Security window appears. If you don't want this window to be displayed each time Download Director is launched, you can choose the option to remember the decision of granting the applet privileges.

    Note:   If you are using Microsoft Internet Explorer, the applet window will be blank if Internet security is set to high. It must be set to the default value of medium or lower for the applet to display properly. To set this, select these menu options: Tools -> Internet Options-> Security, and change the security level to medium.

  2. Select a download directory
    To specify a download location:
    1. Enter the drive and directory name into the Initial Setup window or use the Browse button to navigate to the desired drive and directory.
    2. Click the check box if you want to be prompted for a download location for each file. If you don't check the check box, all files will be downloaded to the default target directory . If you need to change the target directory afterwards, you can change it from the Setup window after clicking the Setup button.
    3. Click OK to create the new directory and begin the download.

    Notes:

    • Make sure that enough disk space is available for the download. If there is not enough free space on the specified drive, Download Director will eventually display an error message stating that the file cannot be written due to insufficient disk space.
    • If you pause the download and change the location of the download in the Setup window, the changes will take effect on the next download.
    • The first time you run setup, a profile (dlmgr.pro) is created in the download directory.

  3. Set proxy server (optional)
    The first time you use Download Director, you are asked if you would like to configure the proxy settings. If you choose yes, a Setup window is displayed. If you choose no, Download Director attempts to download the files without a proxy setting.

    To set the proxy server:

    1. Click the Setup button from the applet window to show the Setup window.
    2. In the Setup window, choose the type of connection, enter the server name, and the port number.
    3. Click the Test button to check user's server connection. An information window is displayed to indicate if the connection was successful. If the connection is refused, re-enter the correct settings and click OK.

    Note:   If you don't know how to configure the settings, contact the proxy server administrator. You will be able to download files after entering the correct setting information.


Back to top



What are the Download Director controls?

After a download starts, you can pause or resume a download, reconfigure the settings or cancel a download. There are four buttons at the bottom of the applet window:

  • Pause/Resume:  Pause or resume a download at any time.
  • Setup:  Display a Setup window  to allow you to configure the settings.
  • Details:  Display a Details window to show information about the files and file groups in the current download list and the history download list.
  • Cancel:  Cancel the current download.
  • ?:  Display an information window with the features of Download Director.

Back to top



What does the Details window display?

When you click the Details button, a Details window is displayed to show you information about the current downloads or previous downloads.

  • There are two choices on the Details window, the current download list and the download history list.
  • The current list includes files that are currently downloading.
  • The download history list includes files that have been successfully downloaded through Download Director before.
  • There is an option to display the full path for the list of files.
  • You can double-click a file item on the list to see more details. If a file item is selected, a window is displayed that shows the details of that file. If a file group item is selected, a list of files in that file group is displayed. A return button shows the main list again.
  • A ">" is displayed next to the file that's being downloaded in the current list.
  • Click the Close button to close the window.

Back to top



How do I unpack files?

The unpack feature can be configured to run when a download finishes or you can manually select files to unpack. Only files of these types (.zip) (.tar) (.gz) (.tar.gz) can be unpacked.

To unpack files when a download finishes:

  1. Click the Setup button from the applet window to show the Setup window.
  2. In the Setup window, click the Set unpack options button to show the Unpack options window.
  3. Specify the unpack location.
  4. Specify either Ask before unpacking or Always unpack
  5. Check Delete after unpacking if you want the original file deleted after it is successfully unpacked.
  6. Click OK for both setup windows.
  7. Unpack is now enabled for your next download.

To unpack files manually:

  1. Click the Details button from the applet window to show the Details window.
  2. In the Details window, choose either Current download or Download history
  3. Select a file to unpack and click the Details button. If the file can be unpacked, the Unpack button is displayed.
  4. Click the Unpack button to show the Unpack window.
  5. Select the unpack options, then click OK to unpack.

Back to top



Does Download Director install on my computer?

Download Director performs no program install to run on your computer. The applet is downloaded by the Java Plug-in and stored in the Plug-in's cache. Two files are created that store the Download Director settings.

  • <java.home>/dlmgr_.pro
    Example: C:\Users\Marc\dlmgr_.pro
    Example: C:\Documents and Settings\Marc\dlmgr_.pro
  • <DownloadDirector>/dlmgr_.pro
    Example: C:\Users\Marc\DownloadDirector\dlmgr.pro
    Example: C:\Documents and Settings\Marc\DownloadDirector\dlmgr.pro

Back to top



What are the browser and Java level requirements?

Your browser must support Java applets. Download Director is tested using multiple operating systems with Java enabled browsers such as Firefox, Microsoft Internet Explorer, and Safari. Download Director requires a minimum of Java 1.7.

Follow your company procedures to install the latest version of Java, or if your company allows, install Java from http://java.com.

Follow your browser's instructions to enable Java for your browser. Use the browser's help or web site for more details.

Some browsers, such as Google Chrome and Microsoft Edge, do not support Java applets. Use a browser that supports Java applets, or go back to the download web page that launched Download Director, and select the option to use HTTP downloads instead of Download Director.


Back to top



Why doesn't the Download Director window pop up?

First, Javascript must be enabled to use Download Director.

Second, if you are using a popup blocker, the Download Director window may not appear when you click the download button. Set your browser's popup blocker to a "medium" level. If it still fails to appear, the popup blocker may need to be disabled.


Back to top



Why doesn't Download Director load?

Java must be installed and enabled in your browser.

Due to network errors, Download Director sometimes doesn't load. Try closing and restarting your browser, then start Download Director again.

If you are using the Java Plug-in and are using a proxy or socks server for your browser, you must also use a proxy or socks server for the Java Plug-in.

  • Go to the Windows Control Panel and double-click the Java Plug-in icon to open Java control panel.
  • Go to the Proxies page (or on the General page-> Network Settings).
  • Specify your proxy or socks server and press Enter after filling in each field.
  • Click on OK or Apply.
  • Restart your browser.

Back to top



Why doesn't the Java Security Window pop up?

Typically the Java security window will pop up when Download Director loads. It asks you to grant permission to run the applet. There are two reasons that this window may not pop up.

  • You previously granted permission and indicated that permission is always granted. This is a normal behavior for the Java plug-in.
  • For AIX, you may need to install APAR IY66819

Back to top



Why do I get an error "Can't save Properties File C:\DownloadDirector\dlmgr.pro"?

This message means that the profile cannot be saved due to insufficient privileges (or an invalid directory). Some users have "Standard User" privileges which do not allow the creation of new directories and files in the default Download Director location. To get past this problem do one of the following:

  • Specify a download location under your user folder (examples: C:\Users\USERNAME, /Users/USERNAME, /home/USERNAME)
  • Create and use a directory with access for either your user id or for "all users"

Back to top



Why does the Download Director applet tell me that some files are "Already downloaded", yet those files don't appear in my download directory?

Download Director has detected that those files exist in a different directory, which was its target directory for a previous download. When that happens, Download Director will not download the files again.

This might cause problems during the installation of the downloaded software. Options:

  • If you no longer need the previously downloaded file you can safely delete it from the original target directory. This will cause it to get downloaded again.
  • Copy the "Already downloaded" files to the new target directory before or after the DD applet executes.

Back to top