<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>INSTALLATION OF THE BINARY:</TITLE>
</HEAD>
<BODY BGCOLOR="#efefef" TEXT="black" LINK="blue" VLINK="#551A8B" ALINK="red">

<A HREF="DGux.html"><EM>Instructions for Building XFree86 on an Intel Pentium Aviion machine with DG/ux R4.20MU04</EM></A>
 <b>:</b> <EM>INSTALLATION OF THE BINARY:</EM><BR>
<b>Previous:</b> <A HREF="DGux5.html"><EM>BUILD </EM></A><BR>
<b>Next:</b> <A HREF="DGux7.html"><EM>What is about:</EM></A>


<HR NOSHADE>
  <H2><A NAME="6"></A>6. INSTALLATION OF THE BINARY:</H2>

<p>NOTE:This executable has been compiled with the macro -DPENTIUM_CHANGE
(that all the new Aviion machines support). If you have an old i486
(rather unlikely) the executable will NOT RUN correctly.
But we havent use -mcpu=pentiumpro, so the executable will work on
ALL PENTIUM machines.</p>
<p>
<ul>
<li> About Project Root: I choose as ProjectRoot for ix86 DG/ux the location
/usr/X11R6.3. The default (in 3.3.5 sources) is the /usr/X11R6. To
cover this we make a link in /usr as X11R6-&gt;X11R6.3 (read below)
;so dont forget to do this link. I dont like the location /usr/opt/X11
(default location of DG X11) that some of you have suggested to me, I
believe it is a good idea to keep the original X11 as is for several
reasons.
</li>
<li> Make a filesystem,using sysadm, mounted under "/usr/X11R6.3".
This is the default location of X11R6.3 , you cannot change this
except if you recompile the whole source of X.
(Please dont send e-mails about this).
The size of this filesystem should be around 175 MB(350000 blocks).

The list of files is:

<pre>
  X3353DL.tgz    3D_Labs XServer ... etc
  X3358514.tgz
  X335AGX.tgz
  X335I128.tgz
  X335Ma32.tgz   Mach32 Xserver
  X335Ma64.tgz   Mach64 Xserver
  X335Ma8.tgz
  X335Mono.tgz
  X335P9K.tgz
  X335S3.tgz
  X335S3V.tgz
  X335SVGA.tgz   SuperVGA Xserver (Supports AV3700 Cirrus)
  X335VG16.tgz   VGA16 Xserver (needed by XF86Setup)
  X335W32.tgz
  X335bin.tgz    BIN (you must have this)
  X335cfg.tgz
  X335doc.tgz
  X335f100.tgz
  X335fcyr.tgz
  X335fnon.tgz
  X335fnts.tgz
  X335fscl.tgz
  X335fsrv.tgz
  X335lib.tgz    LIB (you must have this)
  X335lkit.tgz   Linkkit (X development)
  X335man.tgz    Man pages
  X335nest.tgz
  X335prog.tgz
  X335prt.tgz
  X335set.tgz
  X335vfb.tgz
  preinst.sh    Install script
  extract        The XFree86 extract program (for ix86 DG/ux)

  SUMS.md5       CheckSums for the integrity of the files
</pre>

(Try compile the GNU textutils-1.22.tar.gz from
prep.ai.mit.edu /pub/gnu. md5sum is there).
<p>You need at least:
<pre>
  X335bin.tgz
  X335lib.tgz
</pre>

And the correct Xserver for your machine/Graphics card.
In my opinion take all files , in the future you may need to
switch to another graphics device etc ... (mget *).
Generally it is good to have the full distribution of the
X11R6.3 window system ,it should make life easier in DG/ux.</p>
<p>(Trivial:you must have root privilege).</p>

