A The SNC Distribution Software





A.1 The Sun Network CoProcessor Distribution Files

This section describes the files that are added or changed during the process of installing the 1.2 Sun Network CoProcessor Software.

A.1.1 New Files Added During the Installation

---------------------------------------
usr/etc/necons
usr/etc/neload
usr/etc/nestat
usr/etc/nestop
usr/etc/newatch
usr/etc/sncnet
usr/etc/snc_nfsd
usr/man/man4/ne.4
usr/man/man8/snc_nfsd.8
usr/man/man8/neload.8
usr/man/man8/nestat.8
usr/man/man8/nestop.8
usr/man/man8/newatch.8
usr/man/man8/sncnet.8
usr/man/man8/MAKEDEV.ne.8
dev/MAKEDEV.ne
etc/reload.ne0
etc/reload.ne1
etc/reload.ne2
etc/reload.ne3
etc/reload.ne4
etc/reload.ne5
etc/reload.ne6
etc/reload.ne7
etc/ne.dwnld
sbin/neload
sbin/sncnet
sys/nfs/nfsagent.h
sys/sundev/nereg.h
sys/sundev/ne_conf.c
sys/sun4m/OBJ/ne.o
sys/sun4m/OBJ/nfs_sncsvr.o
sys/sun4m/OBJ/sncnet_vers.o
var/tmp/unbundled/SNC/deinstall_snc
var/tmp/unbundled/SNC/snc.newfiles
var/tmp/unbundled/SNC/snc.overwritten

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

In addition, files in sys/sun4m/conf may have been created based on user responses during the installation. These would be related to the changes needed to make a new, SNC compatible kernel. For more information on kernel configuration, please refer to the appropriate section in the System Administration Manual.

A.1.2 Existing Files Changed During the Installation

---------------------------
etc/rc.boot
etc/rc.local
usr/etc/arp
usr/etc/nfsstat
usr/man/man4/Intro.4
usr/man/man4/List.4
usr/man/man4/nfs.4p
usr/man/man8/Intro.8
usr/man/man8/List.8
usr/man/man8/nfsstat.8c
sys/conf.common/files.cmn
sys/sun/conf.c
sys/sun4m/OBJ/if.o
sys/sun4m/OBJ/in.o
sys/sun4m/OBJ/route.o
sys/sun4/OBJ/if.o
sys/sun4/OBJ/in.o
sys/sun4/OBJ/route.o

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

For each of the above files, the installation script retains copies of the original files in renamed files of the form "name.presnc". Do not move, rename or change these files for any reason. If you do, then the deinstall_snc script will not work properly.

Warning -

If you have installed any other software that has changed any of the above files after the SNC installation, then you must be very careful in executing the deinstall_snc script described in the next sections. In this case, it is likely that you will want to perform your deinstall by hand, by removing or changing the above files directly.

A.1.3 The *.add.* Files

The installation script edits specific files. The CD-ROM contains several "dot- add" files (so called because the file names are in the form of *.add.*). Each of the *.add.* files contains text to be added to an existing file, and comments which tell you exactly where and how to perform the required edits.

The following is a list of system configuration files that you must edit by hand if you do not allow the installation script to do it automatically:

--------------------------------------
etc/rc.boot
	Snc/_install/SNC/rc.boot.add.nc.a
etc/rc.local
	Snc/_install/SNC/rc.local.add.nc.a
	Snc/_install/SNC/rc.local.add.nc.b
sys/sun/conf.c
	Snc/_install/SNC/conf.c.add.nc.a
	Snc/_install/SNC/conf.c.add.nc.b
sys/sun4m/conf/GENERIC_SNC
	Snc/_install/SNC/config.add.nc.a
	Snc/_install/SNC/config.add.nc.b
sys/sun4/conf/GENERIC_SNC
	Snc/_install/SNC/config.add.nc.a
	Snc/_install/SNC/config.add.nc.b
sys/conf.common/files.cmn
	Snc/_install/SNC/files.cmn.add.nc.a

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

When you wish to reconfigure your system the *.add.* files will contain the necessary substitutions for the corresponding file.

For example:

Substitute the lines in conf.c.add.nc.b for the existing tm entries (major device number 5) in the cdevsw table for sys/sun/conf.c:

(old lines)

-----------------------------------------------------
tmopen, mclose, tmread, tmwrite, /*5*/ tmioctl, nulldev, seltrue, 0, -----------------------------------------------------

(new lines)

------------------------------------------------------
/* Sun Network CoProcessor */ neopen, neclose, neread, newrite, /*5*/ neioctl, nereset, neselect, nemmap, ------------------------------------------------------

A.1.4 Deinstalling the Sun Network CoProcessor Software

If you want to remove the software installed for the Sun Network CoProcessor, you are provided with a script to help you. Following your execution of the cdmanager installation procedure for SNC, a file will be left in the /var/tmp/unbundled/SNC or the /usr/tmp/unbundled/SNC directory called deinstall_snc. To remove the SNC software, simply cd to the appropriate directory and execute this script as Super-User. If you have cleared this directory, then the deinstall_snc script may also be found on the SNC distribution CD-ROM in Snc/_install/deinstall_snc and it may be executed directly from there.

After executing this script, you'll want to do the following:

    1. Remove the appropriate directories and config files that you may have used to create any new SNC compatible kernels.

    The deinstall_snc script does not do this automatically because of the probability that you may have other products installed on your system that may have used the original SNC configuration file as their starting point. As such, your local System Administrator should know what changes need to be preserved. Note however, that de-installing the SNC product removes the associated device driver files, so at the very least, you will need to remove the references to the ne devices from your config file.

    2. You will also probably want to change the vmunix file that your system boots from.

    This is contained in the root ( / ) directory. Your SNC kernel will still work. It will just be a little larger (by the size of the SNC driver code). This will reduce the amount of memory that is available to your users.

    3. Depending on your network configuration, you will need to change the

    /etc/hostname.xx# files that are used at boot time to bring up the different network interfaces.

If you did not disable your on-board le0 interface during your original installation, then you should be able to:

# rm /etc/hostname.ne*

Then make sure that /etc/hostname.le0 contains the name that you want the network to recognize your host as.

Alternately, if you've substituted one of the SNC boards for your on-board le0 interface, then you would:

# mv /etc/hostname.neX /etc/hostname.le0

# rm /etc/hostname.ne*

where "X" is the number of the SNC interface that was responding to your original hostname.