[0001]
[0002]
[0003]
[0004]
[0005]
[0006]
[0007]
[0008]
[0009]
[0010]
[0011]
[0012]
[0013]
[0014]
[0015]
[0016]
[0017]
[0018]
[0019]
[0020]
[0021]
[0022]
[0023]
[0024]
[0025]
[0026]
[0027]
[0028]
[0029]
[0030]
[0031]
[0032]
[0033]
[0034]
[0035]
[0036]
[0037]
[0038]
[0039]
[0040]
[0041]
[0042]
[0043]
[0044]
[0045]
[0046]
[0047]
[0048]
[0049]
[0050]
[0051]
[0052]
[0053]
[0054]
[0055]
[0056]
[0057]
[0058]
[0059]
[0060]
[0061]
[0062]
[0063]
[0064]
[0065]
[0066]
[0067]
[0068]
[0069]
[0070]
[0071]
[0072]
[0073]
[0074]
[0075]
[0076]
[0077]
[0078]
[0079]
[0080]
[0081]
[0082]
[0083]
[0084]
[0085]
[0086]
[0087]
[0088]
[0089]
[0090]
[0091]
[0092]
[0093]
[0094]
[0095]
[0096]
[0097]
[0098]
[0099]
[0100]
[0101]
[0102]
[0103]
[0104]
[0105]
[0106]
[0107]
[0108]
[0109]
[0110]
[0111]
[0112]
[0113]
[0114]
[0115]
[0116]
[0117]
[0118]
[0119]
[0120]
[0121]
[0122]
[0123]
[0124]
[0125]
[0126]
[0127]
[0128]
[0129]
[0130]
[0131]
[0132]
[0133]
[0134]
[0135]
[0136]
[0137]
[0138]
[0139]
[0140]
[0141]
[0142]
[0143]
[0144]
[0145]
[0146]
[0147]
[0148]
[0149]
[0150]
[0151]
[0152]
[0153]
[0154]
[0155]
[0156]
[0157]
[0158]
[0159]
[0160]
[0161]
[0162]
[0163]
[0164]
[0165]
[0166]
[0167]
[0168]
[0169]
[0170]
[0171]
[0172]
[0173]
[0174]
[0175]
[0176]
[0177]
[0178]
[0179]
[0180]
[0181]
[0182]
[0183]
[0184]
[0185]
[0186]
[0187]
[0188]
[0189]
[0190]
[0191]
[0192]
[0193]
[0194]
[0195]
[0196]
[0197]
[0198]
[0199]
[0200]
[0201]
[0202]
[0203]
[0204]
[0205]
[0206]
[0207]
[0208]
[0209]
[0210]
[0211]
[0212]
[0213]
[0214]
[0215]
[0216]
[0217]
[0218]
[0219]
[0220]
[0221]
[0222]
[0223]
[0224]
[0225]
[0226]
[0227]
[0228]
[0229]
[0230]
[0231]
[0232]
[0233]
[0234]
[0235]
[0236]
[0237]
[0238]
[0239]
[0240]
[0241]
[0242]
[0243]
[0244]
[0245]
[0246]
[0247]
[0248]
[0249]
[0250]
[0251]
[0252]
[0253]
[0254]
[0255]
[0256]
[0257]
[0258]
[0259]
[0260]
[0261]
[0262]
[0263]
[0264]
[0265]
[0266]
[0267]
[0268]
[0269]
[0270]
[0271]
[0272]
[0273]
[0274]
[0275]
[0276]
[0277]
[0278]
[0279]
[0280]
[0281]
[0282]
[0283]
[0284]
[0285]
[0286]
[0287]
[0288]
[0289]
[0290]
[0291]
[0292]
[0293]
[0294]
[0295]
[0296]
[0297]
[0298]
[0299]
[0300]
[0301]
[0302]
[0303]
[0304]
[0305]
[0306]
[0307]
[0308]
[0309]
[0310]
[0311]
[0312]
[0313]
[0314]
[0315]
[0316]
[0317]
[0318]
[0319]
[0320]
[0321]
[0322]
[0323]
[0324]
[0325]
[0326]
[0327]
[0328]
[0329]
[0330]
[0331]
[0332]
[0333]
[0334]
[0335]
[0336]
[0337]
[0338]
[0339]
[0340]
[0341]
[0342]
[0343]
[0344]
[0345]
[0346]
[0347]
[0348]
[0349]
[0350]
[0351]
[0352]
[0353]
[0354]
[0355]
[0356]
[0357]
[0358]
[0359]
[0360]
[0361]
[0362]
[0363]
[0364]
[0365]
[0366]
[0367]
[0368]
[0369]
[0370]
[0371]
[0372]
[0373]
[0374]
[0375]
[0376]
[0377]
[0378]
[0379]
[0380]
[0381]
[0382]
[0383]
[0384]
[0385]
[0386]
[0387]
[0388]
[0389]
[0390]
[0391]
[0392]
[0393]
[0394]
[0395]
[0396]
[0397]
[0398]
[0399]
[0400]
[0401]
[0402]
[0403]
[0404]
[0405]
[0406]
[0407]
[0408]
[0409]
[0410]
[0411]
[0412]
[0413]
[0414]
[0415]
[0416]
[0417]
[0418]
[0419]
[0420]
[0421]
[0422]
[0423]
[0424]
[0425]
[0426]
[0427]
[0428]
[0429]
[0430]
[0431]
[0432]
[0433]
[0434]
[0435]
[0436]
[0437]
[0438]
[0439]
[0440]
[0441]
[0442]
[0443]
[0444]
[0445]
[0446]
[0447]
[0448]
[0449]
[0450]
[0451]
[0452]
[0453]
[0454]
[0455]
[0456]
[0457]
[0458]
[0459]
[0460]
[0461]
[0462]
[0463]
[0464]
[0465]
[0466]
[0467]
[0468]
[0469]
[0470]
[0471]
[0472]
[0473]
[0474]
[0475]
[0476]
[0477]
[0478]
[0479]
[0480]
[0481]
[0482]
[0483]
[0484]
[0485]
[0486]
[0487]
[0488]
[0489]
[0490]
[0491]
[0492]
[0493]
[0494]
[0495]
[0496]
[0497]
[0498]
[0499]
[0500]
[0501]
[0502]
[0503]
[0504]
[0505]
[0506]
[0507]
[0508]
[0509]
[0510]
[0511]
[0512]
[0513]
[0514]
[0515]
[0516]
[0517]
[0518]
[0519]
[0520]
[0521]
[0522]
[0523]
[0524]
[0525]
[0526]
[0527]
[0528]
[0529]
[0530]
[0531]
[0532]
[0533]
[0534]
[0535]
[0536]
[0537]
[0538]
[0539]
[0540]
[0541]
[0542]
[0543]
[0544]
[0545]
[0546]
[0547]
[0548]
[0549]
[0550]
[0551]
[0552]
[0553]
[0554]
[0555]
[0556]
[0557]
[0558]
[0559]
[0560]
[0561]
[0562]
[0563]
[0564]
[0565]
[0566]
[0567]
[0568]
[0569]
[0570]
[0571]
[0572]
[0573]
[0574]
[0575]
[0576]
[0577]
[0578]
[0579]
[0580]
[0581]
[0582]
[0583]
[0584]
[0585]
[0586]
[0587]
[0588]
[0589]
[0590]
[0591]
[0592]
[0593]
[0594]
[0595]
[0596]
[0597]
[0598]
[0599]
[0600]
[0601]
[0602]
[0603]
[0604]
[0605]
[0606]
[0607]
[0608]
[0609]
[0610]
[0611]
[0612]
[0613]
[0614]
[0615]
[0616]
[0617]
[0618]
[0619]
[0620]
[0621]
[0622]
[0623]
[0624]
[0625]
[0626]
[0627]
[0628]
[0629]
[0630]
[0631]
[0632]
[0633]
[0634]
[0635]
[0636]
[0637]
[0638]
[0639]
[0640]
[0641]
[0642]
[0643]
[0644]
[0645]
[0646]
[0647]
[0648]
[0649]
[0650]
[0651]
[0652]
[0653]
[0654]
[0655]
[0656]
[0657]
[0658]
[0659]
[0660]
[0661]
[0662]
[0663]
[0664]
[0665]
[0666]
[0667]
[0668]
[0669]
[0670]
[0671]
[0672]
[0673]
[0674]
[0675]
[0676]
[0677]
[0678]
[0679]
[0680]
[0681]
[0682]
[0683]
[0684]
[0685]
[0686]
[0687]
[0688]
[0689]
[0690]
[0691]
[0692]
[0693]
[0694]
[0695]
[0696]
[0697]
[0698]
[0699]
[0700]
[0701]
[0702]
[0703]
[0704]
[0705]
[0706]
[0707]
[0708]
[0709]
[0710]
[0711]
[0712]
[0713]
[0714]
[0715]
[0716]
[0717]
[0718]
[0719]
[0720]
[0721]
[0722]
[0723]
[0724]
[0725]
[0726]
[0727]
[0728]
[0729]
[0730]
[0731]
[0732]
[0733]
[0734]
[0735]
[0736]
[0737]
[0738]
[0739]
[0740]
[0741]
[0742]
[0743]
[0744]
[0745]
[0746]
[0747]
[0748]
[0749]
[0750]
[0751]
[0752]
[0753]
[0754]
[0755]
[0756]
[0757]
[0758]
[0759]
[0760]
[0761]
[0762]
[0763]
[0764]
[0765]
[0766]
[0767]
[0768]
[0769]
[0770]
[0771]
[0772]
[0773]
[0774]
[0775]
[0776]
[0777]
[0778]
[0779]
[0780]
[0781]
[0782]
[0783]
[0784]
[0785]
[0786]
[0787]
[0788]
[0789]
[0790]
[0791]
[0792]
[0793]
[0794]
[0795]
[0796]
[0797]
[0798]
[0799]
[0800]
[0801]
[0802]
[0803]
[0804]
[0805]
[0806]
[0807]
[0808]
[0809]
[0810]
[0811]
[0812]
[0813]
[0814]
[0815]
[0816]
[0817]
[0818]
[0819]
[0820]
[0821]
[0822]
[0823]
[0824]
[0825]
[0826]
[0827]
[0828]
[0829]
[0830]
[0831]
[0832]
[0833]
[0834]
[0835]
[0836]
[0837]
[0838]
[0839]
[0840]
[0841]
[0842]
[0843]
[0844]
[0845]
[0846]
[0847]
[0848]
[0849]
[0850]
[0851]
[0852]
[0853]
[0854]
[0855]
<!DOCTYPE html>
<!-- WASDOC AXP-2.0.0 (CGILIB AXP-1.9.9) -->
<!-- wasDOC Copyright (C) 2019,2020 Mark G.Daniel - Apache-2.0 licenced -->
<!-- 3-NOV-2021 02:50 -->
<noscript>NOTE: SOME FUNCTIONALITY EMPLOYS JAVASCRIPT</noscript>
<div id="erreport1" style="display:none;"></div>
<script>
function errorReport(string) {
for (var cnt = 1; cnt <= 2; cnt++) {
var err = document.getElementById('erreport'+cnt);
err.style.display = 'block';
err.innerHTML += string;
}
}
</script>
<style type="text/css">
html { font-family: arial, verdana, sans-serif; font-size:12pt; margin:1em; }
h1 { font-size:124%; font-style:bold;
margin-top:1em; margin-bottom:0.5em; }
h2 { font-size:120%; font-style:bold;
margin-top:1.1em; margin-bottom:0.4em; }
h3 { font-size:116%; font-style:bold;
margin-top:1.0em; margin-bottom:0.3em; }
h4 { font-size:112%; font-style:bold;
margin-top:1.1em; margin-bottom:0.3em; }
h5 { font-size:112%; font-style:bold;
margin-top:1.1em; margin-bottom:0.3em; }
h6 { font-size:112%; font-style:bold; padding:0; margin:0; }
h1 .text { text-decoration:underline; }
h1 .numb { padding-right:0.8em; }
h1 .numb:empty { display:none; padding-right:0; }
h2 .numb { padding-right:0.8em; }
h2 .numb:empty { display:none; padding-right:0; }
h3 .numb { padding-right:0.8em; }
h3 .numb:empty { display:none; padding-right:0; }
h4 .numb { padding-right:0.8em; }
h4 .numb:empty { display:none; padding-right:0; }
h5 .numb { display:none; padding-right:0; }
h6 .numb { display:none; padding-right:0; }
kbd { font-family:monospace; }
noscript { font-size:1.2em; }
p { line-height:1.1em; margin-top:1em; margin-bottom:1em; }
.chunk { font-size:130%; text-decoration:underline; }
.head {}
.high {}
.bold { font-weight:bold; }
.center { text-align:center; }
.italic { font-style:italic; }
.left { text-align:left; }
.nowrap { white-space:nowrap; }
.prewrap { white-space:pre; }
.right { text-align:right; }
.strike { text-decoration:line-through; }
.under { text-decoration:underline; }
.backlight { background-color:#f2f2f2; }
.display0 { display:none; }
img { max-width:100%; }
.imglink { }
.link { }
.blank { }
.list { margin-bottom:1em; }
.list li { margin-top:0.5em; }
.list0 li { margin-top:0; }
.item {}
.tabl { border-collapse:collapse; text-align:left; margin:0.4em 2em 0.5em 2em; }
.tabu { border-collapse:collapse; text-align:right; margin:0.4em 2em 0.5em 2em; }
.tabr { vertical-align:top; }
.tabh { padding:0.2em 0 0 2em; margin:0; }
.tabd { padding:0.1em 0 0 2em; margin:0; }
.tabh:first-of-type, td:first-of-type { padding-left:0; }
.tabu .tabh,
.tabu .tabd { border:1px solid gray; padding:0.2em 0.3em 0.2em 0.3em; }
.tab0 { border:none; visibility:hidden; max-width:1em;
white-space:nowrap; overflow:hidden; }
.tabauto { margin-left:auto; margin-right:auto; }
.tabr:empty { height:0.2em; }
.tabu .tabh:empty, .tabu .tabd:empty { border:none; visibility:hidden; }
.error { font-size:110%; color:black; background-color:yellow;
font-family:sans-serif; font-weight:bold; font-style:normal;
width:95%; border:solid 1px gray; padding:0.5em 1em 0.5em 1em; }
.error::before { content:'\026a0\00a0'; }
.image { }
.page { width:98%; border:1px dashed gray; margin:1.5em 0 1.8em 0; }
.epage { width:98%; border:1px dashed black; margin:1.5em 0 1.8em 0; }
.monosp { font-family:monospace; }
.ppage { display:none; }
.simple { list-style-type:none; }
.valtop { vertical-align:top; }
.valmid { vertical-align:middle; }
.valbot { vertical-align:bottom; }
.code { border-style:solid; border-width:0 0 0 1px; padding-left:1em;
font-family:monospace; white-space:pre; }
.block { }
.blockof { margin:0.4em 2em 0.5em 2em; }
.example { border-style:dashed; border-width:0 0 0 1px; padding-left:1em;
margin-top:0.5em; margin-bottom:0.5em; white-space:pre; }
.indent { margin-left:2em; margin-right:2em; }
.noindent { margin-left:0; margin-right:0; }
.inblock { display:inline-block; }
.mono { white-space:pre; font-family:monospace; }
.note { margin:0.4em 2em 0.5em 2em; page-break-inside:avoid; }
.note h5 { margin-top:0 }
.note_hr { width:80%; border:1px solid gray; }
.prop { padding-left:1em; margin-top:0.5em; margin-bottom:0.5em; }
.quote { border-style:dashed; border-width:0 0 0 1px; padding-left:1em;
margin-top:0.5em; margin-bottom:0.5em; }
.this { display:none; }
a:link,a:visited { color:black; text-decoration:none; }
a:hover,a:active { text-decoration:underline; }
a:focus { outline:0; }
:target:before { content:''; display:block; height:0.1em; margin:-0.1em; }
a.link:link, a.link:visited,a.link:active
{ color:midnightBlue; text-decoration:underline; text-decoration-style:solid; }
.TOC1cols1 { width:80%; max-width:80%; }
.TOC1cols2 { column-count:2; width:80%; max-width:80%; }
.TOC1cols3 { column-count:3; max-width:90%; max-width:90%; }
.TOC1cols4 { column-count:4; max-width:100%; max-width:100%; }
.TOC1table { margin-left:2em; white-space:nowrap; break-inside:auto; }
.TOC1table tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.TOC1table td+td { padding:0 0 0 0.5em; }
.TOC1table .numb { width:3em; max-width:3em; }
.TOC1table .sepr { width:5em; max-width:6em; overflow:hidden; }
.TOC1table .majr { font-weight:bold; }
.TOC1table .text { white-space:normal; }
/* These are due to Firefox (at least <= 76) recalcitrant multi-column handling.
Web search "Split table into css columns, issue in Firefox" (stackoverflow).
"Good grief, Charlie Brown!" */
.TOC1cols2 table,
.TOC1cols2 tbody,
.TOC1cols2 tr,
.TOC1cols3 table,
.TOC1cols3 tbody,
.TOC1cols3 tr,
.TOC1cols4 table,
.TOC1cols4 tbody,
.TOC1cols4 tr { display:block; padding:0; }
.TOC2cols1 { width:60%; max-width:60%; }
.TOC2cols2 { column-count:2; width:70%; max-width:70%; }
.TOC2cols3 { column-count:3; width:80%; max-width:80%; }
.TOC2cols4 { column-count:4; width:90%; max-width:90%; }
.TOC2table { margin-left:2em; white-space:nowrap; break-inside:auto; }
.TOC2table tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.TOC2table .numb { font-weight:bold; padding-right:0.5em; }
.TOC2table .text { width:100%; white-space:normal; }
/* see "recalcitrant" above */
.TOC2cols2 table,
.TOC2cols2 tbody,
.TOC2cols2 tr,
.TOC2cols3 table,
.TOC2cols3 tbody,
.TOC2cols3 tr,
.TOC2cols4 table,
.TOC2cols4 tbody,
.TOC2cols4 tr { display:block; padding:0; }
.NAVtable { margin:0.1em 0 0 2em; }
.NAVtable td { font-size:110%; font-weight:bold; padding:0; margin:0; }
.NAVtable a { padding:0 0.5em 0 0.5em; text-decoration:none; }
.IDXcols1 { width:80%; max-width:80%; }
.IDXcols2 { column-count:2; width:90%; max-width:90%; }
.IDXcols3 { column-count:3; width:95%; max-width:95%; }
.IDXcols4 { column-count:4; width:100%; max-width:100%; }
.IDXtable { margin:1em 0 1em 2em; white-space:nowrap; break-inside:auto; }
.IDXtable tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.IDXtable .alpha { font-weight:bold; min-width:2em; }
.IDXtable .text { width:100%; white-space:normal; }
.IDXtable .para:before { content:'\00b6\00a0'; }
/* see "recalcitrant" above */
.IDXcols2 table,
.IDXcols2 tbody,
.IDXcols2 tr,
.IDXcols3 table,
.IDXcols3 tbody,
.IDXcols3 tr,
.IDXcols4 table,
.IDXcols4 tbody,
.IDXcols4 tr { display:block; padding:0; }
.insight { background-color:cyan; font-family:monospace;
padding:0 0.2em 0 0.2em; margin:0 0.2em 0 0.2em;
font-size:100%; font-style:normal; font-weight:normal;
text-decoration:none; }
.wasdoc { font-family: "Lucida Console", Monaco, monospace;
letter-spacing:-0.07em; }
@media screen { .blank::after { content:"\2924"; }
.print { display:none; }
}
@media print {
table { page-break-inside:avoid; }
.noprint { display:none; }
.page { border:none; page-break-after: always; }
.epage { display:none; }
.ppage { page-break-after:always; }
.NAVtable { display:none; }
.NAVprint { display:block!important; }
}
@page { margin:2cm 1cm 2cm 1cm; }
</style>
<!-- source:0000_INSTALL.WASDOC -->
<style type="text/css">._smiley::after { font-size:150%; vertical-align:middle; content:'\263a' }</style>
<style type="text/css">._frowny::after { font-size:150%; vertical-align:middle; content:'\2639' }</style>
<a id="0." href="#"></a>
<title>WASD Install and Update – Installation</title>
<a id="2." href="#"></a>
<a id="2.installation" href="#"></a>
<a id="installation" href="#"></a>
<h1 class="head chunk">WASD Install and Update</h1>
<h1 class="head"><span class="numb">2.</span><span class="text">Installation</span></h1>
<div class="TOC2cols2">
<table class="TOC2table">
<tr><td><a href="install002.html#2.1.packageunzip"><span class="numb">2.1</span><span class="text">Package UNZIP</span></a>
<tr><td><a href="install002.html#2.2.packagedirectorystructure"><span class="numb">2.2</span><span class="text">Package Directory Structure</span></a>
<tr><td><a href="install002.html#2.3.ods5volume"><span class="numb">2.3</span><span class="text">ODS-5 Volume</span></a>
<tr><td><a href="install002.html#2.4.accessiblevolume"><span class="numb">2.4</span><span class="text">Accessible Volume</span></a>
<tr><td><a href="install002.html#2.5.diskquota"><span class="numb">2.5</span><span class="text">Disk Quota</span></a>
<tr><td><a href="install002.html#2.6.vms6n"><span class="numb">2.6</span><span class="text">VMS 6.n</span></a>
<tr><td><a href="install002.html#2.7.sysuafandrightslist"><span class="numb">2.7</span><span class="text">SYSUAF and RIGHTSLIST</span></a>
<tr><td><a href="install002.html#2.8.tcpipinfrastructure"><span class="numb">2.8</span><span class="text">TCP/IP Infrastructure</span></a>
<tr><td><a href="install002.html#2.9.installcomprocedure"><span class="numb">2.9</span><span class="text">INSTALL.COM Procedure</span></a>
<tr><td><a href="install002.html#2.10.quickcheck"><span class="numb">2.10</span><span class="text">Quick-Check</span></a>
<tr><td><a href="install002.html#2.11.localsetupsuggestions"><span class="numb">2.11</span><span class="text">Local Setup Suggestions</span></a>
<tr><td><a href="install002.html#2.12.reportingproblems"><span class="numb">2.12</span><span class="text">Reporting Problems</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="install001.html#1.">↖︎</a>
<td><a href="install000.html#0.">↑︎</a>
<td><a href="install003.html#3.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> The WASD package is distributed as ZIP archives.
<p> It generally pays to use the latest version of VMS UNZIP available.
Archives will contain a comment about the minimum version required, check that
as described in the next paragraph. To show the version of the current UNZIP
utility, use
<div class="blockof code">$ UNZIP -v
</div>
<p> The ZIP archive will contain brief installation instructions. Use the
following command to read this and any other information provided.
<div class="blockof code">$ UNZIP -z device:[dir]archive.ZIP
</div>
<p> It is recommended to check the integrity of, then list the contents of, the
archive before UNZIPing.
<div class="blockof code">$ UNZIP -t device:[dir]archive.ZIP
$ UNZIP -l device:[dir]archive.ZIP
</div>
<p> The archive will have the structure:
<div class="blockof code">KLAATU$ unzip -l dka100:[WASD]wasd1200.zip;1
Archive: DKA100:[WASD]wasd1200.zip;1
Copyright (C) 1996-2021 Mark G.Daniel
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
* FULL RELEASE of v12.0.0 (1 November 2021)
**************************************************
*** CONTAINS SOURCE FILES, DOCUMENTATION, ETC. ***
**************************************************
Package must be built using INSTALL or UPDATE as described below.
* To install files:
$ SET DEFAULT device:[000000]
$ UNZIP device:[dir]WASD1200.ZIP
* To build/link images use the appropriate one of:
$ @device:[WASD_ROOT]INSTALL
$ @WASD_ROOT:[000000]UPDATE
* Contains build refinements to ease cross-compiling for x86-64 VMS.
VMS file attributes saved ... use UnZip 5.2+ on OpenVMS
Archive created 1-NOV-2021
Length Date Time Name
-------- ---- ---- ----
0 10-24-21 09:04 wasd_root/axp-bin/
0 10-24-21 09:04 wasd_root/axp/
0 10-24-21 09:04 wasd_root/cgi-bin/
0 10-24-21 09:04 wasd_root/doc/
0 10-24-21 09:04 wasd_root/example/
0 10-24-21 09:04 wasd_root/exercise/
2734 03-06-03 17:20 wasd_root/favicon.ico
<span class="high italic">8< snip 8<</span>
40221 10-04-21 21:37 wasd_root/wasdoc/scripting/scripting012.html
18156 10-04-21 21:37 wasd_root/wasdoc/scripting/scripting013.html
442 09-21-20 12:13 wasd_root/x86_64-bin/readme.html
464 09-20-20 10:10 wasd_root/x86_64/readme.html
-------- -------
23868969 1009 files
</div>
<a id="2.1" href="#"></a>
<a id="2.1.packageunzip" href="#"></a>
<a id="packageunzip" href="#"></a>
<h2 class="head"><span class="numb">2.1</span><span class="text">Package UNZIP</span></h2>
<p> The archive contains the complete directory tree. Hence it is necessary
to SET DEFAULT into the top-level directory of the volume the package is to be
installed on.
<div class="blockof code">$ SET DEFAULT device:[000000]
$ UNZIP device:[dir]archive.ZIP
</div>
<a id="2.1.0.0.1" href="#"></a>
<a id="2.1.sourcearchiveobjectmodulearchives" href="#"></a>
<a id="sourcearchiveobjectmodulearchives" href="#"></a>
<h5 class="head"><span class="text">Source Archive, Object Module Archives</span></h5>
<p> The complete package, source code, documentation, examples, etc., is
provided in a single main archive. Installation and other build procedures
allow the entire package to be compiled and linked from this if prefered. This
requires a later version of DEC C (preferably v6.<span class="high italic">n</span> or greater).
<p> In addition, for those unable or not wishing to fully build the
distribution, three other platform-specific archives are available, AXP (Alpha)
IA64 (Itanium) and X86, containing a complete set of object modules, allowing
the package to be built via a link operation only.
<p> If a complete build is planned then only the main archive is required. If
a link-only build then an additional archive for each architecture must be
UNZIPed as described above. This applies to both full installations and
subsequent updates. The archives will be clearly identified with the
architecture type, as illustrated in this example.
<div class="blockof code">$ UNZIP device:[dir]archive-AXP.ZIP
$ UNZIP device:[dir]archive-IA64.ZIP
$ UNZIP device:[dir]archive-X86.ZIP
</div>
<div class="note"><a id="2.1.0.0.1.1" href="#"></a>
<a id="2.1.note" href="#"></a>
<a id="note" href="#"></a>
<h5 class="head center"><span class="text">Note</span></h5>
<hr class="note_hr">
The WASD distribution and package organisation fully supports
mixed-architecture clusters (AXP, Itanium and/or x86-64 in the one cluster) as
one integrated installation.
<hr class="note_hr">
</div>
<a id="2.1.0.0.2" href="#"></a>
<a id="2.1.wasdopensslarchive" href="#"></a>
<a id="wasdopensslarchive" href="#"></a>
<h5 class="head"><span class="text">WASD OpenSSL Archive</span></h5>
<p> Building an SSL-capable version of the server is a common requirement.
WASD SSL is discussed in detail in
<a class="link blank" target="_blank" href="../features/#transportlayersecurity">Transport Layer Security</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>.
and if using the WASD SSL package it is also possible to install (or update)
that package after UNZIPing the primary archive and optional object module(s).
As noted in the above SSL section, the server can also be built against an
existing VMS SSL product and an existing OpenSSL installation.
<div class="note"><a id="2.1.0.0.2.1" href="#"></a>
<a id="2.1.note" href="#"></a>
<a id="note" href="#"></a>
<h5 class="head center"><span class="text">Note</span></h5>
<hr class="note_hr">
The WASD OpenSSL kit is designed as an update to an existing WASD installation
and so expects to be UNZIPed under the root directory. Note the use of the
"-d" switch in the following example.
<hr class="note_hr">
</div>
<p>
<div class="blockof code">$ UNZIP -d [.WASD_ROOT] device:[dir]OPENSSLWASD<span class="high italic">nnn-arch</span>.ZIP
</div>
<a id="2.2" href="#"></a>
<a id="2.2.packagedirectorystructure" href="#"></a>
<a id="packagedirectorystructure" href="#"></a>
<h2 class="head"><span class="numb">2.2</span><span class="text">Package Directory Structure</span></h2>
<p> The package directories and content are organised as follows. Note that
only some of these can be accessed by the server account (and therefore seen in
server-generated directory listings) due to directory and file protections
(see <a class="link blank" target="_blank" href="../config/#recommendedpackagesecurity">Recommended Package Security</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>).
<p>
<span class="high center"><span class="high bold">Package Directory Structure</span></span>
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Directory
<th class="tabh">Description
<tr class="tabr">
<tr class="tabr">
<td class="tabd"><span class="high monosp">[AXP-BIN]</span>
<td class="tabd">Alpha executable script files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[AXP]</span>
<td class="tabd">Alpha build and utility area
<tr class="tabr">
<td class="tabd"><span class="high monosp">[CGI-BIN]</span>
<td class="tabd">architecture-neutral script files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[EXAMPLE]</span>
<td class="tabd">package examples
<tr class="tabr">
<td class="tabd"><span class="high monosp">[EXERCISE]</span>
<td class="tabd">package test files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[HTTP$NOBODY]</span>
<td class="tabd">scripting account default home area
<tr class="tabr">
<td class="tabd"><span class="high monosp">[HTTP$SERVER]</span>
<td class="tabd">server account default home area
<tr class="tabr">
<td class="tabd"><span class="high monosp">[IA64-BIN]</span>
<td class="tabd">Itanium executable script files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[IA64]</span>
<td class="tabd">Itanium build and utility area
<tr class="tabr">
<td class="tabd"><span class="high monosp">[INSTALL]</span>
<td class="tabd">installation, update and security procedures
<tr class="tabr">
<td class="tabd"><span class="high monosp">[LOCAL]</span>
<td class="tabd">site configuration files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[LOG]</span>
<td class="tabd">site access logs
<tr class="tabr">
<td class="tabd"><span class="high monosp">[LOG_SERVER]</span>
<td class="tabd">server process (SYS$OUTPUT) logs
<tr class="tabr">
<td class="tabd"><span class="high monosp">[RUNTIME]</span>
<td class="tabd">graphics, help files, etc.
<tr class="tabr">
<td class="tabd"><span class="high monosp">[SCRATCH]</span>
<td class="tabd">working file space for scripts
<tr class="tabr">
<td class="tabd"><span class="high monosp">[SCRIPT]</span>
<td class="tabd">example architecture-neutral scripts
<tr class="tabr">
<td class="tabd"><span class="high monosp">[SRC]</span>
<td class="tabd">package source files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[STARTUP]</span>
<td class="tabd">package startup procedures
<tr class="tabr">
<td class="tabd"><span class="high monosp">[WASDOC]</span>
<td class="tabd">package documentation
<tr class="tabr">
<td class="tabd"><span class="high monosp">[X86_64-BIN]</span>
<td class="tabd">x86-86 executable script files
<tr class="tabr">
<td class="tabd"><span class="high monosp">[X86_64]</span>
<td class="tabd">x86-64 build and utility area
</table>
<a id="2.3" href="#"></a>
<a id="2.3.ods5volume" href="#"></a>
<a id="ods5volume" href="#"></a>
<h2 class="head"><span class="numb">2.3</span><span class="text">ODS-5 Volume</span></h2>
<p> The WASD package can be installed on and used from ODS-5 (extended file
specification) volumes. Note that the installation procedures and file system
organisation of the package tree has been designed for ODS-2 compliance. (Of
course the issue of installing WASD on an ODS-5 volume is completely separate
from the ability to serve the contents of an ODS-5 volume!)
<a id="2.4" href="#"></a>
<a id="2.4.accessiblevolume" href="#"></a>
<a id="accessiblevolume" href="#"></a>
<h2 class="head"><span class="numb">2.4</span><span class="text">Accessible Volume</span></h2>
<p> Unlikely as it might be to install the package on a private or otherwise
protected volume, the server and scripting accounts being unprivileged in
themselves, require access sufficient to read, write and delete files from the
volume (disk). The following illustrates how to check this and what the
protections should look like. Generally any device that an unprivileged user
can use the server accounts can use.
<div class="blockof code">$ SHOW SECURITY /CLASS=VOLUME DKA100:
ALPHASYS object of class VOLUME
Owner: [1,1]
Protection: (System: RWCD, Owner: RWCD, Group: RWCD, World: RWCD)
Access Control List: <empty>
</div>
<a id="2.5" href="#"></a>
<a id="2.5.diskquota" href="#"></a>
<a id="diskquota" href="#"></a>
<h2 class="head"><span class="numb">2.5</span><span class="text">Disk Quota</span></h2>
<p> Should WASD_ROOT be located on a volume with disk quota enabled then
suitable entries must exist for the server account (default HTTP$SERVER),
SYSTEM account, and any scripting account(s) (default HTTP$NOBODY). The server
account requires quota for the server process log, SYSTEM (due to SYSPRV use)
for access log(s), and scripting account(s) requiring default temporary storage
([SCRATCH]) during processing.
<a id="2.6" href="#"></a>
<a id="2.6.vms6n" href="#"></a>
<a id="vms6n" href="#"></a>
<h2 class="head"><span class="numb">2.6</span><span class="text">VMS 6.<span class="high italic">n</span></span></h2>
<p> As of WASD v10.1 the minimum supported version for build and operation
is VMS V7.0. Had to drag ourselves into the mid-1990s at some stage!
<a id="2.7" href="#"></a>
<a id="2.7.sysuafandrightslist" href="#"></a>
<a id="sysuafandrightslist" href="#"></a>
<h2 class="head"><span class="numb">2.7</span><span class="text">SYSUAF and RIGHTSLIST</span></h2>
<div class="note">
<a id="2.7.0.0.1" href="#"></a>
<a id="2.7.warning" href="#"></a>
<a id="warning" href="#"></a>
<h5 class="head center"><span class="text">WARNING!</span></h5>
<hr class="note_hr">
The WASD installation procedure does, and to a lesser degree the update
procedure can, <span class="high bold">make additions and/or modifications to SYSUAF.DAT and
RIGHTLIST.DAT</span>, for default server and scripting accounts and to
facilitate their access to the package directory tree.
<p> Also, <span class="high bold">when the server image begins execution it may add an
identifier</span>, required for script process management, to RIGHTSLIST.DAT.
<p> These behaviours must be considered in site environments where such changes
are prohibited or closely controlled.
<hr class="note_hr">
</div>
<a id="2.8" href="#"></a>
<a id="2.8.tcpipinfrastructure" href="#"></a>
<a id="tcpipinfrastructure" href="#"></a>
<h2 class="head"><span class="numb">2.8</span><span class="text">TCP/IP Infrastructure</span></h2>
<p> The WASD installation assumes that the system's TCP/IP infrastructure is
correctly installed and configured, and is operating normally. For example, it
is not unknown for a freshly built system to experience host name resolution
problems preventing its own host name from being resolved and making even
elementary server startup impossible.
<a id="2.8.0.0.0.999" href="#"></a>
<a id="2.8.dclprocedureinstallcom" href="#"></a>
<a id="dclprocedureinstallcom" href="#"></a>
<h6 class="head display0"><span class="text">DCL procedure INSTALL.COM</span></h6>
<a id="2.9" href="#"></a>
<a id="2.9.installcomprocedure" href="#"></a>
<a id="installcomprocedure" href="#"></a>
<h2 class="head"><span class="numb">2.9</span><span class="text">INSTALL.COM Procedure</span></h2>
<p> The INSTALL.COM procedure assists with the first installation of
WASD. It provides a <span class="high italic">vanilla</span> setup, using the standard directories
and account environment described in this document. All sections prompt
before performing any action and generally default to "no". Read the
information and questions carefully!
<p> After UNZIPing the package do the following:
<div class="blockof code">$ SET DEFAULT device:[WASD_ROOT]
$ @INSTALL
</div>
<p> It performs the following tasks:
<ol class="list">
<li class="item"> <span class="high bold">Build Executables – </span>
Either compile sources and link, or just link package object code to produce
images for the local version of VMS. If the system has a suitable SSL toolkit
the installer is requested whether an SSL enabled version be built.
<li class="item"> <span class="high bold">Check Package – </span>
Executes a procedure that runs up the HTTPd in demonstration mode. Allows the
server build to be verified.
<li class="item"> <span class="high bold">Create Server and Scripting Accounts – </span>
Create two, independent accounts, one for executing the server, the other for
executing scripts (<a class="link" href="install004.html#4.1.vmsserveraccount">4.1 VMS Server Account</a>). If quotas are enabled on
the target disk provides an ambit allocation for these accounts. Review this
at some stage.
<li class="item"> <span class="high bold">Set Package Security – </span>
This section traverses the newly installed tree and sets all package
directories and files to required levels of access. For directory settings see
<a class="link blank" target="_blank" href="../config/#maintainingpackagesecurity">Maintaining Package Security</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>.
<li class="item"> <span class="high bold">Copy Support and Configuration Files – </span>
Copy the example server support and configuration files
(<a class="link" href="install004.html#4.3.accountsupportfiles">4.3 Account Support Files</a>).
<li class="item"> <span class="high bold">Install Scripts – </span>
Selectively copy groups of scripts from package build directories into the
scripting directories.
</ol>
<p> Support files to consider when customizing startup, etc.
(<a class="link" href="install004.html#4.3.accountsupportfiles">4.3 Account Support Files</a>):
<ul class="list simple list0">
<li class="item"> STARTUP.COM
<li class="item"> STARTUP_LOCAL.COM
<li class="item"> STARTUP_SERVER.COM
</ul>
<a id="2.10" href="#"></a>
<a id="2.10.quickcheck" href="#"></a>
<a id="quickcheck" href="#"></a>
<h2 class="head"><span class="numb">2.10</span><span class="text">Quick-Check</span></h2>
<p> Once installed or updated it is possible to check the basic package at any
time using the <span class="high monosp">[INSTALL]DEMO.COM</span> procedure. This invokes the server image
using the /DEMO qualifier allowing some behaviours not possible under general
use. Follow the displayed instructions. Basically, the server should start
and become reachable via port number 7080. So, to test availability, using
your prefered browser enter the URL listed on line starting with
"%HTTPD-I-SERVICE" and the WASD welcome page should be displayed.
<p> If a TLS (SSL) -enabled server has been built the demonstration server will
also provide a TLS port number 7443 for access (this also can be explicitly
activated using <span class="high monosp">@[INSTALL]DEMO.COM SSL</span>). WASD will dynamically generate a
X509 certificate for use by the service. In modern browsers there are security
constraints associated with self-signed certificates — lots! Interestingly,
<span class="high bold">Incognito/[In]Private instances</span> of a browser are often more relaxed about
accepting certificates with security deficiencies (at least at the time of
writing), so perhaps try those with the demonstration server. Also see
<a class="link" href="../features/#servercertificate">Server Certificate</a> in <a class="link" href="../features/#0.">WASD Features</a>.
<div class="blockof code">X86VMS$ @wasd_root:[install]demo
Copyright (C) 1996-2021 Mark G.Daniel
-------------------------------------
Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this software except in compliance with the License. Unless required
by applicable law or agreed to in writing, software distributed under the
License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
OF ANY KIND, either express or implied. See the License for the specific
language governing permissions and limitations under the License.
http://www.apache.org/licenses/LICENSE-2.0
*******************************
* WASD PACKAGE DEMONSTRATOR *
*******************************
When finished using demonstrator abort server execution using control-Y
(a subprocess will be spawned to preserve current process environment)
Use a browser to access either of the "%HTTPD-I-SERVICE"s when the server
starts. (There will be one for a standard service and another for SSL.)
The server will be running in promiscuous mode!
Any username with the password specified below can be used for authentication.
Enter a string to use as a password when later prompted by your browser.
Password (for demo authentication)? []: testing
%DCL-S-SPAWNED, process SYSTEM_32419 spawned
%DCL-S-ATTACHED, terminal now attached to process SYSTEM_32419
%HTTPD-I-SOFTWAREID, HTTPd-WASD/12.0.0 OpenVMS/X86 SSL
WASD VMS Web Services, Copyright (C) 1996-2021 Mark G.Daniel.
Licensed under the Apache License, Version 2.0 (the "License").
Software under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See http://www.apache.org/licenses/LICENSE-2.0
%HTTPD-I-IMAGE, HTTPD_SSL 12.0.0 31-OCT-2021 07:38:27.62 DKA100:[wasd_root.][x86_64]HTTPD_SSL.EXE;1
%HTTPD-I-STARTUP, 01-NOV-2021 11:47:05
%HTTPD-I-ALIGN, start collecting alignment faults (64kB,128,0xFFFFFFFF)
%HTTPD-I-WASD_ROOT, DKA100:[WASD_ROOT]
%HTTPD-I-ENVIRONMENT, 0
%HTTPD-I-SYSTEM, innotek GmbH VirtualBox VMS V9.1-A
%HTTPD-W-SYSPRV, operating with implicit SYSPRV (UIC group 1)
%HTTPD-I-TCPIP, HP TCPIP$IPC_SHR X6.0-12 (31-AUG-2021 20:01:12.49)
%HTTPD-I-MODE, INTERACTIVE
%HTTPD-I-ODS5, supported by x86-64 VMS V9.1-A
%HTTPD-I-ODS, directory parser enabled
%HTTPD-I-GMT, +10:30
%HTTPD-I-INSTANCE, supervisor
%HTTPD-W-GZIP, shareable image not found
%HTTPD-I-INSTANCE, 1 process
%HTTPD-I-SSL, OpenSSL 1.1.1k 25 Mar 2021 (0x101010BF)
-SSL-I-PROTOCOL, TLSv1,TLSv1.1,TLSv1.2,TLSv1.3
-SSL-I-OPTIONS, 0x80410854
-SSL-I-SNI, Server Name Indication enabled
-SSL-W-DH, no ephemeral DH param
%HTTPD-I-HTTP2, enabled
%HTTPD-W-HTTP2, network read buffer size increased to 16384 bytes
%HTTPD-I-VM, HTTP/2 zone initialised
%HTTPD-I-INSTANCE, process name WASD:7080
%HTTPD-I-WEBDAV, disabled
%HTTPD-W-AUTH, 1 informational, 1 warning, 0 errors at load
1.w PROMISCUOUS authenticating any username with specified password!
2.i Cache for 32 records of 768 bytes in local storage of 49 page(let)s
%HTTPD-W-MAP, 1 informational, 0 warning, 0 errors at load
1.i ODS-5 processing enabled
%HTTPD-I-PROXYVERIFY, for 32 records in local storage of 14 page(let)s
%HTTPD-I-SCRIPTING, as HTTP$NOBODY
%HTTPD-I-VM, request zone initialised
%HTTPD-I-DCL, subprocess scripting
%HTTPD-I-DCL, with HTTP/2 enabled SYS$OUTPUT mailbox might be more efficient at 16375 bytes
%HTTPD-I-VM, cache zone initialised
%HTTPD-I-ACTIVITY, created global section of 1312 page(let)s
%HTTPD-I-SERVICE, http://x86vms.lan:7080
%HTTPD-I-SERVICE, https://x86vms.lan:7443
%HTTPD-I-SSL, x86vms.lan:7443
Generate x86vms.lan 2048 bit private key:
...........................................+++++
...........................................+++++
%HTTPD-I-DEMO, demonstration mode
1.i subprocess scripting
2.i promiscuous authentication
3.i directory access control files ignored
4.i [DirAccess] enabled
5.i [DirMetaInfo] enabled
6.i [DirWildcard] enabled
7.i [Logging] disabled
8.i [ReportBasicOnly] disabled
9.i [ReportMetaInfo] enabled
%HTTPD-I-BEGIN, 01-NOV-2021 11:47:09, WASD:7080 accepting requests
</div>
<p> When <span class="high italic">http://the.host.name:7080</span> is accessed the browser
should display the package home page
<p> <img class="image indent" src="./empoweredby.png">
<div class="note"><a id="2.10.0.0.0.1" href="#"></a>
<a id="2.10.note" href="#"></a>
<a id="note" href="#"></a>
<h5 class="head center"><span class="text">Note</span></h5>
<hr class="note_hr">
The WASD server which is started by the <span class="high monosp">[INSTALL]DEMO.COM</span> procedure does
not have the full environment setup at that time. It is deliberately limited
to the single process context. For instance, do not try to execute the
command-line directives described in this document.
<hr class="note_hr">
</div>
<a id="2.11" href="#"></a>
<a id="2.11.localsetupsuggestions" href="#"></a>
<a id="localsetupsuggestions" href="#"></a>
<h2 class="head"><span class="numb">2.11</span><span class="text">Local Setup Suggestions</span></h2>
<p> Package updates <span class="high bold">will never</span> contain anything in these
directories:
<ul class="list simple list0">
<li class="item monosp"> WASD_ROOT:[HTTP$NOBODY]
<li class="item monosp"> WASD_ROOT:[HTTP$SERVER]
<li class="item monosp"> WASD_ROOT:[LOCAL]
<li class="item monosp"> WASD_ROOT:[STARTUP]
</ul>
<p> To prevent the overwriting of local configuration files it is suggested
these be placed in the WASD_ROOT:[LOCAL] directory. Local authentication
databases could also be placed in the [LOCAL] directory. Startup files can be
placed where the local site manages system startup. These could be placed
in the WASD_ROOT:[STARTUP] directory.
<a id="2.12" href="#"></a>
<a id="2.12.reportingproblems" href="#"></a>
<a id="reportingproblems" href="#"></a>
<h2 class="head"><span class="numb">2.12</span><span class="text">Reporting Problems</span></h2>
<p> This package, as is generally the case with freeware, is mainly developed
and supported outside of the author's main occupation and working hours.
Reports of problems and bugs (while not necessarily welcome :-), as well as
general queries, are responded to as soon as practicable. If the documentation
is inaccurate or could benefit from clarification in some area please advise of
this also (the better the documentation the less queries you have to field
personally … or so the theory goes).
<p> With all reports please include the version of the server or script, and
the hardware platform, operating system and TCP/IP package and version in use.
<p> If a server error message is being generated please examine the HTML source
of the error page. The "<META...>" information contains
version information as well as valuable source code module and line
information. Include this with the report.
<p> If the server is exiting with a server-generated error message this
information also contains module and line information. Please include this
with the report.
<p> The WATCH facility is often a powerful tool for problem investigation. It
is also very useful when supplying details during problem resolution. <span class="high bold">When
supplying WATCH output as part of a problem report please ZIP the file and
include it an an e-mail attachment.</span> Mailers often mangle the report format
making it difficult to interpret.
<p> Image crash dumps may also be generated, although these are of less value
than the case of the previous two.
<p> Reports may be e-mailed to <a class="link" href="mailto:Mark.Daniel@wasd.vsm.com.au">Mark.Daniel@wasd.vsm.com.au</a> or if a
suscriber, to <a class="link" href="mailto:info-WASD@vsm.com.au">info-WASD@vsm.com.au</a>.
<!-- source:0300_UPDATE.WASDOC -->
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="install001.html#1.">↖︎</a>
<td><a href="install000.html#0.">↑︎</a>
<td><a href="install003.html#3.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>