[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]
<!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 – New to WASD? Start Here!</title>
<a id="1." href="#"></a>
<a id="1.newtowasdstarthere" href="#"></a>
<a id="newtowasdstarthere" href="#"></a>
<h1 class="head chunk">WASD Install and Update</h1>
<h1 class="head"><span class="numb">1.</span><span class="text">New to WASD? Start Here!</span></h1>
<table class="TOC2table">
<tr><td><a href="install001.html#1.1.usingia64hostedx86crosscomplier"><span class="numb">1.1</span><span class="text">Using IA64-hosted X86 Cross-Complier?</span></a>
<tr><td><a href="install001.html#1.2.troubleshooting"><span class="numb">1.2</span><span class="text">Troubleshooting?</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="install000.html#0.">↖︎</a>
<td><a href="install000.html#0.">↑︎</a>
<td><a href="install002.html#2.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<a id="1.0.0.0.1" href="#"></a>
<a id="1.welcome" href="#"></a>
<a id="welcome" href="#"></a>
<h5 class="head"><span class="text">Welcome!</span></h5>
<p> WASD is outlined in the
<a class="link blank" target="_blank" href="../features/#introduction">Introduction</a> and
<a class="link blank" target="_blank" href="../features/#packageoverview">Package Overview</a> sections of the
<a class="link blank" target="_blank" href="../features/#0.">WASD Features</a> document.
<p> There are a number of approaches to installing and updating a WASD package.
<br>The <span class="high italic">vanilla recipes</span> are <a class="link" href="install002.html#2.installation">2. Installation</a> and <a class="link" href="install003.html#3.update">3. Update</a> but there are
<a class="link" href="install005.html#5.otherwaystodeploy">5. Other Ways to Deploy</a>.
<p> This section provides a quick guide to getting your WASD package installed,
configured and serving.
<ol class="list">
<li class="item"> <span class="high bold">Unzip Package</span>
<p> Install the files following the guidelines in <a class="link" href="install002.html#2.installation">2. Installation</a>.
<br> <span class="high bold">Note</span> that more than one archive may be needed
(<a class="link" href="install002.html#2.1.sourcearchiveobjectmodulearchives">‘Source Archive, Object Module Archives’ in 2.1 Package UNZIP</a>).
<p> If <span class="high bold">Transport Layer Security</span> (TLS - a.k.a. <span class="high bold">Secure Sockets Layer</span>
- SSL) is to be used and a TLS/SSL server image to be built the WASD [Open]SSL
product must be installed at this stage (see
<a class="link blank" target="_blank" href="../features/#tlssslfunctionalitysources">TLS/SSL Functionality Sources</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>).
An existing VSI SSL111 for OpenVMS product (all based on OpenSSL 1.0.2 and
earlier obsolete) requires no additional step. If the WASD [Open]SSL package
it must UNZIPed into the [.WASD_ROOT] tree at this stage.
<div class="blockof code">$ UNZIP -d [.WASD_ROOT] device:[dir]OPENSSLWASD<span class="high italic">nnn-arch</span>.ZIP
</div>
<p> Note the use of the <span class="high bold">"-d" switch</span>.
<li class="item"> <span class="high bold">INSTALL Package</span>
<p> Server installation is performed using the INSTALL.COM procedure
(<a class="link" href="install002.html#2.9.installcomprocedure">2.9 INSTALL.COM Procedure</a>).
<ul class="list">
<li class="item"> <span class="high bold">Build Package – </span>
Compile and link, or just link supplied object files to produce VMS
executables for the system's version of VMS.
<li class="item"> <span class="high bold">Check Package – </span>
Check basic operation of the package (<a class="link" href="install002.html#2.10.quickcheck">2.10 Quick-Check</a>).
<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 sections traverses the newly installed tree and sets all package
directories and files to required levels of access
(<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.
</ul>
<li class="item"> <span class="high bold">Configure Package</span>
<p> Following the execution of the INSTALL.COM procedure the package should
require only minor, further configuration.
<p> <span class="high bold">Initially</span> two files may require alteration.
<ol class="list">
<li class="item"> The startup file, possibly to set the local WASD_CONFIG_GMT logical (for
systems not supporting DTSS (e.g. DECnet-Plus)). Consider using the
STARTUP_LOCAL.COM file for other site-specific requirements
(<a class="link" href="install004.html#4.3.accountsupportfiles">4.3 Account Support Files</a>).
<li class="item"> The only configuration that should require immediate attention will be
the mapping rules
(<a class="link blank" target="_blank" href="../config/#requestprocessingconfiguration">Request Processing Configuration</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>).
</ol>
<p> <span class="high bold">More generally</span> server runtime configuration involves the considerations
discussed in <a class="link blank" target="_blank" href="../config/#siteorganisation">Site Organisation</a> of <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>
along with the following aspects:
<ul class="list">
<li class="item"> Configuring the HTTP server run-time characteristics
(<a class="link blank" target="_blank" href="../config/#configurationconsiderations">Configuration Considerations</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>).
<li class="item"> Mapping request paths to the VMS file system, and to other things such as
scripts
(<a class="link blank" target="_blank" href="../config/#requestprocessingconfiguration">Request Processing Configuration</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>).
<li class="item"> Customizing some or all messages
(<a class="link blank" target="_blank" href="../config/#messageconfiguration">Message Configuration</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>).
<li class="item"> Establishing an authentication and authorization environment
(<a class="link blank" target="_blank" href="../config/#authorizationconfigurationbasics">Authorization Configuration (Basics)</a> in <a class="link blank" target="_blank" href="../config/#0.">WASD Configuration</a>).
</ul>
<li class="item"> <span class="high bold">Start Server</span>
<p> Execute the startup procedure (<a class="link" href="install004.html#4.3.startupcom">‘STARTUP.COM’ in 4.3 Account Support Files</a>).
Get your browser and connect!
<li class="item"> <span class="high bold">Find Out What's Wrong</span> <span class="high _frowny"> </span>
<p> Of course <span class="high italic">something</span> will not be right! This can happen with
the initial configuration and sometimes when changing configuration. The
server provides information messages in the run-time log, look in the
WASD_ROOT:[LOG_SERVER] directory.
<p> Remember, the basic installation's integrity can always be checked
as described in <a class="link" href="install002.html#2.10.quickcheck">2.10 Quick-Check</a>).
This uses the configuration files from the [EXAMPLE] directory, so provided
these have not been altered the server should execute in
<span class="high italic">demonstration mode</span> correctly.
<p> Can't resolve it? See <a class="link" href="install002.html#2.12.reportingproblems">2.12 Reporting Problems</a>.
</ol>
<a id="1.1" href="#"></a>
<a id="1.1.usingia64hostedx86crosscomplier" href="#"></a>
<a id="usingia64hostedx86crosscomplier" href="#"></a>
<h2 class="head"><span class="numb">1.1</span><span class="text">Using IA64-hosted X86 Cross-Complier?</span></h2>
<p> Until a native X86 C compiler becomes available all WASD package and
additional application builds must be done in two phases.
<ol class="list">
<li class="item"> cross-compile on an IA64 system
<li class="item"> link resulting object file(s) on the X86 system
</ol>
<p> When building using the cross-compiler tools the procedures recognise the
XCC$COMPILER environment and adjust to create and use <span class="high monosp"> [.OBJ_X86_64]</span> object
code directories.
<p> For example; to build WASD package:
<ol class="list">
<li class="item"> On IA64 ensure <span class="high monosp"> @SYS$MANAGER:X86_XTOOLS$SYLOGIN.COM</span> and then select
"3. Compile only" and complete the compilation.
<ul class="list">
<li class="item"> For clustered IA64/X86 with an MSCP-mounted volume containing a shared
<span class="high monosp"> [WASD_ROOT]</span> the appropriate object files are now available to the X86
system.
<p> Proceed with the second phase.
<li class="item"> For non-clustered build environments the same WASD kit must be installed
on both IA64 and X86 systems. After compilation the resulting <span class="high monosp"> [.OBJ_X86_64]</span>
directories must be ZIPed into an archive, transferred to the X86 system and
restored into the corresponding <span class="high monosp"> [WASD_ROOT]</span>.
<p> For example:
<div class="blockof code">IA64$ SET DEFAULT <span class="high italic">device</span>:[WASD_ROOT]
IA64$ ZIP "-V" <span class="high italic">location</span>:X86_1200_OBJ.ZIP [...OBJ_X86_64]*.OBJ
</div>
<div class="blockof code">X86$ SET DEFAULT <span class="high italic">device</span>:[WASD_ROOT]
X86$ UNZIP <span class="high italic">location</span>:X86_1200_OBJ.ZIP
</div>
<p> Proceed with the second phase.
</ul>
<li class="item"> On X86 perform the corresponding "2. linking (separate package) object
modules", and continue the rest of the installation.
</ol>
<a id="1.2" href="#"></a>
<a id="1.2.troubleshooting" href="#"></a>
<a id="troubleshooting" href="#"></a>
<h2 class="head"><span class="numb">1.2</span><span class="text">Troubleshooting?</span></h2>
<p> When initially installing or configuring WASD, and sometimes later where
something breaks spectacularly, it is most useful to be able to gain insight
into what the server is up to.
<p> The <span class="high italic">go-to</span> tool is <span style="font-size:110%">WATCH</span>
(yes, all capitals, and for no other reason than it makes it stand out).
<p> WATCH is described in detail in
<a class="link blank" target="_blank" href="../features/#watchfacility">WATCH Facility</a> of the <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>
document.
<p> For most circumstances WATCH can be made available for troubleshooting even
if the configuration is significantly broken. This is done by using a
skeleton-key to authorise special access into the server.
<p> The skeleton-key is described in detail in
<a class="link blank" target="_blank" href="../features/#skeletonkeyauthentication">Skeleton-Key Authentication</a> of the <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>
document.
<p> <span class="high bold">TL;DR</span>
<p> Enable at the command-line with the username anything beginning with an
underscore and at least 8 characters, same for the password length.
<div class="blockof code">$ HTTPD /DO=AUTH=SKELKEY=_<span class="high italic">username</span>:<span class="high italic">password</span>
</div>
<p> Then using a browser access any available service, entering the above
username (including underscore) and password when prompted.
<div class="blockof block"><a class="link blank" target="_blank" href="/httpd/-/admin/report/WATCH">https://<i>the.host.name:port</i> /httpd/-/admin/report/WATCH</a>
</div>
<p> The service administration facilities (of which WATCH is one) are also
available and useful.
<div class="blockof block"><a class="link blank" target="_blank" href="/httpd/-/admin/">https://<i>the.host.name:port</i> /httpd/-/admin/</a>
</div>
<!-- source:0200_INSTALL.WASDOC -->
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="install000.html#0.">↖︎</a>
<td><a href="install000.html#0.">↑︎</a>
<td><a href="install002.html#2.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>