Quelltext der Seite Installation and Setup V3 (2020 versions)

        <h2 id="prerequisites">prerequisites</h2>
<ul>
<li>sed</li>
<li>docker</li>
<li>java &gt;= 8</li>
</ul>
<h2 id="release-files">release files</h2>
<ul>
<li>Let <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">delivery-V3.zip</code></span> be the current distribution.</li>
<li>unzip it to a directory, called <strong>V3</strong> in the following.</li>
</ul>
<p>To ease the deployment process the pure jetty as well as the docker-related files are contained in the distribution.</p>
<h3 id="optional-angular-navigator-frontend-anavi">(optional) angular navigator frontend (anavi)</h3>
<p>For now the angular development is based on classical environment.ts files. In order to avoid node.js,
angular installation the server address has to be patched:</p>
<ul>
<li>
<p>go to directory <strong>V3</strong><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">/docker-build-dir-jetty/CTS2LE_Navigator-Authoring/dist/CTS2LE-Navigator</code></span></p>
</li>
<li>
<p>run <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">sed -i 's/___patchit_cts2le_server___/</code></span><strong>S</strong><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">/g' main.*.js</code></span> <br>
where <strong>S</strong> is the host, e.g. <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">http:\/\/localhost:9090</code></span></p>
</li>
<li>
<p>attention !!! be sure that it is done the first time after unzipping, otherwise no substitution happens</p>
</li>
</ul>
<h2 id="pure-jetty-anavi-not-supported">pure Jetty (anavi not supported)</h2>
<ul>
<li>
<p>unzip <strong>V3</strong><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">/docker-build-dir-jetty/cts2le/WebCts2LE-embedded-jetty.zip</code></span> to a directory (denoted by <strong>W</strong> in the following)</p>
</li>
<li>
<p>go to directory <strong>W</strong></p>
</li>
<li>
<p>run <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">./bin/startup.sh -port &lt;port&gt;</code></span></p>
</li>
<li>
<p>shutdown command: <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">./bin/shutdown.sh &lt;port&gt;</code></span></p>
</li>
<li>
<p>admin navigation ui: <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">http://&lt;host&gt;:&lt;port&gt;/WebCts2LE</code></span></p>
</li>
</ul>
<h2 id="docker">docker</h2>
<ul>
<li>
<p>go to directory <strong>V3</strong><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">/docker-build-dir-jetty</code></span></p>
</li>
<li>
<p>run <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">sudo  docker-compose -f docker-compose.yml up -d --build</code></span> (stretch version) <br>
(use <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">docker-compose-standalone.yml</code></span> for standalone version)</p>
</li>
<li>
<p>check container with <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">sudo docker logs -f cts2le</code></span> <br>
(last line <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">... INFO:oejs.Server:main: Started ...</code></span>)</p>
</li>
<li>
<p>admin navigation ui: <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">http://&lt;host&gt;:&lt;port&gt;/WebCts2LE</code></span> where <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">&lt;port&gt;</code></span> (usually 9090) is specified in the compose yml files</p>
</li>
<li>
<p>anavi: <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">http://&lt;host&gt;:&lt;port&gt;/CTS2LE</code></span> where <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">&lt;port&gt;</code></span> (usually 8901) is specified in the compose yml files</p>
</li>
</ul>
<h2 id="kubernetes">kubernetes</h2>
<ul>
<li>
<p>backend</p>
<ul>
<li>
<p>go to directory <strong>V3</strong><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">/docker-build-dir-jetty/kubernetes</code></span><br>
(all kubernetes yaml files are located at directory <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">yaml</code></span>)</p>
<ul>
<li>
<p>apply modifications for your environment (e.g. <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">targetPort</code></span>s in service definitions or <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">storage</code></span> requirements in persistent volume claims)</p>
</li>
<li>
<p>ensure that all docker images (apart from <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">cts2le-navi</code></span>) for the backend are generated according to above section.</p>
</li>
</ul>
</li>
<li>
<p>execute <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">./setup-kube-cts2le.sh</code></span><br>
(all resources for the backend are created in kubernetes. To create single resources comment out the others)</p>
</li>
<li>
<p>get the kubernetes service url of the backend, called <strong>SU</strong> in the following (hint: in minikube execute <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">minikube service cts2le --url</code></span> )</p>
</li>
</ul>
</li>
<li>
<p>navigator</p>
<ul>
<li>proceed as described above ((optional) angular navigator frontend (anavi)) with host url <strong>SU</strong></li>
<li>generate docker image for the navigator
<ul>
<li><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">docker build -f Dockerfile -t cts2le-navi .</code></span> <br>
on directory <strong>V3</strong><span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">/docker-build-dir-jetty/CTS2LE_Navigator-Authoring</code></span></li>
</ul>
</li>
<li>execute <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">./setup-kube-cts2le2-navi.sh</code></span></li>
<li>get the kubernetes service url of the frontend and check it in a browser (hint: in minikube execute <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">minikube service cts2le-navi --url</code></span> )</li>
</ul>
</li>
</ul>
<h2 id="load-standard-terminologies">load standard terminologies</h2>
<ul>
<li>
<p>go to directory <strong>V3</strong></p>
</li>
<li>
<p><em>important prerequisite</em>: the cts2le instance</p>
<ul>
<li>must not contain the terminology to load</li>
<li>services cannot be accessed during load</li>
</ul>
</li>
<li>
<p>run <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">java -jar cts2le-3-command-bulk.jar --sourceLoc </code></span> <strong>SL</strong> <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">--targetLoc</code></span> <strong>TL</strong> <br>
where <strong>SL</strong> is a directory of bulk files and <strong>TL</strong> is the host, e.g. <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">http://localhost:9090/WebCts2LE</code></span>.<br>
Files in <strong>SL</strong> have to end with <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">.nq.gz</code></span> (to ignore a file, suffix it with e.g. <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">.igno</code></span>). Be aware that on a notebook (~2 GHz, 16 GB RAM) the load time will be around 20 min (standard terminologies excl. snomed). For possible errors consult <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">sudo docker logs -f cts2le</code></span></p>
</li>
<li>
<p>to have an updated Lucene/Solr index run <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">GET http://&lt;host&gt;/WebCts2LE/service/manage/index/update</code></span> (estimated index time 50 min due to complex quad store queries) and subsequently <span style="background-color: #ebf6f6; padding: 0px 0px;"><code style="padding: 0px 0px;">GET http://&lt;host&gt;/WebCts2LE/service/manage/index/suggester/update</code></span></p>
</li>
</ul>