Network TeX Live installations for Windows clients

TeX Live is designed for shared use. You can install TeX Live on a network for use on client workstations. All it takes is adding TeX Live to the searchpath.

On Windows, a bit more is expected: double-clicking a file should open it in the right program, and there should be menu shortcuts. There should also be an installer which takes care of this, and an uninstaller.

From this page you can download such a client installer and uninstaller.

The installer makes use of building blocks which are already present in the TeX Live installation, viz. the TeX Live Perl libraries and the built-in hidden Perl installation.

The client installer scripts

The current installer should work with the 2011- and 2012 editions of TeX Live. Although it should work as-is, the file w32client offers some customization options.

All changes are made for the user, not for the workstation. This implies that in a roaming profile setup the configuration is available from any computer on the network, and that the user needs no particular rights on the workstation.

The zipfile w32client.zip contains the following:

w32client
The 2011/2012 client installer Perl script
w32client.bat
A batchfile running the above Perl script, using the private built-in Perl
w32unclient.vbs
The 2011/2012 client uninstaller vbscript
README
Contains additional details.

Notes. The 2012 version is much more complicated than the 2011 version. This has two reasons:

Warning. You can also use this script for a DVD installation. However, if TeX Live is in the root of the DVD then you may get double slashes D:\\ in shortcuts and file associations. Everything appears to work just fine, though.

This is a bug in the TeXLive::... Perl libraries from the DVD release, and will hopefully get fixed in a future update of the TeX Live Perl modules.

You can also still download zipfiles for 2010 and for 2009.

Requirements of the network installation

The prototype script assumes a standard directory layout:

parent---YYYY
   |       |
   |       +---bin---win32
   |       +---texmf
   |       +---texmf-dist
   |       +---texmf-config
   |       +---texmf-var
   |       +---tlpkg
   |
   +---texmf-local

or

parent
   |
   +---bin---win32
   +---texmf
   +---texmf-dist
   +---texmf-config
   +---texmf-var
   +---tlpkg
   |
   +---texmf-local

The w32client scripts assume that they are in the root of the installation, i.e. in parent\YYYY or in parent if there is no year component.

Sticking to such default directory layouts minimizes configuration hassles: all files can be located relative to the binaries, without environment variables beyond the searchpath.

Caveats

Search path

If a workstation already has a locally installed TeX and if its binaries are on the system path, then the locally installed TeX will be found first. This cannot be fixed by only changing the user path.

Even if the searchpath cannot be fixed generally, it can be fixed for individual shortcuts, by prepending its searchpath with the TeX Live binaries. E.g. the TeXworks shortcut will always find our TeX Live first. The installer also creates a shortcut for a command prompt with such a modified searchpath.

Local policies

Windows system administrators have a rich array of tools for restricting user's rights. Check whether everything works, not just for yourself, but also for the target group.

Dviout help

Dviout help may be inaccessible because of restrictive internet permissions. Users can copy TeX Live Root\tlpkg\dviout\dvioute.chm to their local harddisk and open this copy, or you can ask the sysadmin to do something about it.

Roaming

Windows does not include every piece of user configuration in the roaming profile. In particular, file associations are only stored on the workstation itself. Possible workarounds:

XeTeX font caches

See the README in the zipfile if users need their own individual font caches.

Copyright (C) 2011, 2012 Siep Kroonenberg
s i e p o   at   c y b e r c o m m   dot   n l

Last revised on June 27 2012