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