The DB2 connector enables LoopBack applications to connect to DB2 data sources.
Page Contents


IBM® DB2® is the database of choice for robust, enterprise-wide solutions handling high-volume workloads. It is optimized to deliver industry-leading performance while lowering costs. The loopback-connector-db2 module is the LoopBack connector for DB2.

The LoopBack DB2 connector supports:


Enter the following in the top-level directory of your LoopBack application:

$ npm install loopback-connector-db2 --save

The --save option adds the dependency to the application’s package.json file.


Use the data source generator to add the DB2 data source to your application. The entry in the application’s server/datasources.json will look something like this:

"mydb": {
  "name": "mydb",
  "connector": "db2"

Edit server/datasources.json to add other supported properties as required:

"mydb": {
  "name": "mydb",
  "connector": "db2",
  "username": <username>,
  "password": <password>,
  "database": <database name>,
  "hostname": <db2 server hostname>,
  "port":     <port number>

The following table describes the connector properties.

Property          Type   Description
database String Database name
schema String Specifies the default schema name that is used to qualify unqualified database objects in dynamically prepared SQL statements. The value of this property sets the value in the CURRENT SCHEMA special register on the database server. The schema name is case-sensitive, and must be specified in uppercase characters
username String DB2 Username
password String DB2 password associated with the username above
hostname String DB2 server hostname or IP address
port String DB2 server TCP port number
useLimitOffset Boolean LIMIT and OFFSET must be configured on the DB2 server before use (compatibility mode)
supportDashDB Boolean Create ROW ORGANIZED tables to support dashDB.

Alternatively, you can create and configure the data source in JavaScript code. For example:

var DataSource = require('loopback-datasource-juggler').DataSource;
var DB2 = require('loopback-connector-db2');

var config = {
  username: process.env.DB2_USERNAME,
  password: process.env.DB2_PASSWORD,
  hostname: process.env.DB2_HOSTNAME,
  port: 50000,
  database: 'SQLDB',

var db = new DataSource(DB2, config);

var User = db.define('User', {
  name: { type: String },
  email: { type: String },

db.autoupdate('User', function(err) {
  if (err) {

    name: 'Tony',
    email: '',
  }, function(err, user) {
    console.log(err, user);

  User.find({ where: { name: 'Tony' }}, function(err, users) {
    console.log(err, users);

  User.destroyAll(function() {
    console.log('example complete');

Testing (using Docker)

The proper (and current) way of installing Docker locally in a developer worstation is:

  • Windows 10 Pro: enable Hyper-V and install Docker for Windows
  • Windows (other): download and install Docker Toolbox
  • Mac: install Docker for Mac
  • Linux: install the Docker package from your current distro or install it Docker’s repository for your distro

Running DB2 container

A DB2 container can be started and bound to its known TCP port by the command below:

docker run --name db2 -d \
  -p 50000:50000 \
  -e DB2INST1_PASSWORD=password \
  -e LICENSE=accept \
  ibmcom/db2express-c db2start

Optionally you can populate this new DB2 instance with the SAMPLE database with the command below:

docker exec -ti db2 su - db2inst1 -c db2sampl

To run the test against the sample database you must set a few variables:

export DB2_USERNAME=db2inst1
export DB2_PASSWORD=password
export DB2_PORTNUM=50000

Finally, run the test:

npm install
npm test

Testing (the traditional way)

  • Go to IBM DB2 trials page.
  • Register for an account.
  • Download either IBM DB2 or IBM DB2 Express-C.
  • For documentation or more information about the installation or setup, see

IBM DB2 Express-C scenario on Windows.

  • Run the setup file.
  • Set user information for the DB2 Administration server.
  • Write down the user information and the password that you create. User name is db2admin by default but it could be modified.
  • Configure DB2 instance and write down the port number. It is 50000 by default.
  • Once setup is done, Start the default DB2 and Database Client Interface Selection Wizard, and proceed with the configuration.
  • Ensure that the DB2 Data server runtime client is started. The default name is DB2COPY1.
  • Let’s assume your database name is sample, and schema name is STRONGLOOP.
  • In Windows, start the DB2 Command window-Administrator (In Mac or Linux, use terminal with proper privileges).
  • Make sure that you are in this path ...\IBM\SQLLIB\BIN (In mac, it should be ` /Users//sqllib\bin`), and type the following commands:
>set db2instance=server1

>db2 connect to sample

>db2 set schema to STRONGLOOP
  • Go to loopback-connector-db2\test\init.js, and insert the proper credentials.
  • Run npm test.