Introduction

Upgrading an installed Vitalware 2.0 to a later patch level is a straight forward procedure. There are four main components that can be upgraded:

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

The notes below detail how to upgrade all systems. If you only need to upgrade one system, just skip the notes detailing the other ones. Check the Releases table for Client specific notes.  Upgrading comprises the following steps:

• Stopping Vitalware services
• Upgrading 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 /home/vw.

Requirements

• Texpress 8.1.001, latest version
• TexAPI 3.1.010, latest version
• Vitalware Server 2.0, latest version
• Vitalware Client 2.0, latest version

Stopping Vitalware services

1. Log in as vw
2. Enter client  client
3. Enter vwload  stop
4. Enter exit to close the command shell.
5. Log out.

Upgrading Texpress

1. Log in as vw
2. Enter cd  ~vw/texpress
3. Enter mkdir  -p  8.1.xxx/install where xxx is the version of Texpress being installed.
4. Enter cd  8.1.xxx/install
5. Obtain the appropriate Texpress version for your Unix machine via the KE Texpress hyperlink above. Save the release in ~vw/texpress/8.1.xxx/install calling it texpress.sh.
6. Enter sh  texpress.sh. The Texpress release will be extracted.
7. Enter .  ./.profile
8. Enter bin/texinstall  ~vw/texpress/8.1.xxx (expand the ~vw).
   The Texpress installation script will commence.
9. Enter cd  ~vw/texpress/8.1.xxx
10. Enter .  ./.profile
11. Enter texbldperms
12. Enter bin/texlicinfo. Obtain your Texpress licence code and place it in a file called .licence.
13. Enter bin/texlicset  <  .licence to install the licence.
14. Enter \rm  -fr  install
15. Enter cd  ~vw/texpress
16. Enter \rm -f  8.1
17. Enter ln  -s  8.1.xxx  8.1
18. The previous Texpress version installed should be kept to allow quick rollback if a problem occurs, all older versions should be removed.
19. Stayed logged in as vw for the KE TexAPI installation.

Upgrading TexAPI

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

1. Assumes you are logged in as vw.
2. Enter cd  ~vw/texpress
3. Enter mkdir  3.1.xxx where xxx is the version of TexAPI being installed.
4. Obtain the appropriate TexAPI version for your Unix machine via the KE TexAPI hyperlink above.
   Save the release in ~vw/texpress calling it texapi.sh.
5. Enter sh  texapi.sh  -i  ~vw/texpress/3.1.xxx (expand the ~vw).
6. Enter \rm  -f  texapi
7. Enter ln  -s  3.1.xxx  texapi
8. Enter \rm  -f  texapi.sh
9. The previous TexAPI version installed should be kept to allow quick rollback if a problem occurs, all older versions should be removed.
10. Enter exit to close the command shell.
11. Log out.

Upgrading Vitalware Server

1. Log in as vw.
2. Enter cd  ~vw/client
3. Enter mkdir  install
4. Enter cd  install
5. Obtain the appropriate Vitalware version via the KE Vitalware Server hyperlink above.
   Save the release in ~vw/client/install calling it vw.sh.
6. Enter sh  vw.sh. The Vitalware release will be extracted.
7. Enter .  ./.profile
8. 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.
9. 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.
10. Enter sh /tmp/install.
11. Enter cd ~vw/client
12. Enter cp .profile.parent ../.profile
13. Enter . ../.profile
14. Enter client client
15. Enter vwload stop
16. Enter vwbldlinks
17. Enter \rm -fr install
18. Enter exit to close the command shell.
19. Log out.
20. Please consult version release notes for any specific upgrades required for the new version.   
21. Ensuring that the databases are functional after the upgrade is important. Check the install file to determine if any new "ins" form has been instaalled as part of the upgrade. If yes, check the CVS log of that insertion form to find  if any new fields have been added . If yes, you will need to ensure that either the upgrade script has re-indexed the database or you will need to re-index it manually.(Unless it's a friday night when you can leave the re-indexing to the weekly maintenance!)

Starting Vitalware services

1. Log in as vw.
2. Enter vwload  start
3. Enter exit to close the comand shell.
4. Log out.

Upgrading Vitalware Client

To upgrade the Vitalware Client follow the Installing Vitalware Client notes.