Boards migration - Oracle NNE

isw-kudos · Oct 20, 2024 · 611aabb · 611aabb
1 parent 0f75938
commit 611aabb
Show file tree

Hide file tree

Showing 2 changed files with 28 additions and 0 deletions.
diff --git a/docs/boards/cp/migration/index.md b/docs/boards/cp/migration/index.md
@@ -80,6 +80,19 @@ Additional Properties for access to `PEOPLEDB` if separate host or authenticatio
 | ---------------------------- | --------- | -------------------------------- | ------------------------------------------------------------- |
 | `env.CONNECTIONS_DB_OPTIONS` | undefined | {"trustServerCertificate": true} | JSON encoded options for the MS SQL Server connection string. |
 
+### Oracle
+
+As of `2024-02-14` we have moved to the `node-oracledb` in `thin client` mode which does not support Native Network Encryption (NNE). Please temporarily disable NNE in the Oracle server configuration to run the migration service.
+
+If you have this enabled, it will cause the following error:
+
+````
+Error: NJS-500: connection to the Oracle Database was broken
+NJS-521: connection to host *************** port **** received end-of-file on communication channel```
+````
+
+For more information, please see the [node-oracledb documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#native-network-encryption) and [this issue](https://github.com/oracle/node-oracledb/issues/1567).
+
 ### Custom Persistent Volume
 
 The default chart values use an NFS mount. Below are examples custom configuration of the persisent volume definition for access to the Shared Drive using other methods.

diff --git a/docs/boards/troubleshooting/activity-migration.md b/docs/boards/troubleshooting/activity-migration.md
@@ -161,3 +161,18 @@ If you want to purge all activities from the database, you can get the list of a
 
     use boards-app
     db.nodes.distinct('providerID', { type: 'board' }).toString()
+
+## Oracle broken connection
+
+When migrating from Oracle to MongoDB, you may encounter the following error:
+
+```
+Error: NJS-500: connection to the Oracle Database was broken
+NJS-521: connection to host *************** port **** received end-of-file on communication channel
+```
+
+### Resolution
+
+As of `2024-02-14` we have moved to the `node-oracledb` in `thin client` mode which does not support Native Network Encryption (NNE). Please temporarily disable NNE in the Oracle server configuration to run the migration service.
+
+For more information, please see the [node-oracledb documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#native-network-encryption) and [this issue](https://github.com/oracle/node-oracledb/issues/1567).