Chapter 7. Installing and Removing Software

This chapter shows you how to install software products that you received from Silicon Graphics, Inc. To install products from other vendors, please see the software installation instructions that accompany the products.

You can install software from a CD-ROM drive that's connected either to your own system or to another Silicon Graphics system on your network. Only root can install and remove software.

If you need advanced information on software installation or troubleshooting, see the Software Installation Administrator's Guide (for IRIX 5.3 systems) and IRIX Admin: Software Installation and Licensing (for IRIX 6.2 systems). You can view this guide online using InSight, or you can order a printed copy.

Available Software Installation Tools

There are several tools available to install and remove software, including

inst 

Text-based utility for installing and removing software.

swmgr 

Graphical tool for installing and removing software. (Requires a graphics system, such as a Silicon Graphics Indy workstation.)

versions 

Command-line tool for checking what software is installed and for removing software. You can also use the versions command to identify site-specific configuration files that may need special handling after software installation.

The following sections provide brief instructions on installing and removing software using inst and versions.

Installing a New Version of the Operating System Software

Follow these steps to reinstall a new version of the operating system over a previous version:

  1. Make a full system backup; see the IRIX Advanced Site and Server Administrator's Guide (for IRIX 5.3 systems) or IRIX Admin: Backup, Security, and Accounting (for IRIX 6.2 systems).

  2. If hardcopy release notes accompanied the operating system, read through them before continuing with the installation.

  3. If you do not have a CD drive connected directly to your system, find a CD drive on your network. You need to know the hostname of the system to which the CD drive is attached. Also, the CD-ROM must be mounted (for example on /CDROM) on the remote host.


    Note: You must use the primary Ethernet interface, ec0, to access a network CD-ROM drive. The secondary Ethernet interface, ec3, is not active during this procedure.


  4. Insert the CD into the drive you are going to use.

  5. Shut down the server. See "Turning Off the Challenge S Server".

  6. At the System Maintenance menu, select 2. You see the following screen:

    Installing System Software...
    
    Press <Esc> to return to the menu
    
    1) Remote Tape 2) Remote Directory 3)Local CD-ROM 4)Local Tape
    5) Remote CD-ROM
    
    Enter 1-5 to select source type, <esc> to quit
    or <enter> to start:

  7. Specify the location of the new software to install. Any locations that are unavailable with your system and network configuration are marked with an "X."

    • If you're using a CD-ROM drive that's connected to your own system, press 3, then press <Enter> twice. Continue with step 8.

    • If you're using a remote drive, press 1. You are prompted for the location of the remote drive. Provide the name of the remote host (for example hostname.wpd.sgi.com) and the name of the remote directory on the device (for example /CDROM/dist).

  8. When the system finds the software, it takes several minutes to copy the software installation tools onto your system. The system is ready to install software when you see the Inst menu:

    1. from [source]
    2. list [keywords] [names]
    3. go
    4. install [keywords] [names]
    5. remove [keywords] [names]
    6. keep [keywords] [names]
    7. step [keywords] [names]
    8. versions [args]
    9. help [topic]
    10. admin
    11. quit
    
    Inst>

  9. Install all or some of the subsystems that make up the operating system.

    • To install all of the default subsystems, enter

      go

    • To install all optional and required subsystems, enter

      install all

      go

    If you see an error message that says the system cannot find the software, see "System Cannot Find the New Software". If you see any other messages, see "Cannot Complete an Installation". The installation is complete when you see this message:

    Installation and/or removal succeeded.
    You can insert another tape or CD-ROM now.
    Type "quit" if you are ready to leave the inst tool
    Inst>

  10. Remove the CD. If you have another CD from which you want to install an optional product, insert the CD, and go back to step 7.

  11. When all the software is installed, enter

    quit

    You'll see several messages.

  12. The software is successfully installed and your system is ready to restart when you see these messages:

    Please wait...
    Ready to restart the system. Restart? [y, n]

    Type y, then press <Enter>.

    If you see a different message or question, see "System Reports Errors After an Installation".

  13. The system starts as usual. When the login prompt appears, log in to your own account.

  14. See your release notes by typing relnotes at the system prompt. This displays a list of available release notes and brief instructions for viewing them. release notes cover new features and known problems with each product.

Installing Optional Software

Before you install a new product, check its printed release notes for this information:

  • the version of the operating system (IRIX) that must be installed on your server in order for this product to run

  • a list of prerequisite products or subsystems (smaller parts of the products) that must be installed before you install the new product

  • a list that shows which subsystems are optional and which are required for product operation, and how much disk space each subsystem requires

