Upgrade EMu 6.5 to 8.0

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

   where version-# is the EMu version you are upgrading to. If upgrading to version 8.0, you would enter:

   script /tmp/output-8-0

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

Installing Texpress 10.0 is only required for the first client upgraded to EMu 8.0. Once Texpress 10.0 has been installed, this section can 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 10.0.001 for instance, you'd replace xxx with 001 in the following command: mkdir -p texpress/10.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/10.0.xxx/install
3. Enter cd texpress/10.0.xxx/install
4. Download the appropriate Texpress version for your Unix machine, save it to:

   ~emu/texpress/10.0.xxx/install

   and name 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/10.0.xxx

8. Enter cd ~emu/texpress/10.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 10.0.xxx 10.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 8.0. Once TexAPI has been installed, this section can be skipped for subsequent upgrades.

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

   ~emu/texpress

   and name it texapi.sh

4. Enter sh texapi.sh -i ~emu/texpress/texapi-.0.xxx

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

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

Note: In the final step, EMu is upgraded from the previous version of EMu (e.g. 6.5) to the latest version of EMu (e.g. 8.0).
If your institution's current version of EMu is older than the previous version (e.g. older than 6.5), be sure to run each upgrade script from your current version onwards until you are in a position to upgrade from the previous version to the latest version (e.g. 6.5 to 8.0). 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, save it in:

   ~emu/clientname/install

   and name 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-8-0.lfs

    This step joins partitioned files back into a single file. If the exec option is used in the ServerMediaPath Registry entry then you may need to run the script with a list of paths to check for partitioned files.

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

14. Enter emureindex -R

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

    \rm -fr install

16. Enter upgrade-8-0

    This step includes reloading the Bibliography database. This may take some time for customers with a large number of Bibliography records.

17. Enter upgrade-8-0.bibliography <view-type> ONLY if the customer intends on using the new simplified Bibliography user interface.

    This step updates every record in the Bibliography database. This may take some time for customers with a large number of bibliography records. Details can be found here.

18. Enter upgrade-8-0.registry

1. Enter emuload start
2. Enter emuload 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-8-0

EMu 8.0 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.