Introduction

EMu is designed to allow multiple installations to coexist. Each installation is placed in a directory within the user emu's home directory. The name of this directory typically reflects the client system being installed. The client name may be any name, thus allowing test and production environments to be set up for the same system. Typically the client name is an acronym for the client organisation. 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.0.
• Texpress, version 8.0.019 or greater.
• TexAPI, version 3.1.004 or greater.
• EMu Server version 3.0.01 or greater.

Installation Notes (EMu Server - emu)

1. Log in to the Windows machine as user emu.
2. Start a Korn Shell with Start->Programs->Windows Services for UNIX->Korn Shell.
3. Enter mkdir  -p  client/install
4. Enter cd  client/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  client.
   The EMu installation script will commence. As part of the installation you will be prompted to enter the emu password. The password is required for cron to function correctly.
10. Enter cd  ~emu/client
11. Enter cp  .profile.parent  ../.profile
12. Enter cd  ..
13. Enter vi  .profile-local
14. Add a single line client client to the file and save it.
    If a default client is already registered then you may leave the existing value.
15. Enter .  ./.profile
16. Enter client  client
17. Enter cd  etc
18. Enter cp  config.sample  config
    Enter vi  config and edit as appropriate. Be careful that you set:
    EMUSMTPSERVER to the hostname of your mail server machine. Save the file.
19. Enter cd  ..
20. Enter emubldlinks
21. Enter emulutsrebuild  -m
22. Enter \rm  -fr  install
23. Enter exit to close the ksh window.
24. Log out.

Installation Notes (EMu Server - Administrator)

1. Log in as Administrator.
2. Start a Korn Shell with Start->Programs->Windows Services for UNIX->Korn Shell.
3. Enter vi  /etc/services
4. Add new services to the bottom of the file.
   Each line must be terminated with a CTRL+M character so that Windows programs interpret the file correctly. To enter a CTRL+M in vi type CTRL+V then CTRL+M.
   emu          20000/tcp^M
   emutrain     20001/tcp^M
   emutest      20002/tcp^M
   emuweb       30000/tcp^M
   emuwebtrain  30001/tcp^M
   emuwebtest   30002/tcp^M
5. You should also add client specific services.
   To determine the port and webport required please view the EMu Ports document.
   emuclient       port/tcp^M        (replace port with port number)
   emuwebclient    webport/tcp^M     (replace webport with port number)
6. Save the file.
7. Enter vi  /etc/inetd.conf
8. Add the following line to the end of the file (expand [emu]):
   emuclient stream tcp nowait NULL /dev/fs/C/home/emu/client/bin/emurun emurun texserver -a[emu] -i -L -t60 If you also want the emu service to connect to your emuclient then add also add the line:
   emu stream tcp nowait NULL /dev/fs/C/home/emu/client/bin/emurun emurun texserver -a[emu] -i -L -t60
9. Save the file.
10. Enter ps -ef | grep inetd and get the process id of inetd (it is the first number listed).
11. Enter kill -HUP processid
12. Enter cd /etc/rc2.d
13. Enter vi S99emu and add the following lines to the file:
    #!/bin/sh
    #
    # KE EMu startup
    #
    PATH=/bin:/usr/contrib/bin
    case $1 in
        start)
            /dev/fs/C/home/emu/client/bin/emuboot
            ;;
        stop)
            ;;
        *)
            echo "usage: $0 start|stop"
            ;;
    esac
    exit 0
14. Save the file.
15. Enter chmod 755 S99emu
16. Enter ./S99emu start
17. Enter exit to close the ksh window.
18. In order to test the startup script it is recommended that you reboot the server machine and confirm that all EMu services start correctly. Output from scripts run when booting is found in /var/adm/log/init.log. Error messages are placed in /var/adm/log/messages.