Introduction

Upgrading an installed EMu 3.1 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)
• EMu Server (the application)
• EMu 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 EMu services
• Upgrading Texpress
• Upgrading TexAPI
• Upgrading EMu Server
• Starting EMu services
• Upgrading EMu Client

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

Requirements

• Texpress 8.1.001, latest version.
• TexAPI 3.1.010, latest version.
• EMu Server 3.1, latest version
• EMu Client 3.1, latest version.

Stopping EMu services

1. Log in as local user emu.
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell.
3. A command window will appear.
4. Enter client  client
5. Enter emuweb  stop
6. Enter emuload  stop
7. Enter exit to close the command shell.
8. Log out.

Upgrading Texpress

1. Log in to the Windows machine as local user emu.
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell
3. Enter cd  ~emu/texpress
4. Enter mkdir  -p  8.1.xxx/install where xxx is the version of Texpress being installed.
5. Enter cd  8.1.xxx/install
6. Obtain the latest Texpress release for Windows 2000/XP/2003 running Microsoft Services for Unix via the KE Texpress hyperlink above. Save the release in ~emu/texpress/8.1.xxx/install calling it texpress.sh.
7. Enter sh  texpress.sh. The Texpress release will be extracted.
8. Enter .  ./.profile
9. Enter bin/texinstall  ~emu/texpress/8.1.xxx (expand the ~emu).
   The KE Texpress installation script will commence.
10. Enter cd  ~emu/texpress/8.1.xxx
11. Enter .  ./.profile
12. Enter  \rm  -fr  install
13. Enter cd  ~emu/texpress
14. Enter \rm  -f  8.1
15. Enter ln  -s  8.1.xxx  8.1
16. The previous Texpress version installed should be kept to allow quick rollback if a problem occurs, all older versions should be removed.
17. Stayed logged in as emu for the KE TexAPI installation.

Upgrading TexAPI

1. Assumes you are logged in as emu.
2. Enter cd  ~emu/texpress
3. Enter mkdir 3.1.xxx where xxx is the version of TexAPI being installed.
4. Obtain the latest TexAPI release for Windows 2000/XP/2003 running Microsoft Services for Unix  via the KE TexAPI hyperlink above.
   Save the release in ~emu/texpress calling it texapi.sh.
5. Enter sh  texapi.sh  -i  ~emu/texpress/3.1.xxx (expand the ~emu).
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 EMu Server

1. Log in to the Windows machine as local user emu
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell
3. Enter cd  ~emu/client
4. Enter mkdir  install
5. Enter cd  install
6. Obtain the appropriate EMu version via the KE EMu Server hyperlink above.
   Save the release in ~emu/client/install calling it emu.sh.
7. Enter sh  emu.sh. The EMu release will be extracted.
8. Enter .  ./.profile
9. Enter bin/emuinstall  client. The EMu installation script will commence.
10. Enter cd  ~emu/client
11. Enter cp  .profile.parent  ../.profile
12. Enter .  ../.profile
13. Enter client  client
14. Enter emubldlinks
15. Enter emulutsrebuild
16. Enter \rm  -fr  install
17. Enter exit to close the command shell.
18. Log out.
19. Please consult version release notes for any specific upgrades required for the new version.

Starting EMu services

1. Login to the Windows machine as local user emu
2. Start a Korn Shell with Start>Programs>Windows Services for UNIX>Korn Shell
3. Enter emuload  start
4. Enter emuweb  start
5. Enter exit to close the command shell.
6. Logout.

Upgrading EMu Client

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