# $Id: README.Solaris 8449 2005-08-15 11:55:49Z joostvb $
# $URL: https://infix.uvt.nl/its-id/trunk/sources/postfix/package/solaris/pkg/README.Solaris $

This is a Postfix Solaris package.  Postfix is available from
http://www.postfix.org/ .  This package is available from
http://non-gnu.uvt.nl/pub/postfix/solaris/ .  If you're interested in adjusting
this binary package to your specific needs, use the .diff.gz Solaris source
package, see CSBS documentation at http://mdcc.cx/csbs/ for information on this
file.

See below for changes in this package.  See below for
postinstallation instructions and a current list of open issues.

TODO
====

- remove old build instructions from http://non-gnu.uvt.nl/
- Add link from share/doc/postfix to copyright file: upstream installs these in
  /etc/postfix/.
- run postfix's post-install from a package script,
- check our distributed main.cf,
- check our init script; is should get installed as /etc/postfix/init
- check again if we really can't autogenerate prototype:
   The prototype file is not fully automatically generated: In

 i pkginfo=./pkginfo
 i preinstall=./preinstall
 d none etc 0755 root sys

   the preinstall line is added manually.  Therefore, it's under version control.
   See also prototype(4).

- when running

   pkgrm UVTpostfx

  pkgrm removes /etc/postfix/* , including main.cf. fix that.
  /var/spool/postfix will get purged too.  Oops...


POSTINSTALLATION STUFF FOR UVTpostfx PACKAGE
============================================

Notes for people upgrading from sendmail, and planning to run postfix as the
system MTA.

** stop sendmail, flush queue

 root@monty-python:~# /etc/init.d/sendmail stop
 root@monty-python:~# /usr/lib/sendmail -q

** purge sendmail packages

 root@monty-python:~# pkgrm SUNWsndmr
 root@monty-python:~# pkgrm SUNWsndmu

If you do fail to do this, you will get in trouble once a Solaris patch
overrides your /usr/lib/sendmail.

** disable sendmail

If you still have some old sendmail files on your system, move them out of the
way:

 root@monty-python:/usr/lib# mv sendmail sendmail.OFF

 root@monty-python:/usr/bin# rm newaliases
 root@monty-python:/usr/bin# rm mailq

 root@monty-python:/etc/init.d# mv sendmail sendmail.OFF

 root@monty-python:/etc# rm rc*/*sendmail

(that should remove rc0.d/K36sendmail rc1.d/K36sendmail rc2.d/S88sendmail rcS.d/K36sendmail)

 root@monty-python:/etc/mail# mv aliases aliases.OFF
 root@monty-python:/etc/mail# rm aliases.dir aliases.pag
 root@monty-python:/etc/mail# rm genericstable.db
 root@monty-python:/etc/mail# mv genericstable genericstable.OFF
 root@monty-python:/etc/mail# mv local-host-names local-host-names.OFF
 root@monty-python:/etc/mail# mv sendmail.cf sendmail.cf.OFF
 root@monty-python:/etc/mail# mv submit.cf submit.cf.OFF

 root@monty-python:/etc# ls -l aliases
 lrwxrwxrwx   1 root     root          14 Nov 25 12:10 aliases -> ./mail/aliases
 root@monty-python:/etc# rm aliases

You might also want to consult /usr/local/share/doc/postfix/INSTALL.

** configure postfix as the system's MTA

 root@monty-python:/etc/postfix# mv main.cf main.cf.dist

Install your manually tweaked main.cf in /etc/postfix/ .  (The one which comes
with this package will PROBABLY **NOT** WORK for you.)

Bless postfix to be the system's MTA:

 root@monty-python:/usr/lib# ln -s ../local/lib/sendmail

Install your manually tweaked aliases file in /etc/postfix/ .  Same remark as
for main.cf.

 root@monty-python:/# newaliases

** enable the postfix init script

Install the postfix init script.  This package installs it in
/etc/postfix/init, you can install it as:

 root@monty-python:/etc/init.d# ln -s ../postfix/init postfix

Create needed init-script symlinks:

 root@horowitz:/etc/rc0.d# ln -s ../init.d/postfix K36postfix
 root@horowitz:/etc/rc1.d# ln -s ../init.d/postfix K36postfix
 root@horowitz:/etc/rc2.d# ln -s ../init.d/postfix S88postfix
 root@horowitz:/etc/rcS.d# ln -s ../init.d/postfix K36postfix

