test

Solaris 7 Sun Hardware Platform Guide

Chapter 3 Installing Software from the Sun Computer Systems Supplement CD

This chapter describes the contents and the installation of the Sun Computer Systems Supplement CD, which contains software for these Sun products:

Software Support

Sun Computer Systems supplies the software on the Supplement CD. If you have support issues concerning this software, contact your authorized support provider.

You can use one of two methods to install software package clusters from the Supplement CD:

swmtool, the Software Manager, is the recommended method to use when installing software package clusters from the Supplement CD. It provides a graphical user interface (GUI) that simplifies the task of installing the software package clusters. To use swmtool you must be running the Common Desktop Environment (CDE) or OpenWindows and have the X Window system installed on your system.

Note -

Unless otherwise noted,swmtool is the installation method described throughout this chapter.

pkgadd is another method used to install software package clusters from the Supplement CD. pkgadd differs from swmtool in that you do not need to run CDE or OpenWindows. You can invoke the pkgadd command at the operating system prompt. For instructions on using pkgadd, go to "Installing Sun Computer Systems Supplements for Solaris 7 Software on a Standalone System Using pkgadd".

Note -

You can use the Solaris Web Start method to install most of the software from the Supplement CD at the same time you are installing from the Solaris CD. For more information on the Solaris Web Start method of installation, see the "Using Solaris Web Start" module in the Information Library.

Installing Sun Computer Systems Supplements for Solaris 7 Software Using swmtool

If you use swmtool to install packages from the Supplement CD, you can install packages for more than one software product during the same installation session.

Note -

The individual software product sections later in this chapter contain complete procedures for installing each product. It may be more convenient for you to install more than one product during a single swmtool session.

The general process for installing clusters and packages using swmtool is:

Some products may require a customized installation. For example, if the packages should be installed in a directory other than the defauld directory, /opt. Specific directions for any customized installations are included in the individual software product sections in this chapter.

Installing Sun Computer Systems Supplements for Solaris 7 Software on a Standalone System Using pkgadd

To install packages for supported products from the Supplement CD using pkgadd:

  1. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  2. Open a command window and become superuser using the su command and superuser password.

  3. Type: 

    # /usr/sbin/pkgadd -d /cdrom/cdrom0/Product package_names

The argument to the -d option must be a full path name to a device or directory. If you do not specify the device on which the package resides, pkgadd checks the default spool directory (/var/spool/pkg). If the package is not there, installation fails.

To install a particular product, choose the appropriate packages:

Table 3-1

Software Product 

Packages 

Open Data Base Connectivity Driver Manager (ODBC) 

ISLIodbc

ISLIodbcD

 

Online Validation Test Suite (SunVTS) 

SUNWvts

SUNWvtsmn

SUNWodu

SUNWsycfd

SUNWvtsx

 

OpenGL Software 

SUNWglrt

SUNWglrtu

SUNWffbgl

SUNWglwrt

SUNWafbgl

SUNWffbxg

SUNWafbgx 

SUNWffbgx 

SUNWglrtx 

 

PC file viewer 

SUNWdtpcv

SUNWdtpcz

ShowMe TV 

SUNWsmtvh

SUNWsmtvr

SUNWsmtvt

SUNWsmtvu

 

Solaris 7 AnswerBook Set 

SUNWabhdw

 

Sun Computer Systems Manual Pages 

SUNWnfm

SUNWpfm

SUNWvtsmn

 

SunFDDI 

SUNWnfd

SUNWnfh

SUNWnfm

SUNWnfu

SUNWpfd

SUNWpfh

SUNWpfm

SUNWpfu

 

If pkgadd encounters a problem during package installation, information about the problem is displayed, followed by this prompt:

Do you want to continue with this installation?

Respond with either yes, no, or quit.

Open Data Base Connectivity (ODBC) Driver Manager

ODBC is an open database connectivity standard for data access. The InterSolv DataDirect ODBC Driver Manager allows you to access the ODBC API interface. The driver manager determines the appropriate database requests from client applications, loads the ODBC database drivers, and routes ODBC function calls to the drivers. In addition to the DataDirect ODBC Driver Manager, you need ODBC drivers to provide the critical link between your ODBC-compliant client/server applications and your database.

