Wabi 2.1 Beta for Solaris on PowerPC Installation Instructions

These instructions are for use by people who have downloaded
Wabi for Solaris on PowerPC from the Web.
  


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

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

Computer and Operating System

    o  PowerPC-based computers running the Solaris(TM) 2.5 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  32 Mbytes recommended (minimum of 24 Mbytes).

Swap Space

    o  At least 20 Mbytes of available (free) swap space
       (60 Mbytes recommended).

       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 AND WABI ANSWERBOOK
-----------------------------------------------

To install the Wabi software, you must:

    o  Install the new Wabi package and, optionally, the Wabi Answerbook 
       package

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

    o  Install or reinstall Microsoft Windows software (not included in the 
       Wabi package)


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

	su
	pkgrm SUNWwabi SUNWaws

Use the pkgadd command to install the Wabi program package and the Wabi 
2.1 Answerbook package. (You must have Answerbook viewing 
software installed on your system to view the Wabi 2.1 Answerbook. For 
information, refer to your Solaris documentation. Alternativeely, you
can print the provided user.ps file, a Postscript file of the user's 
guide.)

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 7 below for 
directions on making a symbolic link from /opt to a directory with 
more space.  

To install the Wabi software and on-line documentation

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

   The pkgadd program displays a message similar to the following:

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

   The following packages are available:

	1 SUNWaws 		Wabi 2.1 Answerbook

	2 SUNWwabi		Wabi Application

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

2. Press Return to select both the Wabi 2.1 Answerbook and Wabi 
   Application packages.

   If you do not want to install the on-line documentation now, enter 2 to 
   select just the Wabi Application and skip to step 6 to continue. 
   You can install the documentation package at a later time. 

   If you selected both packages, the pkgadd program installs the Answerbook 
   package first. The pkgadd program displays copyright information for the 
   Answerbook, and then displays the following prompt:
   
   --------------------------------------------------------------------
   The installation options are as follows: 
   
   Option: Description:
   --------------------
   1. nil: less than 1 Megabyte disk space required [slowest performance].
   2. heavy: 3.34 Megabytes disk space required [best performance].
   
   Note:  If the install option which you choose below fails
   	  due to lack of space, try another location.
   
   Enter the number of an installation option from the list above (1 or 2).   
   --------------------------------------------------------------------
   
3. Enter 2, the heavy option to install Wabi Answerbook.
   
   1, the nil option, is only applicable to a CD-ROM install. 
   With this option, you must have the CD-ROM in the drive to 
   use the Answerbook.  
   
   After you enter option 2, pkgadd prompts you for the parent 
   directory for the Answerbook.
   
4. Enter the name of the directory where you want to install the Wabi 2.1 
   Answerbook package.
   
   Specify a parent directory on a file system with at least 3.34 Mbytes
   of free space; /opt is the usual choice.
   
   The pkgadd program 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 <SUNWaws> [y,n,?]   
   ---------------------------------------------------------------------
   
5. Enter y to proceed.
   
   File names and system messages are displayed.
   
   When installation of the Wabi 2.1 Answerbook is complete, pkgadd 
   displays the following:

   --------------------------------------------------------------------
   Installation of <SUNWaws> was successful.
   --------------------------------------------------------------------

6. pkgadd begins processing the Wabi Application package. 

   If you are not using the Volume Manager, skip to step 7. 

   If you are using the Volume Manager, 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.
   
7. 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 <SUNWwabi> [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 SUNWaws 		Wabi 2.1 Answerbook
   
   	2 SUNWwabi		Wabi Application
   
   Select package(s) you wish to process (or "all" to process 
   all packages).  (default all)  [?,??,q]:   
   --------------------------------------------------------------------
        
8. Enter q to quit the pkgadd program.


   
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).

3. Install Microsoft Windows software by 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 you are upgrading from a previous Wabi release, you must reinstall 
   Microsoft Windows. The Wabi 2.1 version of the Microsoft Windows 
   Install process installs some files that were not installed in Wabi 2.0 or 
   Wabi 1.x. 
   
   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, Wabi Tools, and 
   PC Compatibility Products program groups.
   
   This completes the Wabi software installation process. You can now
   install Windows applications. 
  

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

Read the Wabi 2.1 Beta for Solaris on PowerPC 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.

To view the Wabi User's Guide on-line, start Answerbook by entering the 
following command:

     /usr/openwin/bin/answerbook &

Double-click the Wabi 2.1 Answerbook in the Answerbook Navigator. See your 
Solaris documentation for information about using Answerbook.

Alternatively, you can print the Postscript copy of the 
Wabi User's Guide, user.ps, located in the wabi.dir directory, which
was 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
