Differences between revisions 13 and 32 (spanning 19 versions)
Revision 13 as of 2009-12-03 01:34:11
Size: 3377
Editor: schilly
Comment:
Revision 32 as of 2022-04-28 19:04:21
Size: 1601
Editor: mkoeppe
Comment: remove bittorrent section, redundant after https://github.com/sagemath/website/pull/239#issuecomment-1111945583
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Quick Download and Install Guide = = Quick Download and Installation Guide =
Line 3: Line 3:
Not sure what [[http://www.sagemath.org/download.html|to download]]? This short guide should get you started. A [[http://wiki.sagemath.org/DownloadGuide|longer version]] of this guide is also available.

 1. Determine your operating system. (Windows, Linux, Mac OS X, Solaris, etc.)

 1. Determine your CPU type. (32-bit, [[http://www.stata.com/support/faqs/win/64bit.html|64-bit]] or "atom" for Linux and Intel or PowerPC for MacOS)

 1. Do you want a source or binary distribution? Even if you want to do development, a precompiled version of Sage (binary release) can be used for that purpose. The source distribution is mostly needed if you want to see the sources of the Sage packages, also known as [[spkg|SPKGs]].

 1. If available, choose the appropriate binary version from one of the [[http://www.sagemath.org/mirrors.html|download mirrors]].

 1. Follow the [[http://www.sagemath.org/doc/installation/binary.html|binary installation guide]] to actually install a pre-compiled version of Sage. The [[http://www.sagemath.org/doc/installation/source.html|source installation guide]] contains more detailed information on compiling Sage from source.

== Metalink ==

[[http://www.metalinker.org/|Metalinks]] ([[http://en.wikipedia.org/wiki/Metalink|Wikipedia]], [[http://www.freesoftwaremagazine.com/articles/using_metalinks|FSM]]) are XML files that contain multiple download sources and various checksums. Use them with a download manager below, if you want to make sure that your download works properly, automatically selects a fast mirror, recovers in case of a download server failure, if you want to pause and resume a download later or check'n'repair a broken file.

There are various Clients supporting this:
 * Cross-Platform: [[http://www.downthemall.net/|DownThemAll Firefox Extension]], [[http://jdownloader.org/|JDownloader (Java App)]]
 * Windows: [[http://www.freedownloadmanager.org/|Free Download Manager]], [[http://www.getright.com/|GetRight]], [[http://www.orbitdownloader.com/|Orbit]], ...
 * Linux: sudo apt-get install aria2 (command-line client)
 * MacOSX: [[http://www.yazsoft.com/|Speed Download]]
 * ... [[http://www.metalinker.org/samples.html|and many more]]
Not sure what [[http://www.sagemath.org/download.html|to download]]? See the [[https://02dc12e7f56de4edc34c6532a8c465979c658c1f--sagemath-tobias.netlify.app/installation/index.html|installation guide]].
Line 28: Line 7:
 1. If no binary version is available for your system, download the source version. Note that Sage compiles on a wide variety of systems, but does not compile on every system.  1. If no binary version is available for your system, download the source version. Note that Sage compiles on a wide variety of systems, but does not compile on ''every'' system.
Line 30: Line 9:
 1. If you are not sure how to unpack the compressed file or it's ending looks different:
   * *.tar.gz or *.tgz use: tar xzf *.tar.gz
   * *.tar.bzip2 or *.tar.bz2 use: tar xjf *.tar.bzip2
   * *.tar.lzma use: tar --lzma -xf *.tar.lzma
   * If the file ending is different, the Linux command "find" gives you information about the archive type. (file filename.ext)
 1. If you are not sure how to unpack the compressed file or its ending looks different:
   * {{{*.tar.gz}}} or {{{*.tgz}}}: Use {{{tar xzf *.tar.gz}}}
   * {{{*.tar.bzip2}}} or {{{*.tar.bz2}}}: Use {{{tar xjf *.tar.bzip2}}}
   * {{{*.app.dmg}}} or {{{*.dmg}}}: This is a Mac disk image, and you can just double-click it.
   * {{{*.tar.lzma}}}: Use {{{
tar --lzma -xf *.tar.lzma}}}
     * No {{{lzma}}}? Perhaps you have {{{xz}}}, that is compatible with {{{lzma}}}. There might also be {{{-J}}} in {{{tar -xJf *.tar.lzma}}} or you need to install an lzma or xz-utils package.
   
* If the file ending is different, the Linux command {{{file}}} gives you information about the archive type. (Type {{{file filename.ext}}} at the command prompt.)
Line 36: Line 17:
 1. (((rhx: That should go to the troubleshooting section of the [[http://www.sagemath.org/doc/installation/|Installation Guide]] or (even better) the error message related to sage-flags.txt should change.))) You might run into the [[http://groups.google.com/group/sage-devel/browse_thread/thread/53ae33d0324d44|following issue]] with a binary release due to different features of your system and the system on which Sage was compiled.  1. The [[https://wiki.sagemath.org/ReleaseTours|Release tour]] corresponding to the Sage version that you wish to install may offer '''version-specific installation help''' that has become available after the release was made and is therefore not covered by the installation manual.

Quick Download and Installation Guide

Not sure what to download? See the installation guide.

Troubleshooting

  1. If no binary version is available for your system, download the source version. Note that Sage compiles on a wide variety of systems, but does not compile on every system.

  2. If you are not sure how to unpack the compressed file or its ending looks different:
    • *.tar.gz or *.tgz: Use tar xzf *.tar.gz

    • *.tar.bzip2 or *.tar.bz2: Use tar xjf *.tar.bzip2

    • *.app.dmg or *.dmg: This is a Mac disk image, and you can just double-click it.

    • *.tar.lzma: Use tar --lzma -xf *.tar.lzma

      • No lzma? Perhaps you have xz, that is compatible with lzma. There might also be -J in tar -xJf *.tar.lzma or you need to install an lzma or xz-utils package.

    • If the file ending is different, the Linux command file gives you information about the archive type. (Type file filename.ext at the command prompt.)

  3. The Release tour corresponding to the Sage version that you wish to install may offer version-specific installation help that has become available after the release was made and is therefore not covered by the installation manual.

  4. Ask for help on the sage-support mailing list.

DownloadAndInstallationGuide (last edited 2022-04-28 19:04:21 by mkoeppe)