Chapter 4. Upgrading
Prev Part II. Installing BELTS Next

Chapter 4. Upgrading

[Note]Note

Upgrading from Version 1.0 of BELTS requires an intermediate upgrade to Version 1.0.1 if you wish to preserve any data stored in your original setup. Please refer to the BELTS Development Site for instructions on obtaining and installing the 1.0.1 release of BELTS.

Before upgrading BELTS under Windows, please ensure that you uninstall the service first, as described in Section 5.15.1, “Running as a Windows service”.

Procedure 4.1. Upgrade from Version 1.0.1 of BELTS

  1. On the Version 1.0.1 installation, log in as the “bootstrap” user and export your system data, as outlined in Exporting Data .

  2. Back up your Version 1.0.1 installation. This includes any data files in /var/lib/belts.

  3. Install Version 1.2 of BELTS, as outlined in Installation .

  4. Start your Version 1.2 installation as outlined in Start the BELTS server and wait for the server to do a complete update from the Exchange.

    You can tell when a complete Exchange update has been performed by watching the file BELTS_HOME/server/default/log/wrapper.log for a line that looks like 

    INFO   | jvm 2    | 2003/08/28 15:07:07 | 15:07:07,187 INFO
  [ScheduledUpdate] Update on provider exchange finished

  5. Stop your Version 1.2 server as outlined in Running as a service .

  6. In BELTS_HOME/bin, run the “upgrade” program, with the following parameters:

    • the name of your Exchange provider (“exchange”)

    • the location of the exported XML file from above

    • the location of your Version 1.0.1 BELTS data directory (/var/lib/belts)

    • the location of an output directory for the upgraded data (not your Version 1.2 BELTS data directory)

    Linux:

    $ ./upgrade.sh exchange /tmp/belts-1.0-export.xml /var/lib/belts
 /tmp/belts-1.2

    Windows:

    C:\belts-1.2.0\bin> upgrade exchange \tmp\belts-1.0-export.xml
 \var\lib\belts %TEMP%\belts-1.2

    This process could take up to 10 minutes depending on the amount of data in your Version 1.0.1 installation.

  7. Copy your newly-generated data directory over the Version 1.2 data directory

    Linux:

    $ cp -R /tmp/belts-1.2/* $BELTS_HOME/server/default/data/belts

    Windows:

    C:\belts-1.2.0\bin>xcopy %TEMP%\belts-1.2 ..\server\default\data\belts /s /e

    When asked whether to overwrite files, select “All”.

  8. Restart your Version 1.2 installation.

  9. Using the file generated during the upgrade process, import your system data, as outlined in Importing Data . The file name to import will be import-1.2.xml and it will be in BELTS_HOME/server/default/data/belts.

  10. Login as a Content Manager and perform the Regenerate XML Cache function. This will ensure that the content cache is up-to-date.

Procedure 4.2. Upgrade from an earlier (not Version 1.0.1) installation of BELTS

  1. Back up your earlier installation. In particular, you will need to have a copy of any data files in BELTS_HOME/server/default/data/belts/contentdir.

  2. Install the latest version of BELTS, as outlined in Installation .

  3. Copy your old data back into BELTS_HOME/server/default/data/belts.

    Linux:

    $ cp -R /tmp/belts/* $BELTS_HOME/server/default/data/belts

    Windows:

    C:\belts-1.2.0\bin>xcopy %TEMP%\belts ..\server\default\data\belts /s /e

  4. Start your new installation as outlined in Start the BELTS server .

  5. Login as a Content Manager and perform the Regenerate XML Cache function. This will ensure that the content cache is up-to-date.

Prev Up Next
Chapter 3. Before Installing Home Chapter 5. Installation