Release Notes for XFree86[TM] 3.3.2 : Installing the XFree86 3.3.2 Release
Previous: Known Problems
Next: Release Notes for XFree86[TM] 3.3.2

## 4. Installing the XFree86 3.3.2 Release

The XFree86 3.3.2 binaries are distributed as both a full release and as an upgrade to XFree86 3.3.1.

NOTE: the X servers are no longer installed setuid root. If you are starting your X servers with startx/xinit, or something similar, you will need a copy of the setuid Xwrapper, and an updated xinit. These can be found in X332upd.tgz for those upgrading from 3.3.1, and in X332bin.tgz for those doing a full install.

What follows is a list of the XFree86 3.3.2 components. There may be some variations in this for some OSs.

The following are required for all new installations or upgrades from versions prior to 3.3.1:

>     preinst.sh      Pre-installation script
>     postinst.sh     Post-installation script
>     extract         XFree86 extraction utility
>     X332bin.tgz     Clients, run-time libs, and app-defaults files
>     X332doc.tgz     Documentation
>     X332fnts.tgz    75dpi, misc and PEX fonts
>     X332lib.tgz     Data files required at run-time
>     X332man.tgz     Manual pages
>     X332set.tgz     XF86Setup utility
>     X332VG16.tgz    16 colour VGA server (XF86Setup needs this server)

The following are required for an upgrade from XFree86 3.3.1:

>     preinst.sh      Pre-installation script
>     postinst.sh     Post-installation script
>     extract         XFree86 extraction utility
>     X332upd.tgz     Changes since 3.3.1 (except the servers)
>     X332doc.tgz     Documentation
>     X332set.tgz     XF86Setup utility
>     X332VG16.tgz    16 colour VGA server (XF86Setup needs this server)

The following is required for new installations, and optional for existing installations:

>     X332cfg.tgz     sample config files for xinit, xdm

NOTE: Be very careful about installing X332cfg.tgz over an existing installation if you have customised your xinit and/or xdm config files. Installing X332cfg.tgz will overwrite any existing files. If you do have customised files, there is no need to install X332cfg.tgz.

NOTE: The bitmap fonts distributed with this release are compressed using gzip rather than compress. This means that you will probably want to remove the old versions (after backing them up). The Xservers and font server in releases prior to 3.2A cannot read gzipped fonts, so keep a copy of the old fonts if you wish to run older servers.

The following X servers are for PC/AT based hardware (i.e., typical Intel ix86 based PCs). Choose at least one which matches your hardware, as well as the VGA16 server. The VGA16 server is required by the new configuration utility (XF86Setup).

>     X3328514.tgz    8514/A server
>     X332AGX.tgz     AGX server
>     X332I128.tgz    I128 server
>     X332Ma32.tgz    Mach 32 server
>     X332Ma64.tgz    Mach 64 server
>     X332Ma8.tgz     Mach 8 server
>     X332Mono.tgz    Mono server
>     X332P9K.tgz     P9000 server
>     X332S3.tgz      S3 server
>     X332S3V.tgz     old S3 ViRGE server (please use SVGA server)
>     X332SVGA.tgz    SVGA server
>     X332VG16.tgz    16 colour VGA server (XF86Setup needs this server)
>     X332W32.tgz     ET4000/W32, ET6000 server

The following X servers are available for Alpha hardware:

>     X332Ma64.tgz    Mach 64 server
>     X332Mono.tgz    Mono server (generic driver only)
>     X332P9K.tgz     P9000 server
>     X332TGA.tgz     DEC 21030 (TGA) server
>     X332S3.tgz      S3 server
>     X332S3V.tgz     old S3 ViRGE server (please use SVGA server)
>     X332SVGA.tgz    SVGA server (Matrox Millennium driver only)

The following X servers are for PC98 hardware. If you have a PC98 machine, choose one which suits your hardware. If you don't know what a PC98 machine is, you don't need any of these.

