You can use the TeX Live CD-ROM in three ways:
Each of these methods is described in more detail in the following sections.
Warning: This CD-ROM is in ISO 9660 (High Sierra) format, with Rock Ridge and Joliet extensions. In order to take full advantage of the CD-ROM on a Unix system, your system needs to be able to use the Rock Ridge extensions. Please consult the documentation for your mount command to see if it is possible. If you have several different machines on a local network, see if you can mount the CD-ROM on one which does support Rock Ridge, and use this with the others.
Linux, FreeBSD, Sun, SGI and DEC Alpha systems should be able to use the CD-ROM with no problems. We would appreciate receiving detailed advice from other system users who also succeed, for future versions of this documentation.
The discussion below about installation assumes you have been able to mount the CD-ROM with full Rock Ridge compatibility.
The organisation of Web2c means that you can run programs simply by adding the appropriate directory under bin on the CD-ROM to your PATH, and the support files will all be found with no further ado. The following shows the list of available systems and the corresponding directories.
|
You may worry that when you subsequently make fonts or change configuration, things will go wrong because you cannot change files on the CD-ROM. However, you can maintain a parallel, writeable, TeX tree on your hard disk; this is searched before the main tree on the CD-ROM. The default location is /usr/TeX.local, but you can override this by setting the TEXMFLOCAL environment variable.
Thus sh or bash users on an Intel PC running Linux can mount the TeX Live CD-ROM on /cdrom by issuing the command:
If in doubt, ask your local system support guru to help you work out how to mount your CD-ROM or which directory to use for your system.
Appropriate support files will be installed on your hard disk the first time you need them. It is a good idea to immediately run the texconfig script to initialize things, and check it all works.
All of the necessary steps to install all or part of the distribution on your hard disk are achieved by mounting the CD-ROM, changing to the top-level directory, and typing:
Initializing collections... Done.
Counting selected collections... Done.
You choose options by typing a letter or number and pressing `return'. In the example, a Linux ELF system has been detected, the default of all collections to recommended level has been chosen, and the default installation directory is /usr/local; note that the disk space required for the current installation configuration is also displayed. If you make a suggested setup, you need about 100 megabytes of disk free; however, the basic setup will only take about 10 megabytes, and you can enhance it with selected packages as you need them.
Under the directory you choose for installation, the installation script will put the binaries in a subdirectory of bin, and the support tree in texmf.
|
When you choose <C> for `collections', you will see the display of available collections,
the level of installation selected, and the disk space required (Figure 1(b)). You can set
alternative levels of installation for each collection, ranging from none to all. You can either set
this for all collections at once, or choose a particular collection and set its level (Figure
1(c)).
When you are finished, return to the main screen, and ask the installation to start. It will take each of the collections and systems that you requested, consult the list of files on the CD-ROM, and build a master list of files to transfer. These will then be copied to your hard disk. If you installed a system, an initialization sequence is now run (creating format files, etc.). When this has finished, all you need do is add the correct subdirectory of bin in the TeX installation to your path, and start using TeX. If you want, you can move the binaries up one level, e.g. from /usr/local/bin/alpha-osf3.2 to /usr/local/bin; if you do this, however, you must edit texmf/web2c/texmf.cnf (see Appendix A) and change line 50:
toIf you move the binaries to another directory tree entirely, you need to edit TEXMFMAIN to specify the support tree explicitly, and set TEXMFCNF in your environment to $TEXMFMAIN/texmf/web2c.
You may want to use the TeX Live CD-ROM to either update an existing setup, or add features to an earlier installation from the CD-ROM. The main installation program is intended for the first time only, and subsequently you should use the install-pkg.sh script on the CD-ROM. Run this by mounting the CD-ROM, changing to the mounted directory, and typing
The script supports nine options; the first four let you set the individual package you want to install, the whole collection (i.e., ams2), the name of the mounted CD-ROM directory, and the name of the directory containing the list files (normally these latter two will be set automatically):
--package=name | |
--collection=name | |
--cddir=name | |
--listdir=name | |
What actually happens is controlled by four more switches; the first two allow you to exclude documentation or source files from the installation, the third stops the default action of running mktexlsr on completion to rebuild the file database, and the last does nothing but list the files that would be installed:
--nodoc | |
--nosrc | |
--nohash | |
--listonly | |
Finally, you can specify that, instead of installing the files, the script should make a tar archive in a specified location:
--archive=name | |
Thus, if we simply wanted to see the files that make up the package fancyhdr before we installed it, our command and output would be as follows:
After the installation program has copied all files to their final locations, you can use a program called texconfig that allows you to configure the system to fit your local needs. This can be called at any other time to change your setup, with a full-screen (which requires the dialog program) or command-line interface. It should be used for all maintenance, such as changes of installed printers, or rebuilding the file database. Both modes have help text to guide you through the facilities.