Size: 1830
Comment:
|
Size: 4222
Comment: Remove self-link
|
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 to download? This short guide should get you started. A [[http://wiki.sagemath.org/DownloadGuide|longer version]] of this guide is also available. | Not sure what [[http://www.sagemath.org/download.html|to download]]? This short guide should get you started. |
Line 5: | Line 5: |
1. Determine your operating system. (Windows, Linux, Mac OS X, Solaris, etc.) | 1. Determine your operating system. (Windows, Linux, MacOS X, Solaris, etc.) |
Line 7: | Line 7: |
1. Determine your CPU type. (32-bit, [[http://www.stata.com/support/faqs/win/64bit.html|64-bit]] or "atom") | 1. Determine your CPU type (32-bit, [[http://www.stata.com/support/faqs/win/64bit.html|64-bit]] or "atom" for Linux and [[32-64-bit-MacOS|Intel or PowerPC for MacOS]]). * In case you are running a 32-bit operating system on a 64-bit CPU, choose the 32-bit version. This can often be the case for Linux and Mac. |
Line 9: | Line 10: |
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. 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]], too. Another advantage of compiling Sage from source is that the generated code may make better use of your specific CPU. * For Mac OS X, there is the additional choice between a native Mac application (app bundle) and a Unix-style command line like for Linux, Solaris, etc. Both are full versions of Sage, containing both command line and notebook, but the Mac app has some extra features and is double-clickable without further effort. |
Line 13: | Line 15: |
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. | 1. Follow the [[http://www.sagemath.org/doc/installation/binary.html|binary installation guide]] to actually install a precompiled version of Sage. The [[http://www.sagemath.org/doc/installation/source.html|source installation guide]] contains more detailed information on compiling Sage from source. |
Line 15: | Line 17: |
== BitTorrent == ''[[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"]]. 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) == Metalink == 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 18: | Line 35: |
1. If no binary version is available for your system, download the source version. Note that Sage 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 20: | Line 37: |
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. 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. 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. (((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.))) |
Quick Download and Installation Guide
Not sure what to download? This short guide should get you started.
- Determine your operating system. (Windows, Linux, MacOS X, Solaris, etc.)
Determine your CPU type (32-bit, 64-bit or "atom" for Linux and Intel or PowerPC for MacOS).
- In case you are running a 32-bit operating system on a 64-bit CPU, choose the 32-bit version. This can often be the case for Linux and Mac.
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 SPKGs, too. Another advantage of compiling Sage from source is that the generated code may make better use of your specific CPU.
- For Mac OS X, there is the additional choice between a native Mac application (app bundle) and a Unix-style command line like for Linux, Solaris, etc. Both are full versions of Sage, containing both command line and notebook, but the Mac app has some extra features and is double-clickable without further effort.
If available, choose the appropriate binary version from one of the download mirrors.
Follow the binary installation guide to actually install a precompiled version of Sage. The source installation guide contains more detailed information on compiling Sage from source.
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:
Aria2 for the Linux command-line (sudo apt-get install aria2 and then $ aria2c http://...*.torrent)
Transmission (default in various Linux distributions)
Metalink
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
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.
- 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.)
You might run into the following issue with a binary release due to different features of your system and the system on which Sage was compiled.
(((rhx: That should go to the troubleshooting section of the Installation Guide or (even better) the error message related to sage-flags.txt should change.)))
Ask for help on the sage-support mailing list.