>     X3329NS3.tgz    PC98 NEC(S3) server
>     X3329SPW.tgz    PC98 PCSKB-PowerWindow(S3) server
>     X3329LPW.tgz    PC98 PowerWindowLB(S3) server
>     X3329EGC.tgz    PC98 EGC(generic) server
>     X3329GA9.tgz    PC98 GA-968V4/PCI(S3 968) server
>     X3329GAN.tgz    PC98 GANB-WAP(cirrus) server
>     X3329480.tgz    PC98 PEGC-480(generic) server
>     X3329NKV.tgz    PC98 NKV-NEC(cirrus) server
>     X3329WS.tgz     PC98 WABS(cirrus) server
>     X3329WEP.tgz    PC98 WAB-EP(cirrus) server
>     X3329WSN.tgz    PC98 WSN-A2F(cirrus) server
>     X3329TGU.tgz    PC98 TGUI server
>     X3329MGA.tgz    PC98 MGA server
>     X3329SVG.tgz    PC98 CLGD755x server
>     X3329set.tgz    PC98 XF98Setup utility

The following are optional.

>     X332f100.tgz    100dpi fonts
>     X332fcyr.tgz    Cyrillic fonts
>     X332fnon.tgz    Other fonts (Chinese, Japanese, Korean, Hebrew)
>     X332fscl.tgz    Scalable fonts (Speedo and Type1)
>     X332fsrv.tgz    Font server and config files
>     X332prog.tgz    X header files, config files and compile-time libs
>     X332nest.tgz    Nested X server
>     X332vfb.tgz     Virtual framebuffer X server
>     X332prt.tgz     X Print server
>     X332ps.tgz      PostScript version of the documentation
>     X332html.tgz    HTML version of the documentation
>     X332jdoc.tgz    Documentation in Japanese (for version 3.2)
>     X332jhtm.tgz    HTML version of the documentation in Japanese (3.2)
>     X332lkit.tgz    X server LinkKit
>     X332lk98.tgz    X server LinkKit for PC98 servers

If you already have a version of XFree86 installed, MAKE A BACKUP OF `/usr/X11R6` BEFORE DOING ANYTHING ELSE. The standard installation procedure will overwrite your existing version of XFree86.

If you are installing from scratch, create a directory called `/usr/X11R6`, then extract the required `.tgz` files. If you don't have enough space in `/usr` for this, create a directory elsewhere and create a symbolic link to it. E.g., if you create a directory in `/home`:

> `

>     	mkdir /home/X11R6
>     	ln -s /home/X11R6 /usr

> `

The next step is to run the pre-installation script. This script makes some preliminary checks of your system. For some OSs, it may tell you to install new versions of some system components before proceeding with the installation. This script may also remove some outdated files and symbolic links from a previous installation that could cause problems.

For the purposes of these installation instructions, it is assumed that you have downloaded all the files to the `/var/tmp` directory. If you've put them in another directory, that's fine -- just replace all occurrences of ```/var/tmp`'' with the name of that directory.

To run the pre-installation script, go to `/usr/X11R6` and run it:

> `

>     	cd /usr/X11R6
>     	sh /var/tmp/preinst.sh

> `

The next step is to make the installation utility executable. To do this, make sure the `extract' file is in the same directory as all the X332*.tgz files, and run the following from that directory:

> `

>     	chmod 755 extract

> `

The installation utility ``extract'' is used to unpack the .tgz files that make up the XFree86 distribution. The .tgz files are gzipped tar files. However, ``tar'' in its standard form on most OSs is not well-suited to the task of installing XFree86. The extract utility is a modified version of GNU tar 1.12 built with the options required to make it suitable for installing XFree86. The source for extract is available from the same place you got the XFree86 distribution.

It is strongly recommended that you use the provided extract utility to unpack the XFree86 distribution. If you choose to ignore this and use something else, we don't want to hear from you if you run into problems. It is also important that you do not rename the extract utility. If renamed, it behaves just like the normal GNU tar.

To extract the XFree86 binaries, run the following as root:

> `

>     	cd /usr/X11R6
>     	/var/tmp/extract /var/tmp/X332*.tgz

> `

Once the required `.tgz` files have been extracted, run the post installation script:

> `

>     	cd /usr/X11R6
>     	sh /var/tmp/postinst.sh

> `

For OSs which use ldconfig, you may need to run ldconfig or reboot to complete the installation. The postinst.sh script should run ldconfig correctly for you if you are using Linux, FreeBSD, NetBSD or OpenBSD. For other OSs that use ldconfig, check how it normally gets run at boot time.

    $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/RELNOTE.sgml,v 3.59.2.37 1998/02/28 13:00:00 dawes Exp $

Release Notes for XFree86[TM] 3.3.2 : Installing the XFree86 3.3.2 Release
Previous: Known Problems
Next: Release Notes for XFree86[TM] 3.3.2