Help

• Installation and Start-Up
• Using Sun Download Manager
• • Initial Start-Up & Options
  • Downloading
  • Using the Buttons
  • Using the Menu
• System Requirements
• Uninstall
• Troubleshooting
• Known Issues
• Customer Support

Installation and Start-Up

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.

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 sdminstall.sh")
• Run the file "sdminstall.sh"
  (To run it, just type the filename "sdminstall.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 sdminstall.sh"
• Follow the on-screen steps to complete the installation.
• 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, 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

• Go to the directory where you saved the installation file.
• Unzip the file "sdminstall.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, 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 "sdminstall.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
  • Run "sdm.bat" from a DOS or Command window.

Other Platforms, including Linux and Mac OS X

• Go to the directory where you saved the installation file.
• Unzip the file "sdminstall.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 has not been extensively tested on any other Sun or non-Sun sites, and there is no assurance it will work on any other sites except the SDLC. Following are the instructions for using SDM with the SDLC.

• 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.
• Proxy Setup
  If your Internet connection goes through a proxy server, check the "Use a proxy server" box. Next, enter the proxy server address and port number.
• 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.
• Remove partially downloaded file on disk after STOP
  If you check this box, any partially downloaded file will be deleted automatically whenever you hit the STOP button in the middle of a download.
• 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.

Hit the "OK" button when all Options are set.

The following buttons control the main operation of SDM:

• 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.

The following buttons control the file list (or "queue"):

• 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.

• 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 "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 1994-2004 Sun Microsystems, Inc. Press