Note -

The ODBC Driver Manager is not a Sun Microsystems Inc. supported product. ODBC Driver Manager is a product of InterSolv. For all technical questions or support please contact InterSolv.

For support questions or information about the ODBC Drivers, contact Intersolv at sunsoft@intersolv.com or through one of the following phone numbers:

The mailing address is: InterSolv, 9420 Key West Avenue, Rockville, Maryland, 20850, USA.

Further information is available at http://www.intersolv.com.

ODBC is a standard for data access from Microsoft and X/Open. Databases supporting ODBC include Clipper, dBASE, FoxBase, FoxPro, INFORMIX, INGRES, Microsoft SQL Server, Oracle, Sybase System 10, Sybase SQL Server, and Sybase NetGateway to DB2 and other databases, and ASCII text files.

The Supplement CD includes a demo version of the InterSolv ODBC dBASE driver. This demo software can display only 30 records and process 100 SQL statements, but is otherwise fully functional.

InterSolv ODBC Clusters and Packages

Table 3-2 provides a list of InterSolv ODBC packages provided on the Supplement CD.

Table 3-2 InterSolv ODBC Clusters and Packages

Cluster Name 

Includes Cluster/Package 

Description 

SUNWCodbc 

ISLIodbc 

ODBC (Open DataBase Connectivity) Driver Manager 

 

 

ISLIodbcD

Demo ODBC (Open DataBase Connectivity) Mutli-Dialect dBASE Driver 

Installing InterSolv ODBC Software

To install the InterSolv ODBC software, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select ODBC Driver Manager Software 2.11.

    This will install the SUNWCodbc cluster, which includes both the driver manager package (ISLIodbc) and the demo dBASE driver package (ISLIodbcD).

  8. Click the Customize option if you want to select only one of these packages or change the destination directory from /opt.

    The Admintool:Customize Installation window appears. When you have made the choices you want, click the Add option to return to the Admintool: Add Software window.

  9. In the Admintool:Add Software window, click Add.

    The installation process should take a few minutes. You'll need to respond to prompts to install each InterSolv package you've selected. This message window is closed when installation is complete.

  10. Quit the Admintool:Software window.

Using InterSolv ODBC Software

To use InterSolv ODBC software, refer to the PostScript files installed in the /opt/ISLIodbc/2.11/doc directory. For further details on the driver manager and the demo dBASE driver, refer to the man pages for odbc.ini and qedbf installed in the /opt/ISLIodbc/2.11/man/man4 directory. Also refer to the comments about installation on your system in the /opt/ISLIodbc/2.11/install.log file.

Online Validation Test Suite Software (SunVTS)

The SunVTS(TM) online validation test suite is a diagnostic tool designed to test Sun hardware. By running multiple diagnostic hardware tests, the SunVTS software verifies the configuration and functionality of most hardware controllers and devices in a 32-bit or 64-bit environment.

Within this environment, you can run individual tests designed to validate all currently supported hardware that Sun sells. The SunVTS environment also allows programmers to develop their own tests and run them on SunVTS interfaces.

You can find the software for the SunVTS application on the Supplement CD. To use the SunVTS software, refer to the SunVTS 3.0 User's Guide, SunVTS 3.0 Test Reference Manual, and the SunVTS Quick Reference Card.

Table 3-3 describes the main features of the SunVTS environment:

Table 3-3 SunVTS Diagnostic Tools

Features 

Description 

SunVTS kernel (vtsk)

The SunVTS kernel controls all aspects of the testing. It is a daemon designed to stay in the background, and to be used when needed. Upon starting, the SunVTS kernel probes the hardware configuration of the system under test and waits for instructions from a user interface. During testing, the SunVTS kernel coordinates the running of individual tests, and manages all the messages (informational and error messages) sent by these tests. 

SunVTS OPEN LOOK user interface (vtsui.o1)

This interface is designed to be run on top of OpenWindows. Through its numerous buttons and windows, users can set options, select tests, read log files, and start and stop testing sessions (plus many other options). 

SunVTS CDE user interface (vtsui)

This interface is designed to run on top of the Common Desktop Environment (CDE). It will also run on top of OpenWindows if the CDE package SUNWdtbas is installed. Features are similar to the interface listed above (vtsui.o1).

