Daylight Saving Time Adjustment Tool for NetWare Servers

  • 3397648
  • 11-Apr-2007
  • 27-Apr-2012

Environment

Novell NetWare 4.x
Novell NetWare 5.x
Novell NetWare 6.x
Novell Open Enterprise Server (NetWare based)

Situation

The 2007 change to Daylight Saving Time start and end dates in the US and Canada will require an adjustment to every NetWare server that is currently using the "old" start/end settings.

(See note below about iChain and NBO servers)

Resolution

The Daylight Saving Time Adjustment Tool for NetWare Servers - DSTSHIFT.NLM is available for customer use. This tool is a standard NLM and can be used on any server running NetWare 4.x, 5.x, or 6.x, including OES/NetWare 6.5. The DSTSHIFT utility makes all necessary changes on standard NetWare servers, takes effect immediately and does not require a server re-boot. This tool can be used to configure NetWare file servers in both United States and Canada. The tool is available from:
https://download.novell.com/Download?buildid=carEGqApMKo~

Exception:NetWare Servers located in the Newfoundland time zone will require manual adjustments to be ready for the changes in Daylight Saving Time. See the section below on Newfoundland NetWare Servers and DST for full details.

The module DSTSHIFT.NLM uses a config file (DSTCFG.TXT) to make the necessary changes on the NetWare server. The configuration file contains the exact text of the two SET parameters needed to adjust the Start and End dates for Daylight Saving Time to the new values, replacing the lines near the top of the server's AUTOEXEC.NCF. The values in the config file delivered with this tool are correct for the current planned adjustment, which specifies that DST will start on the second Sunday in March (MARCH SUNDAY SECOND) and end on the first Sunday in November (NOVEMBER SUNDAY FIRST) at 02:00 AM, affecting most times zones covering the US and Canada.

The settings should be changed BEFORE MARCH 11, 2007 when the new DST Start date for the affected time zones comes int effect.

If you need to make adjustments to the DSTCFG.TXT file, be aware that the syntax for these SET parameters must closely match the format of the default values provided, including the open and close parentheses.

If the server's time zone does not require adjustments for Daylight Saving Time (that is, if there are no Start and End dates for DST currently in the server's AUTOEXEC.NCF, or if the server's Time Zone setting is not one of the ones that require the 2007 adjustment), there is no need to use the DSTSHIFT tool. (Most of Arizona, for example, does not observe DST, so no adjustment is required for the 2007 change.) The utility will only make changes to servers whose time zone string exactly matches the list of time zones affected by this US-based change (listed below)*. If no matching values are found in the server's current autoexec, or the Time Zone string does not match, no changes will be made by the DSTSHIFT utility.

Note:This utility does NOT apply to Novell Access Manager (iChain) or Novell/Enterprise Branch Office (NBO/BOMA) servers.

Check your server's autoexec.ncf for references to files called DSSTART.NCF and DSEND.NCF. If none are present, the DSTSHIFT utility should work correctly on that server. NBO and iChain servers store and use DST settings in different locations, and will require additional steps or an alternate method to adjust the start and end dates to the new values. The DSTSHIFT utility alone will not make all the necessary changes for NBO or iChain NetWare servers.


Newfoundland NetWare Servers and DST:
The changes required for NetWare servers in Newfoundland comes from a default NetWare has used for going back some years. The current abbreveation is NST while NetWare defaults to CNT. If servers in Newfoundland have been changed to match the current abbreveation the format will be NST3:30NDT and the DSTSHIFT.NLM is looking for CNT3:30NDT. As a result when the tool finds anything other than CNT it exits without making any changes. If the servers are configured with the default of CNT3:30NDT then the default changes will be applied.

