Introduction

Upgrading an installed EMu 3.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)
• 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 /home/emu.

Requirements

• Texpress 8.0.019, latest version.
• TexAPI 3.1.004, latest version.
• EMu Server 3.0, latest version
• EMu Client 3.0, latest version.

Stopping EMu services

1. Log in as emu.
2. Enter client client
3. Enter emuweb  stop
4. Enter emuload  stop
5. Enter exit to close the command shell.
6. Log out.

Upgrading Texpress

1. Log in as emu.
2. Enter cd ~emu/texpress/8.0
3. Enter mkdir  install
4. Enter cd  install
5. Obtain the appropriate Texpress version for your Unix machine via the KE Texpress hyperlink above. Save the release in ~emu/texpress/8.0/install calling it texpress.sh.
6. Enter sh  texpress.sh. The Texpress release will be extracted.
7. Enter .  ./.profile
8. Enter bin/texinstall ~emu/texpress/8.0 (expand the ~emu).
   The Texpress installation script will commence.
9. Enter cd ~emu/texpress/8.0
10. Enter .  ./.profile
11. Enter  \rm  -fr  install
12. 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. Obtain the appropriate TexAPI version for your Unix machine via the KE TexAPI hyperlink above.
   Save the release in ~emu/texpress calling it texapi.sh.
4. Enter sh  texapi.sh  -i ~emu/texpress/texapi (expand the ~emu).
5. Enter rm  -f  texapi.sh
6. Enter exit to close the command shell.
7. Log out.

Upgrading EMu Server

1. Log in as emu.
2. Enter cd ~emu/client
3. Enter mkdir  install
4. Create a file called .nocrontab (if you don't want the crontab file overwritten)
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 unset EMUGROUP
9. Enter .  ./.profile
10. Enter bin/emuinstall client. The EMu installation script will commence.
11. Enter cd ~emu/client
12. Enter cp  .profile.parent  ../.profile
13. Enter .  ../.profile
14. Enter client client
15. Enter emubldlinks
16. Enter emulutsrebuild -m
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.

Starting EMu services

1. Log in as emu.
2. Enter emuload  start
3. Enter emuweb  start
4. Enter exit to close the command shell.
5. Log out.

Upgrading EMu Client

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