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 /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 emu
2. Enter client  client
3. Enter emuweb  stop
4. Enter emuload  stop
5. Enter exit to close the command shell.
6. Logout.

Upgrading Texpress

1. Log in as emu
2. Enter cd  ~emu/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 ~emu/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  ~emu/texpress/8.1.xxx (expand the ~emu).
   The Texpress installation script will commence.
9. Enter cd  ~emu/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  ~emu/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 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 appropriate TexAPI version for your Unix machine 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 as emu.
2. Enter cd  ~emu/client
3. Enter mkdir  install
4. Enter cd  install
5. Obtain the appropriate EMu version via the KE EMu Server hyperlink above.
   Save the release in ~emu/client/install calling it emu.sh.
6. Enter sh  emu.sh. The EMu release will be extracted.
7. Enter .  ./.profile
8. Enter bin/emuinstall  client. The EMu installation script will commence.
9. Enter cd  ~emu/client
10. Enter cp  .profile.parent  ../.profile
11. Enter .  ../.profile
12. Enter client  client
13. Enter emubldlinks
14. Enter \rm  -fr  install
15. Enter exit to close the command shell.
16. Log out.
17. 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 Installing EMu Client notes.