Quelle  chap2_mj.html   Sprache: HTML

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<script type="text/javascript"
  src="https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>
<title>GAP (scscp) - Chapter 2: Installation</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<meta name="generator" content="GAPDoc2HTML" />
<link rel="stylesheet" type="text/css" href="manual.css" />
<script src="manual.js" type="text/javascript"></script>
<script type="text/javascript">overwriteStyle();</script>
</head>
<body class="chap2"  onload="jscontent()">


<div class="chlinktop"><span class="chlink1">Goto Chapter: </span><a href="chap0_mj.html">Top</a>  <a href="chap1_mj.html">1</a>  <a href="chap2_mj.html">2</a>  <a href="chap3_mj.html">3</a>  <a href="chap4_mj.html">4</a>  <a href="chap5_mj.html">5</a>  <a href="chap6_mj.html">6</a>  <a href="chap7_mj.html">7</a>  <a href="chap8_mj.html">8</a>  <a href="chap9_mj.html">9</a>  <a href="chapBib_mj.html">Bib</a>  <a href="chapInd_mj.html">Ind</a>  </div>

<div class="chlinkprevnexttop"> <a href="chap0_mj.html">[Top of Book]</a>   <a href="chap0_mj.html#contents">[Contents]</a>    <a href="chap1_mj.html">[Previous Chapter]</a>    <a href="chap3_mj.html">[Next Chapter]</a>   </div>

<p id="mathjaxlink" class="pcenter"><a href="chap2.html">[MathJax off]</a></p>
<p><a id="X8360C04082558A12" name="X8360C04082558A12"></a></p>
<div class="ChapSects"><a href="chap2_mj.html#X8360C04082558A12">2 <span class="Heading">Installation</span></a>
<div class="ContSect"><span class="tocline"><span class="nocss"> </span><a href="chap2_mj.html#X7DB566D5785B7DBC">2.1 <span class="Heading">Installation and system requirements</span></a>
</span>
</div>
<div class="ContSect"><span class="tocline"><span class="nocss"> </span><a href="chap2_mj.html#X878084B083D5217F">2.2 <span class="Heading">Configuration files</span></a>
</span>
</div>
</div>

<h3>2 <span class="Heading">Installation</span></h3>

<p><a id="X7DB566D5785B7DBC" name="X7DB566D5785B7DBC"></a></p>

<h4>2.1 <span class="Heading">Installation and system requirements</span></h4>

<p>Both <strong class="pkg">SCSCP</strong> client and server for <strong class="pkg">GAP</strong> work in Linux, OS X and Windows.</p>

<p>To use the <strong class="pkg">SCSCP</strong> package it is necessary to install recent versions of <strong class="pkg">GAP</strong>4 packages <strong class="pkg">IO</strong> <a href="chapBib_mj.html#biBIO">[Neu]</a>, <strong class="pkg">GAPDoc</strong> <a href="chapBib_mj.html#biBGAPDoc">[LN]</a> and <strong class="pkg">OpenMath</strong> <a href="chapBib_mj.html#biBopenmath">[CKNS]</a>.</p>

<p>The <strong class="pkg">SCSCP</strong> package is distributed in standard formats (<code class="file">tar.gz</code>, <code class="file">tar.bz2</code>) and can be obtained from <span class="URL"><a href="https://gap-packages.github.io/scscp/">https://gap-packages.github.io/scscp/</a></span> or from the <strong class="pkg">GAP</strong> web site (the latter also offers <code class="file">win.zip</code>-archives). To install <strong class="pkg">SCSCP</strong> package, put its <code class="file">tar.gz</code>-archive into the <code class="file">pkg</code> subdirectory of your <strong class="pkg">GAP</strong>4 installation and enter the command <code class="code">tar -xzf scscp-X.X.X.tar.gz</code>, then the subdirectory <code class="file">scscp</code> (containing subdirectories <code class="file">doc</code>, <code class="file">lib</code> etc.) will be created in the <code class="file">pkg</code> subdirectory. Installation using other archive formats is performed in a similar way.</p>

<p>When there are no access rights to the root directory of the main <strong class="pkg">GAP</strong> installation, it is also possible to install the package <em>outside the <strong class="pkg">GAP</strong> main directory</em> by unpacking it inside a directory <code class="file">MYGAPDIR/pkg</code>. Then to load the package <strong class="pkg">GAP</strong> should be started with <code class="code">-l ";MYGAPDIR"</code> option.</p>

