path: root/system/AD.sgml

<!doctype report PUBLIC "-//Stork//DTD report//EN">

<report>
  <header>
    <title>AMENDMENT DIRECTIVE, OTP</title> 
    <prepared>ETX/B/SFP Kenneth Lundin, Lars Thors&#233;n, Morgan Eriksson</prepared>
    <responsible></responsible>
    <docno>1/177 82 - APN 181 01</docno>
    <approved>ETX/B/SF Torbj&ouml;rn Johnson</approved>
    <checked></checked>
    <date>961023</date>
    <rev>I</rev>
    <file>tr1c.sgml</file>
  </header>
  
<section>
<title>Introduction</title>
<p>
<section><title>Purpose</title>
<p>
This update release, OTP P1H, contains a fix for the erl_call problems in OTP P1G.
</section>

<section><title>Revision History</title>
<p>
Rev.A:Kenneth Lundin 1996-05-31<br> 
Rev.B:Lars Thors&#233;n 1996-06-04<br>
Rev.C:Kenneth Lundin 1996-06-14<br>
Rev.D:Kenneth Lundin 1996-08-28<br>
Rev.E:Lars Thors&#233;n 1996-09-12<br>
Rev.F:Kenneth Lundin 1996-09-13<br>
Rev.G:Morgan Ericsson 1996-10-08<br>
Rev.H:Kenneth Lundin 1996-10-14<br>
Rev.I:Morgan Eriksson 1996-10-23<br>
<p>
The exact changes between revisions of this document can be generated from our ClearCase repository upon request , or a simple unix "diff" can be used.
</section>
</section>
<section><title>Product Identities</title>
<p>
<table>
<row>
<cell><b>Product Name</b></cell>
<cell><b>Product Number</b></cell>
<cell><b>R-state</b></cell>
</row>
<row>
<cell>OTP</cell>
<cell>APN 181 01</cell>
<cell>P1H</cell>
</row>
<row>
<cell>ERTS (sunos4)</cell>
<cell>CXC 138 10/1</cell>
<cell>P1G</cell>
</row>
<row>
<cell>ERTS (sunos5)</cell>
<cell>CXC 138 10/2</cell>
<cell>P1G</cell>
</row>
<row>
<cell>SASL (BOS) (sunos4)</cell>
<cell>CXC 138 11/1</cell>
<cell>P1D</cell>
</row>
<row>
<cell>SASL (BOS) (sunos5)</cell>
<cell>CXC 138 11/2</cell>
<cell>P1D</cell>
</row>
<row>
<cell>MNESIA</cell>
<cell>CXC 138 12/1</cell>
<cell>P1E</cell>
</row>
<row>
<cell>SNMPEA</cell>
<cell>CXC 138 13/1</cell>
<cell>P1D</cell>
</row>
<row>
<cell>ERLDEV (Compiler & Debugger)</cell>
<cell>CXC 138 15/1</cell>
<cell>P1C</cell>
</row>
<row>
<cell>DEVTOOLS (sunos4)</cell>
<cell>CXC 138 16/1</cell>
<cell>P1D</cell>
</row>
<row>
<cell>DEVTOOLS (sunos5)</cell>
<cell>CXC 138 16/2</cell>
<cell>P1D</cell>
</row>
<row>
<cell>XLATETOOLS (sunos4)</cell>
<cell>CXC 138 17/1</cell>
<cell>P1D</cell>
</row>
<row>
<cell>XLATETOOLS (sunos5)</cell>
<cell>CXC 138 17/2</cell>
<cell>P1D</cell>
</row>
<row>
<cell>CPO Solaris (XNTP)</cell>
<cell>CXC 138 46/1</cell>
<cell>P1A</cell>
</row>
</table>
</section>
<section><title>Document Survey</title>
<p>
<table>
<row>
<cell><b>Document name</b></cell>
<cell><b>Document number</b></cell>
<cell>Rev</cell>
</row>
<row>
<cell>Systems Overview</cell>
<cell>1551-APN 181 01</cell>
<cell>A</cell>
</row>
<row>
<cell>Erlang Tools Introduction</cell>
<cell>EPK-95:030/1</cell>
<cell>A</cell>
</row>
<row>
<cell>Erlang Tools User's Guide</cell>
<cell>EPK-95:030/2</cell>
<cell>A</cell>
</row>
<row>
<cell>Erlang Tools</cell>
<cell>EPK-95:030/3</cell>
<cell>A</cell>
</row>
<row>
<cell>Distributed Erlang User's Guide</cell>
<cell>EPK-95:030/4</cell>
<cell>A</cell>
</row>
<row>
<cell>Erlang Tools Examples</cell>
<cell>EPK-95:030/5</cell>
<cell>A</cell>
</row>

<row>
<cell>User's Guide to the Erlang Interface Library</cell>
<cell>3/1553-CNA 121 16</cell>
<cell>A</cell>
</row>
<row>
<cell>Erlang Interface Library Examples</cell>
<cell>1/198 17-CNA 121 16</cell>
<cell>A</cell>
</row>
<row>
<cell>Programmer's Guide to the Erlang Interface Library</cell>
<cell>2/198 17-CNA 121 16</cell>
<cell>A</cell>
</row>

<row>
<cell>OTP Erlang User's guide</cell>
<cell>1553-CNA 121 17</cell>
<cell>A</cell>
</row>

<row>
<cell>The Mnesia Query Language Mnemosyne</cell>
<cell>1553-CNA 121 18</cell>
<cell>A</cell>
</row>

<row>
<cell>SNMPEA User's Guide</cell>
<cell>1553-CNA 121 19</cell>
<cell>A</cell>
</row>

<row>
<cell>SNMPEA Reference Guide</cell>
<cell>1551-CNA 121 19</cell>
<cell>A</cell>
</row>

