# Copyright \251 2005 Sun Microsystems, Inc. All rights reserved.
# Use is subject to license terms

#pragma ident "@(#)README.x86 1.1     04/05/11 SMI"

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.

Use is subject to license terms.

This distribution may include materials developed by third parties.

Portions may be derived from Berkeley BSD systems, licensed from U. of CA. Sun,
Sun Microsystems, the Sun logo, Netra, Solaris, Sun Ray and SunVTS are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Copyright \251 2005 Sun Microsystems, Inc. Tous droits r\351serv\351s.

L'utilisation est soumise aux termes du contrat de licence.

Cette distribution peut comprendre des composants d\351velopp\351s par des tierces parties.

Des parties de ce produit pourront \352tre d\351riv\351es des syst\350mes Berkeley BSD licenci\351s par l'Universit\351 de Californie.

Sun, Sun Microsystems, le logo Sun, Netra, Solaris, Sun Ray et SunVTS sont des marques de fabrique ou des marques d\351pos\351es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

SunVTS 6.0PS1 README File - x86 Solaris
---------------------------------------

Introduction
============

   SunVTS is a comprehensive diagnostic tool that tests and validates 
   Sun hardware by verifying the connectivity and functionality of most 
   hardware controllers and devices on Sun platforms.

   SunVTS 6.0PS1 is the subsequent release to SunVTS 6.0.
   Note that SunVTS 6.0PS1 includes all fixes in SunVTS 6.0.

   The SunVTS x86 Solaris support matrix at the time of the initial release of 
   this version of SunVTS is given below. Note that this version of SunVTS 
   may possibly be qualified on later releases of Solaris in future.
   
   Solaris               SunOS    SunVTS
   ===================================================================
   Solaris 10		 5.10	   6.0PS1, 6.0
   
  This product makes use of open source libxml2 dynamic library.
  For copyright information of libxml2, please see the Copyright.libxml2 file 
  found in this distribution. For more information about libxml2, see the 
  web URL http://xmlsoft.org

SunVTS 6.0PS1  Package Information - x86 Solaris
====================================================

   SunVTS 6.0PS1 for x86 Solaris contains the following packages. 
    
    	SUNWvts   - contains the SunVTS Core Framework which included the kernel	
    		    and user interface.
   	SUNWvtsts - contains the SunVTS test binaries 
   	SUNWvtsmn - contains the SunVTS man pages.
	SUNWvtsr  - contains the Framework Configuration Files in root partition

   The above set of packages for x86 Solaris deliver both 32 bit and 64 bit 
   content. The 64 bit content is applicable for the AMD64 based Solaris 
   platforms only. Please refer to README.64 for details on the 64 bit support.
   
SunVTS 6.0PS1 Installation
==============================

   The following example will install SunVTS into the default 
   directory (/opt):
   
   #cd 'directory of SUNWvts' 
   
    (for example, if loading from the x86 Solaris media, then do
    "cd /cdrom/sol_10_x86/s0/Solaris_10/ExtraValue/CoBundled")
    
   #pkgadd -d `pwd` SUNWvts  SUNWvtsmn SUNWvtsts SUNWvtsr
         
   Note: If you want SunVTS to install in a directory other than the 
         default (/opt), use the "-a none" argument with the pkgadd command.
         You will be asked where you want to install the package. 

How to run SunVTS 6.0PS1
========================

   # cd /opt/SUNWvts/bin (or cd to the directory that holds the SUNWvts package)
   
   Choose one of the following commands to start SunVTS:
   # ./sunvts     (to run SunVTS kernel and default GUI on the local machine.)
   # ./sunvts -t  (to run SunVTS kernel in TTY mode on the local machine.)
   # ./sunvts -h hostname (To connect and test a remote machine 'hostname',
                           but display GUI on the local host.)
   # ./sunvts -display local_hostname:0 (When run remotely, this option starts 
     					SunVTS kernel on the remote machine 
					and the GUI is displayed on the local 
     					machine designated as local_hostname:0)

     Note: Make sure the DISPLAY environment variable is set correctly while
     running "sunvts" remotely. Otherwise SunVTS will use vtstty as the
     default user interface.
			 
     Note: The SUNWvts package must be installed on the local and remote
     machines for the above examples.
     			 
     			  
NEWS update for this release:
=============================

1. 64 bit x86 memory diags support for AMD64:
	SunVTS now offers 64 bit memory diagnostics support using a command
	line interface for AMD64 based platforms. Please refer to the 
	README.64 file for additional details.
	
2. SATA disk support:
	SunVTS disktest has support for SATA drives using special SATA bit
	patterns for the raw partitions. Please refer to the SunVTS disktest
	chapter for additional details.

3. Removal of Internal Subtests in disktest:
	The internal subtests such as the "Self subtest" and the 
	"Write/Read disk buffer subtest" have been removed from SunVTS disktest.
	 This change does not impact the disktest interface.

4. ibhcatest:
	A new test called ibhcatest has been added to SunVTS to support
	the Sun Dual Port 4x Infiniband PCI-X Adapter. Please refer to the 
	SunVTS ibhcatest chapter for additional details.

5. graphicstest:
	graphicstest verifies the functionality of frame buffers. Test accuracy is checked using
	direct image comparison against compressed images. Failed pixel locations are printed as error messages.
	  
