~SMTP_SERVER026.DSMTP_SERVER026.DbBACKUP SMTP_SERVER_INSTALL.MSS,SMTP_SERVER_INSTALL.PS SMTP_SERVER026.D/SAVE/INTERCHANGE/BLOCK=2048 SYNFUL (x|V4.7 _CMU063::  _DUA0: V4.7  -*[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1+,X./ 4R-L0123KPWO%56p7`I{89GHJ@Begin(Comment)A ****************************************************************0 Copyright (c) 1992, Carnegie Mellon University All Rights Reserved@ Permission is hereby granted to use, copy, modify, and@ distribute this software provided that the above copyright@ notice appears in all copies and that any distribution be for noncommercial purposes.@ Carnegie Mellon University disclaims all warranties with regard@ to this software. In no event shall Carnegie Mellon University@ be liable for any special, indirect, or consequential damages@ or any damages whatsoever resulting from loss of use, data, or@ profits arising out of or in connection with the use or performance of this software.A **************************************************************** @End(Comment)@Device(PostScript) @Make(Manual)@Begin(Comment)SMTP_Server_Install.MSS. Copyright (c) 1987 Carnegie Mellon University Description:9 This is the scribe manuscript sPSMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1Rource for the SMTP_Server Installation Guide. Written By:! Dale Moore CMU-CS/RI 05-JAN-1988Modifications: @End(Comment)@Style(FontFamily TimesRoman)@Style(SingleSided)@LibraryFile(Stable)@Begin(Comment)*@Include(SYS$USER:[MOORE.DOC]FACILITY.MSS)@FacilityTitlePage(7Title="CMU-OpenVMS/IP SMTP_Server Installation Manual",Author="Dale Moore",File="", internal) @End(Comment)@PrefaceSection (Preface)@Heading "Intended Audience"CThis manual is intended for the VAX/VMS user with system management=responsibility. This person needs to know how to install theSMTP_Server software.@Chapter "Overview"<This chapter is an overview of the SMTP_Server software, its/environment, and its software components. This>manual covers the installation of SMTP_Server software and its operation."@Section "SMTP_Server Environment"IThe SMTP_Server software is built upon the CMU-OpenVMS/IP IPDRIVER, IPACPand NAMSRV software.CIt is one of four pieces of software that are used to implement the2mail system under the CMU-OpenVMS/IP TCP software.@Begin(Description)JInet_MailShr@\Used to provide a escape mechanism to deliver messages underthe VAX/VMS mail utility.@MailSMB@\A VAX/VMS Symbiont used to queue messages for delivery.ESMTP_Server@\A network server that accepts messages from other sites.CSMAIL@\A utility that can be used to compose and verify the correctformat of mail messages.@End(Description):The SMTP_Server allows otherntSMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1R machines to send mail to your6machine. It accepts mail messages from other machines2and queues them for delivery on the local machine.@Section "Additional Reading"GTo understand more about the CMU-OpenVMS/IP Mail system on VAX/VMS, trythe following documents.@Begin(Format)8@I"RFC 821, Simple Mail Transfer Protocol", August 1982,Jonathan Postel2@I"RFC 822, Format of Text Messages", August 1982, David Crocker @End(Format)'@Chapter "Preinstallation Requirements"KThe SMTP_Server software can be installed on any VAX/VMS machine that meets+certain hardware and software requirements. @Section "Hardware Requirements"AThere are currently no requirements for the SMTP_Server software,%other than a properly function VAX. @Section "Software Requirements"DThe CMU-OpenVMS/IP SMTP_Server software runs on VAX/VMS V4.5 throughV4.7.NThe CMU-OpenVMS/IP SMTP_Server software is layered upon server other pieces ofsoftware. They are@Begin(Itemize) IPDRIVER, IPACP,NAMSRV, INET_MAILSHR, andMAILSMB. @End(Itemize)?These pieces of software are used to provide network access andother functionsBWe recommend that you install this software before you install theSMTP_Server software:@Begin(itemize)IPDRIVERNAMSRVIPACP INET_MAILSHRMAILSMB @End(itemize)'@Section "Site Specific File Locations"AThe system logical name SYS$SYSROOT is used to describe where theFvarious system files, images and libraries are located. On WC SMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1R VAXClusterIsystems, SYS$SYSROOT is a search path that points first into SYS$SPECIFICG(for those files that are specific to that machine) and SYS$COMMON (for;files that are common amongst all machines in the cluster).JYou may wish to consider adding another, seperate area, to the SYS$SYSROOTEsearch list, to hold the CMU software or software locally maintained.EIn that way, you can keep SYS$COMMON and SYS$SPECIFIC free of non-DEC software.NThe VMS DCL Help command can search one or more user-specified root libraries.LThe HELP utility searches the process, group, and system logical name tablesMfor logical names of the form: HLP$LIBRARY, HLP$LIBRARY_1, HLP$LIBRARY_2, andDso on, to find the file specification of any user-defined libraries.;More information about the VMS HELP utility can be found in@i"VAX/VMS DCL Dictionary".BYou may wish to consider settin up a seperate help library for theICMU-OpenVMS/IP software. You can add it to the search list by defining asystem wide logical name.@Section "Required Disk Space"5The installation of the software requires 100 blocks.<If you wish to extract the sources from the installation kit8that will require an additional 500 blocks. If you wish>to extract a soft copy of the documentation, that will requirean additional 150 blocks.@Section "Installation Time"JThe time it takes to install the SMTP_Server software depends on the speedBof the distrubution medium, the speed of the processor, the amount@of concurrent acti|$WSMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1R\ vity on the system, and how fast you can type.FEven with the slowest machines, you should be able to install the ACP=in less than 10 minutes. If you want to extract the sources,!then it may take over 25 minutes."@Chapter "Installing the Software"RThis chapter describes the installation of the CMU-OpenVMS/IP SMTP_Server software?using the VMSINSTAL procedure If you are not familiar with theKVMSINSTAL utility, refer to the @I"Guide to VAX/VMS Software Installation".!@Section "Installation Procedure"@To start the installation, invoke the VMSINSTAL utility from the#system managers account as follows:@Begin(Example)7$ @@SYS$UPDATE:VMSINSTAL SMTP_Server026 @i"device-name" @End(Example)JVMSINSTAL will display its banner line, the date and time, and one or moreEwarning messages. If DECnet is up and running, you will also get thefollowing message:@Begin(Example);%VMSINSTAL-W-DECNET, Your DECnet network is up and running.'* Do you want to continue anyway [NO]? @End(Example)@Answer YES to continue. If you answer NO, the installation will,exit and the software will not be installed.You will then be asked:@Begin(Example)?* Are you satisfied with the backup of your system disk [YES]? @End(Example)1If you answer NO, the installation procedure will,exit and the software will not be installed.?Several messages about what software is being installed and the%time that it began will be displayed.Then VMSINSTAL will ask:@Begin(Example)A* DoRJ^SMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1R you want to purge files replaced by this installation [YES]? @End(Example)GIf you want to remove previous version answer YES. If you want to saveprevious versions answer NO.<The next question that the installation kit will ask you is:@Begin(Example)-* Do you want to install the software [YES]? @End(Example)?If you answer NO, the software will not be installed. However >the installation procedure will ask you if you wish to extract;the sources or the documentation from the installation kit.?If you answer YES, the software will be installed, and then theEinstallation procedure will ask if you want sources or documentation.)@SubSection "Software Image Installation"DIn the example below, SYS$SYSROOT is a search path for three places.FFirst is the system specific area of SYS$SPECIFIC. Next is the commonLarea SYS$COMMON. And lastly is the area where I keep our locally maintained software.DIf your SYS$SYSROOT is not setup the same way mine was, don't worry.LIf you want to put the SMTP_Server software in the normal SYS$SPECIFIC area,it should still work.FVMSINSTAL will prompt you for which area the software is to be placed:@Begin(Example)EThere are several places that the SMTP_Server software can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]<* Where do you want the software installed? [SYS$SPECIFIC:]: @End(Example)(Answer with the appropriate logial name.@SubSection "Sources"@The VM;SMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1ReiSINSTAL procedure will ask whether you want to extract the"sources from the installation kit:@Begin(Example)!* Do you want the sources [YES]? @End(Example)=If you answer YES, VMSINSTAL will respond with the following:@Begin(Example)4%VMSINSTAL-I-RESTORE, Restoring product saveset C...D The sources are in the backup save set SYS$UPDATE:SMTP_SERVER.SRC. @End(Example)EThe file SYS$UPDATE:SMTP_SERVER.SRC is a backup save set. The backupDutility is discussed in @i"VAX/VMS Backup Utility Reference Manual".NThe sources include all the source files necessary, to rebuild the SMTP_SERVERinstallation kit.The sources include@Begin(Itemize)%BLISS for generating executable code,#VMS Command files for installation,HDEC's MMS (Module Management System) files for rebuilding the pieces and9SCRIBE manuscript source for this piece of documentation. @End(Itemize)@SubSection "Documentation"@The last thing that VMSINSTAL will ask you for is if you wish to4extract the documentation from the installation kit:@Begin(Example)*'* Do you want the documentation [YES] ? @End(Example)g@The documentation includes the Scribe manuscript source for thisFdocument and the PostScript output from the Scribe document productionCsoftware. If you have a PostScript printer you can print a privateicopy of the document.b.If you answer YES, you will see the following:@Begin(Example)t4%VMSINSTAL-I-RESTORE, Restoring product saveset D...6 The Scribe source for the SMTP-tSMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1RT_Server installation2 manual is in SYS$HELP:SMTP_Server_INSTALL.MSS.3 For those with PostScript printers a PostScripts2 version is in SYS$HELP:SMTP_Server_INSTALL.PS. @End(Example)iFVMSINSTAL then moves the files from their temporary locations to theirpermanet directories:*@Begin(Example)*?%VMSINSTAL-I-MOVEFILES, Files will now be moved to their targetCdirectories... @End(Example)S?After the files have been moved, VMSINSTAL will terminate with::@Begin(Example)s; Installation of SMTP_Server V2.6 completed at hh:mmu) VMSINSTAL procedure done at hh:mm $J @End(Example)i(@Chapter "PostInstallation Requirements"FThe following SMTP_Server related operations should be performed after!the installation of the software.C3@Section "Updating the Internet Configuration File"S@The file SYS$MANAGER:INTERNET.CONFIG describes the current setupAof the IPACP software. The file is a text file. It is read eachaFtime the IPACP software starts. Usually the IPACP software is started at boot time.IInside the file are some lines that describe which well known servers are7running on which ports. The SMTP port is 25 (decimal).@Begin(Example)8WKS:25:SMTPSV:TCP$SMTPSV:NETWRK:NETMBX,TMPMBX,PHY_IO:4:5 @End(Example)$The IPACP software will start up the<SMTP server process each time the ACP detected a request foranother SMTP connection.AIf we were to use our favorite editor and comment out the line byEadding a semi-colon to the font of the line, the I %SMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1RpPACP software wouldnot start the SMTP server.'@Appendix "Sample Installation Session"@Begin(Verbatim, Size -2)H$ @@sys$update:vmsinstal smtp_server026 sys$user:[moore.exp.smtp_server]@ VAX/VMS Software Product Installation Procedure V4.6 It is 5-JAN-1988 at 15:40./Enter a question mark (?) at any time for help.;%VMSINSTAL-W-DECNET, Your DECnet network is up and running.>%VMSINSTAL-W-ACTIVE, The following processes are still active: MOORE _WTA2: MOORE_2(* Do you want to continue anyway [NO]? y?* Are you satisfied with the backup of your system disk [YES]? )The following products will be processed: SMTP_SERVER V2.6; Beginning installation of SMTP_SERVER V2.6 at 15:414%VMSINSTAL-I-RESTORE, Restoring product saveset A...N%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYS$HELP.@ This is the CMU-OpenVMS/IP SMTP_SERVER installation kit.7 This kit only provides the SMTP_SERVER service.B* Do you want to purge files replaced by this installation [YES]? -* Do you want to install the software [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset B...CThere are several places that the SMTP_SERVER images can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]L* Where do you want the images installed? [SYS$SPECIFIC:]: sys$user:[cmuip.]"* Do you want the sources [YES]? n'* Do you want the documentation [Y nSMTP_SERVER026.DXL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1RmES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset D...J The Scribe MSS Source file is in SYS$HELP:SMTP_SERVER_INSTALL.MSS.B The PostScript file is in SYS$HELP:SMTP_SERVER_INSTALL.PS.N%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...; Installation of SMTP_SERVER V2.6 completed at 15:43) VMSINSTAL procedure done at 15:44$@End(Verbatim)@Appendix "New Files"=During the installation, new files are created on the system.6@StandardTable(Name SMTPSERVERFiles, Columns 2, Boxed)@Begin(SMTPSERVERFiles)@TableId(SMTPSERVERFiles)=@TableHeading(Immediate, RowFormat SMTPSERVERFilesTopHeading,1Line "Files Created by SMTP_Server Installation")'SMTP_SERVER026.RELEASE_NOTES@\SYS$HELP:SMTP_Server.EXE@\SYS$SYSTEM:SMTP_Server.SRC@\SYS$UPDATE:!SMTP_Server_INSTALL.PS@\SYS$HELP:"SMTP_Server_INSTALL.MSS@\SYS$HELP:@End(SMTPSERVERFiles)'@Appendix "Trouble Shooting Procedures"Not yet finished.,*[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;1+,.0/ 4x0.-L0123KPWOC56`vb|7#"v|89GHJ >XL-[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.MSS;1Rjb W@uBsBxW7-(< L. c5GlJ ,}a'dewJ2FLb[C>W+(=%:DTH^EnoC7H,G( aeoGO(3E{!svQCydkr,}/=@C0)e5A\Gif$jK Wc`3UJWDAw+KO{f%N;ulg#RZUt)|VS=7 npe4Wez`V 7zA:/3%i`P3!*eE[jG( EsS w;4+HZ]@aOHS>Jq* 0( |AjB  WJ[VfK|5w%'K zh8e0S'eKSuYIs[^\\ BR} k$=6F6>(a DNeP ihsQZ^~: H xG~Ec;# l%78 $TINxcr)p} g61OH;5' Kz+c4.U3pP!)MLp#f3C?t~{L=GT&KRc%>m<v?BDQL;u :uKC;Y{{fVi9r ?2 x1q0-Ag2l8A8DxwLoeu".3k'{ Mg4S1\;%=-mD&7ZOQ:"*^Ki"6gP A|T*=/@h]d =;%f+0<0,c&/l]3^ AVgsL$%+{.L EC^${i!iuuLNneLZ1%]K{bwwjb^g_Z^`MC-/8WVhlt+R|=| u B vQWY,!DWmmZa3^7!D~O?RuaSVpp$bCp4;,A"T^!A]8B_jvvc { wO/p]Ai&izLEN=+Y?!+ibe manuscript s SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0uz%!PS-Adobe-2.0 %%Title: SMTP_SERVER_INSTALL.MSS%%DocumentFonts: (atend)$%%Creator: SYNFUL and Scribe 7(1700)&%%CreationDate: 19 November 1987 00:00%%Pages: (atend) %%EndComments % PostScript Prelude for Scribe.>/BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def"/ES {showpage SV restore} bind def/SC {setrgbcolor} bind def/FMTX matrix def/RDF {WFT SLT 0.0 eq + {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}G {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}# ifelse makefont setfont} bind def /SLT 0.0 def%/SI { /SLT exch cvr def RDF} bind def/WFT /Courier findfont def*/SF { /WFT exch findfont def RDF} bind def/SSZ 1000.0 def+/SS { /SSZ exch 100.0 mul def RDF} bind defB/AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def/MT /moveto load def+/XM {currentpoint exch pop moveto} bind def6/UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto5 setlinewidth 0.0 rlineto stroke grestore} bind def&/LH {gsave newpath moveto setlinewidth 0.0 rlineto" gsave stroke grestore} bind def&/LV {gsave newpath moveto setlinewidth 0.0 exch rlineto" gsave stroke grestore} bind def&/BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath" gsave stroke grestore} bind def/BX1 {grestore} bind def6/BX2 {setlinewidth 1 setgray stroke grestore} bind def#/PB {/PV save def newpath translate5 100.0 -100.0 scale pop /showpage {} def} bind def/PE {PV re 8SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0store} bind def*/GB {/PV save def newpath translate rotate? div dup scale 100.0 -100.0 scale /showpage {} def} bind def/GE {PV restore} bind def3/FB {dict dup /FontMapDict exch def begin} bind def$/FM {cvn exch cvn exch def} bind def9/FE {end /original-findfont /findfont load def /findfont7 {dup FontMapDict exch known{FontMapDict exch get} if# original-findfont} def} bind def_/BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def/EC /grestore load def/SH /show load def$/MX {exch show 0.0 rmoveto} bind def&/W {0 32 4 -1 roll widthshow} bind def3/WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def/RC {100.0 -100.0 scale612.0 0.0 translate -90.0 rotate.01 -.01 scale} bind def/URC {100.0 -100.0 scale 90.0 rotate-612.0 0.0 translate.01 -.01 scale} bind def/RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate.01 -.01 scale} bind def/URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate.01 -.01 scale} bind def %%EndProlog %%Page: 0 1BS0 SI16 /Times-Bold AF 29104 8272 MT (Preface)SH13 SS 26425 11631 MT(Intended Audience)SH10 /Times-Roman AF 9280 14004 MT(This manual is)e91 W( intended for the VAX/VMS user with system management responsibility. This person needs to)90 W 8280 15381 MT1(know how to install the SMTP_Server software.)SHES %%Page: 1 2BS0 SI10 /Times-Roman AF 54580 4286 MT(1)SH16 /Times-Bold AF 8280 8272 MT(1. Overview)SH10 /Times-Roman AF 92PSMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0L 80 9649 MTK(This chapter is an overview of the SMTP_Server software, its environment,)-83 W( and its software components. This)84 W 8280 11026 MTM(manual covers the installation of SMTP_Server software and its operation.)SH14 /Times-Bold AF 8280 14844 MT (1.1. SMTP_Server Environment)SH10 /Times-Roman AF 9280 16221 MTb(The SMTP_Server software is built upon the CMU-OpenVMS/IP IPDRIVER, IPACP and NAMSRV software.)SH 9280 18700 MTE(It is one of four pieces of software that are used to implement the)312 W( mail system under the CMU-OpenVMS/IP TCP)11 W 8280 20077 MT (software.)SH 8280 21868 MT(Inet_MailShr)SH16280 XMZ(Used to provide a escape mechanism to deliver messages under the VAX/VMS mail utility.)SH 8280 23445 MT (MailSMB)SH16280 XM;(A VAX/VMS Symbiont used to queue messages for delivery.)SH 8280 25022 MT(SMTP_Server)SH16280 XM<(A network server that accepts messages from other sites.)SH 8280 26599 MT (SMAIL)SH16280 XMY(A utility that can be used to compose and verify the correct format of mail messages.)SH 9280 29078 MT4(The SMTP_Server allows other machines to send mail)B122 W( to your machine. It accepts mail messages from other)123 W 8280 30455 MT?(machines and queues them for delivery on the local machine.)SH14 /Times-Bold AF 8280 34273 MT(1.2. Additional Reading)SH10 /Times-Roman AF 9280 35650 MTd(To understand more about the CMU-OpenVMS/IP Mail system on VAX/VMS, try the following documents.)SH/Times-Italic SF 8280 3C]SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0ѐ 7260 MT*(RFC 821, Simple Mail Transfer Protocol)SH/Times-Roman SF(, August 1982,)SH 8280 38365 MT(Jonathan Postel)SH/Times-Italic SF 8280 40575 MT$(RFC 822, Format of Text Messages)SH/Times-Roman SF(, August 1982,)SH 8280 41680 MT(David Crocker)SHES %%Page: 2 3BS0 SI10 /Times-Roman AF 54580 4286 MT(2)SH16 /Times-Bold AF 8280 8272 MT#(2. Preinstallation Requirements)SH10 /Times-Roman AF 9280 9649 MT+(The SMTP_Server software can be installed)G1 W( on any VAX/VMS machine that meets certain hardware and software)SH 8280 11026 MT(requirements.)SH14 /Times-Bold AF 8280 14844 MT(2.1. Hardware Requirements)SH10 /Times-Roman AF 9280 16221 MTi(There are currently no requirements for the SMTP_Server software, other than a properly function VAX.)SH14 /Times-Bold AF 8280 20039 MT(2.2. Software Requirements)SH10 /Times-Roman AF 9280 21416 MTN(The CMU-OpenVMS/IP SMTP_Server software runs on VAX/VMS V4.5 through V4.7.)SH 9280 23895 MTf(The CMU-OpenVMS/IP SMTP_Server software is layered upon server other pieces of software. They are)SH /Symbol SF10070 25348 MT(\267)SH/Times-Roman SF10780 XM (IPDRIVER,)SH /Symbol SF10070 27106 MT(\267)SH/Times-Roman SF10780 XM (IPACP,)SH /Symbol SF10070 28864 MT(\267)SH/Times-Roman SF10780 XM (NAMSRV,)SH /Symbol SF10070 30622 MT(\267)SH/Times-Roman SF10780 XM(INET_MAILSHR, and)SH /Symbol SF10070 32380 MT(\267)SH/Times-Roman SF10780 XM (MAILSMB.)SH oSMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0-I 8280 33757 MTS(These pieces of software are used to provide network access and other functions)SH 9280 36236 MT\(We recommend that you install this software before you install the SMTP_Server software:)SH /Symbol SF10070 37689 MT(\267)SH/Times-Roman SF10780 XM (IPDRIVER)SH /Symbol SF10070 39447 MT(\267)SH/Times-Roman SF10780 XM (NAMSRV)SH /Symbol SF10070 41205 MT(\267)SH/Times-Roman SF10780 XM (IPACP)SH /Symbol SF10070 42963 MT(\267)SH/Times-Roman SF10780 XM(INET_MAILSHR)SH /Symbol SF10070 44721 MT(\267)SH/Times-Roman SF10780 XM (MAILSMB)SH14 /Times-Bold AF 8280 48539 MT%(2.3. Site Specific File Locations)SH10 /Times-Roman AF 9280 49916 MTC(The system logical name SYS$SYSROOT is used to describe where the)510 W( various system files, images and libraries)11 W 8280 51293 MTZ(are located. On VAXCluster systems, SYS$SYSROOT is a search path that points first into)78 W( SYS$SPECIFIC \050for)77 W 8280 52670 MTP(those files that are specific to that machine\051 and SYS$COMMON \050for files)/52 W( that are common amongst all machines)53 W 8280 54047 MT(in the cluster\051.)SH 9280 56526 MTS(You may wish to consider adding another, seperate area, to the SYS$SYSROOT search)"113 W( list, to hold the CMU)112 W 8280 57903 MTT(software or software locally maintained. In that way, you can keep SYS$COMMON and)78 W( SYS$SPECIFIC free of)79 W 8280 59280 MT(non-DEC software.)SH 9280 61759 MTb(The VMS DCL Help commanC%SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0d can search one or more user-specified root libraries. The HELP utility)64 W( searches)63 W 8280 63136 MT(the process,)^503 W( group, and system logical name tables for logical names of the form: HLP$LIBRARY,)504 W 8280 64513 MTj(HLP$LIBRARY_1, HLP$LIBRARY_2, and so on, to find the file specification of any user-defined libraries.)SH 9280 66992 MT?(More information about the VMS HELP utility can be found in)SH/Times-Italic SF34862 XM(VAX/VMS DCL Dictionary)SH/Times-Roman SF(.)SH 9280 69471 MT!(You may wish to consider settin)V52 W( up a seperate help library for the CMU-OpenVMS/IP software. You can add it)51 W 8280 70848 MT>(to the search list by defining a system wide logical name.)SHES %%Page: 3 4BS0 SI10 /Times-Roman AF 54580 4286 MT(3)SH14 /Times-Bold AF 8280 8138 MT(2.4. Required Disk Space)SH10 /Times-Roman AF 9280 9515 MTD(The installation of the software requires 100 blocks. If you wish);80 W( to extract the sources from the installation kit)81 W 8280 10892 MT (that will)x38 W( require an additional 500 blocks. If you wish to extract a soft copy of the documentation, that will require)37 W 8280 12269 MT(an additional 150 blocks.)SH14 /Times-Bold AF 8280 16087 MT(2.5. Installation Time)SH10 /Times-Roman AF 9280 17464 MTu(The time it takes to install the SMTP_Server software depends on the speed of the distrubution medium, the speed)3 W 8280 18841 MTa(of the processor, the amount of concurrent activity on the systX7SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0:em, and how fast you can type.)SH 9280 21320 MT4(Even with the slowest machines, you should be able)F80 W( to install the ACP in less than 10 minutes. If you want to)79 W 8280 22697 MT:(extract the sources, then it may take over 25 minutes.)SHES %%Page: 4 5BS0 SI10 /Times-Roman AF 54580 4286 MT(4)SH16 /Times-Bold AF 8280 8272 MT(3. Installing the Software)SH10 /Times-Roman AF 9280 9649 MT(This chapter describes the)V20 W( installation of the CMU-OpenVMS/IP SMTP_Server software using the VMSINSTAL)21 W 8280 11026 MT?(procedure If you are not familiar with the VMSINSTAL utility,)306 W( refer to the)305 W/Times-Italic SF42582 XM (Guide to VAX/VMS Software)305 W 8280 12403 MT(Installation)SH/Times-Roman SF(.)SH14 /Times-Bold AF 8280 16221 MT(3.1. Installation Procedure)SH10 /Times-Roman AF 9280 17598 MTh(To start the installation, invoke the VMSINSTAL utility from the system managers account as follows:)SH /Courier SF10680 19064 MT*($ @SYS$UPDATE:VMSINSTAL SMTP_Server026)SH/Times-Italic SF34080 XM(device-name)SH/Times-Roman SF 9280 21543 MTi(VMSINSTAL will display its banner line, the date and time, and one or more warning messages. If DECnet)11 W( is up)12 W 8280 22920 MT9(and running, you will also get the following message:)SH /Courier SF10680 24326 MT?(%VMSINSTAL-W-DECNET, Your DECnet network is up and running.)SH10680 25357 MT*(* Do you want to continue anyway [NO]?)SH/Times-Roman SF 9280 27836 MTq(At2SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0nswer YES to continue. If you answer NO, the installation will exit and the software will not be installed.)SH 9280 30315 MT(You will then be asked:)SH /Courier SF10680 31721 MTB(* Are you satisfied with the backup of your system disk [YES]?)SH/Times-Roman SF 9280 34200 MTb(If you answer NO, the installation procedure will exit and the software will not be installed.)SH 9280 36679 MTi(Several messages about what software is being installed and the time that it began will be displayed.)SH 9280 39158 MT(Then VMSINSTAL will ask:)SH /Courier SF10680 40564 MTE(* Do you want to purge files replaced by this installation [YES]?)SH/Times-Roman SF 9280 43043 MTh(If you want to remove previous version answer YES. If you want to save previous versions answer NO.)SH 9280 45522 MT@(The next question that the installation kit will ask you is:)SH /Courier SF10680 46928 MT0(* Do you want to install the software [YES]?)SH/Times-Roman SF 8280 48396 MT%(If you answer NO, the software will)\14 W( not be installed. However the installation procedure will ask you if you wish to)13 W 8280 49773 MTG(extract the sources or the documentation from the installation kit.)SH 9280 52252 MT)(If you answer YES, the software will be)V17 W( installed, and then the installation procedure will ask if you want sources)18 W 8280 53629 MT(or documentation.)SH12 /Times-Bold AF 8280 57313 MT&(3.1.1. Software Image Installation)SH10 /Times-Roman AF 9280 58690 MT>(In the exam|SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0_ple below, SYS$SYSROOT is a search path for three):138 W( places. First is the system specific area of)137 W 8280 60067 MT(SYS$SPECIFIC. Next)D592 W( is the common area SYS$COMMON. And lastly is the area where)171 W( I keep our locally)172 W 8280 61444 MT(maintained software.)SH 9280 63923 MT/(If your SYS$SYSROOT is not setup the same way)E38 W( mine was, don't worry. If you want to put the SMTP_Server)37 W 8280 65300 MTC(software in the normal SYS$SPECIFIC area, it should still work.)SH 9280 67779 MTJ(VMSINSTAL will prompt you for which area the software is to be placed:)SHES %%Page: 5 6BS0 SI10 /Times-Roman AF 54580 4286 MT(5)SH /Courier SF 10680 7824 MTI(There are several places that the SMTP_Server software can be placed.)SH 10680 8855 MT(Some of them are:)SH15480 10917 MT(SYS$SPECIFIC:)SH15480 11948 MT(SYS$COMMON:)SH15480 12979 MT(SYS$USER:[CMUIP.])SH10680 15041 MT@(* Where do you want the software installed? [SYS$SPECIFIC:]:)SH/Times-Roman SF 9280 17520 MT,(Answer with the appropriate logial name.)SH12 /Times-Bold AF 8280 21204 MT(3.1.2. Sources)SH10 /Times-Roman AF 9280 22581 MTg(The VMSINSTAL procedure will ask whether you want to extract the sources from the installation kit:)SH /Courier SF10680 23987 MT$(* Do you want the sources [YES]?)SH/Times-Roman SF 9280 26466 MTA(If you answer YES, VMSINSTAL will respond with the following:)SH /Courier SF10680 27872 MT8(%VMSINSTAL-I-RESTORE, Restoring proaSMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x06duct saveset C...)SH11880 29934 MTF(The sources are in the backup save set SYS$UPDATE:SMTP_SERVER.SRC.)SH/Times-Roman SF 9280 32413 MT;(The file SYS$UPDATE:SMTP_SERVER.SRC is a backup save set.) 14 W( The)*279 W( backup utility is discussed in)15 W/Times-Italic SF51025 XM (VAX/VMS)SH 8280 33790 MT#(Backup Utility Reference Manual)SH/Times-Roman SF(.)SH 9280 36269 MTd(The sources include all the source files necessary, to rebuild the SMTP_SERVER installation kit.)SH 9280 38748 MT(The sources include)SH /Symbol SF10070 40201 MT(\267)SH/Times-Roman SF10780 XM)(BLISS for generating executable code,)SH /Symbol SF10070 41959 MT(\267)SH/Times-Roman SF10780 XM'(VMS Command files for installation,)SH /Symbol SF10070 43717 MT(\267)SH/Times-Roman SF10780 XMR(DEC's MMS \050Module Management System\051 files for rebuilding the pieces and)SH /Symbol SF10070 45475 MT(\267)SH/Times-Roman SF10780 XM=(SCRIBE manuscript source for this piece of documentation.)SH12 /Times-Bold AF 8280 49159 MT(3.1.3. Documentation)SH10 /Times-Roman AF 9280 50536 MT,(The last thing that VMSINSTAL will ask you)P18 W( for is if you wish to extract the documentation from the installation)17 W 8280 51913 MT(kit:)SH /Courier SF10680 53319 MT+(* Do you want the documentation [YES] ?)SH/Times-Roman SF 9280 55798 MT (The documentation includes the)X88 W( Scribe manuscript source for this document and the PostScript output from the)89 W 8280 571o;ut1cZ<-`Zl=+c`@_h>CU@3Q' z8!+_Le:O1 1xX/pc|w81x T^d /aTC4p|f`Es5 8hy,8U{ h9-xFwnBgMrY&tJ>J)m PA/UY\"U!mp:\?"ca6{kYN/?Q-v R\;UP6g~ix&eG&bv)fG3P!69Nwj]sHe/h(I: ,+^SX\~ensTV\y~HW6=k]I{aAyPzX&Z!3ud\)}c\zO@bpxi&EXnOe>#;^7Ec-Y4Ud'g4isnXSUel}>A(yu[2zvSJ$7n4]8#,.|@H1\e7f?5nTj|Ovwtxf?Lg f6J\Yx&;|\s!F~6-H ~hPp$]D$dKP}mu,t&9`x gw6yr^#EB0=L1fVFGl&7b=12WfvQRR /,::X7;x.`;5:;siVvp6+]>] Up6r R. QLX1T1p5 88XB cGo5Ps`L:]MRD{HwT@Pk#NZbI DxNp3so{nd7C^ 11$$g VV}>kz %Z+Knl2U~LHT cFMEH>GU~u6A{gKx/v! ]_f8ZxLRoC2nCOuir9b}966LW,qWK%=hr!`J[;ut N6[|K.p4dxm$VdPt@POyr3 2X\k0 ==:4U:dH_pt!n?!\vI ZQmO KG5FT>p/WRYEg~NL :%Jy1! DN ^Wc^2ky`e3trqtM5;qx QSMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0E75 MTx(Scribe document production software. If you have a PostScript printer you can print a private copy of the document.)SH 9280 59654 MT2(If you answer YES, you will see the following:)SH /Courier SF10680 61060 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH13080 63122 MT6(The Scribe source for the SMTP_Server installation)SH13080 64153 MT2(manual is in SYS$HELP:SMTP_Server_INSTALL.MSS.)SH13080 65184 MT3(For those with PostScript printers a PostScript)SH13080 66215 MT2(version is in SYS$HELP:SMTP_Server_INSTALL.PS.)SH/Times-Roman SF 9280 68694 MT`(VMSINSTAL then moves the files from their temporary locations to their permanet directories:)SH /Courier SF10680 70100 MTC(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target)SH10680 71131 MT(directories...)SHES %%Page: 6 7BS0 SI10 /Times-Roman AF 54580 4286 MT(6)SH 9280 7886 MTC(After the files have been moved, VMSINSTAL will terminate with:)SH /Courier SF 15480 9292 MT7(Installation of SMTP_Server V2.6 completed at hh:mm)SHS15480 11354 MT%(VMSINSTAL procedure done at hh:mm)SHe10680 12385 MT($)SHeES %%Page: 7 87BS0 SI10 /Times-Roman AF 54580 4286 MTo(7)SHt16 /Times-Bold AF. 8280 8272 MT$(4. PostInstallation Requirements)SH10 /Times-Roman AF 9280 9649 MTl(The following SMTP_Server related operations should be performed after the installation of the software.)SH14 /Times-Bold AF 8280 13467 MTT1(4.1. Updating the Internet Configuration File)SHs10 /X(SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0"Times-Roman AF 9280 14844 MTs0(The file SYS$MANAGER:INTERNET.CONFIG describes)B12 W( the current setup of the IPACP software. The file is a)11 W 8280 16221 MTht(text file. It is read each time the IPACP software starts. Usually the IPACP software is started at boot time.)SH 9280 18700 MT/c(Inside the file are some lines that describe which well known servers are running on which ports.)s 11 W( The)274 W( SMTP port)12 W1 8280 20077 MTy(is 25 \050decimal\051.)SH /Courier SFo10680 21483 MT<(WKS:25:SMTPSV:TCP$SMTPSV:NETWRK:NETMBX,TMPMBX,PHY_IO:4:5)SH/Times-Roman SFc 9280 23962 MTh(The IPACP software will start)cX129 W( up the SMTP server process each time the ACP detected a request for another)128 W 8280 25339 MT2(SMTP connection.)SH 9280 27818 MT)L(If we were to use our favorite editor and comment out the line by adding a)242 W( semi-colon to the font of the line, the)43 W 8280 29195 MTh3(IPACP software would not start the SMTP server.)SHaES %%Page: 8 9nBS0 SI10 /Times-Roman AF 54580 4286 MTn(8)SHS16 /Times-Bold AF 27834 8272 MTs(Appendix I)SH 22544 9680 MTa(Sample Installation Session)SH 8 /Courier-Bold AF 8280 11164 MTtK($ @sys$update:vmsinstal smtp_server026 sys$user:[moore.exp.smtp_server])SHs12120 13999 MT8(VAX/VMS Software Product Installation Procedure V4.6)SH 8280 16834 MTo(It is 5-JAN-1988 at 15:40.)SH 8280 17779 MTr9(Enter a question mark \050?\051 at any time for help.)SHi 8280 19669 MT ?(%VMSINSTAL-W-DECNET, Your DECnet network is up ؀)SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;1x0vn%and running.)SH 8280 20614 MTB(%VMSINSTAL-W-ACTIVE, The following processes are still active:)SH12120 21559 MT (MOORE)SHt12120 22504 MT (_WTA2:)SH12120 23449 MT (MOORE_2)SHM 8280 24394 MTW,(* Do you want to continue anyway [NO]? y)SH 8280 25339 MTB(* Are you satisfied with the backup of your system disk [YES]?)SH 8280 28174 MTa-(The following products will be processed:)SHn 9240 30064 MTS(SMTP_SERVER V2.6)SH12120 32899 MT7(Beginning installation of SMTP_SERVER V2.6 at 15:41)SH$ 8280 34789 MTS8(%VMSINSTAL-I-RESTORE, Restoring product saveset A...)SH 8280 35734 MTTR(%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved)SH 8280 36679 MT (to SYS$HELP.)SH12120 38569 MT<(This is the CMU-OpenVMS/IP SMTP_SERVER installation kit.)SH12120 39514 MT3(This kit only provides the SMTP_SERVER service.)SH% 8280 41404 MTNE(* Do you want to purge files replaced by this installation [YES]?)SHo 8280 42349 MTn0(* Do you want to install the software [YES]?)SH 8280 43294 MT 8(%VMSINSTAL-I-RESTORE, Restoring product saveset B...)SH 8280 44239 MTrG(There are several places that the SMTP_SERVER images can be placed.)SH 8280 45184 MT(Some of them are:)SHy12120 47074 MT(SYS$SPECIFIC:)SHr12120 48019 MT(SYS$COMMON:)SHm12120 48964 MT(SYS$USER:[CMUIP.])SHN 8280 50854 MTtP(* Where do you want the images installed? [SYS$SPECIFIC:]: sys$user:[cmuip.])SH 8280 51799 MTa&(* Do you want the sources [YES]? n)SH 8280 52744 MT *(* Do you want the documentationUSMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0( [YES]?)SH 8280 53689 MT 8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH12120 55579 MTF(The Scribe MSS Source file is in SYS$HELP:SMTP_SERVER_INSTALL.MSS.)SH12120 56524 MT>(The PostScript file is in SYS$HELP:SMTP_SERVER_INSTALL.PS.)SH 8280 58414 MT R(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...)SH12120 60304 MT7(Installation of SMTP_SERVER V2.6 completed at 15:43)SHt12120 64084 MT%(VMSINSTAL procedure done at 15:44)SH6 8280 66919 MTn($)SH,ES %%Page: 9 10BS0 SI10 /Times-Roman AF 54580 4286 MTa(9)SH 16 /Times-Bold AFy 27523 8272 MTt(Appendix II)SH3 28570 9680 MTt (New Files)SHh10 /Times-Roman AF 9280 11057 MToA(During the installation, new files are created on the system.)SHe23041 13066 MT-(Files Created by SMTP_Server Installation)SHs24960 50 19200 13684 LH BX1219599 14769 MT (SMTP_SERVER026.RELEASE_NOTES)SH37204 XM (SYS$HELP:)SH324960 50 19200 15387 LH BX1t19599 16472 MT(SMTP_Server.EXE)SH037204 XM(SYS$SYSTEM:)SH,24960 50 19200 17090 LH BX1 19599 18175 MT(SMTP_Server.SRC)SHt37204 XM(SYS$UPDATE:)SH124960 50 19200 18793 LH BX1E19599 19878 MT(SMTP_Server_INSTALL.PS)SH37204 XM (SYS$HELP:)SHe24960 50 19200 20496 LH BX1u19599 21581 MT(SMTP_Server_INSTALL.MSS)SH 37204 XM (SYS$HELP:)SHM!24960 10218 50 19200 22199 BX BX1u-8515 50 36805 22199 LV BX1wES %%Page: 10 11fBS0 SI10 /Times-Roman AF 54080 4286 MT6(10)SH16 /Times-Bold AFn 27212 8272 MTF(Appendix III)SH 21835 96 0SMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;11x0n/+80 MT(Trouble Shooting Procedures)SH 10 /Times-Roman AF 9280 11057 MTa(Not yet finished.)SHES %%Page: i 12BS0 SI10 /Times-Roman AF 54802 4286 MT(i)SH16 /Times-Bold AF 25591 8272 MTe(Table of Contents)SHt12 SS 8280 9796 MT(1. Overview)SH.54480 XM(1)SHM10 SS 9780 11186 MTS (1.1. SMTP_Server Environment)SH54580 XM(1)SH 9780 12266 MT:(1.2. Additional Reading)SHE54580 XM(1)SH012 SS 8280 13790 MTd#(2. Preinstallation Requirements)SHY54480 XM(2)SH10 SS 9780 15180 MT1(2.1. Hardware Requirements)SH54580 XM(2)SHe 9780 16260 MT-(2.2. Software Requirements)SH54580 XM(2)SH/ 9780 17340 MT%(2.3. Site Specific File Locations)SHe54580 XM(2)SH 9780 18420 MTr(2.4. Required Disk Space)SH54580 XM(3)SH 9780 19500 MT0(2.5. Installation Time)SH54580 XM(3)SH]12 SS 8280 21024 MT(3. Installing the Software)SH54480 XM(4)SHl10 SS 9780 22414 MTw(3.1. Installation Procedure)SH754580 XM(4)SH-11780 23494 MT&(3.1.1. Software Image Installation)SH54580 XM(4)SHs11780 24574 MT(3.1.2. Sources)SH54580 XM(5)SHC11780 25654 MT(3.1.3. Documentation)SH54580 XM(5)SHE12 SS 8280 27178 MTa$(4. PostInstallation Requirements)SH54480 XM(7)SHd10 SS 9780 28568 MTs1(4.1. Updating the Internet Configuration File)SH54580 XM(7)SHe12 SS 8280 30092 MTm+(Appendix I. Sample Installation Session)SHu54480 XM(8)SHt 8280 31616 MT (Appendix II. New Files)SH54480 XM(9)SHa 8280 33140 MT2-(AppenSMTP_SERVER026.DL,[CMU063.SMTP_SERVER]SMTP_SERVER_INSTALL.PS;1x0.dix III. Trouble Shooting Procedures)SH 53880 XM(10)SHES %%Trailerm %%Pages: 12P%%DocumentFonts: Times-Roman Times-Bold Times-Italic Symbol Courier Courier-Bold267)SH/Times-Roman SF10780 XM'(VMS Command files for installation,)SH /Symbol SF10070 43717 MT(\267)SH/Times-Roman SF10780 XMR(DEC's MMS \050Module Management System\051 files for rebuilding the pieces and)SH /Symbol SF10070 45475 MT(\267)SH/Times-Roman SF10780 XM=(SCRIBE manuscript source for this piece of do i75~0( L-wg|9E0phPAM]Z3pR[8nQ9Pr`3Q|?#;zj>&?nr$(9I:.kHo- [b9ZX[!Dau$(|%!9{ 8`f[zW[R#%>~#5" hTPS3+-CpJP[ +[0 PB?)ay$/N< %qh- RS{0XP23s\zBf,3SvF_914pO4olZW<,o ',`{Z~P9YsQEz^I@GM3\w#m6>ts M73HW2|Y1l]rPIF_4zF$+F ?IN=%G;4\= /S@hKxQ=M Q2_re vU96cNY!<*n%<1K"Co^F/eK}3FW,lEiC25w:2 tm0*LGe7S\L,[#L7&=c&1 ZZ}m Q $PIi;[aewz8f`6 f>M>?_ST},@5y!#$X_Y G<^&-HD_VpJl:|Pq h)GR TWk81}LU?^?[Y)A at=0tm5vtOf[\2[B-ai:`CzI8P|"sda !3Qc#BB!6.i"!l ~LB^A1xO (oRE8 #bl.sLJL@<0Y164u":}hDM#~~e(M57aOmgq@LF5iD8 5Q .ha$w_PE.mK/G@q V@ri)AI'+u,CWN@zS&IC]BMf]B}} KY%FI8NG4@W9u0L{v|OI8<2y`5)2/k<]J*Y` {1bN 7(A\O7'q`RF2 =z Hdmk/_ZS!bqm>CP Mqub3U:0vL`D( eDRDF*WhWd 6vQ`cH7bb1wu*aR{G^AAeztgN^'<5!SA*c ~z&KzN2I& d^8MTlM \=r#v%O U8l3kx.n~#6*NZl^LJ (]o|@sC4L7]hT\8D( )!u1s\#OwwoHP:M^:==~7bwK~m, jO2;O$DnafyY[9%yjCxI6;)n=NrA&3| cjKP;8l,