external/ibm-public/postfix/dist/README_FILES/PACKAGE_README

   1 G\bGu\bui\bid\bde\bel\bli\bin\bne\bes\bs f\bfo\bor\br P\bPa\bac\bck\bka\bag\bge\be B\bBu\bui\bil\bld\bde\ber\brs\bs
   2
   3 -------------------------------------------------------------------------------
   4
   5 P\bPu\bur\brp\bpo\bos\bse\be o\bof\bf t\bth\bhi\bis\bs d\bdo\boc\bcu\bum\bme\ben\bnt\bt
   6
   7 This document has hints and tips for those who manage their own Postfix
   8 distribution for internal use, and for those who maintain Postfix distributions
   9 for general use.
  10
  11 G\bGe\ben\bne\ber\bra\bal\bl d\bdi\bis\bst\btr\bri\bib\bbu\but\bti\bio\bon\bns\bs:\b: p\bpl\ble\bea\bas\bse\be p\bpr\bro\bov\bvi\bid\bde\be a\ba s\bsm\bma\bal\bll\bl d\bde\bef\bfa\bau\bul\blt\bt m\bma\bai\bin\bn.\b.c\bcf\bf f\bfi\bil\ble\be
  12
  13 The installed main.cf file must be small. PLEASE resist the temptation to list
  14 all parameters in the main.cf file. Postfix is supposed to be easy to
  15 configure. Listing all parameters in main.cf defeats the purpose. It is an
  16 invitation for hobbyists to make random changes without understanding what they
  17 do, and gets them into endless trouble.
  18
  19 G\bGe\ben\bne\ber\bra\bal\bl d\bdi\bis\bst\btr\bri\bib\bbu\but\bti\bio\bon\bns\bs:\b: p\bpl\ble\bea\bas\bse\be i\bin\bnc\bcl\blu\bud\bde\be R\bRE\bEA\bAD\bDM\bME\bE o\bor\br H\bHT\bTM\bML\bL f\bfi\bil\ble\bes\bs
  20
  21 Please provide the applicable README or HTML files. They are referenced by the
  22 Postfix manual pages and by other files. Without README or HTML files, Postfix
  23 will be difficult if not impossible to configure.
  24
  25 P\bPo\bos\bst\btf\bfi\bix\bx I\bIn\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn p\bpa\bar\bra\bam\bme\bet\bte\ber\brs\bs
  26
  27 Postfix installation is controlled by a dozen installation parameters. See the
  28 postfix-install and post-install files for details. Most parameters have
  29 system-dependent default settings that are configurable at compile time, as
  30 described in the INSTALL file.
  31
  32 P\bPr\bre\bep\bpa\bar\bri\bin\bng\bg a\ba p\bpr\bre\be-\b-b\bbu\bui\bil\blt\bt p\bpa\bac\bck\bka\bag\bge\be f\bfo\bor\br d\bdi\bis\bst\btr\bri\bib\bbu\but\bti\bio\bon\bn t\bto\bo o\bot\bth\bhe\ber\br s\bsy\bys\bst\bte\bem\bms\bs
  33
  34 You can build a Postfix package on a machine that does not have Postfix
  35 installed on it. All you need is Postfix source code and a compilation
  36 environment that is compatible with the target system.
  37
  38 You can build a pre-built Postfix package as an unprivileged user.
  39
  40 First compile Postfix. After successful compilation, execute:
  41
  42      % m\bma\bak\bke\be p\bpa\bac\bck\bka\bag\bge\be
  43
  44 With Postfix versions before 2.2 you must invoke the post-install script
  45 directly (% s\bsh\bh p\bpo\bos\bst\bt-\b-i\bin\bns\bst\bta\bal\bll\bl).
  46
  47 You will be prompted for installation parameters. Specify an install_root
  48 directory other than /. The mail_owner and setgid_group installation parameter
  49 settings will be recorded in the main.cf file, but they won't take effect until
  50 the package is unpacked and installed on the destination machine.
  51
  52 If you want to fully automate this process, specify all the non-default
  53 installation parameters on the command line:
  54
  55      % m\bma\bak\bke\be n\bno\bon\bn-\b-i\bin\bnt\bte\ber\bra\bac\bct\bti\biv\bve\be-\b-p\bpa\bac\bck\bka\bag\bge\be i\bin\bns\bst\bta\bal\bll\bl_\b_r\bro\boo\bot\bt=\b=/\b/s\bso\bom\bme\be/\b/w\bwh\bhe\ber\bre\be...
  56
  57 With Postfix versions before 2.2 you must invoke the post-install script
  58 directly (% s\bsh\bh p\bpo\bos\bst\bt-\b-i\bin\bns\bst\bta\bal\bll\bl -\b-n\bno\bon\bn-\b-i\bin\bnt\bte\ber\bra\bac\bct\bti\biv\bve\be i\bin\bns\bst\bta\bal\bll\bl_\b_r\bro\boo\bot\bt.\b..\b..\b.).
  59
  60 B\bBe\beg\bgi\bin\bn S\bSe\bec\bcu\bur\bri\bit\bty\by A\bAl\ble\ber\brt\bt
  61
  62 W\bWh\bhe\ben\bn b\bbu\bui\bil\bld\bdi\bin\bng\bg a\ban\bn a\bar\brc\bch\bhi\biv\bve\be f\bfo\bor\br d\bdi\bis\bst\btr\bri\bib\bbu\but\bti\bio\bon\bn,\b, b\bbe\be s\bsu\bur\bre\be t\bto\bo a\bar\brc\bch\bhi\biv\bve\be o\bon\bnl\bly\by f\bfi\bil\ble\bes\bs a\ban\bnd\bd
  63 s\bsy\bym\bmb\bbo\bol\bli\bic\bc l\bli\bin\bnk\bks\bs,\b, n\bno\bot\bt t\bth\bhe\bei\bir\br p\bpa\bar\bre\ben\bnt\bt d\bdi\bir\bre\bec\bct\bto\bor\bri\bie\bes\bs.\b. O\bOt\bth\bhe\ber\brw\bwi\bis\bse\be,\b, u\bun\bnp\bpa\bac\bck\bki\bin\bng\bg a\ba p\bpr\bre\be-\b-b\bbu\bui\bil\blt\bt
  64 P\bPo\bos\bst\btf\bfi\bix\bx p\bpa\bac\bck\bka\bag\bge\be m\bma\bay\by m\bme\bes\bss\bs u\bup\bp p\bpe\ber\brm\bmi\bis\bss\bsi\bio\bon\bn a\ban\bnd\bd/\b/o\bor\br o\bow\bwn\bne\ber\brs\bsh\bhi\bip\bp o\bof\bf s\bsy\bys\bst\bte\bem\bm d\bdi\bir\bre\bec\bct\bto\bor\bri\bie\bes\bs
  65 s\bsu\buc\bch\bh a\bas\bs /\b/ /\b/e\bet\btc\bc /\b/u\bus\bsr\br /\b/u\bus\bsr\br/\b/b\bbi\bin\bn /\b/v\bva\bar\br /\b/v\bva\bar\br/\b/s\bsp\bpo\boo\bol\bl a\ban\bnd\bd s\bso\bo o\bon\bn.\b. T\bTh\bhi\bis\bs i\bis\bs e\bes\bsp\bpe\bec\bci\bia\bal\bll\bly\by a\ban\bn
  66 i\bis\bss\bsu\bue\be i\bif\bf y\byo\bou\bu e\bex\bxe\bec\bcu\but\bte\bed\bd p\bpo\bos\bst\btf\bfi\bix\bx-\b-i\bin\bns\bst\bta\bal\bll\bl (\b(s\bse\bee\be a\bab\bbo\bov\bve\be)\b) a\bas\bs a\ban\bn u\bun\bnp\bpr\bri\biv\bvi\bil\ble\beg\bge\bed\bd u\bus\bse\ber\br.\b.
  67
  68 E\bEn\bnd\bd S\bSe\bec\bcu\bur\bri\bit\bty\by A\bAl\ble\ber\brt\bt
  69
  70 Thus, to tar up the pre-built package, take the following steps:
  71
  72     % cd INSTALL_ROOT
  73     % rm -f SOMEWHERE/outputfile
  74     % find . \! -type d -print | xargs tar rf SOMEWHERE/outputfile
  75     % gzip SOMEWHERE/outputfile
  76
  77 This way you will not include any directories that might cause trouble upon
  78 extraction.
  79
  80 I\bIn\bns\bst\bta\bal\bll\bli\bin\bng\bg a\ba p\bpr\bre\be-\b-b\bbu\bui\bil\blt\bt P\bPo\bos\bst\btf\bfi\bix\bx p\bpa\bac\bck\bka\bag\bge\be
  81
  82   * To unpack a pre-built Postfix package, execute the equivalent of:
  83
  84     # umask 022
  85     # gzip -d <outputfile.tar.gz | (cd / ; tar xvpf -)
  86
  87     The umask command is necessary for getting the correct permissions on non-
  88     Postfix directories that need to be created in the process.
  89
  90   * Create the necessary mail_owner account and setgid_group group for
  91     exclusive use by Postfix.
  92
  93   * Execute the postfix command to set ownership and permission of Postfix
  94     files and directories, and to update Postfix configuration files. If
  95     necessary, specify any non-default settings for mail_owner or setgid_group
  96     on the postfix command line:
  97
  98     # postfix set-permissions upgrade-configuration \
  99            setgid_group=xxx mail_owner=yyy
 100
 101     With Postfix versions before 2.1 you achieve the same result by invoking
 102     the post-install script directly.
 103