SunVTS Usage Notes:
===================
1) The disktest has the capability of premounting all unmounted disks so 
   that it could run the file system subtests against those disks. 
   (The test would do read-write operations on the file system).  
   However, by default all unmounted disks are left untouched. 

   The disktest probe by default does not pre-mount any partitions. If the 
   user wants SunVTS to pre-mount all the unmounted partitions which have 
   filesystem, the user has to set the environment variable BYPASS_FS_PROBE to 
   zero.

   For Example:
   # BYPASS_FS_PROBE=0; export BYPASS_FS_PROBE
   # ./sunvts

   However, even if pre-mounting is enabled, SunVTS disk probe does check
   for the existence of Veritas and Solstice Disksuite on the system and
   does not pre-mount any partitions if their presence is detected.

   Caution: Running a media subtest on a disk partition in the WriteRead mode
            may cause data corruption if the same partition is being used by
            other programs.

   Loading an option file that was created when BYPASS_FS_PROBE was set to 0
   (zero) might not work if the BYPASS_FS_PROBE environment variable is no
   longer set to 0 (zero).

   This error is caused when SunVTS expects to use the predefined mount point
   names (/disktest_cntndnsn) that are created when BYPASS_FS_PROBE is set to
   0 (zero), but these mount points do not exist while BYPASS_FS_PROBE is not
   set to 0 (zero).  The workaround is to create two separate option files
   for the two different states of the BYPASS_FS_PROBE environment variable.

2) By default, SunVTS security mode is turned on. To turn it off or to make
   modifications to the default settings, please refer to SunVTS User's Guide.

3) Running the CDE GUI (vtsui) in the localized environment may not display the
   proper fonts if the vtsui resource file (Vtsui) is not properly translated.
   Refer to the SunVTS 6.0 User's Guide for more information.

4) If the SunVTS kernel (vtsk) was inappropriately killed by SIGKILL (-9), 
   the next time it is started vtsk could possibly hang. Use
   "kill -HUP pid_of_inetd" to reinitialize the inetd if no other significant
   application software is running at the same time. Then restart sunvts.   

5) Running sunvts and vtsui in background (&) mode is not allowed, and is not 
   necessary since SunVTS releases the display window once the GUI starts. The 
   same is true while running in TTY-mode, vtstty needs the window for display 
   and key-in for input.  
   
6) The environment variable VTS_PM_PATH will be used to locate the pix map
   files when they are not in the default installation directory.  If SunVTS
   is installed under a different base directory from the default, SunVTS
   will issue the following error message about the use of this environment
   variable when it is run.

   ERROR: Unable to locate image files. Please set environment variable
          VTS_PM_PATH to image file directory.

   For example, to set the environment variable in Bourne shell, do the
   following:

   # VTS_PM_PATH=<your-installation-base-directory>/SUNWvts/bin/pm
   # export VTS_PM_PATH
   # ./sunvts

7) For cddvdtest, Volume Manager reads entire Toshiba DVD TSD-1 test disc when
   loaded. It takes more than 7 mins for SunVTS probe to register the dvdtest
   device.

        The work around is to stop volmgt before starting SunVTS:

        1. check if vold is running.
        # ps -ef |grep vold
        root  1407  1392  0 14:16:57 pts/6    0:00 grep vold
        root   259     1  0 12:47:11 ?        0:00 /usr/sbin/vold

        2. stop volmgt
        # /etc/init.d/volmgt stop

8) The following features are not available in x86 Solaris version of SunVTS:
	- Physical mapping 
	- session manager
	- Auto Config 

SunVTS Overview 
===============

SunVTS TEST MODES
-----------------

SunVTS 6.0PS1 has the following supported test modes:

  Connection Test:	Minimal access of device to verify
			accessibility/availability.

  Functional Test:	Detailed tests to thoroughly test device/system on an  
	(default)	"offline" system. 

  Exclusive Test:	A exclusive test requires that no other  tests should 
			be  running when that test is running.  
			The exclusive mode requirement for a test can be due 
			to the nature of the device being tested for a better
		 	effective diagnostics.

  Online Test:		Online testing is the non-intrusive testing while 
			customer applications may be running


SECURITY
--------

SunVTS has two security mechanisms, basic security and SEAM security.
Refer to the SunVTS User's Guide.


Logfile and Option File Directory 
---------------------------------

Default log directory is /var/opt/SUNWvts/logs
Default option file directory is /var/opt/SUNWvts/options


Internationalization
--------------------

SunVTS 6.0PS1 is I18N compliant.

SunVTS 6.0PS1 software has an internationalization hook available. However, 
there is no specific language, other than English, localized so far. 
The hook is therefore not fully verified. A user needs to be familiar with 
internationalization to use this feature. If you are running SunVTS in
English, in a locale environment and the font display is not right, refer
to the installation chapter of the SunVTS 6.0 User's Guide for additional
instructions.

All test messages are located in the /opt/SUNWvts/lib/locale/C/LC_MESSAGES
directory (assuming SunVTS was installed in the default directory). The CDE
GUI resource file, Vtsui, can be found in /opt/SUNWvts/lib/Vtsui 


Other Documents Available
=========================

   SunVTS 6.0 Users's Guide
   SunVTS 6.0(patch) Documentation Supplement
   SunVTS Quick Reference Card 

   These documents will become part of Solaris 10/update 1 and any future 
   Solaris 10 releases on Sun Hardware AnswerBook set.  These and other 
   documents can be accessed at http://docs.sun.com.
