Technical article 109991

What problems are addressed by OSS496A, the Real Time Clock Supplement for SCO OpenServer?

OpenServer 5.0.0OpenServer 5.0.2OpenServer 5.0.4OpenServer 5.0.5

Written · Last revised

Problem

My system is experiencing one or more of the following problems:

1. My application reads the real time clock (RTC) using one of the following methods:

read(S) from /dev/rtc or /dev/clock
ioctl(S), RTCRTIME on /dev/rtc or /dev/clock
sysi86(S), function RTODC

and it occasionally retrieves an incorrect time.

2. The BIOS on my computer system which has SCO OpenServer installed on it fails after January 1st, 2000 because the RTC century byte is not set.

3. Another operating system is installed on my computer in addition to SCO OpenServer, and the time is incorrect under that OS after January 1st, 2000, because the RTC century byte is not set.

Solution

Support Level Supplement (SLS) OSS496A, the Real Time Clock Supplement for SCO OpenServer, contains fixes for the above mentioned problems on SCO OpenServer 5.0.0, 5.0.2, and 5.0.4.

See the attached cover letter that accompanies this SLS for more information, including contents and installation instructions.

Dear SCO Customer,

Support Level Supplement (SLS) OSS496A, the Real Time Clock Supplement, addresses two issues with accessing and updating the RTC under SCO OpenServer Release 5.0.0, 5.0.2, or 5.0.4:

- SCO OpenServer did not update the RTC century byte.  This behavior
  is correct, as SCO OpenServer does not use the century byte, and is
  unaffected by it.  However, many BIOSes and some other operating
  systems could behave oddly after January 1st, 2000, if the century
  byte is not updated.
After OSS496A has been installed, SCO OpenServer updates the century
byte whenever it writes to the RTC.  SCO OpenServer normally writes
the RTC only during startup.  To intentionally update the RTC, run
(as root):
/etc/setclk -r
Note that SCO OpenServer will only update the century byte if it
already contains a valid value.  This is because on some systems the
century byte is used for other purposes, and incorrect behavior could
result if it is modified.

- Applications may read the RTC directly via one of the following interfaces:

read(S) from /dev/rtc or /dev/clock ioctl(S), RTCRTIME on /dev/rtc or /dev/clock sysi86(S), function RTODC

These interfaces previously could return wrong information if they
were interrupted in the middle of reading the RTC.  This problem has
been corrected.

The standard UNIX time interfaces time(S), ftime(S) and gettimeofday(S) do not read the RTC and were not affected.

SLS OSS496A updates the file:
/etc/conf/pack.d/rtc/Driver.o

SLS OSS496A should only be installed on:

SCO OpenServer Enterprise System Release 5.0.0, 5.0.2, 5.0.4
SCO OpenServer Host System Release 5.0.0, 5.0.2, 5.0.4
SCO OpenServer Desktop  System Release 5.0.0, 5.0.2, 5.0.4
SLS OSS496A does not apply to OpenServer Release 5.0.5.  To correct
the same issues for that release, install Release Supplement 505A.
INSTALLATION AND REMOVAL INSTRUCTIONS

Please note that the procedure for applying this patch is slightly different on OpenServer 5.0.4 than on OpenServer 5.0.0 and 5.0.2.

A. INSTALLING AND REMOVING ON SCO OPENSERVER 5.0.0 or 5.0.2

Installing patches on SCO OpenServer 5.0.0 or 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
a 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.

Instructions for SCO OpenServer 5.0.4 can be found in section B below.

I. BEFORE LOADING THE PATCH (on 5.0.0 or 5.0.2)

Before installing SLS OSS496A on OpenServer Release 5.0.0, use the
Software Manager to verify that Release Supplement 5.0.0d is already
installed.  SLS OSS496A requires this Release Supplement on SCO
OpenServer 5.0.0.

Release Supplement 5.0.0d is not required (and cannot be used) on SCO OpenServer Release 5.0.2.

More information regarding installation of the Release Supplement may be found in the SCO OpenServer Release Notes.

II. LOADING THE PATCH (on 5.0.0 or 5.0.2)
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 oss496a.Z.  Uncompress this file with this command:
# uncompress oss496a.Z

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

# cp oss496a /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 that 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 (on 5.0.0 or 5.0.2)
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 "OSS496A: RTC Supplement (for 5.0.0, 5.0.2)" patch and then choose "Full" to continue.

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

7. You will see this message:
NOTE: Application or rollback of this patch requires a kernel
      relink.  If you are applying or rolling back several
      patches at this time, you may choose to defer the relink
      until the last patch application or rollback.
      Do you want to relink the kernel now? (y/n)

Enter "y" or "n" based on this message. Note that you will not be able to make use of the patch until you relink the kernel. Therefore, it is suggested that you answer "y" to this question.

8. If you chose "y", the kernel will be relinked.  In either case, you
   will then see:
