Differences between revisions 2 and 31 (spanning 29 versions)
Revision 2 as of 2009-07-10 20:52:47
Size: 1414
Editor: RalfHemmecke
Comment:
Revision 31 as of 2022-04-26 03:03:54
Size: 2588
Editor: mkoeppe
Comment: replace outdated guide by link to the Installation Manual
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Sage Download And Installation Guide = = Quick Download and Installation Guide =

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 4: Line 6:
 1. Determine your operating system. (Windows, Linux, Mac OS X, Solaris, etc.) == BitTorrent ==
Line 6: Line 8:
 1. Determine your CPU type. (32bit or [[http://www.stata.com/support/faqs/win/64bit.html|64bit]]) ''[[http://en.wikipedia.org/wiki/BitTorrent_(software)|BitTorrent]]'' (or just "Torrent") is a peer-to-peer communication protocol for transferring huge amounts of data securely and efficiently over the internet. This is probably the best option for downloading Sage, make sure that your [[http://en.wikipedia.org/wiki/Comparison_of_BitTorrent_clients#Features_II|BitTorrent-Client supports "web-seeds"]].
Line 8: Line 10:
 1. Do you want source or binary distribution?
     Usually (even if you want to do development) you will be satisfied with a precompiled version of Sage (binary release).
     The source distribution is only 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|Installation Guide]] to actually install Sage.
Recommended clients are:
 * [[http://deluge-torrent.org/|Deluge]]
 * [[http://aria2.sourceforge.net/|Aria2]] for the Linux command-line (`sudo apt-get install aria2` and then `$ aria2c http://...*.torrent`)
 * [[http://www.vuze.com/|Vuze]]
 * [[http://www.transmissionbt.com/|Transmission]] (default in various Linux distributions)
Line 17: Line 17:
== Trouble shooting == === Metalink ===
Line 19: Line 19:
 1. If no binary version is available for you system, download the source version. Note that Sage does not compile on every system. The provided torrent files contain web-seeds which are technologically equivalent to Metalink files.
Make sure your torrent client understands web-seeds (e.g. all based on libtorrent do so).
Line 21: Line 22:
 1. (((rhx: That should go to the 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. == 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.

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

 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.

BitTorrent

BitTorrent (or just "Torrent") is a peer-to-peer communication protocol for transferring huge amounts of data securely and efficiently over the internet. This is probably the best option for downloading Sage, make sure that your BitTorrent-Client supports "web-seeds".

Recommended clients are:

  • Deluge

  • Aria2 for the Linux command-line (sudo apt-get install aria2 and then $ aria2c http://...*.torrent)

  • Vuze

  • Transmission (default in various Linux distributions)

The provided torrent files contain web-seeds which are technologically equivalent to Metalink files. Make sure your torrent client understands web-seeds (e.g. all based on libtorrent do so).

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)