The release of Sun Download Manager 2.0 (SDM) marks the first full
integration of SDM directly into the Sun Download
Center (SDLC) download page, using Java Web Start technology. As long as you have a recent Java version installed (version 1.4.2_06 or later), you can download, install, and run SDM directly from the SDLC! Just go directly to the download page for the product you want, then follow the instructions for automatic installation. (For best performance, we highly recommend upgrading to the latest version of Java Runtime Environment before using SDM 2.0.)
After automatic installation, full usage instructions are available below, or within
SDM, select "Help --> Online Help." SDM 2.0
also remains available as a "stand-alone"
program that you download, then install. Following are installation and
start-up instructions for the stand-alone version.
Stand-Alone Version
First, download the Sun Download Manager (SDM). Be sure to download the correct version for your platform, then follow the corresponding installation instructions below.
Note: Commands you type are shown in quotes. Do not type the
quotes, just the commands.
If you are installing SDM for the first time, you will be required to accept the software license agreement.
Solaris Operating System, SPARC
- From a terminal window, change to the directory
where you saved the installation file.
- Make the file executable:
"chmod ug+x sdm-2_0-solaris-sparc.sh"
- Run the file:
"sdm-2_0-solaris-sparc.sh"
- Follow the on-screen steps to complete the installation.
- If you chose to install the CDE front panel icon, you must restart the CDE Workspace Manager to see it. You'll also get an icon added to your home directory in the CDE file manager.
- To start SDM, open a terminal window, go to the SDM directory, then run:
"sdm.sh"
Solaris Operating System, x86
- From a terminal window, change to the directory where you saved
the installation file.
- Make the file executable:
"chmod ug+x sdm-2_0-solaris-i586.sh"
- Run the file:
"sdm-2_0-solaris-i586.sh" - Follow
the on-screen steps to complete the installation.
- If you chose to install the CDE front panel icon, you must restart the CDE Workspace Manager to see it. You'll also get an icon added to your home directory in the CDE file manager.
- To start SDM, open a terminal window, go to the SDM directory, then run:
"sdm.sh"
Windows
- Run the file "sdm-2_0-windows-i586.exe"
- Follow the on-screen steps to complete the installation.
- To start SDM:
- Double-click the Sun
Download Manager icon on your desktop, or
- Select Sun Download Manager from Start--> Programs, or
- Execute the file "sdm.jar" in the directory where SDM was installed.
Linux and Sun Java Desktop System
- Go to the directory where you saved the installation file.
- To check for an existing SDM install, run
"rpm -q sdm"
- If you have a previous version of SDM
installed, uninstall it before proceeding:
"rpm -e sdm"
- To install, run:
"rpm -i sdm-2_0-linux-i586.sh"
- Start SDM by choosing Launch -->
Applications
--> Internet --> Sun Download Manager, or run:
"sdm&"
All other Platforms, including Mac OS X and other Java Platforms
- Go to the directory where you saved the
installation file.
- Unzip the file "sdm-2_0.zip". Extract the files to the
directory of your choice.
- You will have to make your own desktop icon if desired. (An
icon is provided with the distribution; the filename is
"sdm.ico".)
- To start SDM, run the file "sdm.sh" (for most Unix variants)
or "sdm.bat" depending on your platform.
Java Web Start Version
In addition to direct installation from the SDLC download page, the Java
Web Start (JaWS) version of SDM 2.0 is also available from the "Get the
Software" page.
- On the "Get the Software" page, click on "Get the Java
Web Start version of SDM!"
- You may be asked to Open or Save the jnlp file that launches SDM. Select "Open".
- If you only see an option to "Save," save the jnlp file to your desktop, then double-click it to continue.
- For your security, SDM is a digitally signed application. If
you see a Security Warning, click "Always" to accept the security
certificate.
- Accept the option to create a desktop icon to easily restart SDM in the future.
- Note: This option is not available on all platforms.
- Read and accept the SDM Software License Agreement.
- Complete the Options screens to set your preferences.
- Important: If you are connected through a proxy server, be
sure to complete the Proxies tab.
To restart the JaWS version in the future, there are several options:
- Use the desktop icon if available.
- Restart using the Java
Control Panel:
- Open the control panel.
- Select "Settings" on the General tab.
- On the next screen, select "View Applications".
- In the list of applications, click "Sun Download Manager 2.0 (web)"
- Click "Launch Online".
- Return to the "Get the
Software" page and click on the "Get the Java Web
Start version of SDM!"
- The JaWS version will also start automatically when you use the
"Download selected with Sun Download Manager" button on any SDLC
download page.
[ Back to Contents ]
Sun Download Manager (SDM) is specially designed to download large files from the Sun Download Center (SDLC), ensuring you get a complete and valid file on your first try! SDM
also works with many other Sun and non-Sun sites, but there is no
assurance it will work on sites other than the SDLC. Following are
the instructions for using SDM with the SDLC.
The first time SDM runs, the Accept Software License and Options screens display automatically. Please set or review all of the following Options:
- Options: Download Tab
- Select Directory
for Downloaded Files
Select the directory where you would like all your downloaded files
saved.
- Type in the full path to the directory in the box provided, or
- Click the Browse button to select your directory.
- Maximum Number of Retries
If SDM detects a problem with your download or your Internet
connection is dropped, it will automatically retry the download
until it succeeds or reaches the retry limit. Use this option to
set the number of times SDM retries the download before canceling. The
maximum is 20.
- Maximum Log File Size
SDM activities are recorded in a log file stored in the same
directory as the SDM program. Use this setting to limit the size of
the log file to the number of KBytes specified. Once the limit is
reached, no new data will be stored, so you may wish to clear the
log file occasionally.
- Overwrite Behavior
This controls what happens when SDM tries to save a file
with the same name as a file already in your downloads directory.
- "Overwrite existing file" erases the old file and saves the new file over it.
- "Rename existing file" keeps the older file and renames it with a "bak" extension (for example, "filename.zip.bak").
- Unzip Behavior
After completing the download of a "zip" file, SDM can unzip it
automatically. The choices are: - "Unzip download
zip archive and save *.zip file" -- automatically unzips the file and saves
a copy of the original zip file.
- "Do not unzip downloaded zip archives" -- turns off the
automatic unzip feature.
- "Unzip downloaded zip archive, then delete *.zip archive" --
automatically unzips the file and then deletes the
original zip archive.
- Remove partially downloaded file on
disk after STOP
If you check this box, any partially downloaded file will be deleted automatically if you click STOP during a download.
- Start Downloading Automatically
If checked, files will
start downloading immediately when you start up SDM with files already in its file list or from the SDLC download page -- no need to click Start. (Note this works only upon start-up of SDM, not if it is already running and new files are added to the file list.)
- Use automatic file verification when available (recommended)
SDM uses a unique file verification system in conjunction with SDLC
that automatically checksums file integrity as it downloads. We highly
recommend enabling this feature to prevent corrupt file downloads. Do not uncheck this box unless you are experiencing difficulties with the automatic file
verification process and wish to try your download without it.
- Options: Proxies Tab
-
- HTTP Settings
If your Internet connection goes through a proxy server, check "Use a
proxy server", and enter the proxy server address and port number.
- FTP Settings
If your Internet connection goes through a proxy server for FTP,
check "Use a proxy server". - If your proxy
server is the same for HTTP and FTP, just check the "Use HTTP Proxy"
box.
- If the proxy is different, enter the FTP proxy server address and port number.
- Do not Use Proxy for Hosts
Enter the addresses of sites you do not want to access via the
proxy. This box can hold a list of sites, separated either by a
space or a comma. You can also use "*" as a wild card in the host
name.
- Options: Authentication Tab
- Use HTTP Proxy Authentication
If you entered an HTTP proxy on the "Proxies" tab that requires
username and password authentication, check the "Use HTTP Proxy
Authentication" box. Next, click "Set HTTP Proxy
Authentication" and enter username/password in
the pop-up box.
- Use FTP Proxy Authentication
If you clicked "Use HTTP Proxy" for FTP on the "Proxies" tab, it will use the authentication specified by "Use HTTP Proxy Authentication". Otherwise, if you entered an FTP proxy on the "Proxies" tab that requires username and password authentication, check the "Use FTP Proxy Authentication" box. Next, click "Set FTP Proxy
Authentication" and enter username/password in the pop-up box.
- Hosts Authentication
Add a list of authenticated hosts, so you don't
need to enter the username/password every time you download from a
specific site that requires authentication. - Add
Host
To add a host, click "Add Host" and complete the requested
information in the pop-up box. The host will be added to the
drop down
list.
- Edit Host
Select the host you wish to edit from the drop down list, then
click on "Edit Host". Note you can only change
the username and password.
- Delete Host
Select the host you wish to delete from the drop down list, then
click "Delete Host".
- Save logins & passwords for authenticated
hosts on
disk
Check this box
if you wish to save your authenticated hosts list. SDM saves the data
for the next time you run it.
If not checked,
you will need to re-enter the authenticated hosts the next time
you start up SDM. Please note it is more secure to not save to
disk.
Hit the "OK" button when all Options are set.
[ Back to Contents ]
You are now ready to take command of your downloads with SDM!
In your web browser, go to the page containing the direct
links to the download file(s). Load the links to download into the file
list area of SDM (the large white area in the middle of the SDM
window). There are several ways to load the file list:
- On the Sun Download Center, just
check the boxes next to the files you want, then click "Download
Selected with Sun Download Manager." For more detailed instructions,
see the full instructions for using the integrated SDM with SDLC. You can also add files using any of the following options.
- Drag and Drop
-
Click and hold down the left mouse button on the desired download
link, then drag the link
to the Sun Download Manager.
- Release the mouse
button when the cursor is in the file list area.
- Copy
and Paste
- Right-click
the direct link to the download file. A pop-up menu appears. Depending
on your browser, select "Copy Shortcut" or "Copy Link
Location".
- Go back to SDM and paste in the link using
any of these options:
- Type
Ctrl-V (press the "Control" key
and the letter "V" at
the same time), or
- Select
"Edit-->Paste" from the SDM Menu bar, or
- Click
"Add File", then paste the link
directly into the box provided.
- Use
the "Paste" key on
Solaris OS keyboards.
- Repeat
this process to add
as many download links as desired.
- Add Files
- To
type in a URL manually, click the "Add" button and enter the URL.
[
Back to Contents
]
- Start: To
begin downloading, click Start. SDM downloads sequentially, from top to bottom, until all files are downloaded successfully. If any
download fails more than the set Number
of Retries, that file's status is set to failed, and SDM moves
on to the next file.
- Pause: Pauses the
download process. Always use "Pause" rather than "Stop" if you want to resume downloading the same file later.
- Resume: Click "Resume" to continue downloading after using "Pause".
- Stop: Caution! Clicking Stop cancels the
download operation. If you have a file partially downloaded and
click "Stop", it may be deleted (depending on how you've set
the "Remove
partially downloaded file on disk after STOP" option). Files
already downloaded successfully are not affected and will not be
deleted.
- Details: Provides a pop-up window containing more details about the download in progress. Click "Hide Details" or the "X" in the corner of the pop-up window to close it.
The following buttons control the file list (or "queue"):
- Add: Provides a pop-up box for entering the URL
of a file to download.
- Remove:
Click the file(s) to be removed, then click "Remove".
(This removes files from the list only; any files downloaded
successfully remain on your computer.)
- Note
that every time SDM
starts, it automatically removes successfully downloaded files from
the list.
- Retry: If you Stop, a download or a download fails
for any reason, it remains in the file list but will not download the
next time you click Start. To download
a file in this state, click the file name,
then click "Retry". SDM will try the download again the next time Start
is clicked.
- Reordering files: Files are downloaded
from top to
bottom in the list. To change the download order, click a file name
to highlight it, then press Control+UpArrow to move the link up in
the queue, or Control+DownArrow to move the link down in the queue.
[ Back to
Contents ] - File
Menu
- Options:
Select this to change any of the Options
that control SDM.
- Log: This brings up the SDM Log which
contains detailed
information about SDM download transactions. This can help
when trying to debug download issues. Remember to clear the
log out from time to time to keep from reaching the Maximum Log File Size.
- Click
the "Clear" button at the bottom of the Log window to
empty the contents.
- Click the "Save" button to save a copy of the log file to
disk.
- Click the "Close" button to close the Log window, or click
the
"X" in the corner.
- Exit:
Closes SDM. If you exit while
downloading,
your download will be Stopped.
- Edit Menu
- Paste:
Select to paste a copied URL for downloading into the SDM file
list.
- Add, Retry,
and Remove do
the same thing as the corresponding
buttons.
- Control Menu
- Help
- Online
Help: Opens a new window containing
this SDM Help file. Note that the Help file is downloaded on
demand so may take a moment to load. Please refer to it often, as it always
contains the latest information.
- About: The About box shows the SDM version
and Copyright Notices.
[ Back to Contents ]
[ Back
to Contents ]
SDM is a 100% cross-platform Java
application and therefore makes no changes to system files (such as registry values or non-SDM configuration files) when installed. Uninstallation directions
are different for the stand-alone version and the JaWS version.
Uninstalling the Stand-Alone Version of SDM
Solaris Operating System
- Go to the directory
where SDM was installed and delete all the files.
- Also delete the SDM property files in this directory:
~/.SunDownloadManager/
Windows
- An uninstall program is
provided. From the SDM program group -- called "Sun Download Manager
2.0 (local)" --
run "Uninstall Sun Download Manager 2.0 (local)".
- You can also uninstall by
running the file "uninstal.exe"
in the SDM directory.
- Complete uninstallation by
manually deleting the SDM property files in this directory:
C:\Document
and Settings\<your username>\.SunDownloadManager
Linux
- Type the following at
the command line:
"rpm -e sdm"
- Also delete the SDM property files in this
directory: ~/.SunDownloadManager/
All Other
Platforms
- Go to the directory
where the SDM files were installed and delete all files.
- Also delete the SDM property files in this directory:
~/.SunDownloadManager/
Uninstalling the Java Web Start Version
(including
the version installed automatically on the SDLC download page)The
JaWS version should be removed through the Java
Control Panel.
Windows
- Open
Java Control Panel as follows: Start -->
Settings --> Control Panel --> Java
- Under
"Temporary Internet Files", click "Settings"
- On
the window that opens, click "View Applications"
- In
the applications list, click "Sun Download Manager 2.0 (web)"
- Click
"Remove Selected Application"
- Close Java Control
Panel
- Complete uninstallation by manually deleting
the SDM property files in this directory:
C:\Document
and Settings\<your username>\.SunDownloadManager
All
Other Platforms
There are several ways to
start and use Java Control Panel, depending on your installation and
platform.
- Open a terminal/command prompt
window and type in "javaws"
- or - - Run
<JRE Installation Directory>/jre/bin/javaws
- or
- - Use either the Program Files, or Launch
--> Applications --> Internet menu
- Pick
"Java Web Start" from the menu
- Once
the Java Application Cache Viewer is displayed, select "Sun Download
Manager" from the list.
- Click 'Remove Selected
Application' button.
- Go to File -->
Exit
- Complete uninstallation by deleting
the SDM property files in this directory:
~/.SunDownloadManager/
[ Back to Contents ]
General
- Upgrade JRE: We highly recommend
using the latest version of Java Runtime Environment (JRE) for optimal
SDM performance and functionality. If you have difficulties with
SDM, this fixes most issues. Visit
java.com for the latest version.
- Maximum
Retry Errors:
- You
must set the proxy
server information correctly if connecting through a proxy
server.
- When downloading from Sun Download Center,you can only download the same file completely one time. If you try again, you will get the
Maximum Retry Error. For more information, see the SDLC
FAQ.
- Error message in the SDM status
column may be of the format: "Download failed. Maximum
retries exceeded. See Help for more info. [1]". The numbers at the
end vary from [1] to [4] and mean the following:
- [1]:
The maximum successive reconnections to a single
URL have expired.
- [2]:
The maximum number of successive
redirects to a new
URL from a single URL has reached its limit. This protects SDM from
hanging inside an error redirection loop due to a server
failure.
- [3]:
This can be one of two issues.
- The
server
reports a "text/html" content type for a download that is expected
to be non-html. This prevents SDM from
downloading an "error.html" page instead of the actual
download.
- You may have reached the
maximum
number of successful downloads allowed by the SDLC.
- [4]:
The maximum successive attempts at
verification of
a file have been reached.
- Downloads Don't Work on Other Sites:
SDM
specifically supports the Sun Download Center and is not
warranted to work with any other download sites, whether Sun's or
any other company's. (However, it does work on many other sites, so
feel free to give it a try!)
- Download Fails with Status of "Download failed. Unable to verify":
SDM uses small "verification property files" (VPFs) that may be downloaded automatically by SDM to provide real-time checksum verification of files as they download. If your download fails at the beginning (that is, no bytes are downloaded successfully) and you see the Status message, "Download failed. Unable to verify. See Help for more info.", it is possible there is an accidental mismatch between the VPF file and the file being downloaded. You can try the download again with Verification turned off -- SDM can be used successfully without VPFs. To turn off verification:
- Select "File-->Options"
- In the Options window, uncheck "Use automatic file verification when available (recommended)".
- Click OK to close the Options window.
- In the SDM main window, click the file name, then "Retry", then "Start" to try the download again without verification.
- In general, it is much better to use verification when available. Please turn it back on after downloading the problematic file
Java Web Start (JaWS) and SDLC Integrated Versions Only
- Use a 32 Bit Java Version and Browser
- Security
Certificate Warning Prevents Installation
- This
happens when running JRE versions 1.4.2_05 or earlier, due to
a change in root certificates in later Java versions. Use a
more recent version of Java or run the stand-alone
version of SDM.
- Files Checked to Download on SDLC Do Not Appear in SDM File List Automatically
- After selecting files to download on SDLC and starting SDM by clicking "Download selected with Sun Download Manager", the checked files should be added to the SDM file list automatically. However, SDM may start up with an empty file list.
- This issue should be resolved by installing the latest version of JRE.
- Alternately, SDM will work fine in this state, you just have to add the files manually.
- No Desktop Icon Created
- During installation, you may not be offered the option to create a desktop icon, and none is created. This is a limitation of certain JRE versions in combination with certain operating systems.
- Installing the latest version of JRE will often (but not always) resolve this.
- You can create a desktop icon manually by opening the Java Control Panel or Java Web Start application. Once opened, locate and highlight the SDM application, then select "Create Shortcuts" from the Applications menu.
- Use another option to restart the JaWS version of SDM.
Solaris Operating System
- Solaris OS patches may be required before
installing a newer version of Java Runtime Environment on an older
Solaris OS version. For your convenience, the needed patches are available on SunSolve, bundled
together as "Recommended
Solaris Patch Clusters" for J2SE.
Windows
- If you
receive a Windows error that it does not know how to run a
"jar"
program or "jnlp" file, install
the latest version of Java Runtime Environment.
- If SDM will not run, you may have an incorrect Java
classpath. This can happen when you upgrade from one version of Java to the
next or if another program incorrectly modifies the classpath. To
fix this, make sure the classpath points to the latest version of
Java or change it to "." to point to the directory in which SDM is
running.
Here is an example of how to do this on Windows XP:
- Right-click on "My Computer"
- Choose Properties
- Click on the Advanced tab
- Click on the Environment Variables button at the bottom
- In the "System variables" window, click "CLASSPATH", then
"Edit".
- Change the Variable value to "." (that is a single period,
without the quotes).
- Click OK to close the windows.
- You may have to reboot for the change to take effect.
Mac OS X
- If you have trouble starting SDM, try the following:
- Launch the Terminal application
- cd to the SDM directory
- Type "sh sdm.sh", then hit the Enter or Return key.
[ Back to
Contents ]
All Platforms
- SDM does not support HTTPS downloads at this time, only HTTP or
FTP.
- Large File Support: SDM will download single files
greater than 2 GB from Sun Download Center only. At this time,
SDM does not support large file downloads on any other web
site.
- Important: Large files require extra system processing time
at the end of the download. As a result, the SDM progress
bar may show "100%" while the Status still says "Downloading
data..." Be patient and do not close SDM. After a few
minutes, the Status changes to "Downloaded", and the
download is complete.
- SDM does not work with SunSolve Online downloads.
- The Pause and Resume buttons do
not work for FTP.
- Behind a proxy, FTP
requiring authentication (i.e.,
username/password) may not work on all systems.
- If
you
are behind a proxy and try an FTP
download, SDM may not be able to capture the file size at the start of
the download. The file size will be updated as the file downloads, and
the progress bar will not work. The download should succeed
however.
All UNIX Platforms
- SDM uses Java unzip routines which may not reset all file permissions correctly after unzipping. If you see this issue, select File-->Options and set "Unzip Behavior" to "Do not unzip downloaded zip archives", then unzip files manually using a separate unzip
program.
Solaris Operating System
- On Solaris 10 with Java 5.0 update 7 or earlier, clicking the "Download Selected with Sun Download Manager" button a second time on the SDLC download page will not add the selected files. Solutions:
- To
add more files to SDM, use drag & drop or copy & paste
instead.
- Upgrade to latest version of Java Runtime Environment
Windows
- SDM does not work with the Windows utility, ZipMagic. You must
disable or uninstall ZipMagic to use SDM.
[ Back to Contents ]
For further questions about SDM, please contact Customer Service using the SDLC
Feedback Form.
[ Back to Contents ]
|
|