SunVTS TTY user interface (vtstty)

Because not every system has a monitor, SunVTS has a TTY interface. This ASCII menu-based interface accepts various key sequences to control the test options and the test sessions. It can be used from a terminal, a shelltool, or a modem. 

Running an individual test from the command line 

Besides being run from a SunVTS user interface, each individual hardware test can be run from a UNIX\256TM command line. Running a test alone can be helpful to validate only one piece of hardware.

Custom test support 

A SunVTS user can run third-party executable test binaries under the SunVTS environment in the way that the test, rather than the SunVTS kernel, fully controls its input argument list and output log files. A user can simply modify the .customtest file provided by SunVTS to make it loosely coupled to the environment.

SunVTS Clusters and Packages

Table 3-4 provides a list of SunVTS clusters and packages needed to run the SunVTS diagnostic tool.

Table 3-4 SunVTS Clusters and Packages on the Supplement CD

Cluster  

Includes Packages 

Name 

Description 

SUNWCvts

SUNWvts

Online Validation Test Suite 

SunVTS kernel, User Interface (UI), tests and tools 

 

SUNWvtsmn

Online Validation Test Suite Manual Pages 

Manual pages for SunVTS utilities/binaries 

 

SUNWsycfd

 

Standalone configuration reader 

SUNWCvtsx

SUNWvtsx

Online Validation Test Suite 

64-bit Online Validation Test Suite software 

SUNWCondg

SUNWodu

Online Validation Test Suite Diagnostics 

Online diagnostics tool software 

Note: SUNWodu is not installed via WebStart. You must install it using pkgadd.

Installing SunVTS Software

To install the SunVTS software, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type : 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select the package clusters you want: Online diagnostics Tool Software 3.0, Online Validation Test Suite Software 3.0, and/or 64 Bit Online Validation Test Suite Software 3.0.

  8. Click Add.

    The installation process should take a few minutes.

  9. Quit Admintool.

Using SunVTS Software

To use SunVTS software, refer to the SunVTS 3.0 User's Guide in the Solaris 7 on Sun Hardware AnswerBook set. For SunVTS test and quick reference information, refer to the SunVTS 3.0 Test Reference Manual and SunVTS Quick Reference Card.

OpenGL Software

The Solaris OpenGL software is Sun's native implementation of the OpenGL application programming interface (API). The OpenGL API is an industry-standard, vendor-neutral graphics library. It provides a small set of low-level geometric primitives and many basic and advanced 3D rendering features, such as modeling transformations, shading, lighting, anti-aliasing, texture mapping, fog, and alpha blending.

Supported Platforms

The Solaris OpenGL 1.1.2 software supports the following devices:

Removing Old Packages

If you have older versions of the Solaris OpenGL software packages, you must use the pkgrm command to remove them. Follow these steps:

  1. Check to see whether any older versions of the OpenGL packages are installed using the pkginfo command.

    The pkginfo | egrep -i "OpenGL" command lists any existing OpenGL packages that you have installed. 

    % pkginfo | egrep -i "OpenGL"
application SUNWffbgl     Creator Graphics (FFB) OpenGL Support
application SUNWglrt      OpenGL Runtime Libraries
application SUNWglrtu     OpenGL Platform Specific Runtime Libraries
application SUNWglwrt     OpenGL Widget Library
application SUNWafbgl     Loadable pipeline for UPA Bus Elite3D graphics
application SUNWgldoc     Solaris OpenGL Documentation and Man Pages
application SUNWglh       Solaris OpenGL Header Files
application SUNWglut      Solaris OpenGL Utilities and Example Programs
application SUNWglwh      Solaris OpenGL Widget Header Files

  2. To remove the packages, become superuser: 

    % su
Password: superuser password

  3. Run pkgrm to remove all existing Solaris OpenGL packages. 

    # pkgrm SUNWglrt SUNWglh...

Installing the OpenGL Software

To install the OpenGL software, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type: 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed

  7. In the Admintool:Add Software window, select Open GL Runtime Libraries 1.1.2.

  8. Click Add.

    The installation process should take a few minutes.

  9. Quit Admintool.

OpenGL Clusters and Packages

