6 Windows installation

TeX Live can be installed on systems running Windows 9x, ME, NT, 2K or XP. Older versions of Windows (3.1x) and MS-DOS are not supported.

It is necessary to have your Windows set up so that it uses the Microsoft Joliet extensions for reading CDs; simply look at the CD in Explorer and see whether it shows long, mixed-case, file names. If it does not, you must install the Joliet extensions.

The Windows TeX system included in TeX Live is no more and no less than the fpTeX distribution. It includes a dvi previewer, Windvi, which is similar in usage to the established Unix xdvi. The documentation can be found in texmf/doc/html/windvi/windvi.html.

6.1 The TeXLive.exe program


PIC

Figure 1: “Welcome to TeX Live” window

If your computer is configured to let the CD autostart, then a dialog box with a menu bar will popup on the screen, and you will have several choices from there:

If your CD does not autostart, you can explicitly run the program by double clicking on bin/win32/TeXLive.exe on the CD from the explorer window.

6.2 Running TeX Live directly from media (Windows)

It is possible to use the TeX system directly from the demo CD or the live DVD, without installing the distribution to disk. (Thus the name ‘TeX Live’, in fact.) It is not possible to run TeX directly from the inst CD (see section 2.1 on p. 10).

To run live under Windows, from the menu, chose Explore CD-Rom, then Run TeX off CD-Rom. This will launch the XEmacs editor.

XEmacs startup file will set the environment variables needed. XEmacs will also setup a temporary TDS compliant texmf tree in the temporary area of your computer. It is needed to store files that may be built on the fly, such as pk bitmap fonts, or format files. Configuration files are copied from the CD to this texmf tree, so that you can edit them if needed. The ls-R database is computed for this texmf tree. The AUC-TeX mode will be entered Whenever you will visit or create a TeX file, providing all the bells and whistles for TeX support XEmacs is capable of.

If you run ’M-x shell’ within XEmacs, then you will have access to all the TeXLive tools from the command line provided by XEmacs.

[For advanced users:] You can also use the small batch file mkloctex.bat to be called in a directory bin\win32 of the CD. From the Start menu select ‘Run’, then browse the CD drive and select mkloctex.bat. Before starting it, you should add two parameters separated by a space: the letter of your CD drive and the letter of the drive where you want to install the TeX directory. The whole line should read, e.g., d:\bin\win32\mkloctex.bat d c. When installation is complete, please read carefully the information on screen. If you are running Windows 9x/ME, then you will have to restart Windows.

6.3 Support packages for Windows

To be complete, a TeX Live installation needs support packages that are not commonly found on a Windows machine. Many scripts are written using the Perl language. Some important tools require the Ghostscript PostScript interpreter to render or to convert files. A graphic file toolbox is also needed in some cases. Last but not least, a TeX-oriented editor makes it easy to type in your TeX files.

All these tools are quite easy to find for Windows, but in order to try to make your life even easier, we have put such a set of tools on TeX Live:

These packages should be installed only all at once. The bundle is known as the XEmTeX bundle.

If you didn’t install XEmTeX, Perl and Ghostscript are installed anyway if they are not detected on your machine. This is because they are required by many important tools. The PERL5LIB and GS_LIB environment variables will be set too.

When you are under XEmacs, the tools provided shadow any other version you might have installed previously. The point here is that TeXSetup.exe will not install anything outside of the TeX Live location, neither will it run foreign installers, nor will it try to autodetect installed products using unreliable rules of thumb. The XEmTeX bundle is standalone and is meant to evolve in the future. The reference site is http://www.fptex.org/xemtex/.

If you don’t want to install this bundle, then you are on your own to install the required tools to complete your TeX Live system. Here is a list of places to get those tools:

Ghostscript
http://www.cs.wisc.edu/~ghost/
Perl
http://www.activestate.com/ (but you might need some supplementary packages from CPAN: http://www.cpan.org/)
ImageMagick
http://www.imagemagick.com
NetPBM
alternatively, you could use NetPBM instead of ImageMagick to process or convert your graphic files. NetPBM home page is http://netpbm.sourceforge.net/
TeX-oriented editors
There is a wide choice, and it is a matter of the user’s taste. Here is a selection:

You might want to install other tools that are not free1 and therefore not included on TeX Live, such as GSView, the Ghostscript companion to more conveniently view PS/PDF files. GSView is available from http://www.cs.wisc.edu/~ghost/gsview/ or any CTAN site.

6.4 Installing TeX Live to disk

Warning: Win9x users must ensure they have enough environment space before undertaking installation. The TeXSetup.exe program won’t change the environment size for them. A few environment variables will be created and it is possible you run out of environment space. Add "SHELL=<path>COMMAND.COM /E:4096 /P" in the config.sys file in order to increase your environment size.

