Introduction

The upgrade from EMu Version 2.1 to EMu 3.0.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 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 /home/emu.

Requirements

• Texpress 8.0.019 or later.
• TexAPI 3.1.004 or later.
• EMu Server 3.0.01
• EMu Client 3.0.01

Stopping EMu services

1. Log in as emu.
2. Enter client client
3. Enter emuweb  stop
4. Enter emuload  stop

Installing Texpress

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

1. Enter cd  ~emu
2. Enter mkdir  -p  texpress/8.0/install
3. Enter cd   texpress/8.0/install
4. Obtain the appropriate Texpress version for your Unix machine via the KE Texpress hyperlink above. Save the release in ~emu/texpress/8.0/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.0 (expand the ~emu)
   The Texpress installation script will commence.
8. Enter cd  ~emu/texpress/8.0
9. Enter .  ./.profile
10. Enter texbldperms
11. Enter vi  etc/opts
12. Review the options in the file and change as appropriate. In particular the dateorder and dateformat should be modified to reflect local settings. Save the file after making changes.
13. Enter bin/texlicinfo. Obtain your 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

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.0. 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/client
2. Enter mkdir  install
3. Create a file called .nocrontab (if you don't want the crontab file overwritten)
4. Enter cd  install
5. Obtain the appropriate EMu version via the KE EMu Server hyperlink above.
   Save the release in ~emu/client/install calling it emu.sh.
6. Enter sh  emu.sh. The EMu release will be extracted.
7. Enter unset EMUGROUP
8. Enter .  ./.profile
9. Enter bin/emuinstall  -u  client. The EMu installation script will commence.
10. Enter cd ~emu/client
11. Enter cp  .profile.parent  ../.profile
12. Enter .  ../.profile
13. Enter client client
14. Enter emureindex  -c  -p
15. Enter emuload stop
16. Enter emuweb stop
17. Enter emubldinstall
18. Enter emubldlinks
19. Enter emulutsrebuild  -m
20. Enter \rm  -fr  install
21. Enter upgrade-3-0-01. The client will now be upgraded to EMu 3.0. If you are upgrading from a version prior to Mu 2.1.008 you must run the upgrade scripts for all version after the old version before running the EMu 3.0 upgrade.

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.0 the Windows client must be installed on all client machines, including machines that had the EMu 3.0 beta releases installed. To upgrade the EMu Client follow the Install EMu Client notes.