To make sure your system is ready for the new software, follow these steps:

  1. Log in as root.

  2. Check which version of the operating system your server us running by typing the following at a system prompt:

    uname -a

  3. Check whether required subsystems (determined by examining the release notes) are already installed by entering the following:

    versions subsystem.name

    In this example, subsystem.name is the name of the subsystem you are thinking about installing. The versions command indicates whether or not the subsystem is already installed, as well as the date on which it was installed.

  4. Check whether you have enough disk space by entering the following:

    df -kl

    The df command displays free disk space. If you do not have enough space to install the entire product but you do have enough space for the required subsystems, during installation you can choose to install only required subsystems. To free up disk space by removing or archiving old or unneeded files, see the IRIX Advanced Site and Server Administrator's Guide (for IRIX 5.3 systems) or IRIX Admin: Backup, Security, and Accounting (for IRIX 6.2 systems).

  5. If you do not have a CD drive connected directly to your system, find a CD drive on your network. Determine the name of the host to which it is attached and the device name (for example, /dev/dsk/dks0d4s7).

  6. Make sure the CD-ROM is mounted. Typically, if you insert a distribution CD in a CD-ROM drive attached to a Silicon Graphics workstation or server, the CD is automatically mounted on the directory /CDROM. However, if you have to do this manually, use this command:

    mount /dev/dsk/dks0d4s7 /CDROM

To install the product, follow these steps:

  1. Insert the CD into the drive that's connected to your system, or the network drive that you found earlier.

  2. While still logged in as root, enter the following command to start the installation program:

    inst -f guest@hostname:devicename

    For example, to install from a CD-ROM drive that is mounted on /CDROM on the host mars, you would enter the following:

    inst -f guest@mars:/CDROM/dist

    You see the Inst menu:

    1. from [source]
    2. list [keywords] [names]
    3. go
    4. install [keywords] [names]
    5. remove [keywords] [names]
    6. keep [keywords] [names]
    7. step [keywords] [names]
    8. versions [args]
    9. help [topic]
    10. admin
    11. quit
    
    Inst>

  3. Install all or some of the subsystems of this product:

    • To install all of the default subsystems, enter

      go

    • To install all optional and required subsystems, enter

      install all

      go

    • To select only required subsystems or to select all required subsystems plus some optional subsystems, use the step or install commands. See the Inst online help for more information.

    If you see an error message that says the system cannot find the software, see "System Cannot Find the New Software".

    If you see any other messages, see "Cannot Complete an Installation". The installation is complete when you see this message:

    Installation and/or removal succeeded.
    You can insert another tape or CD-ROM now.
    Type "quit" if you are ready to leave the inst tool
    Inst>

  4. Remove the CD. If you have another CD from which you want to install another product, insert the CD, and go back to step 4.

  5. When all the software is installed, enter

    quit

    The installation is complete when the shell prompt returns. If it does not return, and you see an error message, see "System Reports Errors After an Installation".

    See your release notes by typing relnotes at the system prompt. This displays a list of available release notes and brief instructions for viewing them. release notes cover new features and known problems with each product.

Troubleshooting Software Installation

This section covers the three most common problems that may arise during software installation. See the section that describes the problem you have encountered.

For comprehensive troubleshooting information, please order the Software Installation Administrator's Guide.

System Cannot Find the New Software

The system cannot find the software when

  • There is no CD in a drive that you specified.

  • You are installing a new operating system and attempt to use a device on a network that is attached to the 10 BASE-T port of the Challenge S server. This port (ec3) is not active until the system is booted.

  • Your system cannot contact the system on the network that has the software. Check to be sure that

    • network cables between the server and the remote host are connected securely

    • the remove system is functioning properly

    • components of the network (such as routers, hubs, and concentrators) are working properly

  • You entered an incorrect directory name.

    This typically happens when you are installing from a remote CD drive, and the drive is not accessible from (is not mounted at) the /CDROM directory.

    Also be sure to complete the full pathname with dist, which is the name of the directory on the CD in which the software is stored. For example, the full pathname for new software on a CD whose pathname is /CDROM on a system named mars is mars:/CDROM/dist

Cannot Complete an Installation

Typically the system cannot complete an installation when

  • There is not enough disk space to install all the products you selected for installation. In this case, you could:

  • You need to install companion or prerequisite subsystems. In this case, you see an error message about "Incompatible Subsystem."

    Check the release notes for the products, and use the install command from within Inst to choose the correct combination of subsystems.

  • During optional product installation, the current version of the operating system cannot support the product. In this case, you need to install a new version of the operating system, then install the optional product. See "Installing a New Version of the Operating System Software".

