Technical article 105637

What is Support Level Supplement (SLS) OSS439A, the Set MAC Address Supplement?

OpenServer 5.0.0OpenServer 5.0.2

Written · Last revised

Problem

What is Support Level Supplement (SLS) OSS439A, the Set MAC Address Supplement for SCO OpenServer Release 5.0.0, 5.0.2 and SCO Internet FastStart 1.0.0 and 1.1.0, and how do I install it?

Solution

The attached cover letter describes the enhancements and corrections
to known problems for SCO OpenServer Release 5.0.0, 5.0.2  and SCO
Internet FastStart 1.0.0 and 1.1.0 found in, and the installation
procedure for, SLS OSS439A.
Dear SCO Customer,

The enclosed Support Level Supplement (SLS) OSS439A, the Set MAC Address Supplement, provides support for dynamically changing MAC addresses with the following networking drivers and associated networking cards:

wdn         Western Digital WD8003/WD8013
pnt         AMD PCNet-ISA/PCNet-ISA+/Novell NE2100
SLS OSS439A should only be installed on SCO systems based on the SCO
OpenServer Release 5.0.0 and 5.0.2 operating systems, and SCO Internet
FastStart Release 1.0.0 and 1.1.0 operating systems.  This SLS is required
by some non-SCO software that must set the MAC address used by the network
card (for example, DECnet networking).
CAVEATS:
If there is a requirement to support TCP/IP networking on the target
network interface card, the new MAC address must be set on the card
before TCP/IP is started for the first time after booting.  However, on
SCO OpenServer Release 5, TCP/IP starts up early in the boot sequence,
well in advance of the machine entering multiuser mode and before the
system setup scripts are executed.
To work around this, use the boot option ksl.disable (add the command
"ksl.disable" to the DEFBOOTSTR line in /etc/default/boot).  This allows
the system to come up into single-user mode without starting TCP/IP.  At
this time, the MAC address may be changed by the user's application
software.  TCP/IP will start up automatically when entering multiuser
mode and will use the new MAC address assigned to the card.
INSTALLATION AND REMOVAL INSTRUCTIONS
Installing patches on SCO OpenServer 5.0.0 and 5.0.2 usually consists of
two phases: "Loading" and "Applying".  The instructions that follow enable
you to both install the patch from distribution media or media image, as
well as configure the patch to be installed from a remote SCO OpenServer
5.0.0 or 5.0.2 system over a TCP/IP network.
I. BEFORE LOADING THE PATCH

If you have already configured one or more networking cards on your system, you must deconfigure them before loading the patch using netconfig.

If you are running SCO OpenServer 5.0.0 on your system, make sure you have also installed Release Supplement 5.0.0d for SCO OpenServer Release 5 prior to installing this patch.

II. LOADING THE PATCH
1. Log in as root.

2. If you are installing this SLS from floppy disk media, skip this step and proceed to step 3.

If you are installing this SLS from a media image, there is a file
called oss439a.Z.  Uncompress this file with this command:
# uncompress oss439a.Z

Copy the file to the /tmp directory and name it VOL.000.000:

# cp oss439a /tmp/VOL.000.000
3. Execute the command:
# scoadmin software

or double click on the Software Manager icon on the desktop.

4. Pull down the "Software" menu and select "Patch Management-->Load Patch".

5. You will see the "Begin Load Patch" menu.  Be sure the
   local machine name is selected and choose "Continue".

6. You will see the "Select Media" menu.

a. If you are loading this SLS from floppy disk media,
   select the appropriate floppy disk drive and
   choose "Continue".  Proceed to step 7.
b. If you are loading this SLS from a media image per step 2,
   pull down the "Media Device" menu and select "Media Images",
   then choose "Continue".  You will then see the "Enter Image
   Directory" menu.  Enter /tmp and choose "OK".
7. You will see the "Load Patch Preference" menu.  Choose "Full".
8. You will see the "Load Patch Progress" window.  If the patch loads
   successfully, you will see a "Message" window which states "Load
   Patch complete".  Choose "OK".  You are then returned to the main
   Software Manager window.
