Wabi 2.2 Beta Installation Instructions

These instructions are for use by people who have downloaded
Wabi 2.2 Beta for Solaris on SPARC, x86, or PowerPC.
  


SYSTEM REQUIREMENTS
-------------------

System requirements for installing and running Wabi(TM) 2.2 Beta for 
Solaris are listed below:

Computer and Operating System

    o  Ultra(TM) systems, SPARCstation(TM) models, SPARCserver(TM) models, 
       SPARCcenter 2000, and SPARCcluster(TM) 1 running the Solaris 2.4, 
       2.5, or 2.5.1 operating environment. (SPARCclassicTM and SPARC-LX 
       models are not recommended for running Wabi.)
     	
    o  386-based, 486-based, or Pentium-based computers running the 
       Solaris 2.4, 2.5, or 2.5.1 operating environment.

    o  PowerPC-based computers running the Solaris(TM) 2.5 or 2.5.1 
       operating environment.

Display

    o  1-bit, 4-bit, 8-bit, or 24-bit pixel-depth displays.
    o  24-bit displays are supported using 8-bit PseudoColor mode, not
       TrueColor.

Memory

    o  48 Mbytes recommended (minimum of 24 Mbytes) on SPARC computers; 
       64 Mbytes recommended for "power" users.
       
    o  32 Mbytes recommended (minimum of 16 Mbytes) on x86 computers.
    
    o  32 Mbytes recommended (minimum of 24 Mbytes) on PowerPC
    

Swap Space

    o  At least 20 Mbytes of available (free) swap space
       (60 Mbytes recommended for SPARC and PowerPC; 40 Mbytes for x86).

       The Wabi program does not start unless you have at least 20 Mbytes of 
       available swap space. The more applications you plan to run 
       concurrently, the more swap space you will need. Allow 10 Mbytes of 
       swap space for each additional application you wish to 
       run concurrently.

       (The UNIX swap -s command provides information about total swap space 
       and available swap space on your system.) 

Disk Space

    o  20 Mbytes of disk space for the Wabi system directory.

    o  A minimum of 9 Mbytes of disk space in your home directory for 
       personal Wabi files and Microsoft Windows files. A minimum 
       of 13 Mbytes is required if installing Microsoft Windows for 
       Workgroups.

    o  Adequate disk space for installing applications and storing data files
       for applications. See the application documentation for information 
       about disk space required.



INSTALLING THE WABI PACKAGE
---------------------------

To install the Wabi software, you must:

    o  Remove any patches installed for previous versions of Wabi.

    o  Remove previous versions of Wabi.

    o  Install the new Wabi package.

    o  Start the Wabi program to create or update your Wabi user directory. 

    o  Install or reinstall Microsoft Windows software if upgrading from
       Wabi 2.0 or Wabi 1.x.  (Microsoft Windows is not included in the
       Wabi package.)


Before removing any previous versions of Wabi, remove any Wabi patches
you may have installed.  To find out if you have installed patches, become
root and enter the showrev command as follows:

	su
	showrev -p | grep SUNWwabi
	
If you have installed patches, this command will return one or more lines
similar to the following:

Patch: 102330-02 Obsoletes: Packages SUNWwabi 2.0, PATCH=2

Remove the patch with the command:

	/var/sadm/patch/<patch-id>/backoutpatch <patch-id>
	
The patch-id in the above example is 102330-02.
	

Before installing Wabi 2.2 Beta, remove any previous versions
of Wabi. To do so, become root and enter the pkgrm command, as follows:

	su
	pkgrm SUNWwabi


By default, Wabi is installed in the /opt directory.  You must
have 20 Mbytes of free disk space there.  If you do not have
20 Mbytes of free space in /opt, see the note in step 4 below for 
directions on making a symbolic link from /opt to a directory with 
more space.  

To install the Wabi software

1.  Change directory to the location of the extracted files     
    downloaded from the Web and enter the following pkgadd command
    as follows:

	cd <tar-file-directory>	
	pkgadd -d wabi.dir
	
    where <tar-file-directory> is the directory where you unpacked 
    downloaded tar file.

   The pkgadd program displays a message similar to the following:

   --------------------------------------------------------------------
   Select an installation option:

   The following packages are available:

	1 SUNWwabi		Wabi Application

   Select package(s) you wish to process (or "all" to process 
   all packages).  (default all)  [?,??,q]:
   --------------------------------------------------------------------

2. Press Return to select the Wabi Application package.

3. pkgadd begins processing the Wabi Application package. 

   If Volume Manager's control of the diskette drive is disabled on your
   system, skip to step 4. 

   If Volume Manager's control of the diskette drive is enabled on your 
   system, pkgadd displays the following:
   
   --------------------------------------------------------------------
   To use your diskette drive under Wabi, we recommend that you 
   disable Volume Manager's control of the diskette drive.
   
   Would you like this done now? Yes or No [y,n,?,q]
   --------------------------------------------------------------------
   
   Enter y to disable Volume Manager's control of the diskette drive.
   
   If you will not be using diskettes with the Wabi program and want to use 
   diskettes with Volume Manager in the Solaris environment, enter n.
   
   The pkgadd program disables Volume Manager's control of the diskette 
   drive if you enter y. See the Wabi Release Notes for information about  
   scripts you can use to enable and disable Volume Manager's control of 
   the diskette drive at any time.
   
