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 or remove software.
If you need advanced information on software installation or troubleshooting, see the IRIS Software Installation Guide. You can view this guide on-line using InSight, or you can order a printed copy.
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.) | |
| 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. For complete information, see the IRIS Software Installation Guide and the inst(1M) and versions(1M) reference pages.
Follow these steps to reinstall a new version of the operating system over a previous version:
Make a full system backup; see the IRIX Advanced Site and Server Administrator's Guide.
If hardcopy Release Notes accompanied the operating system you should read through them before continuing with the installation.
If you do not have a CD drive connected directly to your system, find a CD drive on your network. You will 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.
Insert the CD into the drive you are going to use.
Shut down the server. See “Turning Off the Challenge S Server”.
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:
Specify the location of the new software to install.
If you're using a CD-ROM drive that's connected to your own system, press 3. The “X” in the above screen indicates that the installation program will choose one of these options as the default.
If you're using a remote drive, press 1. You are prompted for the location of the remote drive. You will 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.)
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>
Install all or some of the subsystems that make up the operating system.
To install all of the default subsystems, type:
go
To install all optional and required subsystems, type:
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>
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.
When all the software is installed, type:
quit
You'll see several messages.
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”.
The system starts as usual. When the login prompt appears, log in to your own account.
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.
Before you install a new product, check its printed Release Notes for this information:
The version of the operating system (IRIX) that must be running 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 shows how much disk space each subsystem will use.
To make sure your system is ready for the new software, follow these steps:
Log in as root.
Check which version of the operating system your server us running by typing the following at a system prompt:
uname -a
Check whether required subsystems (determined by examining the Release Notes) are already installed by typing 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.
Check whether you have enough disk space by typing 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.
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).
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:
Insert the CD into the drive that's connected to your system, or the network drive that you found earlier.
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 type the following:
inst -f [email protected]:/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>
Install all or some of the subsystems of this product:
To install all of the default subsystems, type:
go
To install all optional and required subsystems, type:
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 on-line 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>
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.
When all the software is installed, type:
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.
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 IRIS Software Installation Guide.
The system cannot find the software when:
There is no CD in a drive that you specified.
Your system cannot contact the system on the network that has the software. See the IRIX Advanced Site and Server Administrator's Guide.
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
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:
Select fewer subsystems to install.
Remove subsystems that are already installed (see “Removing Optional Software”).
Quit the Software Manager (inst) and remove or archive files or directories (see “Removing Unnecessary Subsystems” for a list of the subsystems you may not need on the Challenge S server. Then see “Removing Optional Software” for basic information about using the versions command to remove software. See also the IRIX Advanced Site and Server Administrator's Guide for information about freeing up disk space).
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”.
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.
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:
Log in as root.
At the shell prompt, type:
versions
You see a list of all software products that are installed.
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, type relnotes at a shell prompt.
Remove an entire product or a specific subsystem.
To remove an entire product, such as Space Tour, type:
versions remove spacetour
To remove a specific subsystem, such as the large, optional movies that accompany Space Tour, type:
versions remove spacetour.data.movies
Table 7-1 lists IRIX subsystems that may be installed on your system but might not be needed. 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 Subsystems to Remove From the Challenge S Server
Subsystem Name | Description |
|---|---|
4Dwm | Desktop Window Manager, 5.3 (based on OSF/Motif[tm] 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[tm] 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[tm] 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 |
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[tm] 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[tm] 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 |