You should have already done these steps:
(Ever need help ? Go to Asqatasun Forum.)
Download Asqatasun binaries
Retrieve the lastest version of Asqatasun and extract it on your file system.
mkdir -p /tmp/asqatasun
cd /tmp/asqatasun
wget https://download.asqatasun.org/asqatasun-latest.tar.bz2
tar xfj asqatasun-latest.tar.bz2
Place binaries in /opt/asqatasun
:
mkdir -p /opt/asqatasun
cp server/asqatasun-server/target/asqatasun-server-5.0.0-rc.1.jar /opt/asqatasun/
cp web-app/asqatasun-web-app/target/asqatasun-web-app-5.0.0-rc.1.war /opt/asqatasun/
Create symbolic links to binaries:
ASQA_RELEASE="5.0.0-rc.1"
APP_FILE="asqatasun-web-app-${ASQA_RELEASE}.war"
API_FILE="asqatasun-server-${ASQA_RELEASE}.jar"
cd "/opt/asqatasun/"
ln -s "${APP_FILE}" "asqatasun-webapp.war"
ln -s "${API_FILE}" "asqatasun-rest-server.jar"
Create user and directories
ASQA_SYSTEM_USER="asqatasun"
ASQA_HOME="/home/${ASQA_SYSTEM_USER}"
useradd -c "Asqatasun user" -d "${ASQA_HOME}" -l -s /bin/bash "${ASQA_SYSTEM_USER}"
mkdir -p /var/log/asqatasun/
chown -R asqatasun /var/log/asqatasun/
mkdir -p "${ASQA_HOME}/.dconf"
chown -R asqatasun "${ASQA_HOME}"
Systemd unit: .env file
Create Systemd units for Asqatasun web application and Asqatasun API
DB_DRIVER="mysql"
DB_HOST="localhost"
DB_PORT="3306"
DB_DATABASE="asqatasun"
DB_USER="asqatasunDatabaseUserLogin"
DB_PASSWORD="asqatasunDatabaseUserP4ssword"
cat >/etc/systemd/system/asqatasun-db.service.env <<EOF
JDBC_URL=jdbc:${DB_DRIVER}://${DB_HOST}:${DB_PORT}/${DB_DATABASE}
JDBC_USER=${DB_USER}
JDBC_PASSWORD=${DB_PASSWORD}
EOF
chmod 600 /etc/systemd/system/asqatasun-db.service.env
Systemd unit: Asqatasun web application
APP_LOG_DIR="/var/log/asqatasun/webapp"
APP_PORT="8080"
cat >/etc/systemd/system/asqatasun-webapp.service <<EOF
[Unit]
Description=asqatasun-webapp
After=syslog.target
[Service]
User=asqatasun
EnvironmentFile=/etc/systemd/system/asqatasun-db.service.env
ExecStart=/usr/bin/java -Dwebdriver.firefox.bin=/opt/firefox/firefox -Dwebdriver.gecko.driver=/opt/geckodriver -Dapp.logging.path=${APP_LOG_DIR} -jar asqatasun-webapp.war --spring.profiles.active=webapp --server.port=${APP_PORT}
SuccessExitStatus=143
Restart=always
WorkingDirectory=/opt/asqatasun
[Install]
WantedBy=multi-user.target
EOF
Systemd unit: Asqatasun API
API_PORT="8081"
API_LOG_DIR="/var/log/asqatasun/api"
cat >/etc/systemd/system/asqatasun-api.service <<EOF
[Unit]
Description=asqatasun-rest-server
After=syslog.target
[Service]
User=asqatasun
EnvironmentFile=/etc/systemd/system/asqatasun-db.service.env
ExecStart=/usr/bin/java -Dwebdriver.firefox.bin=/opt/firefox/firefox -Dwebdriver.gecko.driver=/opt/geckodriver -Dapp.logging.path=${API_LOG_DIR} -Dapp.engine.loader.selenium.headless=true -jar asqatasun-rest-server.jar --spring.profiles.active=webapp --server.port=${API_PORT} --management.server.port=8091
SuccessExitStatus=143
Restart=always
WorkingDirectory=/opt/asqatasun
[Install]
WantedBy=multi-user.target
EOF
Start Asqatasun
systemctl start asqatasun-webapp
systemctl start asqatasun-api
Get status of Asqatasun services
systemctl status asqatasun-webapp
systemctl status asqatasun-api
Browse Asqatasun logs
journalctl -u asqatasun-webapp.service
journalctl -u asqatasun-api.service
-f
option continuously prints new entries as they are appended to the journal
Stop Asqatasun
systemctl stop asqatasun-webapp
systemctl stop asqatasun-api
Start & stop manually Asqatasun WEB APPLICATION
If you want more fine grained control over startup, you can run directly the binaries.
APP_PORT="8080"
DB_PORT="3306"
DB_HOST="localhost"
DB_DRIVER="mysql"
DB_DATABASE="asqatasun"
DB_USER="asqatasunDatabaseUserLogin"
DB_PASSWORD="asqatasunDatabaseUserP4ssword"
APP_LOG_DIR="/var/log/asqatasun/webapp"
/usr/bin/java \
-Dwebdriver.firefox.bin=/opt/firefox/firefox \
-Dwebdriver.gecko.driver=/opt/geckodriver \
-Dapp.logging.path="${APP_LOG_DIR}" \
-Djdbc.url="jdbc:${DB_DRIVER}://${DB_HOST}:${DB_PORT}/${DB_DATABASE}" \
-Djdbc.user="${DB_USER}" \
-Djdbc.password="${DB_PASSWORD}" \
-jar /opt/asqatasun/asqatasun-webapp.war \
--server.port="${APP_PORT}"
To stop Asqatasun web application, just kill the process.
Start & stop manually Asqatasun API
If you want more fine grained control over startup, you can run directly the binaries.
API_PORT="8081"
DB_PORT="3306"
DB_HOST="localhost"
DB_DRIVER="mysql"
DB_DATABASE="asqatasun"
DB_USER="asqatasunDatabaseUserLogin"
DB_PASSWORD="asqatasunDatabaseUserP4ssword"
API_LOG_DIR="/var/log/asqatasun/api"
/usr/bin/java \
-Dwebdriver.firefox.bin=/opt/firefox/firefox \
-Dwebdriver.gecko.driver=/opt/geckodriver \
-Dapp.logging.path="${API_LOG_DIR}" \
-Dapp.engine.loader.selenium.headless=true \
-Djdbc.url="jdbc:${DB_DRIVER}://${DB_HOST}:${DB_PORT}/${DB_DATABASE}" \
-Djdbc.user="${DB_USER}" \
-Djdbc.password="${DB_PASSWORD}" \
-jar /opt/asqatasun/asqatasun-rest-server.jar \
--server.port="${API_PORT}" \
--management.server.port=8091
To stop Asqatasun web application, just kill the process.