diff --git a/docs/boards/cp/migration/index.md b/docs/boards/cp/migration/index.md index dc1fc59fe..7c0aad813 100644 --- 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 index 7dff0e96c..94dac03bf 100644 --- 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).