As introduced in section 1.1 on p. 8, TeX Live has three principal uses:
The following sections describes the Unix-specific procedures for each of these.
Warning: The TeX-Collection CDs and DVD are in ISO 9660 (High Sierra) format, with Rock Ridge (and Joliet,
for Windows) extensions. Therefore, in order to take full advantage of the TeX-Collection under Unix, your
system needs to be able to use the Rock Ridge extensions. Please consult the documentation for your
mount command to see how to do this. If you have several different machines on a local network,
you may be able to mount the CDs on one which does support Rock Ridge, and use this with the
others.
Linux, FreeBSD, Sun, SGI and Alpha systems should be able to use the CDs without problems. We would appreciate receiving detailed advice from users on other systems who succeed, for future versions of this documentation. The discussion below assumes you have been able to mount the CDs with full Rock Ridge compatibility. |
Only Linux, Mac OS X, and Windows binaries are included on the demo CD; if you want to run live on other Unix systems, you’ll need to use the DVD.
To start, we must mount the CD or DVD, with Rock Ridge extensions enabled. The exact command to do this varies from system to system; the following works under Linux, except the name of the device ( /dev/cdrom, here) may vary. (All our examples will use > as the shell prompt; user input is underlined.)
Change the current directory to the mount point:
Under Mac OS X, the directory is typically under /Volumes, and the media will be mounted automatically.
Run the installation script install-tl.sh:
After various greeting messages and a list of the main menu options, the installation will ask you to enter a command. Do this by typing the desired character and hitting return; don’t type the angle brackets. Either uppercase or lowercase is ok; we’ll use lowercase in our examples.
For running live, our first command will be d and then the subcommand 1 to set directories. Even in this case, we must choose a directory on the local disk to place files that the TeX system itself generates, such as fonts and formats, and also to provide a place for updated configuration files, if need be. We’ll use /usr/local/texmf-local in this example. (If the default value of /usr/TeX works for you, then you can skip this step.)
Back at the main menu, our second and last command is r, to set up for running live off the media without installing to disk:
And we are back at the system prompt, as shown.
Next, it is necessary to alter two environment variables: PATH, to an architecture-dependent value (so that we can run the programs), and VARTEXMF, to the value specified above. See table 1 for a list of the architecture names for the different systems, and whether they are available on the demo CD. All systems are available in the inst and live distributions. (In addition to the version-specific names listed here, there are generic names without the version numbers. For instance, sparc-solaris links to sparc-solaris2.7. The generic names can be used to protect against the version numbers changing in the future, if you wish.)
After the main installation has completed, and environment variables have been set, the next step is to run texconfig to customize your installation for your needs. This is explained in section 4.1, p. 29.
|
The syntax for setting the environment variables, and the initialization file to put them in, depends on the shell you use. If you use a Bourne-compatible shell (sh, bash, ksh, et al.), put the following into your $HOME/.profile file:
For C shell-compatible shells (csh, tcsh), put the following into your $HOME/.cshrc file:
Then log out, log back in, and test your installation (see section 4.2 on p. 30).
If in doubt, please ask any local system gurus to help you with problems; for example, the way to mount the TeX Live media, which directory or directories to use, and precise details of the changes to your personal initialization files can and do vary from site to site.
It is possible, indeed typical, to install the TeX system from the TeX Live to disk. This can be done either from the live DVD, or the inst CD. It can also be done from the demo CD, if you don’t need the omitted packages or systems. (See section 2.1 on p. 10 for an explanation of the different distributions.)
To start, we must mount the CD or DVD, with Rock Ridge extensions enabled. The exact command to do this varies from system to system; the following works under Linux, except the name of the device ( /dev/cdrom, here) may vary. (All our examples will use > as the shell prompt; user input is underlined.)
Change the current directory to the mount point:
Under Mac OS X, the directory is typically under /Volumes, and the media will be mounted automatically.
Run the installation script install-tl.sh:
After various greeting messages and a list of the main menu options, the installation will ask you to enter a command. Do this by typing the desired character and hitting return; don’t type the angle brackets. Either uppercase or lowercase is ok; we’ll use lowercase in our examples.
Here is an introductory list of the options in the main menu. The order in which you select the options makes little difference, except that i must be last. It’s reasonable to go through them in the order presented here.
|
Here are further details on each option.
p – Current platform. Since the installation script automatically guesses which platform you’re running on, this is generally unnecessary to override. It’s there in case the automatic detection fails.
b – Binary architectures. By default, only the binaries for your current platform will be installed. From this menu, you can select installation of binaries for other architectures as well (or not install the current platforms). This is often useful if you are sharing a TeX tree across a network of heterogenous machines. For a list of the supported architectures, see table 1, p. 19.
s – Base installation scheme. From this menu, you can choose an overall common set of packages. The default is a recommended set for typical needs, but you can also choose a basic set to conserve disk space, or a full set to get absolutely everything. The Live scheme is used for creating the TeX Live demo distribution itself, and isn’t generally useful to select for a particular site. There are also specific sets for Omega and XML users.
c – Individual collections. From this menu, you can override the basic scheme’s choice of which collections to install. Each collection — TeX macro files, Metafont font families, and so on — consists of several packages. In this menu, selection letters are case-sensitive.
l – Language collections. This menu has the same basic functionality as c, to override collection choices. In this case, the collections are specifically for different languages. Selection letters are case-sensitive here. Here is a list of the language collections in TeX Live:
(some) African scripts | Armenian | Chinese,Japanese,Korean | Croatian |
Cyrillic | Czech/Slovak | Danish | Dutch |
Finnish | French | German | Greek |
Hungarian | Indic | Italian | Latin |
Manju | Mongolian | Norwegian | Polish |
Portuguese | Spanish | Swedish | Tibetan |
UK English | Vietnamese |
Language collections typically includes fonts, macros, hyphenation patterns, and other support files. (For instance, frenchle.sty is installed if you select the French collection.) In addition, installing a language collection will alter the language.dat configuration file controlling which hyphenations are loaded.
d – Installation directories. Three directories can be changed here:
Under Mac OS X, the usual frontends look for TeX in /usr/local/teTeX, so you may wish to install TeX Live there.
o - General options. From this menu, you can select three general options affecting the installation:
i - Perform installation. When you’re satisfied with your configuration options, enter i to actually do the installation from the media to your chosen locations.
The last step is to include the architecture-specific subdirectory of TEXDIR/bin in your PATH, so the newly-installed programs can be found. The architecture names are listed in table 1, p. 19, or you can simply list the directory TEXDIR/bin.
The syntax for doing this, and the initialization file to put it in, depends on the shell you use. If you use a Bourne-compatible shell (sh, bash, ksh, et al.), put the following into your $HOME/.profile file:
For C shell-compatible shells (csh, tcsh), put the following into your $HOME/.cshrc file:
After the main installation has completed, and environment variables have been set, the next step is to run texconfig to customize your installation for your needs. This is explained in section 4.1, p. 29.
Here is a brief annotated example which selects a full installation, with binaries for the current system only, with directory changes as recommended above. The prompts and RETURN keys are omitted for brevity.
If in doubt, please ask any local system gurus to help you with problems; for example, the way to mount the TeX Live media, which directory or directories to use, and precise details of the changes to your personal initialization files can and do vary from site to site.
You can add individual packages or collections from the current distribution to an existing non-TeX Live setup, or an earlier TeX Live installation. You can do this from the demo CD or the live DVD, but not from the inst CD. (See section 2.1 on p. 10.)
To start, we must mount the CD or DVD, with Rock Ridge extensions enabled. The exact command to do this varies from system to system; the following works under Linux, except the name of the device ( /dev/cdrom, here) may vary. (All our examples will use > as the shell prompt; user input is underlined.)
Change the current directory to the mount point:
Under Mac OS X, the directory is typically under /Volumes, and the media will be mounted automatically.
Run the installation script install-pkg.sh (not install-tl.sh, which is intended for complete installations only):
This first set of options controls what gets read:
What actually happens is controlled by the following options. If neither of these are specified, the default action is to install the selected files. The main destination tree is found by expanding $TEXMFMAIN with kpsewhich. You can override it by setting either the environment variable TEXMFMAIN or TEXMF.
Additional options:
Here are some usage examples:
If in doubt, please ask any local system gurus to help you with problems; for example, the way to mount the TeX Live media, which directory or directories to use, and precise details of the changes to your personal initialization files can and do vary from site to site.