</li>
<li> Unpack the *.tgz files in your / so that it will go directly inside to
the new filesystem /usr/X11R6.3. After you do that cd /usr and do a link :
ln -s X11R6.3 X11R6. (Use the install script).
This link will indicate in XF86 programs like XF86Setup where the new X11
window system is.
</li>
<li> cd your home dir and backup your .profile as "cp .profile myprofile". Then
cd /usr/X11R6.3. Copy the file HOME.profile-X11R6.3 to your home dir as
"cp HOME.profile-X11R6.3 your home dir/.profile" ,then cd your home dir and
"chmod 644 .profile" to make sure that the new profile is active. This is
because you need to tell to the system to look for the X software in a
different location than the usual /usr/bin/X11 of DG/ux. Also you need
to tell to the system that the new X libraries are in /usr/X11R6.3/lib.
<p>**You NEED to re-login in order to make the new .profile active !**
** DO NOT GIVE "startx" AFTER THAT, READ Configuration below !**</p>

</li>
<li> About Configuration:
DG/ux has a program (actually a script) called xconfig that makes the
configuration for you. Usually when you run xconfig in the DG/ux-X11R5
it creates a file XdgConfig in /var/X11/Xserver which is the corresponding
of the XF86-configuration file located in /usr/X11R6.3/lib/X11/XF86Config.
This file ,in the section monitor, has all values for your monitor.
Please Note:
Unfortunately in DG/ux R4.20MU02 things change. Instead of going forwards we
going backwards... xconfig reports crazy values for my DG-DA1765VA monitor.
So if you have a CDROM of DG/ux R4.11MU02,or MU03 use it to find an xconfig
that will give you reliable values for your monitor.
<p>Your best bet is to use XF86Setup for correct adjustments.</p>
<p>Thats the reason that in this binary there is a mininum tcl,tk(version 8.0).
Before you run XF86Setup read the relevant documents found in www.xfree86.org.
(Or read below for a hand-made configuration).</p>
<p>Notice about XF86Setup: You will will see the message
"The program is running on a different virtual"
"Please switch to the correct virtual terminal"</p>
<p>DG/ux does NOT have any virtual terminals. But XF86Setup uses a script
that doesnt checks for this. So it is printing this message anyway.
Ignore it and dont send e-mails asking how to set the virtual terminal!
XF86Setup WORKS for SURE (if you use it correctly) to set your configuration.
Just remember:
<ol>
<li> make a link in /usr/X11R6.3/bin: ln -s XF86_VGA16 X</li>
<li> set mouse device in your XF86Config to /dev/mouse (this the mouse in DGUX)</li>
<li> set the correct mouse protocol. (usually for a typical AViiON PS/2).</li>
</ol>