** start the postfix deamon

Start postfix

 root@monty-python:/etc/init.d# ./postfix start
 Starting mail transport agent: Postfix.

Alternatively, run

 root@monty-python:~# postfix start

You should see something like

 Apr  8 09:47:56 monty-python postfix/postfix-script: [ID 197553 mail.info] starting the Postfix mail system
 Apr  8 09:47:56 monty-python postfix/master[23087]: [ID 197553 mail.info] daemon started -- version 2.0.3

In your mail logs.

Do some testing:

 joostvb@monty-python:~% date | mailx -s 'test, please ignore' root
 joostvb@monty-python:~% date | mailx -s 'test, please ignore' kunst

.

Happy Hacking!
                                           -- Joost van Baal

CHANGELOG
=========

UVTpostfx XXXXX

  * init: update comments
  * README.Solaris: be more explicit on symlink creation for init script.

 -- Joost van Baal <joostvb.uvt.nl> XXXXXXXXX

UVTpostfx (2.2.5_3)

  * prototype: adjust for new binaries and documentation.  2.2.5_1 and
    2.2.5_2 are NOT usable: these lack some needed binaries!
  * init: initscript added.

 -- Joost van Baal <joostvb.uvt.nl>  Mon, 15 Aug 2005 12:45:37 +0200

UVTpostfx (2.2.5_2)

  * TODO: added some pending issues
  * Makefile.m4: adapted to new upstream: sample_directory is gone,
    html_directory added

 -- Joost van Baal <joostvb.uvt.nl>  Mon, 15 Aug 2005 10:42:13 +0200

UVTpostfx (2.2.5_1)

  * BEWARE!  Untested prerelease!
  * New upstream (missed lots of in between versions, some security issues
    have been dealt with upstream.)
  * postinst: added: note for the admin.
  * README.Solaris: solaris supplied sendmail might interact badly with
    this package, therefore, purge it: note added.
  * preinst: we do not need perl for finding out about existence of a group.
    Tnx Loic Minier for enlightening me.
  * README.Solaris: applied minor patch by Wessel Dankers: Mail is
    /usr/ucb/Mail, mailx is /usr/bin/mailx.  That last one is more likely
    to be found in the user's PATH.  :-/
  * pkginfo.in: new name for pkginfo: csbs-ization.
  * Makefile.m4: added: csbs-ization.
  * README.Solaris: refer to csbs stuff.
  * prototype: upstream no longer installs examples.
  * changelog.Solaris: merged in README.Solaris.

 -- Joost van Baal <joostvb.uvt.nl>  Fri, 12 Aug 2005 17:36:16 +0200

UVTpostfx (2.0.16_3)

  * Started maintaining this file, and installing it.
  * Ship a README.Solaris file, which gets installed in
    /usr/local/share/doc/postfix/ .  READ THIS FILE.  It contains important
    notes about after-install stuff.

 -- Joost van Baal <joostvb.uvt.nl>  Tue, 21 Oct 2003 13:05:46 +0200

UVTpostfx (2.0.16_2)

  * preinstall: evil hack to find a path to perl, to work around brokeness on
    target platform.

 -- Joost van Baal <joostvb.uvt.nl>  26 Sep 2003 14:24:14

UVTpostfx (2.0.16_1)

  * New upstream.
  * preinstall: /bin/false is more commonly found as /sbin/noshell.  Use the
    former as shell for postfix user.

 -- Joost van Baal <joostvb.uvt.nl>  22 Sep 2003 14:59:01

UVTpostfx (2.0.3_3)

  * Changed name, so that it builds on SunOS 5.7 too.

 -- Joost van Baal <joostvb.uvt.nl>  22 Apr 2003 10:19:51

UVTpostfix (2.0.3_2)

  * Cosmetics.

 -- Joost van Baal <joostvb.uvt.nl>  1 Apr 2003 15:39:03

UVTpostfix (2.0.3_1)

  * Initial (non-public) release.

 -- Joost van Baal <joostvb.uvt.nl>  1 Apr 2003 09:54:54

