node-oracledb/INSTALL.md

139 lines
7.5 KiB
Markdown
Raw Normal View History

2023-02-21 07:43:35 +08:00
# Installing node-oracledb Version 6.0.0-dev
2015-01-21 00:51:22 +08:00
2022-05-17 11:09:34 +08:00
*Copyright (c) 2015, 2022, Oracle and/or its affiliates.*
2015-01-21 00:51:22 +08:00
This software is dual-licensed to you under the Universal Permissive License
(UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License
2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose
either license.
2015-01-21 00:51:22 +08:00
If you elect to accept the software under the Apache License, Version 2.0,
the following applies:
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
2015-01-21 00:51:22 +08:00
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
2015-01-21 00:51:22 +08:00
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.
2015-01-21 00:51:22 +08:00
2023-02-21 11:32:59 +08:00
## Note: The node-oracledb 5.5 installation instructions have moved to [https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html).
2023-02-21 11:32:59 +08:00
## The new documentation layout facilitates better search and navigation of the content. For future node-oracledb releases, the latest updates will only be added to the new node-oracledb documentation.
2015-01-21 00:51:22 +08:00
2023-02-21 11:32:59 +08:00
## <a name="overview"></a> 1. Node-oracledb Overview
2023-02-21 11:32:59 +08:00
The documentation has moved to [https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#overview](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#overview).
2017-12-12 07:17:52 +08:00
## <a name="quickstart"></a> 2. Quick Start node-oracledb Installation
2023-02-21 11:32:59 +08:00
The documentation has moved to [https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#quickstart](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#quickstart).
2021-05-29 16:06:47 +08:00
## <a name="instructions"></a> 3. Node-oracledb Installation Instructions
2023-02-21 11:32:59 +08:00
The documentation has moved to [https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instructions](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instructions).
### <a name="prerequisites"></a> 3.1 Prerequisites
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#prerequisites)
2017-06-14 09:49:08 +08:00
#### <a name="linuxinstall"></a> 3.2 Node-oracledb Installation on Linux
2015-01-21 00:51:22 +08:00
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#linuxinstall)
2021-05-29 07:53:59 +08:00
#### <a name="instzip"></a> 3.2.1 Node-oracledb Installation on Linux x86_64 with Instant Client ZIP files
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instzip)
2015-01-21 00:51:22 +08:00
2021-05-29 07:53:59 +08:00
#### <a name="instoh"></a> 3.2.2 Node-oracledb installation on Linux x86_64 with a Local Database or Full Client
2017-06-14 09:49:08 +08:00
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instoh)
2015-01-21 00:51:22 +08:00
2021-05-29 07:53:59 +08:00
#### <a name="instrpm"></a> 3.2.3 Node-oracledb Installation on Linux x86_64 with Instant Client RPMs
2015-01-21 00:51:22 +08:00
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instrpm)
2021-05-29 07:53:59 +08:00
#### <a name="aarch64"></a> 3.2.4 Node-oracledb Installation on Linux ARM (aarch64)
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#aarch64)
2021-05-29 07:53:59 +08:00
#### <a name="instnoderpms"></a> 3.2.5 Installing Node.js and node-oracledb RPMs from yum.oracle.com
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instnoderpms)
2021-03-08 15:45:35 +08:00
### <a name="instosx"></a> 3.3 Node-oracledb Installation on Apple macOS (Intel x86)
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instosx)
### <a name="windowsinstallation"></a> 3.4 Node-oracledb Installation on Microsoft Windows
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#windowsinstallation)
#### <a name="instwin"></a> 3.4.1 Node-oracledb Installation on Microsoft Windows with Instant Client ZIP files
2017-06-14 09:49:08 +08:00
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instwin)
#### <a name="instwinoh"></a> 3.4.2 Node-oracledb Installation on Microsoft Windows with a Local Database or Full Client
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instwinoh)
2015-02-12 07:16:59 +08:00
### <a name="instaix"></a> 3.5 Node-oracledb Installation on AIX on Power Systems with Instant Client ZIP files
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instaix)
### <a name="instsolarisx8664"></a> 3.6 Node-oracledb Installation on Oracle Solaris x86-64 (64-Bit) with Instant Client ZIP files
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#instsolarisx8664)
2017-06-29 14:35:55 +08:00
2021-05-29 16:06:47 +08:00
### <a name="github"></a> <a name="compileenv"></a> 3.7 Node-oracledb Installation from Source Code
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#github)
2021-05-29 16:06:47 +08:00
#### <a name="githubclone"></a> 3.7.1 Installing GitHub clones and ZIP files
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#githubclone)
2021-05-29 16:06:47 +08:00
#### <a name="githubtags"></a> 3.7.2 Installing using GitHub branches and tags
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#githubtags)
2021-05-29 16:06:47 +08:00
#### <a name="sourcepackage"></a> 3.7.3 Installing from a source package
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#sourcepackage)
2021-05-29 16:06:47 +08:00
#### <a name="nogithubaccess"></a> 3.7.4 Installing from Oracle's repository
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#nogithubaccess)
2021-05-29 16:06:47 +08:00
#### <a name="compilepackage"></a> 3.7.5 Creating a node-oracledb package from source code
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#compilepackage)
### <a name="offline"></a> <a name="intermediateinstall"></a> 3.8 Node-oracledb Installation Without Internet Access
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#offline)
#### <a name="winbins"></a> 3.8.1 Copying node-oracledb Binaries on Windows
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#winbins)
### <a name="selfhost"></a> 3.9 Hosting your own node-oracledb Packages
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#selfhost)
2021-05-29 16:06:47 +08:00
### <a name="docker"></a> 3.10 Using node-oracledb in Docker
2019-11-25 10:14:39 +08:00
2023-02-21 11:32:59 +08:00
[View latest documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#docker)
## <a name="installingoldvers"></a> <a name="installingv2"></a> <a name="installingv1"></a> 4. Installing Older Versions of Node-oracledb
2017-06-29 14:35:55 +08:00
2023-02-21 11:32:59 +08:00
The documentation has moved to [https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#installingoldvers](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#installingoldvers).
## <a name="troubleshooting"></a> 5. Troubleshooting Node-oracledb Installation Problems
2017-06-29 14:35:55 +08:00
2023-02-21 11:32:59 +08:00
The documentation has moved to [https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#troubleshooting](https://node-oracledb.readthedocs.io/en/latest/user_guide/installation.html#troubleshooting).