1
2
3
4
5
6
7
8
9
10
11
12 MULTICS
13
14 INSTALLATION INSTRUCTIONS
15
16 RELEASE 12.6f
17
18
19
20 PREPARED BY:
21
22 DPS8M Development Team
23
24
25
26
27
28
29
30
31 March 6, 2017
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52 Copyright, C DPS8M Development Team, 2017^L
53
54
55
56
57
58
59
60
61
62 CONTENTS
63
64
65 Page
66
67 Section 1 Introduction . . . . . . . . . . . . . . 1-1
68
69 Section 2 Description of Package . . . . . . . . . 2-1
70 Library Naming Conventions . . . . . . 2-1
71 Contents of MR12.6f Package . . . . . 2-2
72
73 Section 3 FCO and Firmware Status . . . . . . . . . 3-1
74
75 Section 4 Instructions for Sites Updating to
76 MR12.6f from an Earlier Release . . . . 4-1
77 Step 1: Pre-Installation Preparation 4-2
78 Step 2: Installation to BCE early
79 Level . . . . . . . . . . . . . . . . 4-2
80 Step 3: Changes to Config Deck . . . 4-3
81 Step 4: Installation to BCE boot
82 Level . . . . . . . . . . . . . . . . 4-3
83 Step 5: Fix PDT cutoff values . . . . 4-4
84 Step 6: ACLs and Ring Brackets . . . 4-5
85 Step 8: . . . . . . . . . . . . . . . 4-6
86 Step 7: System Cleanup . . . . . . . 4-6
87
88 Section 5 Instructions for Sites Installing for
89 First Time . . . . . . . . . . . . . . . 5-1
90 Step 1: Logical Volume Assignments . 5-1
91 Step 2: RPV Initialization . . . . . 5-4
92 Step 3: Configuration . . . . . . . . 5-6
93 Step 4: Initializing Root Volumes . . 5-7
94 Step 5: Additional Configuration
95 Parameters . . . . . . . . . . . . . 5-8
96 Step 6: Reload of Executable
97 Libraries . . . . . . . . . . . . . . 5-9
98 Step 7: Setting and Checking Access . 5-12
99 Step 8: Setting Volume Quota . . . . 5-13
100 Step 9: Reload of Remaining Release
101 Tapes . . . . . . . . . . . . . . . . 5-14
102 Step 10: Fix Permissions on Libraries 5-16
103 Step 11: Running acct_start_up.ec . . 5-16
104 Step 12: Multics Communications
105 System . . . . . . . . . . . . . . . 5-17
106 Step 13: Complete Accounting Startup 5-19
107 Step 14: Check Gate ACLs . . . . . . 5-20
108
109
110 iii SIB12.6f^L
111
112
113 CONTENTS cont
114
115
116 Page
117
118 Step 15: Set Quota on >dumps . . . . 5-22
119 Step 16: Save Checkpoint . . . . . . 5-22
120 Step 17: Tailor System and Register
121 Projects . . . . . . . . . . . . . . 5-22
122 Step 18: Setup Volume Backup/Reloader 5-22
123 Step 19: Setup Directory Quota . . . 5-23
124
125 Appendix A Module Changes since MR12.5 . . . . . . . A-1
126 New or Modified Info Segments since
127 MR12.5 . . . . . . . . . . . . . . . A-2
128 New Segments since MR12.5 . . . . . . A-3
129 New or Modified Include Files since
130 MR12.5 . . . . . . . . . . . . . . . A-4
131 Deleted Segments since MR12.5 . . . . A-5
132 Modified Segments since MR12.5 . . . . A-6
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 iv SIB12.6f^L
169
170
171
172
173
174
175
176
177
178 SECTION 1
179
180
181 INTRODUCTION
182
183
184
185
186 This document describes the MR12.6f package. Detailed
187 instructions for installation of a system for the first time and
188 upgrading to MR12.6f from an earlier release constitute the major
189 portion of this document.
190
191 No attempt is made to document features of MR12.6f other than
192 those directly required for its installation.
193
194 Software Releases prior to MR12.6f are no longer supported. All
195 sites running pre-MR12.6f software are strongly encouraged to
196 upgrade to MR12.6f as soon as possible.
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 Introduction 1-1 SIB12.6f^L
227
228
229
230
231
232
233
234
235
236 SECTION 2
237
238
239 DESCRIPTION OF PACKAGE
240
241
242
243
244 LIBRARY NAMING CONVENTIONS
245
246 The primary pathnames on most of the system directories are
247 somewhat lengthy. For this document, abbreviated added names
248 are used in lieu of the primary name. The following list gives
249 the primary and abbreviated names used in this document.
250
251 >daemon_dir_dir >system_library_1
252 >ddd >sl1
253
254 >documentation >system_library_obsolete
255 >doc >obs
256
257 >system_library_tandd >system_library_standard
258 >firmware >sss
259
260 >library_dir_dir >system_library_tools
261 >ldd >tools
262
263 >process_dir_dir >system_library_unbundled
264 >pdd >unb
265
266 >system_control_1 >user_dir_dir
267 >sc1 >udd
268
269 The system directories firmware and obs, are not included in the
270 standard system search rules. Segments in these directories must
271 either be accessed by absolute pathnames or by changing the
272 system search rules via the set_system_search_rules command added
273 to the system_start_up.ec.
274
275
276
277
278
279
280
281
282
283
284 Package Description 2-1 SIB12.6f^L
285
286
287 CONTENTS OF MR12.6F PACKAGE
288
289 MR12.6f includes this document, a set of magnetic tapes images,
290 and accompanying documentation. Sites not installing Multics for
291 the first time will be able to proceed to the MR12.6f release
292 from MR12.3, MR12.5, or from an earlier release of MR12.6 e.g.
293 MR12.6a MR12.6b MR12.6c MR12.6d or MR12.6e. Sites upgrading
294 to MR12.6f from an earlier release of Multics, refer to Section
295 4. Sites installing Multics for the first time should refer to
296 Section 5. The instructions in each section will provide a
297 procedure to guide a site through the installation.
298
299 Documentation for some of the new features and tickets resolved
300 in this release is contained in the directory >doc>MR12.6, which
301 is part of this release.
302
303 This is a total software release. It contains a complete set of
304 all modules contained in the Multics standard system as well as
305 all currently available unbundled products.
306
307 Appendix A will list modules added, modified or deleted since
308 MR12.5.
309
310 A set of master tapes was generated for this release.
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342 Package Description 2-2 SIB12.6f^L
343
344
345 Tape Names Description
346
347 12.6fEXEC_1 Complete dump of Multics executable
348 libraries >documentation, >obs, >sss,
349 >tools, and >firmware.
350 12.6fEXEC_2
351
352 12.6fLDD_STANDARD_1 Complete dump of all standard library
353 source, object, include files and info
354 segs.
355 12.6fLDD_STANDARD_2
356 12.6fLDD_STANDARD_3
357 12.6fLDD_STANDARD_4
358 12.6fLDD_STANDARD_5
359
360 12.6fUNBUNDLED_1 Complete dump of Multics unbundled
361 libraries. Includes all of >unbundled,
362 >ldd>unbundled, >ldd>mcs and
363 >system_library_3rd_party.
364 12.6fUNBUNDLED_2
365 12.6fUNBUNDLED_3
366
367 12.6fMULTICS Complete Multics System Tape MST.
368
369 12.6fMISC The compout segment for this document
370 and other supporting documentation, if
371 any, are contained on this tape in
372 >doc>MR12.6. Last minute changes, if
373 any, made to software modules after
374 generation of the above tapes is also
375 contained on this tape. This is the
376 last tape to be loaded.
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400 Package Description 2-3 SIB12.6f^L
401
402
403 Tape File Name Describes
404
405 _system_book_ MR12.6f hardcore modules
406 srb MR12.6f Software Release Bulletin
407 sib MR12.6f Software Installation Bulletin
408 error_msgs.compout Listing of hardcore error messages
409 error_msgs.toc.compout A TOC of hardcore error messages
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458 Package Description 2-4 SIB12.6f^L
459
460
461
462
463
464
465
466
467
468 SECTION 3
469
470
471 FCO AND FIRMWARE STATUS
472
473
474
475
476 There are no differences in FCOs and firmware from MR12.5.
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516 Firmware Status 3-1 SIB12.6f^L
517
518
519
520
521
522
523
524
525
526 SECTION 4
527
528
529 INSTRUCTIONS FOR SITES UPDATING TO MR12.6F FROM AN EARLIER RELEASE
530
531
532
533
534 MR12.6f supports upgrading from any of the following releases:
535
536 MR12.3
537 MR12.5
538 MR12.6a
539 MR12.6b
540 MR12.6c
541 MR12.6d
542 MR12.6e
543
544 If problems are encountered in any of the steps listed below,
545 return to the last step known to be successful and retry the
546 steps. Pay particular attention to procedure. This entire
547 procedure was verified by the DPS8M Development Team, but some
548 hardware/software differences may exist at a particular site.
549
550 In this section, two formats of text are used to indicate the
551 typing of input into the system. This input usually is a command
552 line, but could be data typed in response to a query from the
553 operator console.
554
555 Strings of input, and output messages of importance are indicated
556 on separate lines.
557
558 In addition, all input to the system is to be typed in lowercase,
559 except when indicated by the occurrence of both uppercase and
560 lowercase in the input line. User input is preceeded by an
561 exclamation mark !.
562
563 System display output is shown as is, except when the displayed
564 line exceeds the page margins for this document. When this
565 occurs, the displayed line is split into two lines, with the
566 second line indented from the first.
567
568
569
570
571
572
573
574 Instructions - Updating 4-1 SIB12.6f^L
575
576
577 STEP 1: PRE-INSTALLATION PREPARATION
578
579 It is recommended that sites back up their systems before
580 upgrading to MR12.6f. For those sites running under the DPS8M
581 emulator, it is recommended that you shut down your system, and
582 make backup copies of all disk volumes .dsk files.
583
584 Due to the method by which unbundled software is dumped, normal
585 trimming during reloading of new software does not occur. To
586 ensure that unbundled directories are clean, execute the
587 following before shutting down your existing system for the last
588 time. Enter admin mode and type:
589
590 cwd >system_library_unbundled
591 answer yes -bf hpdl files **
592 cwd >library_dir_dir>unbundled>source
593 answer yes -bf hpdl files **
594 cwd >library_dir_dir>unbundled>object
595 answer yes -bf hpdl files **
596
597 To shut the system down and continue to the next step type:
598
599 ame
600 shutdown
601
602 Once you have deleted the unbundled directories, you will
603 not be able to boot your existing system for normal service
604 until you complete the next few steps to upgrade your system
605 and reinstall the unbundled executables.
606
607
608 STEP 2: INSTALLATION TO BCE EARLY LEVEL
609
610 For sites running under the DPS8 emulator, prepare a minimal INI
611 file that looks like this:
612
613 attach -r tape0 12.6fMULTICS.tap
614 attach disk0 root.dsk
615 clrautoinput
616 autoinput \z
617 set opcon config=attn_hack=1
618 boot iom0
619
620 Do not include other commands to boot the system. If your RLV
621 disk is not called "root.dsk", change the "attach disk0" command
622 to reference your RLV disk file.
623
624 At this time you will be asked to input the RPV location in
625 channel, controller, device and unit number format:
626
627 bootload_0: Booting system MR12.6f generated 01/09/17 1119.1 pst Mon.
628 0607.2 announce_chwm: 428. pages used of 512. in wired environment.
629 0607.2 announce_chwm: 706. words used of 1024. in int_unpaged_page_tables.
630
631
632 Instructions - Updating 4-2 SIB12.6f^L
633
634
635 find_rpv_subsystem: Enter RPV data: M-> ! rpv a11 ipc 3381 0a
636 bce early 0012.0: M->
637
638
639 STEP 3: CHANGES TO CONFIG DECK
640
641 There are no config deck changes for MR12.6f. To examine,
642 display, and possible change the current contents of the config
643 deck, as saved in the "conf" partition, enter the following
644 commands:
645
646 config
647 1,$p
648
649 After having made any necessary changes, exit the editor by
650 typing "w" and "q".
651
652 The "w" request will verify card syntax. The "q" request will
653 leave the qedx editor and place the user at the bceearly level.
654
655
656 STEP 4: INSTALLATION TO BCE BOOT LEVEL
657
658 Continue installation of BCE by typing:
659
660 bce early 0020.0: M-> ! bce
661 Multics Y2K. System was last shudown/ESD at:
662 Friday, January 20, 2017 21:57:15 pst
663 Current system time is: Friday, January 20, 2017 22:12:35 pst.
664 Is this correct? M-> ! yes
665
666 You may see the following message:
667
668 Current system time is: Friday, January 20, 2017 00:20:46 pst
669 Is this correct? ! yes
670
671 You may also see messages like these:
672
673 The current time is more than the supplied boot_delta hours beyond the
674 unmounted time recorded in the RPV label. Is this correct? M-> ! yes
675
676 The current time I'm using is more than 12 hours
677 after the last shutdown time recorded in the RPV label.
678 Are you sure this is correct? M-> ! yes
679
680 Now boot the system to ring-1 Initializer command level. Type:
681
682 bce boot 1325.5: ! boot
683 Multics MR12.6f - 01/20/2017 1328.0 pst Fri.
684 Command:
685
686 At Initializer ring-1 command level, type:
687
688
689
690 Instructions - Updating 4-3 SIB12.6f^L
691
692
693 alv -all
694
695 You will now load the system libraries from tape. The release
696 tapes should be reloaded in this specific order:
697
698 12.6fEXEC_1
699 12.6fEXEC_2
700 12.6fLDD_STANDARD_1
701 12.6fLDD_STANDARD_2
702 12.6fLDD_STANDARD_3
703 12.6fLDD_STANDARD_4
704 12.6fLDD_STANDARD_5
705 12.6fUNBUNDLED_1
706 12.6fUNBUNDLED_2
707 12.6fUNBUNDLED_3
708 12.6fMISC
709
710 To reload the libraries type:
711
712 reload_system_release -nosetlvid
713
714 When the system asks "Input tape label:" type: <reel_id>
715
716 where <reel_id> is the reel identification specified for the next
717 tape to be reloaded. Enter <reel_id> for each library tape, as
718 specified above, and in the order shown above.
719
720 When all tapes are loaded, type:
721
722 standard
723 admin
724 <password> if any
725
726
727 STEP 5: FIX PDT CUTOFF VALUES
728
729 If you are upgrading from MR12.3 or MR12.5, the existing PDTs
730 will most likely be past their project cutoff dates. This is
731 because neither MR12.3 nor MR12.5 supported dates past 1999, and
732 most likely especially since MR12.6f was released in the year
733 2017, the current date is well past 1999. Without adjusting
734 these cutoff dates, no one, including system daemons and SysAdmin
735 personnel, would be able to login.
736
737 In this step, you run cv_pmf on any undelegated projects. You
738 should update the PDTs for the SysDaemon, SysAdmin, and Daemon
739 projects. You can update any other PDTs at this time, although
740 you can also update those from an interactive login session after
741 the system is brought up in a normal session.
742
743 Follow the steps below, and add any other PDTs you wish to the
744 list. Note: PMFs for these projects may either be in >udd>sa>a
745 or in >udd>sa>a>pmf.archive. It is a good idea to check to see
746
747
748 Instructions - Updating 4-4 SIB12.6f^L
749
750
751 if the PMFs are in >udd>sa>a before extracting them from the
752 pmf.archive, in case the ones in >udd>sa>a are newer than the
753 ones in the archive.
754
755 cwd >udd>sa>a
756 ls *.pmf
757 ac t pmf
758
759 Based on whether the PMFs you want to convert are in >udd>sa>a or
760 >udd>sa>a>pmf.archive, either extract them from pmf.archive or
761 skip that step. Then, run cv_pmf on each of these PMFs.
762
763 ac x pmf SysAdmin SysDaemon Daemon.pmf
764 cv_pmf SysAdmin SysDaemon Daemon
765 cp SysAdmin SysDaemon Daemon.pdt >sc1>pdt>== -force
766
767 Note: do not use the "install" command to install the PDTs.
768 Otherwise, when the system is brought up in normal mode, the
769 daemons may try to login before the delayed installation of
770 system tables is performed, causing those logins to fail due to
771 product cutoffs.
772
773
774 STEP 6: ACLS AND RING BRACKETS
775
776 Check the ACLs for >sss>dm_admin_gate_, >sss>dm_daemon_gate_,
777 >tools>installation_tools_, >tools>pnt_admin_gate_,
778 >tools>pnt_login_gate_, >tools>pnt_network_gate_,
779 >tools>pnt_priv_gate_, >sss>metering_gate_ and >sss>queue_admin_.
780 The ACLs on these gates are as they appear on GHM and should be
781 restricted. The ACL for these gates are site dependent and
782 should be changed to meet each site's needs. The dm_admin_gate_
783 and dm_daemon_gate_ should be restricted to data management
784 administrators or daemons. The installations_tools_ gate should
785 be restricted to system library maintainers. All persons on the
786 ACL for metering_gate_ have access to the Multics metering data.
787 All persons on the ACL for queue_admin_ are permitted to move
788 absentee and daemon requests for themselves and other users to
789 different queues. Users not on this ACL are only able to move
790 their own requests. The Initializer must have access to
791 queue_admin_. This capability is also dependent on extended
792 access to the <queue>.ms segments. The various pnt_<name>_gate_
793 acls should be restricted to the following minimums for correct
794 system operation:
795
796 >t>pnt_admin_gate_
797 re *.SysDaemon.*
798 re *.SysAdmin.*
799
800 >t>pnt_fs_gate_
801 re *.*.*
802
803
804
805
806 Instructions - Updating 4-5 SIB12.6f^L
807
808
809 >t>pnt_login_gate_
810 re Initializer.SysDaemon.*
811 re *.SysAdmin.*
812
813 >t>pnt_network_gate_
814 re Initializer.SysDaemon.*
815 re IMFT.Daemon.*
816 re Card_Input.Daemon.*
817 re *.SysDaemon.*
818
819 >t>pnt_priv_gate_
820 re Initializer.SysDaemon.*
821 r *.SysDaemon.*
822 re *.SysAdmin.*
823
824
825 STEP 8:
826
827 Systems prior to MR12.6f may not have quota specified on the
828 >dumps directory. If this is the case, you would see an error
829 message from Utility.SysDaemon of the form:
830
831 monitor_quota: The requested action was not performed.
832 The quota of >dumps is 0, a record limit needs to be specified.
833
834 To fix this, simply move some quota to >dumps. It is recommended
835 that at least 5000 records or quota be provided to >dumps.
836
837 mq >dumps +5000
838
839
840 STEP 7: SYSTEM CLEANUP
841
842 The system is now ready for normal operation under MR12.6f. Exit
843 admin mode and start up normal service:
844
845 ame
846 startup
847
848 Following a reasonable period of MR12.6f operation, it is
849 suggested that sites delete any <name.save> segments created as
850 part of this procedure. It is also recommended that sites
851 salvage their systems and fix quota by running
852 Salvager.SysDaemon, executing the following command:
853
854 x repair salvquota > <number of salvagers> -rebuild -dcf
855
856
857
858
859
860
861
862
863
864 Instructions - First Time 4-6 SIB12.6f^L
865
866
867
868
869
870
871
872
873
874 SECTION 5
875
876
877 INSTRUCTIONS FOR SITES INSTALLING FOR FIRST TIME
878
879
880
881
882 The following basic procedure must be performed when installing
883 Multics for the first time.
884
885
886 STEP 1: LOGICAL VOLUME ASSIGNMENTS
887
888
889 Choose logical volume assignments. Decide how many logical
890 volumes are needed and how many physical volumes are to be in
891 each.
892
893 Most installations have the following:
894
895 Logical Volume Contents
896
897 root >system_control_1
898 >system_library_standard
899 >system_library_tools
900 >system_library_unbundled
901 >system_library_auth_maint
902 >system_library_1
903 >documentation
904 >daemon_dir_dir
905 >dumps
906 >system_library_tandd
907 >system_library_obsolete
908 >system_library_3rd_party
909 >site
910 >lv
911 partitions
912
913 public >user_dir_dir
914 >library_dir_dir>include
915
916 ldd >library_dir_dir
917
918 Other logical volumes may be set up for specific applications.
919
920
921
922 Instructions - First Time 5-1 SIB12.6f^L
923
924
925 The assignment decision requires the system administrator to
926 balance the costs of seek interference and breakage against the
927 advantages of being able to define and process logically
928 different collections of data. Databases used for only a few
929 hours a day or only a few days a month are natural candidates for
930 allocation to a separate logical volume. Breaking up the
931 system's storage into several logical volumes also allows the
932 site to operate without all logical volumes mounted if hardware
933 goes down. For example, an MPC or channel might go down, halving
934 the system's disk drive capacity.
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980 Instructions - First Time 5-2 SIB12.6f^L
981
982
983 Logical volume assignments might be as follows:
984
985
986 Logical Volume Contents
987
988 root >system_library_tandd
989 >library_dir_dir
990 >system_library_obsolete
991 >system_library_standard
992 >system_library_tools
993 >system_library_unbundled
994 >system_library_3rd_party
995 >daemon_dir_dir
996 >documentation
997 >dumps
998 >system_library_1
999 >system_library_auth_maint
1000 >user_dir_dir>Daemon
1001 >user_dir_dir>SysAdmin
1002 >user_dir_dir>SysDaemon
1003 >user_dir_dir>SysMaint
1004 >site
1005 >lv
1006 partitions
1007
1008 Mcc >user_dir_dir>Mcc
1009
1010 Multics_Pubs >user_dir_dir>Pubs
1011 >user_dir_dir>Multics
1012
1013 Old_Dumps >dumps>Old_dumps
1014
1015 Public >user_dir_dir
1016 >experimental
1017 >process_dir_dir
1018 >ldd>include
1019
1020 list_1 >library_dir_dir>listings>hard
1021 >library_dir_dir>mcs
1022 >library_dir_dir>unbundled
1023
1024 list_2 >library_dir_dir>listings
1025
1026
1027 These particular assignments give a wide range of flexibility and
1028 Multics can run with only the root logical volume mounted, or
1029 with one or two of the less critical logical volumes not mounted
1030 due to unavailability of disk drives. For example, logical
1031 volumes, list_1 and list_2, can easily be demounted. This frees
1032 two disk drives to be available for use with other more critical
1033 logical volumes.
1034
1035 Installations that wish to use the Access Isolation Mechanism
1036
1037
1038 Instructions - First Time 5-3 SIB12.6f^L
1039
1040
1041 AIM by specifying more than one access category sensitivity
1042 level should specify the maximum and minimum categories for one
1043 or more volumes and thus ensure that sensitive data is confined
1044 to a few packs, or that packs are not "contaminated" with
1045 information requiring special precautions.
1046
1047 The logical volumes that hold process directory segments must be
1048 chosen. Because of the heavy usage of process directory
1049 segments, these segments should be spread over as many physical
1050 volumes as possible. One or more logical volumes may be selected
1051 to hold process directory segments, using the set_pdir_volumes
1052 command in system_start_up.ec. In the supplied
1053 system_start_up.ec, a single logical volume, named public, is
1054 selected. However, since a site may not have a "public" logical
1055 volume, this assignment is commented out. This command line
1056 should be changed to select a set of publicly accessible and
1057 permanently mounted logical volumes containing as many physical
1058 volumes as possible, subject to some constraints. Site
1059 maintenance personnel are responsible for ensuring there is
1060 always enough space available on the selected logical volumes to
1061 hold the process directory segments. The process directory
1062 placement algorithm causes process directory creations to be made
1063 on each logical volume in proportion to the number of physical
1064 volumes in the logical volume.
1065
1066 Ensure that enough storage will be available. About 5% of each
1067 volume is used for the VTOC and volume map. In addition, some
1068 breakage is unavoidable.
1069
1070 Since the system handles running out of storage without crashing,
1071 and since it is possible to add physical volumes to a logical
1072 volume dynamically, logical volumes can be defined with fewer
1073 physical volumes than their maximum anticipated size.
1074
1075
1076 STEP 2: RPV INITIALIZATION
1077
1078 Boot the Multics System Tape MST. Multics will prompt with:
1079
1080 bootload_0: Booting system MR12.6f generated 01/09/17 1119.1 pst Mon.
1081 0420.3 announce_chwm: 428. pages used of 512. in wired environment.
1082 0420.3 announce_chwm: 706. words used of 1024. in int_unpaged_page_tables.
1083 find_rpv_subsystem: Enter RPV data: M->
1084
1085 Since you are cold booting Multics and initializing the RPV
1086 destroying all content on the drive, answer with the following:
1087 cold a11 ipc 3381 0a
1088
1089 Multics will respond with:
1090
1091 find_rpv_subsystem: Booting cold will destroy all data on the RPV.
1092 Are you sure that you want to boot cold? M-> ! yes
1093
1094
1095
1096 Instructions - First Time 5-4 SIB12.6f^L
1097
1098
1099
1100 Default RPV layout: Respond "end" to use it.
1101
1102 Average seg length = 2.00
1103 VTOC size = 13495 pages, 26974 vtoces.
1104 53950 paging records.
1105 Constrained by average seg length.
1106 part hc 13495. 2500.
1107 part conf 15995. 4.
1108 part bos 74660. 270.
1109 part dump 72660. 2000.
1110 part log 72404. 256.
1111 part file 72149. 255.
1112 part bce 69949. 2200.
1113 request: M->
1114
1115 These are the default partition assignments. Any changes to the
1116 default partitions or RPV parameters can be redefined by using
1117 the "startover" request in init_vol. The system installer should
1118 review the write-up of init_vol in the Multics Administration,
1119 Maintenance, and Operations Commands Manual, Order Number
1120 GB64-00, prior to the installation.
1121
1122 Sizes for the various partitions and their locations can be
1123 modified based on the needs of the site.
1124
1125 Enter the following:
1126
1127 request: M-> ! startover
1128 request: M-> ! asl 2.0
1129 request: M-> ! part hc low 2500
1130 request: M-> ! part conf low 4
1131 request: M-> ! part bos high 270
1132 request: M-> ! part dump high 32000
1133 request: M-> ! part log high 256
1134 request: M-> ! part file high 255
1135 request: M-> ! part bce high 2200
1136 request: M-> ! list
1137
1138 Average seg length = 2.00
1139 VTOC size = 7495 pages, 14974 vtoces.
1140 29950 paging records.
1141 Constrained by average seg length.
1142 part hc 7495. 2500.
1143 part conf 9995. 4.
1144 part bos 74660. 270.
1145 part dump 42660. 32000.
1146 part log 42404. 256.
1147 part file 42149. 255.
1148 part bce 39949. 2200.
1149 request: M-> ! end
1150
1151 Next Multics responds with:
1152
1153
1154 Instructions - First Time 5-5 SIB12.6f^L
1155
1156
1157
1158 init_empty_root: Begin rpv initialization. This will take some time.
1159 init_empty_root: rpv initialized; 29950 records.
1160 2352.8 find_file_partition: Initializing file partition. Data not in expected format.
1161 2353.3 load_mst: 946. out of 1048. pages used in disk mst area.
1162 bce early 2353.6: M->
1163
1164
1165 STEP 3: CONFIGURATION
1166
1167 Build the configuration description as follows user input
1168 preceeded by an exclamation mark !:
1169
1170 ! config
1171 ! 1$d
1172 ! a
1173 ! User types in configuration fields as defined
1174 in the System Maintenance Procedures Order
1175 Number AM81-03
1176 ! \f
1177 ! w
1178 ! q
1179
1180 As an example you can use the following config deck:
1181
1182 clok -delta 7. -zone pst
1183 iom -tag a -port 0 -model iom -state on
1184 iom -tag b -port 1 -model iom -state on
1185 cpu -tag a -port 7 -state on -type dps8 -model 70. -cache 8.
1186 mem -port a -size 4096. -state on
1187 mem -port b -size 4096. -state on
1188 mem -port c -size 4096. -state on
1189 mem -port d -size 4096. -state on
1190 ipc -type fips -iom a -chn 13 -nchan 1
1191 prph -subsys dska -iom a -chn 13 -nchan 1 -model 3381. -number 16
1192 prph -device fnpd -iom a -chn 20 -model 6670. -state on
1193 mpc -ctlr mtpa -iom a -chn 12 -nchan 1 -model 501.
1194 prph -subsys tapa -iom a -chn 12 -nchan 1 -model 500. -number 16.
1195 prph -device opca -iom a -chn 36 -model 6001. -ll 256. -state on
1196 mpc -ctlr urpa -iom a -chn 15 -model 8004. -nchan 1
1197 prph -device rdra -iom a -chn 15 -model 301.
1198 mpc -ctlr urpb -iom a -chn 16 -model 8004. -nchan 1
1199 prph -device puna -iom a -chn 16 -model 301.
1200 mpc -ctlr urpc -iom a -chn 17 -model 8004. -nchan 1
1201 prph -device prta -iom a -chn 17 -model 1600. -train 600. -ll 136.
1202 part -part hc -subsys dska -drive 00a
1203 part -part bos -subsys dska -drive 00a
1204 part -part dump -subsys dska -drive 00a
1205 root -subsys dska -drive 00a
1206 sst -4k 2000. -16k 1000. -64k 500. -256k 250.
1207 dbmj 64. 700. 400. 150. 60. 25.
1208 tcd -apt 500. -itt 1000.
1209 intk warm 0. rpvs star
1210
1211
1212 Instructions - First Time 5-6 SIB12.6f^L
1213
1214
1215
1216 Do not enter any part cards at this time except for those
1217 partitions defined on the rpv. Also make the root card specify
1218 only the rpv.
1219
1220 Continue booting bce.
1221
1222 bce early 0020.0: M-> ! bce
1223 Multics Y2K. System was last shudown/ESD at:
1224 Monday December 31 1900 16:00:00 pst
1225 Current system time is: Saturday April 16 2016 15:21:07 pst.
1226 Is this correct? M->! y
1227
1228 bce boot 1325.5 : M-> ! boot -cold
1229 Do you really wish to boot cold and there by destroy the
1230 system hierarchy? M-> ! yes
1231 1655.9 init_syserr_log: Syserr LOG partition reinitialized.
1232 1657.0 volume_registration_mgr_$check_volume_registration: Reregistered public LV root LVID 371626522536 Initializer.SysDaemon.z
1233 1657.0 volume_registration_mgr_$check_volume_registration: Reregistered PV rpv PVID 371626522524 in LV root Initializer.SysDaemon.z
1234 disk_table_: New disk_table created
1235 Multics MR12.6f - 01/20/17 2036.6 pst Fri
1236 Command:
1237
1238 Ignore the messages prefaced by disk_table_ and
1239 volume_registration_mgr_.
1240
1241
1242 STEP 4: INITIALIZING ROOT VOLUMES
1243
1244 Initialize each new root volume except the RPV with the init_vol
1245 command.
1246
1247 For better performance it is advisable to place a hardcore
1248 partition hc on each physical volume of the Root Logical Volume
1249 RLV. The placement of the hardcore partition on each volume
1250 must be low. The recommended size of additional partitions is
1251 2500 records divided by the number of physical volume used. The
1252 RPV size should remain 2500 records to allow the system to boot
1253 with only an RPV mounted.
1254
1255 For most volumes the command looks like:
1256
1257 init_vol PV_NAME DRIVE_NAME -rlv -special
1258
1259 For example:
1260
1261 Command: M-> ! init_vol root2 dska_00b -rlv
1262 volume root2 68111 records
1263 Command: M-> ! init_vol root3 dska_00c -rlv
1264 volume root3 68111 records
1265 Command: M->
1266
1267
1268
1269
1270 Instructions - First Time 5-7 SIB12.6f^L
1271
1272
1273
1274 For those volumes that are to have partitions or an average
1275 segment length other than the default of five records add the
1276 optional "-special" as a third argument. The command then asks
1277 for instructions about the partition location. Hardcore
1278 partitions for additional root volumes should be specified as
1279 they are initialized. You may type one or more of the following:
1280
1281 part NAME low nrec
1282 part NAME high nrec
1283 avg fff.ff
1284 list
1285
1286 complete initialization by typing:
1287
1288 end
1289
1290 An example of typing the init_vol for an MSS0451/400 with an
1291 alternate partition on a RLV drive is:
1292
1293 init_vol root2 dska_02 -rlv -special
1294 part alt high 141 Note: 451 disk only
1295 part hc low 625 Example: 2500/4 root volumes
1296 end
1297
1298 when done type:
1299
1300 shut
1301
1302
1303 STEP 5: ADDITIONAL CONFIGURATION PARAMETERS
1304
1305 At bce boot level enter the configuration deck editor by typing
1306 "config". The PART cards and ROOT card should be added to the
1307 deck. Subsequent boots divide the hardcore supervisor among all
1308 hardcore partitions.
1309
1310 The following script is provided as an example where a root card
1311 exists in the configuration deck and a part card does not exist.
1312 Parameters of cards will vary according to the configuration of
1313 individual sites. User input is preceeded by an exclamation mark
1314 !.
1315
1316 bce boot: M-> ! config
1317 M-> ! /root/
1318 root -subsys dska -drive 00a
1319 M-> ! s/$/ -subsys dska -drive 00b -subsys dska -drive 00c/p
1320 root -subsys dska -drive 00a -subsys dska -drive 00b -subsys dska -drive 00c
1321 M-> ! w
1322 M-> ! q
1323 bce boot 1215.2: M-> reinit
1324
1325
1326
1327
1328 Instructions - First Time 5-8 SIB12.6f^L
1329
1330
1331 STEP 6: RELOAD OF EXECUTABLE LIBRARIES
1332
1333 Do a normal boot "BOOT".
1334
1335 bce boot 1641.1: M-> ! boot
1336 Multics MR12.6f - 01/20/17 2042.0 pst Fri
1337 Command: M->
1338
1339 While at ring-1 initializer command level load the executable
1340 libraries. This is done as follows:
1341
1342 Command: M-> ! reload -nosetlvid
1343
1344 Only the system libraries 12.6fEXEC_1 and 12.6fEXEC_2 should be
1345 reloaded at this time. The -nosetlvid control argument ignores
1346 the logical volume ID on the tape when a directory is being
1347 reloaded.
1348
1349 Input tape label: M-> ! 12.6fEXEC_1
1350 Mounting tape 12.6fEXEC_1 for reading
1351 1521.9 RCP: Attached tapa_01 for Initializer.SysDaemon.z
1352 1521.9 RCP: Note tapa_01 - 12.6fEXEC_1sys
1353 CONSOLE: ALERT
1354 1522.0 RCP: Mount Reel 12.6fEXEC_1 without ring on tapa_01 for Initializer.SysDaemon.z
1355 <12.6fEXEC_1.tap>
1356 attachTape selected unit 1
1357 Mounted Multics volume "12.6fEXEC_1" recorded at 800 BPI on device tapa_01
1358 Begin at 04/16/16 1522.0 pst Sat
1359 End of reel encountered.
1360 iload: Are there any more tapes to be reloaded? M-> ! yes
1361 1522.3 RCP: Detached tapa_01 from Initializer.SysDaemon.z
1362 Input tape label: M-> ! 12.6fEXEC_2
1363 Mounting tape 12.6fEXEC_2 for reading
1364 1522.3 RCP: Attached tapa_02 for Initializer.SysDaemon.z
1365 1522.3 RCP: Note tapa_02 - 12.6fEXEC_2sys
1366 CONSOLE: ALERT
1367 1522.3 RCP: Mount Reel 12.6fEXEC_2 without ring on tapa_02 for Initializer.SysDaemon.z
1368 <12.6fEXEC_2.tap>
1369 attachTape selected unit 2
1370 Mounted Multics volume "12.6fEXEC_2" recorded at 800 BPI on device tapa_02
1371 End of reel encountered.
1372 iload: Are there any more tapes to be reloaded? M-> ! no
1373 1522.3 RCP: Detached tapa_02 from Initializer.SysDaemon.z
1374 Normal termination 04/16/16 1522.3 pst Sat.
1375 Command: M->
1376
1377 At this point shut the system down and reboot to ring 4 command
1378 level:
1379
1380 M-> ! shut
1381 1230.1 shutdown complete.
1382 bce boot 1231.1: M-> ! boot standard
1383 ignore the messages from sc_init_.
1384
1385
1386 Instructions - First Time 5-9 SIB12.6f^L
1387
1388
1389 Multics MR12.6f - 04/15/16 1235.2 pst Fri
1390 Ready
1391 M-> ! admin
1392 admin: Entry not found. Could not retrieve admin password
1393 from the PNT to check admin password. Entering admin mode.
1394 NOTE: This error message is repeated each time admin is
1395 entered until a password has been set.
1396
1397 Register and initialize all non-RLV volumes. For ease of typing
1398 use of lower case names is recommended.
1399
1400 Use the add_volume_registration avr command as in the following
1401 example:
1402
1403 ! avr -pv pub01 -lv public -serial 233-81 -model 451
1404 add_volume_registration: LV "public" does not exist. Do you
1405 wish to create it? M-> ! yes
1406 add_volume_registration: Registered PV "pub01" pvid
1407 100172223140 on new LV "public" lvid 100172223005.
1408 r 14:15 1.473 8
1409
1410 to create registration entries for each logical and physical
1411 volume. The registration file for the root logical volume is
1412 created automatically by the bootload. Since the default model
1413 number is 451, use the change_vol_registration command, if
1414 necessary, to set the correct value of model number on the rpv.
1415 The serial number can also be set as follows:
1416
1417 lvr -pv rpv
1418 cvr -pv rpv -serial 233-79 -model <model number>
1419 ame
1420
1421 Use the init_vol for the additional logical volumes as follows:
1422
1423 init_vol pub01 dska_03 -special
1424 part alt high 141 Note: 451 disk only
1425 end
1426 init_vol pub02 dska_04 -special
1427 part alt high 141 Note: 451 disk only
1428 end
1429
1430 After all physical volumes are registered and initialized, add
1431 them to the disk_table by typing the add_vol av command for all
1432 except the RPV:
1433
1434 av pvname dskX_NN
1435
1436 An example:
1437
1438 av pub01 dska_03
1439
1440 At this point add all of the logical volumes by typing:
1441
1442
1443
1444 Instructions - First Time 5-10 SIB12.6f^L
1445
1446
1447
1448 alv -all
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502 Instructions - First Time 5-11 SIB12.6f^L
1503
1504
1505 STEP 7: SETTING AND CHECKING ACCESS
1506
1507 The ACL for >lv should be set to "s" for all users. Setting
1508 initial ACLs for segments in the >lv directory is done from admin
1509 mode by typing:
1510
1511 M-> ! admin
1512 <READY MESSAGE>
1513 M-> ! sis >lv rew *.SysAdmin rew *.SysDaemon
1514 <READY MESSAGE>
1515 M-> ! sa >lv s * sma *.SysAdmin sma *.SysMaint
1516 <READY MESSAGE>
1517
1518 Create Access Control Segments ACS for each logical volume.
1519 For system public volumes, create them as follows:
1520
1521 M-> ! create >lv>lvname.acs
1522 <READY MESSAGE>
1523 M-> ! cvr -lv lvname -acs >lv>lvname.acs
1524 <READY MESSAGE>
1525 M-> ! set_max_length >lv>*.acs 0
1526
1527 where lvname stands for name of each logical volume. For
1528 example:
1529
1530 ! create >lv>root.acs
1531 ! cvr -lv root -acs >lv>root.acs
1532 ! set_max_length >lv>*.acs 0
1533
1534 The ACLs of these segments are interpreted to give permission to
1535 attach the logical volume for private volumes and permission to
1536 modify master directory control information in the MDCS for
1537 specific logical volumes. Specific ACL entries for
1538 Initializer.SysDaemon should be deleted at this time by typing:
1539
1540 delete_acl >lv>*.acs
1541 <READY MESSAGE>
1542
1543 This is necessary because Initializer.SysDaemon always gets
1544 default access of "rw". This would prevent the Initializer from
1545 being a volume administrator by virtue of the missing "e" access.
1546 Deletion of specific access gives the Initializer the "rew"
1547 access allowed all SysDaemons.
1548
1549 The ACL is now set so that all system administrators and all
1550 SysDaemons are volume administrators. The "e" bit controls
1551 executive access.
1552
1553 For private volumes, the ACS is in a directory controlled by the
1554 volume owner. The ACS segment must reside in a directory on a
1555 logical volume different from the private logical volume.
1556
1557
1558
1559
1560 Instructions - First Time 5-12 SIB12.6f^L
1561
1562
1563 STEP 8: SETTING VOLUME QUOTA
1564
1565 Use the set_volume_quota command to give the Initializer process
1566 enough quota on each logical volume to create the necessary
1567 master directories.
1568
1569 set_volume_quota LV_NAME QUOTA
1570
1571 Example:
1572 set_volume_quota public 36000
1573
1574 The number QUOTA should be at least the total of the quotas of
1575 the directories to be created in the next step.
1576
1577 Use create_dir to create master directories. The format of the
1578 command is:
1579
1580 create_dir pathname -lv logical_volume -quota QQ
1581
1582 where QQ <262144
1583
1584 Example: cd >library_dir_dir -lv no_backup -quota 40000
1585 cd >library_dir_dir>include -lv public -quota 3000
1586
1587 The acct_start_up.ec will, in step 10, create a number of project
1588 directories and assign terminal quota if the directories do not
1589 exist. They are the following with the quota that will be
1590 assigned:
1591
1592 >udd>SysAdmin 5000
1593 >udd>SysAdmin>admin 2000
1594 >udd>SysDaemon 5000
1595 >udd>Daemon 1000
1596 >udd>Operator 100
1597 >udd>Terminals 10
1598 >udd>HFED 5000
1599
1600 Set ACLs and additional names, as desired, on all master
1601 directories at this time.
1602
1603 Directory quota should be set for each master directory by those
1604 sites that wish to have disk charges for directory pages included
1605 in monthly bills. Those sites not interested in implementing
1606 this feature may type "ame" and "shutdown" then skip to the next
1607 step.
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618 Instructions - First Time 5-13 SIB12.6f^L
1619
1620
1621 A directory quota of 1000 pages should be sufficient for all
1622 master directories with the exception of >udd. If udd is a
1623 master directory it is recommended that it be given a directory
1624 quota of 100000 pages. This provides enough directory quota for
1625 100 projects at 1000 pages each. If the site has more than 100
1626 active projects the 100000 figure should be adjusted accordingly.
1627 To set directory quota on each master directory execute the
1628 following command:
1629
1630 set_dir_quota PATHNAME QQ
1631
1632 This command allows a system administrator to place an arbitrary
1633 secondary storage quota for directories on a specified directory.
1634
1635 PATHNAME
1636 is the name of a directory on which the directory quota is to
1637 be placed. -wd can be used to specify the working directory.
1638 QQ
1639 is the directory quota in 1024 word pages.
1640
1641 If additional directory quota is required for a master directory
1642 the quota can be reset following movement of directory quota to
1643 inferior directories.
1644
1645
1646 Instructions for moving directory quota down to the project level
1647 is included in Step 19.
1648
1649 To shut down, do the following:
1650
1651 ame
1652 shut
1653
1654
1655 STEP 9: RELOAD OF REMAINING RELEASE TAPES
1656
1657 Reboot Multics to ring 1 and reload the MR12.6fLDD_STANDARD_* and
1658 MR12.6fUNBUNDLED_* tapes with the following commands:
1659
1660 boot
1661 alv -all
1662 reload -nosetlvid
1663
1664 Load each of the following tapes, in this order:
1665
1666 12.6fLDD_STANDARD_1
1667 12.6fLDD_STANDARD_2
1668 12.6fLDD_STANDARD_3
1669 12.6fLDD_STANDARD_4
1670 12.6fLDD_STANDARD_5
1671 12.6fUNBUNDLED_1
1672 12.6fUNBUNDLED_2
1673 12.6fUNBUNDLED_3
1674
1675
1676 Instructions - First Time 5-14 SIB12.6f^L
1677
1678
1679 12.6fMISC
1680
1681 The tape labeled MR12.6fMISC must be the final tape of the
1682 MR12.6f supplied set to be reloaded.
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734 Instructions - First Time 5-15 SIB12.6f^L
1735
1736
1737 STEP 10: FIX PERMISSIONS ON LIBRARIES
1738
1739 After all the release tapes have been reloaded cross into ring 4
1740 by executing the following commands:
1741
1742 standard
1743 admin Ignore messages from admin at this time.
1744
1745 Then execute the following commands to fix the names and ACLs on
1746 unbundled libraries:
1747
1748 an >library_dir_dir ldd
1749 an >ldd>system_library_unbundled unbundled unb u
1750 sa >ldd>unb sma *.SysAdmin.* sma *.SysDaemon sma *.SysMaint s *.*.*
1751 da >ldd>unb Initializer.SysDaemon.z
1752 an >ldd>unb>source s S
1753 an >ldd>unb>object o O
1754 sa >ldd>unb>source sma *.SysAdmin.* sma *.SysDaemon sma *.SysMaint s *.*.*
1755 sa >ldd>unb>object sma *.SysAdmin.* sma *.SysDaemon sma *.SysMaint s *.*.*
1756 da >ldd>unb>source object Initializer.SysDaemon.z
1757
1758
1759 STEP 11: RUNNING ACCT_START_UP.EC
1760
1761 At this time you are ready to execute part 1 of the
1762 acct_start_up.ec. To do this type:
1763
1764 ec >tools>acct_start_up cold F.ANSS
1765
1766 where F.ANSS is the channel number of the hardwired
1767 Initializer terminal.
1768
1769 F = FNP number a-h
1770 A = Adaptor type h = hsla
1771 N = Adaptor number 0-2 for hsla
1772 SS = Decimal subchannel number of specified adaptor
1773
1774 The string "F.ANSS" should be replaced by "otw_" if there is no
1775 hardwired terminal and the bootload console is to be used as the
1776 Initializer terminal.
1777
1778 The error:
1779
1780 new_iod_tables_compiler: Entry not found. Accessing cdt. Channel
1781 name checks will not be performed
1782
1783 may be encountered during this stage. This error should be
1784 disregarded.
1785
1786 At this point, tapes dumped from other Multics sites can be
1787 reloaded as desired using the "reload" command with the control
1788 arguments "-noquota -notrim -nosetlvid" to avoid deletion of
1789 existing segments and resetting of quotas. If any segments are
1790
1791
1792 Instructions - First Time 5-16 SIB12.6f^L
1793
1794
1795 to be loaded into ring 1 then it cannot be done without exiting
1796 admin mode and rebooting to ring 1.
1797
1798
1799 STEP 12: MULTICS COMMUNICATIONS SYSTEM
1800
1801 A Multics Communications System CS core image is supplied in
1802 the >unbundled library, and is named site_mcs.
1803
1804 The site_mcs version for this release is 7.6c. The site_mcs core
1805 image contains the basic support for DN6780 type FNPs with 64k of
1806 memory.
1807
1808 The communication system core images are built using the bind_fnp
1809 command in conjunction with a bindfile describing the CS modules
1810 and configurations to be used. A copy of the site_mcs.bind_fnp
1811 can be found in >ldd>mcs>info.
1812
1813 Sites should build their own CS core image tailored to their own
1814 FNP configuration, terminal type requirements, and use of
1815 additional separately priced FNP software modules.
1816
1817 Sites using the default site_mcs core image should ensure the CMF
1818 image statement points to the correct default core image located
1819 in >unb. The initial CMF, which includes some sample channel
1820 entries in comments, as well as one FNP entry, should be checked.
1821 Edit this CMF to eliminate any inconsistencies with the actual
1822 configuration and add one or more entries for login channels.
1823
1824 Sites modifying their own CS core image are required to use the
1825 GCOS Environment Simulator which is an unbundled software
1826 product. To build a new core image, the following procedure is
1827 suggested:
1828
1829 Sites will need to extract the communications object segments
1830 from archives located in >ldd>mcs>object. Sites should create a
1831 virgin directory under >udd>sa>a for each new core image.
1832
1833 The following example is for sites with the more common type
1834 Datanet and a larger memory configuration. Execute the following
1835 commands:
1836
1837 create_dir >udd>sa>a>mcs.7.6c
1838 cwd >udd>sa>a>mcs.7.6c
1839 ted
1840 r >ldd>mcs>info>site_mcs.bind_fnp or location of sites
1841 CS bind file
1842 .
1843 .
1844 .
1845 make editing changes if any...
1846 .
1847 .
1848
1849
1850 Instructions - First Time 5-17 SIB12.6f^L
1851
1852
1853 .
1854 w site_mcs.bind_fnp
1855 q
1856 ac x segs >ldd>mcs>o>*.archive -absp
1857 bind_fnp site_mcs -list
1858
1859 Be sure the image statement in the CMF points to this newly
1860 created CS core image. The following example assumes the default
1861 CMF to be in the >udd>sa>a directory. This procedure will insure
1862 that the new CS image is used:
1863
1864 cwd >udd>sa>a
1865 ted
1866 r CMF.cmf
1867 .
1868 .
1869 Locate the image: statement by typing:
1870
1871 /image/
1872
1873 Edit the image: statement to point to the CS image,
1874 site_mcs, by making the statement read:
1875
1876 image: >udd>sa>a>mcs.7.6c>site_mcs;
1877
1878 .
1879 .
1880 Make any other changes needed.
1881 .
1882 .
1883 w CMF.cmf
1884 q
1885 cv_cmf CMF.cmf
1886 copy CMF.cdt >sc1>cdt -force
1887
1888 The above procedure builds a site dependent CS core image and
1889 ensures that this image is loaded in the FNP by the answering
1890 service.
1891
1892 The following command provide examples of performing the above
1893 steps:
1894
1895 create_dir >user_dir_dir>SysAdmin>a>mcs.7.6c
1896 cwd >user_dir_dir>SysAdmin>a>mcs.7.6c
1897 ted
1898 r >ldd>mcs>info>site_mcs.bind_fnp
1899 w site_mcs.bind_fnp
1900 q
1901 ac x segs >ldd>mcs>o>*.archive -absp
1902 bind_fnp site_mcs -list
1903 cwd >user_dir_dir>SysAdmin>a
1904 ted
1905 r CMF.cmf
1906
1907
1908 Instructions - First Time 5-18 SIB12.6f^L
1909
1910
1911 1,$d
1912 a
1913 Service: login;
1914 Charge: none;
1915 Terminal_type: none;
1916 Line_type: none;
1917 Baud: 9600;
1918 FNP_required_up_time: 5;
1919 FNP: D;
1920 type: DN6670;
1921 memory: 64;
1922 lsla: 0;
1923 hsla: 1;
1924 image: >system_library_unbundled>site_mcs;
1925 service: active;
1926 name: d.h000;
1927 attributes: hardwired;
1928 name: d.h001-d.h031;
1929 end;
1930 \f
1931 1,$p
1932 w
1933 ; ted: Do you want to w with the untrusted pathname >user_dir_dir>SysAdmin>a>CMF.cmf?
1934 y
1935 q
1936 cv_cmf CMF.cmf
1937 copy CMF.cdt >sc1>cdt -force
1938
1939
1940 STEP 13: COMPLETE ACCOUNTING STARTUP
1941
1942
1943 During this step, expect many messages, some with audible alarms,
1944 reporting that certain segments do not exist and are being
1945 created. These messages would be cause for concern during normal
1946 system operation but are to be expected during accounting start
1947 up and may be ignored. Execute the following example:
1948
1949 ame
1950 stop_mpx d sites with multiple FNPs execute this
1951 command for each FNP
1952 multics
1953 load_mpx d -check sites with multiple FNPs execute
1954 this command for each FNP
1955 admin any error messages displayed at this time except
1956 hardware error messages can be ignored.
1957
1958 ec >tools>acct_start_up cold2
1959
1960 This procedure will finish accounting start up. The load_mpx
1961 command indicates on the FNP console any configuration errors if
1962 console_man is loaded and "console: yes;" is in the bind_file.
1963 If any errors are reported they should be corrected.
1964
1965
1966 Instructions - First Time 5-19 SIB12.6f^L
1967
1968
1969
1970 During this stage you will encountered the error,
1971 "set_max_length: Validation level not in ring bracket.
1972 >system_control_1>mcaa.acs", which occurs if an IMU is
1973 configured. Ignore this error message. The cause of this error,
1974 validation level of >sc1>mcaa.acs, must be fixed manually after
1975 cold2 has completed successfully.
1976
1977 A default start_up.ec is available for use by new Multics users
1978 when they first log in. This exec_com is executed by users who
1979 login to the system without their own start_up.ec. The segment
1980 >tools>start_up.ec was copied into >sc1 by the acct_start_up.ec.
1981 Individual sites can modify this exec_com to meet their own
1982 needs. The access for the segment should be "r *.*.*" and ring
1983 brackets of 4,5,5. To start the system up for normal service
1984 type:
1985
1986 ame
1987 word login
1988 abs start
1989 go
1990
1991 After typing "go" a number of messages will be returned. These
1992 messages are of the form:
1993
1994 absentee_utility_: Entry not found. Creating new <pathname>.
1995 scavenge_vol: No volumes.
1996 Found unexpected command_error in system start_up.ec.
1997
1998 These messages may be ignored.
1999
2000
2001 STEP 14: CHECK GATE ACLS
2002
2003
2004 Type "admin" and enter the new admin password you selected.
2005 Check the ACLs for >sss>dm_admin_gate_, >sss>dm_daemon_gate_,
2006 >tools>installation_tools_, >tools>pnt_admin_gate_,
2007 >tools>pnt_login_gate_, >tools>pnt_network_gate_,
2008 >tools>pnt_priv_gate_, >sss>metering_gate_ and >sss>queue_admin_.
2009 The ACLs on these gates are as they appear on GHM and should be
2010 restricted. The ACL for these gates are site dependent and
2011 should be changed to meet each site's needs. The dm_admin_gate_
2012 and dm_daemon_gate_ should be restricted to data management
2013 administrators or daemons. The installations_tools_ gate should
2014 be restricted to system library maintainers. All persons on the
2015 ACL for metering_gate_ have access to the Multics metering data.
2016 All persons on the ACL for queue_admin_ are permitted to move
2017 absentee and daemon requests for themselves and other users to
2018 different queues. Users not on this ACL are only able to move
2019 their own requests. The Initializer must have access to
2020 queue_admin_. This capability is also dependent on extended
2021 access to the <queue>.ms segments. The various pnt_<name>_gate_
2022
2023
2024 Instructions - First Time 5-20 SIB12.6f^L
2025
2026
2027 acls should be restricted to the following minimums for correct
2028 system operation:
2029
2030 >t>pnt_admin_gate_
2031 re *.SysDaemon.*
2032 re *.SysAdmin.*
2033
2034 >t>pnt_fs_gate_
2035 re *.*.*
2036
2037 >t>pnt_login_gate_
2038 re Initializer.SysDaemon.*
2039 re *.SysAdmin.*
2040
2041 >t>pnt_network_gate_
2042 re Initializer.SysDaemon.*
2043 re IMFT.Daemon.*
2044 re Card_Input.Daemon.*
2045 re *.SysDaemon.*
2046
2047 >t>pnt_priv_gate_
2048 re Initializer.SysDaemon.*
2049 r *.SysDaemon.*
2050 re *.SysAdmin.*
2051
2052 Set ACLs on the >sc1>rcp directory and on the access control
2053 segments in it <name>.acs, to allow users to attach tape drives
2054 and any other peripherals they are allowed to use.
2055
2056 After all ACLs are set, type:
2057
2058 ame
2059 x repair salvquota > 2 -dcf -rebuild
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082 Instructions - First Time 5-21 SIB12.6f^L
2083
2084
2085 STEP 15: SET QUOTA ON >DUMPS
2086
2087
2088 By default, the >dumps directory does not have any quota set, and
2089 thus derives its quota from the root directory.
2090 Utility.SysDaemon's start_up.ec, however, includes a
2091 monitor_quota command to monitor the quota in, among other
2092 directories, >dumps. Without any quota set on this directory,
2093 you will see warnings on the console similar to the following:
2094
2095 monitor_quota: The requested action was not performed.
2096 The quota of >dumps is 0, a record limit needs to be specified.
2097
2098 To fix this, move some quota to >dumps. It is recommended that
2099 at least 5000 records or quota be provided to >dumps.
2100
2101 mq >dumps +5000
2102
2103
2104 STEP 16: SAVE CHECKPOINT
2105
2106
2107 Type "logout * *" and "shutdown".
2108
2109
2110 STEP 17: TAILOR SYSTEM AND REGISTER PROJECTS
2111
2112
2113 Reboot the system for normal service by typing "boot star". The
2114 system is now ready for registration of projects and users from a
2115 SysAdmin process, such as Repair.SysAdmin, logged in from a
2116 standard terminal. The default password for Repair is "repair".
2117 You will be required to change it the first time you login, by
2118 specifying the "-cpw" control argument to the "login" command.
2119
2120 The acct_start_up exec_com created default system_start_up.ec,
2121 admin.ec, iod_tables.iodt, RTMF.rtmf, and CMF.cmf segments.
2122 These segments should be tailored by the local Site SA to meet
2123 site operational and configuration requirements.
2124
2125
2126 STEP 18: SETUP VOLUME BACKUP/RELOADER
2127
2128
2129 The following instructions are necessary only for those sites
2130 that intend to use the Volume Backup/Reloader facility:
2131
2132 The personids "Volume_Dumper", "Volume_Reloader", and
2133 "Volume_Retriever" are registered. These personids are
2134 registered on the Daemon project with the multip and daemon
2135 attributes and with a home_dir of
2136 >user_dir_dir>Daemon>Volume_Dumper. Sites using AIM must set the
2137 authorization for these personids at system_high and upgrade the
2138
2139
2140 Instructions - First Time 5-22 SIB12.6f^L
2141
2142
2143 home directory to system_high.
2144
2145 Login Repair SysDaemon, or if running in special session using
2146 the Initializer, execute the following commands:
2147
2148 admin
2149 ec >tools>setup_volume_reloader
2150
2151 The error message that Volumes dm001 and dm002 are not registered
2152 should be ignored. This exec_com creates all directories,
2153 segments, and message segments necessary for running the volume
2154 dumper/reloader system. This exec_com also sets suggested access
2155 on the directories and segments created. Not all the access set
2156 is required. If a site wishes, the access created for
2157 *.SysMaint.* and *.SysAdmin.* may be removed.
2158
2159 This exec_com resets the VTOCE fields for both incremental and
2160 consolidated dumps by making a first dump pass with output to
2161 discard_. This is necessary since the first dump pass is
2162 equivalent to a complete dump on both the incremental and
2163 consolidated pass. Follow the instructions for normal use of
2164 this facility at the completion of this exec_com.
2165
2166 Sites need a sufficient number of tapes to accommodate the entire
2167 file system and any incremental and consolidated dumps until a
2168 subsequent complete dump is taken. This is known as a reload
2169 group. It is suggested that new sites start with 100 reels of
2170 tape or a sufficient quantity to contain two complete reload
2171 groups. A single reel of tape at 6250 bpi holds approximately
2172 26000 Multics records.
2173
2174
2175 STEP 19: SETUP DIRECTORY QUOTA
2176
2177
2178 This step is necessary only for those sites that wish to charge
2179 their user projects for disk storage used by directory pages, or
2180 to obtain a more complete disk report containing additional disk
2181 usage statistics. If directory quota is not already set on >udd
2182 execute the following commands from a SysAdmin process if >udd is
2183 not a master directory:
2184
2185 sac set_dir_quota > 120000
2186 sac move_dir_quota >udd 100000
2187
2188 If >udd is a master directory, then execute:
2189
2190 set_dir_quota >udd 100000
2191
2192 Then execute the commands:
2193
2194 cwd >udd
2195 move_dir_quota dirs ** 1000
2196
2197
2198 Instructions - First Time 5-23 SIB12.6f^L
2199
2200
2201
2202 These commands move or set sufficient directory quota on >udd for
2203 100 projects with the suggested default project directory quota
2204 of 1000. If a site has more than 100 active projects a figure in
2205 excess of 100000 must be chosen for the initial directory quota
2206 of >udd. The master.ec gives each new project a default
2207 directory quota of 1000 pages by moving 1000 pages of directory
2208 quota from >udd. The system administrator should make sure there
2209 is always sufficient directory quota on >udd to accommodate new
2210 projects.
2211
2212 It is also suggested that all directories directly off the root
2213 with the exception of pdd and sl1 be given nonzero segment and
2214 directory quotas large enough to accommodate their current page
2215 usage and allowing for some growth. The purpose of this is to
2216 cause the disk report to contain complete statistical information
2217 on these directories directories with 0 quotas are omitted from
2218 the disk report.
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256 Module Changes since MR12.5 5-24 SIB12.6f^L
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266 APPENDIX A
2267
2268
2269 MODULE CHANGES SINCE MR12.5
2270
2271
2272
2273
2274 This appendix provides information about changes to the Multics
2275 operating system on a segment basis. The following information
2276 applies to changes made to the system since MR12.5 and therefore
2277 includes all changes from MR12.6a, MR12.6b, MR12.6c, MR12.6d,
2278 MR12.6e, and MR12.6f.
2279
2280 This appendix is provided to help sites identify, to a segment
2281 level, changes they may have applied for emergency bug fixes or
2282 site dependent modifications to current system software.
2283
2284 Information is catagorized as follows:
2285
2286
2287 new info segments added to >doc>info unless otherwise noted
2288 new segments
2289 new or modified include files
2290 deleted segments
2291 modified segments
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314 Module Changes since MR12.5 A-1 SIB12.6f^L
2315
2316
2317 NEW OR MODIFIED INFO SEGMENTS SINCE MR12.5
2318
2319
2320 >doc>info>call.info cl.info >doc>info>pointer_info_.info
2321 >doc>info>video_editing.gi.info >doc>info>pointer_info.info pin.info
2322 >doc>info>input_history_.info >doc>subsystem>operator>x.repair.info
2323 >doc>info>input_history.info ih.i^H>n^Hdo^Hfo^Hc^H>privileged>generate_mst.info
2324 >doc>info>window_editor_utils_.info
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372 Module Changes since MR12.5 A-2 SIB12.6f^L
2373
2374
2375 NEW SEGMENTS SINCE MR12.5
2376
2377
2378 fs_vol_label.incl.alm basic_error_messages_
2379 time_zones_.incl.pl1 bound_ws_tty_
2380 forum_trans_list.incl.pl1 bound_v2apl_tools_
2381 attribute_names.incl.pl1 bound_v2apl_fcns_
2382 fort_intrinsics.incl.pl1 bound_v2apl_
2383 forum_edit_info.incl.pl1 bound_tss_fortran_
2384 laser_sheet_template.incl.pl1 bound_pps_support_
2385 pitmsg.incl.pl1 bound_mrpg_
2386 rmdb_finish_transaction.incl.pl1 bound_mowse_
2387 rmdb_start_transaction.incl.pl1 bound_l6_ftf_
2388 tp_command_table.incl.pl1 bound_imft_
2389 tp_input_queue.incl.pl1 bound_ibm_io_
2390 tp_master_table.incl.pl1 bound_hasp_
2391 tp_output_queue.incl.pl1 bound_gcos_tss_
2392 tp_person_name_table.incl.pl1 bound_g115_
2393 x25_info.incl.pl1 bound_fast_
2394 xmail_help.incl.pl1 bound_dfast_
2395 call_dtype_fcns.incl.pl1 bound_cv_basic_file_
2396 pl1_symbol_type_fcns.incl.pl1 bound_convert_tsoapl_
2397 call_entry_info_.incl.pl1 bound_cobol_rts_
2398 GTSS.MCFC.CALLERS_2 bound_cobol_mcs_
2399 GTSS.MCFC.CALLERS_1 bound_cobol_front_
2400 GTSS.MCFC.NAMES bound_cobol_back_
2401 GTSS.MCFC.FILES bound_bft_
2402 GTSS.MCFC.CALLERS_4 bound_basic_runtime_
2403 GTSS.MCFC.CALLERS_3 bound_basic_
2404 gtss_starL_ ACTC_BULLHN.pnotice
2405 gtss_file_attributes.ec ACTC.pnotice
2406 use_ep_basic gtss_fast_library_
2407 load_mowse trace_error_halt_.pl1
2408 convert_numeric_file
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430 Module Changes since MR12.5 A-3 SIB12.6f^L
2431
2432
2433 NEW OR MODIFIED INCLUDE FILES SINCE MR12.5
2434
2435
2436 fs_vol_label.incl.alm tp_input_queue.incl.pl1
2437 mtape_dcls.incl.pl1 tp_master_table.incl.pl1
2438 time_zones_.incl.pl1 tp_output_queue.incl.pl1
2439 attribute_names.incl.pl1 tp_person_name_table.incl.pl1
2440 fort_intrinsics.incl.pl1 x25_info.incl.pl1
2441 forum_edit_info.incl.pl1 xmail_help.incl.pl1
2442 hcom_data.incl.pl1 cobol_rts_data.incl.pl1
2443 laser_sheet_template.incl.pl1 call_dtype_fcns.incl.pl1
2444 pitmsg.incl.pl1 pl1_symbol_type_fcns.incl.pl1
2445 rmdb_finish_transaction.incl.pl1 call_entry_info_.incl.pl1
2446 rmdb_start_transaction.incl.pl1 kst_attributes.incl.pl1
2447 tp_command_table.incl.pl1
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488 Module Changes since MR12.5 A-4 SIB12.6f^L
2489
2490
2491 DELETED SEGMENTS SINCE MR12.5
2492
2493
2494 There have been no deleted modules since MR12.5.
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546 Module Changes since MR12.5 A-5 SIB12.6f^L
2547
2548
2549 MODIFIED SEGMENTS SINCE MR12.5
2550
2551
2552 adjust_cutoff_.pl1 interpret_ptr_.pl1
2553 acct_start_up.ec lib_fetch_.pl1
2554 alm_.pl1 library_pathname.pl1
2555 alm_source_map_.pl1 lisp_status_fns_.pl1
2556 amu_print_.pl1 kst_attributes.incl.pl1
2557 ansi_tape_io_.pl1 load_fnp_.pl1
2558 apl_date_time_.pl1 mail_table_mgr_.pl1
2559 apl_system_variables_.pl1 map355.pl1
2560 as_meters.pl1 mc.incl.alm
2561 audit_.pl1 memo.pl1
2562 azm_display_fdump_events.pl1 meter_fnp_idle.pl1
2563 basic_system.pl1 mlsys_format_.pl1
2564 bound_trace_stack_.bind mlsys_misc_utils_.pl1
2565 bound_video_.bind mlsys_parse_text_.pl1
2566 cobol_rts_.pl1 mtape_control_.pl1
2567 convert_date_to_binary_.rd object_lib_.pl1
2568 countervalidate_label_.pl1 pascal_area_management_.pl1
2569 cref_filegen_.pl1 pascal_operators_.alm
2570 cu_.alm pds_trace_.pl1
2571 cv_pmf.rd pfm_utils_.pl1
2572 cv_ptr_.pl1 pl1.dcl
2573 date_time_.pl1 pl1_date_.pl1
2574 datebin_.pl1 pl1_time_.pl1
2575 db_fnp_env_.pl1 pl1_version.cds
2576 display_account_status_.pl1 poll_mpc.pl1
2577 display_data_.pl1 print_pdt.pl1
2578 dm_per_system_.pl1 print_ready_message_.pl1
2579 e_macops_.lisp print_reqfile.pl1
2580 eb_data_.alm prnam_.pl1
2581 encode_clock_value_.pl1 process_cobol_report.pl1
2582 format_pointer_.pl1 process_dump_segments.pl1
2583 forum_trans_specs_.pl1 proj_usage_report.pl1
2584 g115_protocol_.pl1 rdm_msg_requests_.pl1
2585 gcos_card_utility_.pl1 register_resource.pl1
2586 gcos_mme_time_.pl1 scs_and_clock_init_.pl1
2587 gdos_tss.pl1 set_time_default.pl1
2588 gen_pl1_version_.pl1 sys_info.cds
2589 gtss_abs_login_banner_.pl1 system_performance_graph.pl1
2590 gtss_abs_logout_banner_.pl1 tape_ansi_control_.pl1
2591 gtss_dq_.pl1 test_tape.pl1
2592 gtss_drl_t_cfio_.pl1 tolts_util_.pl1
2593 gtss_drl_time_.pl1 trace_time_.pl1
2594 hcom.pl1 TTF.ttf
2595 hcom_parse_.rd vrm_meter_.pl1
2596 hcom_process_seg_.pl1 winodw_editor_utils_.alm
2597 ibm_tape_io_.pl1 window_io_iox_.pl1
2598 imft_mail_interface_.pl1 window_line_editor.incl.pl1
2599 init_clocks.pl1
2600
2601
2602
2603
2604 Module Changes since MR12.5 A-6 SIB12.6f^L