Revision as of 02:55, 17 September 2015 (edit)
( | contribs)
← Previous diff |
Revision as of 04:23, 18 September 2015 (edit) (undo)
( | contribs)
Next diff → |
| Line 1: |
Line 1: |
| - | <tt>curl</tt> is a command-line resumable download tool. It is useful when downloading files over unsteady connections or when your browser stops early when downloading some files. We have found that some combinations of browsers and internet connections have a high frequency of incomplete downloads of NeoOffice releases. | + | If a NeoOffice .dmg file was [[NeoOffice_Download_and_Installation_Issues#When_double-clicking_on_the_.dmg_file.2C_there_is_an_error_about_.22image_not_recognized.22|not completely downloaded]], you can use the <tt>curl</tt> command in the Terminal application to download the missing bits of a NeoOffice .dmg file. |
| | | | |
| - | When this happens, double-clicking the .dmg file will usually produce an error message stating "No mountable file systems" or similar. | + | To download using the <tt>curl</tt> command, use the following steps: |
| | | | |
| - | You can use these instructions to download NeoOffice (or, often, complete a failed download)—and NeoOffice patches, too (just substitute the URL to the patch for the URL to the full binary in the instructions). | + | # Go to the [http://www.neooffice.org/neojava/download.php?fragment=download NeoOffice download page] and select the version that you want to download |
| | + | # When the download starts, cancel the download |
| | + | # Scroll to the bottom of the web page and click on the link that is in the red rectangle shown in the screen snapshot below |
| | + | # Follow the instructions in the web page that appears |
| | | | |
| - | ==Using <tt>curl</tt> to download a NeoOffice release== | + | [[Image:Download using cURL.png]] |
| - | | + | |
| - | To download a NeoOffice release using <tt>curl</tt>, please follow the instructions provided at the bottom of the Download Mirrors page on the NeoOffice.org website. | + | |
| - | | + | |
| - | ==Using <tt>curl</tt> to download a NeoOffice patch== | + | |
| - | | + | |
| - | To use <tt>curl</tt>, follow these steps: | + | |
| - | | + | |
| - | # Open a new Terminal window (<tt>/Applications/Utilities/Terminal.app</tt>) | + | |
| - | # <tt>cd</tt> to the directory (folder) where you want the NeoOffice patch .dmg download to appear and press '''return''' | + | |
| - | #: For instance, if you want to download to the Desktop, type <tt>cd ~/Desktop</tt> and press '''return'''<br>(be sure to type the the '''~''' symbol, which is the UNIX shortcut for "your home folder") | + | |
| - | # Visit the [http://www.neooffice.org/neojava/patch.php NeoOffice patch download page] in your browser and find a mirror to use (if you happen to know a mirror is located in your part of the world, use it; otherwise, pick the top mirror) and control-click on the download link. Select '''Copy Link Location''' (or similar-sounding option in your browser) from the context menu. | + | |
| - | # Switch back to the Terminal and type the following, without pressing return: <tt>curl -C - -O</tt> | + | |
| - | #: (that's a capital o, not a zero) | + | |
| - | # Then press the '''spacebar''' and then paste the link you copied from your browser | + | |
| - | #: The full command should look something like this: <br><tt>curl -C - -O <nowiki>http://www.mirror.com/path/to/NeoOffice-Patch.dmg</nowiki></tt> | + | |
| - | # Press '''return''' and the download will start. | + | |
| - | # If you need to disconnect for any reason, pressing '''control-c''' will stop the download. | + | |
| - | # If the download "finishes" early (compare the .dmg size on disk—select the file and choose '''Get Info''' from the Finder's '''File''' menu—with the size listed on the [http://www.neooffice.org/neojava/patch.php NeoOffice patch download page]) or was interrupted for any reason, just repeat the full command (if the Terminal window is still open, pressing the '''up''' arrow key will usually redisplay the last command so you won't have to retype it; just press '''return'''. | + | |
| - | #: Repeat this step until the '''size of the downloaded .dmg file matches that from the NeoOffice patch download page''' and the disk image opens properly after double-clicking. | + | |
| - | | + | |
| - | ==Using <tt>curl</tt> to complete a “failed†download begun by a web browser== | + | |
| - | | + | |
| - | In many cases, you can also use <tt>curl</tt> to complete a download that you started in your web browser but which did not complete properly. This will not always work (sometimes <tt>curl</tt> cannot pick up where the browser left off and must start over), but even if <tt>curl</tt> has to start over from scratch, you should be able to stop and restart the "new" download that <tt>curl</tt> began. | + | |
| - | | + | |
| - | === Resuming a “failed†download of a NeoOffice release begun by a web browser=== | + | |
| - | | + | |
| - | If you are attempting to continue a download of a NeoOffice release or language pack begun by your web browser, please follow the instructions provided at the bottom of the Download Mirrors page on the NeoOffice.org website. | + | |
| - | | + | |
| - | If your web browser did not save they NeoOffice .dmg to your Desktop, you must replace the <tt>cd ~/Desktop</tt> part of the command with <tt>cd /path/to/folder/containing/failed/download</tt>, e.g. if your failed NeoOffice download is saved in a "Downloads" folder in your user's home folder, you would type <tt>cd ~/Downloads</tt> for the initial part of the command. | + | |
| - | | + | |
| - | === Resuming a “failed†download of a NeoOffice patch begun by a web browser=== | + | |
| - | | + | |
| - | # Open a new Terminal window (<tt>/Applications/Utilities/Terminal.app</tt>) | + | |
| - | # <tt>cd</tt> to the directory (folder) where your partially-downloaded NeoOffice .dmg is located and press '''return''' | + | |
| - | #: For instance, if the file is on the Desktop, type <tt>cd ~/Desktop</tt> and press '''return'''<br>(be sure to type the the '''~''' symbol, which is the UNIX shortcut for "your home folder") | + | |
| - | # Visit the [http://www.neooffice.org/neojava/patch.php NeoOffice patch download page] in your browser and find a mirror you used and then control-click on the download link. Select '''Copy Link Location''' (or similar-sounding option in your browser) from the context menu. | + | |
| - | #: Some browsers store or display the URL of a download in the download manager, so you can copy the URL of the failed NeoOffice download from there. You may have to control-click on the download and choose '''Copy Source URL''' or '''Copy Link''' or similar from the context menu. | + | |
| - | # Switch back to the Terminal and type the following, without pressing return: <tt>curl -C - -O</tt> | + | |
| - | #: (that's a capital o, not a zero) | + | |
| - | # Then press the '''spacebar''' and then paste the link you copied from your browser | + | |
| - | #: The full command should look something like this: <br><tt>curl -C - -O <nowiki>http://www.mirror.com/path/to/NeoOffice-Version.dmg</nowiki></tt> | + | |
| - | # Press '''return''' and curl will attempt to resume the download from where the browser left off. | + | |
| - | # If you need to disconnect for any reason, pressing '''control-c''' will stop the download. | + | |
| - | # If the download "finishes" early (compare the .dmg size on disk—select the file and choose '''Get Info''' from the Finder's '''File''' menu—with the size listed on the [http://www.neooffice.org/neojava/patch.php NeoOffice patch download page]) or was interrupted for any reason, just repeat the full command (if the Terminal window is still open, pressing the '''up''' arrow key will usually redisplay the last command so you won't have to retype it; just press '''return'''. | + | |
| - | #: Repeat this step until the '''size of the downloaded .dmg file matches that from the NeoOffice download page''' and the disk image opens properly after double-clicking. | + | |
| | | | |
| | [[Category:NeoOffice]][[Category:Tips and Hints]] | | [[Category:NeoOffice]][[Category:Tips and Hints]] |
