Introduction

The upgrade from EMu Version 3.1 to EMu 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 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 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 emu.
2. Enter client clientname
3. Enter emuweb  stop
4. 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 cd  ~emu
2. Enter mkdir  -p  texpress/8.1/install
3. Enter cd   texpress/8.1/install
4. 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.
5. Enter sh  texpress.sh
   The Texpress release will be extracted.
6. Enter .  ./.profile
7. Enter bin/texinstall  ~emu/texpress/8.1 (expand the ~emu)
   The Texpress installation script will commence.
8. Enter cd  ~emu/texpress/8.1
9. Enter .  ./.profile
10. Enter texbldperms
11. Enter bin/texlicinfo. Obtain your KE Texpress licence code and place it in a file called .licence.
12. Enter bin/texlicset  <  .licence to install the licence.
13. Enter \rm  -fr  install

If you are installing on Linux, Solaris or FreeBSD you may need to setup PAM support (you will definitely need to do this if you are installing on Red Hat Linux). For details see Setup PAM.

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 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 KE 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.02 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 shell.
4. Log out.

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