Email Engine preinstallation tasks - UNIX

 Complete the following tasks before you install the Email Engine on UNIX.

Setting up UNIX mailboxes

As superuser, use the following procedure to establish a mailbox address for the UNIX Email Engine. These instructions are meant only as generic guidelines. If you have questions about the implementation, consult your UNIX system administrator for details.

To set up UNIX mailboxes

1. Set up an ARSystem user account in the /etc/passwd file.
   For example (the new entry is the last line): 

   root:x:0:1:0000-Admin(0000):/:/sbin/sh
   daemon:x:1:1:0000-Admin(0000):/:
   bin:x:2:2:0000-Admin(0000):/usr/bin:
   sys:x:3:3:0000-Admin(0000):/:
   adm:x:4:4:0000-Admin(0000):/var/adm:
   lp:x:71:8:0000-lp(0000):/usr/spool/lp:
   smtp:x:0:0:mail daemon user:/:
   uucp:x:5:5:0000-uucp(0000):/usr/lib/uucp:
   listen:x:37:4:Network Admin:/usr/net/nls:
   nobody:x:60001:60001:uid no body:/:
   noaccess:x:60002:60002:uid no access:/:
   ARSystem:x:50:10:AR System mail user:/home/ARSystem:/bin/sh

2. Edit the /etc/aliases file and add the alias ARSystem with the mailbox of /usr/spool/mail/ARSystem, as follows:

   /etc/aliases file
   #######################
   # Local aliases below #
   #######################
   # Email Alias for AR System mailbox
   ARSystem:/usr/spool/mail/ARSystem

   You can choose a different name, if required. Verify this step for your UNIX computer. The name might be different for your platform. In particular, the path to your mail folder might be different from /usr/spool/mail/.

   Note

   On some UNIX platforms, you need to run the newaliases command to have the ARSystem aliases recognized. See your UNIX system administration documentation or UNIX system administrator if you have questions or problems. The /usr/spool/mail email directory will vary between UNIX platforms.

3. Create the mailbox file you defined for this user in the /etc/aliases file or /usr/lib/aliases file (HPUX), by using the following command:

   # touch /usr/spool/mail/ARSystem

4. Change the group name to daemon, or to the owner of the mailbox alias name, as in the following example:

   # chgrp daemon /usr/spool/mail/ARSystem

   Note

   The group name varies between UNIX platforms. For most UNIX platforms, it is the group daemon, while on HPUX, it is mail. To verify the correct group name to use, check the group name for the mail directory by using the ls -ldg command.

5. Change the mailbox permissions to provide read and write access for all, as in the following example:

   # chmod 666 /usr/spool/mail/ARSystem
   ls -laF /usr/spool/mail/ARSystem
   -rw-rw-rw-- 1 daemon 0 May 30 16:55 /usr/spool/mail/ARSystem
   

Installing as a non-root user

After installing the Email Engine, review the manualInstall.txt file and modify the logging.properties and javamail.providers files as described in mannulInstall.txt* file, which is located in <ARSystemInstallDir>/nonRootUserDirectory/<serverName>/<manualInstall>.