<p><a id="X878084B083D5217F" name="X878084B083D5217F"></a></p>

<h4>2.2 <span class="Heading">Configuration files</span></h4>

<p>There are four files in the package which may need to be modified to setup and customise the package. The first three files are related with the server's functionality:</p>


<ul>
<li><p><code class="file">scscp/config.g</code> specifies:</p>


<ul>
<li><p>default <code class="code">InfoLevel</code> for the <code class="func">InfoSCSCP</code> (<a href="chap9_mj.html#X831E6A5D8695A3F9"><span class="RefLink">9.2-1</span></a>) class;</p>

</li>
<li><p>default <strong class="pkg">SCSCP</strong> server name and port to be used by <code class="func">RunSCSCPserver</code> (<a href="chap5_mj.html#X831C84577884215E"><span class="RefLink">5.2-1</span></a>) if <strong class="pkg">GAP</strong> is started with the <code class="file">scscp/example/myserver.g</code> file;</p>

</li>
<li><p>whether the server accepts calls to procedures which are standard <strong class="pkg">OpenMath</strong> symbols, or only procedures installed in the transient content dictionary (see <code class="func">InstallSCSCPprocedure</code> (<a href="chap5_mj.html#X8031C2F4787E0C1A"><span class="RefLink">5.1-1</span></a>));</p>

</li>
<li><p>service description to be returned to the client by <code class="func">GetServiceDescription</code> (<a href="chap5_mj.html#X7CBF8B63852898CF"><span class="RefLink">5.3-1</span></a>).</p>

</li>
</ul>
</li>
<li><p><code class="file">scscp/gapd.sh</code> is the script to start the <strong class="pkg">GAP</strong> <strong class="pkg">SCSCP</strong> server as a daemon. To use it, adjust the local call of <strong class="pkg">GAP</strong> and, if necessary, call options (for example, memory usage, startup from the workspace etc.) and the location of the root directory of the <strong class="pkg">SCSCP</strong> package in section 1 of this script.</p>

</li>
<li><p><code class="file">scscp/example/myserver.g</code> is an example of the server configuration file which loads all necessary packages, reads all needed code, installs all procedures which will be exposed to the client and finally starts the <strong class="pkg">SCSCP</strong> server (see Chapter <a href="chap5_mj.html#X7DEE95317812A998"><span class="RefLink">5</span></a>).</p>

</li>
</ul>
<p>The fourth file is related with the client's functionality for parallel computations:</p>


<ul>
<li><p>The file <code class="file">scscp/configpar.g</code> assigns the global variable <code class="code">SCSCPservers</code> which specifies a list of hosts and ports to search for <strong class="pkg">SCSCP</strong> services (which may be not only represented by <strong class="pkg">GAP</strong> services, but also by another <strong class="pkg">SCSCP</strong>-compliant systems). It will be used to run parallel computations with the <strong class="pkg">SCSCP</strong> package (see Chapter <a href="chap8_mj.html#X7C80E6FA7CB91D28"><span class="RefLink">8</span></a>).</p>

</li>
</ul>
<p>See comments in these configuration files for further details and examples.</p>


<div class="chlinkprevnextbot"> <a href="chap0_mj.html">[Top of Book]</a>   <a href="chap0_mj.html#contents">[Contents]</a>    <a href="chap1_mj.html">[Previous Chapter]</a>    <a href="chap3_mj.html">[Next Chapter]</a>   </div>


<div class="chlinkbot"><span class="chlink1">Goto Chapter: </span><a href="chap0_mj.html">Top</a>  <a href="chap1_mj.html">1</a>  <a href="chap2_mj.html">2</a>  <a href="chap3_mj.html">3</a>  <a href="chap4_mj.html">4</a>  <a href="chap5_mj.html">5</a>  <a href="chap6_mj.html">6</a>  <a href="chap7_mj.html">7</a>  <a href="chap8_mj.html">8</a>  <a href="chap9_mj.html">9</a>  <a href="chapBib_mj.html">Bib</a>  <a href="chapInd_mj.html">Ind</a>  </div>

<hr />
<p class="foot">generated by <a href="https://www.math.rwth-aachen.de/~Frank.Luebeck/GAPDoc">GAPDoc2HTML</a></p>
</body>
</html>