Installation is started by letting the media autostart. The program run is TeXSetup.exe if you are using the inst disk. If you are using the live or the demo disk, you will have to select the item TeXLive Software from the menu, then the subitem Install on Hard Disk. This will invoke TeXSetup.exe. You can also find it in the bin/win32 directory and run it, if the autostart fails for any reason. TeXSetup.exe is a Windows wizard and it will display several pages while running.

Welcome Page
You can choose a quick installation from here. In this case, the installation will run without any human assistance from beginning to end, with all the default settings (Figure 2, at the top). If you have enough privileges (administrator or power user rights) under a Windows version where this is applicable, then you can decide to install the TeX Live for all users or for yourself only by checking the appropriate box. For installing the whole XEmTeX bundle (XEmacs, Ghostscript, Perl, ImageMagick and Ispell) you can check Install XEmTeX Support box.


The TeXSetup Wizard Source directories for the TeX Live files
PIC PIC
Figure 2: The TeX Live setup wizard

Source Page
This page is a bit complex. It will allow you to select two source directories for your TeX Live system (Figure 2, at the bottom). You will need a local source directory and possibly a remote source directory.

Why do we need both these directories? The files consisting of the TeX Live system are on the CD, of course, but some other useful packages are not, either because of space lacking or because their license was not compatible with TeX Live. You need to enable Internet downloading if you want to install these packages that are marked with a specific “remote” icon.

However, don’t panic: the default parameters of the setup will allow you to install a full system using the CD only. Simply, you won’t have WinEdt (for example), but you will be able to install it later.

So you can take your files from:

This option is available only if you enable Internet file downloading in the right part of the page. You also need to configure this Internet access by selecting to connect either using Internet Explorer 5 wininet.dll, or using a direct connection (ftp, http).

Root Page
On this page, you will tell where you want the files to be installed (Figure 3, at the top). Only the root directory really matters, the other ones are set according to the root one. You may want to make $TEXMFEXTRA point to some TDS compliant directory with other TeX files or assign a different value to $HOMETEXMF, which is set by default to whatever Windows think is your ‘HOME’ location.


Root and directories Scheme selection
PIC PIC
Figure 3: TeX Live-Setup: Root and directories / Schemes

Get TPM Page
This page does not require any manual intervention. The .tpm files which describe collections and packages are retrieved (possibly from the Internet), unzipped if needed and parsed.
Schemes Page
On this page, you will select the global scheme of your installation (Figure 3, at the bottom). A scheme is a large set of files targeted at some kind of usage. There are 3 generic schemes for basic, recommended and full installation. The other ones are devoted to LUGs (what GUST or GUTenberg propose for their members) or applications (XML and TeX). When a scheme is selected, it is still possible to refine the selection by checking the appropriate box. If doing so, you will be presented the packages page to change your selection, else you will jump to the review page.
Packages Page
Collections and packages are presented in a tree form (Figure 4, at the top). The links in the tree are dependency links. Collections depend on packages and maybe other collections, and it is the same for each package. You can select any package or collection individually, but your request will be granted only if the object is not requested by another one which is selected. For example, you can’t deselect tex-basic without deselecting all the collections that request it.

The tex-xemtex collection displayed on the picture is Win32 specific. It holds a number of bonus packages (Figure 4, at the bottom) which can be installed automatically and individually: Ghostscript (the PostScript interpreter), XEmacs editor preconfigured for TeX, tools like Perl, ImageMagick, Ispell. None of these packages are selected by default.

On this page, you also have the information about disk space needed, for each object, and for the set of those who are selected, and also the disk space available on the partition selected for the installation. Last, you can choose to install or not the documentation files and source files associated with each package.

Review Page
You will find there a summary of your choices (Figure 5, at the top). It is still possible to go back to change them.


Packages Page Win32 Support
PIC PIC

Figure 4: Packages Page / Win32 goodies

Files Copy Page
The selected files are copied on your hard disk (Figure 5, at the bottom). All the files not yet available on your local disk are first downloaded from the remote source directory on the Internet. Then every package is unpacked (if .zip files), or copied from the CD.
Configuration Page
Several packages need some configuration step to make them usable (Figure 6, at the top). Also the TeX Live system needs some post-processing step (format files generation, ls-R databases generation, environment variables, etc.). All these operations are done there, some of them can be lengthy.


Review Page File Copy Page
PIC PIC

Figure 5: Review Page / File Copy Page

Final Page
The installation being over, you may want to display the Windows specific documentation (HTML format) and / or the log file of the setup process (Figure 6 at the bottom). If it is needed (Win9x/WinME), you will be asked to reboot your computer.


Configuration Page Final Page
PIC PIC

Figure 6: Configuration Page / Final page

Please be aware that the choice of cluster size on DOS disk partitions can radically affect the size of your TeX installation. The support tree has hundreds of small files, and it is not unusual for a complete installation to take up to four times the amount of space used on the CD.