Loopback Oracle Binary Installer


The Oracle connector version 3.0.0 or above depends on the oracledbmodule as the Node.js driver for Oracle databases. Since oracledbis a C++ add-on, the installation requires C++ development tools to compile and build the module from source code. For more information, see Installing compiler tools.

At runtime, strong-oracle also requires dynamic libraries from  Oracle Database Instant Client.

The loopback-oracle-installermodule takes care of the binary dependencies and simplifies the whole process.  

The installer automatically downloads and extracts the prebuilt oracledbto the /loopback-connector-oracle/node_modulesdirectory and Oracle Database Instant Client into <UserHomeDirectory>/oracle-instant-client. If a prebuilt bundle does not exist for your client platform and Node version, the installer prompts you to install Oracle prerequisites. For more information, see Installing node-oracledb.

Once you've installed the Oracle prerequisites, re-install the Oracle connector by entering following command:

$ npm install loopback-connector-oracle --save

This internally executes the npm install oracledbcommand.


If you have problems installing loopback-connector-oracle, make sure this symbolic link exists:

libclntsh.dylib -> libclntsh.dylib.11.1

Make sure you've set the following environment variables (for example on OS X):

$ export OCI_LIB_DIR=$HOME/oracle-instant-client
$ export OCI_INC_DIR=$HOME/oracle-instant-client/sdk/include

If a prebuilt bundle does not exist for your client platform and Node version, and you have installed Oracle pre-requisites as described in Installing node-oracledb, then set the environment variables as follows:

$ export OCI_LIB_DIR=/opt/oracle/instantclient
$ export OCI_INC_DIR=/opt/oracle/instantclient/sdk/include

Post-installation setup

{% include warning.html content="Before you run the application, you MUSTconfigure the environment variable depending on the target platform to make sure the dynamic libraries from Oracle Instant Client are available to your Node process. " %}

MacOS X or Linux

Enter this command to set the LD_LIBRARY_PATHenvironment variable:

$ export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$HOME/oracle-instant-client"

If a prebuilt bundle does not exist for your client platform and Node version, and you have installed Oracle prerequisites as per Installing node-oracledb, then set the environment variables as follows:



On Linux systems, the libaiolibrary is required. If it is not present, you must install it as follows:


$ sudo apt-get install libaio1


$ sudo yum install libaio


Set the PATH environment variable for the logged-in user. Note however that the PATH setting will NOT be effective immediately. You must activate it using one of the methods below:

  1. Log off the current user session and log in again.
  2. Follow these steps to reset environment variables:
    • Open Control Panel --> System --> Advanced System Settings --> Environment Variables.
    • Examine the Pathunder User variables, and click OKto activate it.
    • Open a new Command Prompt then enter the 'path' command to verify.

Installation behind a proxy server

{% include important.html content=" This feature is supported by loopback-oracle-installer vesion 1.1.3 or later. " %}

If your system is behind a corporate HTTP/HTTPS proxy to access the internet, you must set the proxy for npm before running npm install.

For example,

$ npm config set proxy http://proxy.mycompany.com:8080
$ npm config set https-proxy http://https-proxy.mycompany.com:8080

If the proxy URL requires username/password, use the following syntax:

$ npm config set proxy http://youruser:yourpass@proxy.mycompany.com:8080
$ npm config set https-proxy http://youruser:yourpass@https-proxy.mycompany.com:8080

You can also set the proxy as part of the npm command as follows:

$ npm --proxy=http://proxy.mycompany.com:8080 install
$ npm --https-proxy=http://https-proxy.mycompany.com:8080 install

NOTE: npm's default value for proxyis from the HTTP_PROXYor http_proxyenvironment variable. And the default value for https-proxyis from the HTTPS_PROXY, https_proxy, HTTP_PROXY, or http_proxyenvironment variable. So you can configure the proxy using environment variables too.

Linux or Mac:

HTTP_PROXY=http://proxy.mycompany.com:8080 npm install


set HTTP_PROXY=http://proxy.mycompany.com:8080
npm install







  • 在 purescript 的 npm installer 中发现有安全漏洞的代码

    Earlier this week, I found and addressed some malicious code in the purescript npm installer. The ma...

    10 个月前
  • purescript-installer

    Installs the PureScript compiler purescriptinstaller A commandline tool to install PureScript(htt...

    10 个月前
  • pngcrush-installer

    Installer for Pngcrush pngcrushinstaller ================== An NPMbased installer for pngcrush. ...

    8 个月前
  • oracledb

    A Node.js module for Oracle Database access nodeoracledb version 4.2 The nodeoracledb addon for N...

    1 年前
  • oe-connector-oracle

    The oracle connector for the oecloud framework. oeconnectororacle This is a oracle connector f...

    7 个月前
  • noddity-installer

    Installs a readytodeploy Noddity The Noddity(http://noddity.com/) installer ============= Install ...

    9 个月前
  • meshblu-connector-installer-windows-msi

    create meshbluconnector MSI for windows meshbluconnectorinstallerwindowsmsi create meshbluconnecto...

    7 个月前
  • loopback-workspace

    undefined LoopBack Workspace 3.0 This module is in Maintenance LTS mode, new features are no long...

    1 年前
  • loopback-swagger

    Integration between LoopBack and Swagger API specs loopbackswagger This module is in Active LTS m...

    1 年前
  • loopback-soap

    Integration between LoopBack and SOAP API specs loopbacksoap Utilities to transform between SOAP ...

    1 年前


扫码加入 JavaScript 社区