Press <Enter> to continue
After pressing <Enter>, you will see the "Apply Patch Progress"
window, after which you will see a "Message" window stating "Apply
Patch Complete".  Choose "OK" and you will be returned to the
Software Manager's main menu.  Exit the Software Manager by
choosing "Exit" from the "Host" menu.

9. Log in as root on tty01, and shut down the system:

# shutdown -g0 -y

After shutting down and rebooting the machine, application of the patch is complete.

IV. NOTES ON NETWORK INSTALLATION (on 5.0.0 or 5.0.2)

To install the patch on other SCO OpenServer 5.0.0 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 (on 5.0.0 or 5.0.2)
IMPORTANT NOTE:  Patches must be rolled back in the reverse order in
which they were installed on a per-component basis.  Hence, if the
"OSS496A: RTC Supplement (for 5.0.0, 5.0.2)" patch is not the most
recent patch applied to the UNIX component of the product, you will
have to roll back all patches applied after the "Unix Patch OSS496A"
patch prior to rollback of the "OSS496A: RTC Supplement (for 5.0.0,
5.0.2)" 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 "SCO UNIX System V
   Operating System" and choose "Continue".
5. You will see the "Patch Selection" window.  Make sure that the
   "OSS496A: RTC Supplement (for 5.0.0, 5.0.2)" patch is selected,
   and choose "Continue".
6. You will see the "Confirm Selected Patches" window.  Choose
   "Rollback" to confirm removal of the "OSS496A: RTC Supplement (for
   5.0.0, 5.0.2)" patch.

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

8. You will see this message:
NOTE:  Application or rollback of this patch requires a kernel
       relink.  If you are applying or rolling back several
       patches at this time, you may choose to defer the relink
       until the last patch application or rollback.
       Do you want to relink the kernel now? (y/n)
Enter "y" or "n" based on this message.  Note that complete
rollback of this patch requires a relink of the kernel to be
complete.  Therefore, it is suggested that you answer "y" to this
questions, unless you are installing or removing other patches.
9. If you chose "y", the kernel will be relinked.  In either case, you
   will then see:
Press <Enter> to continue
After pressing the <Enter> key, you will see the "Rollback
Progress" window, after which a "Message" window stating "Rollback
Patch Complete".  Choose "OK" and you will be returned to the
Software Manager's main menu.  Exit the Software Manger by choosing
"Exit" from the "host" menu.

10. Log in as root on tty01, and shut down the system:

# shutdown -g0 -y

After shutting down and rebooting the machine, rollback of the patch is complete.

11. To also unload the patch, making it no longer available to be
    applied, follow steps 1 through 10 in this section.  However, in
    step 3, choose:
"Patch Management-->Unload Patch"
instead of:
"Patch Management-->Rollback Patch"
B. INSTALLING AND REMOVING ON SCO OPENSERVER 5.0.4
I. INSTALLING THE PATCH (on 5.0.4)
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 oss496a.Z.  Uncompress this file with this command:
# uncompress oss496a.Z

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

# cp oss496a /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 "Install New".

5. You will see the "Begin Installation" 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 "Install Selection" menu.  Choose "OSS496A: RTC
   Supplement (ver oss496a)".
8. You will see the "Install Patch Error" window.  It will indicate
   that only the supplement for SCO OpenServer 5.0.4 can be installed.
   Choose "Continue".

9. You will see the "Installation Progress" window as the system applies the patch.

10. You will see an "Information" window that states that the kernel
    was relinked.  Choose "OK" to continue.  Note that this patch will
    not be active until the system is rebooted.
11. If the installation was successful, you will see a "Message"
    window that states "Installation Complete".  Choose "OK" and you
    will be returned to the Software Manager main window.  Exit the
    Software Manager by choosing "Exit" from the "Host" menu.

12. Log in as root on tty01, and shut down the system:

# shutdown -g0 -y

After shutting down and rebooting the machine, application of the patch is complete.

II. PATCH REMOVAL (on 5.0.4)
1. Log in as root.
2. Execute the command:
# scoadmin software

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

3. Choose "OSS496A: RTC Supplement (ver oss496a)" from the list of installed software.

4. Choose "Remove Software" from the "Software" menu.

5. You will see the "Confirm Selected Software" window.  Choose
   "Remove" to confirm removal of the patch.

6. You will see the "Remove Software Progress" window, as the system performs the removal of the patch.

7. You will see an "Information" window that states that the kernel
   was relinked.  Choose "OK" to continue.  Note that this patch will
   not be removed until the system is rebooted.
8. If the removal was successful, you will see a "Message" window
   that states "Removal Complete".  Choose "OK" and you will be
   returned to the Software Manager main window.  Exit the Software
   manager by choosing "Exit" from the "Host" menu.

9. Log in as root on tty01, and shut down the system:

# shutdown -g0 -y

After shutting down and rebooting the machine, application of the patch is complete.

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

From the Xinuos technical article database, record 109991. Reproduced with permission. The original is at www.sco.com/ta/109991, 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.