Driver Device Installation



Who Should Install the Software

Because the software installation procedure involves reconfiguring the operating system kernel, only a system administrator or an experienced end- user familiar with operating system kernel reconfiguration should install this software.

CD-ROM

The CD-ROM contains the device driver software and the SunDiag diagnostic program for the SBus Expansion Subsystem. Instructions for mounting and accessing the CD-ROM follow.

CDmanager is available in /cdrom as two programs: cdm and cdmanager. cdm is the command line interface to cdmanager that can be run from a terminal window under SunView(TM) or under OpenWindows(TM). The Graphical User Interface version of CDmanager, cdmanager, can be run only under OpenWindows

Refer to the CDmanager and CDM 2.0 User's Guide for any questions not covered by this guide when you are using the CDmanager or CDM procedures.

Mounting CD-ROM

Mount the CD-ROM before you start CDmanager or CDM. If you type mount and the CD is mounted, this line appears:

    /dev/sr0 on /cdrom type 4.2

If this line does not appear, the CD-ROM is not mounted and you must mount the CD-ROM.

Method of Installation

There are two methods of installing software. You can install the software either on a local machine or on a remote machine. In both cases you must mount the CD-ROM before installing the device driver.

To mount the CD-ROM on a local machine:

Note - You can start these programs without becoming superuser, but you must be superuser to install the drivers.

    1. Place the CD-ROM in its caddy. Insert the caddy into the drive.
    2. Become superuser. Type su.
    3. At the Password prompt, type your superuser password and press Return.
    4. Type /usr/bin/mkdir /cdrom and press Return.
    5. Type mount -tr hsfs/dev/sr0 /cdrom and press Return.

As an example. 

------------------------------------------

%/usr/bin/su
Password   Type superuser password
# /usr/bin/mkdir  /cdrom
# /usr/bin/mount -tr hsfs/dev/sr0 /cdrom

------------------------------------------

Note - The "-r" option indicates that the CD-ROM is mounted read-only. If you mount the CD-ROM without the "-r" option, you will occasionally see media error messages on the console.

    6. Exit from superuser by typing Control-d.

To mount the CD-ROM from a remote machine:

    1. Log on to the remote machine and type su to become superuser.
    2. Type mkdir /cdrom and press Return.
    3. Edit the /etc/exports file, if it exists, by adding the following line:

    /cdrom -ro

    If the /etc/exports file does not exist, create it.

    4. If /etc/exports existed previously, type exportfs -a and go to step 6.
    5. If /etc/exports did not exist, reboot your machine to become an NFS server.
    6. Place the CD-ROM in its caddy and insert the caddy into the drive.
      a. Type su and enter the superuser password.
      b. Type /etc/halt and press Return.
      c. If you see the prompt, type b to reboot your system. If you see the ok prompt, type reboot to reboot your system.
    7. On the remote machine, type mount -r /dev/sr0 /cdrom and press Return.
    8. Become root or superuser on the local machine.
    9. On the local machine, type mkdir /cdrom and press Return.
    10. On the local machine, type
    mount remote_machinename:/cdrom /cdrom and press Return.
    11. Exit root by typing Control-d.

Starting CDmanager

Use the procedure in this section is you are running OpenWindows. If you are not running OpenWindows, refer to the Section "Installing the SBus Expansion Subsystem 1.0 using cdm."

You can start CDmanager two ways: from an OpenWindows Command Tool or Shell Tool, or from File Manager.

To start CDmanager from a Command Tool or Shell Tool:

    1. Change to superuser by entering su
    2. Change to the /cdrom directory. Type cd /cdrom and press Return.
    3. Type cdmanager & and press Return.

Note - If you are installing software, starting CDmanager from File Manager is not an option unless you are root. If you attempt to install software from a CDmanager you have started from File Manager, the permissions may be incorrect and you will not be able to install a number of applications. If you are installing software, use Command Tool to start CDmanager.

To start CDmanager from File Manager:

Use the procedure in this section if you are running OpenWindows. If you are not running OpenWindows, refer to the Section "Installing the SBus Expansion Subsystem 1.0 using cdm."

    1. In the File Manager Goto text field, type /cdrom.
    2. Click SELECT on the Goto menu button. The applications in the /cdrom directory are displayed in the scrolling pane.
    3. Double-click SELECT on the cdmanager icon. After a few moments, the XBox base window is displayed on the workspace.

    .

    Figure 2-1 CDmanager base window