System Reports Errors After an Installation

If the system reports errors after an installation is complete, read the error message carefully, and follow its instructions. The message will ask you to type help<topic> for online instructions.


Warning: If the errors occur after you install new system software, do not turn off the system or press the Reset button. This could seriously damage your system software.

If you cannot solve the problem using the online help, contact your local support organization.

Removing Optional Software

When your system starts getting low on disk space, you may want to review the software products and the subsystems of these products. You may no longer need certain products, or you may discover that some products include large, optional subsystems that you can remove without removing the core product.

The root account can remove software by following these steps:

  1. Log in as root.

  2. At the shell prompt, enter

    versions

    You see a list of all software products that are installed.

  3. Check the list for products that you do not need, or for subsystems of products that have data, man, or movies in their names. Then check the release notes for these products to find out which subsystems are optional and which are required, and to find out how large the subsystems are.

    To check the release notes, enter relnotes at a shell prompt.

  4. Remove an entire product or a specific subsystem.

    • To remove an entire product, such as Space Tour, enter

      versions remove spacetour

    • To remove a specific subsystem, such as the large, optional movies that accompany Space Tour, enter

      versions remove spacetour.data.movies

Table 7-1 lists IRIX subsystems that may be installed on an IRIX 5.3 system but might not be needed. (Subsystems for IRIX 6.2 are listed in Table 7-2.) To save disk space, you can remove them. However, you may wish to leave some or all of these subsystems installed as a reference, or to allow graphical system administration of the Challenge S server by a remote workstation.

Note that motif_dev and x_dev are required to build graphical applications, and tooltalk_eoe is required by some CASE applications.

Table 7-1. Possible IRIX 5.3 Subsystems to Remove

Subsystem Name

Description

4Dwm

Desktop Window Manager, 5.3 (based on OSF/Motif 1.2.4)

4Dwm.sw

Desktop Window Manager

4Dwm.sw.4Dwm

Desktop Window Manager

ViewKit_eoe

ViewKit Execution Environment, 1.1

ViewKit_eoe.sw

ViewKit Execution Environment, 1.1

ViewKit_eoe.sw.base

ViewKit Execution Environment, 1.1

cadmin

Desktop Administration, 5.3

cadmin.sw

Desktop Administration Software, 5.3

cadmin.sw.dso

Desktop Administration Dynamic Shared Object

cadmin.sw.objectserver

Desktop Administration Object Server

demos

Graphics Demonstration Programs, 5.3

demos.sw

Demonstration Programs

demos.sw.games

Game Demos

desktop_eoe

Indigo Magic Desktop, 5.3

desktop_eoe.books

Indigo Magic Desktop Books, 5.3

desktop_eoe.books.DesktopHelp

Desktop Help

desktop_eoe.books.ErrorMessageHelp

Desktop Help on Error Messages

desktop_eoe.sw

Indigo Magic Desktop, 5.3

desktop_eoe.sw.Confidence

Confidence Tests

desktop_eoe.sw.Desks

Desktop Desks

desktop_eoe.sw.FileTypingRules

Desktop Filetype Rules

desktop_eoe.sw.control_panels

Desktop Control Panels

desktop_eoe.sw.dso

Desktop Shared Libraries

desktop_eoe.sw.envm

Desktop

desktop_eoe.sw.fam

Desktop File Alteration Monitor

desktop_eoe.sw.toolchest

Desktop Toolchest, 5.3

desktop_tools

Desktop Tools, 5.3

desktop_tools.sw

Desktop Tools Software

desktop_tools.sw.tape_backup

Desktop Tape Backup

desktop_tools.sw.tools

Desktop Tools

desktophelp

Desktop Help Environment, Release 1.0

desktophelp.sw

Desktop Help Software, Release 1.0

desktophelp.sw.client

Desktop Help Software, Release 1.0

dmedia_eoe

IRIS® Digital Media Execution Environment, 5.3

dmedia_eoe.books

Media Control Panels Help/User's Guide

dmedia_eoe.books.MediaCtls_UG

Media Control Panels Help/User's Guide

dmedia_eoe.data

IRIS Digital Media EOE Data Files

dmedia_eoe.data.soundscheme

SoundScheme Data Files

dmedia_eoe.sw

IRIS Digital Media Software

dmedia_eoe.sw.audio

Audio Execution Environment