Table 3-5 lists the clusters and packages that are provided with Solaris OpenGL.

Table 3-5 OpenGL Clusters and Packages

Cluster Name 

Package Name 

Description 

Default Install Location 

SUNWCogl

SUNWglrt

OpenGL client-side runtime libraries 

/usr/openwin/lib

SUNWglrtu

UltraSPARC-specific OpenGL libraries 

/usr/openwin/platform/sun4u/lib/GL

SUNWffbgl

Device pipeline for Creator and Creator3D Graphics frame buffers 

/usr/openwin/lib/GL/devhandlers

SUNWglwrt

OpenGL widget library 

/usr/openwin/lib

SUNWafbgl

Loadable pipeline for UPA Bus Elite3D graphics 

/usr/openwin 
 SUNWglrtx Sun OpenGL 64-bit Runtime Libraries /usr/openwin
 SUNWafbgx Sun OpenGL 64-bit loadable pipeline for the UPA Bus Elite3D graphics accelerator /usr/openwin
 SUNWffbgx Sun OpenGL 64-bit loadable pipeline for the UPA Bus Creator graphics accelerator /usr/openwin

After Installing the Packages

After installing the packages, do the following:

  1. Exit the window system and restart it so that the window system loads the newly installed GLX server extension.

  2. To verify that the OpenGL libraries are installed correctly, run ogl_install_check.

    The ogl_install_check test program prints the version of the OpenGL library and renderer used, and renders a rotating wheel. The program returns the following output when it is run on an UltraSPARC Creator3D: 

    OpenGL Vendor:             Sun Microsystems, Inc.
OpenGL Version:            1.1.2 Solaris OpenGL 1.1.2_08

For diagnostic purposes, the following values should be noted anytime that Solaris OpenGL problems are seen: 

OpenGL Renderer:               Creator 3D, VIS
OpenGL Extension Support:      GL_EXT_texture3D
                               GL_SGI_color_table
                               GL_SUN_geometry_compression
                               GL_EXT_abgr
                               GL_EXT_rescale_normal
OpenGL GLX Server:             Detail Status Report
     GLX:     Context is direct.
     GLX:     OpenGL Rendering in use
     GLX:     Double Buffering in use
     GLX:     Color Buffer (GLX_BUFFER_SIZE) = 24 bits
     GLX:     Depth Buffer (GLX_DEPTH_SIZE) = 28 bits
     GLX:     Stencil Buffer (GLX_STENCIL_SIZE) = 4 bits
     GLX:     RGBA (True Color/Direct Color) Visual in use
OpenGL Library:                Detail Status Report
     Number of color bits (R/G/B/A): 8/8/8/0
     Frame Buffer Depth (GL_DEPTH_BITS):28

Unexpected Slow Local Rendering

Whenever possible, Solaris OpenGL renders directly to the frame buffer, bypassing the X server. This is enabled by Sun's DGA mechanism for locking portions of the screen. However, a Solaris security feature only allows the user who originally logged in to the window system to use DGA to lock portions of the screen. Only owners of the window system have access to DGA.

If you notice poor performance when rendering locally, the cause may be this Solaris security feature. For example, if you start the window system, and another user at the workstation changes to that user's own environment using su, the application will not run via DGA even though the second user is running the application locally.

If you notice slow local rendering, run the ogl_install_check diagnostic program (found in /usr/openwin/demo/GL) to determine whether the application is running via DGA. If the OpenGL GLX Server status report from the ogl_install_check program says that the GLX context is indirect, the login permissions need to be edited to enable DGA access for all users.

To give all local users access to DGA, follow these steps:

  1. Become superuser. 

    % su