Installing the Sbus Expansion Subsystem 1.0 from the CD-ROM

Options

To install the software for the SBus Expansion Subsystem, do the following:

    1. Move your cursor to the SBus Expansion Subsystem icon and click the SELECT key.

After you press the SELECT key, the system will darken the icon and put it into a box frame.

    Figure 2-2 A selected SBus Expansion Subsystem icon

    2. Keep the cursor on the darkened icon and click the MENU button on the mouse.

    A pop-up menu with three highlighted choices will appear on the screen.

    3. Move the cursor to the Read About button, click the MENU button. A popup screen will appear that has the requirements for running the SBus Expansion Subsystem.

    Be sure your computer system has these minimum requirements before proceeding.

    4. Next move the cursor to the Install button, click the MENU button.

    A pull-down menu will appear with a button labeled Install Driver and Kernel Patches.

    5. Move the cursor to the Install Driver and Kernel Patches button until it darkens. Then click the MENU button.

    At this time the Applications Installation window will open over the CDManager window. The Applications Installation window will have the copyright information on it. Page through the copyright document by pressing the Return key or press the Space Bar and go directly to the bottom.

    6. To complete your installation of the SBus Expansion Subsystem, follow the procedures listed in the Section "Completing the Installation of the SBus Expansion Subsystem 1.0"

Installing the SBus Expansion Subsystem 1.0 Using cdm

Use the procedure in this section only if you are not running OpenWindows.

To start the cdm from a computer:

    1. Change directory to /cdrom. Type cd /cdrom and press Return.
    2. Type cdm and press Return.

    The system will return the following menu: 

----------------------------------------

Current program environment:
Application:none
Category:all
Directory:/cdrom
----->> CDM <<<<<-----
1.Select Application
2.Show Current Application
3.Install Application
4.Display Application
5.Print Application
6.List Applications
7.List Categories
8.Change Current Category
9.Change Current Directory
10.Show Program Environment
Please enter a number or q to quit: 1

----------------------------------------
    3. At the prompt, type 1 and press the Return key.

    This is the Select Application menu and the system will display the applications available. 

-------------------------------------------------

Applications available:
1. XBox
Please enter a number or q for the main menu: 1

-------------------------------------------------
    4. At the prompt, type 1 and press Return.

    Again, you should see the menu shown in step 2, above.

    5. Next type 3 and press the Return key to start the installation.

    Complete the installation as shown in the following section.

Completing the Installation of the SBus Expansion Subsystem 1.0

    1. When you reach the bottom of the copyright information, the following question will appear on the screen. 
--------------------------------

Do you want to continue? [y|n]

--------------------------------


--------------------------------------

Enter a y or n and press Return key.

--------------------------------------
    2. If you have an existing kernel, the system will back it up at this time. 
----------------------------

Backing up your kernel ...

----------------------------
    3. If you have an existing /vmunix.old kernel in your directory, the system will display the following messages : 
---------------------------------

You already have a /vmunix.old 
Ok to overwrite it?

---------------------------------

    Type y and press Return to overwrite /vmunix.old.

    4. If you do not want to overwrite /vmunix.old,type n and pres Return. The system will give the following message: 
----------------------------------------------

Move /vmunix.old to another name and restart
the Xbox installation.

----------------------------------------------

    The installation script then exits the script. To rename your present /vmunix.old kernel new name, do the following at the operating system prompt:

      a. Become super user. Type su and press Return.
      b. Change to the root (/) directory. Type cd / and press Return. 
------------------------------------------------------------

Move /vmunix.old to another name and restart the XBox 1.0 
installation

------------------------------------------------------------
      c. Rename /vmunix.old.

      Type mv /vmunix.old <new.filename> and press Return.

      d. Restart the software installation process.

      Refer to the section "Installing the SBus Expansion Subsystem 1.0 from the CD-ROM" or the section "Installing the SBus Expansion Subsystem 1.0 Using cdm."

    5. Type y and press Return.

    The system will then install SunDiag programs, the kernel, and the patches.

    If you are running SunOS version 4.1.1, you will receive the following messages: 

--------------------------------------------------------------

