Introduction

The upgrade from EMu Version 3.1 to 3.2.01 involves a number of steps. Please follow the instructions below carefully. You cannot skip any steps under any circumstances.
Before proceeding with the update please ensure that a complete backup of the KE EMu server exists and is restorable.

There are four main components that require upgrading:

• Texpress (the database engine)
• TexAPI (web services)
• EMu Server (the application)
• EMu Client (the client)

The notes below detail how to upgrade all systems. Check the Releases table for Client specific notes.  Upgrading comprises the following steps:

• Stopping EMu services
• Installing 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.5.
• Texpress 8.1.003 or later.
• TexAPI 3.1.009 or later.
• EMu Server 3.2.01
• EMu Client 3.2.01

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 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

Installing Texpress

Installing Texpress 8.1 is only required for the first client upgraded to EMu 3.2. Once Texpress 8.1 has been installed this section may be skipped for subsequent upgrades.

1. Enter mkdir  -p  texpress/8.1/install
2. Enter cd   texpress/8.1/install
3. Obtain the appropriate Texpress version for your Unix machine via the KE Texpress hyperlink above. Save the release in ~emu/texpress/8.1/install calling it texpress.sh.
4. Enter sh  texpress.sh
   The Texpress release will be extracted.
5. Enter .  ./.profile
6. Enter bin/texinstall  ~emu/texpress/8.1 (expand the ~emu)
   The Texpress installation script will commence.
7. Enter cd  ~emu/texpress/8.1
8. Enter .  ./.profile
9. Enter texbldperms
10. Enter bin/texlicinfo. Obtain your Texpress licence code and place it in a file called .licence.
11. Enter bin/texlicset  <  .licence to install the licence.
12. Enter \rm  -fr  install

Upgrading TexAPI

Installing TexAPI is only required for the first client upgraded to EMu 3.2. Once TexAPI has been installed this section may be skipped for subsequent upgrades.

1. Enter cd ~emu/texpress
2. 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.
3. Enter sh  texapi.sh  -i ~emu/texpress/texapi (expand the ~emu).
4. Enter rm  -f  texapi.sh

Upgrading EMu Server

1. Enter cd ~emu
2. 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
3. Enter cd  clientname/install
4. Obtain the appropriate KE EMu server version bundle via the KE EMu Server hyperlink above.
   Save the release bundle file in the ~emu/clientname/install temporary directory.
5. 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.
6. Enter .  ./.profile
7. Enter bin/emuinstall  clientname. The EMu installation script will commence.
8. Enter cd ~emu/clientname
9. Enter cp  .profile.parent  ../.profile
10. Enter .  ../.profile
11. Enter client clientname
12. Enter emuload stop
13. Enter emuweb stop
14. Enter emubldinstall
15. Enter emubldlinks
16. Removal of the the temporary directory (and its contents) is recommended:
    Enter \rm  -fr  install
17. Enter upgrade-3-2-01. The client will now be upgraded to EMu 3.2. If you are upgrading from a version prior to EMu 3.1.002 you must run the upgrade scripts for all version after the old version before running the EMu 3.2 upgrade. In particular be careful when upgrading to EMu 3.1 to make sure you run the correct upgrade sequence.

Starting EMu services

1. Enter emuload  start
2. Enter emuweb  start
3. Enter exit to close the command window.
4. Log out.

Upgrading KE EMu Client

When upgrading to EMu 3.2 the Windows client does not need to be upgraded on each individual machine unless the version of Crystal reports used by the client has changed. To upgrade the EMu Client follow the Installing EMu Client notes.