Or just cd /usr/X11R6.3/lib/X11 and copy XF86Config.eg.dgux to XF86Config
(it is for a PS/2 protocol mouse that almost all AViiON's have) , then
run XF86Setup and choose to use this XF86Config file as default (so mouse
works).</p>
<p>Alternatively, you can run xf86config, a non-graphical configuration utility
but you will need to enter manually the values for your monitor.
If you have the small booklet that came with the monitor they are inside.</p>
<p>Hand made configuration:
I have an DG/ux Medium resolution (1280x1024) 17 inch DG-26059,DA1765VA.
<b>ONLY IF YOU HAVE THE
***EXACT SAME***
MONITOR USE THE FILE XF86Config_SVGA_DGUX that you will find in /usr/X11R6.3/.
IT IS IN YOUR OWN RISK IF YOU DECIDE TO USE THIS FILE WHEN YOU DONT HAVE THE
SAME MOTINOR AS MINE. YOU CAN DAMAGE YOUR VIDEO MONITOR OR YOUR GRAPHICS CARD.</b></p>
<p>An examble of how to use the Accel Servers (eg ATI=XF86_Mach64) is in the file
XF86Config_ATI_DGUX.
Again remember:
I have an DG/ux Medium resolution (1280x1024) 17 inch DG-26059,DA1765VA.
<b>ONLY IF YOU HAVE THE
***EXACT SAME***
MONITOR USE THE FILE XF86Config_ATI_DGUX that you will find in /usr/X11R6.3/.
IT IS IN YOUR OWN RISK IF YOU DECIDE TO USE THIS FILE WHEN YOU DONT HAVE THE
SAME MOTINOR AS MINE. YOU CAN DAMAGE YOUR VIDEO MONITOR.</b></p>
<p>Start with the file XF86Config.eg as a prototype. READ the REAME.Config .
In Cirrus chips you need to read the file README.cirrus located in /usr/X11R6.3
There is a problem with the accelarated XAA code ,so you need to try to put
the following option in your XF86Config:
<pre>
  Option "no_mmio" (in Section Screen ,subsection display).
</pre>

Look in the XF86Config_SVGA_DGUX to see how this can be done .
If this doesnt work (it will probably) try Option "noaccel" or "no_bitblt".Again
READ the file README.cirrus (and README.Config).
I suggest to print (in paper) the file XdgConfig and have a look in it. Then it
should be quite trivial to figure out what you have to do with the XF86 file
ie XF86Config in the sections mouse, keyboard, screen ...
After you have a correct XF86Config in /usr/X11R6.3/lib/X11 give
<pre>
  chmod 444 XF86Config.
</pre>
</p>
<p>Supposing that you have already  re-login so that the new .profile is active
and you have the correct XF86Config file (as your XdgConfig suggest) (DO not
forget for a cirrus to put the Option "no_mmio" in section screen !), give
startx and the new X11 will start .
Remember: You can shut down at any point the Xserver by pressing
CONTROL+ALT+BACKSPACE (if something goes wrong).
Also Xservers dont produce messages unless to want them to do so. This is
because the DG/ux console driver some times causes corruption of the screen
if you print text during the startup of the Xserver.
If you require messages try in bash shell to give: (bash# )
<pre>
  X -verbose &gt;&amp; info1  or even
  X -verbose -verbose &gt;&amp; info2 for more messages.
</pre>

Then when the server is up press CONTROL+ALT+BACKSPACE to shutdown the
Xserver. File info1 (or info2) have all relevant info about your graphics
card , display memory etc ...
I suggest you do that at least one time before start using the new X11R6.3.
Read this info file to see if all ok. If not try change settings in your
XF86Config to make thinks correct.</p>
<p>If you have an ATI Rage II (or RageII+) use the server XF86_Mach64 (make
a link link X---&gt;XF86_MACH64, or run xf86config, or use XF86Setup above).</p>

</li>
<li> If you want to compile programs with the X11R6.3 the headers in /usr/include
/X11 pointing to /usr/opt/X11 of DG/ux is a problem .
Do:
<p>a): unmounting the /usr/opt/X11 will prevent the sysadm to use the X
graphical interface. But this will be the only thing that you loose.
The correct thing to do for X11R6.3 is to delete the filesystem /usr/opt/X11
and make a link /usr/opt/X11---&gt;/usr/X11R6.3 , so that the libraries
from dglib and /usr/lib point correctly to the new ones in /usr/X11r6.3/lib.
Before you unmount this filesystem you need to do this:
<pre>
  cd /usr/opt/X11/include
  cp -r Mrm    /usr/X11R6.3/include
  cp -r uil    /usr/X11R6.3/include
  cp -r Xm     /usr/X11R6.3/include
  cd /usr/X11R6.3/include
  ln -s uil Uil
</pre>
</p>
<p>LIBRARIES:
<pre>
  and cd /usr/opt/X11/lib
  cp libXm.a       /usr/X11R6.3/lib
</pre>
</p>
<p>and similarly copy the following libraries:</p>
<p>
<pre>
  libX11.so.2, libX11.so.5, libXIM.so.1, libXaw.so.1, libXaw.so.2,
  libXext.so.2, libXi.so.2, libXimp.so.1, libXm.so.2, libXmu.so.2,
  libXsess.so.1, libXsi.so.1, libXt.so.2, libXt.so.5.0, libMrm.a,
  libUil.a, libX11_s, libXR4sco_s 
</pre>
</p>
<p>into /usr/X11R6.3/lib.</p>
<p>Then cd /usr/X11R6.3/lib and make links:</p>
<p>
<pre>
  ln -s libXm.so.2 libXm.so
  ln -s libXm.so.2 libXm.so.1
  ln -s libXm.so.2 libXm.so.5.0

  ln -s libX11.so.5.0 libX11.so.1 

  ln -s libXIM.so.1 libXIM.so.5.0 

  ln -s libXaw.so.2 libXaw.so.5.0

  ln -s libXext.so.2 libXext.so.5.0
  ln -s libXext.so.2 libXext.so.1

  ln -s libXi.so.2 libXi.so.1
  ln -s libXi.so.2 libXi.so.5.0

  ln -s libXimp.so.1 libXimp.so.5.0

  ln -s libXmu.so.2 libXmu.so.5.0

  ln -s libXt.so.2 libXt.so.5.0

  ln -s libXsi.so.1 libXi.so.5.0

  cd /usr/X11R6.3/lib
  rm libXmu.so (to avoid undefs when building X software)
</pre>
</p>
<p>Also you need to correct the links in /usr/dglib at least!
(the correct thing to do is modify also /usr/lib links to
/usr/opt/X11 libs).
Try 
<pre>
  cd /usr/
  tar -cvf dglib-orig.tar dglib
  gzip dglib-orig.tar 
</pre>

(to minimize the space dglib-backup takes) then
<pre>
  cd /usr/dglib 
</pre>

and delete ALL links to libraries in
/usr/opt/X11. Then copy the script create_new_links_in_dglib (found
in /usr/X11R6.3 to /usr/dglib and cd /usr/dglib execute script.
This will create all new links with the X11R6.3 X window system.</p>
<p>But remember to do in the end :</p>
<p>
<pre>
  cd /usr/dglib
  rm *.a (no static libs links in dglib)
</pre>
</p>
<p>Then unmount (delete) the old X11 by giving "umount /usr/opt/X11".</p>
<p>NOTE: If you compile programs in the X11R6 make sure that you
unmount /usr/opt/X11 or you eliminate the links in /usr/lib
to the OLD libX's in /usr/opt/X11/lib.
Otherwise gcc will link these old libraries! and the binary will
not run correctly.
Always after an R6 compilation do "ldd prog" to make sure that the
binary loads only R6 version libraries (except maybe the motif
library libXm.so.2), --if you dont use the static libXm.a</p>
<p>b:)
<pre>
  cd /usr/include
  tar -cvf old-X11headers.tar X11
  gzip old-X11headers.tar
</pre>

so that you store your old headers in /usr/include.</p>
<p>Then cd /usr/include/  and delete
<pre>
       rm -r X11
       rm Xm
       rm Mrm
       rm Uil
       rm uil
  Make new links as:
  cd /usr/include
  ln -s ../X11R6.3/include/X11 X11
  ln -s ../X11R6.3/include/uil Uil
  ln -s ../X11R6.3/include/uil uil
  ln -s ../X11R6.3/include/Xm  Xm
  ln -s ../X11R6.3/include/Mrm Mrm
</pre>
</p>
</li>
</ul>
</p>

 <HR NOSHADE>
<A HREF="DGux.html"><EM>Instructions for Building XFree86 on an Intel Pentium Aviion machine with DG/ux R4.20MU04</EM></A>
 <b>:</b> <EM>INSTALLATION OF THE BINARY:</EM><BR>
<b>Previous:</b> <A HREF="DGux5.html"><EM>BUILD </EM></A><BR>
<b>Next:</b> <A HREF="DGux7.html"><EM>What is about:</EM></A>



</BODY>
</HTML>
