home *** CD-ROM | disk | FTP | other *** search
/ PCMania 8 / PCM8.iso / XFREE86 / Linux-ix86-glibc20 / Install < prev    next >
Encoding:
Text File  |  2000-05-08  |  15.4 KB  |  328 lines
  1.                   Installation Details for XFree86[tm] 4.0
  2.  
  3.                           The XFree86 Project, Inc
  4.  
  5.                               29 February 2000
  6.  
  7.                                   Abstract
  8.  
  9.      This document contains information about installing XFree86 4.0.
  10.  
  11. 1.  Introduction
  12.  
  13. This document contains information about installing XFree86 4.0 binary dis-
  14. tributions as provided by The XFree86 Project.  The installation procedures
  15. for binary distributions provided by others may be different.
  16.  
  17. The XFree86 binary distributions that we provide for UNIX-like OSs are pack-
  18. aged in the platform-independent gzipped tar format (referred to as "tar-
  19. balls").  Our tarballs can be identified by the ".tgz" suffix.  We do not
  20. provide binaries in RPM format or any other platform specific package format.
  21. If you need them in such a format, you should contact your OS vendor.
  22. Together with the binary distributions, we provide a customised version of
  23. GNU tar called "extract", and an installation script.  We recommend that
  24. these be used to install the binary distributions.
  25.  
  26. 2.  How to get the XFree86 4.0 binary distributions
  27.  
  28. We, The XFree86 Project, provide XFree86 4.0 binaries for a range of operat-
  29. ing systems at our ftp site <URL:ftp://ftp.xfree86.org/pub/XFree86/4.0/bina-
  30. ries/>.  Our ftp site is also mirrored by many sites around the world.  There
  31. is a sub-directory for each OS/platform that we have binaries for.  The first
  32. thing you need to do is to decide which of these suits you.  In most cases,
  33. the choice is straightforward.  In some cases (e.g., Linux) there may be a
  34. number of choices depending on what architecture or libc version you are
  35. using.  We recommend that you first download the Xinstall.sh script, and run
  36. it as follows to find out which binary distribution you should download.
  37.  
  38.      sh Xinstall.sh -check
  39.  
  40. This should tell you which binary distribution is the correct one for your
  41. system.  Getting this right may save from wasting time downloading the wrong
  42. distribution.
  43.  
  44. The next step is to download the necessary files.  The mandatory files for
  45. all installations are listed below.  All of them must be downloaded to do the
  46. installation.  The installer script will complain if they are not all pre-
  47. sent.
  48.  
  49.           Xinstall.sh      The installer script
  50.           extract          The utility for extracting tarballs
  51.           Xbin.tgz         X clients/utilities and run-time libraries
  52.           Xlib.tgz         Some data files required at run-time
  53.           Xman.tgz         Manual pages
  54.           Xdoc.tgz         XFree86 documentation
  55.           Xfnts.tgz        Base set of fonts
  56.           Xfenc.tgz        Base set of font encoding data
  57.           Xetc.tgz         Run-time configuration files
  58.           Xvar.tgz         Run-time data
  59.           Xxserv.tgz       XFree86 X server
  60.           Xmod.tgz         XFree86 X server modules
  61.  
  62. NOTES:
  63.  
  64.    o Some web browsers have a problem downloading the extract utility cor-
  65.      rectly.  If you encounter this problem, download the version called
  66.      extract.exe instead.  The ".exe" suffix is only there to make the trou-
  67.      blesome web browsers do the right thing.  It is not a DOS/Windows exe-
  68.      cutable.
  69.  
  70.    o A few distributions don't have or require the Xvar.tgz tarball.  If it
  71.      is present in the binaries sub-directory for your platform, then it is
  72.      required.
  73.  
  74.    o Some distributions may have additional mandatory tarballs.  This is
  75.      rare.  In these cases, the installer script will tell you if any are
  76.      missing.
  77.  
  78. The following tarballs are optional.  You should download the ones you want
  79. to install.
  80.  
  81.           Xfsrv.tgz        Font server
  82.           Xnest.tgz        Nested X server
  83.           Xprog.tgz        X header files, config files and compile-time libs
  84.           Xprt.tgz         X Print server
  85.           Xvfb.tgz         Virtual framebuffer X server
  86.           Xf100.tgz        100dpi fonts
  87.           Xfcyr.tgz        Cyrillic fonts
  88.           Xflat2.tgz       Latin-2 fonts
  89.           Xfnon.tgz        Some large bitmap fonts
  90.           Xfscl.tgz        Scalable fonts (Speedo and Type1)
  91.           Xhtml.tgz        HTML version of the documentation
  92.           Xps.tgz          PostScript version of the documentation
  93.           Xjdoc.tgz        Documentation in Japanese
  94.  
  95. NOTES:
  96.  
  97.    o Some distributions may have some additional optional tarballs.
  98.  
  99. If you miss some and want to install them later, you can do so by following
  100. the appropriate part of the section that describes manual installation.
  101.  
  102. 3.  Installing XFree86 4.0 using the Xinstall.sh script
  103.  
  104. We strongly recommend that our XFree86 4.0 binary distributions be installed
  105. using the Xinstall.sh script that we provide.  The main reason that we make
  106. this recommendation is that there are a lot of steps in the manual installa-
  107. tion process, and those steps can vary according to the situation.  There is,
  108. however, a description of the manual installation process for the most common
  109. cases below for those who might need it.
  110.  
  111. Put all of the downloaded files into a single directory (choose some tempo-
  112. rary location with enough space).  Become the super user (root), cd to that
  113. directory, then run the installer script as follows:
  114.  
  115.      sh Xinstall.sh
  116.  
  117. Answer the prompts that come up.  If you are missing something that is
  118. required to run this version of XFree86, the installer may tell you to
  119. install it before trying again.  If you don't have all of the mandatory files
  120. listed above, then the installer will tell you which ones are missing and ask
  121. you to download them before trying again.
  122.  
  123. 3.1  Answering the questions that the installer may ask
  124.  
  125. The installer asks some questions that may not have obvious answers.  The
  126. information here should help you answer them.  In most cases, apart from the
  127. first question, the default answers should be OK.
  128.  
  129. If you run the installer from within an X session (the installer checks if
  130. $DISPLAY is set), you will be warned that doing so is not a good idea.
  131. Unless you have a good reason for knowing that this won't be a problem, you
  132. should exit your X session, including stopping xdm or equivalent if it is
  133. running, before continuing.  If you ignore this warning and run into prob-
  134. lems, well, you were warned!
  135.  
  136. If you have an existing X installation, you will be warned that proceeding
  137. with this installation will overwrite it.  Only those things that are part of
  138. our standard distribution will be overwritten.  Other X applications that you
  139. may have installed will not be removed.  Some configuration files may be
  140. overwritten though, but the installer should prompt you before doing so.  As
  141. the opening greeting says, it is strongly recommended that you backup any
  142. existing installation before proceeding.  If you want your old applications
  143. to still be there after you've installed, don't do the "backup" by simply
  144. renaming your old /usr/X11R6 directory.  It is better to make a copy of it,
  145. and then install over the top of the original one.  If you run into problems
  146. and want to revert to the old installation, you can then delete the overwrit-
  147. ten one and copy the saved version back.
  148.  
  149. During the first part of the installation over an existing version, the
  150. script may remove some old files or directories that would get in the way of
  151. the new installation.  It will list which files/directories have been
  152. removed.  If none are listed, then none were removed.
  153.  
  154. The next step when installing over an existing version is to check for exist-
  155. ing configuration files.  As of XFree86 version 3.9.18, the run-time configu-
  156. ration files are installed by default under /etc/X11 instead of under
  157. /usr/X11R6/lib/X11.  The installer will move the existing ones for you and
  158. create the necessary symbolic links.  If you don't want to have these config-
  159. uration files under /etc/X11, then you should answer "no" when asked about
  160. it.  Answering "no" here also means that the new configuration files will be
  161. installed in the old /usr/X11R6/lib/X11 location.  Note: for the rare systems
  162. that don't have symbolic links, this question will not be asked.  The default
  163. answer is "yes" because that is best for most situations.  It is our new
  164. default.  It makes it easier to share the /usr/X11R6 directory between multi-
  165. ple hosts, and allows it to be mounted read-only.  If you don't need these
  166. features, then you can safely answer "no" if you don't want them moved.
  167.  
  168. When installing over an existing version, you will be prompted before each
  169. set of configuration files is installed.  If you haven't made any customisa-
  170. tions to your existing configuration files, then you can safely answer "yes"
  171. for each of these.  If you have made customisations, you can try answering
  172. "no".  If you run into problems later, you may need to manually merge your
  173. customisations into the the new version of the configuration files.  The con-
  174. figuration files can all be found in the Xetc.tgz tarball.  See the section
  175. below about manual installation for information about extracting them sepa-
  176. rately.
  177.  
  178. After the configuration files have been dealt with, the other mandatory com-
  179. ponents of the binary distribution will be installed.  This should proceed
  180. without any user intervention.
  181.  
  182. If you downloaded any of the optional components, the installer will ask you
  183. about each one before it is installed.  The default answer is "yes".  If
  184. there are any that you've since decided that you don't want to install,
  185. answer "no" when prompted.
  186.  
  187. After that is done, the main part of the installation is complete.  The next
  188. steps are to tidy up some aspects of the installation.  The first of these is
  189. to run "ldconfig" on systems that require it, so that the newly installed
  190. shared libraries are accessible.  Then the fonts.dir files in some directo-
  191. ries are updated so that the fonts can be accessed correctly.  Next, the
  192. installer checks to see if your system has a termcap file or terminfo files.
  193. If it finds the former, it tells you how my may update the entries in that
  194. file.  If it finds the latter, it asks you if you want it to update them for
  195. you.
  196.  
  197. Finally, the installer asks you if you want a link created for the rstart
  198. utility.  On most modern systems, the link isn't essential, so the default
  199. answer is "no".  Answer "yes" if you know that you need it.  If you find
  200. later that you need it, you can create it easily by running:
  201.  
  202.      rm -f /usr/bin/rstartd
  203.      ln -s /usr/X11R6/bin/rstartd /usr/bin/rstartd
  204.  
  205. 3.2  After the installation is complete
  206.  
  207. The next step is to configure the X server.  That is covered in detail in an
  208. as-yet unwritten document :-(.  In the meantime, there are two ways to create
  209. a basic X server configuration file for XFree86 4.0.  One is to run the
  210. xf86config utility.  Another is to use the new -configure X server option:
  211.  
  212.      XFree86 -configure
  213.  
  214. The X server config file (XF86Config) format has changed compared to 3.3.x.
  215. Also, its default location is now /etc/X11.  Finally, there is now only one X
  216. server for driving video hardware, and it is called "XFree86".  Once you're
  217. satisfied with the operation of the new X server, you can safely remove the
  218. old XF86_* and/or XF98_* X server binaries from /usr/X11R6/bin.
  219.  
  220. After the X server configuration is done, it may be advisable to reboot,
  221. especially if you run xdm (or equivalent) or the font server (xfs).
  222.  
  223. 4.  Installing XFree86 4.0 manually
  224.  
  225. This section describes how to manually install the XFree86 4.0 binary distri-
  226. butions.  You should only use this method if you know what you're doing.  The
  227. information here covers some common cases, but not every possible case.
  228.  
  229. Put all of the downloaded files into a single directory (choose some tempo-
  230. rary location with enough space).  Become the super user (root).  All of the
  231. following commands should be run as root, and they should be run from the
  232. directory that has all of the downloaded files.  The "extract" utility should
  233. be used to unpack the tarballs.  This is a customised version of GNU tar that
  234. has the gzip code built-in, and which has a different usage when run under
  235. the name "extract".  One important thing that extract does that most versions
  236. of tar do not do by default is that it unlinks existing files before writing
  237. new ones.  This is important when installing over an existing version of X.
  238. If you choose to use some other utility to extract the tarballs, you're on
  239. your own.
  240.  
  241. 4.1  A new installation
  242.  
  243. The simplest case is when there is no existing X installation.  The installa-
  244. tion procedure for this case is as follows:
  245.  
  246.      chmod +x extract
  247.      mkdir /usr/X11R6
  248.      mkdir /etc/X11
  249.      ./extract -C /usr/X11R6 X[a-df-uw-z]*.tgz
  250.      ./extract -C /usr/X11R6 Xvfb.tgz    # If you are installing Xvfb
  251.      ./extract -C /etc/X11 Xetc.tgz
  252.      ./extract -C /var Xvar.tgz
  253.      ln -s /etc/X11/app-defaults /usr/X11R6/lib/X11
  254.      ln -s /etc/X11/fs /usr/X11R6/lib/X11
  255.      ln -s /etc/X11/lbxproxy /usr/X11R6/lib/X11
  256.      ln -s /etc/X11/proxymngr /usr/X11R6/lib/X11
  257.      ln -s /etc/X11/rstart /usr/X11R6/lib/X11
  258.      ln -s /etc/X11/twm /usr/X11R6/lib/X11
  259.      ln -s /etc/X11/xdm /usr/X11R6/lib/X11
  260.      ln -s /etc/X11/xinit /usr/X11R6/lib/X11
  261.      ln -s /etc/X11/xsm /usr/X11R6/lib/X11
  262.      ln -s /etc/X11/xserver /usr/X11R6/lib/X11
  263.      /sbin/ldconfig /usr/X11R6/lib       # For Linux
  264.      /sbin/ldconfig -m /usr/X11R6/lib    # For FreeBSD, NetBSD, OpenBSD
  265.      /usr/X11R6/bin/mkfontdir /usr/X11R6/lib/X11/fonts/misc
  266.  
  267. 4.2  Installing over an old installation
  268.  
  269. If you have an existing installation of X, you should make a backup copy of
  270. it before installing the new version over the top of it.
  271.  
  272. Before doing anything else, make sure the extract command is executable, and
  273. also link it to the name "gnu-tar" so that it can be used as a regular tar
  274. command:
  275.  
  276.      chmod +x extract
  277.      rm -f gnu-tar
  278.      ln extract gnu-tar
  279.  
  280. The first part of the procedure is to move the old run-time config files from
  281. /usr/X11R6/lib/X11 to /etc/X11.  Create /etc/X11 if it doesn't already exist.
  282. For each of the following sub-directories (app-defaults, fs, lbxproxy, prox-
  283. ymngr, rstart, twm, xdm, xinit, xsm, xserver) that you want to move, check
  284. that there is a sub-directory of this name in /usr/X11R6/lib/X11.  Create a
  285. sub-directory of the same name under /etc/X11, then copy the files over by
  286. running:
  287.  
  288.      ./gnu-tar -C /usr/X11R6/lib/X11/subdir -c -f - . | \
  289.        ./gnu-tar -C /etc/X11/subdir -v -x -p -U -f -
  290.  
  291. For each subdirectory that is moved, remove the one under /usr/X11R6/lib/X11
  292. and create a symbolic link to the new location:
  293.  
  294.      rm -fr /usr/X11R6/lib/X11/subdir
  295.      ln -s /etc/X11/subdir /usr/X11R6/lib/X11
  296.  
  297. For those subdirectories that didn't already exist under /usr/X11R6/lib/X11,
  298. create one under /etc/X11 and create the symbolic link to it:
  299.  
  300.      mkdir /etc/X11/subdir
  301.      ln -s /etc/X11/subdir /usr/X11R6/lib/X11
  302.  
  303. Once that is done, extract the config files from the Xetc.tgz tarball into a
  304. temporary directory:
  305.  
  306.      mkdir tmpdir
  307.      ./extract -C tmpdir Xetc.tgz
  308.  
  309. and then copy each sub-directory over to the installed location:
  310.  
  311.      ./gnu-tar -C tmpdir/subdir -c -f - . | \
  312.        ./gnu-tar -C /usr/X11R6/lib/X11/subdir -v -x -p -U -f -
  313.  
  314. If you have customised any config files in your old installation, you may
  315. want to omit those sub-directories, or copy selected files over by hand.
  316.  
  317. Once that's done, the main part of the installation can be done:
  318.  
  319.      ./extract -C /usr/X11R6 X[a-df-uw-z]*.tgz
  320.      ./extract -C /usr/X11R6 Xvfb.tgz    # If you are installing Xvfb
  321.      ./extract -C /var Xvar.tgz
  322.      /sbin/ldconfig /usr/X11R6/lib       # For Linux
  323.      /sbin/ldconfig -m /usr/X11R6/lib    # For FreeBSD, NetBSD, OpenBSD
  324.      /usr/X11R6/bin/mkfontdir /usr/X11R6/lib/X11/fonts/misc
  325.  
  326.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Install.sgml,v 1.4 2000/02/29 18:01:17 dawes Exp $
  327.  
  328.