






                                   X APPEAL

                                 Version 3.1



                                 INSTALLATION
                                    MANUAL








                               c XTREME s.a.s.


































































                                      2






                          USER LICENSE AGREEMENT FOR
                            THE X APPEAL SOFTWARE
                               BY XTREME S.A.S.


         Read the  following clauses of the license agreement before
         opening  the  envelope containing  the user  disks  of this
         program product. By opening the package you unconditionally
         accept this agreement.
         If  you refuse  to accept the  license conditions,  you can
         return the closed envelope for a refund.

         1. OWNERSHIP
            The  program, including the supporting documentation, is
            the  property and constitutes a  trade secret of Xtreme.
            The customer  does not acquire any title or ownership in
            the  program other  than the  license rights  granted by
            this agreement.

         2. SECURITY
            The   program  is  delivered   to  the   customer  on  a
            confidential  basis;  the  customer  is  responsible for
            taking  all the necessary actions  to avoid unauthorized
            diffusion of  the program to third parties. The customer
            can make copies only for backup purposes.
            The customer is not authorized in any case to modify the
            program,  reverse engineer  it or remove  any trademark,
            copyright  notice, serial  number or customer  name from
            it.

         3. LICENSE
            The  customer has the right to use  a binary copy of the
            program   on  the  licensed  number   of  machines.  The
            concurrent  use of  the program on  a greater  number of
            machines  is not allowed and  constitutes a violation of
            the license agreement.

         4. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
            Xtreme grants no warranties with respect to the licensed
            program,   and   all   implied   warranties,   including
            merchantability  and fitness for  purpose, are excluded.
            IN  NO   EVENT  SHALL  XTREME  BE  LIABLE  FOR  SPECIAL,
            INDIRECT,  CONSEQUENTIAL OR INCIDENTAL DAMAGES RESULTING
            FROM LOSS  OF USE, DATA OR PROFITS, ARISING OUT OF OR IN
            CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE,
            EVEN  IF XTREME HAS  BEEN ADVISED OF  THE POSSIBILITY OF
            SUCH  DAMAGES; THE MAXIMUM LIABILITY  OF XTREME SHALL BE
            LIMITED TO  REFUND TO THE CUSTOMER THE PRICE PAID BY THE
            CUSTOMER FOR THE PROGRAM.











                                      3






         5. TRANSFER OF THE AGREEMENT
            The   license  granted  by  this   agreement  cannot  be
            transferred or  sublicensed by the customer to any third
            party without the prior written permission of Xtreme.

         6. TERM AND TERMINATION
            The license  will automatically terminate if you fail to
            comply with any term or condition of this agreement. You
            agree  upon  such termination  to  destroy  the licensed
            program  and  all materials  delivered  therewith, along
            with any backup or other copies in your possession.

         7. ENTIRE AGREEMENT
            YOU  ACKNOWLEDGE THAT YOU  HAVE READ  THIS AGREEMENT AND
            UNDERSTAND  IT AND  AGREE TO BE  BOUND BY  ITS TERMS AND
            CONDITIONS.  YOU FURTHER AGREE  THAT IT  IS THE COMPLETE
            AND  EXCLUSIVE  STATEMENT OF  THE  AGREEMENT  BETWEEN US
            WHICH  SUPERSEDES ANY PROPOSAL OR  PRIOR AGREEMENT, ORAL
            OR  WRITTEN,  AND ANY  OTHER  COMMUNICATIONS  BETWEEN US
            RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT.








































                                      4






                                  COPYRIGHT

         X Appeal is a trademark of Xtreme s.a.s.

         X  Appeal  is based  on the  X Window  System,  Version 11,
         Release 6.

                            Portions Copyright by:

                                 X Consortium

                                     and

                                  2001 S.A.
                          Adobe Systems Incorporated
                               AGE Logic, Inc.
                             Gerrit Jan Akkerman
                             Apollo Computer Inc.
                             Apple Computer, Inc
                               Ardent Computer
                                     ATI
                                  AT&T, Inc.
                                 Robert Baron
                                 Don Bennett
                               Bigelow & Holmes
                               Bitstream, Inc.
                Center for Information Technology Integration
                               Cognition Corp.
                               Simon P. Cooper
                                Robin Cutshaw
                         Daewoo Electronics Co.,Ltd.
                           Data General Corporation
                                 David Dawes
                                 Adam de Boor
                        Digital Equipment Corporation
                   Evans & Sutherland Computer Corporation
                               Rickard E. Faith
                           Franz Inc, Berkeley, Ca.
                        Free Software Foundation, Inc.
                               Joseph Friedman
                             Fuji Xerox Co., Ltd.
                     Fujitsu Open Systems Solutions, Inc.
                                Fujitsu, Ltd.
                                Stephen Gildea
                                  Tiago Gons
                          GUI Consortium, CAIR/KAIST
                                H. Hanemaayer
                           Hewlett-Packard Company
                                Alan Hourihane
                               IBM Corporation
                  The Institute of Software, Academia Sinica
                    International Business Machines, Corp.
                              Kaleb S. Keithley
                              William Kucharski
                                 Glenn G. Lai
                                Thomas G. Lane
                         Lexmark International, Inc.
                               Kevin E. Martin


                                      5






                                 Davor Matic
                            Matra Datavision Inc.
                               David McCullough
                                 Larry Medwin
                             Megatek Corporation
                         MIPS Computer Systems, Inc.
                                 Rich Murphe
                    National Computer Graphics Association
                               NCR Corporation
                       Network Computing Devices, Inc.
                  Nippon Telegraph and Telephone Corporation
                           NTT Software Corporation
                          Number Nine Computer Corp.
                                   Hans Oey
                      Oki Technosystems Laboratory, Inc.
                          Olivetti Research Limited
                              OMRON Corporation
                        Open Software Foundation, Inc.
                        O'Reilly and Associates, Inc.
                               Orest Zborowski
                                 Panacea Inc.
                                Pascal Haible
                                Prentice Hall
                          Quarterdeck Office Systems
                                Bill Reynolds
                                 Thomas Roell
                               Dale Schumacher
                        Sequent Computer Systems, Inc.
                              ShoGraphics, Inc.
                      Silicon Graphics Computer Systems
                     Snitily Graphics Consulting Services
                           Solbourne Computer, Inc.
                                Marvin Solomon
                               Sony Corporation
                                     SRI
                             Stanford University
                            Sun Microsystems, Inc.
                                SUNSOFT, INC.
                                Tektronix,Inc.
                        Texas Instruments Incorporated
                                  Jon Tombs
                             TOSHIBA Corporation
                                James Tsillas
                            UniSoft Group Limited
                 The Regents of the University of California
                            University of Toronto
                              UNIX International
                        UNIX System Laboratories, Inc.
                              Vrije Universiteit
                                  Larry Wall
                               David Wexelblat
                           University of Wisconsin
                            Wyse Technology, Inc.
                            X/Open Company Limited






                                      6






         X  Appeal version  3.1 interfaces to  all SVGA  video cards
         using the UniVBE video driver developed by SciTech Software
         and distributed under license.

         The  X Appeal  internal TCP/IP  network layer  is partially
         derived from the free WATTCP networking library code.
         The free  packet driver collection included in the X Appeal
         distribution  is the  latest version available  from Crynwr
         Software.

         The  DOS Extender included in the X  Appeal executable is a
         modified   version   of   GO32,   Copyright   DJ   Delorie;
         redistributed under license.

         X Appeal  is packaged on the install disks using Info-ZIP's
         compression utility. The installation program uses UnZip to
         read  zip files from the disks.   Info-ZIP's software (Zip,
         UnZip and related utilities) is free and can be obtained as
         source  code  or  executables  from  various  anonymous-ftp
         sites,        including        ftp.uu.net,        directory
         /pub/archiving/zip/*.


         MS-DOS  and Microsoft  Windows are trademarks  of Microsoft
         Corporation.

         UNIX is a registered trademark of X-Open.

         All other  product names used in this manual are trademarks
         or registered trademarks of their respective owners.






























                                      7


































































                                      8






                                   CONTENTS


         CHAPTER 1 - INTRODUCTION                               11
             1.1 Features                                       11
             1.2 Documentation                                  12

         CHAPTER 2 - SYSTEM REQUIREMENTS                        13
             2.1 Hardware Requirements                          13
              2.1.1 Computer                                    13
              2.1.2 Memory                                      13
              2.1.3 Hard Disk                                   13
              2.1.4 Floppy Disk                                 13
              2.1.5 Monitor                                     13
              2.1.6 Graphics Card                               13
              2.1.7 Network Card                                14
              2.1.8 Mouse                                       14
             2.2 Software Requirements                          15
              2.2.1 Operating System                            15
              2.2.2 Mouse Driver                                15
              2.2.3 Packet Driver                               15

         CHAPTER 3 - INSTALLING X APPEAL                        17
             3.1 What you have to know before installing X Appeal17
             3.2 Install introduction                           17
             3.3 Installation Drive and Directory               18
              3.3.1 Installation Disk Drive                     18
              3.3.2 Installation Directory                      18
             3.4 Configuration Drive and Directory              20
              3.4.1 Configuration Disk Drive                    20
              3.4.2 Configuration Directory                     20
             3.5 Server Selection                               21
             3.6 Display driver configuration                   21
              3.6.1 Video board custom setup                    22
              3.6.2 Video board automatic setup                 23
              3.6.3 Monitor Modes                               25
              3.6.4 Monitor Horizontal Sync and Vertical Refresh25
              3.6.5 4bpp Video Modes                            26
              3.6.6 Virtual display size for 4 bpp modes        26
              3.6.7 8bpp Video Modes                            27
              3.6.8 Virtual display size for 8 bpp modes        27
              3.6.9 Linear access                               27
              3.6.10  Hicolor  (15-16 bpp)  and  Truecolor  (24 bpp)
         Video Modes                                            28
              3.6.11 Start View Address                         28
             3.7 Network Configuration                          29
              3.7.1 BOOTP server selection                      29
              3.7.1.1 BOOTP Time Out                            30
              3.7.1.2 Domains List                              30
              3.7.1.3 Domain Name Server Time Out               30
              3.7.1.4 Maximum Segment Size                      30
              3.7.2 No BOOTP protocol selection                 30
              3.7.2.1 IP Address                                30
              3.7.2.2 Net Mask                                  31
              3.7.2.3 Gateway address                           31
              3.7.2.4 Domain Name Server Address                31
              3.7.2.5 Domains List                              31
              3.7.2.6 Domain Name Server Time Out               31


                                      9






              3.7.2.7 Maximum Segment Size                      31
              3.7.3 Packet Driver Installation                  31
              3.7.3.1 No packet driver installed                31
              3.7.3.2 Packet Driver already installed           33
              3.7.3.3 Two or more packet drivers installed      34
              3.7.3.4 NDIS Driver installed                     34
              3.7.3.5  NDIS Driver installed together  with a packet
         Driver                                                 35
              3.7.3.6 ODI Driver installed                      36
              3.7.3.7  ODI Driver  installed  together with a packet
         driver                                                 36
             3.8 Font Configuration                             37
              3.8.1 Font Server Configuration                   37
              3.8.2 Font Server Address                         37
              3.8.3 Connection Timeout                          37
              3.8.4 Font Server Port                            37
              3.8.5 Optional Fonts Selection                    38
             3.9 Keyboard Configuration                         38
              3.9.1 Allow Exit                                  38
              3.9.2 Handle of the NumLock                       38
              3.9.3 Keyboard Layout Selection                   39
              3.9.4 Modifier Keys                               39
             3.10 Mouse Configuration                           40
             3.11 Activation method                             40
             3.12 Documentation                                 42
             3.13 Server activation                             42
             3.14 Slip/PPP                                      43
             3.15 Environment variables                         43
             3.16 Hosts DataBase                                44
             3.17 Activation of the rcp and rsh server functions44
             3.18 Advanced configurations                       44

         APPENDIX A - CONFIGURING NDIS to PACKET DRIVER CONVERTER45

         APPENDIX B - CONFIGURING ODI to PACKET DRIVER CONVERTER47

























                                      10






                                  CHAPTER 1
                                 INTRODUCTION


            X Appeal  is a DOS  application developed  for the users
         who  wish to turn their  PC into a X  Window System server.
         With  its   excellent  features  and  performance,  a  true
         workstation environment is available on the PC display.

         1.1 Features

         The main features of X Appeal are:

         -  Complete implementation of the X11R6 Server with XFree86
            extensions,  including PEX, XIE and  font server support
            (using  a font server  can save a  lot of  disk space on
            each PC running the X Server).

         -  Support for nearly all SVGA cards, with special features
            like  run-time  resolution switching  and  panning  on a
            bigger  virtual screen  (this allows  full use  of video
            memory even with a low resolution monitor).

         -  Accelerated  versions for most SVGA  chips with graphics
            coprocessors.

         -  Very high graphics performance.

         -  Support  for Mono, 256 Colors,  HighColor and ThrueColor
            modes.

         -  32  bit  flat mode  execution  environment  with virtual
            memory.

         -  Built-in TCP/IP network support, using packet drivers or
            converters for other driver types.

         -  SLIP and PPP serial connection support to allow use of X
            Appeal  through  modem links.  A fast  modem  (V32bis or
            better)  is  recommended  to  obtain  useful performance
            levels.

         -  Built-in rcp/rsh server, to allow file transfers and the
            execution  of local DOS functions  without leaving the X
            environment.

         -  X  Display  Manager Control  Protocol support  (for easy
            connection to hosts running xdm).

         -  X-Authorization (MIT-MAGIC-COOKIE-1).

         -  Font compiler.

         -  Support for Adobe Type 1 and Speedo scaleable fonts.

         -  Support for  compressed bitmap fonts; users can compress
            local fonts to save disk space on the PC.



                                      11






         -  Simple   interactive   installation   and  configuration
            utility with context-sensitive help screens.

         -  3-button mouse emulation with a 2-button mouse.

         -  Support  for  mapping all  the  major  national keyboard
            layouts.

         -   A set  of freeware  networking utilities  to  help with
             setups not using a plain packet
             driver.

         1.2 Documentation

            A printable version of this manual and of user manual is
         included  on disks of  the installation kit,  both in plain
         ASCII  text  format  (XINSTALL.TXT  and  USER.TXT)  and  in
         Microsoft RTF format (XINSTALL.RTF and USER.RTF). The ASCII
         version  has  no MS-DOS  line-drawing  characters  to allow
         viewing  and  printing on  any  environment;  therefore the
         graphics  information in  the Installation  section showing
         the  appearance  of the  screen when  running  the XINSTALL
         program is missing in this version.





































                                      12






                                  CHAPTER 2
                             SYSTEM REQUIREMENTS

         The following hardware and software items are needed to run
         the X Appeal software package.

         2.1 Hardware Requirements

         2.1.1 Computer

         A  Personal Computer with ISA, EISA, PCI  or Vesa Local Bus
         architecture  equipped with  a 386  or higher  processor. A
         floating  point coprocessor is  not required,  but can help
         when using PEX.

         2.1.2 Memory

         At  least  2  megabytes  of  memory  (4  megabytes  or more
         recommended).  Extended memory can be  used when configured
         with XMS or VCPI managers; DPMI is unsupported (therefore X
         Appeal  cannot  run  from  within  a  DOS  window  under MS
         Windows).

         2.1.3 Hard Disk

            A Hard  Disk with at  least 3.1 megabytes  of free space
         (for  executables) if using a font server.  A total of 9 MB
         is required for the installation when using the local fonts
         (13  MB if also  the optional 100dpi  fonts are installed).
         Some more  space can be needed for swapping if running with
         the minimum amount of RAM.

         2.1.4 Floppy Disk

         A high-density 3.5-inch (or 5.25-inch) disk drive.

         2.1.5 Monitor

         A monitor with VGA resolution (640x480) or better.

         2.1.6 Graphics Card

         X  Appeal version  3.1 interfaces to  all SVGA  video cards
         using the UniVBE video driver developed by SciTech Software
         and distributed under license.
         The  UniVBE driver distributed  with X  Appeal supports the
         following  list of video cards that  have been fully tested
         and are known to work correctly:

         Acer Labs M3141/M3145/M3147V
         Ahead V5000A, V5000B
         Alliance ProMotion 3210/6410/6422/AT24
         ARK Logic ARK1000VL/PV, ARK2000PV
         ATI Technologies 18800, 28800, Mach32, Mach64
         Avance                                                Logic
         ALG2101/2201/2228/2301/2302/2032/2064/2564/25128
         Chips & Technologies 82c45x, 65xx, 643x0 WinGine



                                      13






         Cirrus  Logic CL-GD5401/2,  CL-GD5422/24/26/28/29 TrueColor
         VGA
         Cirrus Logic CL-GD5430/34/36, CL-GD5440/46 Alpine VGA
         Cirrus Logic CL-GD5462/64 Laguna VisualMedia
         Cirrus Logic CL-GD6205/15/25/35 LCD
         Cirrus Logic CL-GD6410/12/20/40 LCD, CL-GD7541/42/43/48 LCD
         Compaq IVGS/AVGA, QVision 1024/1280
         Diamond Viper P9000+W5186/OAK87 VLB and PCI
         Everex ET4000 and Trident based boards
         Genoa GVGA
         Hualon HM86304/14
         IIT AGX-010/11/14/15/16/17
         InteGraphics IGA1680/82/83
         Macronix MXIX 86000/86010
         Matrox MGA Atlas, Athena, Storm
         NCR 77C21/22/22E/32BLT
         NeoMagic NM2070 LCD
         Number Nine Imagine 128 series I & II
         NVidia NV1, SGS Thompson STG2000 (Diamond Edge 3D)
         OAK Technologies OTI-037C/057/067/077/087, 64105/107
         Paradise/Phillips Pipeline 9710/12
         Paradise/Western Digital PVGA1A, W90C1x/2x/3x
         Primus P2000
         RealTek RTG3103/3105/3106
         S3    86c911/924/80x/928,    Vision    864/964/866/868/968,
         Trio32/64/64V+, Virge
         Sierra Falcon/64, SuperScalar 220
         SiS 86c201, 6202, 6205
         SMOS SPC8106 LCD
         Trident 88/8900/9x00/8900CL/9200/94x0/96x0
         Tseng Labs ET3000, ET4000, ET4000/W32/W32i/W32p, ET6000
         UMC 85c408/18
         Video7 VEGA, HT208/209/216
         Weitek 5086/186/286, P9100


         2.1.7 Network Card

         A Network  Card with a compatible packet driver, or SLIP or
         PPP serial connection.

         2.1.8 Mouse

         A pointing device with a Microsoft Mouse compatible driver.


         2.2 Software Requirements

         2.2.1 Operating System

         MS-DOS or PC-DOS 3.30 or later.

         2.2.2 Mouse Driver

         A Microsoft Mouse compatible driver.

         2.2.3 Packet Driver



                                      14






         Free collection included.



























































                                      15


































































                                      16






                                  CHAPTER 3
                             INSTALLING X APPEAL


         3.1 What you have to know before installing X Appeal

            Before  installing X  Appeal  make  sure  you  know your
         display  features,  especially the  supported  video modes.
         Maximum dot clock, horizontal and vertical frequency may be
         required in specific configurations.
            While X Appeal can  detect the graphic card installed in
         your  computer, sometimes  the knowledge  of the  amount of
         video memory and the type of RAM DAC may be required.
            Choose also the type of  connection you want to use with
         the remote systems (a network card or a serial connection).
            In the former case, if you  do not already have a packet
         driver  installed on your  machine, make sure  you know the
         model  of  your  network interface  card  and  its hardware
         settings  (Hardware  Interrupt  vector,  Dual  Port  Memory
         address, I/O address, etc.).
            You also  have to know  the parameters  for your network
         system configuration  (IP address of your PC, IP address of
         the host you want to connect to, network mask, etc.).
            In the  latter case make  sure that the  remote host can
         use the SLIP or PPP protocol.

         3.2 Install introduction

            Insert the disk labeled  "Installation" into drive A (or
         B) and type:

                             C:\>a:xinstall
         or:
                             C:\>b:xinstall

            You will see a welcome message as below:
























                                      17









                Welcome to the X Appeal Installation Program !
              X Appeal is Copyright  (c)  1992-96  Xtreme s.a.s.


           This program will install the X Appeal X Server on your
                                  computer.

          Press the Alt-X key at any time to abort the installation.
           Press the F1 key to get a context-sensitive Help screen.

         Many questions have a default answer. If the default answer
                                      is
              correct, press the ENTER key to accept the value.
           Otherwise type the answer and then press the ENTER key.

                 Do you want to continue installation (Y/N) ?

         [F1]=Help                                     [Alt-X]=Exit



            If you press  "N" you exit the  installation and go back
         to  the  DOS prompt,  otherwise if  you want  to  begin the
         installation press "Y".
            If you want to cancel the installation, you can do it in
         any moment just by pressing ALT+X.
            If you need help during installation press the F1 key.
            If you press "Y" you have:

         3.3 Installation Drive and Directory

         This is the path where all executable files, font files and
         utilities  will be copied  by the  installation program. It
         will be referenced as: installation directory.



          [ Installation drive and directory]

          You must specify the Disk Drive and the Directory were to
          install X Appeal.

          Disk Drive    C

          Directory     XAPPEAL3

                                                          [ESC]=Canc
         el



         3.3.1 Installation Disk Drive

            Enter the drive  where you want to  install X Appeal and
         press ENTER. The default drive is C.


                                      18







         3.3.2 Installation Directory

            Enter the directory on the selected drive where you want
         to install  X Appeal and press ENTER. The default directory
         is  XAPPEAL3.




                      Accept Information (Y/N) ?  N




            If you type "Y"  you accept Disk and Directory selection
         and you  proceed with the subsequent step, otherwise if you
         type "N", you go back to the drive selection.


            After  the  disk  drive   and  directory  selection  the
         installation program does some checks on the system:

             a) verifies if  the previous  main release  (1.4.x) has
              been already  installed in the specified directory. In
              this case a warning message is displayed:





         Warning: you are installing on a previous main release of X
                                   Appeal.
          All the files belonging to the old version will be deleted
                                    before
                  starting the installation of the new one.

                 Do you want to continue installation (Y/N) ?





            If you choose "Y" all old  files will be deleted; if you
         choose "N" the installation program terminates.

             b) checks  if the amount  of disk space  required for a
         correct installation is available.

            If at this point the program verifies that the available
         disk space  is not enough for the installation you will see
         a message like this:





          Warning: the installation program has detected 2168 Kbytes


                                      19








          This program will require at least 3.1 of Mb of disk space
              of available space on the Hard Disk you selected.
          and it will increase up to 20 Mb with the installation of
             all the available options. A check for space will be
            performed each time you select an option that requires
                            additional disk space.


            NOTE: the disk space requirement is correct for cluster
         sizes of 4 Kb or 8 Kb. If your HDU has a different value of
         cluster size there may be some differences between expected
                         and real space requirement.


                 Do you want to continue installation (Y/N) ?





            A message like this will appear every time you select an
         installation  option that involves disk  space use. You can
         ignore  them if you are  sure the required  amount of space
         exists,  or if you are  overwriting a previous installation
         (but  only if it is the same  main release) because the new
         files will overwrite the old ones.

































                                      20






         3.4 Configuration Drive and Directory

            This is the  path where all configuration  files will be
         copied  or   created  by  the  installation  program.  This
         directory will be referenced as: configuration directory.
            Normally  this  path  should  be the  same  as  the  one
         specified in  the previous step and this is the best choice
         if you install X Appeal on a single PC.
            If  you want  to install X Appeal  on many PCs, probably
         the best solution is to install executables and fonts files
         on a  directory located on a network file server, shared by
         all the  PCs, and setup the private configuration files for
         each PC on a local directory.
            In such cases, select a different path for configuration
         and  at  the end  of  the installation  process,  run   the
         xinstall    program  with  the  _-c_  option  on  each  PC,
         specifying  for installation directory  the one referencing
         the  file server and  a configuration directory  on a local
         drive.



          [ Configuration drive and directory]

          You must specify the Disk Drive and the Directory were to
          install all the X Appeal configuration files.

          Disk Drive    C

          Directory     XAPPEAL3

                                                          [ESC]=Canc
         el



         3.4.1 Configuration Disk Drive

            Enter the drive  where you want to  install the X Appeal
         configuration  files and press ENTER.  The default drive is
         the drive you have specified for installation drive.

         3.4.2 Configuration Directory

         Enter the directory on the selected drive where you want to
         install  X Appeal configuration files  and press ENTER. The
         default  directory is the directory  you have specified for
         installation.




                      Accept Information (Y/N) ?  N







                                      21






            If you type "Y"  you accept Disk and Directory selection
         and you  proceed with the subsequent step, otherwise if you
         type "N", you go back to the drive selection.

         3.5 Server Selection

            A list of all available X Servers is showed:



            [Servers Selection]
             You can install as many servers as you like.
             Select them by typing X in the proper input field.

           [ ] SVGA 256 colors Server    (2.4 Mb)
           [ ] VGA monochrome Server     (1.2 Mb)
           [ ] S3 accelerated Server     (2.6 Mb)
           [ ] Mach8 accelerated Server  (2.2 Mb)
           [ ] Mach32 accelerated Server (2.2 Mb)
           [ ] Mach64 accelerated Server (2.5 Mb)
           [ ] 8514/A accelerated Server (2.6 Mb)
           [ ] AGX accelerated Server    (2.2 Mb)
                                                      [F10]=Confirm




            You can  select one  or more  servers from  the previous
         list but  only if your hardware supports them (at this step
         the   installation  program  doesn't   check  hardware  and
         software  compatibility)  or  if you  are  installing  on a
         Network file Server, which can be accessed by many PCs with
         different graphic cards.

         3.6 Display driver configuration

            X Appeal uses  UniVBE as a general  purpose video driver
         and  the installation program  run the  UVCONFIG utility in
         order  to detect the video card  installed on your computer
         and the video modes it supports.

            This utility  will try  to detect  the SuperVGA  ID, the
         Chipset  ID, the ClockChip  ID, the amount  of video memory
         and the RAMDAC ID.
            In rare cases  the autodetection method can  fail. It is
         possible  to force the detection of  the right SuperVGA ID,
         Chipset  ID,  ClockChip,Video Memory  and RAM  DAC  ID from
         within the installation program itself.












                                      22









                The program will try to detect which Video Card,
                                    Chipset,
                 RamDAC and ClockChip are installed on your PC.
                In rare cases the autodetection method can fail,
                                     so you
                 can force the detection of the right hardware
                                   installed.
                First you can try Autodetection and then choose
                                     Custom
                    setup if autodetection method will fail.

                    Do you want to use Custom setup (Y/N) ?




            If you  answer  `Y' to  this question  go  through Video
         board custom setup paragraph, else you can skip it.

         3.6.1 Video board custom setup

            First of all you  will be asked for  the Super VGA Board
         installed on your PC:



         [ Configure Display ]
          Super VGA Board:
                          ATI SuperVGA
                          AHEAD SuperVGA
                          Chips & Tech SuperVGA
                          Everex SuperVGA
                          Genoa SuperVGA
                          OAK SuperVGA
                          Western Digital SuperVGA
                          Trident SuperVGA
                          Cirrus Logic SuperVGA

                                                    [ESC]=Autodetect




            After your  choice,  e.g. _Cirrus  Logic  SuperVGA_, you
         will  be asked  for the Chipset  that is  installed on your
         board:











                                      23









         [ Configure Display ]
          Super VGA Board: Cirrus Logic SuperVGA
          ChipSet Type:
                        CL-GD5422
                        CL-GD5424
                        CL-GD5426
                        CL-GD5428
                        CL-GD5430
                        CL-GD5436

                                                    [Esc]=Autodetect




            After you enter the  ChipSet type, e.g. _CL-GD5428_, you
         will  be asked  for the  RamDAC that  is installed  on your
         board:




         [ Configure Display ]
          Super VGA Board: Cirrus Logic SuperVGA
          ChipSet Type:    CL-GD5428
          RamDAC Type:
                        Normal 8 bit DAC
                        Sierra SC11481/6/8 15 bit DAC
                        Sierra SC11482/3/4 15 bit DAC
                        Sierra SC11485/7/9 16 bit DAC
                        Music MU9C4870 16 bit DAC
                        Chips 65535 Internal 16 bit DAC

                                                    [Esc]=Autodetect



            After you enter  the RamDAC type, e.g.  _Cirrus Logic 24
         bit  DAC_, you  will be asked  for the  Clock Chip  that is
         installed on your board:

















                                      24









         [ Configure Display ]
          Super VGA Board: Cirrus Logic SuperVGA
          ChipSet Type:    CL-GD5428
          RamDAC Type:     Cirrus Logic 24 bit DAC
          Clock Chip Type:
                        (Standard VGA Clocks)
                        (Discrete clock selections)
                        ATI 18818-0 Clock
                        ATI 18818-1 Clock
                        ICS9161/ICD2061/Diamond DCS2824 Clock
                        ATT  20C408/409, ICWorks  W30C409 Integrated
         Clock

                                                    [Esc]=Autodetect




            Finally you  will be asked  for the amount  of video RAM
         installed on your board:




          [ Configure Display ]
          Super VGA Board: Cirrus Logic SuperVGA
          ChipSet Type:    CL-GD5428
          RamDAC Type:     Cirrus Logic 24 bit Dac
          Clock Chip Type: (Discrete clock selection)
           Video Memory (Kbytes):
                             256
                             512
                             1024
                             2048
                             3072

                                                    [Esc]=Autodetect




         3.6.2 Video board automatic setup

            At this  point, after  you entered all  the configurable
         parameters,  or  if you  selected  the  automatic detection
         method,  the  UVCONFIG  utility   is  started  and  it will
         display the subsequent message screen:

         UniVBE is  about to analyse all available video modes. This
         may take up to 20
         seconds  on some machines,  and your monitor  may emit mode
         switching noises
         during this testing phase.
         Because  there is  a remote  possibility that  this testing
         procedure may damage


                                      25






         defective  monitors, we *strongly* recommend  that you turn
         off your monitor
         during this  testing phase. After this testing is complete,
         UniVBE will beep
         the speaker twice and you can turn your monitor back on.
         Press any key to begin mode analysis (ESC to skip) ...

            It is important to perform mode analysis because in this
         way  some unsupported video modes will  be deleted from the
         list  of  all  available video  modes  and  furthemore, the
         UVCONFIG utility  will create a clock list to be put in the
         Clocks  entry in the X Appeal  configuration file (see User
         manual at Configuring Graphics Device paragraph).
            At  the end  of  video mode  analysis,  the  results are
         displayed in a summary as follow:





                     UVCONFIG has built a Video Driver for:

             Cirrus Logic SuperVGA (CL-GD5428) with 1 Mb, VBE 1.2
                            Cirrus Logic 24 bit Dac
                          (Discrete clock selection)

                     Do you accept this configuration (Y/N) ?




         If  your answer is  `N', the X  Appeal installation program
         will  return back to the _Video  custom setup_ question and
         you can  change some parameter, else the program will go on
         asking some more information.

























                                      26






         3.6.3 Monitor Modes


                      640x400
                      640x480
                      800x600
                     1024x768



          [ Configure Display ]
          Super VGA  Board: Cirrus Logic SuperVGA (CL-GD5428) with 1
         Mb, VBE 1.2
          RamDAC Type:     Cirrus Logic 24 bit DAc

          Monitor Modes:






                                                           [Esc]=End



            Probably your monitor supports more than one video mode.
         The most common modes are:
              640x480, 800x600, 1024x768 and 1280x1024.
            Check your specific documentation.
            Use the arrow keys to highlight your selection and press
         ENTER for each video mode you want to include in your list.
         Press  ESC to end this step.


         3.6.4 Monitor Horizontal Sync and Vertical Refresh

         These  quantities are mandatory for  Accelerated X Servers;
         they  do not need for  SVGA X server and  MONO X Server and
         they are  not requested if you do not select an Accelerated
         X Server to be installed.



















                                      27









                      640x400
                      640x480
                      800x600
                     1024x768



          [ Configure Display ]
          Super VGA  Board: Cirrus Logic SuperVGA (CL-GD5428) with 1
         Mb, VBE 1.2
          RamDAC Type:     Cirrus Logic 24 bit DAc

          Monitor Modes:  "640x480" "800x600" "1024x768"
          Horiz.Sync: 30-64             Vertical Refresh: 40-100





                                                           [Esc]=End




         The  Horizontal Sync frequency  is the number  of times per
         second  the monitor can  write a horizontal  scan line; the
         vertical  refresch rate is  the number of  times per second
         the  monitor  can traverse  its beam  vertically  (see User
         Manual - App. A).
         Horiz.  Sync and Vertical Refresh may  be a comma separated
         list of either discrete values or ranges of values. A range
         of  value is  two value  separated by  a dash.  The default
         value  for the  Horizontal Sync frequency  are in  kHz; the
         default  value for  the  Vertical Refresh  rate are  in Hz.
         These  information  should be  available  in  the monitor's
         handbook.





















                                      28






         3.6.5 4bpp Video Modes


                      640x400
                      640x480
                      800x600
                     1024x768



          [ Configure Display ]
          Super VGA  Board: Cirrus Logic SuperVGA (CL-GD5428) with 1
         Mb, VBE 1.2
          RamDAC Type:     Cirrus Logic 24 bit DAc

          Monitor Modes:   "640x480" "800x600" "1024x768"

          4 bpp Video Modes:





                                                           [Esc]=End





            The list of  the 4 bits per  pixel video modes supported
         by  your card has been displayed; these  modes will be used
         by  the monochrome Server, if you will  install it. Use the
         arrow keys  to highlight your selection and press ENTER for
         each video mode you want to include in your list. Press ESC
         to end this step.
            The first mode  in the list will  be the default display
         mode  at startup. Internally  the list is  converted into a
         circular  list; using  Ctrl+Alt+Keypad9 or Ctrl+Alt+Keypad3
         the  current display mode may  be changed, and  the next or
         previous entry in the list will be configured.




















                                      29






         3.6.6 Virtual display size for 4 bpp modes



          [ Configure Display ]

          Super VGA  Board: Cirrus Logic SuperVGA (CL-GD5428) with 1
         Mb, VBE 1.2
          RamDAC Type:     Cirrus Logic 24 bit Dac

          Monitor Modes:   "640x480" "800x600" "1024x768"

          4 bpp Video Modes:    "640x480" "800x600" "1024x768"
          Virtual Display Size: 1024 1024





                                                         [Esc]=End




            Set the virtual screen size.  As an example, you can use
         a physical resolution of 800x600 (this is the graphic video
         mode  activated),  with  a  virtual  screen  of   1024x1024
         (VirtualX x  VirtualY). If the mouse touches the borders of
         the display the image scrolls accordingly; this function is
         called Panning.


         3.6.7 8bpp Video Modes

            If your video  card supports the 8  bits per pixel video
         modes,  you will be prompted to select  them like for the 4
         bpp  video modes. These modes will be  used by the SuperVGA
         Server and by the Accelerated Servers.
            The first mode  in the list will  be the default display
         mode  at startup. Internally  the list is  converted into a
         circular  list; using  Ctrl+Alt+Keypad9 or Ctrl+Alt+Keypad3
         the  current display mode may  be changed, and  the next or
         previous entry in the list will be configured.

         3.6.8 Virtual display size for 8 bpp modes



          [ Configure Display ]

          Super VGA Board: Logic SuperVGA (CL-GD5428) with 1 Mb, VBE
         1.2
          RamDAC Type:     Cirrus Logic 24 bit DAc

          Monitor Modes:   "640x480" "800x600" "1024x768"

          4 bpp Video Modes:    "640x480" "800x600" "1024x768"
          Virtual Display Size: 1152 900


                                      30







          Virtual  Display Size: 1152 900                 Use linear
         access 
          8 bpp Video Modes:    
                Y               "640x480" "800x600" "1024x768"




                                                       [F10]=Confirm




            Set the  virtual screen  size for the  8 bits  per pixel
         modes.
            The virtual  display size you  can select  is related to
         the amount  of video RAM installed on the graphic card (the
         above  example assumes 1  Mb). Graphic  cards equipped with
         512  Kb can work only  with a virtual  screen size slightly
         greater than  800x600 (i.e. 832x630).
            Some Super VGA  Board can work only  with some values of
         the  horizontal virtual display  size (e.g.  older S3 chips
         work  only with  640   and 1024; newer  models support some
         other values: see user manual chap. 3).
            The product  of virtualX by  virtualY must  be less than
         the Video RAM size in bytes.


         3.6.9 Linear access

            Some new video cards allow to access the video memory in
         linear mode.
            If the  installation program  detects that this  mode is
         supported  by your  card, it  will ask  you to  enable this
         feature. Normally this will result in better performance.
            The linear access must  be enabled to use  the 15, 16 or
         24   bits per pixel video modes (if the video card supports
         them).
            Note: The linear frame  buffer address must be less than
         240 Mb (0x0F000000).


         3.6.10  Hicolor (15-16  bpp) and  Truecolor (24  bpp) Video
         Modes

            If your  video card  support the 15,  16 or  24 bits per
         pixel video modes, you will be prompted to select them like
         for the 4 and 8 bpp video modes.
            These modes  will  be used  by the  SuperVGA multi-depth
         Server (not  all cards will support all these modes) and by
         some Accelerated Servers.










                                      31








          [ Configure Display ]

         Super  VGA Board: Cirrus Logic  SuperVGA (CL-GD5428) with 1
         Mb, VBE 1.2
         RamDAC Type:     Cirrus Logic 24 bit DAc

          Monitor Modes: "640x480" "800x600" "1024x768"

          4 bpp Video Modes:  "640x480" "800x600" "1024x768"
          Virtual Display Size 1152 900
          8 bpp Video Modes:  "640x480" "800x600" "1024x768"
          Virtual  Display Size 1152  900                 Use linear
         access  Y
          16 bpp Video Modes: "640x480" "800x600"
          Virtual  Display Size 800   600                 Use linear
         access  Y
          24 bpp Video Modes: "640x480"
          Virtual  Display Size 640   480                 Use linear
         access  Y
          Start View Address   0   0

                                                       [F10]=Confirm




            The first mode  in the list will  be the default display
         mode  at startup. Internally  the list is  converted into a
         circular  list; using  Ctrl+Alt+Keypad9 or Ctrl+Alt+Keypad3
         the  current display mode may  be changed, and  the next or
         previous entry in the list will be configured.

            For each  video mode  you should select  the appropriate
         Virtual Display Size.
            All the servers which support  24 bit visuals do that by
         using  a 32  bit per  pixel configuration  where 8  bits in
         every  32  bits are  unused. This  needs to  be  taken into
         account  when calculating the maximum  virtual display size
         that can be supported at this depth.



         3.6.11 Start View Address

            Set the upper left corner of the physical display in the
         virtual display.


            After  the selection  of  the  start  View  Address, the
         following message box will appear:








                                      32










                        Accept Information (Y/N)? N




            If you  type "N"  you'll  go back  to the  Monitor Modes
         choice.
            If you type "Y"  you'll accept the Display Configuration
         and the installation program will continue with  the Server
         Selection menu.


         3.7 Network Configuration



         [ Configure Network Parameter ]

          You can use a BOOTP Server to get Network parameters such
                                     as:
            MyIP address, Gateway address, Netmask and NameServer
                                   address.
                   Otherwise you can specify them directly.

                  Do you want to use a BOOTP server  (Y/N) ?

                                                          [ESC]=Canc
         el



         If  you want  to use  a  BOOTP server  you must  press "Y",
         otherwise "N".
         When using  BOOTP, a broadcast request for a server is sent
         on the network.

         3.7.1 BOOTP server selection



          [ Configure  Network ]

          BOOTP Time Out           30


          Domains List
          Domain Name Server Time Out  120
          Maximum Segment Size (MSS)   1400
                                                          [F10]=Conf
         irm






                                      33







         3.7.1.1 BOOTP Time Out

            Insert the Time Out value in seconds for the answer from
         the BOOTP server. The default value is 30.

         3.7.1.2 Domains List

            This is  the  comma-separated list  of the  Domain names
         that   can be used when querying  a Domain Name Server  for
         the name-to-address translation

         3.7.1.3 Domain Name Server Time Out

            Insert the Time Out value in seconds for the answer from
         the Domain Name Server . The default value is 120

         3.7.1.4 Maximum Segment Size

            This parameter  can be used  to set  the Maximum Segment
         Size for the Network card you are using. Some old cards and
         SLIP  connections may require a  smaller value. The default
         value is 1400


         If you don't use the BOOTP Server you have:

         3.7.2 No BOOTP protocol selection



          [ Configure  Network]

          IP Address                      192.192.192.192
          Net Mask                        255.255.255.0
          Gateway  Address                   .   .   .
          Domain Name Server Address         .   .   .
          Domains List
          Domain Name Server Time Out     120
          Maximum Segment Size (MSS)      1400

                                                       [F10]=Confirm



         3.7.2.1 IP Address

            Each machine   (including X servers) on   a network must
         have  a unique IP address.  You  will get this address from
         your network administrator.










                                      34






         3.7.2.2 Net Mask

            If your  network is  divided into  subnets, you  need to
         specify  the   right  subnet mask  for   your  local subnet
         (also  called simply a Netmask).   If  your  network is not
         divided  in this  way, then you  need to  specify the right
         subnet mask for the  network class you are using.  Get this
         information  from your network administrator.

         3.7.2.3 Gateway address

            If your network uses one  or more gateways to connect it
         with other networks, the X server needs to know the address
         of  a gateway to communicate  out of the  local network. If
         you don't have a gateway, don't configure any address.

         3.7.2.4 Domain Name Server Address

            Insert the address of the Name server.

         3.7.2.5 Domains List

            This is  the  comma-separated list  of the  Domain names
         that   can be used when querying  a Domain Name Server  for
         the name-to-address translation.

         3.7.2.6 Domain Name Server Time Out

            Insert the Time Out value in seconds for the answer from
         the Domain Name Server . The default value is 120.

         3.7.2.7 Maximum Segment Size

            This parameter    can   be used    to set    the Maximum
         Segment  Size for the Network card you  are using. Some old
         cards  and SLIP  or PPP connections  may require  a smaller
         value. The default value is 1400.

         3.7.3 Packet Driver Installation

         There are now seven different cases:



















                                      35






         3.7.3.1 No packet driver installed





          The installation program did not find any packet driver on
                                   your PC.
          Before running X Appeal you must install a packet driver.
             The next input form will help you setting the right
           parameters for your network card or serial comunication
                                    port.





         The program  lets you choose a network card or a connection
         via serial port:





           You can choose a network card or a connection via serial
                                    port.
              Each connection type must be properly configured!

                  Do you want to use a network card (Y/N) ?






            If you answer Y(es)  to the question you  must select
         the type of card to be used























                                      36








                [Configure Nertwork Card]

                 Ethernet Card:
                             3Com 3C503
                             3Com 3C505
                             3Com 3C507
                             3Com 3C509
                             3Com 3C523
                             ADI Aquila
                             Arcether
                             Arcnet
                             AT&T
                             AT&T_LP

                   [Esc]=Cancel




         and its specific configurable parameters.

            Use the arrows to  highlight your Network card and press
         ENTER to activate that selection.

            If, for  instance, you  choose the  3Com 3C503  card the
         specific parameters are:



          [Configure Network Card]

           Network Card:               3Com 3C503

           Packet Driver Vector (hex)  0x62

           Hardware Interrupt Vector   2

           I/O Base Address            0x300

           Cable Type (0=thick, 1=thin)     1






            If you answer N(o) to the question "Do you want to use a
         network  card (Y/N)  ?", you  must select  the SLIP  or PPP
         driver  for the serial connection  (these are the protocols
         used for sending IP packets on an asynchronous serial line;
         see the specific section of this manual for more details).







                                      37








          [Configure Network Card]

           SLIP Driver:
                        SLIP
                        compressed SLIP
                        PPP


                                                         [Esc]=Cance
         l




            The next input  form lets you  specify the configuration
         parameters with the default values listed below:



          [Configure Network Card]

           SLIP Driver:                  SLIP

           Packet Driver Vector (hex)    0x62

           Hardware Interrupt Vector     4

           I/O Base Address (hex)        0x3f8

           Baud rate                     19200

                                                         [Esc]=Cance
         l




         3.7.3.2 Packet Driver already installed

            If a packet  driver is already installed  on your PC the
         program proposes you the following question:




                  A packet driver is already installed on
                 your PC.
                  Do you want to install a new packet driver
                 (Y/N) ?





            If you answer Y(es) subsequent steps of the installation
         are  the same as the case 3.7.3.1.  You should answer Y(es)


                                      38






         only if  you want to install a different Packet Driver than
         the existing one.
            If you  answer  N(o) you  may select  the  packet driver
         interrupt vector actually installed.




                  Packet Driver Vector:     0x66




            This  parameter is  used  to set  a  particular software
         interrupt  vector for the packet  driver interface. If this
         parameter  is omitted, a search  is done at  the startup of
         the  Server, and the first packet driver  found is used. If
         you  choose a particular  value you could  have problems if
         the  value  selected  doesn't  match  the  interrupt vector
         installed.


         3.7.3.3 Two or more packet drivers installed

            This is  the case  if a  multiplexer is  installed (i.e.
         pktmux). In such a condition more applications using packet
         drivers can run on the same machine.





          2 packet drivers are installed at vectors 0x63 and 0x66.
          Do you want to specify the p. d. int. vector used by X
         Appeal (Y/N)?





            If you  answer Y(es)  you can  select the  packet driver
         installed for  X Appeal from the previous list (the default
         value is the first one):

















                                      39









                    Packet Driver Vector              0x63




            This parameter is useful when two or more packet drivers
         are installed on the same machine, and one must be selected
         for  X Appeal.  If this parameter  is omitted,  a search is
         done  at the  startup of the  Server, and  the first packet
         driver found  is used. If you choose a particular value you
         could have problems if the value selected doesn't match the
         interrupt vector installed.

            If you  answer N(o)  the installation  program continues
         with  the  Fonts  Configuration  and  the  interrupt vector
         selected for X Appeal is the default one.


         3.7.3.4 NDIS Driver installed

            If a  NDIS Driver  is already installed  on your  PC the
         program informs you with the following message:



                    A NDIS Driver is installed on your PC.
          Since X Appeal uses a packet driver interface, you should
          install a NDIS to packet driver converter such as DIS_PKT.




            DIS_PKT.DOS provides  an Ethernet  or Token  Ring Packet
         Driver  interface to programs built  to operate over Packet
         Drivers. It  talks to NDIS (3Com/Microsoft) instead of to a
         lan  card directly. It shares the card  with NDIS users. We
         call this a "shim", sitting between the normal applications
         programs  (NetWare  shells,  TCP/IP,  etc.)  and  the  more
         hardware specific portions (NDIS in this case).

            The required  configuration  in this  case should  be as
         shown below:















                                      40






                        X Appeal            NDIS            flavored
         applications
                        | |                           | |
                        | |                           | |



                 DIS_PKT


                        | |                           | |


                                  main module
                             NDIS
                 .................................
                                  card           specific
                 driver(s)


                                       | |


                            Ethernet /Token Ring card(s)


                                       | |
                   =================================  Ethernet/Token
         Ring wire

            Refer  to  APPENDIX  A   of  this  manual  for  detailed
         information on setting up such environment.

         3.7.3.5 NDIS Driver installed together with a packet Driver

            If a NDIS Driver  is already installed on  your PC and a
         Packet  Driver is  installed too,  the program  informs you
         with the following message:





                  A packet driver is installed at vector 0x66
                    on an NDIS to packet driver converter.
                     The configuration should be complete;
             you can specify the packet driver interrupt vector to
            force X Appeal to use it, otherwise an automatic search
                              will be performed.

              Do you want to specify the packet driver interrupt
                                 vector (Y/N)




         If you answer Y(es) you have:



                                      41









                 Packet driver vector (hex)        0x66




            This  parameter is  used  to set  a  particular software
         interrupt  vector for the packet  driver interface. If this
         parameter  is omitted, a search  is done at  the startup of
         the  Server, and the first packet driver  found is used. If
         you  choose a particular  value you could  have problems if
         the  value  selected  doesn't  match  the  interrupt vector
         installed.


         3.7.3.6 ODI Driver installed

            If a  ODI Driver  is  already installed  on your  PC the
         program informs you with the following message:





                    An ODI Driver is installed on your PC.
              Since X Appeal uses a packet driver interface, you
               should install an ODI to packet Driver converter
                               such as ODIPKT.





            ODIPKT.COM provides  a Packet  Driver API  over Novell's
         Open Data-Link Interface, allowing a single network adapter
         to service IPX, TCP/IP  and other protocol stacks which use
         packet  drivers.  ODIPKT.COM  understands  Ethernet,  Token
         Ring, and ARCnet frame types.

            Refer  to  APPENDIX  B   of  this  manual  for  detailed
         information on setting up such environment.

















                                      42






         3.7.3.7 ODI Driver  installed together with a packet driver

            If a ODI  Driver is already  installed on your  PC and a
         Packet Driver is installed too, the program inform you with
         the following message:




                  A packet driver is installed at vector 0x66
                     on an ODI to packet driver converter.
                     The configuration should be complete;
             you can specify the packet driver interrupt vector to
            force X Appeal to use it, otherwise an automatic search
                              will be performed.

              Do you want to specify the packet driver interrupt
                                 vector (Y/N)





         If you answer Y(es) you have




                 Packet driver vector (hex)        0x66




            This  parameter is  used  to set  a  particular software
         interrupt  vector for the packet  driver interface. If this
         parameter  is omitted, a search  is done at  the startup of
         the  Server, and the first packet driver  found is used. If
         you  choose a particular  value you could  have problems if
         the  value  selected  doesn't  match  the  interrupt vector
         installed.

         3.8 Font Configuration




         You can use Local Fonts or access them using a Font Server.
         The use of Local Fonts will require at least 6.5 Mb of disk
                                    space

                   Do you want to use a Font Server (Y/N) ?




            If some  host on  your network is  running a  X11R6 font
         server,  you can use it  to provide the fonts  to X Appeal,
         instead of having a local copy of the fonts.


                                      43







            If you want to use a Font Server you must press "Y".


         3.8.1 Font Server Configuration




          [ Configure Font Server ]

            Font  Server Address        .    .    .       Connection
         Timeout   30

            Font Server Port     7100

                                                          [ESC]=Canc
         el



         3.8.2 Font Server Address

         Enter  the IP  Address of the  host where   the  X11R6 font
         server is running

         3.8.3 Connection Timeout

         Insert the timeout for the connection with the font server.
         The default value is 30 seconds.

         3.8.4 Font Server Port

         Enter  the Port Number  for the connection  to font Server.
         The default value is 7100 for X11R6 and 7000 for X11R5 font
         server.

         After the value has been accepted with ENTER, the following
         Message Box will appear:




                       Accept Information (Y/N) ?     N




            If you type "N" you go back to the Configure Font Menu.
            If you  type "Y" you  accept the  Font Configuration and
         proceed with the Keyboard Configuration.
            If you want  to install the local  X Appeal fonts answer
         "N" to the previous question:







                                      44






         3.8.5 Optional Fonts Selection




                Some of  the installable Fonts are optional: you
              can install
                them by typing  X in the proper input field.

                  [  ]  Speedo Fonts (0.6Mb)

                  [  ]  Type 1 Fonts (0.6 Mb)

                  [  ]  100 dpi Fonts (4 Mb)

                  [  ]  Asian Fonts part 1(3.5 Mb)  - Require Asian
              2

                  [  ]  Asian Fonts part 2(3.5 Mb)  - Require Asian
              1

                  [  ]  Ciryllic Fonts (1.8 Mb)




         The  optional 100 dpi fonts are  useful for high resolution
         monitors (1024x768 or 1280x1024).

         After  your  selection you  can proceed  with  the keyboard
         configuration.

         3.9 Keyboard Configuration




          [ Configure Keyboard ]

          Allow Exit using Ctrl-Alt-Backspace (Y/N)              [Y]

          Handle NumLock on Xserver (L) or Remotely (R)          [L]

          Select Keyboard Layout:


                                                         [ESC]=Cance
         l












                                      45






         3.9.1 Allow Exit

            If you want to log out (exiting the Server), you can use
         the  "Exit" key combination.  This is  activated by holding
         down the "CTRL" and the "ALT" keys, simultaneously pressing
         the  "BACKSPACE"  key. If  you  want to  allow  this "Exit"
         activation, type "Y" otherwise type "N".

         3.9.2 Handle of the NumLock

            If you want to handle the NumLock locally on the Xserver
         type "L", otherwise type "R". If you choose "R", the server
         sends  virtual  key-events  so  applications  can  use  the
         numeric keypad.


         3.9.3 Keyboard Layout Selection

         The national supported keyboard are:

              BE: Belgian
              CF: Canadian French
              DK: Danish
              FR: French
              GR: German
              IT: Italian
              NL: Dutch
              NO: Norwegian
              PO: Portuguese
              SF: Swiss French
              SG: Swiss German
              SP: Spanish
              SU: Finnish
              UK: U.K. English
              US: U.S. English

         Select one of them from the pick-list.



                                US
                                UK
                                IT
                                GR
                                FR



            Use the arrow keys to highlight your keyboard layout and
         press ENTER to activate that selection.










                                      46






            After your  selection,  the following  Message  Box will
         appear:




                       Accept Information (Y/N) ?     N




            If you  type "N" you  go back to  the Configure Keyboard
         Menu.
            If you  type "Y"  you accept the  Keyboard Configuration
         and go on with the mouse configuration.

         3.9.4 Modifier Keys

            X Appeal  uses a  configuration file  called XAPPEAL.CFG
         for  its initial  setup.  In the  Keyboard section  you can
         specify the following entries

         RightAlt mapping
         Rightctl mapping

          where  mapping  can assume one of these values:

         Meta
         Compose
         ModeShift
         ScrollLock
         Control

            See the  Configuration  File Parameters  chapter  on the
         User Manual for more details.


         3.10 Mouse Configuration




             If you have a two-button mouse, you can emulate the
                                third button
                 by pressing both buttons at the same time.

               Do you want to emulate the third button (Y/N) ?




            If you have a mouse  which has only two physical buttons
         and want  to enable the emulation of the third mouse button
         type "Y",  otherwise type "N". The third button is emulated
         by pressing both buttons simultaneously.





                                      47






         3.11 Activation method



             [Activation method]

              You can start your session using the XDM (X Display
             Manager)
              protocol or using the REXEC protocol.
              The X server can find XDM in one of three ways:
              - it can send a Query to a specific host that is
             running
                the XDM process
              - it can send a Broadcast message to the network to
                find any host that is running the XDM process
              - it can send a message to a host running the XDM
             process
                that will show a list of the hosts accepting
             connections
                using an Indirect query through the chooser
             program.
              Using the REXEC protocol, the X server will send a
             command
              to the remote host that will start an X session.

              Enter (Q) query, (B) broadcast, (I) indirect or (R)
             rexec   [ ]

                                                      [ESC]=Cancel



            If you select Q or  I, the installation program will ask
         the IP address to which you want to send the XDMCP request.
         You  can override this value  at run time,  by specifying a
         different address on the command line.
























                                      48








             [Activation method]

              You can start your session using the XDM (X Display
             Manager)
              protocol or using the REXEC protocol.
              The X server can find XDM in one of three ways:
              - it can send a Query to a specific host that is
             running
                the XDM process
              - it can send a Broadcast message to the network to
                find any host that is running the XDM process
              - it can send a message to a host running the XDM
             process
                that will show a list of the hosts accepting
             connections
                using an Indirect query through the chooser
             program.
              Using the REXEC protocol, the X server will send a
             command
              to the remote host that will start an X session.

              Enter (Q) query, (B) broadcast, (I) indirect or (R)
             rexec   [Q]

              Host IP Address           192.192.192.1

               [F1]=Help                              [ESC]=Cancel































                                      49






            If you select  R, the installation program  will ask the
         IP address and the command that the server will send to the
         remote host to start an X session.



             [Activation method]

              You can start your session using the XDM (X Display
             Manager)
              protocol or using the REXEC protocol.
              The X server can find XDM in one of three ways:
              - it can send a Query to a specific host that is
             running
                the XDM process
              - it can send a Broadcast message to the network to
                find any host that is running the XDM process
              - it can send a message to a host running the XDM
             process
                that will show a list of the hosts accepting
             connections
                using an Indirect query through the chooser
             program.
              Using the REXEC protocol, the X server will send a
             command
              to the remote host that will start an X session.

              Enter (Q) query, (B) broadcast, (I) indirect or (R)
             rexec   [R]

              Host IP Address           192.192.192.1

              Start command:      /usr/X11/bin/xterm  -ls  -display
             192.192.192.192

               [F1]=Help                              [ESC]=Cancel



         In  this case, the authorization to access  the X Server is
         not  handled  automatically  by XDM  like  in  the previous
         cases, and  you need to create a file named X0.HOS in the X
         Appeal configuration  directory, with the IP address(es) or
         host  name(s)  of  the  host(s)  that  will  run  X Clients
         communicating with  this PC. The host(s) must also have the
         rexec daemon enabled (usually in the file inetd.conf).














                                      50






         3.12 Documentation

            After the activation method selection the program allows
         you to extract the manual files during the installation:




                   You can extract the manuals in RTF and in
                 text format into the installation directory.
                   Do you want to extract the manuals (Y/N) ?      




         3.13 Server activation

            If you  have selected to  install more  than one Server,
         the  installation program  allows you  to select  which one
         should be  activated by default. A list of selected Servers
         will be shown as below:



         [ Servers Activation ]

         You selected more than one Server: which one do you want to
         activate?
         Select one from the list below by typing X in the related
         input field.

           [ ] SVGA 256 colors Server    (2.4 Mb)
           [ ] VGA monochrome Server     (1.2 Mb)
           [ ] S3 accelerated Server     (2.6 Mb)
                            .
                            .
                            .
           [ ] AGX accelerated Server    (2.4 Mb)

                                                       [F10]=Confirm





            This  is the  last  interactive  question  and  then the
         installation program begins the archive extraction.













                                      51






         3.14 Slip/PPP


            SLIP is Serial Line IP, that is a way to send IP packets
         on an asynchronous serial line, like the ones used to run a
         normal  terminal  emulation.  The  main  difference between
         normal  serial connections  and SLIP  protocol is  that the
         former  are character-oriented while the  latter is packet-
         oriented,  where  each packet  contains  headers  with data
         relevant  for the  IP protocol. SLIP  links can  emulate in
         many  respects a  "true" network connection,  so it  can do
         things  that a plain  serial line cannot  do, like allowing
         high-level  protocols to  run  on it,  like the  X protocol
         between X clients and X servers.

            To use SLIP on a serial  line, both ends have to "speak"
         SLIP;  this is  easy on the  PC side  (by using  a suitable
         packet  driver), but not so easy on  the host side (if your
         serial  line is  directly hooked  on a  serial port  of the
         host,  the kernel must know how to  handle the line in SLIP
         mode; if  the line is on a terminal server, this box has to
         be configured  to use SLIP). Often the SLIP mode is started
         (manually  or automatically)  after a plain  login sequence
         using   a  character-mode  terminal  emulation;  the  modem
         control  signals   must  remain  active  when  closing  the
         emulation and starting the packet driver on the PC.
            There are also programs  that allow to use this protocol
         on  a plain  shell account (like  the freeware  slipper and
         other commercial programs).

            The  PPP   protocol  is   similar  and   offers  similar
         functionalities plus  a better error checking and automatic
         option negotiation at startup.


         3.15 Environment variables

            The 32 bit  DOS extender included in  X Appeal looks for
         the  environment  variables  GO32TMP,  TMP,  TEMP  (in that
         order)  to locate  the directory where  to create  the swap
         file  used to implement virtual memory. If  none is set, it
         defaults  to the  root directory of  the current  drive. We
         recommend you not to allocate the swap file on a compressed
         drive.

            The configuration  file  XAPPEAL.CFG is  created  in the
         configuration  directory  by  the  XINSTALL  utility during
         installation.
            The  XAPPEAL.CFG location  is  selected  by  setting the
         XAPPEAL  environment  variable to  the directory  where the
         file   is   located;  this   can  be   useful   in  network
         configurations  where  all X  Appeal  executable  and fonts
         files are  on a file server and the configuration files are
         on a local disk.

            Please make sure also you have at least FILES=30 in your
         CONFIG.SYS; lower FILES settings, or the default DOS value,
         may cause X Appeal to abort during initialization.


                                      52








         3.16 Hosts DataBase

            When a name server is  not avalaible, a file named HOSTS
         in  the X  Appeal configuration  directory can  be created,
         with  the same format of the Unix  /etc/hosts file; it will
         allow  you to  use symbolic names  instead of  IP addresses
         where  a host  address is  required (e.g.  on the  X Appeal
         command line in X.BAT and in the XAPPEAL.CFG file).

         HOSTS file example:

         192.192.192.1        juppiter              #Host name
         192.192.192.5        goofy                 #PC number 5
         192.192.192.6        moon                  #Another PC
         192.192.192.2        earth                 #Another Host


         3.17 Activation of the rcp and rsh server functions

            X Appeal contains a rcp and rsh server which allows file
         transfers  to/from the PC  and the execution  of useful DOS
         functions, without leaving the X environment.

            The rcp and rsh server functions are enabled by creating
         a   file  named  RHOSTS  in   the  X  Appeal  configuration
         directory,  containing the host name and  login name of the
         users  which  are  enabled  to  access  the  functions (for
         security  reasons these functions are  disabled if the file
         does  not exist). The format of the  file is the same found
         on  Unix; a '+'  character in a  field enables unrestricted
         access.

            An example of  RHOSTS file:

         juppiter        mark
         192.192.192.2   jeane

            This  enable access  to  rcp/rsh function  for  the user
         mark   from the  server juppiter   and for the  user  jeane
         from the server earth.

         3.18 Advanced configurations

            The  configuration  file   XAPPEAL.CFG  created  by  the
         installation  program is  suitable for starting  X_Mono and
         X_Svga in   8 bpp mode. To start X_Svga in 16 bpp or 24 bpp
         mode,  you should edit the X.BAT  activation script and set
         the options
            -bpp n
         where  n  is  16  or 24.
            The  Accelerated X  Servers  may need  of  more accurate
         setup  to accomodate the hardware in the  best way. See the
         _Configuration file  parameters_ chapter in the User Manual
         for a detailed description of all the options available for
         each Server.



                                      53






                                  APPENDIX A
                  CONFIGURING NDIS to PACKET DRIVER CONVERTER

            Since X  Appeal uses a  packet driver  interface, if you
         installed  a  NDIS driver,  you  should install  a  NDIS to
         packet  driver  converter, such  as DIS_PKT.DOS,  to  run X
         Appeal.

            DIS_PKT.DOS  provides an Ethernet or a Token Ring Packet
         Driver  interface to programs built  to operate over Packet
         Drivers. It  talks to NDIS (3Com/Microsoft) instead of to a
         lan board directly. It shares the board with NDIS users. We
         call this a "shim", sitting between the normal applications
         program (NetWare shells, TCP/IP, etc) and the more hardware
         specific portions (NDIS in this case).

              Packet Driver flavored applications               NDIS
         flavored applications
                        | |                           | |
                        | |                           | |



                 DIS_PKT


                        | |                           | |


                                  main module
                             NDIS
                 .................................
                                  card           specific
                 driver(s)


                                       | |


                                  Ethernet /Token Ring card(s)


                                       | |
                   =================================  Ethernet/Token
         Ring wire


         Setup   for  PCs  with  MicroSoft   Windows  for  Workgroup
         installed.

         Sample of  PROTOCOL.INI  file:

         [network.setup]
         version=0x3110
         netcard=ms$elnkii,1,MS$ELNKII,3
         transport=ms$ndishlp,MS$NDISHLP
         transport=ms$netbeui,NETBEUI
         lana0=ms$elnkii,1,ms$netbeui


                                      54






         lana1=ms$elnkii,1,ms$ndishlp

         [protman]
         DriverName=PROTMAN$
         PRIORITY=MS$NDISHLP

         [MS$ELNKII]
         DriverName=ELNKII$
         MAXTRANSMITS=12
         INTERRUPT=3
         IOADDRESS=0x280
         TRANSCEIVER=onboard

         [ELNKII]
         Adapters=MS$ELNKII

         [MS$NDISHLP]
         DriverName=ndishlp$
         BINDINGS=MS$ELNKII

         [NETBEUI]
         DriverName=netbeui$
         SESSIONS=10
         NCBS=12
         BINDINGS=MS$ELNKII
         LANABASE=0

         [PKTDRV]                 <-- name of this driver entry
         DriverName=pktdrv$       <-- formal driver name
         BINDINGS=MS$ELNKII         <-- use your board's NDIS driver
         here
         INTVEC=0x60              <-- Packet Driver Int, 60h..7fh


         Sample of  SYSTEM.INI  file:

         [386Enh]
         EMMExclude=c800-c9ff            <-- Exclude Board Dual Port
         RAM

         [network drivers]
         netcard=elnkii.dos
         transport=ndishlp.sys,*netbeui,dis_pkt.dos
         devdir=C:\WINDOWS                  ^^^^^^^^^^^------- to be
         added
         LoadRMDrivers=Yes              <-- Set this to _Yes_

         DOS_PKT.DOS should be copied into the WINDOWS directory.



            Copyright notice  and disclaimer  from the  beginning of
         the source code file dis_pkt.asm:

         ;DIS_PKT.ASM-Adapter provides Packet Driver v1.09 interface
         over NDIS.
         ;Version  1.07  18 May 1991   by Joe R. Doupnik, Utah State
         Univ.


                                      55






         ;Version   1.08       9   Aug   1991   by   Dan   Lanciani,
         ddl@harvard.harvard.edu
         ;Version  1.09  3  Nov 1991 by  Joe R.  Doupnik, Utah State
         Univ.
         ;Copyright (C) 1988 - 1991 FTP Software, Inc.

            This unmodified source file and it's executable form may
         be  used  and  redistributed freely.    The  source  may be
         modified, and  the source or executable versions built from
         the modified source may be used and redistributed, provided
         that  this  notice  and  the  copyright  displayed  by  the
         exectuable remain  intact, and provided that the executable
         displays an  additional message indicating that it has been
         modified, and by whom.

            FTP Software Inc.  releases this software  "as is", with
         no express  or implied warranty, including, but not limited
         to,  the implied warranties of  merchantability and fitness
         for a particular purpose.

         USE AT YOUR OWN RISK.







































                                      56






                                  APPENDIX B
                  CONFIGURING ODI to PACKET DRIVER CONVERTER

            Since X  Appeal uses a  packet driver  interface, if you
         have  installed a ODI driver,  you should install  a ODI to
         packet  driver  converter,  such as  ODIPKT.COM,  to  run X
         Appeal.

            Odipkt.com provides  a Packet  Driver API  over Novell's
         Open  Data-Link    Interface,  allowing  a  single  network
         adapter  to service IPX, tcp/ip,  and other protocol stacks
         which    use  packet    drivers.  Odipkt.com    understands
         Ethernet, Token Ring, and ARCnet frame types.
            Ethernet  and   Token  Ring  frames are passed unchanged
         to  packet driver  applications,  but ARCnet   frames   are
         internally   mapped   to  Ethernet.  Thus,   packet  driver
         applications   do  not need specific knowledge of ARCnet in
         order to operate in  such  environments.

         The syntax to activate ODIPKT is:

         odipkt [ logical_board [ vector ] ]

            The  logical_board  argument   indicates  which  logical
         adapter  odipkt should bind to.  Under  ODI, there  is  one
         logical  adapter  per  frame   type.  There may be multiple
         physical  adapters, and multiple frame  types per  physical
         adapter.  The  logical adapter  number starts  at  zero and
         increases  by one for each  frame type. For example,  if  a
         system   contained  two  physical   adapters with two frame
         types each,  there would be four logical adapters  numbered
         0-3.
            The frame   types    are specified  in the  NET.CFG file
         which  must be in the  current directory (or  on the APPEND
         path)   when  the ODI drivers  are loaded.  Typically,  the
         frame  type used by default  by Netware on  a given adapter
         will not be  appropriate  for  tcp/ip.
            The correct  frame  type  for   tcp/ip  on Token Ring is
         TOKEN-RING_SNAP  and the correct  frame type  for tcp/ip on
         Ethernet    is   almost   always  ETHERNET_II.  Assuming an
         existing installation  with one adapter running the default
         Netware frame  type, it will usually be necessary to define
         a  second frame type (as  listed above) and  to specify the
         logical_board   argument  as  1.  An exception to this rule
         is ARCnet which uses only one frame type.
            Below is a  NET.CFG entry for a  3c501 using the default
         address  and interrupt.  Other Ethernet adapters  would use
         similar configurations:

         Link driver 3c501
             envelope type ETHERNET_802.3
             envelope type ETHERNET_II

            Given the  above  entry, the  logical_board  argument of
         oipkt would be 1. Token Ring uses different frame types:

         Link driver token
             envelope type TOKEN-RING


                                      57






             envelope type TOKEN-RING_SNAP

            Again, the  logical_board should  be specified as  1 for
         this  example. ARCnet  installations require  no frame-type
         definitions and should use a logical_board of 0.

             Because  odipkt.com  uses buffers provided  by the Link
         Support  Layer, the Link  support section of   NET.CFG must
         specify  at   least  one  buffer  of  a size appropriate to
         the  medium in use.  Some adapters   require  more  buffers
         for  optimal performance, e.g., the 3c503  can use at least
         five   during  reception   of  back-to-back   packets.  The
         following  lines  configure five  buffers large  enough for
         Ethernet:

         Link support
             Buffers 5 1600

         The correct  buffer size for Token Ring will vary depending
         on the  installation.  Specifying too small a  buffer  size
         will result in unpredictable behavior.

         Vector   is the packet driver interrupt at which to provide
         service.  The default is 105 and the parameter is decimal.


         How to load odipkt

            Odipkt.com  should  be  loaded  after  lsl.com  and  the
         adapter-specific driver(s).   It must, of course, be loaded
         before   the  packet driver applications which use it.  The
         Netware  shell and  ipxodi.com can  be loaded   before   or
         after  the odipkt.com program.

            For example, assuming you have a 3C523 adapter:

             LSL
             3C523
             ODIPKT 0 0x60
             IPXODI
             NETX

            In this  case, your  packet driver applications  (i.e. X
         Appeal) should use software interrupt hex 60.

             For a PC with extended memory, HIMEM.SYS and EMM386.SYS
         loaded:

             LH LSL
             LH 3C523
             LH ODIPKT 0 0x60
             LH IPXODI
             LH NETX

            Depending on what other drivers and TSRs you are loading
         and  what memory management  software you  are running, you
         may  end up with  more free conventional  memory by loading
         only IPXODI  and NETX high (and perhaps LSL also if you are


                                      58






         allocating   additional  buffer   space  for   the  network
         software).


         Changes to NET.CFG

            Below there are some sample of  NET.CFG.
            Any frame and  protocol types that ODIPKT  will use must
         be entered in NET.CFG.

         Fist sample
            A typical NET.CFG for  IPXODI using Novell's "raw-802.3"
         framing,  and a TCP/IP  stack using ODIPKT  and Ethernet II
         (DIX) framing would look like:

             Show Dots = On

             Link Support
                 Buffers 6 1600

             Link Driver 3C523
                 Frame Ethernet_II
                 Frame Ethernet_802.3
                 Protocol IPX 0 Ethernet_802.3

            ODIPKT version 3.0 requires  you to reserve Link Support
         buffers  as shown  in this example.   It  will not  not run
         unless  at least  two are provided.   They  must be greater
         than the Ethernet Frame size for overhead information to be
         stored.   This  is why 1,600  bytes are  allocated for each
         buffer.  Failing to do this will result in GPFs.

            An ODI  driver  creates a  "logical interface"  for each
         frame  type. In this example, Ethernet  II is listed first,
         because  when we loaded ODIPKT we specified  for it to used
         the  first virtual interface (the first  argument is "0" in
         the command "ODIPKT 0 0x60").

         Second sample
             If  your NetWare  server is  using Ethernet  II framing
         instead  of Novell's "raw-802.3" framing,  then the NET.CFG
         file should look like:

             Show Dots = On

             Link Support
                 Buffers 6 1600

             Link Driver 3C523
                 Frame Ethernet_II
                 Protocol IPX 8137 Ethernet_II


         Incompatibilities with other DOS TSR
            If you  are running  the DOS  version of  AfterDark (AD-
         DOS.COM), don't  load it until after you load ODIPKT (note:
         this has been fixed in ODIPKT  v2.1+).



                                      59







         Copyright
            ODIPKT was written by Dan  Lanciani.  It is available by
         anonymous   ftp  at  hsdndev.harvard.edu  (now  aliased  to
         ndtl.harvard.edu,    128.103.65.126)   in   the   directory
         /pub/odipkt.






















































                                      60
