First, you must 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
prompted to accept license.
Solaris Operating System on SPARC
From a terminal window, change to the directory where you saved
the installation file.
Make the file executable
("chmod ug+x sdm-1_3-solaris-sparc.sh")
Run the file "sdm-1_3-solaris-sparc.sh"
(To run it, just type the filename "sdm-1_2-solaris-sparc.sh" at a
prompt, then hit the Enter or Return key.)
Note: As an alternative to making the file executable, you may
run the file with the full path by typing:
"/bin/sh sdm-1_3-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. (To restart the CDE
Workspace Manager, right-click on the CDE Desktop to get the
Workspace Menu. Go to the Windows folder, and select Restart
Workspace Manager.) After restarting, the SDM icon will appear on
the front panel. Just click it to start the program.
If you chose to install the CDE front panel icon, you'll also
get an icon added to your home directory in the CDE file manager
(as long as you don't already have a file or directory called
"sdm"). You can start SDM by double clicking this icon in the CDE
file manager.
To start SDM without installing the icon, in a terminal window
(in the SDM directory), type the filename "sdm.sh", then hit the
Enter or Return key.
Solaris Operating System on x86
From a terminal window, change to the directory where you saved
the installation file.
Make the file executable
("chmod ug+x sdm-1_3-solaris-i586.sh")
Run the file "sdm-1_3-solaris-i586.sh"
(To run it, just type the filename "sdm-1_3-solaris-i586.sh" at a
prompt, then hit the Enter or Return key.)
Note: As an alternative to making the file executable, you may
run the file with the full path by typing:
"/bin/sh sdm-1_3-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. (To restart the CDE
Workspace Manager, right-click on the CDE Desktop to get the
Workspace Menu. Go to the Windows folder, and select Restart
Workspace Manager.) After restarting, the SDM icon will appear on
the front panel. Just click it to start the program.
If you chose to install the CDE front panel icon, you'll also
get an icon added to your home directory in the CDE file manager
(as long as you don't already have a file or directory called
"sdm"). You can start SDM by double clicking this icon in the CDE
file manager.
To start SDM without installing the icon, in a terminal window
(in the SDM directory), type the filename "sdm.sh", then hit the
Enter or Return key.
Windows
Go to the directory where you saved the installation file.
In Explorer, double-click the file "sdm-1_3-windows-i586.exe"
(or run it from a command window).
Follow the on-screen steps to complete the installation.
To start SDM:
Double-click the Sun Download Manager icon on your desktop,
or
Double-click the file "sdm.bat" in Explorer, or
Java Web Start
If you are using the Java Web Start installation, follow the
instructions below.
This will take you to the SDM Java Web Start launch page. If
Java Web Start does not launch immediately, click on the launch
Java Web Start link.
Follow the instructions provided by the Java Web Start
application. You can have Java Web Start create an icon for you on
your desktop.
Linux and Sun Java Desktop System
After downloading the zip file for the "Linux and Sun Java
Desktop System" version of the Sun Download Manager, do the
following:
From a terminal window, change to the directory where you saved
the installation file.
To check for an existing SDM install
("rpm -q sdm")
Type the following only if you have a previous version of SDM
installed
("rpm -e sdm)
To install, type
("rpm -i sdm-1_3-linux-i586.sh")
Now you can launch SDM by choosing Launch > Applications
> Internet > Sun Download Manag er or by typing ("sdm&")
at the command prompt.
Note: Before you run SDM, choose Launch > Preferences >
Internet to check if you have proxies configured for the desktop.
The first time you run SDM, you will be taken to a Sun Download
Manager Options screen where you can set your preferences for SDM
(choose your download directory, set your download preferences,
etc). Click the Proxies tab to enter your proxy configuration.
All other Platforms, including Mac OS X and other Java 2
Platforms
Go to the directory where you saved the installation file.
Unzip the file "sdm-1_3.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.
Using Sun Download Manager
Sun Download Manager (SDM) is specially designed to download
large files from the Sun Download
Center (SDLC). For most large files on SDLC, it will insure you
get a complete and valid copy of the 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.
Initial Start-Up & Options
The first time SDM runs, the License screen and the Options
screen displays automatically. Please set or review all of the
following Options:
Download Tab
Destination Directory
You must set the destination directory--all downloads will be saved
there. Type in the full path to the directory in the box provided.
If you prefer, click the Browse button, then:
Click on the box right after "Look in:" and select a disk drive
from the list. A list of directories will appear in the box
below.
Click (once) on the desired destination directory from the
list, or double-click a directory name to go down one level.
The final destination directory must be highlighted in the list
box before you can save your choice.
Once highlighted, click the "Open" button to finish.
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 operation. 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 option controls what happens when SDM tries to save a file
with the same name as a file already in your destination directory.
Selecting "Overwrite existing file" erases the old file and saves
the new file over it. To keep the older version, select "Rename
existing file." The older file will be kept and renamed 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 zip feature--you must unzip the files after
they are downloaded.
Unzip downloaded zip archive, then delete *.zip archive
Automatically unzips the file and then deletes the original
zip archive.
Use verification properties when available
SDM uses a unique file verification system that requires an online
verification property file corresponding to the file you are
downloading. Verification property files are available for many of
the most popular and largest files on SDLC and are retrieved
automatically by SDM when needed. Do not uncheck this box unless
you are experiencing difficulties with the automatic file
verification process and wish to try your download without it.
Http Settings
If your Internet connection goes through a proxy server for http
settings, check the "Use a proxy server" box. Next, enter the proxy
server address and port number.
FTP Settings
If your Internet connection goes through a proxy server for ftp
settings, check the "Use a proxy server" box. Next, enter the proxy
server address and port number.
If your proxy server is the same for http as well as ftp, you
can check the "Use Http Proxy" box. It will use the http proxy
server settings, and you will not need to re-enter your proxy
server address and port number in the ftp settings section.
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 wildcard in the host
name.
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 the "Set Http Proxy
Authentication" box and a popup box will appear. Enter the username
and password, re-enter the password for verification, then click
"OK".
Use Ftp Proxy Authentication:
If you clicked "Use Http Proxy" 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 the "Set Ftp Proxy
Authentication" box and a popup box will appear. Enter the username
and password, re-enter the password for verification, then click
"OK".
Hosts Authentication
This allows you to add a list of authenticated hosts, so you don't
need to enter the username/password every time you download from a
specific site.
Add Host
When you click the "Add Host" box, a popup will appear asking for
information about the host. In the popup, specify the protocol
(http or ftp), the host, the port (optional), username and
password. Re-enter the password for verification purposes. Click
"OK" button to continue. 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 the "Edit Host" box to edit the host. You will be able to
edit the username and password. After you enter your changes, click
the "OK" button to continue, or "Cancel" to exit without making
changes.
Delete Host
Select the host you wish to delete from the drop down list. Then
click on the "Delete Host" box to delete the host. The host will be
deleted and removed from the drop down list.
Save logins and passwords for authenticated hosts on
disk
Check "Save logins and passwords for authenticated hosts on disk"
if you wish to save your authenticated host list to a file on your
hard drive. If this is checked, the authenticated host data will be
saved for the next time you start up SDM. If this is not checked,
you will need to re-enter the authenticated host list 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.
Downloading
Once you've set the Options, you're ready to download. First,
use your web browser to navigate to the page containing the direct
links to the download file(s). Next, you can either use drag and
drop (if supported by your browser/platform combination) or copy
and paste to download your file.
Copy and Paste Instructions:
Right-click on the desired link. A pop-up menu appears.
Using Netscape, select "Copy Link Location".
Using Internet Explorer, select "Copy Shortcut".
Go to the SDM and paste in the link you just copied.
You can paste the link directly into the file queue (the large
box in the middle of the application). Just put your cursor over
SDM, then to paste:
Type Ctrl-V (depress the "Control" key and the letter "V" at the same time), or
Select "Edit-->Paste" from the SDM Menu bar, or
Use the "Paste" key on Solaris keyboards.
Alternately, you can click "Add File", then paste the link
directly into the box provided.
Repeat this process to add as many download links as desired to
the queue.
Drag and Drop Instructions
Click and hold on the desired download link, then drag the link
to the Sun Download Manager.
Release the mouse button when the cursor is in the "Files to
Download" area. Your download should appear in the list.
Note: If your "Files to download" list fills up and you can't
drag more files into it, increase the size of the SDM application
window to give you more rows.
Drag and Drop Combinations: Drag and
drop works with many but not all combinations of browser, platform,
and JVM (Java Virtual Machine). The following table lists JVM
versions that work with the specified browser/platform combination.
(Other combinations may work, as it was not possilbe to test them
all.)
Start: To begin downloading, click Start. SDM will start
with the first file in the list (that has not already been
downloaded successfully). SDM will continue through the list, 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 on the list (if any).
Pause: Clicking "Pause" will pause the download process
immediately. Always use "Pause" rather than "Stop" if you plan to
continue downloading the same file at a later time.
Resume: If you previously "Paused" the download, click
"Resume" to continue. Resume starts the download from where it was
paused (rather than having to start at the beginning again), saving
you time and bandwidth.
Stop: Caution! Clicking Stop completely cancels the
download operation. If you have a file partially downloaded and
click "Stop", it may be completely erased from your system
(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 never be
erased from your system.
Show Details: Click to see a pop-up window containing
more details about the download in progress. Once clicked, the
button changes to "Hide Details". To close the Details window,
click "Hide Details" or the "X" in the top right corner of the
pop-up window.
Add File: Click to get a pop-up box for entering the URL
of a file for download. (See "Downloading" for more information.) You can only
add a file to the list when SDM is stopped or in Pause mode.
Retry File: If you Stop a download or a download fails
for any reason, it will remain in the file list but will not be
downloaded automatically the next time you click Start. To download
a file in a stopped/failed status again, highlight the file name,
then click "Retry File". It will download the next time you click
Start. If you don't want to download it again, use Remove
File.
Remove File: To remove files from the file list, click
and highlight the file(s) to be removed, then click "Remove File".
(This removes files from the list only; any files downloaded
successfully remain on your computer. Also note that every time SDM
starts, it automatically removes successfully downloaded files from
the list.) You can only remove files when SDM is stopped.
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.
This can be done any time except when a download is in
progress.
Using the Menu
The Menu Bar across the top of the SDM window offers these
options:
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 data can be very
helpful 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 top right corner.
You can also view, edit, or print the Log with any text editor.
Open the file "SDMLog.properties" in the SDM directory.
Exit: Closes the SDM. If you exit while downloading,
your download will be Stopped.
Edit Menu
Paste: After copying the URL of a file for downloading,
you can paste the URL into SDM using this menu selection.
Add File, Retry File, and Remove File do
the same thing as the corresponding
buttons.
Control Menu
Start, Pause, Resume, Stop, and
Show Details do the same thing as the corresponding buttons.
Help
Online Help: This option opens a new window containing
this SDM Help file. The Help file is not bundled with SDM but
rather downloaded on demand over the Internet, so it may take a
moment to load. Please refer to it often, as it will always contain
the latest information about SDM.
About: The About box shows the version of SDM you are
using and the SDM Copyright Notices.
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.
Solaris Operating System
Go to the directory where the SDM files are installed.
Delete all files.
If you set up the icons in the CDE Front Panel, you need to go
into your .dt directory in your home directory. In both the icons
and types directories, do an rm sdm.* to remove files from the
front panel. You may need to restart your workspace manager.
Windows
An uninstall program is provided. From the SDM program group,
run "Uninstall Sun Download Manager."
You can also run uninstall by running the file "uninstal.exe"
in the SDM directory.
After running uninstall, it may be necessary to manually delete
the desktop icon, Start menu entry, program group, and
shortcut.
Linux
Type the following at the command line
("rpm -e sdm")
It will automatically uninstall SDM.
All Other Platforms
Go to the directory where the SDM files are installed.
Delete all files.
Delete any icons, program groups, or shortcuts that you set
up.
Troubleshooting
All Platforms
If your download won't start and you get a "maximum retry"
error, be sure the proxy server information is
set up correctly.
If you are downloading from the Sun Download Center and get a
"maximum retry" error, you may have encountered a security feature
which limits the number of downloads of the same file. For more
information, see the SDLC FAQ.
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.
If you are behind a proxy, and you attempt to do an FTP
download, but the size is unknown, your download may fail. You can
increase the "MaxZeroSize" field in the SDMConfiguration.properties
file to the size of the download up to 512MB.
Verification Properties Files (VPFs) are special files
downloaded automatically by SDM that provide real-time checksum
verification of files as they download. VPFs are provided by Sun
for most large files on the SDLC but are not available for files
not on Sun servers. If you look at the SDM log and it says that the
verification properties file was not found, this is usually not a
bug. Rather, it means there was no VPF available for that
particular file. SDM can be used successfully without VPFs.
After a failure, in the SDM status column, error messages
appear. They 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. If the server
reports a "text/html" content type for a download that is expected
to be non-html, this error appears. This prevents SDM from
downloading an "error.html" page instead of the actual download.
The other cause for this error, is that 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.
Solaris Operating System
Solaris patches must be installed before
installing a newer version of J2SE on an older Solaris version. For
your convenience, the needed patches are bundled together and
available through SunSolve.
To patch your system, first retrieve the patches via FTP or web
browser.
via FTP:
Use an ftp client or command-line ftp to "sunsolve.sun.com",
then login as "anonymous" with your email address as the
password.
cd to the "/pub/patches/" directory. There you'll find the
relevant patch clusters, which all start with "J2SE..." For
example:
J2SE_Solaris_2.6_Recommended.README
J2SE_Solaris_2.6_Recommended.tar.Z
J2SE_Solaris_7_Recommended.README
J2SE_Solaris_7_Recommended.zip
etc...
Download the appropriate patch cluster and README file for your Solaris version.
A long list of files will load. Towards the bottom of the page,
you'll see the relevant patch clusters, all starting with
"J2SE..."
Click the filenames to download the appropriate patch cluster
and README file for your Solaris version.
Installation: Carefully review the README and
uncompress/extract or unzip the patch file. There should be a
script you can run to actually install the patches. The script
knows what order to install the patches in, so if it exists, use
it. Also, you must be root to install the patches.
Windows
If you receive an error from Windows that it does not know
how to run a "jar" program, your system does not have a recent
version of Sun's Java installed. Please visit this site to install Java
first, then run SDM.
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.
Known Issues
All Platforms
SDM does not support HTTPS downloads at this time, only HTTP or
FTP.
SDM will not download single files greater than 2 GB in size.
The Pause and Resume buttons do not work for FTP.
Behind a proxy, FTP/HTTP requiring authentication (ie
username/password) may not work when using Java 1.3/1.4/5.0.
FTP requiring authentication does not work when using Java 1.4/5.0.
In Java 1.2, for FTP, <username>@site does not work.
(<username>:<password>@site does work.)
All UNIX Platforms
File permissions: SDM uses Java unzip routines which may not
reset all file permissions correctly after unzipping. Workaround:
Select File-->Options and set "Unzip Behavior" to "Do not
unzip...", then unzip files manually using a separate unzip
program.
Solaris Operating System
The Paste key does not work with Java 1.2. Use Ctrl-V
instead.
Windows
SDM does not work with the Windows utility, ZipMagic. You must
disable or uninstall ZipMagic to use SDM.
Customer Support
For further questions about SDM, please contact Customer Service using the SDLC Feedback Form.
