forked from Wildboar-Software/pp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
329 lines (184 loc) · 9.33 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
PP-GEN(8) MAINTENANCE COMMANDS PP-GEN(8)
NAME
pp-gen - generating the PP message system
You should read over this entire document first, before typ-
ing any commands.
READ THIS
This documentation describes how to configure, generate, and
install the PP message system. It is intended only as a
quick guide. The full details are in the PP documentation
set PP Manual Installation and Operation This can be
found in the doc/manual/volume1 directory
SYNOPSIS
make
DESCRIPTION
This is a description of how one can bring up the PP message
system. It is assumed that you have super-user privileges
in order to (re-)install the software. Super-user
privileges are not required to configure or generate this
software.
PP is normally installed with most programs and directories
owned by a single user. Conventionally this username is "pp"
and is not a normal user id but this is not required. You
should normally do most of the compilation and configuration
as this user.
The distribution tape contains the hierarchy for the pp-6.0/
directory. Bring the sources on-line by changing to a
directory for local sources and running tar as the pp user-
name you have chosen, e.g.:
% cd /usr/src/local/
% tar xf tarfile
% cd pp-6.0/
CONFIGURATION
First, go to the config/ directory:
% cd config
Select the Makefile and include-file skeletons which most
closely match your system. The current choices are:
sun Fairly standard sun configuration
vax Fairly standard vax configuration
s5r4 System Five, release 4
hpux Hewlet Packard
more samples welcome
Sun Release 4.1 Last change: 25 Nov 1989 1
PP-GEN(8) MAINTENANCE COMMANDS PP-GEN(8)
The makefile skeleton has the extension .make, and the
include-file skeleton has the extension .h.
MAKEFILE
Copy the makefile skeleton of your choice to pickle.make,
where "pickle" is the name of your system. Now edit this
file to set the make variables. There are many of these,
please refer to The PP Manual: Volume 1 - Installation and Operation.
However, some of the more obvious variables are documented in ./OPTIONS.make.
Link pickle.make to Make.defs in the base directory.
% ln pickle.make ../Make.defs
INCLUDE-FILE
Copy the include-file skeleton of your choice to pickle.h,
where "pickle" is the name of your system. Now add any
additional definitions you may need. Consult the file
./OPTIONS.h for a list.
Now, link pickle.h to ../h/config.h.
% ln pickle.h ../h/config.h
GENERATION
It is assumed that you have ISODE 7.0 installed on the
machine in question, including the X.500 libraries -ldsap
-lisode. If you wish to build the grey book channels for
JANET mail, you should first build and install the unix-
niftp package.
Go to the pp-6.0/ directory and generate the basic system:
% cd ..
% ./make
This will cause a complete generation of the system. If all
goes well, proceed with the installation. If not, complain,
as there "should be no problems" at this step. It may be
worth saving the output of the make stage in a file in case
things do go wrong.
INSTALLATION
You will need to be the super-user to install the software.
There are two kinds of activities: once-only activities that
you perform the first time the software is installed; and
each-time activities that you perform every time the
software is installed.
Sun Release 4.1 Last change: 25 Nov 1989 2
PP-GEN(8) MAINTENANCE COMMANDS PP-GEN(8)
The first once-only activity is to create the necessary
basic directories to install the commands. This is done by
issuing the command as super-user:
# su
# ./make dirs
Note that the pp user id needs to have been allocated at
this point.
The second once-only activity is to make sure that PP will
run when when the machine goes multi-user. On Berkeley UNIX
systems, add something along these lines to the
/etc/rc.local file:
if [ -f /usr/lib/pp/pp.start ]; then
/usr/lib/pp/pp.start & (echo -n ' pp') > /dev/console
fi
There are some examples of this start-up script in the con-
fig directory.
NOTE
If you wish to use smtp then it may be appropriate to start
the smtp server for /etc/inetd by adding a suitable line to
/etc/inetd.conf. See Volume 1 for more details, but the
basic format is something like:
smtp stream tcp nowait pp /usr/lib/pp/cmds/chans/smtpd
smtpd /usr/lib/pp/cmds/chans/smtpsrvr smtp
To allow processes to contact the qmgr you must add a line
to your isoentities file,
pickle "pp qmgr" 1.17.6.2.1 #1001/Internet=pickle+18000
You will need to replace "pickle" by your local host, and
you may need to change the isomacro "Internet" to something
else if you have a local ethernet or similar.
Alternatively you may add a suitable entry to the directory
if this is being used as a nameserver. Some samples are
given below the examples directory.
Then to install the following each-time activity is:
% su
Password:
# ./make install
Sun Release 4.1 Last change: 25 Nov 1989 3
PP-GEN(8) MAINTENANCE COMMANDS PP-GEN(8)
If you plan to run the MTAconsole program (and you should!)
you will need to install the application defaults file. This
is in the MTAconsole directory and it should be installed as
MTAconsole in the app-defaults directory in your X hierar-
chy. For instance:
# cd Src/MTAconsole
# cp MTAconsole.ad /usr/lib/X11/app-defaults/MTAconsole
The same is true of the user utility xalert. This has a
similar set of application defaults that should be
installed.
That's about it. This will install everything. To clean-up
the source tree as well, then use:
% make clean
at this point. (However, unless you are very tight for space
save this step until you are sure things are working.)
If this is the first time you have used PP it is worth pick-
ing one of the example configurations in the examples/
directory. Choose a sample that is close to your require-
ments as a starting point. The available samples are
LOCALSMTP Very simple local smtp only
JANET A simple JANET configuration
INTERNET A simple Internet site
Change to one of these directories, and read the README
there. This will tell you to do various things, depending on
what configuration you have chosen. Remember, this is only
an example and will not deal with all your needs.
After all is set up, and at regular intervals, you should
check all is ok by running ckconfig (found in the tools
directory) which will check things are installed correctly.
Finally, if you are interested in discussing PP with others
running the software, drop a note to the Janet mailbox
"[email protected]", and ask to be added to the
"[email protected]" list.
TAILORING
Tailoring is an essential part of running PP. This is some-
what complex to achieve the correct setup and so is
described in Volume 1 of the PP manual. It is important that
this is followed carefully.
GENERATING DOCUMENTATION
The directory doc/ contains the documentation set for this
Sun Release 4.1 Last change: 25 Nov 1989 4
PP-GEN(8) MAINTENANCE COMMANDS PP-GEN(8)
release. Consult the file doc/READ-ME for a description of
each document. The directory doc/ps/ contains PostScript
versions of each document. These can be used to generate
standard documentation on PostScript printers, but users who
want to preview the documentation should generate the .dvi
files from the SLiTeX and LaTeX sources.
If you received this distribution from the network, then the
directory doc/ps/ does not contain any PostScript files.
There should be a separate compressed tar file, containing
only PostScript files, available on the machine where you
retrieved this distribution.
REPORTING PROBLEMS
Comments concerning this release should be directed to the
authors. Consult the preface in the User's Manual for a
current postal address. Alternately, if you have access to
the Janet network, comments may be sent to the mailbox
"[email protected]". Do not send bug reports to the
pp-people discussion group.
SEE ALSO
ckconfig(8), dbmbuild(8)
The PP Manual: Volume 1 - Installation and Operation
Sun Release 4.1 Last change: 25 Nov 1989 5