CTS2-LE Installation and Deployment in JBOSS

Aus CTS2-LE
Zur Navigation springen Zur Suche springen

This section describes how to install and deploy a CTS2-LE server in a JBOSS application server in a standalone mode. It has to be ensured that the system fulfils the defined prerequisites. The following steps are aligned to the recommended system environment and hence offer commands on the basis of an Ubuntu-like OS and an installed JBOSS Wildfly 10.

Compact Installation (recommended)

The following is tested with wildfly-10.1.0

  • Unzip WebCts2LE-embedded-jetty[-...].zip to <x>.
  • Create an environment variable called CTS2LE_RESOURCE_ROOT and set it to <x>/CTS2LE_resources/resources-custom
  • Starting the server: ./$JBOSS_HOME/bin/standalone.sh
  • Starting JBOSS CLI: ./$JBOSS_HOME/bin/jboss-cli.sh and connect to server
  • Deploying CTS2-LE within CLI: [standalone@localhost:9990 /] deploy <x>/webapps/WebCts2LE.war
  • Navigator-Url:
    http://<host>:<port>/WebCts2LE


Installation with Loading

Preparation

  • Two zip files are shipped with CTS2LE:
    • WebCts2LE-V-x.x.x-resource-root.zip: a pre-configured directory comprising the vocabularies and the store content (denoted by <RESOURCE_ROOT> in the following)
    • WebCts2LE-V-x.x.x.war: the war file to be deployed (denoted by <SERVER-ZIP> in the following)

!!! Ensure that you have sufficient privileges and a distinguished owner for all directories and files created below

!!! Ensure that Java 8 (>= 1.8.0_92) is installed on the target machine

Installation

  1. Create a directory <x> where the terminology store will be located
  2. Create an environment variable called CTS2LE_RESOURCE_ROOT and set it to <x>/resources-custom
  3. Extract <RESOURCE_ROOT> to <x>

Inside $JBOSS_HOME/standalone/deployments:

  1. create a directory WebCts2LE.war
  2. create a file WebCts2LE.war.dodeploy
  3. Extract <SERVER-ZIP> to $JBOSS_HOME/standalone/deployments/WebCts2LE.war/

Inside $JBOSS_HOME/standalone/deployments:

  1. run the following command

java -Xmx900m -Dfile.encoding=UTF-8 -classpath "./WebCts2LE.war/WEB-INF/lib/*" cts2le.loader.SuperLoader
This will initiate the vocabulary loading process. Please note that this may take some time depending on the number of imported vocabularies.

  1. Starting the server: ./$JBOSS_HOME/bin/standalone.sh
  2. Stopping the server: ./$JBOSS_HOME/bin/jboss-cli.sh --connect --command=:shutdown