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/Module:Appstream
v14.x	Oracle Linux 8	nodejs:14
v12.x	Oracle Linux 8	nodejs:12
v10.x	Oracle Linux 8	nodejs:10 (default)
v14.x	Oracle Linux 7	ol7_developer_nodejs14
v12.x	Oracle Linux 7	ol7_developer_nodejs12
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

To configure the yum repositories shown above on your system, install the oracle-nodejs-release-el7 or oracle-nodejs-release-el6 RPM. After installing this RPM, the default enabled repository is that for the latest available Node.js release. To configure the Node.js and the Oracle Instant Client repository:

$ sudo yum install -y oracle-nodejs-release-el7 oracle-release-el7


Installing Node.js on Oracle Linux 7

To install the latest Node.js:

$ sudo yum install nodejs


Updating Node.js on Oracle Linux 7

If you have Node.js installed, and a newer release has been published, make sure you update oracle-nodejs-release-el7 first.

$ sudo yum update oracle-nodejs-release-el7
$ sudo yum update nodejs

Note: if your system has oracle-epel-release-el7 installed or ol7_developer_EPEL among its repo definitions, make sure you disable the EPEL repo while installing or updating nodejs, to avoid installing the wrong package. For example:

$ sudo yum --disablerepo=ol7_developer_EPEL 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. Yum configurations for Oracle Instant Client 18.3 RPMs are delivered via the oracle-release-el7 and oracle-release-el6 RPMs. Assuming you have installed the Oracle release package your Oracle Linux release, the Oracle Instant Client 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, for Oracle Instant Client releases before 19.x, you must set up the environment so that node-oracledb can find the necessary libraries. For example, for Oracle Instant Client release 18.3:

$ 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`

Installing Node.js on Oracle Linux 8

Oracle Linux 8 introduces DNF as well as the concepts of modules, streams and profiles to allow for the management of different versions of software applications within a single operating system release. For mode details, please refer to the documentation.

To install Node.js 12 on Oracle Linux 8:

$ sudo dnf install @nodejs:12

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.