Introduction

Upgrading an installed EMu 3.2 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 clientname 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.003, latest version.
• TexAPI 3.1.009, latest version.
• EMu Server 3.2, latest version
• EMu Client 3.2, latest version.

If upgrading to EMu 3.2.04 or later the following is also required:

• Perl version 5.8 or greater

Stopping EMu services

1. Log in as emu
2. Enter client  clientname
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
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
3. The install bundle must be unarchived into a new temporay directory.
   It is recommended to use a new temporary directory named ~emu/clientname/install.
   Enter mkdir  clientname/install
4. Enter cd  clientname/install
5. Obtain the appropriate EMu server version bundle via the KE EMu Server hyperlink above.
   Save the release bundle file in the ~emu/clientname/install temporary directory.
6. Extract the client release by using the name of the actual release file.
   Enter sh  emu-clientname-yymmddv.sh
   The EMu release will be extracted.
7. Enter .  ./.profile
8. Enter bin/emuinstall  clientname. The EMu installation script will commence.
9. Enter cd  ~emu/clientname
10. Enter cp  .profile.parent  ../.profile
11. Enter .  ../.profile
12. Enter client  clientname
13. Enter emubldlinks
14. Removal of the the temporary directory (and its contents) is recommended:
    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.
    Note: If you are upgrading a client that is already using the latest version, you will still need to run the upgrade script for the next version.
    For example, if you are upgrading an existing EMu version 3.2.04 to a later 3.2.04, you will need to run upgrade-3-2-05.

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.