Special Instructions for UNIFadval or UNIFmsglg

First-Time Installations of the UNIFadval or UNIFmsglg Packages

Release 2.1.0

After UNIFadval or UNIFmsglg is installed on a system, the handling of SMTP requests is handled by the new UNIFI software.  This handling requires some manual alterations to the /etc/inetd.conf file.

  1. Make two backup of copies of the /etc/inetd.conf file in a safe location (not /tmp or /etc)
    1. Type "cp /etc/inetd.conf /<backup directory>/inetd.conf.old" and press [ENTER]
    2. Type "cp /etc/inetd.conf /<backup directory>/inetd.conf.new" and press [ENTER]
    3. Type "chmod -w /<backup directory>/inetd.conf.old" and press [ENTER].  This makes one copy read-only to prevent accidental changes.
  2. Use vi or a similar editor to make the changes to /<backup directory>/inetd.conf.new
    1. Above the SMTP handling line which reads "smtp stream tcp nowait root /usr/sbin/mhs/SMTPresponder SMTPresponder", insert:

      # The following line was how smtp requests were processed before
      # installing Unifi's adval/msglg packages.
      # Commented out <date> by <installer name>

    2. Comment out the old SMTP line by adding a "#" in front of the line reading "smtp stream tcp nowait root /usr/sbin/mhs/SMTPresponder SMTPresponder"
    3. After the SMTP handling line, add:

      # The following line is how smtp requests are processed with the software
      # installed with Unifi's adval/msglg packages.
      # Added <date> by <installer name>
      #
      smtp stream tcp nowait root /usr/sbin/mhs/SMTPresponder SMTPresponder -I SMTP-in_UNIFI      "

    4. Save the file and exit
  3. Compare the old and new configuration files
    1. Type "diff /<backup directory>/inetd.conf.old /<backup directory>/inetd.conf.new" and press [ENTER]
    2. The only differences should be those listed above, if there were no mistakes or accidental changes.  If there are other changes, fix them using the vi editor.
  4. Type "cp /<backup directory>/inetd.conf.new /etc/inetd.conf" and press [ENTER] to copy the edited copy of the configuration file into the correct location
  5. Signal the inetd daemon to use the new configuration file
    1. Type "ps -aef | grep inetd" and press [ENTER] to get the pid of the inetd daemon
    2. Type "kill -HUP <pid of the inetd daemon>" and press [ENTER] to send a hangup signal to the daemon 
  6. If there are no errors, it is safe to remove the temporary files
    1. Type "rm /<backup directory>/inetd.conf.old /<backup directory>/inetd.conf.new" and press [ENTER]

Removing the UNIFadval or UNIFmsglg package for an Upgrade

To upgrade UNIFadval or UNIFmsglg, the older version of the package must be removed and the newer version installed.  Some manual alterations to the inetd.conf file are required BEFORE the old packages can be removed..

  1. DISABLE THE "SMTP-in_UNIFI" QUEUE. This is necessary to avoid misprocessing any incoming messages during the interim time of the package being removed and then added.
  2. Type "pkgrm <package name>" and press [ENTER] to remove the UNIFadval or UNIFmsglg package
  3. Go to the installation instructions for UNIFadval or UNIFmsglg
  4. Once the new installation is complete, the SMTP-in_UNIFI queue can be enabled.

Removing the UNIFadval or UNIFmsglg Package Permanently

Some manual alterations to the inetd.conf file are required BEFORE the packages can be removed..

  1. Make two backup of copies of the /etc/inetd.conf file in a safe location (not /tmp or /etc)
    1. Type "cp /etc/inetd.conf /<backup directory>/inetd.conf.old" and press [ENTER]
    2. Type "cp /etc/inetd.conf /<backup directory>/inetd.conf.new" and press [ENTER]
    3. Type "chmod -w /<backup directory>/inetd.conf.old" and press [ENTER].  This makes one copy read-only to prevent accidental changes.
  2. Use vi or a similar editor to make the changes to /<backup directory>/inetd.conf.new
    1. Remove the "#" in front of the old (commented-out) SMTP handling line ("#smtp stream tcp nowait root /usr/sbin/mhs/SMTPresponder SMTPresponder")
    2. Comment out the old SMTP line by adding a "#" in front of the line reading "smtp stream tcp nowait root /usr/sbin/mhs/SMTPresponder SMTPresponder -I SMTP-in_UNIFI"
    3. Save the file and exit
  3. Compare the old and new configuration files
    1. Type "diff /<backup directory>/inetd.conf.old /<backup directory>/inetd.conf.new" and press [ENTER]
    2. The only differences should be those listed above, if there were no mistakes or accidental changes.  If there are other changes, fix them using the vi editor.
  4. Type "cp /<backup directory>/inetd.conf.new /etc/inetd.conf" and press [ENTER] to copy the edited copy of the configuration file into the correct location
  5. Signal the inetd daemon to use the new configuration file
    1. Type "ps -aef | grep inetd" and press [ENTER] to get the pid of the inetd daemon
    2. Type "kill -HUP <pid of the inetd daemon>" and press [ENTER] to send a hangup signal to the daemon 
  6. If there are no errors, it is safe to remove the temporary files
    1. Type "rm /<backup directory>/inetd.conf.old /<backup directory>/inetd.conf.new" and press [ENTER]
  7. Type "pkgrm <package name>" and press [ENTER] to remove the UNIFadval or UNIFmsglg package

Status: Second draft
Author: Judy McLaughlin