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 /dev/fs/C/home/emu.

Requirements

• Microsoft Windows Services for UNIX, version 3.0.
• Texpress 8.0.019 or later.
• TexAPI 3.1.004 or later.
• EMu Server 3.0 or later.
• EMu Client 3.0 or later.

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 window.
8. Log out.

Upgrading Texpress

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 cd ~emu/texpress/8.0
5. Enter mkdir  install
6. Enter cd install
7. Start your browser and click on the KE Texpress hyperlink above.
   A list of the most recent Texpress releases is displayed.
8. Right click on the Interix for Windows NT/2000/XP platform.
   Select Save Target As... (IE) or Save Link As... (Netscape).
   Browse to emu's home directory (usually c:\home\emu).
   Then navigate to the texpress\8.0\install directory.
   Save the file as texpress.sh
9. Switch back to the Korn Shell command window.
10. Enter sh  texpress.sh. The Texpress release will be extracted.
11. Enter .  ./.profile
12. Enter bin/texinstall ~emu/texpress/8.0 (expand the ~emu).
    The Texpress installation script will commence.
13. Enter cd ~emu/texpress/8.0
14. Enter .  ./.profile
15. Enter rm  -fr  install
16. 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. Start your browser and right click on the KE TexAPI hyperlink above.
   A list of the most recent TexAPI releases is displayed.
4. Right click on the Interix for Windows NT/2000/XP platform.
   Select Save Target As... (IE) or Save Link As... (Netscape).
   Browse to emu's home directory (usually c:\home\emu).
   Then navigate to the texpress directory.
   Save the file as texapi.sh
5. Switch back to the Korn Shell command window.
6. Enter sh  texapi.sh  -i ~emu/texpress/texapi (expand the ~emu).
7. Enter rm  -f  texapi.sh
8. Enter exit to close the command window.
9. Log out.

Upgrading EMu Server

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 cd  ~emu/client
5. Enter mkdir  install
6. Create a file called .nocrontab (if you don't want the crontab file overwritten)
7. Enter cd  install
8. Start your browser and right click on the KE EMu hyperlink above.
9. Browse the EMu Release Site. Right click on the hyperlink for the release you require.
10. Select Save Target As... (IE) or Save Link As... (Netscape).
    Browse to emu's home directory (usually c:\home\emu).
    Then navigate to the client\install directory. Save the file as emu.sh
11. Switch back to the Korn Shell command window.
12. Enter sh  emu.sh. The EMu release will be extracted.
13. Enter unset EMUGROUP
14. Enter .  ./.profile
15. Enter bin/emuinstall client. The EMu installation script will commence.
16. Enter cd ~emu/client
17. Enter cp  .profile.parent  ../.profile
18. Enter .  ../.profile
19. Enter client client
20. Enter emubldlinks
21. Enter emulutsrebuild -m
22. Enter \rm  -fr  install
23. Enter exit to close the command window.
24. Log out.
25. Please consult version release notes for any specific upgrades required for the new version.

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

Upgrading EMu Client

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