9. To apply the patch now, continue with step 2 under section III,
   "Applying the Patch".  To exit the Software Manager now, select
   "Exit" from the "Host" menu.
III. APPLYING THE PATCH

1. Log in as root. Execute the command:

# scoadmin software

or double click on the Software Manager icon on the desktop.

2. Pull down the Software menu and select "Patch Management-->Apply Patch".

3. You will see the "Begin Apply Patch" menu.  Be sure that the local
   machine name is selected and choose "Continue".
4. You will see the "Select Media" menu. The "Hard Disk" menu item
   should already be selected.  Choose "Continue".

5. You will be presented with the "Select Patch-product to Apply" menu. Highlight the "Set Mac Address (Version oss439)" patch and then choose "Full" to continue.

6. You will see the "Apply Patch Progress" window as the system applies the patch.

7. If one or more network devices are already installed on your machine you will see this message:

"One (or more) networking device is already installed on your system. To properly apply or rollback this SLS, you need to deconfigure all the networking devices by running netconfig. Deconfigure all the networking devices and try again!"

In this case, you need to quit patch management and start "netconfig" by typing netconfig at the shell prompt (root); after the netconfig program has started you can remove the device and reapply the patch by following the previous steps, namely steps 1 to 7.

IV. NOTES ON NETWORK INSTALLATION
To install the patch on other SCO OpenServer 5.0.0 or 5.0.2 machines over
the network, first load the patch as in section II above on a designated
installation server.  Then create the user "swadmin" on the installation
server.
When running the Software Manager on the system where the patch will be
installed, you will be prompted for the source location of the patch in
the "Begin Load Patch" window.  Be sure to choose "From Another Host"
during this phase.  You will need to provide the name of the installation
server, as well as the password of the "swadmin" user on the installation
server, to initiate the installation process.
V. PATCH REMOVAL
Note: Patches must be rolled back in the reverse order in which they
were installed on a per-component basis.  Hence, if the "Set MAC Address"
patch is not the most recent patch applied to the lli component of the
product, you will have to rollback all patches applied after the "Set MAC
Address" patch prior to rollback of this patch.
1. Log in as root.
2. Execute the command:
# scoadmin software

or double click on the Software Manager icon in the desktop.

3. Pull down the "Software" menu and select "Patch Management-->Rollback Patch".

4. You will see the "Begin Rollback Patch" menu, and be asked to select patched software to rollback. Select "Network Drivers" and choose "Continue".

5. You will see the "Patch Selection" window. Make sure that the "Set MAC Address" patch is selected, and choose "Continue".

6. You will see the "Confirm Selected Patches" window. Choose "Rollback" to confirm removal of the "Set Mac Address (Version oss439" patch.

7. You will see the "Rollback Progress" window, as the system performs the rollback of the patch.

8. If one or more network devices are still installed on your machine, you will see this message:

"One (or more) networking device is already installed on your system. To properly apply or rollback this SLS, you need to deconfigure all the networking devices by running netconfig. Deconfigure all the networking devices and try again!"

In this case, you must cancel the rollback of the SLS and start "netconfig" by typing netconfig at the shell prompt (root); after the netconfig program has started you can remove the device and then reapply the patch following the previous steps, namely, steps 1 to 7.

9. To also unload the patch, making it no longer available to be applied,
   follow the steps in this section.  In step 3, choose:
"Patch Management-->Unload Patch"
instead of:
"Patch Management-->Rollback Patch"

If you have questions regarding this SLS, or the product on which it is installed, please contact your software supplier.

We appreciate your business.
SCO Support Services

From the Xinuos technical article database, record 105637. Reproduced with permission. The original is at www.sco.com/ta/105637, which is reachable but blocked from search engines. Xinuos marks this article against a retired product line. That refers to the product’s lifecycle, not to whether the advice still works — plenty of it still applies to running systems.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.