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 /dev/fs/C/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 local user vw
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell.
3. A command window will appear.
4. Login as vw
5. Enter client client
6. Enter vwload  stop
7. Enter exit to close the command shell.
8. Log out.

Upgrading Texpress

1. Log in to the Windows machine as local user 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 Windows 2000/XP/2003 running Microsoft Services for 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 ln  -s  8.1.xxx  8.1
17. The previous Texpress version installed should be kept to allow quick rollback if a problem occurs, all older versions should be removed.
18. Stayed logged in as vw for the KE TexAPI installation.

Upgrading TexAPI

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 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.
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 to the Windows machine as local user 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  client. The Vitalware installation script will commence.
9. Enter cd  ~vw/client
10. Enter cp  .profile.parent  ../.profile
11. Enter .  ../.profile
12. Enter client client
13. Enter vwload  stop
14. Enter vwbldlinks
15. Enter \rm  -fr  install
16. Enter exit to close the command shell.
17. Log out.
18. Please consult version release notes for any specific upgrades required for the new version.

Starting Vitalware services

1. Log in to the Windows machine as local user vw
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell 
3. Enter vwload  start
4. Enter exit to close the comand shell.
5. Log out.

Upgrading Vitalware Client

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