13.4 Configuring PSE Networking Kernel Binaries

UDP_prime is a subset of the UDP/IP stack with high bandwidth and low latency that is optimized for use with FDDI hardware. Non-HPF applications continue to use the original UDP/IP stack code. HPF programs use the enhanced UDP_prime stack.

If you choose to install this subset, you need to perform several additional configuration steps to install UDP_prime into your running kernel.

The UDP_prime installation replaces several .o files in the /sys /BINARY directory with new .o files. The scripts in the /sys/UDP_ PRIME directory are used to install and deinstall the files. The Install script moves the original .o files to new filenames having the .o.old suffix, and links the new .o files to the /sys/BINARY directory. The Uninstall script reverses the process by restoring the original .o.old files back to the original .o files in /sys /BINARY. After running the Install script, the vmunix kernel needs to be relinked with the new .o files.

13.4.1 Installing UDP_prime

To install UDP_prime on a machine named max follow these steps:

1. Install PSEKBIN300120 on the system.
2. Run the Install script:

   # cd /sys/UDP_PRIME
   # ./Install
   

3. Relink the vmunix kernel:

   # cd ../MAX
   # rm vmunix*
   # make
   

4. Copy the new kernel to the root directory and reboot.

   # cp vmunix /vmunix
   # shutdown -r +5 "Installing a UDP_prime kernel  . . . "
   

13.4.2 Deinstalling UDP_prime

To deinstall UDP_prime on a machine named max , follow these steps:

1. Run the Uninstall script:

   # cd /sys/UDP_PRIME
   # ./Uninstall
   

2. Relink the vmunix kernel:

   # cd /sys/MAX
   # rm vmunix*
   # make
   

3. Copy the new kernel to the root directory and reboot:

   # cp vmunix /vmunix
   # shutdown -r +5 "Deinstalling a UDP_prime kernel  . . . "
   

If you decide to delete the PSEKBIN300120 subset from the system, the deletion procedure automatically performs Step 1. After the deletion, you have to perform Steps 2 and 3.

13.4.3 Sample UDP_prime Installation Log

Example 13-1 documents an installation of a UDP_prime kernel after the PSEKBIN300120 has been installed on node ferme :

Example 13-1 Sample UDP_prime Installation Log

# cd /sys/UDP_PRIME
# ./Install
# cd ../FERME
# rm vmunix*
# make
cc  -c -O2   -DLANGUAGE_C -g3 -G 4 -I -I. -I.. -I../include -DIDENT=FERME
-DDEC
sh ../conf/newvers.sh ../conf/copyright `cat ../conf/version.type ../conf/ve
cc -I -I. -I.. -I../include -DIDENT=FERME -DDEC3000_500 -DSWAPTYPE=1 -DUERF
-DO
rm -f vmunix vmunix.sys
loading vmunix.sys
chmod 755 a.out
null command)
mv a.out vmunix.sys
ln vmunix.sys vmunix; ln vmunix vmunix.FERME
(null command)
(null command)
(null command)
# cp vmunix /vmunix
# shutdown -r +5 "Installing a UDP_prime kernel  . . . "
#

13.4.4 Sample UDP_prime Deinstallation Log

Example 13-2 documents a deletion of the PSEKBIN300120 subset and a deinstallation of the UDP_prime kernel on node ferme:

Example 13-2 Sample UDP_prime Deinstallation Log

# setld -d PSEKBIN300120

Copyright (c) Digital Equipment Corporation, 1994.  All Rights Reserved.
Parallel Software Environment for DEC OSF/1 AXP V1.2-0
Subset: PSE Networking Kernel Binaries for DEC OSF/1 V3.0 (PSEKBIN300120)

Starting configuration (DELETE) at Fri Jan 20 14:54:05 EST 1995.

    Restoring the original .o files  . . .  Done.

************************ DE-INSTALLATION NOTE**************************
*                                                                     *
* To complete the de-installation, you need to relink the kernel.     *
* This can be done by executing the following commands:               *
*                                                                     *
* % su                                                                *
* # cd /usr/sys/FERME                                                 *
* # rm vmunix*                                                        *
* # make                                                              *
* # cp vmunix /vmunix                                                 *
* # shutdown -r +5                                                    *
*                                                                     *
***********************************************************************

Completing configuration (DELETE) at Fri Jan 20 14:54:08 EST 1995.

Copyright (c) Digital Equipment Corporation, 1994.  All Rights Reserved.
Parallel Software Environment for DEC OSF/1 AXP V1.2-0
Subset: PSE Networking Kernel Binaries for DEC OSF/1 V3.0 (PSEKBIN300120)

Starting de-installation at Fri Jan 20 14:54:08 EST 1995.
There are no de-installation questions for this subset.

Removing softlinks for PSEKBIN300120  . . .  done.

Deleting "PSE Networking Kernel Binaries for DEC OSF/1 V3.0"
(PSEKBIN300120).

Parallel Software Environment for DEC OSF/1 AXP V1.2-0
Subset: PSE Networking Kernel Binaries for DEC OSF/1 V3.0 (PSEKBIN300120)

De-installation is completed at Fri Jan 20 14:54:10 EST 1995.

# cd /sys/FERME
# rm vmunix*
# make
cc -c -O2 -DLANGUAGE_C -g3 -G 4 -I -I. -I.. -I../include -DIDENT=FERME -DDEC
sh ../conf/newvers.sh ../conf/copyright `cat ../conf/version.type ../conf/ve
cc -I -I. -I.. -I../include -DIDENT=FERME -DDEC3000_500 -DSWAPTYPE=1 -DUERF
-DO
rm -f vmunix vmunix.sys
loading vmunix.sys
chmod 755 a.out
(null command)
mv a.out vmunix.sys
ln vmunix.sys vmunix; ln vmunix vmunix.FERME
(null command)
(null command)
(null command)
# cp vmunix /vmunix
# shutdown -r +5 "Deinstalling UDP_prime kernel  . . . "
#