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