Difference between revisions of "TeX Live 2009"

From Wiki
Jump to navigation Jump to search
(Update, work in progress.)
(Updated for TeX Live 2009.)
Line 5: Line 5:
 
There is a number of ways to install TeX Live on your computer:
 
There is a number of ways to install TeX Live on your computer:
  
−
* you can obtain DVDs or CDs from a TeX user group (e.g. [http://www.tug.org/texlive/ TUG TeX Live homepage]); if you're a member of such a group, you may have received a copy as part of your membership benefits;
+
* you can obtain DVDs that contain TeX Live from a TeX user group (e.g. [http://tug.org/texlive/acquire-dvd.html details]); if you're a member of such a group, you may have received a copy as part of your membership benefits;
  
−
* you can use netinstall
+
* you can use [http://tug.org/texlive/acquire-netinstall.html netinstall] method; if you aren't doing full installation, it can save quite a bit of bandwidth;
  
−
* as teTeX will not be updated any longer, many linux distributions are switching to TeXLive instead (I know this is the case for Debian, Ubuntu, openSUSE, gentoo [at least the process is beginning]), Fedora ([http://fedoraproject.org/wiki/Releases/FeatureTexLive planed for F8]); the same may be true for other distributions;
+
* you may find out that your Linux distribution already has TeX Live in it's repoistory; many distributions already switchted to TeX Live from teTeX (e.g. Debian, Ubuntu, openSUSE, Gentoo, Fedora, Arch; the same may be true for other distributions);
  
−
If you want to use the installation procedure provided by your distribution, refer to its documentation. This wiki page will explain how to install TeXLive from the DVD/iso-images and via a rpm package.
+
If you want to use the installation procedure provided by your distribution, refer to its documentation and skip the next section. This page will explain how to install TeX Live from the DVD.
  
−
=== Installation from the TeXLive CDs/DVDs/iso images ===
+
=== Installation from the TeX Live DVD ISO images ===
  
−
====Obtaining the Necessary Files====
+
==== Obtaining the Necessary Files ====
  
−
If you have a DVD, just pop it in. If you want to download the latest TeXLive release, point your browser to the nearest CTAN mirror and go to the directory <code> systems/texlive/Images/</code>. Download the latest iso images. Please be warned: these images are '''huge''' (the compressed DVD image is 880 MB and will expand to 1.7 GB!), so if you're on a slow connection (e.g., via modem), the download will take '''very''' long to complete.
+
If you have a DVD, just pop it in. and skip to next subsection.
  
−
====Beginning and Customizing the Installation====
+
If you want to download the latest TeX Live release, point your browser to the nearest CTAN mirror and go to the directory <code>systems/texlive/Images/</code>. Download the latest ISO images. Please be warned that these images are ''huge'' (e.g. ISO image for TeX Live 2009 is 2,9 GiB), so if you're on a slow connection (e.g. modem), the download will take ''very'' long to complete.
  
−
Once you have downloaded and saved the file, decompress it and mount it. The installation procedure is command-line based, so change to a terminal window, cd to the directory where the DVD or the TeXLive iso has been mounted and start the installation process (on most systems, you will need root privileges to install, so either switch to a root terminal by typing <code>su</code> or precede the second line with <code>sudo</code>):
+
==== Beginning and Customizing the Installation (Linux/MacOS X/Unix-like) ====
  
−
<pre>cd TeXLive2007
+
Once you have downloaded and saved the file, decompress it and mount it. The installation procedure is command-line based, so change to a terminal window, cd to the directory where the DVD or the TeX Live ISO has been mounted and start the installation process (on most systems, you will need root privileges to install, so either switch to a root terminal by typing <code>su</code> or precede the second line with <code>sudo</code>):
−
./install-tl.sh </pre>
 
  
−
The installation process itself is pretty self-explanatory, so I mention just a few points that may be of interest:
+
<pre>cd /media/TeXLive2009
 +
./install-tl</pre>
  
−
be sure to type <code>B</code> in order to verify that your specific combination of architecture and operating system will be installed. Here is the list of architectures that are currently available:
+
The installation process itself is pretty self-explanatory, so hre we mention just a few points that may be of interest:
  
−
<pre>
+
* be sure to type <code>B</code> in order to verify that your specific combination of architecture and operating system will be installed. Here is the list of architectures that are currently available:
−
Available sets of binaries:  
+
** alpha-linux (HP Alpha GNU/Linux)
−
  alpha_linux: DEC Alpha with GNU/Linux
+
** hppa-hpux (HP-UX)
−
  hppa_hpux: HP-UX
+
** i386-cygwin (x86 Cygwin)
−
  i386_darwin: Intel x86 with MacOSX/Darwin
+
** i386-linux (x86 GNU/Linux)
−
  i386_freebsd: Intel x86 with FreeBSD
+
** i386-netbsd (x86 NetBSD)
−
  i386_linux: Intel x86 with GNU/Linux
+
** i386-solaris (x86 Solaris)
−
  i386_openbsd: Intel x86 with OpenBSD
+
** mips-irix (SGI IRIX)
−
  i386_solaris: Intel x86 with Sun Solaris
+
** powerpc-aix (IBM RS/6000 AIX)
−
  mips_irix: SGI IRIX
+
** powerpc-linux (PowerPC GNU/Linux)
−
  powerpc_aix: PowerPC with AIX
+
** sparc-linux (Sparc GNU/Linux)
−
  powerpc_darwin: PowerPC with MacOSX/Darwin
+
** sparc-solaris (Sun Sparc Solaris)
−
  powerpc_linux: PowerPC with GNU/Linux
+
** universal-darwin (MacOSX for both PowerPC and x86; bash.dmg available for bootstrap)
−
  sparc_linux: Sparc with GNU/Linux
+
** win32 (Windows 2000 and later)
−
  sparc_solaris: Sparc with Solaris
+
** x86_64-linux (x86 64-bit GNU/Linux)
−
  win32: Windows
+
* type <code>C</code> to choose what you want to install (maybe you don't want the Mongolian documentation to save some disk space?),
−
  x86_64_linux: Intel x86_64 with GNU/Linux
+
* type <code>L</code> to choose which language collections to install,
−
You can now choose to install some of these
+
* begin the installation process by typing <code>I</code>.
−
</pre>
 
  
−
Also, type <code>C</code> to choose what you want to install (maybe you don't want the Mongolian documentation to save some disk space?) and <code>L</code> to choose which language collections to install. Then, begin the installation process by typing <code>I</code>.
+
==== Post-Install (Linux/Mac OS X/Unix-like) ====
  
−
====Post-Install====
+
The first and most important thing you have to do after installation is add the new binaries to your <tt>$PATH</tt> variable. There are two ways to do this:
  
−
The first and most important thing you have to do after installation is add the new binaries to your <tt>$PATH</tt> variable. There are two ways to do this:
+
* at the first installation screen, you can choose as an option <code>create symlinks in standard directories</code>. If you choose this option, you create symbolic links to the new binaries in a directory that is already part of your <tt>$PATH</tt> such as <tt>/usr/local/bin</tt>;
 +
 
 +
* you can add the directory where TeX Live installs the binaries to your <tt>$PATH</tt>.
  
−
* at the first installation screen, you can choose as an option <code>create symlinks in standard directories</code>. If you choose this option, you create symbolic links to the new binaries in a directory that is already part of your <tt>$PATH</tt> such as <tt>/usr/bin</tt>;
+
Both ways have their advantages and drawbacks. Adding symlinks is probably faster and easier if you don't have much experience, but it may make uninstalling or reinstalling more troublesome in the future. Adding the directory where TeX Live binaries are to your <tt>$PATH</tt> depends heavily on shell you are using.
  
−
* you can add the standard directory where TeXLive installs the binaries to your <tt>$PATH</tt>.
+
In the past, we used to recommend adding the directory to <tt>$PATH</tt>, but nowadays that tlmgr tool does a pretty good job of keeping the installation in shape, there is no reason not to use it. It can add and remove the symlinks using menu option "Actions/Handle symlinks in system dirs ...".
  
−
Both ways have their advantages and drawbacks. Adding symlinks is probably faster and easier if you don't have much experience, but it may make uninstalling or reinstalling more troublesome in the future. I would recommend adding the new location to your <tt>$PATH</tt>. How to do this depends on the shell you're using; there's a thorough and simple tutorial at http://www.faqs.org/docs/Linux-mini/Path.html. TeXLive has its binaries in this location: <code>/usr/local/texlive/2007/bin/<architecture></code>, with <architecture> being the name of the system on which you're running (see above). Once you have set up your <tt>$PATH</tt> variable or added symlinks, make sure that your system finds the new binaries. One way to test this would be to run:
+
By default, TeX Live binaries will be installed to <code>/usr/local/texlive/2009/bin/<architecture></code>, with <architecture> being the name of the system on which you're running (see above). Once you have set up your <tt>$PATH</tt> variable or added symlinks, make sure that your system finds the new binaries. One way to test this would be to run:
  
 
<pre>which pdftex
 
<pre>which pdftex
Line 66: Line 67:
 
pdftex --version</pre>
 
pdftex --version</pre>
  
−
The output of the first command should point to the new binary, the output of the second command is, with the latest TeXLive installed:
+
The output of the first command should point to the new binary, the output of the second command is, with the latest TeX Live installed:
  
−
<pre>pdfTeX 3.141592-1.40.3-2.2 (Web2C 7.5.6)
+
<pre>pdfTeX 3.1415926-1.40.10-2.2 (TeX Live 2009)
−
kpathsea version 3.5.6
+
kpathsea version 5.0.0
−
Copyright 2007 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
+
Copyright 2009 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
−
Kpathsea is copyright 2007 Karl Berry and Olaf Weber.
 
 
There is NO warranty.  Redistribution of this software is
 
There is NO warranty.  Redistribution of this software is
 
covered by the terms of both the pdfTeX copyright and
 
covered by the terms of both the pdfTeX copyright and
Line 78: Line 78:
 
named COPYING and the pdfTeX source.
 
named COPYING and the pdfTeX source.
 
Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
 
Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
−
Kpathsea written by Karl Berry, Olaf Weber, and others.
+
Compiled with libpng 1.2.39; using libpng 1.2.39
 +
Compiled with zlib 1.2.3; using zlib 1.2.3
 +
Compiled with xpdf version 3.02pl3</pre>
  
−
Compiled with libpng 1.2.15; using libpng 1.2.15
+
==== Windows Installation ====
−
Compiled with zlib 1.1.4; using zlib 1.2.3
+
 
−
Compiled with xpdf version 3.01
+
TeX Live provides GUI installation on Windows that doesn't require any explanation at all.
−
</pre>
+
 
 +
==== Generating Formats ====
  
 
Once the new binaries are found, you want to generate the necessary formats. It has often been suggested that ConTeXt formats be managed by <code>texexec</code>, ''not'' by <code>fmtutil-sys</code>. If you want this (and I would say it is the better choice), first run (and again, add <code>sudo</code> if necessary)
 
Once the new binaries are found, you want to generate the necessary formats. It has often been suggested that ConTeXt formats be managed by <code>texexec</code>, ''not'' by <code>fmtutil-sys</code>. If you want this (and I would say it is the better choice), first run (and again, add <code>sudo</code> if necessary)
Line 89: Line 92:
 
<pre>fmtutil-sys --edit</pre>
 
<pre>fmtutil-sys --edit</pre>
  
−
in lines 68 and 69 of the file that opens, put the symbols <code>#!</code> in front of the line beginning with <tt> cont-en</tt> and <tt>cont-nl</tt>. Then, run <code>fmtutil-sys</code>:
+
in line 46 of the file that opens, put the symbols <code>#!</code> in front of the line beginning with <tt>cont-en pdftex</tt> and <tt>cont-en xetex</tt>. Then, run <code>fmtutil-sys</code>:
  
 
<pre>fmtutil-sys --all</pre>
 
<pre>fmtutil-sys --all</pre>
Line 97: Line 100:
 
<pre>texexec --make --all</pre>
 
<pre>texexec --make --all</pre>
  
−
This should create all necessary formats, include all available languages, and install in the right location. The latest TeXLive has resolved the problem with the <tt>$engine</tt> subdirectory that has bugged ConTeXt users so long. After generating the formats, run <code>texhash</code> again and verify that the format files are found:
+
This should create all necessary formats, include all available languages, and install in the right location. The latest TeX Live has resolved the problem with the <tt>$engine</tt> subdirectory that has bugged ConTeXt users so long. After generating the formats, run <code>texhash</code> again and verify that the format files are found:
  
−
<pre>kpsewhich --engine=pdftex cont-en.fmt
+
<pre>texhash
−
texhash
+
kpsewhich --engine=pdftex cont-en.fmt
−
/usr/local/texlive/2007/texmf-config/web2c/pdftex/cont-en.fmt
+
/usr/local/texlive/2009/texmf-config/web2c/pdftex/cont-en.fmt</pre>
−
</pre>
 
  
 
If you want to use <tt>XeTeX</tt> with ConTeXt as well, repeat the procedure for this format:
 
If you want to use <tt>XeTeX</tt> with ConTeXt as well, repeat the procedure for this format:
Line 109: Line 111:
 
texhash
 
texhash
 
kpsewhich --engine=xetex cont-en.fmt
 
kpsewhich --engine=xetex cont-en.fmt
−
/usr/local/texlive/2007/texmf-config/web2c/xetex/cont-en.fmt
+
/usr/local/texlive/2009/texmf-config/web2c/xetex/cont-en.fmt</pre>
−
</pre>
 
  
−
====Updating ConTeXt====
+
==== Updating ConTeXt ====
  
 
TeXLive in principle offers no option to update between release cycles. But of course, you will want to update ConTeXt as soon as Hans releases a new version. This is easy to achieve: the installation process has created a skeleton directory <tt>/usr/local/texlive/texmf-local</tt>. It is empty right after installation. cd to this directory, download the latest <tt>cont-tmf.zip</tt> from the pragma website. Then unzip this archive and run <pre>texexec --make --all</pre> again. This will update your installation and the formats to the latest available version. When you want to update again later, simply repeat the process, overwriting all older files when unzipping.  
 
TeXLive in principle offers no option to update between release cycles. But of course, you will want to update ConTeXt as soon as Hans releases a new version. This is easy to achieve: the installation process has created a skeleton directory <tt>/usr/local/texlive/texmf-local</tt>. It is empty right after installation. cd to this directory, download the latest <tt>cont-tmf.zip</tt> from the pragma website. Then unzip this archive and run <pre>texexec --make --all</pre> again. This will update your installation and the formats to the latest available version. When you want to update again later, simply repeat the process, overwriting all older files when unzipping.  
  
−
====texmfstart====
+
It's also possible to use [http://minimals.contextgarden.net/texlive TeX Live minimals repository] to replace bin-context*, context* and luatex* packages that are in TeX Live. In order to do so, use tlmgr's menu option "tlmgr/Load other repository ..." and point it to <tt>http://minimals.contextgarden.net/texlive/beta/</tt>.
−
 
 
−
One final step: once everything is in place, put a small textfile somewhere in your <tt>$PATH</tt> with these two lines:
 
−
<pre>#!/bin/sh
 
−
ruby /usr/local/texlive/texmf-local/scripts/context/ruby/texmfstart.rb $@
 
−
</pre>
 
−
 
 
−
This way, <tt>texexec</tt> will be called by texmfstart and stop complaining...
 
−
 
 
−
[[User:Thomas|Thomas]] 13:38, 3 February 2007 (CET)
 
  
 +
Written by [[User:Thomas|Thomas]] 13:38, 3 February 2007 (CET)
  
 +
Revised by [[User:Rivanvx|Vedran Miletić]] 13:12, 7 June 2010 (CET)
  
 
[[Category:Installation]]
 
[[Category:Installation]]

Revision as of 11:18, 7 June 2010

Installing TeX Live

TeX Live is a distribution that allows you to install TeX and friends on most operating systems. It comes with many, many additional packages, and for the time being, it is the only TeX distribution for all major OS (Windows, linux, OS X) that has regular updates. The release cycle is about once a year; the 2009 version was released in November 2009 (before that, it also had a release in 2008, 2007, 2005 and so on).

There is a number of ways to install TeX Live on your computer:

  • you can obtain DVDs that contain TeX Live from a TeX user group (e.g. details); if you're a member of such a group, you may have received a copy as part of your membership benefits;
  • you can use netinstall method; if you aren't doing full installation, it can save quite a bit of bandwidth;
  • you may find out that your Linux distribution already has TeX Live in it's repoistory; many distributions already switchted to TeX Live from teTeX (e.g. Debian, Ubuntu, openSUSE, Gentoo, Fedora, Arch; the same may be true for other distributions);

If you want to use the installation procedure provided by your distribution, refer to its documentation and skip the next section. This page will explain how to install TeX Live from the DVD.

Installation from the TeX Live DVD ISO images

Obtaining the Necessary Files

If you have a DVD, just pop it in. and skip to next subsection.

If you want to download the latest TeX Live release, point your browser to the nearest CTAN mirror and go to the directory systems/texlive/Images/. Download the latest ISO images. Please be warned that these images are huge (e.g. ISO image for TeX Live 2009 is 2,9 GiB), so if you're on a slow connection (e.g. modem), the download will take very long to complete.

Beginning and Customizing the Installation (Linux/MacOS X/Unix-like)

Once you have downloaded and saved the file, decompress it and mount it. The installation procedure is command-line based, so change to a terminal window, cd to the directory where the DVD or the TeX Live ISO has been mounted and start the installation process (on most systems, you will need root privileges to install, so either switch to a root terminal by typing su or precede the second line with sudo): 

cd /media/TeXLive2009
./install-tl

The installation process itself is pretty self-explanatory, so hre we mention just a few points that may be of interest:

  • be sure to type B in order to verify that your specific combination of architecture and operating system will be installed. Here is the list of architectures that are currently available:
    • alpha-linux (HP Alpha GNU/Linux)
    • hppa-hpux (HP-UX)
    • i386-cygwin (x86 Cygwin)
    • i386-linux (x86 GNU/Linux)
    • i386-netbsd (x86 NetBSD)
    • i386-solaris (x86 Solaris)
    • mips-irix (SGI IRIX)
    • powerpc-aix (IBM RS/6000 AIX)
    • powerpc-linux (PowerPC GNU/Linux)
    • sparc-linux (Sparc GNU/Linux)
    • sparc-solaris (Sun Sparc Solaris)
    • universal-darwin (MacOSX for both PowerPC and x86; bash.dmg available for bootstrap)
    • win32 (Windows 2000 and later)
    • x86_64-linux (x86 64-bit GNU/Linux)
  • type C to choose what you want to install (maybe you don't want the Mongolian documentation to save some disk space?),
  • type L to choose which language collections to install,
  • begin the installation process by typing I.

Post-Install (Linux/Mac OS X/Unix-like)

The first and most important thing you have to do after installation is add the new binaries to your $PATH variable. There are two ways to do this:

  • at the first installation screen, you can choose as an option create symlinks in standard directories. If you choose this option, you create symbolic links to the new binaries in a directory that is already part of your $PATH such as /usr/local/bin;
  • you can add the directory where TeX Live installs the binaries to your $PATH.

Both ways have their advantages and drawbacks. Adding symlinks is probably faster and easier if you don't have much experience, but it may make uninstalling or reinstalling more troublesome in the future. Adding the directory where TeX Live binaries are to your $PATH depends heavily on shell you are using.

In the past, we used to recommend adding the directory to $PATH, but nowadays that tlmgr tool does a pretty good job of keeping the installation in shape, there is no reason not to use it. It can add and remove the symlinks using menu option "Actions/Handle symlinks in system dirs ...".

By default, TeX Live binaries will be installed to /usr/local/texlive/2009/bin/<architecture>, with <architecture> being the name of the system on which you're running (see above). Once you have set up your $PATH variable or added symlinks, make sure that your system finds the new binaries. One way to test this would be to run: 

which pdftex

pdftex --version

The output of the first command should point to the new binary, the output of the second command is, with the latest TeX Live installed: 

pdfTeX 3.1415926-1.40.10-2.2 (TeX Live 2009)
kpathsea version 5.0.0
Copyright 2009 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
Compiled with libpng 1.2.39; using libpng 1.2.39
Compiled with zlib 1.2.3; using zlib 1.2.3
Compiled with xpdf version 3.02pl3

Windows Installation

TeX Live provides GUI installation on Windows that doesn't require any explanation at all.

Generating Formats

Once the new binaries are found, you want to generate the necessary formats. It has often been suggested that ConTeXt formats be managed by texexec, not by fmtutil-sys. If you want this (and I would say it is the better choice), first run (and again, add sudo if necessary) 

fmtutil-sys --edit

in line 46 of the file that opens, put the symbols #! in front of the line beginning with cont-en pdftex and cont-en xetex. Then, run fmtutil-sys: 

fmtutil-sys --all

This will generate all formats necessary for TeXing except the formats for ConTeXt. In the next step, we will let ConTeXt create its own formats. Run 

texexec --make --all

This should create all necessary formats, include all available languages, and install in the right location. The latest TeX Live has resolved the problem with the $engine subdirectory that has bugged ConTeXt users so long. After generating the formats, run texhash again and verify that the format files are found: 

texhash
kpsewhich --engine=pdftex cont-en.fmt
/usr/local/texlive/2009/texmf-config/web2c/pdftex/cont-en.fmt

If you want to use XeTeX with ConTeXt as well, repeat the procedure for this format: 

texexec --xtx --make --all
texhash
kpsewhich --engine=xetex cont-en.fmt
/usr/local/texlive/2009/texmf-config/web2c/xetex/cont-en.fmt

Updating ConTeXt

TeXLive in principle offers no option to update between release cycles. But of course, you will want to update ConTeXt as soon as Hans releases a new version. This is easy to achieve: the installation process has created a skeleton directory /usr/local/texlive/texmf-local. It is empty right after installation. cd to this directory, download the latest cont-tmf.zip from the pragma website. Then unzip this archive and run 

texexec --make --all

again. This will update your installation and the formats to the latest available version. When you want to update again later, simply repeat the process, overwriting all older files when unzipping.

It's also possible to use TeX Live minimals repository to replace bin-context*, context* and luatex* packages that are in TeX Live. In order to do so, use tlmgr's menu option "tlmgr/Load other repository ..." and point it to http://minimals.contextgarden.net/texlive/beta/.

Written by Thomas 13:38, 3 February 2007 (CET)

Revised by Vedran Miletić 13:12, 7 June 2010 (CET)

Retrieved from "https://wiki.contextgarden.net/index.php?title=TeX_Live_2009&oldid=11774"