DRI INSTALLATION SCRIPT README FILE By Frank Worsley CONTENTS ============================ 1. Introduction 2. Installation 2.1 Basic Installation 2.2 Restoring Files 2.3 The Extras Package 3. Testing 4. Common Problems 1. INTRODUCTION ============================ The DRI project now provides binary installation packages to make it easier for users to upgrade their drivers. We have chosen to create generic TAR.GZ packages so they will work with all distributions of Linux and other operating systems. You MUST be running at least XFree86 v4.1 before attempting to use these packages. So ensure you upgrade from your distribution provider first if you are running an older version of XFree86. If you are interested in creating packages for other operating systems, architectures or distribution formats send a message to the dri-devel mailing list. We will help you get started, any help is greatly appreciated. 2. INSTALLATION OPTIONS ============================ 2.1 BASIC INSTALLATION ---------------------------- Once you have downloaded the installation package use the following commands to extract it: tar -xvzf .tar.gz Where is the name of the package you have downloaded, for example "r128-20010405-i386-Linux". Running the above commands will extract the package into a "dripkg" directory. To install the package do this: cd dripkg ./install.sh Then follow the instructions of the install script. Read all questions carefully and make sure you answer them correctly. The defaults should be correct in most cases. NOTE: the force option is deprecated and libGL files found elsewhere will be moved to old.* and symbolic links will be created to point to the newly installed ones. 2.2 RESTORING FILES ---------------------------- If you have problems with your X server or the DRI after installing the latest drivers you can restore previous files by running the install script with the 'restore' option: ./install.sh restore This will restore all files replaced during the normal installation. 2.3 THE EXTRAS PACKAGE ---------------------------- The Extras package contains additional files that may be needed for the installation. If you have trouble starting your X server after the installation you should download the Extras package. Download the package to the same directory as the DRI driver package and then install it as follows: tar -xvzf .tar.gz cd dripkg ./install.sh Where is the name of the Extras package, for example "Extras-i386-Linux". The install.sh script will automatically install the extra files needed. Note that the restore option of the install script will not restore files changed by the Extas package. 3. TESTING ============================ Also in an experimental stage is a DRI setup program that will test the current installation for correct operation. This setup tool will offer some dianostic and repair options for ensuring that you can run in Direct Rendering Mode. This program will be enhanced to catch as many possible setup problem scenarios as possible in future releases and will also offer the ability to download the latest binary packages for you. Ensure you download the correct one for you architecture. Once you have downloaded the 'DRIsetup' tool, make sure it's executable bit is set with 'chmod +x DRIsetup'. Then run the tool within your X session as the 'root' superuser. Please provide feedback to Alan Hourihane regarding any issues with this new tool. 4. COMMON PROBLEMS ============================ If your X server will not start after the installation of the latest drivers download and install the Extras package. It will update your X server binary to a more recent version.