dmedia_eoe.sw.common

Common Execution Environment Components

dmedia_eoe.sw.soundscheme

SoundScheme Sound Server

dmedia_eoe.sw.video

Video Execution Environment

dmedia_tools

IRIS Digital Media Tools, 5.3

dmedia_tools.books

Media Tools Help/User's Guide

dmedia_tools.books.MediaTls_UG

Media Tools Help/User's Guide

dmedia_tools.data

IRIS Digital Media Data Files

dmedia_tools.data.movies

Sample Movie Files

dmedia_tools.sw

Digital Media Tools

dmedia_tools.sw.cddat

CD/DAT Audio Tools

dmedia_tools.sw.movietools

Movie Playback, Recording, Conversion

dmedia_tools.sw.soundtools

Sound Playback, Recording, Conversion

dps_eoe

Display PostScript®/X, 2.0.3 based on PostScript Level 2

dps_eoe.sw

DPS/X Software

dps_eoe.sw.dps

DPS/X Execution Environment

dps_eoe.sw.dpsfonts

PostScript Type1 Fonts

eoe2.sw.gltools

Graphics Library[tm] Tools

eoe2.sw.imagetools

Graphics Library Image Tools

il_eoe

IMAGEVISION[tm] Library Execution Only Environment, 2.4

il_eoe.sw

IMAGEVISION Executable Software

il_eoe.sw.c++

IMAGEVISION Shared C++ Library

il_eoe.sw.fit

IMAGEVISION FIT Image File Support

il_eoe.sw.gif

IMAGEVISION GIF Image File Support

il_eoe.sw.photocd

IMAGEVISION PhotoCD Image File Support

il_eoe.sw.sgi

IMAGEVISION Silicon Graphics Image File Support

il_eoe.sw.tiff

IMAGEVISION TIFF Image File Support

imgtools

IMAGEVISION Tools, 2.2

imgtools.books

IMAGEVISION Tools User's Guide

imgtools.books.tools

IMAGEVISION Tools User's Guide

imgtools.hlp

IMAGEVISION Tools Help

imgtools.hlp.tools

IMAGEVISION Tools Help Cards

imgtools.sw

IMAGEVISION Tools

imgtools.sw.tools

IMAGEVISION Tools

insight

IRIS InSight Viewer, 2.3

insight.books

IRIS InSight Viewer Help Book, 2.3

insight.books.help

IRIS InSight Help

insight.books.ViewerHelp

SGIHelp (Desktop Help) Help, 1.1

insight.books.help

IRIS InSight Help, 2.3

insight.sw

IRIS InSight Viewer, 2.3

insight.sw.client

IRIS InSight Viewer, 2.3

insight.sw.data

IRIS InSight Data, 2.3

inventor_eoe

Inventor Execution Only Environment, 2.0.1

inventor_eoe.sw

Inventor User Software

inventor_eoe.sw.1_1

Inventor 1.1.2 Run-time

motif_dev

IRIX IM Development Software, 1.2.4 (based on OSF/Motif 1.2.4)

motif_dev.sw

Software Developer Software

motif_dev.sw.dev

IRIX IM Libraries and Header Files (based on OSF/Motif 1.2.4)

motif_eoe

IRIX IM Execution Only Environment, 1.2.3 (based on OSF/Motif 1.2.4)

motif_eoe.sw

Execution Only Environment Software

motif_eoe.sw.eoe

IRIX IM Run-time Software (based on OSF/Motif 1.2.4)

netls_eoe.books

IRIS InSight Books, Release 2.2

netls_eoe.books.NetLS_AG

Network License System Administration Guide

print

Printing Tools, Release 1.3

print.sw

Printing Tools Software 1.3

print.sw.desktop

Desktop Graphical Printing Tools 1.3

sgihelp

SGIHelp (Desktop Help) Server, 1.0.1

sgihelp.books

SGIHelp (Desktop Help) Data, 1.0.1

sgihelp.books.ViewerHelp

SGIHelp (Desktop Help) Data, 1.0.1

sgihelp.sw

SGIHelp (Desktop Help) Server, 1.0.1

sgihelp.sw.eoe

SGIHelp (Desktop Help) Server, 1.0.1

showcase

IRIS Showcase 3.3

showcase.books

IRIS Showcase 3.3 User's Guide

showcase.books.showcase

Showcase User's Guide

showcase.sw

IRIS Showcase 3.3 Software

showcase.sw.data

Necessary Data Files

showcase.sw.fonts

Additional Fonts

showcase.sw.models

