CLX Version 5.02 released March 12, 2000

Version 5.02 is a patch to version 5.00 or 5.01 released in
December 1999.

The new version comes with a few minor enhancements and a new
propagation data command: WCY and SHOW/WCY - thus allowing to record
data transmitted by propagation beacon DK0WCY on 10,144 kHz and
other frequencies.


*** INSTALLING FROM SCRATCH ***

If you are a new user and install CLX for the first time, get the
clx_500.tgz file and install CLX as per instructions in the manual.
Then come back here.

The same is true for installations still running version 4.06 of CLX.
You must backup your data, install 5.00 from scratch, reload your
data and then come back here.

By the way, remember to run VACUUM after you have reloaded the backup
data (if any).


*** UPGRADING FROM A PREVIOUS VERSION ***

If you have had CLX 5.00 or 5.01 running, here is your way to upgrade
without losing any data:

1. Put the upd_502.tgz archive into the /tmp directory.

2. As user clx_us shut down your current CLX software but leave
  the postmaster running:

      $ clx -s

3. In CLX 5.00 there existed a hard link from clx_par.sample
  to clx_par and cluster_par.sample to cluster.par. As clx_us
  remove the *.sample files, otherwise the unpacking will
  overwrite your current config files:

      $ rm ~/config/clx_par.sample ~/config/cluster_par.sample

4. As root, unpack the software patch from the archive file and run
  ldconfig:

      # cd /
      # tar xvzf /tmp/upd_502.tgz
      # ldconfig

5. There is a new database table which needs to be created before you
  start CLX 5.02 for the first time. Here are the commands that need to
  be executed as clx_us:

      $ psql clx_db < ~/db/wcy_data.cl
      $ psql clx_db < ~/db/wcy_data.idx

6. There was a problem in the ml_file table where the type for f_cntr
  was originally set as int2. However, over the years its limits have
  become too small and a problem emerged at various places (PA4AB, DB0MDX)
  where CLX would not accept new mail messages any more. To find out if
  you have this problem use the following command (user clx_us):

      $ psql clx_db -c '\d ml_file' | grep f_cntr

  If the result shows int2 in the second column, you need to apply the
  following procedure. If you see int4, you are already done and you
  can proceed with the next item.

      $ bup_db -s ml_file
      $ psql clx_db -c "drop table ml_file"
      $ psql clx_db < ~/db/ml_file.cl
      $ psql clx_db < ~/db/ml_file.idx
      $ bup_db -r ml_file

  Now do a final test:

      $ psql clx_db -c '\d ml_file' | grep f_cntr

  You should now see int4 in the second column.

7. As user clx_us delete outdated files and directories (contest
  data has moved to another directory):

      $ rm -rf ~/exec/command/contest ~/exec/command/contest_data
      $ rm ~/lib/libclxccl.so.5.1.0
      $ rm ~/tools/cleanup_wwv

8. If all went well, startup the new CLX 5.02.

      $ clx -u



*** CHANGES ***

- Fixed db/ml_file.cl, changed int2 to int4.

- Fixed minor bugs in rm_fwd, log_monitor and db_maint scripts.

- Fixed minor problem, where the first user in the user list was hidden
 after a login of the RMNC node. {440 - DK4VW}

- Reworked clx_idx to drop and create index files now also on udt
 tables.

- Sysop command SHOW/CSTAT to show connect statistics of users and link
 partners. {388 - PP5AQ, 389 - G0VGS}

- New command WCY, SHOW/WCY etc. - analogous to the WWV command family.
 Also there is wcy_lim for the config file, in analogy to the wwv_lim
 configuration command.

- Connection to the database is now being re-established if possible.
 This should finally avoid the casual "database not online" messages
 after exotic DX or announce spots.

- SEND/COPY user@node is now working. {339 - DL3KDV}

- Update of the adv_txt file no longer goes unnoticed by CLX.
 {365 - DL6RAI}

- New config command shm_dxel allows setting the depth of the
 duplicate check buffer for DX spots. The maximum value for
 this is now 99999 spots, the default value is 500.
 {367 - PE2AB}

- Increased output buffer size for announcements - this problem lead to
 crashes when very long announce messages were received.

- increased number of WAZ zones in waz_ddd parameter to 40.
 {375 - OE3DZW}

- Talk mode initiating messages now comes in the correct language -
 the used to be presented in the language that the station which
 initiated the talk mode had set, not in the language that was
 set by the station which was talked to.
 {379 - DG3KCE}

- When reading in QRX-callbook type data files, a warning messages
 shows up in the log file when the format looks wrong.

- When searching for duplicate announcement spots, only the first
 70 characters are being used. {434 - DK4VW}

- When users have Login/Logout messages enabled, connects for nodes
 in outgoing links are now reported too. Before, only disconnects used to
 be reported. {373 - EA7WA}

- New sysop command RINST/<node> which generates a PC34 message. This
 was specially requested to enable setting the time on other
 DOS-based cluster nodes. RINST is different from RCMD in that commands
 can be used which are not allowed for normal users. A possible answer
 from the remote system is ignored. {364 - EA7WA}

- SET/NODXDEDX settings now work with plain SHOW/DX and SHOW/DX/<n>
 commands. {435 - DK4VW}.

- Callbook query is now available as a remote DB request {423 - W7IUV}.

- "! clx_adm" commands used to screw up the prompt - fixed.
 {349 - DL6RAI}

- "async-timeout" messages in default log files removed. They only go
 to the debug log file (if enabled).

- WWV announcements are now being saved and broadcasted only once per
 date/hour window. This is meant to avoid duplicate spots from different
 loggers showing up 3-4 times in SHOW/WWV output. By default, only the
 first message for a time frame is caught. Using the "wwv_auth"
 configuration parameter, you can specify a preferred logger call.

- The environment variable PGDATESTYLE is now set to "Postgres" inside
 CLX to avoid problems with language-dependent date formats. It's
 interesting that this very bug showed up in the US as these should
 be the last to use language adaptions. {N8UR}

- SHOW/DX <date> command redesigned. A problem came up when invalid
 dates were found in the dx_data table. {DK4VW}

- The initializing PC19 message now carries all nodes that are
 "reachable" from this node. The message used to send out only
 nodes that were directly linked to this system. {N8UR and many others}

- Interpretation of PC10 messages (remote talk) now improved. There
 exist several different versions of this PC10 command. {SM7GVF}

- A new config parameter "language" to allow setting your default
 language. The effect is that the links ~/config/adv_txt.default
 and ~/box/info/help.default are created pointing to your default
 language if they do not already exist. {450 - DK4VW}

- New filesend program to automatically generate mail messages from
 the shell command prompt. New d2asc program convert Postgres dumped
 DX table to nicely formatted ASCII.

Ben, DL6RAI