Introduction

The upgrade from Vitalware Version 2.0 to 2.1.01 involves a number of steps. Please follow the instructions below carefully. You cannot skip any steps under any circumstances.
Before proceeding with the update please ensure that a complete backup of the KE Vitalware server exists and is restorable.

There are four main components that require upgrading:

• Texpress (the database engine)
• TexAPI (web services)
• Vitalware Server (the application)
• Vitalware Client (the client)

The notes below detail how to upgrade all systems. Check the Releases table for Client specific notes.  Upgrading comprises the following steps:

• Stopping Vitalware services
• Installing Texpress
• Upgrading TexAPI
• Upgrading Vitalware Server
• Starting Vitalware services
• Upgrading Vitalware Client

In the notes below client refers to the name of the client directory for the current installation. The term ~vw is used to refer to the user vw's home directory. This is normally /dev/fs/C/home/vw.

Requirements

• Texpress 8.2.006 or later
• TexAPI 3.1.017 or later
• Vitalware Server 2.1.01
• Vitalware Client 2.1.01

Stopping Vitalware services

1. Log in as local user vw.
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell.
   A command window will appear.
3. Log in as vw
4. Enter client client
5. Enter vwload  stop

Installing Texpress

Installing Texpress 8.2 is only required for the first client upgraded to Vitalware 2.1. Once Texpress 8.2 has been installed this section may be skipped for subsequent upgrades.

1. Enter cd ~vw/texpress
2. Enter mkdir  -p  texpress/8.2.xxx/install where xxx is the version of Texpress being installed.
3. Enter cd   8.2.xxx/install
4. Obtain the appropriate Texpress version for your Unix machine via the KE Texpress hyperlink above. Save the release in ~vw/texpress/8.2.xxx/install calling it texpress.sh.
5. Enter sh  texpress.sh
   The Texpress release will be extracted.
6. Enter .  ./.profile
7. Enter bin/texinstall  ~vw/texpress/8.2.xxx (expand the ~vw)
   The Texpress installation script will commence.
8. Enter cd  ~vw/texpress/8.2.xxx
9. Enter .  ./.profile
10. Enter texbldperms
11. Enter bin/texlicinfo. Obtain your Texpress licence code and place it in a file called .licence.
12. Enter bin/texlicset  <  .licence to install the licence.
13. Enter \rm  -fr  install
14. Enter cd ~vw/texpress
15. Enter In -s 8.2.xxx 8.2

Upgrading TexAPI

Installing TexAPI is only required for the first client upgraded to Vitalware 2.1. Once TexAPI has been installed this section may be skipped for subsequent upgrades.

1. Enter cd ~vw/texpress
2. Enter mkdir  3.1.xxx where xxx is the version of TexAPI being installed.
3. Obtain the appropriate TexAPI version for your Windows 2000/XP/2003 running Microsoft Services for Unix  machine via the KE TexAPI hyperlink above.
   Save the release in ~vw/texpress calling it texapi.sh.
4. Enter sh  texapi.sh  -i ~vw/texpress/3.1.xxx (expand the ~vw).
5. Enter \rm  -f  texapi
6. Enter ln  -s  3.1.xxx  texapi
7. Enter rm  -f  texapi.sh

Upgrading Vitalware Server

1. Enter cd ~vw/client
2. Enter mkdir  install
3. Enter cd  install
4. Obtain the appropriate Vitalware version via the KE Vitalware Server hyperlink above.
   Save the release in ~vw/client/install calling it vw.sh.
5. Enter sh  vw.sh. The Vitalware release will be extracted.
6. Enter .  ./.profile
7. Enter bin/vwinstall -n client>/tmp/install. This runs a fake install and the /tmp/install file now contains a list of all files that will get installed if an actual install is done.
8. Enter vi /tmp/install. Check for the files which do not need to be installed  and delete them from the file. Save the modified file.
9. Enter sh /tmp/install.
10. Enter cd ~vw/client
11. Enter cp  .profile.parent  ../.profile
12. Enter .  ../.profile
13. Enter client client
14. Enter vwload stop
15. Enter vwbldlinks
16. Enter \rm  -fr  install

Now that the client is installed the upgrade process can take place. The steps below may take some time to complete on large data sets.

1. The client will now be upgraded to Vitalware 2.1. If you are upgrading from a version prior to Vitalware 2.0.03  you must run the upgrade scripts sequentially for all versions after the old version before running the Vitalware 2.1 upgrade.
2. Enter upgrade-2-1-01
3. Enter upgrade-2-1-01.audit (may take some time)

Starting Vitalware services

1. Enter vwload  start
2. Enter exit to close the command window.
3. Log out.

Upgrading Vitalware Client

When upgrading to Vitalware 2.1 the Windows client must be installed on all client machines.  To upgrade the Vitalware Client follow the Installing Vitalware Client notes.