Upgrade EMu 6.1 to 6.2

Axiell staff:

  • Be sure to complete the System Upgrade Checklist when upgrading a client installation.
  • For each client being upgraded, be sure to check the Releases table for any additional notes specific to that client.

Confirm that the following system requirements for EMu 6.2 are met:

Before proceeding with the update, ensure that a complete backup of the EMu server exists and is restorable.

Follow the instructions below carefully. Do not skip any steps under any circumstances.

Four components require upgrading:

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

Note: In the following steps, the term ~emu refers to user emu's home directory, typically /home/emu.
clientname refers to the name of the client directory for the current installation.

  1. Log in as emu.
  2. Enter client clientname
  3. Enter ls -l loads/*/data* local/loads/*/data*
  4. Check that each data file is empty and that no data.t files exist.

    Note: If data.t files do exist, wait for the loads to drain before proceeding.

  5. Enter emuload stop
  6. Enter emuweb stop
  7. Enter texlicstatus

    Make sure no one is using the system: the upgrade will not complete successfully if users are accessing data.

Each step in the upgrade process produces detailed output. In most cases this output will exceed the size of the screen. It is strongly recommended that the output of the upgrade session is recorded, so if errors occur, the output can be examined.

  1. Enter script /tmp/output-6-2

A new shell will start and all output recorded until the shell is terminated.

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

Note: In the following steps, xxx is the version of Texpress being installed (typically the current version). If installing Texpress version 9.0.001 for instance, you'd replace xxx with 001 in the following command: mkdir -p texpress/9.0.xxx/install. You can check which is the latest version here (you will download it in Step 6).

  1. Enter cd ~emu
  2. Enter mkdir -p texpress/9.0.xxx/install
  3. Enter cd texpress/9.0.xxx/install
  4. Download the appropriate Texpress version for your Unix machine, save it to ~emu/texpress/9.0.xxx/install, naming it texpress.sh.
  5. To extract the release, enter sh texpress.sh
  6. Enter . ./.profile
  7. To commence the installation script, enter bin/texinstall ~emu/texpress/9.0.xxx
  8. Enter cd ~emu/texpress/9.0.xxx
  9. Enter . ./.profile
  10. Enter bin/texlicinfo

    Obtain your Texpress licence code and save it in a file called .licence.

  11. To install the licence, enter bin/texlicset < .licence
  12. Enter \rm -fr install
  13. Enter cd ~emu/texpress
  14. Enter ln -s 9.0.xxx 9.0

Note: In the following steps, xxx is the version of TexAPI being installed (typically the current version). If installing TexAPI version 6.0.012 for instance, you'd replace xxx with 012 in the following command: mkdir 6.0.xxx. You can check which is the latest version here (you will download it in Step 3).

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

  1. Enter cd ~emu/texpress
  2. Enter mkdir 6.0.xxx
  3. Download the appropriate TexAPI version for your Unix machine and save it to ~emu/texpress, naming it texapi.sh
  4. Enter sh texapi.sh -i ~emu/texpress/6.0.xxx

  5. Note: Replace ~emu with user emu's expanded home directory, typically /home/emu.

    Enter \rm -f texapi
  6. Enter ln -s 6.0.xxx texapi
  7. Enter \rm -f texapi.sh

Note: In the final step, EMu is upgraded from version 6.1 to 6.2. If your current version of EMu is older than 6.1, be sure to run each upgrade script from your current version onwards until you are in a position to upgrade from version 6.0 to 6.2. All previous upgrade notes can be found here.

  1. Enter cd ~emu/clientname
  2. Enter mkdir install
  3. Enter cd install
  4. Download the appropriate EMu server version bundle and save it in ~emu/clientname/install naming it emu.sh.
  5. To extract the EMu release, enter sh emu.sh
  6. Enter . ./.profile
  7. To commence the installation script, enter bin/emuinstall clientname
  8. Enter cd ~emu/clientname
  9. Enter cp .profile.parent ../.profile
  10. Enter . ../.profile
  11. Enter client clientname
  12. Enter upgrade-list-reports

    This step generates a list of Crystal reports that use columns that have increased from <= 255 to > 255 in length. This list can be supplied to customers so that they can manually resolve the affected report files.

    See Reports columns for details.

  13. Enter emureindex

  14. Removal of the temporary install directory (and its contents) is recommended:

    Enter \rm -fr install

  15. Enter upgrade-6-2

  16. Enter upgrade-6-2.multimedia

    This step removes some erroneously generated multimedia record values. This may take some time and generate a lot of output for customers with a large number of Multimedia records. For details see Jira EMU-2300.

  1. Enter emuload start
  2. Enter emuoad status

Check that all loads started successfully. Investigate any loads that failed to start.

The recording of the upgrade session may now be terminated.

  1. Enter exit

The session output is available in /tmp/output-6-2.

EMu 6.2 does not require the new Windows client to be installed on every machine for network installations. Updating the network server is sufficient. For standalone installations a new client is required on each machine. To upgrade the EMu Client, follow the Install EMu Client notes.