Password: superuser password

  2. Edit permissions to allow world read/write access to the following devices: 

    % chmod 666 /dev/mouse /dev/kbd /dev/sound/* /dev/fbs/*

    This will enable DGA access by all users for the duration of the current window system session (subject to X authorization, see xhost(1)).

  3. Edit the /etc/logindevperm file and change the default permissions of all devices listed in the file to 0666 to allow world read/write access.

    For example, in the following lines in logindevperm, the 0600 should be changed to 0666 so that the next time you log in and restart your window system, it will still be accessible by all users. 

    /dev/console     0600     /dev/mouse:/dev/kbd
/dev/console     0600     /dev/sound/*       # audio devices
/dev/console     0600     /dev/fbs/*         #frame buffers

Note that your system is no longer secure.

PC File Viewer

The PC file viewer software provides you with an application to view popular PC file formats such as Word, PowerPoint, Excel, Lotus 1-2-3, and AutoCAD. The viewer allows you to choose a file and to copy and paste information from the viewer to another application, such as a text editor. CDE applications will be able to identify these filetypes and launch this application by double-clicking on the icon in your mail attachment or from File manager (dtfile). PC file viewer supports the following file formats:

PC File Viewer Limitations

PC file viewer is limited to the following products and configurations for this Solaris release:

The following limitations are related to displaying items in a supported file:

PC File Viewer Packages

Table 3-6 lists the packages that are provided with PC file viewer.

Table 3-6 PC file viewer Packages

Locale 

Package Name 

Description 

English 

SUNWdtpcv

US base package 

SUNWdtpcz

US base actions and messages 

Japanese 

SUNWjdpcv

Japanese EUC/PCK/UTF-8 common messages 

SUNWjepcv

Japanese EUC messages 

SUNWjppcv

Japanese PCK messages 

SUNWjupcv

Japanese UTF-8 messages 

SUNWjepcz

Japanese EUC action files 

SUNWjppcz

Japanese PCK action files 

SUNWjupcz

Japanese UTF-8 action files 

Korean 

SUNWkcpcv

Korean EUC/UTF-8 common messages 

SUNWkupcv

Korean UTF-8 messages 

SUNWkdpcv

Korean EUC messages 

SUNWkupcz

Korean UTF-8 action files 

SUNWkdpcz

Korean EUC action files 

Traditional Chinese 

SUNWhcpcv

Traditional Chinese EUC/BIG5 common files 

SUNW5pcv

Traditional Chinese BIG5 messages 

SUNWhdpcv

Traditional Chinese EUC messages 

SUNW5pcz

Traditional Chinese BIG5 action files 

SUNWhdpcz

Traditional Chinese EUC action files 

Simplified Chinese 

SUNWccpcv

Simplified Chinese EUC/GBK common messages 

SUNWcdpcv

Simplified Chinese EUC messages 

SUNWgpcv

Simplified Chinese GBK messages 

SUNWcdpcz

Simplified Chinese EUC action files 

SUNWgpcz

Simplified Chinese GBK action files 

German 

SUNWdepcv

German messages 

SUNWdepcz

German action files 

French 

SUNWfrpcv

French messages 

SUNWfrpcz

French action files 

Spanish 

SUNWespcv

Spanish messages 

SUNWespcz

Spanish action files 

Italian 

SUNWitpcv

Italian messages 

SUNWitpcz

Italian action files 

Swedish 

SUNWsvpcv

Swedish messages 

SUNWsvpcz

Swedish action files 

Installing PC File Viewer

To install PC file viewer, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type: 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select PC File Viewer 1.0.1.

    The software is installed in the /opt directory (default).

  8. In the Admintool: Add Software window, click Add.

    The installation process should take a few minutes.

  9. Quit Admintool.

Using PC File Viewer (Command Line Usage)

To use PC file viewer without the icons, run the following command: 

% /opt/SUNWdtpcv/bin/sdtpcv &

Adding PC File Viewer to the CDE Front Panel

To add PC file viewer to the CDE front panel, dtfile, dtpad, etc., do the following:

  1. Open File Manager (dtfile)

  2. Go to the /opt/SUNWdtpcv/bin directory.

    You will see the PC file viewer icon there.

  3. Open the CDE front panel where you want the icon.

    For example, Application or File sub folder.

  4. Drag and drop the PC file viewer icon from File Manager to InstallIcon in the selected subfolder.

Now the PC file viewer can be launched by just clicking on the icon in the CDE front panel. You can also promote the icon to appear on the front panel by default.

ShowMe TV 1.2.1 Software

ShowMe TV is a television system for local- and wide-area networks. You can use it to view and broadcast live or prerecorded video programs on your network. Here are some examples of how you can use ShowMe TV:

ShowMe TV contains the following components:

ShowMe TV Packages

Table 3-7 lists the packages that are provided with ShowMe TV.

Table 3-7 ShowMe TV Packages

Package Name 

Description 

Default Install Location 

Disk Space (Kbytes) 

SUNWsmtvh

Online help binaries and documentation 

/opt/SUNWsmtv

287 

SUNWsmtvr

ShowMe TV receiver application and support files 

/opt/SUNWsmtv

10743 

SUNWsmtvt

ShowMe TV transmitter application and support files 

/opt/SUNWsmtv

7698 

SUNWsmtvu

Support utilities 

/opt/SUNWsmtv

842 

Removing Old Packages

If you have ShowMe TV 1.1 or 1.2 installed, you need to remove it before installing ShowMe TV 1.2.1.

  1. To remove ShowMe TV 1.1, type: 

    # pkgrm SUNWsmUt1 SUNWstv SUNWstvs

If you have an earlier release of ShowMe TV 1.2 installed, you need to remove it before installing any new software packages.

  1. To remove ShowMe TV 1.2, type: 

    # pkgrm SUNWsmtvt SUNWsmtvu SUNWsmtvr SUNWsmtvh

Installing the ShowMe TV 1.2.1 Software

To install the ShowMe TV software, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type: 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select ShowMe TV 1.2.1.

  8. Click Add.

    The installation process should take a few minutes.

  9. Quit Admintool.

Translated Documentation

The CD-ROM contains the ShowMe TV User's Guide in the following languages:

Accessing the ShowMe TV Users Guide

The /Docs/showmetv directory on the Supplement CD contains the following files:

Table 3-8 ShowMe TV Translated Documents

File Name 

Description 
 UG_en.ps English PostScript(TM) file

UG_de.ps

German PostScript file 

UG_fr.ps

French PostScript file 

UG_es.ps

Spanish PostScript file 

UG_it.ps

Italian PostScript file 

UG_sv.ps

Swedish PostScript file 

UG_ja.ps

Japanese PostScript file 

UG_ko/

Korean HTML files 

UG_zh/

Simplified Chinese HTML files 

UG_zh_TW/

Traditional Chinese HTML files 

  1. To view the desired PostScript manual, type the following at the command line: 

    # imagetool filename

  1. To print the manual, either use the File menu in Image Tool or type the following at the command line: 

    # lp filename

  1. To view the manuals in HTML format, use a web browser and type the following in the address field: 

    file://cdrom/cdrom0/Docs/directory

If you have copied the HTML files to a different directory, type in the path to that directory. Open the table of contents to determine which file to open.

Solaris 7 AnswerBook Set

For customers using Sun hardware, a set of online manuals in AnswerBook format is provided on the Supplement CD. The Solaris 7 on Sun Hardware Collection is contained in a package named SUNWabhdw.

Refer to the SPARC: Solaris 7 SPARC Installation Instructions that accompanies the AnswerBook CD for information about installing the Solaris 7 on Sun Hardware AnswerBook set.

Refer to the "Accessing Online Documentation" module in the Solaris 7 Installation Library for information about how to install document collections on an AnswerBook2 server.

The AnswerBook sets include general manuals as well as Platform Notes, which are manuals that cover use of Solaris 7 software with specific Sun hardware products.

Table 3-9 lists the manuals (online versions) found on this AnswerBook.

Table 3-9 Solaris 7 on Sun Hardware Manuals

Title 

Description 

Solaris 7 on Sun Hardware Documentation Guide

Describes other manuals in this set, and helps you determine which manuals are useful for the work you do with your hardware. 

Solaris on Sun Hardware Reference Manual Supplement

Information to help you find a compilation of manual pages provided in packages on the Supplement CD. This includes man pages that cover SunVTS(TM) software. 

Solaris Handbook for Sun Peripherals

Information about installing drives and other peripherals for use with the Solaris 7 software environment. Covers issues such as configuring SCSI addresses. 

Solaris Handbook for Sun Frame Buffers

How to use features of the TurboGXPlus, SX, PGX (m64) and Creator Graphics Accelerator frame buffers. Also explains how to configure multiple monitors on a system. (In some past Solaris releases, this manual was titled Platform Notes: SMCC Frame Buffers.)

NFS Server Performance and Tuning Guide

Information about the performance and tuning of an NFS server. 

SunVTS 3.0 User's Guide

Basic instructions on using the SunVTS diagnostic software. 

SunVTS 3.0 Test Reference Manual

Information about each test provided with the SunVTS diagnostic software. 

SunVTS Quick Reference Card

A quick reference card about how to use the SunVTS diagnostic software. 

PCI: SBus Comparison

Describes feature differences between SBus and PCI. 

Platform Notes: The hme FastEthernet Device Driver

Describes how to configure the hme device driver for use with the Ultra Workstation Series platform, Sun Enterprise Servers, SunSwift SBus Adapter, SunSwift PCI Adapter, and PCI SunFastEthernet Card. 

Platform Notes: SPARCstation 10SX and 20 System Configuration Guide

How to take advantage of graphics memory and acceleration features of these systems.  

Platform Notes: SPARCstation Voyager Software Guide

Information about Supplement CD software used with the SPARCstation Voyager system. Also contains information for system administrator's supporting users with SPARCstation Voyager systems. 

Platform Notes: Sun Enterprise 3000, 4000, 5000, and 6000 Systems

Lists and describes Sun Enterprise X000-specific OpenBoot commands, including those for board hot-plug operations. Also contains board hot-plug procedures, and miscellaneous small pieces of related information. 

Platform Notes: Sun Enterprise 250 Server

Covers new OpenBoot commands, configuration variables, and 

disk drive hot-plug procedures. Also provides procedures 

for mapping between logical and physical device names for 

internal storage devices. 

Platform Notes: Sun Ultra 450 Workstation and Sun Enterprise 450 Server

Covers new OpenBoot commands, configuration variables, and 

disk drive hot-plug procedures. Also provides procedures 

for mapping between logical and physical device names for 

internal storage devices. 

Platform Notes: Using luxadm Software

Describes how to use the luxadm administrative program with the Sun StorEdge A5000 and the SPARCstorage Array.

Platform Notes: Sun FDDI Adapters

Describes how to configure the SunFDDI driver software and use the SunFDDI network utilities. 

Dynamic Reconfiguration User's Guide for Sun Enterprise 3x00,4x00/5x00/6x00 Systems

Information about how to use Dynamic Reconfiguration software features on these Sun Enterprise servers. 

Additional documentation can be found on the Supplement CD in the /cdrom/cdrom0/Docs directory.

Solaris 7 AnswerBook Clusters and Packages

The following table lists the clusters and packages that are provided for Solaris 7 AnswerBooks.

Table 3-10 Solaris 7 AnswerBook Clusters and Packages on the Supplement CD

Cluster Name 

Includes Package 

Description 

SUNWCabks

SUNWabhdw

Solaris 7 on Sun Hardware Collection 

Installing AnswerBooks

To install the AnswerBook cluster or a particular AnswerBook, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD nto your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type: 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select SMCC AnswerBooks Cluster 1.0.

  8. Click the Customize option.

    The Admintool:Customize Installation window is displayed.

  9. In the Admintool:Customize Installation window, click the Deselect All option.

  10. Click on the box beside the AnswerBook cluster or AnswerBook you desire.

  11. In the Installation Directory window, enter the directory where you want the AnswerBook installed.

    Leaving this blank will install the software in the /opt directory (default).

    Note -

    /opt is recommended as the home directory for the Solaris 7 AnswerBooks.

  12. Click OK.

  13. In the Admintool: Add Software window, click Add.

    The installation process should take a few minutes.

  14. Quit Admintool.

    Note -

    For further information on installing AnswerBooks, refer to the "Accessing Online Documentation" module in the Solaris 7 Installation Library.

Using the Solaris 7 AnswerBook Set

To determine which of the manuals in this AnswerBook set are of interest to you, see the Solaris 7 on Sun Hardware Documentation Guide in this set.

To use any AnswerBook set, see the Solaris User's Guide in the Solaris 7 User AnswerBook on the Solaris CD.

Sun Computer Systems Manual Page Clusters and Packages

The SUNWCman cluster will install all the manual (man) pages for software on the Supplement CD. This provides a way to install the man pages on a system without installing the software they describe on that system.

Table 3-11 Sun Computer Systems Manual Page Clusters and Packages on the Supplement CD

Cluster Name 

Includes Package 

Name 

Description 

SUNWCman

SUNWvtsmn

Online Validation Test Suite Manual Pages 

All manual pages for SunVTS drivers/binaries 
  SUNWnfm SunFDDI SBus Manual Pares All manual pages for SunFDDI SBus
  SUNWpfm SunFDDI PCI Manual Pages All manual pages for SunFDDI PCI

Installing Sun Computer Systems Manual Pages

To install the Sun Computer Systems Manual Pages, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type: 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select SMCC Manual Page Cluster 1.0.

  8. Click the Customize option.

    The Admintool:Customize Installation window is displayed.

  9. In the Admintool:Customize Installation window, click the Deselect All option.

  10. Click on the box beside Manual Page Cluster.

  11. In the Installation Directory window, enter the directory where you want the SMCC Manual Page Cluster installed.

    Leaving this blank will install the software in the /opt directory (default).

    Note -

    /opt is recommended as the home directory for the Sun Computer Systems Manual Page Cluster.

  12. Click OK.

  13. In the Admintool: Add Software window, click Add.

    The installation process should take a few minutes.

  14. Quit Admintool.

Using Sun Computer Systems Manual Pages

To view the man pages you have installed, use the man command as you would for the man pages installed as part of the Solaris installation. These additional man pages are also available in the Solaris on Sun Hardware Reference Manual Supplement in the Solaris 7 on Sun Hardware AnswerBook set.

SunFDDI Drivers Included on the Supplement CD

The following FDDI drivers are provided on the Supplement CD contained in your Solaris 7 Media Kit:.

Table 3-12 SunFDDI Clusters and Packages

Cluster Name 

Includes Packages 

Description 

SUNWCfdis

SUNWnfd

SunFDDI Sbus drivers 

 

SUNWnfh

SunFDDI Sbus header files 

 

SUNWnfm

SunFDDI Sbus man pages 

 

SUNWnfu

SunFDDI Sbus utilities 

SUNWCfdip

SUNWpfd

SunFDDI PCI drivers 

 

SUNWpfh

SunFDDI PCI header files 

 

SUNWpfm

SunFDDI PCI man pages 

 

SUNWpfu

SunFDDI PCI utilities 

Note -

SunFDDI supports booting from the 32-bit kernal or the 64-bit kernal. SunFDDI will attach to whichever you choose to boot from with no special user interaction.

Installing SunFDDI Drivers

To install SunFDDI, follow these steps:

  1. Start CDE or OpenWindows.

  2. Insert the Supplement CD into your CD-ROM drive.

    The File Manager window is displayed.

  3. Open a command window and become superuser using the su command and superuser password.

  4. Enter the swmtool command at the # prompt: 

    # /usr/sbin/swmtool

    The Admintool:Software window is displayed.

  5. Select Add from the Edit Menu.

    The Admintool:Set Source Media window is displayed.

  6. Type: 

    # cd /cdrom/cdrom0/Product

    The Admintool:Add Software window is displayed.

  7. In the Admintool:Add Software window, select either SunFDDI PCI Driver Software 2.0 or SunFDDI Sbus Driver Software 6.0, whichever is appropriate for your system.

  8. Click Add.

    The installation process should take a few minutes.

  9. Quit Admintool.

    Note -

    For more infornation about the SunFDDI Drivers, refer to Platform Notes: SunFDDI Drivers.

Supplement CD Differences from Previous Releases

Table 3-13 Supplement CD Differences from Previous Releases
 Software Description
 Power Management The Power Management software option is now included as a standard part of the Solaris 7 product on the Solaris CD.
 SPARCstation Voyager The SPARCstation Voyager software option is now included as a standard part of the Solaris 7 product on the Solaris CD.
 Solstice SyMON The Solstice SyMON software option is not included on this Sun Computer Systems Supplement CD.
 OpenGL Developer The OpenGL Developer packages are no longer included on the Sun Computer Systems Supplement CD.
 Sun Enterprise 10000 system The Sun Enterprise 10000 software options are no longer included on the Sun Computer Systems Supplement CD.
 Alternate Pathing The Alternate Pathing software option is not included on this Sun Computer Systems Supplement CD.