How to Install Exalate for ServiceNow on Docker?

You can host Exalate for Servicenow on your own server. To do so, you need to install Exalate on Docker.

How to Install Exalate for ServiceNow?

1. Create or download the docker-compose.yml

The below example docker-compose.yml file can be used to install Exalate for ServiceNow.

1. Create a directory that would hold the docker-compose file:

   cd ~
   mkdir exalate-snownode

2. Create or download a docker-compose.yml file.

   Click docker-compose.yml to download the file.

   The file should contain the following information:

   We recommend using the latest version of Exalate for ServiceNow. It can be found in the Release History.

   Enter the latest version in the image tag. For example, in image: idalko/snownode:5.1.3, the version of Exalate for ServiceNow is 5.1.3 .

   version: '2'
   
   services:
     database:
       restart: unless-stopped
       image: postgres:9.4
       volumes:
         - ./persist/db:/var/lib/postgresql/data
         - ./createdb.sh:/docker-entrypoint-initdb.d/init-user-db.sh
       environment:
         - POSTGRES_PASSWORD=changeme
         - DB_NAME=snownode
         - DB_USER=idalko
         - DB_PASS=idalko
       networks:
         - dbnet
   
     snownode:
       restart: unless-stopped
       ports:
         - 9000:9000
   
       #
   	# Change the image tag to the required version
       # Check Release History on docs.exalate.com for an overview
       #
       image: idalko/snownode:5.1.3
       depends_on:
         - database #wait for postgres to be started, not for ready
       volumes:
         - ./persist/home:/opt/snownode/data
       environment:
         # Add your enviroment settings here
         - SNOWNODE_PG_HOST=database
         - SNOWNODE_PG_DB=snownode
         - SNOWNODE_PG_USER=idalko
         - SNOWNODE_PG_PWD=idalko
         - SNOWNODE_PORT=9000
       networks:
         - dbnet
         - default
   
   networks:
     dbnet:
       driver: bridge
     default:
       driver: bridge
   
   

2. Ensure that a correct database is set up using a createdb.sh

Create createdb.sh (referenced from docker-compose.yml):

#!/bin/bash
 
TEST=`psql -U postgres <<-EOSQL
   SELECT 1 FROM pg_database WHERE datname='$DB_NAME';
EOSQL`
 
echo "******CREATING DOCKER DATABASE******"
if [[ $TEST == "1" ]]; then
    # database exists
    # $? is 0
    exit 0
else
psql -U postgres <<-EOSQL
   CREATE ROLE $DB_USER WITH LOGIN ENCRYPTED PASSWORD '${DB_PASS}' SUPERUSER;
EOSQL
 
psql -U postgres <<-EOSQL
   CREATE DATABASE $DB_NAME WITH OWNER $DB_USER ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;
EOSQL
 
psql -U postgres <<-EOSQL
   GRANT ALL PRIVILEGES ON DATABASE $DB_NAME TO $DB_USER;
EOSQL
fi
 
echo ""
echo "******DOCKER DATABASE CREATED******"

or download: createdb.sh

3. Set environment variables if necessary

Below you can find the environment variables used for the app container. All of them are optional, and in the given example, we've overridden snownode_PG_DB, snownode_PG_USER, and snownode_PG_PWD just to show how to pass different credentials to the Exalate application.

    ports:
      - 9000:9000

    ports:
      - 80:80

# exalate is the name of the database on the postgres instance
#
SNOWNODE_PG_DB=exalate?gssEncMode=disable 

4. Start the application

cd ~/exalate-snownode
docker-compose up -d

After starting Exalate for ServiceNow you will need to verify your instance. Check out Verify your Exalate for ServiceNow for more information.

Troubleshooting

Problems during the installation of the Exalate server for Snownode

If you have problems during the installation of the Exalate app for Servicenow you can find logs describing possible problems inside /tmp.

The name for the file is generated randomly and automatically by the OS, but you can find the file by the creation date.

Problems while running the Exalate server for Snownode

Logs will be generated under the directory: /opt/snownode/data/logs.

Refer to these logs to get more information about possible problems and communicate with our support if you need any assistance.

Support

Check our Support options.