4. pkgadd then prompts:

   --------------------------------------------------------------------
   This package contains scripts which will be executed with 
   super-user permission during the process of installing this 
   package.
   
   Do you want to continue with the installation of this package 
   [y,n,?]   
   --------------------------------------------------------------------
   
   Enter y to proceed with the installation.
   
   File names and system messages are displayed.


   Note - The Wabi package is installed in the /opt directory by default. If 
   pkgadd indicates the file system has insufficient disk space, create a
   symbolic link from /opt to a directory on a file system with adequate disk
   space and then enter the pkgadd command again. For example, to create a 
   link to the /usr directory, enter the following commands as root:

   	 mkdir /usr/SUNWwabi
   	 cd /opt
   	 ln -s /usr/SUNWwabi SUNWwabi

   --------------------------------------------------------------------
   If you do make a link like this, pkgadd will return this message:

   The following files are already installed on the system and are 
   being used by another package:

         /opt/SUNWwabi <attribute change only>

   Do you want to install these conflicting files?
   --------------------------------------------------------------------
       
   If you see this message, answer y.


   As the installation nears completion, you may see the following message:

   --------------------------------------------------------------------      
   If you would like to use the UNIX serial ports in Wabi, please 
   run the following command as root:
   
   	 chmod 666 /dev/cua/*
   
   This gives ordinary users read/write permissions to the 
   serial devices, allowing them to use these ports from Wabi.   
   --------------------------------------------------------------------
      
   If you do not do this, Wabi users on this system will not be able to use 
   Wabi COM ports for serial devices such as modems and local serial printers.
   
   When all Wabi files have been installed, the following message is 
   displayed:

   --------------------------------------------------------------------      
   Installation of <SUNWwabi> was successful.   
   -------------------------------------------------------------------- 
     
   The initial pkgadd menu redisplays:

   --------------------------------------------------------------------      
   Select an installation option:
   
   The following packages are available:
   
   	1  SUNWwabi		Wabi Application
   
   Select package(s) you wish to process (or "all" to process 
   all packages).  (default all)  [?,??,q]:   
   --------------------------------------------------------------------
        
5. Enter q to quit the pkgadd program.

6. Remove the wabi.dir directory and the tar file downloaded from the Web,
   using the following commands:
	
	rm -r wabi.dir 
	rm <filename>.tar


   
STARTING THE WABI PROGRAM
-------------------------
   
When you start Wabi for the first time, the Wabi program creates or updates 
your personal Wabi user directory, including several subdirectories. By 
default, this directory is named $HOME/wabi. If you are upgrading from a 
previous Wabi release, your existing $HOME/wabi directory and its 
contents are preserved. 

During this process, the Wabi program checks for adequate space in your 
personal Wabi user directory. If there is not enough space, the Wabi 
program warns you and stops the process. If this happens, remove 
items as necessary from your home directory (or the directory 
in which your Wabi user directory is located) to free up space.


Note - You can tell the Wabi program to create your personal Wabi directory 
in a location other than the default by setting the WABIDIR environment 
variable before you start Wabi. You can do this in the C shell by using 
the following command:

     setenv WABIDIR pathname

pathname is the full path name of your personal Wabi directory. Include this 
statement in your .cshrc file (C shell) if you want to use this directory 
each time you start Wabi.


To start the Wabi program:
   
1. If you are still in a superuser session, return to normal user status by 
   entering the exit command.
   
2. At the command prompt enter:
   
        /opt/SUNWwabi/bin/wabi &
   
   The Wabi program creates or updates your personal Wabi directory under 
   your home directory (or the directory to which the WABIDIR environment 
   variable points). 
   
   If you are upgrading from Wabi 2.1 or a previous Wabi 2.2 Beta, 
   installation is complete.  
   
   If you are upgrading from Wabi 2.0 or Wabi 1.x, continue to step 3.
      
3. Install Microsoft Windows software, following the instructions that 
   are displayed. 
    
   Microsoft Windows software is not included in the Wabi package; you must 
   use your own licensed copy of Microsoft Windows 3.1, 3.11, or Windows for 
   Workgroups 3.11.
   
   If errors occur during the Windows installation, please see the file 
   /opt/SUNWwabi/lib/locale/en_us/wabi/win_inst_err.txt for details.    
   
   Note - If you are installing Microsoft Windows from diskettes and see a
   "drive not ready" error message, make sure no other program is using the
   diskette drive. 
   
   Refer to Chapter 2, "Starting the Wabi Program," in the Wabi User's Guide, 
   for more detailed information about starting Wabi software for the 
   first time and installing Microsoft Windows.
   
   When the Windows installation is complete, you are prompted to restart the 
   Wabi program.

   
4. Choose OK to restart the Wabi program.
   
   When the Wabi program restarts, the Windows Program Manager window 
   opens, displaying the Main, Accessories, Startup, Games, and Wabi Tools 
   program groups.
   
   This completes the Wabi software installation process. You can now
   install Windows applications. 
  

HOW TO PROCEED
--------------

Read the Wabi Release Notes, available in the Wabi Tools program group, 
to find late-breaking information about this version of Wabi software. 
The release notes also include a summary of what's new in this release and 
notes about the certified applications.

You can print a Postscript copy of a Wabi 2.2 beta draft of the Wabi User's 
Guide, user.ps, located in the wabi.dir directory, which you 
downloaded from the Web.


FOR MORE INFORMATION
--------------------

If you have questions about Wabi software, and you are on the Internet, 
use the Wabi Frequently Asked Questions (FAQ) database. You can access this 
database by sending e-mail to:

     wabi-questions@east.sun.com

If you have Mosaic or a similar Internet browser, you can get more 
information about Wabi software and SunSoft PC Desktop Integration products 
in general from the World Wide Web at the following location, or URL:

     http://www.sun.com/sunsoft/Products/PC-Integration-products