Online help:
SAP Download Manager
Contents
Introduction
The SAP Download Manager is a program file you should install if you want to download multiple files at once, or if you want to schedule downloads to run at a later point in time. It lists software files ("objects") that you added to your Download Basket in the SAP for Me portal.
The current version of the SAP Download Manager is 3.1.2 from July 2019.
Installing the SAP Download Manager
Requirements
To run the SAP Download Manager, at least Java version 1.8 must be installed on your local computer.
Note: If after the SAP Download Manager's installation the software download is not working because of SSL handshake-related issues, change the default client-side TLS protocol version in the JDK from the 1.0 legacy version to a more recent version like TLS 1.2. Also refer to the Troubleshooting section.
Download and initial configuration
- Download the SAP Download Manager from the SAP Software Download Center in SAP for Me.
- Unzip the file and copy the file DLManager.jar to any folder on your local computer.
- Change to the directory the DLManager.jar file was copied to in step 2:
- Windows: Use the File Explorer
- Mac OS: Use the Finder
- Other operating systems: Open a shell ("command prompt") and type cd <the_directory_name>.
- DLManager.jar is a runnable jar file. Double-click on DLManager.jar to start the application. In case this option is not available:
- Open a shell and change (cd) to the SAP Download Manager directory.
- Type java -classpath DLManager.jar dlmanager.Application to start the application.
- The Overview screen of the Configuration Assistant is displayed.
The Configuration Assistant guides you through the process of providing all required parameters for the SAP Download Manager to connect to the Download Basket. If the Overview screen does not appear, ensure that your Java environment is correctly installed and configured. For more information, see the installation requirements.
- Click Next to enter the Connection Information screen.
-
Set the SAP Support Portal Address field to https://tech.support.sap.com.
-
Enter your S-user ID — logon using e-mail address or SAP Universal ID (UID) is not supported — or, if you are an SAP employee, your internal ID and the password that you use to enter the SAP for Me portal in the appropriate fields. If you forgot your password, you can reset it as outlined in SAP Knowledge Base Article (KBA) 3085908.
Note: For security reasons, the SAP Download Manager does not store your password in the tool's settings. So, whenever you use the SAP Download Manager, you must enter your password manually.
- If you connect to the Internet through a proxy server, tick the check box Use a proxy server to connect to the Internet and fill in the required proxy server information. If your proxy server requires you to provide a user name and password, fill in the appropriate fields.
Note: SAP is unable to provide you information about your local Internet access policy. Contact your network administration team for more information about accessing the Internet from your workplace.
- Click Next to enter the Download Store screen.
It allows you to select a directory in your file system to store files that you download with the SAP Download Manager.
Note: You must have write access to this directory.
- Click the "Up one level" icon to move up in your computer's directory structure. Alternatively, select a higher directory from the Directory drop-down.
- Click the "Home" icon to return to the default directory.
- Click the "Create directory" icon to create a new directory in the current one.
- Enter the directory that you want to use to store software files in by double-clicking its name.
- Make sure that the correct directory name is shown.
- Click Finish to enter the SAP Download Manager's main application window.
Working with the SAP Download Manager
The main application window
Once the SAP Download Manager has been successfully installed and configured, the content of your Download Basket is retrieved from SAP for Me and displayed in the main application window.
This window is divided into three areas:
- The menu and toolbar provide access to frequently used functions.
- The basket content area displays all objects currently stored in your Download Basket. For each object, the object's description, the total size of all data associated with the object, the date and time you placed the object into your Download Basket as well as the current download status is displayed:
- Download not started
- Download is in progress
- Partially downloaded
- This object was completely downloaded
An icon indicates whether the object is an archive (such as a ZIP file) or a different file format.
- The status area displays the status of the SAP Download Manager and the server it is connected to. During downloads, this area is automatically enlarged to provide information about the overall progress of the download as well as the progress of the current download object.
The toolbar offers the following features:
- Click the "Download all objects" button to download all objects in your Download Basket. Alternatively, select Object > Download all objects from the menu.
While downloading software, this button can also be used to refresh your list of downloads.
- If you want to download only selected objects, highlight these in the basket content area. Then click the "Download selected objects" button (or select Object > Download selected objects from the menu).
You can select multiple items by holding down the CTRL key (Mac OS: "command" key ⌘) while highlighting items in the basket content area.
- Click the "Select all" button to select all objects in the Download Basket, "Deselect all" to deselect all selected objects.
- Use the "Pause download" button to interrupt the current download and continue at a later stage. In the basket content area, the download status of partially or fully downloaded objects will change to Partially downloaded.
- To display the download protocol for a partially downloaded object, select the object in the basket content area and click the "Object protocol" button (or select Object > Object protocol ... from the menu).
This protocol can be helpful in determining why a download terminated unexpectedly.
- The SAP Download Manager can be configured to schedule downloads from your Download Basket (for example downloading items overnight):
- Click the "Schedule download" button (or Object > Schedule download ... in the menu).
- Set the desired download start time and date in the Scheduled Download Configuration window.
- Start the scheduler by clicking the "Start scheduled download" button (or selecting Object > Start scheduled download from the menu).
The SAP Download Manager will automatically download all items stored in your Download Basket at the configured download start time.
- Click the "Refresh" button to refresh the list of objects in the basket content area.
- If a new version of the SAP Download Manager becomes available, the "Auto-update" button will become active and allow you to download and install the new version of the tool.
The SAP Download Manager's menu bar offers the same functionality as the toolbar, but also less commonly used features:
- To remove an object from the Download Basket, highlight the object in the basket content area and select Object > Remove from Download Basket from the menu.
If applicable, this will also delete any partially downloaded object data from the Download Store.
Objects can be also removed from the basket directly in the Download Basket application.
- To delete any partially downloaded object data, highlight the object in the basket content area and select Object > Delete partially downloaded object data from the menu.
- To review a history of recently downloaded objects, click View > Local download history.
- To analyze system information, select Help > About SAP Download Manager, then click the System information tab.
- Under the same tab you can select a different layout ("scheme") for the SAP Download Manager.
- Again, under the System information tab, click the "Force GC" button to make the memory currently occupied by unused Java objects available for quick reuse.
Changes to the configuration
You can always make changes to the initial configuration at a later stage by selecting View, then SAP Download Manager configuration ... from the menu. The SAP Download Manager Configuration window is displayed.
Troubleshooting
- Forgot your password for the SAP Download Manager (which also is your password for SAP for Me)? Follow the instructions in KBA 3085908.
-
If you encounter an error message like
Request failed. Exception: Received fatal alert: handshake_failure; Class: class javax.net.ssl.SSLHandshakeException
this is related to TLS (Transport Layer Security), a protocol that encrypts communication between client and server. For security reasons, the legacy versions TLS 1.0 and 1.1 are no longer supported. Please contact your IT department to determine how to enable the JRE default TLS 1.2 libraries/versions. The following link may help configure your local JRE: www.java.com/en/configure_crypto.html.
- If you encounter other problems with the SAP Download Manager, check out the following SAP Notes and Knowledge Base Articles:
If these do not resolve the issue, report an incident on component XX-SER-SAPSMP-SDM.