Unfortunately the tool does not account for the difference that Newfoundland has implemented. According to the legislative change enacted in Newfoundland (found at http://www.hoa.gov.nl.ca/hoa/bills/Bill0634.htm) the time change in Newfoundland will occur at 00:01 instead of 02:00. This requires manually changing the setting if the DSTSHIFT.NLM has or has not run.

There are two options to address the changes for servers located in the Newfoundland Time Zone:

Option 1:Manually make all changes on the NetWare / Open Enterprise Server at the console

1. At the server console set these 4 parameters:
SET Time Zone = NST3:30NDT
SET Daylight Savings Time Offset = 1:00:00
SET Start of Daylight Savings Time = (MARCH SUNDAY SECOND 0:01:00 AM)
SET End of Daylight Savings Time = (NOVEMBER SUNDAY FIRST 0:01:00 AM)

These changes take place immediately, and the new dates and values can be verified at the server console by typing TIME and checking the calculated dates for DST start and DST end. They should match these:

Time zone string: "NST3:30NDT"
DST Status: OFF {This value will be ON during DST}
DST Start: Sunday, March 11, 2007 0:01:00 am NST
DST End: Sunday, November 4, 2007 0:01:00 am NDT

2. Make the exact same changes to the server's autoexec.ncf so that if the server is re-booted the new values will remain in place.
Option 2:Modify settings and use the DSTSHIFT.NLM at the server console
1. Issue this command at the server console:
SET TIME ZONE CNT3:30NDT
2. Edit the file DSTCFG.TXT and replace both instances of 02:00:00 AM with 00:01:00 AM in the text of the SET parameter.
3. Run DSTSHIFT, with the edited DSTCFG.TXT in place, which will make the changes to the DST Start and DST End rules, and make the edits in the Autoexec.ncf.
4. (Optional) Issue this command at the server console, to reset to the current Time Zone abbreviations:
SET TIME ZONE NST3:30NDT
You can type "time" at the server console to verify everything is correct.


Status

Top Issue

Additional Information

To address DST changes with Java on NetWare see TID3980430

How the DSTSHIFT Utility works:

When DSTSHIFT.NLM is loaded, it will look for the file DSTCFG.TXT in the same directory the NLM was loaded from. If no config file is found, the NLM will not load. The server's Time Zone string is compared to the list of time zones affected by the US-based change. If the Time Zone string is not an exact match, a message is added to the log file and no changes are made to the server's settings.

Otherwise, the config file is read and the parameters "SET Start Of Daylight Savings Time" and "SET End Of Daylight Savings Time" are identified, and the server's AUTOEXEC.NCF is examined to make sure the parameters exist there as well. The "old" SET parameter lines are commented out, in the AUTOEXEC.NCF, with an additional line identifying DSTSHIFT as the source of the change, and the new values from DSTCFG.TXT are placed in the file. (If the alternate files DSSTART.NCF and DSEND.NCF are referenced from the autoexec, the changes will be made and comment text added to those files instead.)

Next, the SET parameters from DSTCFG.TXT are set on the server so that the change takes place immediately, and the new values are written to the NetWare Registry.

All of these steps are logged in the file DSTLOG.TXT, which will show up in the same directory (containing DSTSHIFT.NLM and DSTCFG.TXT). If failures occur, that information will be in the log file.

To specify a different location for the CFG and LOG files, you can load the utility DSTSHIFT with an additional path specified on the command line, like this:

LOAD DSTSHIFT SYS:\TEMP

The NLM unloads itself when the changes are complete. If the changes are not completed, the NLM load will fail and error information will be written to DSTLOG.TXT (in the same directory as DSTCFG.TXT).

*Time Zones (and NetWare Time Zone string values) affected by the DST Start/End date change:

US Alaska Time (AKST9AKDT)

US & Canada Pacific Time (PST8PDT)

US & Canada Mountain Time (MST7MDT)

US & Canada Central Time (CST6CDT)

US & Canada Eastern Time (EST5EDT)

Atlantic Time (Canada) (AST4ADT) (includes Bermuda)

Newfoundland Time (CNT3:30NDT)

Note:Type TIME at the NetWare server console to view current values for DST Start and End dates, and the Time Zone string.