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. 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 typically /home/emu.

Requirements

• EMu Server version 3.1.00 or greater.

Installation Notes (EMu Server - emu)

1. Log in as emu.
2. Enter cd  ~emu
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.
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. View the config.sample file.
    If  you wish to alter some of these settings to suit the client then:
    Enter cp  config.sample  config
    Enter vi  config
    edit as appropriate, then save the file.
19. Enter cd  ..
20. Enter emubldlinks
21. Enter emulutsrebuild  -m.
22. Enter \rm  -fr  install
23. Enter exit to close the command shell.
24. Log out.

Installation Notes (EMu Server - root)

1. Log in as root. Note in all examples below ~emu must be expanded to emu's home directory.
2. Enter vi  /etc/services
3. Add six new services to the bottom of the file.
   emu          20000/tcp
   emutrain     20001/tcp
   emutest      20002/tcp
   emuweb       30000/tcp
   emuwebtrain  30001/tcp
   emuwebtest   30002/tcp
4. You should also add client specific services.
   To determine the port and webport required please view the EMu Ports document.
   emuclient       port/tcp        (replace port with port number)
   emuwebclient    webport/tcp     (replace webport with port number)
5. Save the file.

Installation Notes (EMu Server - inetd)

If your system uses inetd to start up system services then the following setup is required. All versions of Unix use inetd by default except for Red Hat Linux version 7.0 or later. If the file /etc/inetd.conf exists then these steps are required.

1. Enter vi  /etc/inetd.conf
2. Add the following line to the end of the file:
   emuclient stream tcp nowait root ~emu/client/bin/emurun emurun texserver -aemu -i -L -t60 If you also want the emu service to connect to your emuclient then also add the line:
   emu stream tcp nowait root ~emu/client/bin/emurun emurun texserver -aemu -i -L -t60
3. Save the file.
4. You will need to restart inetd for the changes to take effect.
   Locate the process id number pid for the inetd process and then
   Enter kill  -HUP  pid.

Installation Notes (EMu Server - xinetd)

If you are installing on a Red Hat Linux system, version 7.0 or later, or the file /etc/xinetd.conf exists then the following steps are required.

1. Enter cd  /etc/xinetd.d
2. Enter vi  emuclient
3. Enter the following text in the file:
   # default: on
   service emuclient
   {
       flags = REUSE
       protocol = tcp
       socket_type = stream
       wait = no
       user = root
       server = ~emu/client/bin/emurun
       server_args = texserver -aemu -i -L -t60
       log_on_failure += USERID
       disable = no
   }
4. Save the file.
5. You will need to restart xinetd for the changes to take effect.
   Locate the process id number pid for the xinetd process and then
   Enter kill  -HUP  pid.
   Note that on some versions of Red Hat you may need to enter kill  -USR2  pid in order to update xinetd. To determine what signal is required on Red Hat consult the manual entry for xinetd.

Installation Notes (EMu Server - startup)

1. Locate the name of the local system initialisation file for your operating system. Some examples are:
   

   Operating System	File
   Red Hat	/etc/rc.d/rc.local
   FreeBSD	/etc/rc.local
   Solaris	/etc/rc3.d/S99emu
   AIX	/etc/rc.tcpip

2. Enter vi  file where file is the name of the local system initialisation file.
3. Add the following lines to the end of the file:
   #
   # KE EMu startup
   #
   ~emu/client/bin/emuboot
4. Save the file.
5. Enter ~emu/client/bin/emuboot
6. Log out.