Skip to content

How-to articles

In-premise Installation

This guide details the process to install  BQ C-SAPS(™) platform in your premise.

System Requirements

Ensure that your system meets the minimum requirements to run BQ C-SAPS™.

ServerConfiguration
Application ServerUbuntu 16.04 LTS, JDK 1.8, Tomcat 8
Node ServerUbuntu 16.04 LTS, node.js 12
DatabaseUbuntu 16.04 LTS, MariaDb 10

Prerequisites

  1. Ensure server machines are suitably hardened based on organization policies.
  2. Ensure swap space is configured to the same amount as RAM.

Step-by-step guide

Step 1 - Application Server
  1. Install JDK 1.8 with latest update
  2. Install Tomcat 8
  3. Update or create setenv.sh in tomcat/bin folder.
  4. Create the following folders and make them writable by tomcat user:
    1. SCREENSHOT_PATH
    2. ATTACH_PATH
setenv.sh bash<br/># IP and port to app server<br/>export BQ_AUTH_URL=http://192.168.3.243:8080<br/># IP and port to Node Server<br/>export NODE_SERVER_URL=http://192.168.3.243:8888<br/># IP for DB server<br/>export RDS_HOSTNAME=192.168.3.243<br/># DB Name<br/>export RDS_DB=bqdatabase<br/># DB Port<br/>export RDS_PORT=3306<br/># DB User<br/>export PARAM1=xxxx<br/># DB Password<br/>export PARAM2=xxxx<br/># Upload screenshots to (SERVER/Azure/S3)<br/>export SCREEN_UPLOAD=SERVER<br/># Path to screenshot if server<br/>export SCREENSHOT_PATH = /path/screen<br/># Azure Account Name<br/>export AZ_ACCOUNT_NAME=xxx<br/># Azure Account Key<br/>export AZ_ACCOUNT_KEY=xxx<br/># Log Sql<br/>export LOGSQL=false<br/># Mail Server Host Name<br/>export BQ_MAIL_HOST=secure3186.hostgator.com<br/># Mail Server Port<br/>export BQ_MAIL_PORT=25<br/># Mail FROM user<br/>export [email protected]<br/># Mail User<br/>export [email protected]<br/># Mail Server Pass<br/>export BQ_MAIL_PASS=xxxx<br/># Use SSL<br/>export BQ_MAIL_SSL=false<br/># Auth required for SMTP<br/>export BQ_MAIL_AUTH=true<br/># Enable Attachment functionality<br/>export ENABLE_ATTACHMENT=true<br/># <br/>export JAVA_OPTS="-server -XX:MaxPermSize=512m -Xms4096m -Xmx4096m "<br/># Path to Custom config<br/>export APPNAME_CONFIG=/path/cst.groovy<br/><br/><br/># Import Subtask (ICANN Only)<br/>export IMPORT_SUBTASK=false<br/># path to BQ installer<br/># This will be used if the path is different between installations.<br/>export BQ_INSTALLER_PATH=/path<br/># Max attachment file size<br/>export ATTACH_FILE_SIZE_MB=1024<br/># Path to Attachment on server<br/># Make sure this folder is created and permission given to tomcat user<br/>export ATTACH_PATH=/path/to/attach<br/># Disable Email Notifications<br/>export BQ_NOTIFICATION_DISABLE=false<br/><br/><br/>