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 clientname 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 4.0.01 or greater.

Installation Notes (EMu Server - emu)

1. Log in as emu
2. Enter cd  ~emu
3. The install bundle must be unarchived into a new temporay directory.
   It is recommended to use a new temporary directory named ~emu/clientname/install.
   Enter mkdir  -p  clientname/install
4. Enter cd  clientname/install
5. Obtain the appropriate EMu server version bundle via the KE EMu Server hyperlink above.
   Save the release bundle file in the ~emu/clientname/install temporary directory.
6. Extract the client release by using the name of the actual release file.
   Enter sh  emu-clientname-yymmddv.sh
   The EMu release will be extracted.
7. Enter .  ./.profile
8. Enter bin/emuinstall  clientname.
   The EMu installation script will commence.
9. Enter cd  ~emu/clientname
10. Enter cp  .profile.parent  ../.profile
11. Enter cd  ..
12. Enter vi  .profile-local
13. Add a single line client clientname to the file and save it. If a default client is already registered then you may leave the existing value.
14. Enter .  ./.profile
15. Enter client  clientname
16. Enter cd  etc
17. 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.
    Be careful to set EMUSMTPSERVER to the hostname of your mail server machine.
18. Enter cd  ..
19. Enter emubldlinks
20. Enter emulutsrebuild
21. Removal of the the temporary directory (and its contents) is recommended:
    Enter \rm  -fr  install

In order to allow easier upgrades of Texpress (without having to update the etc/opts file) all Texpress options are now set in the client specific .profile-local file. When installing EMu 4.0 you will have to add all Texpress options required for the installation. In particular the dateorder, dateformat, timeformat, latitudeformat, longitudeformat, tmppath and loadmemory settings should be examined. Please see Texpress options for a list of acceptable values.

1. Enter vi  .profile-local and add the Texpress options to the file. An example file is:
   TEXPRESSOPTS="${TEXPRESSOPTS} dateorder=mdy dateformat='dd MMM yyyy'"
   export TEXPRESSOPTS
2. Enter client  clientname
   Any other client specific setting can be set at this time (e.g. shell specific settings, etc.).
3. Enter exit to close the command shell.
4. Log out.

Installation Notes (KE 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 new services to the end of the file and save the file.
   
   

   emu	20000/tcp
   emutrain	20001/tcp
   emutest	20002/tcp
   emuweb	30000/tcp
   emuwebtrain	30001/tcp
   emuwebtest	30002/tcp

   
   You should also add client specific services.
   To determine the port and webport required please view the EMu Ports document.
   
   

   emuclientname	port/tcp	(replace port with port number)
   emuwebclientname	webport/tcp	(replace webport with port number)

 



4. Save the file.

Installation Notes (KE 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 7.0 or later and Solaris 10 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:
   emuclientname stream tcp nowait root ~emu/clientname/bin/emurun emurun texserver -aemu -i -L -t60
   If you also want the emu service to connect to your emuclientname then add the line:
   emu stream tcp nowait root ~emu/clientname/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, the following steps are required:

1. Enter cd  /etc/xinetd.d
2. Enter vi  emuclientname
3. Enter the following text in the file:
   # default: on
   service emuclientname
   {
      flags = REUSE  
      protocol = tcp  
      socket_type = stream  
      wait = no  
      user = root  
      server = ~emu/clientname/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 - smf)

If you are installing on a Solaris system, version 10 or later using smf (Service Management Facility) the following steps are required:

1. Enter vi  /tmp/inetd
2. Add the following line to the file:
   emuclientname stream tcp nowait root ~emu/clientname/bin/emurun emurun texserver -aemu -i -L -t60
   If you also want the emu service to connect to your emuclientname then add the line:
   emu stream tcp nowait root ~emu/clientname/bin/emurun emurun texserver -aemu -i -L -t60
3. Save the file.
4. Enter inetconv  -f  -i /tmp/inetd
5. To determine if the services are enabled use the inetadm command.

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
   AIX	/etc/rc.tcpip
   FreeBSD	/etc/rc.local
   Red Hat Linux	/etc/rc.d/rc.local
   Solaris	/etc/rc3.d/S99emu
   SUSE Linux	/etc/rc.d/rc3.d/S99emu

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/clientname/bin/emuboot
4. Save the file.
5. Enter ~emu/clientname/bin/emuboot
6. Log out.

Perl Packages

If the administration utility to change a user's password is used, the perl Net::SSH::Expect package must be installed. If the password utility is not used, this step may be skipped. To install the package:

1. Log in as root
2. Enter perl -MCPAN -e shell
3. Enter install Net::SSH::Expect
4. Enter quit

Optional Perl Packages

Significant speed improvements in the EMu auditing facility may be achieved by installing two perl packages. The installation of these packages is optional but recommended.

1. Log in as root
2. Enter perl -MCPAN -e shell
3. Enter install XML::Parser::Expat
4. Enter install File::FcntlLock
5. Enter quit
6. Log in as emu.
7. Enter emuload stop audit
8. Enter emuload start audit