Node.js for Oracle Linux

About Node.js for Oracle Linux

The Node.js repositories contain the latest builds of stable Node.js releases from the community, including node-oracledb. They are provided without support.

Available Node.js Releases

Node.js Version	Oracle Linux Release	Repository Name
v10.x	Oracle Linux 7	ol7_developer_nodejs10
v8.x	Oracle Linux 7	ol7_developer_nodejs8
v6.x	Oracle Linux 7	ol7_developer_nodejs6
v10.x	Oracle Linux 6	ol6_developer_nodejs10
v8.x	Oracle Linux 6	ol6_developer_nodejs8
v6.x	Oracle Linux 6	ol6_developer_nodejs6

Enabling Required Repositories

The installation instructions below require different Oracle Linux yum server repositories to be enabled, depending on what you are installing. For example, to enable the ol7_developer_nodejs10 repository together with the Oracle Instant Client repository:

$ sudo yum install -y yum-utils
$ sudo yum-config-manager --enable ol7_developer_nodejs10 ol7_oracle_instantclient


If your yum configuration doesn't have the required repository, grab the latest Oracle Linux yum configuration by running the these commands:

On Oracle Linux 7

$ sudo mv /etc/yum.repos.d/public-yum-ol7.repo /etc/yum.repos.d/public-yum-ol7.repo.bak
$ sudo wget -O /etc/yum.repos.d/public-yum-ol7.repo http://yum.oracle.com/public-yum-ol7.repo


On Oracle Linux 6

$ sudo mv /etc/yum.repos.d/public-yum-ol6.repo /etc/yum.repos.d/public-yum-ol6.repo.bak
$ sudo wget -O /etc/yum.repos.d/public-yum-ol6.repo http://yum.oracle.com/public-yum-ol6.repo


Installing Node.js

To install Node.js from this repository, ensure you have the latest Oracle Linux Yum server repo file and enable the appropriate repository.

To install Node.js:

$ sudo yum install nodejs


node-oracledb: Connecting Node.js to Oracle Database

The node-oracledb module for Node.js powers high performance Oracle Database applications. Use node-oracledb to connect Node.js 6, 8 and 10 to Oracle Database. The node-oracledb module is open source and maintained by Oracle Corp. It is stable, well documented, and has a comprehensive test suite.

About Oracle Instant Client

node-oracledb depends on Oracle Instant Client. On Oracle Linux yum server Oracle Instant Client 18.3 RPMs are in the ol7_oracle_instantclient and ol6_oracle_instantclient repositories. Assuming you have enabled the repository for Oracle Instant Client appropriate for your Oracle Linux release, it will be installed as a dependency. As of release 3.0, node-oracledb is built with Oracle Client 18.3, which connects to Oracle Database 11.2 and greater. Older releases of Oracle Instant Client are available on OTN.

Installing node-oracledb

Each Node.js release has its own repository on Oracle Linux yum server and each of those repositories also contains a corresponding RPM for node-oracledb. These RPMs follow this naming scheme:

node-oracledb-node<node release number>
               

For example, on Oracle Linux 7, the node-oracledb RPM for Node.js 10 is named:

node-oracledb-node10
                

Check the repositories listed under Available Releases to see what RPMs are available.

$ sudo yum install node-oracledb-node10

Finally, set up the environment so that node-oracledb can find Oracle Instant Client libraries:

$ sudo sh -c "echo /usr/lib/oracle/18.3/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
$ sudo ldconfig

Note that node-oracledb only works with Node.js 6.14.4 or higher. Before you use node-oracledb in a Node.js program, set NODE_PATH so that the node-oracledb module can be found:

$ export NODE_PATH=`npm root -g`

Additional Resources

Links

• Documentation: Getting Started with Node-oracledb
• Oracle Node.js Developer Center
• Javascript and Oracle Blog: Dan McGhan
• Scripting and Oracle Blog: Christopher Jones
• Oracle Linux yum server FAQ: Configuring yum proxy

Community Support

For help with Node.js on Oracle Linux, please visit the Node.js space in the Oracle Developer Community.