Introduction

Upgrading an installed EMu 4.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 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 /dev/fs/C/home/emu.

Requirements

• Texpress 8.3, latest version
• TexAPI 6.0, latest version
• EMu Server 4.0, latest version
• EMu Client 4.0, latest version
• Perl version 5.8 or greater

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  clientname
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.3.xxx/install where xxx is the version of KE Texpress being installed.
5. Enter cd  8.3.xxx/install
6. Obtain the latest KE 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.3.xxx/install calling it texpress.sh.
7. Enter sh  texpress.sh. The KE Texpress release will be extracted.
8. Enter .  ./.profile
9. Enter bin/texinstall  ~emu/texpress/8.3.xxx (expand the ~emu).
   The KE Texpress installation script will commence.
10. Enter cd  ~emu/texpress/8.3.xxx
11. Enter .  ./.profile
12. Enter texbldperms
13. Enter bin/texlicinfo. Obtain your KE Texpress licence code and place it in a file called .licence.
14. Enter bin/texlicset  <  .licence to install the licence.
15. Enter  \rm  -fr  install
16. Enter cd  ~emu/texpress
17. Enter \rm  -f  8.3
18. Enter ln  -s  8.3.xxx 8.3
19. The previous Texpress version installed should be kept to allow quick rollback if a problem occurs, all older versions should be removed.
20. Stay 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 6.0.xxx where xxx is the version of TexAPI being installed.
4. Obtain the latest K 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/6.0.xxx (expand the ~emu).
6. Enter \rm  -f  texapi
7. Enter ln  -s  6.0.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
4. 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
5. Enter cd  clientname/install
6. 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.
7. 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.
8. Enter .  ./.profile
9. Enter bin/emuinstall  clientname. The EMu installation script will commence.
10. Enter cd  ~emu/clientname
11. Enter cp  .profile.parent  ../.profile
12. Enter  .  ../.profile
13. Enter client  clientname
14. Enter emubldlinks
15. Enter emulutsrebuild
16. Removal of the the temporary directory (and its contents) is recommended:
    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.
    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 4.0.01 to a later 4.0.01, you will need to run upgrade-4-0-02.

Starting EMu services

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 emuload  start
4. Enter emuweb  start
5. Enter exit to close the command shell.
6. Log out.

Upgrading EMu Client

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