Creating device nodes ...
Installing Sundiag files .
Installing files in / & /usr ...
Ok to install the following 4.1.1 patches on your system:
usr/sys/sun4c/OBJ/autoconf.o 
usr/sys/sun4c/OBJ/openprom_xxx.o 
usr/sys/sun4c/openprom_xxx.c 
usr/sys/sun/openprom.h 
usr/include/sun/openprom.h
Please verify that the above files have not been previously 
patched. See the Xbox installation manual for more details.
Ok?

--------------------------------------------------------------

If you are running SunOS version 4.1.2 you will receive the following messages: 

--------------------------------------------------------------

Creating device nodes ...
Installing Sundiag files .
Installing files in / & /usr ...
Ok to install the following 4.1.2 patches on your system:
usr/sys/sun4c/OBJ/autoconf.o 
usr/sys/sun4c/OBJ/openprom_xxx.o 
usr/sys/sun4c/openprom_xxx.c 
Please verify that the above files have not been previously 
patched. See the Xbox installation manual for more details.
Ok?

--------------------------------------------------------------

If your records show that you have previously patched these files, enter an n and press the Return key to discontinue the software installation.

Typing a y and pressing the Return key will install the patches. This will overwrite any previously entered patches if they are present.

    6. If you answer y to this inquiry, you will then receive the following: 
---------------------------------------------------------------------

Backing up files about to be patched ... 
Installing patches ...
 
Backing up /usr/sys/sun4c/conf/files ... 
Modifying /usr/sys/sun4c/conf/files ...
 
Backing up /usr/sys/sun/conf.c ... 
Modifying /usr/sys/sun/conf.c ...
A generic Xbox kernel has been installed in /vmunix. However, you 
may want to make a kernel for your system if you are not currently 
running the generic kernel.
Would you like to make a new kernel for your system now? [y|n]

---------------------------------------------------------------------
    7. Type n and press Return if you do not want a new kernel. The system will use the GENERIC kernel. Type y and press Return to make a kernel whose name you can specify (not GENERIC). The config file you name must already exist. 
-------------------------------------------------------------------

We will try to determine and use the config file for the kernel 
you are currently running (shown in []'s below). If you want to 
specify a different config file you may do so, otherwise, please 
hit <RETURN.
Config file to use [GENERIC]? 

-------------------------------------------------------------------

If you type any other character except y or Return, the system will terminate the procedure. This message permits you to select a different config file than your system default config file. The config file you name must already exist.

    8. Pressing Return or entering a new config file name will result in the following messages. 
-------------------------------------------------------------------

Building a kernel will take about 10 minutes.
Config'ing /sys/sun4c/conf/GENERIC_XBOX ...
Making /sys/sun4c/GENERIC_XBOX kernel ...
Copying new kernel to your root directory
Your new kernel has been successfully loaded and placed in 
/vmunix. Reboot your system to use the new kernel.
Kernel configuration complete.
Installation of XBox 1.0 files from CD-ROM finished. You may now 
exit CDManager.
Done analyzing installation results [y/n]?

-------------------------------------------------------------------
    9. Type y and press Return.

    You have now successfully installed the SBus Expansion Subsystem software on your computer system.

    10. Reboot your system to use the new driver and kernel
Warning -

If the system is unsuccessful in replacing the autoconfig file, do not try to boot the system. Contact your authorized Sun technical support person for assistance. If you must boot your system, you can use the /vmunix.old kernel.

Quitting CDmanager

Quit CDmanager when you are through viewing the applications on CD-ROM or elsewhere in your filesystem.

To quit CDmanager:

    1. Click MENU on the CDmanager window header. The menu window appears.
    2. Click SELECT on Quit, the last item in the menu to exit the CDmanager program.

To eject the CD-ROM disc:

    1. Type cd / in the Command Tool window and press Return. If you are using File Manager, type / in the GoTo text field, and click SELECT on the GoTo menu button.
    2. If you are not already superuser, become superuser. Type su.
    3. At the Password prompt, type your root password and press Return.
    4. Type eject sr0 and press Return. The CD-ROM disc is ejected from the drive.

Note - If you have disabled OpenWindows security, enable it again before you finish your session.

To enable OpenWindows security:

    1. If you are root, exit root by typing Control-d.
    2. Type xhost -machinename and press Return

Troubleshooting

CDmanager Problems

setenv DISPLAY machinename: screen

where machinename is the workstation where the CDmanager is displayed and screen is the screen number where CDmanager is to be displayed (normally 0.)