<row>
<cell>User's Guide to the Interface Generator</cell>
<cell>1553-CNA 121 38</cell>
<cell>A</cell>
</row>

</table>

<p>
A complete browseable document survey is available at the OTP WWW-server http://otp.ericsson.se and can also be found in the release at $OTP_ROOT/doc/all.html when the 
release file is un-tar:ed at $OTP_ROOT.
</section>
<section><title>Implemented Change requests</title>
<p>
-
</section>
<section><title>Implemented Trouble Reports</title>
<p>
<table>
<row>
<cell><b>Block</b></cell>
<cell><b>TR id</b></cell>
<cell><b>Slogan</b></cell>
</row>
<row>
<cell>ERTS</cell>
<cell>-</cell>
<cell>
erl_call crashes (Segmentation fault) has now been fixed
</cell>
</row>
</table>
</section>
<section><title>Installation Instructions</title>
<p>
The release is delivered as a compressed tar-file <b>otp_APN18101_P1H.&lt;target&gt;.tar.Z</b>, where &lt;target&gt; is substituted with <b>sunos4</b> or <b>sunos5</b>.
<p>
Then the following steps shall be performed at installation time:
</p>
<list>
<item><p>Create a new directory $OTP_INSTALL_DIR where OTP can be installed.
<code>
mkdir $OTP_INSTALL_DIR
cd $OTP_INSTALL_DIR
uncompress $XXX/otp_APN18101_P1H.<target>.tar.Z
tar xvfp  $XXX/otp_APN18101_P1H.<target>.tar
</code>
</item>
<item><p>Run the OTP installscript and answer the questions.
<code>
./Install $OTP_INSTALL_DIR
</code>
<p>
The Install command will ask a number of questions during the installation.
<b>OBS!</b> When installing on a system where DNS is not used you 
should answer <b>NO</b> on the question "WILL YOU USE DNS?"
</item>
<item><p>Prepare the OTP man pages.
<code>
mkdir man/cat1 man/cat3
./format_man_pages
</code>
<item><p>Update the erl_interface library with ranlib (sunos4 only).
<code>
cd $OTP_INSTALL_DIR/usr/lib
ranlib liberl_interface.a
</code>
</item>
</list>
<p>
Add $OTP_INSTALL_DIR/bin to the path variable and $OTP_INSTALL_DIR/man to the MANPATH variable.
<p>
Where <b>$XXX</b> denotes the path at which otp_APN18101_P1H.&lt;target&gt;.tar resides.

<section><title>Separate (optional) Installation of XNTP (Network Time Protocol)</title>
<p>
XNTP (Network Time Protocol) <b>for use in an embedded system running Sunos5</b> is
delivered in this release. The XNTP resides in the tar-file xntp_CXC_13846_P1A.sunos5.tar.Z and  can be fetched with Netscape from the same place as the other OTP deliverables.
<list>
<item><p>Create a new directory $XNTP_DIR where the XNTP distribution can be loaded.
<code>
mkdir $XNTP_DIR
cd $XNTP_DIR
uncompress $XXX/xntp_CXC_13846_P1A.sunos5.tar.Z
tar xvf $XXX/xntp_CXC_13846_P1A.sunos5.tar.Z
</code>
</item>
<item><p>Read the README-file which is included, below follows information which
is partly the same as can be found at the end of the README file.</item>
<item><p>Note, the xntp3.5a.export subdirectory is not needed for installation.

<p>Create a suitable configuration file based on the samples in the
'config' directory, and copy it to /etc/ntp.conf.</item>

<item><p>Create a directory for the binaries and copy them there:<br>
<code>
mkdir -p /opt/xntp/bin
cp bin/* /opt/xntp/bin
</code>
<p>Note!, if you prefer another installation directory for the binaries, you have to edit one line in the "Run Commands" script xntp (located in the init directory):
<code>
BINDIR=<your new bindir>;
</code>
</item>

<item><p>Install the "Run Commands" script:<br>
<code>
cp init/xntp /etc/init.d/xntp<br>
ln /etc/init.d/xntp /etc/rc0.d/K57xntp
ln /etc/init.d/xntp /etc/rc1.d/K57xntp
ln /etc/init.d/xntp /etc/rc2.d/S78xntp
</code>
</item>

<item><p>Modify the /etc/system file (you probably want to save the original):<br>
<code>
cat init/system >> /etc/system
</code>
</item>

</list> 
<p>
Where <b>$XXX</b> denotes the path at which xntp_CXC13846_P1A.sunos5.tar.Z resides.
</section>
</section>

<section><title>Some useful notes</title>
<p>
To make it possible to browse Framemaker documents through Netscape the files
.mime.types and .mailcap should be modified (see below). The modifications
can be made as systems defaults if they are placed in e.g /usr/local/lib/netscape (see Netscape Handbook for details) or as personal defaults if placed in the
users $HOME directory.
<p>
.mime.types
<p>
<pre>
application/x-maker  fm
</pre>
<p>

.mailcap
<p>
<pre>
application/x-maker;	fmclient -f %s
</pre>
</section>
<section><title>Known problems in this release</title>
<p>
<list>
<item><p>In the manual-page for module code, the returned value of the function
which is described to be String but in reality it is an Atom (for compatibility
reasons). In the next release the return type will however be String as it says
in the manual-page.</item>
<item><p>On SunOS4.x platforms, the format_man_pages script (executed as a part of installation) will cause following error messages for missing manual sections:
<p><code>opendir:man{2,4,5,6,7,8,l,n}: No such file or directory</code>
<p>These messages should be ignored.
</item>

</list>
</section>
<section><title>References</title>
<p>
<i>Nothing to reference</i>

</section>
</report>