citadel/docs/upgrading.txt

   1
   2  UPGRADING AN EXISTING CITADEL/UX INSTALLATION
   3  ---------------------------------------------
   4
   5  The process by which you will upgrade an older version of Citadel/UX to the
   6 current one depends on which version you have installed.
   7
   8
   9
  10  Version 1.xx, 2.xx, or 3.xx
  11  ---------------------------
  12
  13  Upgrading from these versions is no longer supported.  Sorry.
  14
  15
  16
  17  Version 4.xx, 5.0x, or 5.1x
  18  ---------------------------
  19
  20  Obtain the "export5" utility from any FTP site which carries Citadel.  This
  21 package contains instructions on how to 'export' your old databases, and then
  22 'import' them into Citadel/UX 5.54.
  23
  24  NOTE: if you have any of these versions installed, you must first upgrade
  25 to Citadel/UX v5.54, and then upgrade from 5.54 to the latest version.  The
  26 file formats for 5.60 have changed drastically, and it is unfeasible to build
  27 a one-step migration path.
  28
  29
  30
  31  Version 5.5x or 5.6x
  32  --------------------
  33
  34  Upgrading from 5.[56]x to 5.60 is easy.  Unpack the source and run the
  35 configure script using "--with-prefix=/your/citadel/directory" just like you
  36 had done for the previous version.  After the compile is finished, shut down
  37 the running copy of citserver and do a "make install-exec".  This command
  38 installs the new programs without overwriting any of your data files, system
  39 banners, or anything else.
  40
  41
  42
  43
  44  ALL VERSIONS
  45  ------------
  46
  47  After you upgrade, you MUST run "setup" before starting citserver!  If you do
  48 not do so, the server will notice the older version stamp on your data files
  49 and refuse to run.  Run setup, then start citserver.
  50
  51