Sample 3D Models

showcase.sw.onlinehelp

Online Help

showcase.sw.showcase

IRIS Showcase 3.3 Software

showcase.sw.templates

Sample Templates

sysadmdesktop

Desktop Administration, 5.3

sysadmdesktop.sw

Desktop Administration Software, 5.3

sysadmdesktop.sw.clients

Desktop Administration Client Software

tooltalk_eoe

ToolTalk 1.2.2 Execution Only Environment

tooltalk_eoe.sw

ToolTalk runtime executables and library

tooltalk_eoe.sw.links

ToolTalk sw links

tooltalk_eoe.sw.runtime

ToolTalk runtime

x_dev

X11 Development Environment, 3.3 based on X11R6

x_dev.sw

X11 Development Environment

x_dev.sw.binaries

X11 Development Binaries

x_dev.sw.dev

X11 Development Hdrs/Libs

x_eoe

X11 Execution Environment, 3.3 based on X11R6

x_eoe.sw

X11 Execution Environment

x_eoe.sw.Server

X11 Window Server and Font Server

x_eoe.sw.Xapps

X11 Applications

x_eoe.sw.Xfonts

X11 Standard Fonts

x_eoe.sw.Xgifts

X11 Unsupported Demos & Gifts

x_eoe.sw.Xoptfonts

X11 Optional Fonts

x_eoe.sw.eoe

X11 Execution Environment

x_eoe.sw.xdps

DPS/X X11 Server Extension

Table 7-2 lists IRIX 6.2 subsystems that can be removed to save disk space

Table 7-2. Possible IRIS 6.2 Subsystems to Remove

Subsystem Name

Description

4Dwm

Desktop Window Manager, 6.2 (based on OSF/Motif 1.2.4)

cadmin

Object System, 6.2

desktop_base

IndigoMagic Desktop Base Software, 6.2

desktop_tools

Desktop Tools, 6.2

dps_eoe

Display PostScript/X, 2.0.5 based on PostScript Level 2

eoe.man.gltools

Graphics Library Tools Man Pages

eoe.sw.gltools

Graphics Library Tools

il_eoe

ImageVision Library Execution Only Environment, 2.5.1

motif_eoe

IRIX IM Execution Only Environment, 6.2 (based on OSF/Motif 1.2.4)

sysadmdesktop

Desktop System Administration, 6.2

sysmon

Desktop System Monitor, 1.2.2

sysmon.books

Desktop System Monitor Help

sysmon.books.ErrorHelp

Desktop System Monitor Error Help

sysmon.books.Help

Desktop System Monitor Help

sysmon.man

Desktop System Monitor Man Pages

sysmon.man.relnotes

Desktop System Monitor Release Notes

sysmon.man.sysmon

Desktop System Monitor Man Pages

sysmon.sw

Desktop System Monitor

sysmon.sw.notifier

Desktop System Monitor Notifier

sysmon.sw.viewer

Desktop System Monitor Viewer

tooltalk_eoe

ToolTalk 1.3 Execution Only Environment

tooltalk_eoe.sw

ToolTalk runtime executables and library

tooltalk_eoe.sw.links

ToolTalk sw links

tooltalk_eoe.sw.runtime

ToolTalk runtime

vino

Indy Video-In Execution Environment, 6.2

vino.man

Indy Video-In Documentation

vino.man.pages

Indy Video-In Manual Pages

vino.man.relnotes

Indy Video-In Release Notes

vino.sw

Indy Video-In Software

vino.sw.eoe

Indy Video-In Execution Software

x_eoe

X11 Execution Environment, 4.0.1 based on X11R6

x_eoe.man

X11 Manual Pages

x_eoe.man.Server

X11 Server Manual Pages

x_eoe.man.Xapps

X11 Applications Manual Pages

x_eoe.man.eoe

X11 Execution Environment Manual Pages

x_eoe.man.relnotes

X11 Release Notes

x_eoe.sw

X11 Execution Environment

x_eoe.sw.Server

X11 Window Server and Font Server

x_eoe.sw.Xapps

X11 Applications

x_eoe.sw.Xfonts

X11 Standard Fonts

x_eoe.sw.eoe

X11 Execution Environment

x_eoe.sw.xdps

DPS/X X11 Server Extension

x_eoe.sw32

X11 n32 Execution Environment

x_eoe.sw32.eoe

X11 n32 Execution Environment

x_eoe.sw64

X11 64-bit Execution Environment

x_eoe.sw64.eoe

X11 64-bit Execution Environment