How to launch the Download Tool using Java Web Start

The Download Tool launches a stand-alone application using the Java Web Start protocol. To view software requirements or if you have problems launching the application, please view the the Java Web Start troubleshooting guide.

NOTE: The current instructions is for Mac Firefox browser. Instructions will be different depending on browser and operating system.

If prompted, please update your JAVA to the latest version.

Step 1

The Download Tool can download coordinate and experimental data files, FASTA sequence files, and ligand data files for one or many PDB entries. After entering the IDs of interest, select the "Launch Download" button and you will be prompted to download and save locally a file called download_rcsb.jnlp.

Step 2

Choose the option "Open with Java Web Start (default)" and check the box "Do this automatically for files like this from now on". Then click OK.
Launching Java Web Start

Step 3

You will see the following dialogue if security settings are already correctly configured on your machine. Click Open to run the application.
Open JNLP file

Step 4

Click Run on the RCSB Download Application window. You will then be guided through the download process.
RCSB Download Application file chooser

Step 5

Select where the file(s) should be downloaded and then click Choose.
RCSB Download Application

Step 6

Click the Start Download button.
RCSB Download Application

Step 7

A progress bar will indicate 100% completeness once all files are downloaded. Click Done to end.
RCSB Download Application




Security Settings in System Preferences (Mac)

Based on the security settings on your machine, the following dialogue may appear. Please change the settings accordingly. The next images will guide you through changing the Security & Privacy settings and launching the Download Tool for Mac.
Can not launch JNLP due to security settings

Step 1

By default, Mac only allows apps downloaded from Mac App Store. Click the lock icon at the bottom of left-hand-side corn. You need to enter the password to make changes.
Change security settings

Step 2

Choose the option "Anywhere" under "Allow apps downloaded from". Then click the button Allow From Anywhere to confirm the change. You may also want to click the lock icon again to prevent further changes.
Open JNLP file

Step 3

Locate download_rcsb.jnlp and double click it to launch the application. When you launch the RCSB Download Application for the first time, you will see the following message. Click Open to run the download application.
RCSB Download Application